Currents用Amplitude
Amplitude は製品分析およびビジネスインテリジェンスプラットフォームです。
BrazeとAmplitudeの双方向統合により、Amplitudeコホート、ユーザー特性、およびイベントをBrazeに同期できます。また、Braze Currentsを活用してBrazeイベントをAmplitudeにエクスポートし、製品データとマーケティングデータのより深い分析を実行できます。
前提条件
| 要件 | 説明 |
|---|---|
| Amplitude アカウント | このパートナーシップを利用するには、Amplitude アカウントが必要です。 |
| Currents | Amplitude にデータをエクスポートするには、アカウントに Braze Currents を設定する必要があります。 |
データエクスポート連携
BrazeからAmplitudeにエクスポートできるイベントとイベントプロパティの完全なリストは、以下のセクションに記載されています。Amplitudeに送信されるすべてのイベントには、ユーザーのexternal_user_idがAmplitudeユーザーIDとして含まれます。Braze固有のイベントプロパティは、Amplitudeに送信されるデータのevent_propertiesキーの下に送信されます。
この機能を使用するには、AmplitudeのユーザーIDがBrazeのexternal IDと一致している必要があります。
Brazeは、external_user_idが設定されているユーザー、またはdevice_idが設定されている匿名ユーザーのイベントデータのみを送信します。匿名ユーザーの場合、AmplitudeのデバイスIDをSDK内のBrazeデバイスIDと同期する必要があります。例:
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Amplitudeにエクスポートできるイベントは2種類あります。メッセージエンゲージメントイベントはメッセージ送信に直接関連するBrazeイベントで構成され、顧客行動イベントにはセッション、カスタムイベント、プラットフォームを通じてトラッキングされた購入などのその他のアプリやWebサイトのアクティビティが含まれます。すべての通常イベントには[Appboy]のプレフィックスが付き、すべてのカスタムイベントには[Appboy] [Custom Event]のプレフィックスが付きます。カスタムイベントと購入イベントのプロパティには、それぞれ[Custom event property]と[Purchase property]のプレフィックスが付きます。
Braze Currentsは、Amplitudeにイベントをエクスポートする際に[Appboy]プレフィックスを適用します。このラベルはBrazeの旧製品名を参照しています。これは想定された動作であり、SDKや連携の問題を示すものではありません。
Brazeに命名・インポートされたすべてのコホートには[Amplitude]のプレフィックスとcohort_idのサフィックスが付きます。つまり、cohort_idが「abcd1234」で「TEST_COHORT」という名前のコホートは、Brazeのフィルターでは[Amplitude] TEST_COHORT: abcd1234というタイトルになります。
追加のイベント権限へのアクセスが必要な場合は、アカウントマネージャーに連絡するか、サポートチケットを開いてください。
ステップ1:BrazeでAmplitude連携を設定する
Amplitudeで、AmplitudeエクスポートAPIキーを確認します。
AmplitudeのAPIキーを常に最新の状態に保ってください。コネクタの認証情報が期限切れになると、コネクタはイベントの送信を停止します。この状態が48時間以上続くと、コネクタのイベントは削除され、データは永久に失われます。
ステップ2:Braze Currentを作成する
Brazeで、Currents > + Create Current > Create Amplitude Export に移動します。連携名、連絡先メールアドレス、AmplitudeエクスポートAPIキー、およびAmplitudeリージョンを所定のフィールドに入力します。次に、トラッキングするイベントを選択します。利用可能なイベントのリストが表示されます。最後に、Launch Current をクリックします。
Braze CurrentsからAmplitudeに送信されるイベントは、Amplitudeのイベントボリュームクォータにカウントされます。
AmplitudeのAPIキーを貼り付けた際に「無効なAPIキー」エラーが表示された場合は、キーを手動で入力してみてください。一部のブラウザでは、コピー＆ペースト時に隠し文字が追加され、バリデーションエラーの原因になることがあります。
詳細については、AmplitudeのAppboy Amplitude Integrationを参照してください。
レート制限
CurrentsはAmplitudeのHTTP APIに接続しており、デバイスごとに30イベント/秒のレート制限と、デバイスごとに500Kイベント/日の非公式な制限があります。これらのしきい値を超えると、AmplitudeはCurrentsを通じてログに記録されたイベントをスロットリングします。インテグレーション内のデバイスがこのレート制限を超えた場合、すべてのデバイスからのイベントがAmplitudeに表示されるまでに遅延が生じることがあります。
通常の状況では、デバイスが30イベント/秒または500Kイベント/日を超えるレポートを行うことはなく、このイベントパターンはインテグレーションの設定ミスによってのみ発生します。このような遅延を回避するには、SDKインテグレーションの手順に記載されている通常のレートでイベントをレポートするようにSDKインテグレーションを設定し、単一のデバイスに対して多数のイベントを生成する自動テストの実行を控えてください。
サポートされているCurrentsイベント
Brazeは、以下のイベントをAmplitudeにエクスポートすることをサポートしています。
各イベントのペイロード構造については、メッセージエンゲージメントイベント用語集および顧客行動イベント用語集の Amplitude タブを選択してください。