Amplitude Recommendでは、Amazon S3 バケットにコーホートを同期できます。これにより、Amplitudeからユーザーのグループを効果的にエクスポートし、Amazon S3 バケットで構築した他のデータベースまたは保存した手順にそれらを同期することができます。そこから、内部分析ダッシュボードと内部パーソナライゼーションエンジンでAmplitudeコーホートを使用できます。
この記事では、統合の設定と使用について説明します。
注意: このデスティネーションは、コーホートをS3に同期するために使用されています。生データをS3に同期する別のデータがあります。
統合の設定
統合を設定するには、次のステップに従ってください:
- ソース＆デスティネーション→デスティネーションに移動します。Amazon S3（コーホート）デスティネーションをクリックします。（Amazon S3デスティネーションを選択しないでください: それは生データエクスポート用です）
- Amazon S3コンソールから、Amplitudeが同期するS3バケットを見つけます。名前、パス、および地域に注意してください。
- Amplitudeで、デスティネーション設定でBucket Nameフィールドにバケット名を入力します。Bucketパスで同じことを行って、Bucketがホストされている地域を選択します。同期に名前を付けて保存をクリックします。
- バケットポリシーをコピーするボタンをクリックします
- Amazon S3コンソールで、S3バケットに移動して、権限→バケットポリシーに移動します。AmplitudeバケットポリシーをAmazon S3コンソールに貼り付けます。
- オプションで、バケットに次の2つのパラメータを設定することもできます:
- サフィックスを要求するを設定すると、S3にエクスポートされたすべてのファイルの最後に文字列を追加できます。
- ユーザープロパティ:エクスポートされた各ファイルで、追加列として各ユーザーに同期する単一のユーザープロパティを選択できます。
詳細は、次のセクションを参照してください。
Amazon S3にコーホートをエクスポートする
S3バケットがAmplitudeに接続されたら、コーホートをそのバケットに同期できます。そうするためには、次のステップに従ってください:
- 同期するコーホートを開きます。同期するをクリックして、ドロップダウンリストからAmazon S3を選択します。
- 表示されたモーダルで、構成されたバケットを選択します。
- 希望する場合、次の2つのオプションパラメータを設定します:
- ユーザープロパティ:このコーホートでエクスポートされた各ユーザーにユーザープロパティを追加できます。エクスポートされたCSVファイルに追加の列としてユーザープロパティが表示されます。
- ルーティングキー:S3のコーホートファイル名の最後に追加される文字列を入力します。
詳細は、下記のS3のコーホートを参照してください。
- 必要な同期頻度を選択します:1回、1時間、または1日。
- 同期を保存をクリックして、プロセスを完了します。
S3のコーホート
指定されたバケットでコーホートはCSVとして同期されます。フォルダ内に、CSVのリストが表示されます。
各同期は3つ生成されます。CSVファイル:これは、前回の同期からコーホートを入力したユーザーのもの、前回の同期からコーホートを退去したユーザーのもの、前回の同期時にコーホートに既に含まれているユーザーのものです。こうすると、S3コーホートメンバーシップの完全な履歴ログを常に保持できます。
CSVファイルはすべて、この命名規則を使用します:
path/integer_cohortID_YYYY-MM-DDTHH:SS_difftype_routingkey.csv
Where:
パス:ファイルが書き込まれるパスのオプションフォルダープレフィックス。cohortID:コーホートの特殊識別子この数字はAmplitudeのコーホートのURLに表示されます。YY-MM-DDTHH-SS:コーホートが同期されたときのタイムスタンプ。difftype:これは、3人のユーザーのうちのどのグループをグループ化するかを説明します。CSVファイルは含まれています。受入れ可能な値は、entering、exiting、existingですroutingkey: 以前に入力されたオプションの文字列サフィックス
CVS名のタイムスタンプは、コーホートが同期された日時を指します。1時間/1日でスケジュールされた同期がある場合、その時点のそのコーホートで資格のあるユーザーの完全なリストが付いた新しいファイルを作成します。これは、最も新鮮なユーザーグループになり、最も新鮮なユーザーグループが含まれます。また、オーディエンスメンバーシップの歴史的なログを維持できます。
上記の通り、各CSVファイルは、ユーザーのリストを含みます。データは次の列に分割されています:
- amplitudeID:ユーザーの内部Amplitude識別子
- userID:ユーザーの特殊データベース識別子
- userProperty:エクスポートコーホートセクションのステップ3で追加されたユーザープロパティの値;各ユーザープロパティに1つの列があります。ポートフォリオプロジェクトでは、各ソースアプリに別の列があります。