Brazeコネクタ構成ガイド

同意カテゴリ

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

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

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

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

アクション

ユーザーの追跡アクションには、Customer Data Platform（CDP）とイベントストリーミングの両方で同じ機能が含まれています。ベストプラクティスとして、CDPアクションではユーザー属性のマッピングを構成し、イベントストリーミングアクションではイベントと購入のマッピングを構成してください。

アクション名	訪問プロファイル	イベントデータ
ユーザーの追跡（バッチ）	✓	✓
ユーザーの追跡（非バッチ）	✓	✓
ユーザーの削除（非バッチ）	✓	✓
ユーザーのサブスクリプショングループステータスの更新（非バッチ）	✓	✗
複数のサブスクリプショングループにわたるユーザーのサブスクリプショングループステータスの更新（非バッチ）	✓	✗
キャンペーンメッセージの送信	✓	✓
キャンバスメッセージの送信	✓	✓
トランザクションメールの送信	✓	✓
ユーザーの識別	✓	✓

ユーザーの追跡（バッチ／非バッチ）

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

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

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

バッチと非バッチ

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

トラフィックのピーク時には、Brazeはバッチリクエストよりも非バッチリクエストを優先します。

バッチ制限

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

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

ユーザーID

パラメータ	説明
外部ID	ユーザーの外部ID。
Braze ID	ユーザーのBraze ID。
ユーザーエイリアス名	ユーザーのエイリアス名。ユーザーエイリアスを指定する場合は、`Alias Name`と`Alias Label`の両方を構成する必要があります。
ユーザーエイリアスラベル	ユーザーのエイリアスラベル。ユーザーエイリアスを指定する場合は、`Alias Name`と`Alias Label`の両方を構成する必要があります。
顧客のメールアドレス	顧客のメールアドレス。
顧客の電話番号	顧客の電話番号。

ユーザー属性

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

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

パラメータ	説明
国	ユーザーの国。
現在地 - 緯度	追跡対象ユーザーの現在の緯度。
現在地 - 経度	ユーザーの現在の経度。
初回セッションの日付	ユーザーの初回セッションの日付。
最終セッションの日付	ユーザーの最終セッションの日付。
生年月日	ユーザーの生年月日。
メールアドレス	ユーザーのメールアドレス。
メールサブスクリプションステータス	ユーザーのメールサブスクリプションステータス。
Facebook	`id`（文字列）、`likes`（文字列の配列）、`num_friends`（整数）のいずれかを含むハッシュ。
名	ユーザーの名。
性別	ユーザーの性別。`M`、`F`、`O`（その他）、`N`（該当なし）、`P`（回答を希望しない）、またはnil（不明）。
居住都市	ユーザーの居住都市。
画像URL	ユーザープロファイルに関連付ける画像のURL。
言語	ISO 639-1形式によるユーザーの言語構成。詳細については、Braze：使用可能な言語コードの一覧を参照してください。
姓	ユーザーの姓。
メールをスパムとしてマークした日時	ユーザーのメールがスパムとしてマークされた日時。ISO 8601形式または`yyyy-MM-dd’T’HH:mm:ss:SSSZ`形式で表示されます。
電話番号	ユーザーの電話番号。
プッシュサブスクリプションステータス	`opt_in`（プッシュメッセージを受信するよう明示的に登録）、`unsubscribed`（プッシュメッセージの受信を明示的に解除）、または`subscribed`（オプトインもオプトアウトもしていない）に構成します。
プッシュトークンID配列	プッシュトークンの移行に使用するアプリIDの配列。詳細については、Braze API：APIを介した移行を参照してください。
プッシュトークン配列	プッシュトークンの配列。
プッシュトークンデバイスID配列	プッシュトークンの移行に使用するデバイスIDの配列。詳細については、Braze API：APIを介した移行を参照してください。
タイムゾーン	IANAタイムゾーンデータベースのタイムゾーン名。例：`America/New_York`または`Eastern Time (US & Canada)`。無効なタイムゾーン値は無視されます。
Twitter	ID（整数）、スクリーン名（文字列、Xのハンドル名）、フォロワー数（整数）、友達数（整数）、ステータス数（整数）のいずれかを含むハッシュ。
既存ユーザーのみ更新	`true`または`false`に構成します。ユーザー値が存在しない場合、デフォルトで作成されます。trueに構成すると、既存のユーザーのみが更新され、新しいユーザーは作成されません。

ユーザー属性の変更

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

増加（正または負の値を使用可能）
減少
加算

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

イベント

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

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

パラメータ	説明
App ID	アプリグループ内の特定のアプリに関連付けられた App Identifier API キー、または `app_id`。詳細については、Braze API：App Identifier API キーを参照してください。
Name	（必須）イベントの名前。
Time	イベントの時刻。値がマッピングされていない場合は、自動的に `now` に構成されます。
Update Existing Only (Events)	true または false に構成します。イベント値が存在しない場合は、デフォルトで新しく作成されます。true に構成すると、既存のイベントのみが更新され、新しいイベントは作成されません。

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

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

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

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

イベントテンプレート

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

テンプレートは、サポートされているフィールドに二重波括弧で囲んだ名前を使用して挿入します。例：{{SomeTemplateName}}。

購入

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

次のコードサンプルは、複数の商品購入を含む単一イベントを受信するための Braze のベストプラクティス例を示しています。

// event to 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

この例では、各商品を適切に表す次の purchases オブジェクトが Braze に送信されます。

// payload to Braze through Tealium Connector:
{
  "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",
    }
  ]
}

パラメータ	説明
App ID	イベントのアプリケーション ID。
Product ID	商品 ID の配列。購入イベントでは必須です。
Currency	購入に使用された通貨の ISO 4217 アルファベットコード。購入イベントでは必須です。
Price	商品価格の配列。購入イベントでは必須です。
Quantity	商品数量の配列。
Purchase Time	ISO 8601 形式の購入時刻。明示的にマッピングされていない場合は、自動的に `now` に構成されます。
Update Existing Only (Purchases)	（任意）値は `true` または `false` です。デフォルトでは、購入値が存在しない場合は新しく作成されます。`true` に構成すると、既存の購入のみが更新され、新しい購入は作成されません。

購入テンプレート変数

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

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

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

購入テンプレート

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

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

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

テンプレートは、サポートされているフィールドに二重波括弧で囲んだ名前を使用して挿入します。例：{{SomeTemplateName}}。

バッチの有効期間

パラメータ	説明
Batch Time To Live	（任意）バッチの有効期間（分）。1～60 の値を入力します。デフォルト値は 10 分です。間隔を短くするとデータがより早く送信されますが、API リクエストの頻度が増加する可能性があります。

ユーザーの削除（非バッチ）

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

External ID
Braze ID
Alias Name
Alias Label

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

パラメータ

パラメータ	説明
External ID	削除するユーザーの External ID。
Braze ID	削除するユーザーの Braze ID。
User Alias Name	削除するユーザーのエイリアス名。ユーザーエイリアスを指定する場合は、Alias Name と Alias Label の両方を構成する必要があります。
User Alias Label	削除するユーザーのエイリアスラベル。ユーザーエイリアスを指定する場合は、Alias Name と Alias Label の両方を構成する必要があります。
Customer Email Address	ユーザーのメールアドレス。
Customer Phone Number	E.164 形式のユーザーの電話番号。
Deletion Prioritization	削除するユーザーを識別するパラメータとして Customer Email Address を使用する場合は必須です。削除リクエストの優先順位を指定する配列です。指定できる値は、`most_recently_updated` と、`identified`（External ID を持つユーザー）または `unidentified`（External ID を持たないユーザー）のいずれかです。

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

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

パラメータ

パラメータ	説明
Group Type	（必須）管理するサブスクリプショングループのタイプ（`SMS` または `EMAIL`）。
Update Type	（必須）構成するサブスクリプション状態（`SUBSCRIBE` または `UNSUBSCRIBE`）。
Subscription Group ID	（必須）サブスクリプショングループの ID。
External ID	ユーザーの External ID。複数のユーザーも指定できます。
Email	（EMAIL サブスクリプショングループで使用）ユーザーのメールアドレス。 `EMAIL` グループで External ID が構成されていない場合、Email は必須です。
Phone	（SMS サブスクリプショングループで使用） E.164 形式の電話番号。例：`+1415555371` `SMS` グループで External ID が構成されていない場合、Phone は必須です。

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

パラメータ

パラメータ	説明
Group Type	（必須）管理するサブスクリプショングループのタイプ（`SMS`、`EMAIL`、または `SMS` と `EMAIL` の両方）。
Update Type	（必須）構成するサブスクリプション状態（`SUBSCRIBE` または `UNSUBSCRIBE`）。
Subscription Group ID	（必須）サブスクリプショングループの ID。ユーザーのステータスを複数のサブスクリプショングループで同時に更新するには、配列型属性をマッピングします。
External ID	ユーザーの External ID。 Email が構成されていない場合、External ID は必須です。
Email	（EMAIL サブスクリプショングループで使用）ユーザーのメールアドレス。 `EMAIL` グループで External ID が構成されていない場合、Email は必須です。
Phone	（SMS サブスクリプショングループで使用） E.164 形式の電話番号。例：`+1415555371` `SMS` グループで External ID が構成されていない場合、Phone は必須です。

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

バッチ制限

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

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

パラメータ

パラメータ	説明
キャンペーンID	（必須）キャンペーンID。
送信ID	特定のメッセージ送信用にBrazeによって生成されるか、ユーザーが作成するキー。分析はこのキーに基づいて追跡されます。
エイリアス名	エイリアスの値。
エイリアスラベル	エイリアスのキー。
外部ユーザーID	複数のデバイスにわたって同じユーザープロファイルを識別するために使用される値。
既存ユーザーのみに送信	デフォルト値は`true`です。`false`の場合は、属性オブジェクトも含める必要があります。
トリガープロパティ	メッセージテンプレート内で参照できる、パーソナライゼーション用のキーと値のペア。ネストされたオブジェクトにはテンプレートを使用します。
受信者属性	受信者属性を作成または更新します。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を指定します。詳細および使用例については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。
テンプレート	トリガープロパティで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、サポートされているフィールドに二重波括弧を使用して名前で挿入されます。例：`{{SomeTemplateName}}`。

Canvasメッセージの送信

バッチ制限

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

パラメータ

パラメータ	説明
Canvasデータ	Canvas ID - Brazeダッシュボード内の特定のCanvasに対してBrazeが生成するランダムキー。
エイリアス名	エイリアスの値。
エイリアスラベル	エイリアスのキー。
外部ユーザーID	複数のデバイスにわたって同じユーザープロファイルを識別するために使用される値。
既存ユーザーのみに送信	デフォルト値は`true`です。`false`の場合は、属性オブジェクトも含める必要があります。
トリガープロパティ	メッセージテンプレート内で参照できる、パーソナライゼーション用のキーと値のペア。ネストされたオブジェクトにはテンプレートを使用します。
受信者属性	受信者属性を作成または更新します。
Canvasエントリプロパティ	メッセージテンプレート内で参照できる、パーソナライゼーション用のキーと値のペア。ネストされたオブジェクトにはテンプレートを使用します。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を指定します。詳細および使用例については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。
テンプレート	トリガープロパティで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、サポートされているフィールドに二重波括弧を使用して名前で挿入されます。例：`{{SomeTemplateName}}`。

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

パラメータ

パラメータ	説明
キャンペーンID	（必須）キャンペーンID。
外部送信ID	特定の送信を識別するためのID。指定すると、このIDは重複排除キーとしても使用され、Brazeによって24時間保存されます。
エイリアス名	エイリアスの値。
エイリアスラベル	エイリアスのキー。
外部ユーザーID	複数のデバイスにわたって同じユーザープロファイルを識別するために使用される値。
トリガープロパティ	メッセージテンプレート内で参照できる、パーソナライゼーション用のキーと値のペア。ネストされたオブジェクトにはテンプレートを使用します。
受信者属性	受信者属性を作成または更新します。
テンプレート変数	テンプレートのデータ入力としてテンプレート変数を指定します。詳細および使用例については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。
テンプレート	トリガープロパティで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、サポートされているフィールドに二重波括弧を使用して名前で挿入されます。例：`{{SomeTemplateName}}`。

ユーザーの識別

バッチ制限

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

パラメータ

パラメータ	説明
外部ID	Brazeの外部IDにマッピングする属性を選択します。
エイリアス名	（必須）エイリアス名。
エイリアスラベル	（必須）エイリアスラベル。

よくある質問

このコネクタは他のBrazeインテグレーションとどのように連携しますか？

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

Braze Web SDKタグの構成、Braze SDKの初期構成
AndroidおよびiOS/Swift向けTealium Remote Command for Braze（詳細）

これらのインテグレーションは、コネクタのイベントアクションおよび購入アクションで収集されるデータと同様のユーザー行動データをBrazeが収集するための代替手段です。