Braze（コホート同期）

Amplitude DataのBraze連携機能により、数回クリックするだけでAmplitudeのコホートをBrazeに送信できます。

考慮事項

• この連携を使用したい各Amplitudeプロジェクトで有効にしてください。
• この連携をBrazeで使用する方法の詳細については、Brazeのドキュメントを参照してください。
• Brazeアカウントが必要です。
• Brazeがユーザーを識別した後、AmplitudeはBrazeの要件により、device_idではなくexternal_idでユーザーを参照する必要があります。この制限に対処するために、Amplitudeは各コホートに対して、1つはdevice_idをマッピングする同期、もう１つはuser_idをマッピングする同期というように、送信先への同期を2つ設定することを推奨します。両方の同期において、Amplitudeはユーザーのdevice_id（存在する場合）およびexternal_idを通じて、ユーザーの追加または削除を試みます。

前提条件

AmplitudeからBrazeへのコホート連携を設定するには、Brazeから次の情報が必要です。

1. データインポートキー（Braze REST APIキー）

   • Brazeでパートナー連携、Amplitudeの順にクリックし、新しいキーを生成をクリックします。 データインポートキーは、Braze のドキュメントに記載されている Braze REST API キーです。
   • 詳細については、Braze のドキュメントを参照してください。

2. エンドポイント：REST 操作のエンドポイント

   • Braze で「パートナー統合」をクリックし、「Amplitude」をクリックします。
   • 次のようになります：https://rest.iad-##.braze.com。
   • 使用しているエンドポイントを見つけるには、Brazeのドキュメントを参照してください。

連携を設定する

Amplitude設定

1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
2. コホートタイプを選択し、Brazeをクリックします。 （オプション）検索バーを使用して Braze を検索します。
3. 送信先を追加をクリックします。
4. エンドポイントを選択し、データインポートキーを貼り付けます。
5. ユーザーをマップする対象となる Amplitude と Braze のプロパティを選択します。
   • ターゲットオブジェクトとしてユーザーエイリアスを選択した場合、ユーザーエイリアスラベルを追加します。それ以外の場合は、空のままにしてください。
6. 完了したら、[保存] をクリックします。

コホートの送信

最初のコホートを同期するには、以下の手順に従ってください。

1. Amplitudeで、同期したいコホートを開き、[同期] をクリックします。
2. 「Braze」を選択し、「次へ」をクリックします。
3. 同期したいアカウントを選択します。
4. 同期のケイデンスを選択します。 ワンタイム同期、スケジュール同期、またはリアルタイム同期を選択します。 コホートの同期に関する詳細は、「サードパーティの宛先との同期」を参照してください。
5. 作業が完了したら、作業内容を保存してください。

複数のAPIキーターゲットを設定する

マルチキーサポートにより、Amplitudeプロジェクトごとに複数のBraze APIキーを設定し、各コホートの同期を特定のターゲットに送信できます。組織が単一のAmplitudeプロジェクトから複数のBrazeインスタンス、リージョン、アカウントを管理する場合にこれを使用します。

キーを追加する

1. Amplitudeデータで、_カタログ > 送信先_に移動し、Brazeコホート同期接続を選択します。
2. 送信先設定モーダルで、別のキーを追加をクリックします。
3. ターゲットの名前を入力します（たとえば、「米国本番」や「EUステージング」など）。

4. Braze REST APIキーを貼り付け、このターゲット用のRESTエンドポイントを選択します。
5. このターゲットのユーザー マッピング プロパティを選択します。
   • user_id：AmplitudeユーザーIDをBrazeexternal_idにマッピングします。これは識別されたユーザーに対して使用してください。
   • device_id：AmplitudeデバイスIDをBrazeデバイスIDにマッピングします。 これは匿名ユーザーに対して使用してください。
   • ユーザー エイリアス: ユーザーをカスタム エイリアスでマップします。 このオプションを選択した場合、ユーザーエイリアスラベルを入力します。
6. 保存をクリックします。

追加したいキーごとに、これらの手順を繰り返します。

同期を作成するときにターゲットを選択する

新しいコホート同期を作成すると、Amplitudeはコホートを送信するターゲットを選択するよう求めます。 到達したい Braze インスタンスに対応する名前付きターゲットを選択します。

下位互換性

マルチキーサポートが利用可能になる前にBraze連携を設定した場合、既存の設定は変更なく引き続き機能します。Amplitudeはオリジナルのキーを「Default」という名前のターゲットに割り当て、既存のすべての同期ジョブをそのターゲットに自動的に割り当てます。元のキーの横に新しいターゲットをいつでも追加できます。

Brazeでコホートを利用する

1. Brazeで_オーディエンス_に移動し、セグメントをクリックします。
2. 「セグメントを作成」をクリックし、セグメントに名前を付けます。
3. _「フィルターを追加」_の下で**「Amplitudeコホート」**を選択し、作成およびAmplitudeから同期したコホートを選択します。
4. 保存後、キャンバスまたはキャンペーン作成時に、ターゲット設定ユーザーステップでこのセグメントを参照できます。

Eメール通知

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

• 成功通知：コホートとBrazeの同期が正常に完了すると、Amplitudeから確認メッセージが送信されます。
• 失敗通知：同期ジョブが失敗したときにAmplitudeが警告を発するので、問題が発生した場合に迅速に対処できます。

トラブルシューティング

Brazeにユーザーのリストが表示されません

コホートを同期すると、Brazeはそのコホート内のユーザーとBraze内にすでに存在するユーザーを照合します。新しいユーザーを作成することはありません。Amplitudeコホートのユーザーと一致するユーザー（userId）がBrazeに存在することを確認してください。