同期

Amplitudeは、コホート、プロパティ、計算、予測に対して3種類の同期をサポートしています。オンデマンド同期、自動同期、リアルタイム同期です。

オンデマンド同期は、オーディエンステストや1回限りのキャンペーンに役立ちます。 自動同期は毎日または毎時間のスケジュールで実行されます。 コホートオーディエンスメンバーシップやユーザー予測確率が変化すると、Amplitudeは接続先のコホートメンバーシップを自動的に調整します。 リアルタイム同期は毎分更新されます。これは、迅速な更新が必要なインタラクティブなユースケースに最適です。

CSV のダウンロードや手動での同期は必要ありません。 ユーザーがアプリ内でアクションを実行すると、Amplitudeはユーザーを関連する広告、メール、またはテストプラットフォームに自動的に同期します。

機能の可用性

• Free、Plus、グロース、エンタープライズプランのユーザーは、オンデマンド同期機能を利用できます。
• グロース、エンタープライズ、Plusプランのユーザーは自動同期を利用できます。
• グロースプランとエンタープライズプランのユーザーはリアルタイム同期を利用できます。

リアルタイム同期

リアルタイム同期機能により、Amplitudeはユーザーがコホートに参加または離脱するとほぼ同時に、アップデートをパートナーの送信先に送信します。これにより、エンドユーザーへのタイムリーなコンテキストメッセージングなど、コホート同期のさらなる用途が可能になります。 リアルタイム同期を作成するとき、Amplitudeはまず初期データを送信先に送信します。同期データが大きい場合は、この処理に数時間かかることがあります。 この初期同期の後、Amplitudeはユーザーがコホートに入退場するたびに1分ごとに更新情報を送信します。

ほとんどの宛先とコホートは、リアルタイムのコホート同期をサポートしています。パートナーがAPIリクエストに失敗または拒否した場合、またはネットワーク遅延やエラーが発生した場合、Amplitudeは問題が解消されると変更内容を送信します。

リアルタイム同期は、広告配信先や S3 など、頻繁な更新に対応していない特定の配信先や、頻繁な同期を妨げる厳しい統合制限がある配信先をサポートしていません。

リアルタイム同期は、コンピューテーションコストが高いため、一部の複雑なコホートまたは非常に大規模なコホートをサポートしていません。リアルタイム同期はコホートメンバーシップを宛先に送信できますが、計算結果、プロパティ、または予測を送信することはできません。

新しい同期を作成する

新しい同期を作成するには、次の手順に従ってください。

1. + 新規作成_をクリックし、[同期]_ タイルをクリックします。 _新しい同期を作成_モーダルが表示されます。

2. 作成する同期タイプを選択します。コホート、レコメンデーション、ユーザープロパティ、またはコンピューテーション同期です。次に、_次へ_をクリックします。

3. ドロップダウンリストから、同期したい特定のアイテムを選択します。次に、_次へ_をクリックします。

4. 同期先の送信先を選択します。送信先が表示されない場合は、[+ 送信先を追加] または [送信先を管理] をクリックし、そこで送信先を設定します。次に、_次へ_をクリックします。

5. オンデマンド同期、定期同期、またはリアルタイム同期のいずれを作成するかを選択します。 定期的な同期は1時間ごとまたは1日のスケジュールで実行されますが、リアルタイム同期は1分ごとに更新されます。

   ステップ 4 で選択した内容によっては、同期先となるカスタマーアカウントまたは API ターゲットを指定する必要がある場合もあります。

6. [同期] をクリックします。 同期はアクティブです。

Eメール通知

Amplitudeはコホート同期ジョブについて自動的にメールアラートを送信します：

• 成功通知: コホートの同期が正常に完了したときに確認メッセージを受信します。
• 失敗通知：同期ジョブが失敗したときにアラートを受信するため、問題に迅速に対処できます。

これらの通知を使用すると、プラットフォームを手動で確認することなく、コホートの同期ステータスをモニターできます。

同期の詳細を表示

同期を作成した後、［同期］パネルで同期名をクリックすると、その詳細が表示されます。

_詳細_タブには、同期に関する基本情報が表示されます。上記の例はコホートの同期です。そのため、「詳細」タブにはコホートの定義と、その人口を経時的に詳しく示すチャートが表示されます。［同期］ タブには、この同期を受信する各送信先が表示されます。

_「比較」_タブでは、この同期されたコホートと選択した別のコホートの直接比較を表示できます。 ［構成基準］ ドロップダウンを使用して、［ユーザー構成］ チャートの結果をユーザープロパティごとに分類できます。

Amplitude アナリティクス内で同期されたコホートのリストを表示するには、[コホート] をクリックし、[同期されたコホート] タブを開きます。

コホート同期の不一致を理解する

Amplitudeからサードパーティの送信先にコホートを同期する場合、Amplitudeとパートナーのプラットフォームのユーザー数に違いがあることに気付く場合があります。これらの違いが発生する理由と、どのユーザーが正常に転送されたかを確認する方法を理解することは、これらの問題を解決するのに役立ちます。

Amplitudeを使用すると、同期するユーザープロパティを選択できます。 これはカスタマイズに役立ちますが、コホート同期時の不一致を最小限に抑えるために慎重な計画も必要です。

コホート同期の違いの一般的な理由には次のものがあります。

• 未解決のマッピング：ユーザープロパティが設定されていない、または NULL である場合、Amplitudeはプロパティに紐付けられたユーザーを同期できません。たとえば、メールを User_ID として使用して 100 人のユーザーのコホートをプラットフォームに同期する場合、メールを提供したユーザーが 50 人しかいなければ、その 50 人のユーザーのみが同期されます。ソースでデータを確認して修正し、Amplitudeでデータを更新してから、別の同期を実行してください。
• 無効なマップ済みプロパティ： サードパーティ製の宛先で予期された形式に準拠していないプロパティは、同期の一部または失敗を引き起こす可能性があります。たとえば、ダウンストリームの送信先は、電子メールや電話番号などの特定の識別子形式を受け入れない場合があります。

コホートマッピングを更新する際の警告

Amplitudeユーザープロパティマッピングを変更しようとすると、Amplitudeは警告を発します。マッピングを変更するとアクティブなコホート同期に影響が生じる可能性があるためです。 [View Syncs] をクリックすると、変更が影響を与える可能性がある同期が表示されます。そこから、同期をオフにするかどうかを決定します。

警告が表示されない場合でも、マッピング プロパティを変更する際には注意してください。 マッピングを変更すると、追跡対象のユーザー数に予期しない変化が生じる可能性があります。

たとえば、メールアドレスによるマッピングを停止し、電話番号に切り替えた場合、以前にメールと同期していたユーザーは更新を受け取ることができません。 この変更は新規ユーザーにのみ影響します。 Amplitudeは電話番号に基づいて新規ユーザーを同期しますが、既存ユーザーは引き続きメールアドレスに基づいて同期します。 時間が経つにつれて、このことがデータの矛盾につながる可能性があります。

コホート同期プロセスがしばらく前から実施されており、マッピングを変更することを検討している場合は、まず新しい同期送信先を作成してください。その後、この新しいターゲットを使用して同期を続行します。

同期履歴を表示

コホート同期履歴ページには、過去14日間のコホート同期の詳細な内訳が表示されます。 各コホート同期では、スキップされたユーザー、追加されたユーザー、または削除されたユーザーのリストが表示されます。 このページにアクセスするには、次の手順に従ってください。

1. _コホート_タブをクリックします。
2. 興味のある特定のコホートを選択してください。
3. _[同期] _タブをクリックします。
4. コホート同期に複数の送信先が含まれている場合は、適切なコホート送信先を選択してください。
5. ［History］ タブをクリックします。

CSVエクスポートを使用してエクスポートされたコホートを検査する

Amplitudeがコホートからサードパーティの送信先にどのユーザーを何人エクスポートしたかを確認するには、エクスポートされたすべてのユーザーを含むCSVをエクスポートしてください。

CSVエクスポートには次の列が含まれます。

• Amplitude_id: 各ユーザーに関連付けられた固有のAmplitude IDを表示します。
• 操作：Amplitudeがユーザーをコホートメンバーシップから追加または削除したかどうかを示します。
• マップされたプロパティ：この列には、コホート同期用のマップされたユーザー識別子が表示されます。
• Skip_detected：コホート同期プロセス中にAmplitudeがユーザーをスキップしたかどうかを示します。
• Skip_reason：Amplitudeがユーザーをスキップした理由の大まかな分類です。
  • 未解決のマッピング：ユーザーを識別するために使用されるマッピングされたプロパティが存在しないか値がないため、Amplitudeはコホート同期中にこのユーザーをスキップしました。
  • パートナーによって拒否されました：マッピングされたプロパティが必要な形式に準拠していないため、サードパーティの送信先がこのユーザーを拒否しました。たとえば、データフィールドが正しい数値形式または電子メール形式でない場合、送信先はユーザーをコホート同期から除外します。

一部のユーザープロパティは不完全であるか、ターゲットプラットフォームの基準に準拠していない可能性があります。コホート同期成功率が80%を超えることは、広告キャンペーンにとって許容されることがよくあります。メールキャンペーンやA/Bテストの場合は、95%以上のレートを使用してください。

スキップされたエントリが多数ある場合は、ソースにデータ品質の問題がある可能性があります。 この問題を解決するには、CSVファイルを確認して不一致を特定してください。次に、Amplitudeにインポートする際にユーザーデータを適切に修正してください。 修正を行った後、コホート同期プロセスを再度起動して、データの正確性と一貫性を確認してください。

その他の考慮事項

• リアルタイムコホート同期：Amplitudeのリアルタイム同期（RTS）機能を使用すると、コホート同期履歴ページでは、同期中にスキップされたユーザーのCSVをエクスポートすることはできません。スキップされたユーザーの詳細な追跡を行うには、リアルタイム同期ではなく、1時間ごとまたは1日の同期を使用してください。
• ユーザーは送信先に到達すると通知なくドロップされます：一部の送信先は、基準を満たさないユーザーを通知なくドロップした場合でも、Amplitudeからのコホート同期が成功したことを示す2XX応答を返すことがあります。このような場合、CSVファイルを確認することで、Amplitudeが特定のユーザーをエクスポートしたことを確認してください。

サポートされている宛先

送信先カタログを参照してください。