Brazeコネクタの構成ガイド

コネクタのアクション

同意カテゴリ

• 分析
• モバイル
• パーソナライゼーション

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタの追加方法については、コネクタの概要の記事を参照してください。

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

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

詳細については、BrazeドキュメントのBrazeテクノロジーパートナー：Tealiumを参照してください。

アクションの構成 - パラメータとオプション

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

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

アクション - ユーザーのトラッキング（バッチ/非バッチ）

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

• 外部ID
• Braze ID
• 別名

詳細については、Braze API：ユーザートラックを参照してください。

バッチ制限

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

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

ユーザーID

ユーザー属性

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

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

ユーザー属性の変更

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

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

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

イベント

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

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

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

データ入力としてテンプレート変数を提供します（詳細は：テンプレート変数を参照）。

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

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

イベントテンプレート

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

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

トリガープロパティ内で参照するために、トリガープロパティに対してテンプレートを提供します。詳細については、Trimouテンプレートエンジンを参照してください。

テンプレートは、サポートされているフィールドに二重の中括弧で名前を付けて挿入されます（例：{{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コネクタ経由で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セクションのマッピングは無視されます。

トリガープロパティ内で参照するために、トリガープロパティに対してテンプレートを提供します。詳細については、Trimouテンプレートエンジンを参照してください。

テンプレートは、サポートされているフィールドに二重の中括弧で名前を付けて挿入されます（例：{{SomeTemplateName}}）。

アクション - ユーザーの削除（非バッチ）

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

• 外部ID
• Braze ID
• 別名
• 別名ラベル

詳細については、Braze API：ユーザー削除エンドポイントを参照してください。

パラメータ

アクション - ユーザーサブスクリプショングループのステータスの更新（非バッチ）

詳細については、Braze API：サブスクリプショングループエンドポイントを参照してください。

パラメータ

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

バッチ制限

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

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

パラメータ

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

バッチ制限

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

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

パラメータ

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

パラメータ

ユーザーの識別

バッチ制限

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

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

パラメータ

よくある質問

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

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

• Braze Web SDKタグのセットアップ、Braze Initial SDK Setup
• AndroidおよびiOS/Swift用のTealium Remote Command for Braze（詳細はこちら）

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