Braze (イベントストリーム)

Amplitude Activation Braze ストリーミング連携は、数回クリックするだけで、Amplitude イベントとユーザーを Braze に転送します。

ユースケース

イベント ストリーミングは、カスタマーがアクションを実行した直後にメッセージを送信します。例えば：

• カートを放棄したカスタマーにメールを送信します。
• スティッキアクションを完了したカスタマーを祝福します。

連携を設定する

前提条件

AmplitudeからBrazeへのストリーミングを設定するには、Brazeから以下の情報が必要です。

• Braze APIエンドポイント:REST操作のためのBrazeエンドポイントです。
• Braze APIキー：認証に使用されるBraze APIキーです。エンドポイントの特定やAPIキーの検索方法については、Brazeのドキュメントを参照してください。
• Braze App ID：Amplitudeイベントを受信するアプリのBraze App ID。アプリIDの検索方法については、Brazeのドキュメントを参照してください。

新しい同期を作成する

1. Amplitudeデータで、**[カタログ]をクリックし、[宛先]**タブを選択します。
2. **「Braze」（「イベント」・「ユーザープロパティ」）**を選択するか、*「タイプ」＞「イベント」*でフィルタリングします。
3. 送信先を追加 を選択します。
4. 同期名を入力し、[同期を作成] をクリックします。

認証情報を入力する

1. ご利用のBraze APIエンドポイントを選択します。
2. Braze API キーを入力してください。
3. Braze アプリ ID を入力します。
4. Braze ユーザーエイリアスを使用して Braze 上のユーザーを識別する場合、使用予定の Braze ユーザーエイリアスラベルを入力します。 それ以外の場合は、このフィールドを無視してください。
5. 「ユーザーのみを更新」オプションをオンにすると、新しいユーザーを作成せずに Braze に存在するユーザーを更新できます。 エイリアスだけのユーザープロファイルを送信する場合は、このフィールドをチェックしないでください。[Update Users Only] をチェックした場合、AmplitudeはBrazeにエイリアスのみのユーザープロファイルを作成しません。詳細については、Braze のドキュメントを参照してください。

マッピングを設定する

これはイベント転送とユーザー転送の両方に適用されます。

1. 左側のドロップダウンから、BrazeユーザーIDに対応するAmplitudeユーザープロパティを選択します。
2. 右側のドロップダウンから、BrazeユーザーIDの種類を選択します。
   • 外部ID：Braze内の各ユーザーの一意の識別子です。
   • Braze ID：Braze が各ユーザーに提供する固有の識別子です。
   • ユーザーエイリアス：Brazeの各ユーザーに対する代替の一意の識別子です。
   • 電子メール：外部 ID または Braze ID なしで電子メールを識別子として使用すると、予期しない動作が発生する可能性があります。 たとえば、AmplitudeがIDと同じメールアドレスを持つユーザーをBrazeに送信した場合、Brazeはそれらを統合しません。その結果、2つの異なるユーザーが作成されます。 この問題を回避するには、Brazeユーザープロファイルのドキュメントを参照してください。Brazeはまた、ユーザーをマージするためのユーザーマージAPIも提供しています。

イベント転送の設定

イベントをBrazeにストリーミングしたい場合は、「イベントの送信」でトグルを有効にします（「イベントはBrazeに送信されます」）。有効にされている場合、Amplitudeはイベントを取り込む際に、自動的にBrazeに転送します。Amplitudeは、この連携を使用してスケジュールどおりにまたはオンデマンドでイベントを送信しません。

1. **[イベントの選択とフィルタリング] **で、送信するイベントを選択します。 Brazeで必要なイベントのみを選択してください。

2. （オプション）[追加のプロパティを選択] で、Braze に送信するイベントおよびユーザーのプロパティをさらに選択します。 ここでプロパティを選択しない場合、Amplitudeは何も送信しません。 AmplitudeはこれらのプロパティをBrazeカスタムイベントプロパティとしてBrazeに送信します。

ユーザー転送の設定

ユーザーとプロパティの更新を Braze にストリーミングするには、Send Users を有効にします。この設定は、AmplitudeでHTTP V2 APIまたはIdentify APIを使用してユーザーを更新するときに、Brazeでユーザーを作成または更新します。 この連携は、スケジュールされた更新やオンデマンドの更新をサポートしていません。

オプションで、［Select additional properties］フィールドで、Brazeに送信するユーザープロパティを選択できます。 Amplitudeは選択したプロパティのみを送信し、そのうちの1つが更新された場合にのみ送信します。 AmplitudeはこれらのプロパティをBrazeのカスタム属性として送信します。

同期を有効にする

設定が完了したら、ページ上部の [ステータス] を [有効] に切り替え、[保存] をクリックします。

よくある質問

Amplitudeでユーザープロパティを設定解除しても、Brazeでカスタム属性が削除されないのはなぜですか？

$unsetを使用してユーザープロパティを削除する場合、Amplitude イベントストリーミングは Braze に明示的な削除信号や NULL 信号を送信しません。代わりに、Amplitudeはストリーミングペイロードからこのプロパティを除外します。 プロパティがAPIリクエストに含まれていない場合、Brazeは既存のカスタム属性値を保持するため、この属性はBraze内で変更されません。

これは現在の連携の既知の制限です。Braze はカスタム属性をクリアするために /users/trackAPI ペイロードに明示的な null 値を必要としますが、Amplitude のストリーミングレイヤーは $unset 操作を Braze API の明示的な null 値に変換しません。

Amplitude Event StreamingはBrazeでのカスタム属性の削除やクリアをサポートしていません。 また、Amplitude はユーザープロパティを JSONnullに設定することもサポートしていません。Amplitude HTTP API は null をユーザープロパティ値として受け入れません。

Brazeで属性をクリアする必要がある場合は、Braze /users/trackAPIを直接使用して、削除したい属性に対して明示的なnullを送信してください。この機能がユースケースにとって重要な場合、Amplitudeの担当者を通じて機能のリクエストを送信してください。