外部レビュープラットフォームの接続

外部レビュー プラットフォーム統合

既存のサードパーティのレビュー プラットフォームを LoyaltyTree に接続し、レビューを同期して自動的に顧客にシードを付与します。

概要

Judge.me、Loox、または Yotpo のようなレビュー プラットフォームをすでに使用している場合は、当社のネイティブレビュー システムに切り替える代わりに、LoyaltyTree と統合できます。これにより、以下のことができます：

• 既存のレビューを保持： マイグレーションや最初からやり直す必要はありません
• レビューに対してシードを付与： 顧客はレビューを残すとロイヤルティ報酬を獲得します
• 統一された顧客体験： レビューは顧客の全体的なロイヤルティの旅に貢献します
• 自動同期： レビューはウェブフックを介して LoyaltyTree に流れ込みます

ステップ 1: レビュー設定にアクセス

1. LoyaltyTree 管理者で ストア に移動します
2. ストア カードを見つけて レビュー設定 ボタンをクリックします
3. 設定タブに移動します

ステップ 2: 外部プラットフォーム モードを選択

レビュー システム 設定で：

1. レビュー システム ドロップダウンを見つけます
2. それを「LoyaltyTree ネイティブ」から 外部プラットフォーム に変更します
3. レビュー システムを有効にするにチェックが入っていることを確認します

ステップ 3: レビュープラットフォームを選択

レビュー プラットフォーム ドロップダウンからレビュー プロバイダーを選択します：

ステップ 4: ウェブフック処理を有効にする

ウェブフック処理を有効にするオプションにチェックを入れます。これにより、LoyaltyTree が外部プラットフォームからレビュー データを受信して処理できるようになります。

ステップ 5: ウェブフック URL を構成する

プラットフォームを選択すると、LoyaltyTree があなたのストア用のユニークな ウェブフック URL を生成します。

ウェブフック URL をコピー：

1. 統合パネルの ウェブフック URL フィールドを見つけます
2. コピーボタンをクリックして完全な URL をコピーします
3. この URL を安全に保管します - あなたのストア専用です

レビュー プラットフォームにウェブフックを追加：

正確な手順はプラットフォームによって異なりますが、一般的には：

1. レビュー プラットフォームの管理設定に移動します
2. ウェブフック または 統合 セクションを探します
3. コピーした URL で新しいウェブフックを追加します
4. レビュー作成または新規レビューイベントを選択します
5. ウェブフック設定を保存します

ステップ 6: ウェブフック シークレット (オプション)

追加のセキュリティのために、受信ウェブフックが正当であることを確認するためのウェブフック シークレットを構成できます。

動作の仕組み：

1. ウェブフック シークレットフィールドにシークレットキーを入力します
2. レビュー プラットフォームを構成して、このシークレットでリクエストに署名します
3. LoyaltyTree は x-webhook-signature または x-signature ヘッダーを使用して署名を確認します

注: すべてのプラットフォームがウェブフック署名をサポートしているわけではありません。サポートしていない場合は、このフィールドを空のままにできます。

ステップ 7: Generic/Custom オプション - 期待される JSON フォーマット

レビュー プラットフォームがウェブフックを送信すると、LoyaltyTree は以下のデータ形式を期待します：

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "素晴らしい製品！",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "製品名"
}

必須フィールド：

ネストされたフォーマットのサポート：

LoyaltyTree は、レビュー プラットフォームによく使われるネストされたデータ形式もサポートしています：

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "素晴らしい製品！"
  }
}

外部レビューに対するシード報酬

注: レビューに対するシードの割り当ては ロイヤルティグループ レベルで管理されます。ストアのロイヤルティ設定 → シード設定に移動して、顧客がレビュー、写真ボーナス、初回レビュー ボーナスに対して獲得するシードの数を設定してください。

レビューのウェブフックが受信されると：

1. LoyaltyTree は customer_email を既存の顧客に一致させます
2. 見つかった場合は、シードがシード設定の構成に基づいて付与されます
3. 投稿された写真のレビューは、設定されている場合にボーナス シードを獲得できます
4. 初めてレビューを書く顧客は追加のボーナス シードを獲得できます

トラブルシューティング

レビューが同期されませんか？

• ウェブフック URL を確認： クエリパラメータを含め、完全な URL をコピーしたことを確認します
• ウェブフックが有効か確認： LoyaltyTree で「ウェブフック処理を有効にする」がチェックされていることを確認します
• レビュー プラットフォームを確認： ウェブフックがアクティブで、正しい URL を指していることを確認します
• 新しいレビューでテスト： テストレビューを送信してウェブフックをトリガーします

顧客がシードを受け取っていませんか？

• メールが一致する必要があります： ウェブフック内の customer_email は、LoyaltyTree データベース内の顧客と一致する必要があります
• シード設定を確認： レビュー報酬がロイヤルティグループで構成されていることを確認します
• 顧客は登録される必要があります： 匿名またはゲストの顧客はシードの賞を受け取れない場合があります

ウェブフック署名エラー？

• シークレットが一致する必要があります： LoyaltyTree のシークレットは、レビュー プラットフォームに設定されているものと正確に一致する必要があります
• ヘッダー形式： LoyaltyTree は x-webhook-signature または x-signature ヘッダーを探します

ヘルプが必要ですか？

外部レビュー プラットフォームの統合についてのサポートは、当社のサポートチームまでお問い合わせください。support@loyaltytree.eco にご連絡ください。