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が設定されている匿名ユーザーのイベントデータのみを送信します。匿名ユーザーの場合、SDKでAmplitudeのデバイスIDを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キーを貼り付ける際に「Invalid API key」エラーが表示される場合は、キーを手動で入力してみてください。一部のブラウザでは、コピー＆ペースト時に非表示の文字が追加され、バリデーションエラーが発生することがあります。
詳細については、AmplitudeのAppboy Amplitude Integrationを参照してください。
レート制限
CurrentsはAmplitudeのHTTP APIに接続します。このAPIには、デバイスあたり30イベント/秒のレート制限と、デバイスあたり1日500Kイベントの非公開の制限があります。これらのしきい値を超えると、AmplitudeはCurrentsを通じて記録されたイベントをスロットリングします。インテグレーション内のデバイスがこのレート制限を超えた場合、すべてのデバイスからのイベントがAmplitudeに表示されるまでに遅延が発生する可能性があります。
通常の状況では、デバイスが30イベント/秒または1日500Kイベントを超えるレポートを行うことはありません。このイベントパターンは、インテグレーションの設定ミスによってのみ発生します。このような遅延を回避するには、SDKインテグレーションの手順に記載されている通常のレートでイベントをレポートするようにSDKインテグレーションを設定し、単一のデバイスに対して大量のイベントを生成する自動テストの実行を控えてください。
サポートされているCurrentsイベント
Brazeは、以下のイベントをAmplitudeにエクスポートすることをサポートしています。
各イベントのペイロード構造については、メッセージエンゲージメントイベント用語集および顧客行動イベント用語集の Amplitude タブを選択してください。