Amazon S3 (コホート)

この連携をセットアップして、コホートを Amazon S3 バケットに送信します。Amplitudeからユーザーグループをエクスポートすることで、Amazon S3バケットに基づいて構築された他のデータベースやストアドプロシージャと同期できるようになります。その後、社内のアナリティクスダッシュボードやパーソナライゼーションエンジンでAmplitudeコホートを使用できます。

前提条件

• Amazon S3コンソールから、Amplitudeを同期させたいS3バケットを見つけます。その名前、パス、および地域をコピーします。

連携を設定する

Amplitude設定

1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
2. コホートセクションで、Amazon S3（コホート）をクリックします。この連携にはAmazon S3を選択しないでください。
3. バケット名を入力し、リージョンを選択し、バケットパス（オプション）を入力して、送信先の名前を入力します。Amplitudeはコホートを同期するときにこの名前を使用します。
4. Amplitudeユーザープロパティを選択して、Amazon S3とAmplitudeの間でユーザーを一致させます。
5. バケットポリシーをコピーをクリックします。

Amazon S3のセットアップ

1. Amazon S3コンソールで、S3バケットに移動し、許可 → バケットポリシーに移動します。AmplitudeバケットポリシーをAmazon S3コンソールに貼り付けます。
2. オプションで、バケットに次の 2 つのパラメータを設定できます。
   • サフィックスを要求: 設定すると、ユーザーは S3 にエクスポートされるすべてのファイルの末尾に文字列を追加できます。
   • ユーザープロパティ：エクスポートされる各ファイルの追加の列として、各ユーザーと一緒に同期する単一のユーザープロパティを選択します。

コホートの送信

S3バケットをAmplitudeに接続した後、任意のコホートをそのバケットに同期できます。

1. Amplitudeの「コホート」ページから、送信するコホートをクリックするか、コホートを作成します。
2. [同期] をクリックします。
3. Amazon S3 を選択し、次へをクリックします。
4. S3 の場所を選択します。 これは、連携を設定する際にバケットに付けた名前です。
5. （オプション）。 次の2つのオプションパラメータを設定します。
   • ユーザープロパティ：このコホートでエクスポートされた各ユーザーにユーザープロパティを追加します。 ユーザープロパティは、エクスポートされたCSVファイルに列として表示されます。
   • ルーティングキー：S3のコホートファイル名の末尾に追加する文字列を入力します。
6. 同期の頻度を選択します。
7. 完了したら、[同期] をクリックします。

S3のコホート

Amplitudeは、コホートをCSVとして指定したバケットに同期します。このフォルダ内には、CSVファイルのリストがあります。

同期ごとに次の3つのCSVファイルが生成されます：

• 1 つは、最後の同期以降にコホートに入ったユーザーです。
• 1 つは、最後の同期以降にコホートを退出したユーザーに関するものです。
• 最後の同期時にコホート内に存在していたユーザーを含む 1 つ。 このようにすることで、S3 コホートメンバーシップの完全な履歴ログを常に保持できます。

CSV ファイルはすべて次の命名規則を使用しています。

path/projectID_cohortID_YYYY-MM-DDTHH:SS_difftype_routingkey.csv

場所：

• path：ファイルが書き込まれるパスに付与する、オプションのフォルダ接頭辞です。
• projectID: コホートが属するAmplitudeプロジェクトを識別します。
• cohortID: あなたのコホートの一意の識別子です。 この番号は、AmplitudeのあなたのコホートのURLで確認できます。
• YYYY-MM-DDTHH-SS: コホートが同期された時のタイムスタンプです。
• difftype：CSVファイルに含まれる3つのユーザーグループのうちのどれかを説明します。使用可能な値はentering、exiting、またはexistingです。
• routingkey：前に入力したオプションの文字列サフィックスです。

CSV 名内のタイムスタンプは、コホートが同期された日時を示しています。 1時間ごとまたは1日のスケジュール設定による同期がある場合、Amplitudeは同期ごとに新しいファイルを作成し、その時点でそのコホートに属する資格のあるユーザーの完全なリストを記載します。 オーディエンスメンバーシップの履歴ログを保持できます。

各 CSV ファイルにはユーザーのリストが含まれており、データは次の列に分類されています。

• amplitudeID： ユーザーの内部 Amplitude 識別子です。
• userID: ユーザーの一意のデータベース識別子です。
• userProperty： コホートを送信するセクションの手順 3 で追加したユーザープロパティの値です。ユーザープロパティごとに列が 1 つあります。ポートフォリオプロジェクトでは、ソースアプリケーションごとに別々の列があります。