PendoとIntercomのIDを同期する

最終更新日:

この記事では、Finが訪問者を認識できるように、PendoとIntercom間のIDマッピングを設定する方法について説明します。Pendoの訪問者IDとIntercomのユーザーIDがすでに一致している場合を除き、タスクナッジやフラストレーションシグナルのサポートなど、Intercomインテグレーションの機能を対象の訪問者に対して利用するには、IDの同期が必要です。

ID同期はPendoアプリの設定で行われています。エージェント自体を接続し、その機能を有効にするには、「Agent Toolkitでエージェントを設定する」の手順を完了していることを確認します。

仕組み

PendoとIntercomのインテグレーションにより、サポートとプロダクトツールが連携するため、チームは各訪問者の全体像を共有して作業できます。Intercomとのインテグレーションには、次のような複数の側面があります。

Pendoの訪問者IDとIntercomのユーザーIDがすでに一致している場合は、これを設定する必要はありません。一致しない場合、Finでは訪問者を特定できないため、フラストレーションシグナル、タスクナッジ、セッションコンテキスト、ガイドを機能させるにはIDの同期が必要です。

ステップ1:IntercomとPendoのIDを比較する

PendoとIntercomで、訪問者(Intercomでは「ユーザー」と呼ばれます)を識別するために同じIDが使用されていることを手動で確認します。

  1. Intercomで、アプリケーションのユーザーの詳細を開きます。
  2. ユーザー詳細パネルでユーザーIDを表示します。この値をコピーしてPendoで使用します。
  3. Pendoで、[ピープル(People)]>[訪問者(Visitors)]に移動します。
  4. IntercomのユーザーIDの値を検索バーに貼り付けてください。
    • Pendoで同じユーザーを検索しても返ってきた場合、IDはすでに同期されています。次の手順に進む必要はありません。インターコムフィンとPendoの使い方については「次の手順」をご覧ください。
    • 検索してもPendoにユーザーが返されない場合は、次の手順を実行して、PendoとIntercom間のIDマッピングを完了する必要があります。

ステップ2:Pendo ID同期を有効にする

IntercomとPendoの両方を使用するアプリケーションごとに、このセクションの手順を実行します。

アプリケーション設定へのアクセス

  1. Pendoで、[設定(Settings)]>[サブスクリプション設定(Subscription settings)]に移動します。
  2. アプリケーション(Applications)]タブを選択します。
  3. アプリケーションのリストで、設定するアプリケーションを選択します。[アプリの詳細(App Details)]タブにアプリケーション設定が表示されます。

訪問者IDとIntercomの同期を有効にする

  1. アプリの詳細(App Details)]で、[訪問者IDをIntercomと同期(Sync visitor IDs with Intercom)]設定を見つけます。
  2. チェックボックスを選択すると、この設定が有効になります。

Intercomとの訪問者ID同期を有効にすると、PendoはページからIntercomユーザーIDを読み取り、それをintercomUserIdとして訪問者メタデータに保存し、Pendo訪問者IDをカスタム属性pendoVisitorIdとしてIntercomにプッシュします。

PendoとIntercomの両方がインストールされているすべてのアプリケーションで、このプロセスを繰り返します。

ステップ3:IntercomでPendoの訪問者IDカスタム属性を作成する

pendoVisitorIdという名前のユーザーカスタム属性を作成し、Pendoがその属性に書き込めるように検証済みの更新が不要であることを確認します。

  1. Intercomで設定を開きます。
  2. Intercomのドキュメント「カスタムデータ属性(CDA)の作成と追跡」に記載されている手順に従って、新しい属性を作成します。
  3. 新しいユーザー属性を作成(Create new people attribute)]モーダルで、次の情報を更新します:
    • フォーマット:テキスト。
    • 名前pendoVisitorId
    • 検証済みの更新が必要:オフ。Intercomには、この属性が未検証の更新を受け付けることを示す注記が表示されますが、これはこの属性では想定された動作です。
  4. [保存]を選択します。

ステップ4:セットアップを確認する

イベントデータが流れて処理されるまでしばらく待ってから、同期によってPendoにintercomUserIdフィールドが生成されていることを確認します。

  1. Pendoで、[設定(Settings)]>[メタデータ(Metadata)]に移動します。[訪問者レベルのデータ(Visitor-level data)]タブが開きます。
  2. マッピング(Mappings)]テーブルで、intercomUserIdフィールドが使用可能になっていることを確認します。

intercomUserIdフィールドが表示されない場合は、設定してからまだ時間が経っていない可能性があります。このフィールドは、ID同期が有効になり、イベントデータが処理された後にのみ表示されます。データがシステムを通過する時間によっては、最大1時間かかることがあります。

次のステップ

PendoとIntercom間のIDのマッピングが正常に完了したら、Intercom Finとのインテグレーションの設定に進むことができます。次のいずれか、またはすべてを設定するかを選択します:

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています