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: ユーザー追跡を参照してください。

バッチ制限

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

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

ユーザーID

ユーザー属性

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

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

ユーザー属性の変更

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

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

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

イベント

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

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

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

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

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

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

イベントテンプレート

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

テンプレートは、サポートされるフィールドに名前とダブルカーリーブレースで注入されます。例えば、{{SomeTemplateName}}。

購入

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

次のコードサンプルは、複数の製品の購入を含む単一イベントを受信するための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 > 製品ID
• product_quantity > 数量
• product_price > 価格

この例の結果は、Brazeに次のような購入オブジェクトを送信します。それぞれの製品を表しています：

// Tealiumコネクターを介して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: サブスクリプショングループエンドポイントを参照してください。

パラメータ

複数のサブスクリプショングループにわたるユーザーのサブスクリプショングループステータスの更新（非バッチ）

パラメータ

属性

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

バッチ制限

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

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

パラメータ

Canvasメッセージの送信

バッチ制限

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

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

パラメータ

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

パラメータ

ユーザーを特定する

バッチ制限

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

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

パラメータ

よくある質問

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

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

• Braze Web SDKタグ構成、Braze初期SDK構成
• Tealium Remote Command for Braze on Android and iOS/Swift (詳細はこちら)

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