RudderStack
RudderStack は、顧客イベントデータを収集し、希望するデータウェアハウスやBrazeなどの他の多数の分析プロバイダーにルーティングするための、オープンソースの顧客データインフラです。エンタープライズ対応で、イベントデータをダイナミックに処理するための強力な変換フレームワークを提供します。
BrazeとRudderStackの統合により、Android、iOS、およびWebアプリケーションのネイティブSDK統合と、バックエンドサービスからのサーバー間統合が提供されます。
前提条件
| 要件 | 説明 |
|---|---|
| RudderStack アカウント | このパートナーシップを利用するには、RudderStack アカウントが必要です。 |
| 設定済みのソース | ソースとは、Webサイト、モバイルアプリ、バックエンドサーバーなど、RudderStackに送信されるあらゆるデータの発生元のことです。RudderStackでBrazeを送信先として設定する前に、ソースを設定する必要があります。 |
| Braze REST APIキー | users.track、users.identify、users.delete、users.alias.new の権限を持つBraze REST APIキー。これは、Brazeダッシュボードの設定 > APIキーから作成できます。 |
| Braze アプリキー | アプリキーを取得するには、Brazeダッシュボードで設定 > アプリの設定 > 識別情報に移動し、アプリ名を見つけます。関連する識別子文字列を保存してください。 |
| データセンター | データセンターは、Brazeダッシュボードのインスタンスに対応しています。 |
連携
ステップ1:ソースを追加する
Brazeへのデータ送信を開始するには、まずRudderStackアプリでソースが設定されていることを確認する必要があります。データソースの設定方法については、RudderStackを参照してください。
ステップ2:送信先を設定する
データソースの設定が完了したら、RudderStackダッシュボードでDestinationsの下にあるADD DESTINATIONを選択します。利用可能な送信先のリストからBrazeを選択し、Nextをクリックします。
Brazeの送信先設定で、アプリキー、Braze REST APIキー、データクラスター、およびネイティブSDKオプション(デバイスモードのみ)を入力します。ネイティブSDKオプションを有効にすると、Brazeネイティブ SDKを使用してイベントが送信されます。
ステップ3:連携タイプを選択する
RudderStackのWebおよびネイティブクライアントサイドライブラリとBrazeの連携は、以下のいずれかの方法で行えます。
- サイドバイサイド / デバイスモード: RudderStackがクライアント(ブラウザーまたはモバイルアプリケーション)から直接Brazeにイベントデータを送信します。
- サーバー間 / クラウドモード: Braze SDKがイベントデータを直接RudderStackに送信し、そのデータが変換されてBrazeにルーティングされます。
- ハイブリッドモード: ハイブリッドモードを使用して、iOSおよびAndroidの自動生成イベントとユーザー生成イベントを単一の接続でBrazeに送信します。

サイドバイサイド連携(デバイスモード)
このモードでは、Webサイトまたはモバイルアプリに設定されたBraze SDKを使用してイベントをBrazeに送信できます。
サポートされているメソッドの説明に従って、Braze GitHubリポジトリでプラットフォームに対応するRudderStack SDKへのマッピングを設定してください。
デバイスモード連携を完了するには、プロジェクトへのBrazeの追加に関するRudderStackの詳細な手順を参照してください。
サーバー間連携(クラウドモード)
このモードでは、SDKがイベントデータを直接RudderStackサーバーに送信します。RudderStackがこのデータを変換し、目的の送信先にルーティングします。この変換は、RudderStackのバックエンドでRudderStackのトランスフォーマーモジュールを使用して行われます。
連携を有効にするには、サポートされているメソッドの説明に従って、RudderStackのメソッドをBrazeにマッピングする必要があります。

RudderStackのサーバーサイドSDK(Java、Python、Node.js、Go、Ruby)はクラウドモードのみをサポートしています。これは、サーバーサイドSDKがRudderStackのバックエンドで動作し、Braze固有のSDKを読み込むことができないためです。

サーバー間連携は、プッシュ通知やアプリ内メッセージングなどのBraze UI機能をサポートしていません。ただし、これらの機能はデバイスモード連携でサポートされています。
ハイブリッドモード
ハイブリッドモードを使用して、iOSおよびAndroidソースからすべてのイベントをBrazeに送信します。
ハイブリッドモードを選択してBrazeにイベントを送信すると、RudderStackは以下を実行します。
- Braze SDKを初期化します。
- すべてのユーザー生成イベント(identify、track、page、screen、group)をクラウドモードのみでBrazeに送信し、デバイスモードでの送信をブロックします。
- 自動生成イベント(Braze SDKを必要とするアプリ内メッセージ、プッシュ通知)をデバイスモードで送信します。
ハイブリッドモードでイベントを送信するには、ソースをBrazeの送信先に接続する際にハイブリッドモードオプションを使用します。次に、プロジェクトにBraze連携を追加します。
ステップ4:追加設定を構成する
初期設定が完了したら、Brazeでデータを正しく受信するために以下の設定を構成します。
- Enable subscription groups in group call:この設定を有効にすると、グループイベントで購読グループのステータスが送信されます。詳細については、Group を参照してください。
- Use Custom Attributes Operation:Brazeの階層化カスタム属性機能を使用して、カスタム属性オブジェクトによるセグメントの作成やメッセージのパーソナライズを行いたい場合は、この設定を有効にします。詳細については、Send user traits as nested custom attributes を参照してください。
- Track events for anonymous users:この設定を有効にすると、匿名ユーザーのアクティビティを追跡し、その情報をBrazeに送信します。
デバイスモードの設定
以下の設定は、デバイスモード経由でBrazeにイベントを送信する場合にのみ適用されます。
- Client-side Events Filtering:この設定では、Brazeに送信するイベントのブロックまたは許可を指定できます。この設定の詳細については、Client-side Events Filtering を参照してください。
- Deduplicate Traits:この設定を有効にすると、
identify呼び出しでユーザー特性の重複が排除されます。 - Show Braze logs:この設定は、ソースとして JavaScript SDK を使用している場合にのみ適用されます。有効にすると、Brazeのログがユーザーに表示されます。
- OneTrust Cookie Categories:この設定では、OneTrust の Cookie 同意グループをBrazeに関連付けることができます。
サポートされているメソッド
Brazeは、RudderStackのidentify、track、screen、page、group、aliasメソッドをサポートしています。
RudderStackのidentifyメソッドは、ユーザーをそのアクションに関連付けます。RudderStackは、一意のユーザーIDと、名前、メール、IPアドレスなど、そのユーザーに関連するオプションの特性を取得します。
identifyコールのデルタ管理
デバイスモード経由でBrazeにイベントを送信する場合、identifyコールの重複排除によってコストを削減できます。これを行うには、Deduplicate Traitsダッシュボード設定を有効にします。RudderStackは、変更または修正された属性(特性)のみをBrazeに送信します。
ユーザーの削除
RudderStackのData Regulation APIのSuppression with Delete regulationを使用して、Braze内のユーザーを削除できます。
RudderStackのtrackメソッドは、すべてのユーザーアクティビティとそれに関連するプロパティを取得します。
注文完了
RudderStack eCommerce APIを使用して、Order Completedという名前のイベントに対してtrackメソッドを呼び出すと、RudderStackはそのイベントに含まれる商品をpurchasesとしてBrazeに送信します。
RudderStackのscreenメソッドを使用すると、ユーザーのモバイル画面表示を、閲覧した画面に関する追加情報とともに記録できます。
RudderStackのpageメソッドを使用すると、Webサイトのページビューを記録できます。また、そのページに関するその他の関連情報も取得します。
RudderStackのgroupメソッドを使用すると、ユーザーをグループに関連付けることができます。
購読グループのステータス
購読グループのステータスを更新するには、RudderStackダッシュボードで「Enable subscription groups in group call」設定を有効にし、groupコール内で購読グループのステータスを送信します。
RudderStackのaliasメソッドを使用すると、既知のユーザーの異なるIDを統合できます。RudderStackはBrazeに対するaliasコールをクラウドモードでのみサポートしていることに注意してください。
ユーザー特性を階層化カスタム属性として送信する
ユーザー特性を階層化カスタム属性として Braze に送信し、追加、更新、削除の操作を実行できます。これを行うには、Braze の送信先を設定する際に、RudderStack の「Use Custom Attributes Operation dashboard」設定を有効にしてください。この機能はクラウドモードでのみ利用できます。
identify イベントで、ユーザー特性を階層化カスタム属性として以下の形式で送信できます。
rudderanalytics.identify("1hKOmRA4GRlm", {
"cars": {
"add": [{
"age": 27,
"id": 1,
"name": "Alex Keener"
}],
"update": [{
"age": 30,
"id": 2,
"identifier": "id",
"name": "Rowan"
},
{
"age": 27,
"id": 1,
"identifier": "id",
"name": "Alex"
}
]
},
"country": "USA",
"email": "[email protected]",
"firstName": "Alex",
"gender": "M",
"pets": [{
"breed": "beagle",
"id": 1,
"name": "Scooby",
"type": "dog"
},
{
"breed": "calico",
"id": 2,
"name": "Garfield",
"type": "cat"
}
]
})
track、page、または screen 呼び出しを使用してユーザー特性をカスタムユーザー属性として送信するには、イベント内のコンテキストフィールドとして traits を渡します。
rudderanalytics.track("Product Viewed", {
revenue: 8.99,
currency: "USD",
},{
"traits": {
"cars": {
"add": [{
"age": 27,
"id": 1,
"name": "Alex Keener"
}],
"update": [{
"age": 30,
"id": 2,
"identifier": "id",
"name": "Alex"
},
{
"age": 27,
"id": 1,
"identifier": "id",
"name": "Rowan"
}
]
},
"city": "Disney",
"country": "USA",
"email": "[email protected]",
"firstName": "Alexa",
"gender": "woman",
"pets": [{
"breed": "beagle",
"id": 1,
"name": "Scooby",
"type": "dog"
},
{
"breed": "calico",
"id": 2,
"name": "Garfield",
"type": "cat"
}
]
}
});

更新および削除の操作では、identifier は必須キーです。ネストされた配列に追加、更新、または削除の操作が存在しない場合、RudderStack はデフォルトで作成操作を使用してプロパティを作成します。階層化カスタム属性の送信の詳細については、オブジェクトの配列を参照してください。
トラブルシューティング
RudderStack のログに「[Braze Deduplication]: Duplicate user detected, the user is dropped」と表示される
このメッセージは、Deduplicate Traits が有効になっている場合に、RudderStack が変更のないユーザー属性を Braze に転送する前に削除した際に表示されます。これは Braze のエラーではありません。
RudderStack は、受信した identify および track の属性をユーザープロファイルと比較し、差分のない属性をスキップすることで、Braze のデータポイント使用量を削減します。詳細については、RudderStack の User Trait Deduplication in Braze ガイドを参照してください。
呼び出しのたびにすべての属性を送信する必要がある場合は、RudderStack の Braze 送信先設定で Deduplicate Traits をオフにしてください。ただし、これにより Braze のデータポイント消費量が増加する可能性がある点にご注意ください。