コンテンツにスキップ

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にマッピングする必要があります。

ハイブリッドモード

ハイブリッドモードを使用して、iOSおよびAndroidソースからすべてのイベントをBrazeに送信します。

ハイブリッドモードを選択してBrazeにイベントを送信すると、RudderStackは以下を実行します。

  1. Braze SDKを初期化します。
  2. すべてのユーザー生成イベント(identify、track、page、screen、group)をクラウドモードのみでBrazeに送信し、デバイスモードでの送信をブロックします。
  3. 自動生成イベント(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"
      }
    ]
  }
});

トラブルシューティング

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 のデータポイント消費量が増加する可能性がある点にご注意ください。

New Stuff!