Accoil (イベントストリーム)

Amplitudeのお客様は、ユーザーだけでなくアカウントに関するプロダクトデータを運用するためにAccoilを使用しています。

Accoilは、カスタマーサクセス、サポート、セールス、マーケティングチームを支援します。

• プロダクトの使用状況に基づいてアカウントの健全性をリアルタイムで追跡できます。
• カスタマーベース全体でのエンゲージメントの変化を監視します。
• 顧客の解約が発生する前にリスクのあるアカウントを特定します。
• 使用状況のシグナルに基づいて、プロダクト認定アカウントを可視化します。
• カスタマージャーニー全体にわたってプロアクティブなワークフローを強化します。

Amplitudeとの連携により、アカウントとユーザーのイベントは追加の計測を必要とせずに直接Accoilにストリーミングされるため、アカウントレベルのインサイトをリアルタイムかつ実用的な状態に保ちます。

ユースケース

• リアルタイムのアカウント健全性監視。
• カスタマーベース全体にわたるエンゲージメント追跡。
• リスクのあるアカウントの識別。
• プロダクト認定アカウントの可視化。

考慮事項

• イベントには、Accoil がイベントを正しく処理できるように有効なユーザー ID が含まれている必要があります。 匿名イベントを除外する必要がある場合は、フィルタを追加してください。
• 接続を有効にした後、ユーザーイベントが Accoil に表示されるまでに 1 ～ 2 分かかることがあります。

前提条件

連携を設定する前に、次のことが必要であることを確認してください。

• アクティブな Accoil ワークスペース。
• Accoil アカウントから取得した API キー。

連携を設定する

Accoil API キーを取得する

1. Accoilワークスペースにログインしてください。
2. ワークスペース > 設定 > アカウント設定 > 一般に移動します。
3. 関連するプロダクトのAPIキーをコピーします。

Amplitudeで新しい同期を作成する

1. Amplitudeでデータ、カタログの順に移動し、送信先タブを選択します。
2. 「カスタマーエンゲージメント」の下でAccoilを選択します。
3. 同期名を入力し、同期を作成を選択します。

認証情報を入力する

1. 入力フィールドにAccoil APIキーを貼り付けます。
2. 1. イベントの選択とフィルタリングの下で、すべてのイベントを選択します。
3. 接続をテストを選択します。

Accoil は接続を検証します。 成功すれば、データストリーミングをすぐに開始できます。

同期設定を構成する

イベントを選択してフィルタリングする

デフォルトでは、Amplitudeは転送対象となるすべてのイベントを選択します。 この設定を有効にしておくと、ユーザーのライフサイクル全体にわたってプロダクトの使用状況を最大限に把握できます。

オプションで次のことができます：

• User IDが付いたイベントのみを含めるようにフィルタリングします。
• 送信する特定のイベント タイプを手動で選択してください。

プロパティを送信先にマップする

AmplitudeからAccoilへの固有のユーザー識別子のマッピング。

• Amplitudeプロパティ：プロダクト内のユーザーを一意に識別するユーザープロパティを選択します（例：user_id、email、またはカスタムID）。
• Accoilプロパティ：このプロパティは自動的にuserIdにマッピングされます。

これにより、すべてのイベントデータがAccoilの正しいユーザープロフィールに関連付けられます。

追加のプロパティを選択してください（オプション）

Accoilに送信する追加のイベントまたはユーザープロパティを指定します。Amplitudeはこれらを各イベントのメタデータとして含めます。

• これらのプロパティを使用して、Accoil内のセグメンテーション、フィルタリング、ターゲティングに使用できるデータを充実させます。
• 例：trial_end、plan_type、api_key、api_token_id、status。

同期を完了して有効にする

1. 設定を確認してください。
2. ステータス スイッチを [有効] に切り替えます。
3. [保存] を選択します。

Amplitudeイベントは、リアルタイムでAccoilにストリーミングできるようになりました。

グループ情報とアカウント情報をAccoilにマッピングする

AmplitudeからAccoilにイベントをストリーミングする場合、AmplitudeはAmplitudeイベントペイロードからグループレベルのデータ（アカウント識別子や関連メタデータなど）を抽出し、それをAccoilがアカウントレベルのインサイトを得るために処理できる構造にマッピングします。

グループとアカウントデータの取得元

Amplitudeイベントには以下を含めることができます。

• groupsオブジェクト。イベントがどのグループに関連付けられているかを識別します（例：Account）。
• group_propertiesオブジェクト。各グループのメタデータが含まれます（例：domain、name、またはその他のカスタムトレイト）。

Amplitudeはこれら2つのフィールドを一緒に使用して、各イベントが属するアカウント（またはグループ）と、Accoilでそのアカウントにどのような特性を付加すべきかを判断します。

イベント内のグループを特定する

groupsと group_propertiesの両方がイベント内に存在する場合、マッピング ロジックは次のようになります：

• すべてのグループタイプを繰り返し処理します（例：Account）。
• 各タイプの下でグループIDを収集します。
• 各グループIDに関連付けられたメタデータ（トレイト）をgroup_propertiesから取得します。

これにより候補グループのリストが作成され、それぞれに次のものが含まれます。

• groupId：グループの一意の識別子です。
• traits: domain、name などのメタデータフィールドやその他の関連属性です。

プライマリグループを選択する

複数のグループが存在する場合、AmplitudeはそれらをgroupId（昇順）で並び替え、最初のグループをプライマリグループとして選択します。これにより、イベントに関連付けられたグループデータは一貫性が保たれます。

グループ特性を Accoil ペイロードにマッピングする

プライマリグループを選択した後、Amplitudeはその識別子とメタデータをgroupTraitsフィールドにあるAccoil互換の構造体へとフォーマットします。

例えば：

"groupTraits": [
  {
    "groupId": "210000",
    "traits": {
      "domain": "accoil.com",
      "group_type": "Account",
      "name": "Released Import Test"
    }
  }
]

Accoilはこれらの特性を使用して次のことを行います。

• アカウントプロファイルを充実させます。
• セグメンテーションとコホート分析をサポートします。
• レシピやダッシュボード内でフィルタリングとターゲティングを有効にします。