Brazeコネクタ構成ガイド

同意カテゴリ

• アナリティクス
• モバイル
• パーソナライゼーション

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタ概要の記事を参照してください。

コネクタを追加した後、以下の構成を構成します：

• APIエンドポイント
  （必須）アカウントがプロビジョニングされているインスタンスのAPIエンドポイントを選択します。
  詳細については、Braze APIエンドポイントを参照してください。
• APIキー
  （必須）users.trackおよびusers.deleteの権限が有効になっているAPIキーを提供します。
  詳細については、Braze App Group REST APIキーを参照してください。

追加情報については、BrazeドキュメントBraze Technology Partners: Tealiumを参照してください。

アクション

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

ユーザーを追跡アクションは、AudienceStreamとEventStreamの両方で同じ機能を含んでいます。ベストプラクティスとして、AudienceStreamアクションのユーザー属性マッピングを構成し、EventStreamアクションのイベントと購入マッピングを構成します。

ユーザーを追跡（バッチ/非バッチ）

できるだけ多くのIDパラメータをマッピングすることをお勧めします。アクションが複数のIDでトリガーされた場合、以下の優先順位に基づいて最初の空白でない値が選択されます：

• 外部ID
• Braze ID
• エイリアス名/エイリアスラベル

詳細については、Braze API: ユーザー追跡を参照してください。

バッチ対非バッチ

• バッチ: 大量のユーザープロファイルのバックフィルや同期に使用します。
• 非バッチ: リアルタイムのユースケースに使用します。

ピーク時のトラフィック状況では、Brazeは非バッチリクエストをバッチリクエストより優先して処理します。

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：1000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：2 MB

ユーザーID

ユーザー属性

Brazeのベストプラクティスに従い、変更されたユーザー属性のみを送信し、変更されていない属性の送信を避けることをお勧めします。変更されていない属性の送信を避けるために、訪問と訪問属性のエンリッチメントと、属性が変更されたときに認識するルールを使用します。詳細については、エンリッチメントルールを参照してください。

空の値はnullに変換され、Brazeユーザープロファイルから削除されます。

ユーザー属性の変更

次の操作を使用して数値ユーザー属性を変更します：

• インクリメント（正または負の値を受け入れる）
• デクリメント
• 加算

配列属性は、既存の配列から値を追加または削除することで変更します。

イベント

イベント名は Name にマッピングする必要があります。

同じ長さの配列属性をマッピングして複数のイベントを送信します。単一値属性を使用することもでき、各イベントに適用されます。

イベントテンプレート変数

データ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。

ドット表記を使用してネストされたテンプレート変数を名前付けします（例：items.name）。

ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。

イベントテンプレート

Body Dataで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。

テンプレートは、例えば {{SomeTemplateName}} のように、サポートされるフィールドに名前で注入されます。

購入

購入データをマッピングするには、Product ID、Currency、および Price の値をマッピングする必要があります。同じ長さの配列属性をマッピングして複数のイベントを送信します。単一値属性を使用することもでき、各イベントに適用されます。

次のコードサンプルは、複数の製品に対する単一イベントを受信するためのBrazeのベストプラクティス例を示しています：

// Tealiumへのイベント：
{
  [...]
  "tealium_event": "purchase",
  "product_name": ["Backpack", "Pencil", "Notebook"],
  "product_quantity": [1, 5, 3],
  "product_category": ["Travel", "Office", "Office"],
  "product_price": [39.95, 1.99, 3.99],
  "order_currency": "USD"
}

対応する製品配列属性をBrazeパラメータにマッピングします：

• product_name > Product ID
• product_quantity > Quantity
• product_price > Price

この例の結果は、以下の購入オブジェクトをBrazeに送信し、それぞれの製品を表します：

// Tealium Connector経由でBrazeへのペイロード：
{
  "purchases": [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Backpack",
      "currency" : "USD",
      "price" : 39.95,
      "time" : "2013-07-16T19:20:30+01:00",
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Pencil",
      "currency" : "USD",
      "price" : 1.99,
      "time" : "2013-07-16T19:20:30+01:00",
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Backpack",
      "currency" : "USD",
      "price" : 3.99,
      "time" : "2013-07-16T19:20:30+01:00",
    }
  ]
}

購入テンプレート変数

データ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。

ドット表記を使用してネストされたテンプレート変数を名前付けします（例：items.name）。

ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。

購入テンプレート

ネストされたオブジェクトを送信するためのテンプレートを定義します。

テンプレートが定義されている場合、Purchases セクションのマッピングは無視されます。

Body Dataで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。

テンプレートは、例えば {{SomeTemplateName}} のように、サポートされるフィールドに名前で注入されます。

ユーザー削除 (非バッチ)

各アクションには External ID、Braze ID、User Alias のいずれか一つが必要ですが、できるだけ多くの属性をマッピングすることをお勧めします。IDがマッピングされると、次の優先順位に基づいて最初の空白でない値が選択されます：

• External ID
• Braze ID
• Alias Name
• Alias Label

詳細については、Braze API: User Delete Endpointを参照してください。

パラメータ

ユーザー購読グループステータスの更新 (非バッチ)

詳細については、Braze API: Subscription Groups Endpointsを参照してください。

パラメータ

複数の購読グループでユーザー購読グループステータスを更新 (非バッチ)

パラメータ

キャンペーンメッセージの送信

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：50
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

キャンバスメッセージの送信

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：50
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

トランザクショナルメールの送信

パラメータ

ユーザーの特定

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：50
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：1 MB

パラメータ

よくある質問

このコネクタは他のBraze統合とどのように連携しますか？

Track User APIに加えて、Brazeにはユーザー属性のマッピングをサポートする追加のデータ収集方法があります。Tealiumは、以下の2つの独立したが類似した統合でWebおよびネイティブモバイル用のBraze SDKをサポートしています：

• Braze Web SDKタグ構成, Braze初期SDK構成
• AndroidおよびiOS/Swift用のTealiumリモートコマンド（詳細はこちら）

これらの統合は、コネクタのイベントおよび購入アクションで収集されるデータに類似したデータをBrazeが収集するために使用される代替方法です。