Brazeコネクタ構成ガイド

コネクタのアクション

同意カテゴリ

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

構成の構成

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

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

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

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

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

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

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

アクション - ユーザーを追跡する（バッチ/非バッチ）

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

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

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

バッチ制限

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

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

ユーザーID

ユーザー属性

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

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

ユーザー属性の変更

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

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

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

イベント

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

複数のイベントを送信するために、等しい長さの配列属性をマッピングします。単一値属性を使用することもでき、それぞれのイベントに適用されます。

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

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

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

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

イベントテンプレート

Body Dataで参照されるテンプレートを提供します（参照：Trimouテンプレーティングエンジン)。

テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます（例：{{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 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）。

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

購入テンプレート

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

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

Body Dataで参照されるテンプレートを提供します（参照：Trimouテンプレートエンジン）。

テンプレートは、名前で二重中括弧によってサポートされたフィールドに注入されます（例：{{SomeTemplateName}}）。

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

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

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

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

パラメータ

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

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

パラメータ

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

パラメータ

属性

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

バッチ制限

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

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

パラメータ

Canvasメッセージを送信

バッチ制限

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

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

パラメータ

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

パラメータ

ユーザーを識別

バッチ制限

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

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

パラメータ

よくある質問

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

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

• Braze Web SDKタグ構成、Braze初期SDK構成
• AndroidとiOS/SwiftのBraze用Tealiumリモートコマンド (詳細を学ぶ)

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