Google Pub/Sub（コホート同期）

Amplitude DataのGoogle Pub/Subコホート連携により、コホートメンバーシップの更新情報をPub/Subトピックに直接ストリーミングできます。

考慮事項

• この連携は、Amplitudeの有料プランをご利用のお客様のみがご利用いただけます。
• この連携を使用したいAmplitudeプロジェクトごとに有効にする必要があります。
• この連携を設定する前に、Amplitudeのアクティベーションと行動コホートを確認してください。
• Amplitudeは、サポートされているすべてのケーデンス（毎日、毎時間、リアルタイム）を通じてコホートの更新情報を送信します。
• 既存のリアルタイムコホート同期の制限値はすべて適用されます。

ペイロード

Pub/Subに送信されるペイロードはJSONオブジェクトです。例：

{
  "cohort_name": "Test Cohort",
  "cohort_id": "gs72ns",
  "in_cohort": true,
  "computed_time": "1685748245",
  "message_id": "some-message-id:54",
  "users": [{
    "user_id": "user1@amplitude.com"
    },
    {
      "user_id": "user2@amplitude.com"
    }]
}

• cohort_name：文字列です。オーディエンスの名前です。
• cohort_id：文字列です。オーディエンスの一意のID。これは、Amplitudeでオーディエンスを表示するときにもURLに表示されます。
• in_cohort：ブール値です。このユーザーバッチがオーディエンスに入場しているか退場しているかを示します。 各メッセージには1つの状態が含まれており、両方ではありません。
• compute_time：文字列です。Amplitudeがオーディエンスを再計算したときのエポックタイムスタンプ。 Kinesisストリーミングは、受信メッセージに順序を適用することはできません。このタイムスタンプを使用して、順序を復元できます。
  • Amplitudeはこの値を数値ではなく文字列として送信します。これは、一部の言語やプラットフォームがJSON数値を浮動小数点数と解釈し、精度が低下するためです。
• message_id：文字列です。各メッセージの一意の ID。
• users:リスト。ユーザーバッチです。各ユーザーは JSON オブジェクトとして表示されます。
  • user_id：文字列です。ユーザーのID。

連携を設定する

前提条件

作業を開始する前に、Pub/Subにトピックを作成し、Google IAMサービスアカウントを作成してください。

Amplitudeは連携をセットアップするためにPub/Subから2つのことを必要とします：

• Pub/Sub トピック名: Google Cloud でのトピックのフルネームではなく、トピックの名前です。 この手順に関するヘルプについては、Google Pub/Sub のドキュメントを参照してください。
• Googleサービスアカウントキー：Amplitude Pub/Sub連携用の専用サービスアカウントを作成します。この手順に関するヘルプについては、Googleのドキュメントを参照してください。

Google Pub/Sub の設定

トピックとサービスロールを作成したら、作成したトピックのプリンシパルとしてサービスアカウントを追加します。 詳細な手順については、Google のドキュメントを参照してください。

1. トピックを開きます。
2. [アクセス権] タブで、[プリンシパルの追加] をクリックします。
3. サービスアカウントの名前を追加します。
4. ロールとして「Pub/Sub Publisher」を選択します。

次に、サービスアカウント用のキーを作成します。 これはAmplitudeのセットアップを完了するために必要です。 この手順に関するヘルプについては、Googleのドキュメントを参照してください。

Amplitude設定

1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
2. コホートセクションで、Google Pub/Subをクリックします。
3. [別の送信先を追加] をクリックします。
4. この送信先の表示名を入力します。この名前は、コホートを同期するときの送信先を識別します。
5. Pub/Sub トピックの ID を入力します。
6. 上記の設定に基づき、.json形式でサービスアカウントキーをアップロードします。
7. 送信先を保存します。

Amplitudeはコホート同期の送信先を作成します。

コホートの送信

1. Amplitudeで、エクスポートしたいコホートを開きます。
2. [同期] をクリックし、[Google Pub/Sub] を選択します。
3. 作成した送信先を選択します。
4. 必要な同期頻度を選択します。