このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Intercom（イベントストリーム）

Amplitude ActivationのIntercomストリーミング連携により、数回クリックするだけでAmplitudeイベントとユーザーをIntercomに転送できます。

連携を設定する

前提条件

新しいIntercomアプリを作成する

  1. Intercom Developer Hubから、[Your Apps]をクリックします。
  2. 新しいアプリをクリックします。
  3. 名前を入力し、ワークスペースを選択します。
  4. アプリを作成をクリックします。

アプリを作成する方法の詳細については、Intercom のドキュメントを参照してください。

必要な情報

AmplitudeからIntercomへのストリーミングを設定するには、Intercomから次の情報が必要です。

Intercomアクセストークン：Intercomアプリ用のIntercomアクセストークンです。

  1. Intercom Developer Hubから、[Your Apps]をクリックします。
  2. アプリをクリックします。
  3. ［Authentication］ ページに移動します。
  4. Intercomアクセストークンは、アクセストークンの下にあるワークスペース名のすぐ下に表示されます。

新しい同期を作成する

  1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
  2. 「イベントストリーミング」セクションで、Intercomをクリックします。
  3. 同期名を入力し、[同期を作成] をクリックします。

認証情報を入力する

  1. Intercom API エンドポイントを選択します。
  2. Intercom アクセス トークンを入力します。

マッピングを設定する

これはイベント転送とユーザー転送の両方に適用されます。

  1. 左側のドロップダウンから、IntercomユーザーIDに対応するAmplitudeユーザープロパティを選択します。
  2. 右側のドロップダウンから、Intercom ユーザー ID のタイプを選択します。
    • ユーザーID：Intercom内の各ユーザーの一意の識別子です。
    • メール

イベント転送の設定

イベントの送信の下でトグルを有効にすると（「イベントをIntercomに送信」）、イベントをIntercomにストリーミングできます。有効にされている場合、Amplitudeはイベントを取り込むと自動的にイベントをIntercomに転送します。 この連携は、スケジュール通りまたはオンデマンドでイベントを送信しません。AmplitudeはイベントをIntercomデータイベントとしてIntercomに送信します。 Intercomのイベントタイプは120種類に制限されています。

Intercomがイベントを作成すると（Amplitudeのイベントストリーミング連携からのイベントを含む）、Intercomは[Intercom] event.createdイベントをトリガーします。Amplitudeにこれらのイベントを保存させたくない場合は、Amplitudeのブロックフィルターまたはドロップフィルターを使用してこのデータを削除してください。

  1. イベントの選択とフィルタリングで、送信するイベントを選択します。Intercom で必要なイベントだけを選択します。

匿名ユーザーイベントのストリーミング

Intercomでは、すべてのイベントにユーザーIDが存在する必要があります。ユーザーIDを持たない可能性のあるイベントを選択した場合は、ユーザーIDが存在するイベントのみを送信するようにフィルターを追加してください。Amplitudeは、Intercomにすでに存在するユーザーに対してのみイベントをストリーミングします。 そうしないと、配信メトリクスに影響を受ける可能性があります。

  1. （オプション）追加プロパティの選択で、Intercomに送信するイベントやユーザープロパティをさらに選択します。ここでプロパティを選択しない場合、Amplitudeは何も送信しません。 AmplitudeはこれらのプロパティをIntercomイベントメタデータとしてIntercomに送信します。Intercom では、イベントごとにメタデータ値が 20 個までという制限があります。

ユーザー転送の設定

ユーザーとプロパティの更新をIntercomにストリーミングするには、ユーザーの送信を有効にします。この設定は、AmplitudeでHTTP V2 APIまたはIdentify APIを使用してユーザーを更新するときに、Intercomでユーザーを作成または更新します。 この連携は、スケジュールされた更新やオンデマンドの更新をサポートしていません。Amplitudeは各ユーザーをIntercomの連絡先として作成します。

オプションで、追加プロパティを選択フィールドでIntercomに送信するユーザープロパティを選択します。Amplitudeは選択したプロパティのみを送信し、そのうちの1つが更新された場合にのみ送信します。 AmplitudeはこれらのプロパティをIntercomカスタム属性として送信します。

同期を有効にする

設定が正しいことを確認したら、ページ上部のステータスを有効切り替え、保存をクリックします。

これは役に立ちましたか？