Tealium AudienceStream
Tealium AudienceStreamは、オムニチャネルの顧客セグメンテーションおよびリアルタイムアクションエンジンです。AudienceStreamはEventStreamに流入するデータを取得し、ブランドとの顧客エンゲージメントの最も重要な属性を表す訪問者プロファイルを作成します。
BrazeとTealiumの統合では、AudienceStreamの訪問者プロファイルを活用します。共有された行動によりこれらのプロファイルがセグメント化され、オーディエンスと呼ばれる共通の特徴を持つ訪問者のセットが作成されます。これらのオーディエンスは、コネクターを介してリアルタイムでマーケティングテクノロジースタックにデータを提供できます。

TealiumのAudienceStreamsとEventStreamsは、バッチと非バッチの両方のコネクターアクションを提供します。非バッチコネクターは、リアルタイムリクエストがユースケースにとって重要であり、BrazeのAPIレート制限仕様に達する懸念がない場合に使用してください。ご質問がある場合は、Brazeのサポートまたはカスタマーサクセスマネージャーにお問い合わせください。
前提条件
| 名前 | 説明 |
|---|---|
| Tealiumアカウント | サーバーサイドアクセスが可能なTealiumアカウントが必要です。このパートナーシップを最大限に活用するため、クライアントサイドの連携も併せて使用することをお勧めします。 |
| REST APIキー | users.track、users.delete、subscription.status.set の権限を持つBraze REST APIキー。これは、Brazeダッシュボード > 開発者コンソール > REST APIキー > 新しいAPIキーを作成で作成できます。 |
| Braze RESTエンドポイント | RESTエンドポイントURL。エンドポイントはお客様のインスタンスのBraze URLに応じて異なります。 |
連携
ステップ1: 属性とバッジを設定する
属性について
AudienceStream を使用する最初のステップは、属性を作成することです。属性を使用すると、訪問者の習慣、好み、アクション、およびブランドとのエンゲージメントを表す重要な特性を定義できます。
訪問属性: 訪問属性は、ユーザーの現在の訪問(またはセッション)に関連します。これらの属性に保存されたデータは、訪問の間保持されます。訪問属性の例は以下のとおりです。
- 訪問時間 (Number)
- 現在のブラウザ (String)
- 現在のデバイス (String)
- ページビュー数 (Number)
訪問者属性: 訪問者属性は、現在のユーザーに関連します。これらの属性に保存されたデータは、ユーザーの存続期間中保持されます。訪問者属性の例は以下のとおりです。
- 生涯注文額 (Number)
- 名 (String)
- 生年月日 (Date)
- 購入ブランド (Tally)
利用可能なデータ型の完全なリストについては、Tealium を参照してください。
属性エンリッチメント
目的の属性を特定したら、エンリッチメント(属性の値をいつ、どのように更新するかを決定するビジネスルール)で設定できます。各データ型は、属性の値を操作するための独自のエンリッチメントを提供しています。これは「WHEN」設定に関連付けられています。各訪問属性と訪問者属性には、以下のオプションが利用可能です。
- New Visitor: 訪問者が初めてサイトにアクセスしたときに発生します。
- New Visit: 訪問者による新しい訪問が発生したときに発生します。
- Any Event: 任意のイベントで発生します。
- Visit Ended: 訪問が終了したときに発生します。
エンリッチメントがいつ発生するかを決定するルールと呼ばれるカスタム条件を作成することもできます。
バッジ
バッジは、価値のある行動パターンを表す特別な訪問者属性です。バッジは、エンリッチメントのロジックに基づいて訪問者に割り当てられるか、または削除されます。このロジックは通常、訪問者セグメントをキャプチャするために複数の条件を組み合わせたり、特定の値に達した場合のしきい値を設定したりします。
属性とバッジの例
訪問者属性「Lifetime Order Value」を作成し、すべての完了した注文(購入イベント)に対する顧客の累積支出額(order_total)を計算します。Tealium アカウントで生涯注文額を設定するには、以下の手順に従ってください。
- AudienceStream > Visitor/Visit Attributes に移動し、Add Attribute をクリックします。
- スコープとして Visitor を選択し、Continue をクリックします。
- データ型として Number を選択し、Continue をクリックします。
- 属性の名前「Lifetime Order Value」を入力します。
- Add Enrichment をクリックし、Increment or Decrement Number を選択します。
- インクリメントする値を含む属性(
order_total)を選択します。 - 「WHEN」を「Any Event」のままにし、Create a New Rule をクリックします。
- 購入イベントが発生した場合を識別するルールを作成します。
- Save をクリックし、次に Finish をクリックします。
これで、すべての顧客に生涯注文額の属性が関連付けられます。
バッジを作成することで、特定の共通属性を持つユーザーを分類し、ターゲティングできます。以下の例では、「Lifetime Order Value」が500ドルを超えるユーザーに対して VIP バッジを作成します。
- AudienceStream > Visitor/Visit Attributes に移動し、Add Attribute をクリックします。
- スコープとして Visitor を選択し、Continue をクリックします。
- データ型として Badge を選択し、Continue をクリックします。
- バッジの名前「VIP」を入力します。
- Add Enrichment をクリックし、Assign Badge を選択します。
- 「WHEN」を「Any Event」のままにします。
- Create Rule を選択して、バッジ割り当てのルールを作成します。このルールにタイトルを付け、先ほど作成した属性を使用して、ルールを「…has attribute “Lifetime Order Value greater than 500”」に設定します。
- Save をクリックし、次に Finish をクリックします。
ステップ2: オーディエンスを作成する
Tealium のホームページから、サイドバーナビゲーションの AudienceStream 配下にある Audiences を選択します。ここでは、共通の属性を持つユーザーのオーディエンスを作成できます。このオーディエンスへのユーザーの入場または退出が、次のステップで設定するコネクターアクションのトリガーとなり、この情報が Braze のユーザープロファイルに渡されます。
まず、オーディエンスに名前を付け、作成しようとしているオーディエンスのタイプに適用される属性を検討します。たとえば、VIP ユーザーのオーディエンスを作成するには、VIP バッジを持つ訪問者のオーディエンスを作成できます。
完了したら、オーディエンスを保存/公開してください。
ステップ3: イベントコネクターを作成する
コネクターは、Tealium と他のベンダー間でデータを送信するために使用される連携です。これらのコネクターには、パートナーのサポートされている API を表すアクションが含まれています。
- Tealium のサイドバーの Server-Side 配下で、AudienceStream > Audience Connectors に移動します。
- 青い + Add Connector ボタンを選択して、コネクターマーケットプレイスを参照します。表示される新しいダイアログボックスで、スポットライト検索を使用して Braze コネクターを見つけます。
- このコネクターを追加するには、Braze コネクタータイルをクリックします。クリックすると、接続の概要と必要な情報のリスト、サポートされているアクション、および設定手順を確認できます。設定は、ソース、設定、アクションの3つのステップで構成されます。
ソース
表示される Source ダイアログで、前のステップで作成したオーディエンスと、状況に適したトリガーを選択します。また、頻度キャップを切り替えて、このアクションがトリガーされる頻度を制御することもできます。

設定
次に、Configuration ダイアログが表示されます。ページ下部の Add Connector を選択します。コネクターに名前を付け、Braze API エンドポイントと Braze REST APIキーをここに入力します。

以前にコネクターを作成したことがある場合は、利用可能なコネクターリストから既存のものを使用し、鉛筆アイコンでニーズに合わせて変更するか、ゴミ箱アイコンで削除できます。
このオーディエンスにリンクするコネクターを作成または選択したら、Done をクリックして続行します。
アクション
次に、コネクターアクションに名前を付け、設定するマッピングに従ってデータを送信するアクションタイプを選択します。ここでは、Braze 属性を Tealium 属性名にマッピングします。選択するアクションタイプによって、Tealium が必要とするフィールドの選択肢は異なります。以下は、これらのフィールドの例と説明です。

提供されているすべてのフィールドが必須ではありません。

このアクションでは、ユーザー、イベント、購入属性をすべて1つのアクションでトラッキングできます。Track User アクションは AudienceStream と EventStream の両方で同じですが、Tealium ではユーザー属性マッピングは AudienceStream アクションで、イベントおよび購入マッピングは EventStream アクションで設定することを推奨しています。
| パラメーター | 説明 |
|---|---|
| ユーザー ID | このフィールドを使用して、Tealium ユーザー ID フィールドを Braze の対応するフィールドにマッピングします。1つ以上のユーザー ID 属性をマッピングします。複数の ID が指定された場合、最初の空でない値が次の優先順位で選択されます: External ID、Braze ID、Alias Name、Alias Label。 - プッシュトークンをインポートする場合は、External ID と Braze ID を指定しないでください。 - ユーザーエイリアスを指定する場合は、エイリアス名とエイリアスラベルの両方を設定する必要があります。 詳細については、Braze の /users/track エンドポイントを参照してください。 |
| ユーザー属性 | 既存の Braze ユーザープロファイルフィールド名を使用して、Braze ダッシュボードのユーザープロファイル値を更新するか、独自のカスタムユーザー属性データをユーザープロファイルに追加します。 - デフォルトでは、ユーザーが存在しない場合は新しいユーザーが作成されます。 - Update Existing Only を true に設定すると、既存のユーザーのみが更新され、新しいユーザーは作成されません。- Tealium 属性が空の場合、null に変換され、Braze ユーザープロファイルから削除されます。ユーザー属性を削除するために null 値を Braze に送信しない場合は、エンリッチメントを使用する必要があります。 |
| ユーザー属性の変更 | このフィールドを使用して、特定のユーザー属性をインクリメントまたはデクリメントします - 整数属性は、正または負の整数でインクリメントできます。 - 配列属性は、既存の配列に値を追加または削除することで変更できます。 |
| イベント | イベントは、特定のユーザーによるカスタムイベントのタイムスタンプ付きの単一の発生を表します。このフィールドを使用して、Braze のイベントオブジェクトのようなイベント属性をトラッキングおよびマッピングします。 - マッピングされた各イベントには、イベント属性 Name が必須です。- イベント属性 Time は、明示的にマッピングされない限り、自動的に現在時刻に設定されます。- デフォルトでは、イベントが存在しない場合は新しいイベントが作成されます。 Update Existing Only を true に設定すると、既存のイベントのみが更新され、新しいイベントは作成されません。- 複数のイベントを追加するには、配列型属性をマッピングします。配列型属性は同じ長さである必要があります。 - 単一値属性を使用して、各イベントに適用できます。 |
| イベントテンプレート | ボディデータで参照されるイベントテンプレートを指定します。テンプレートを使用して、Braze に送信する前にデータを変換できます。詳細については、Tealium のテンプレートガイドを参照してください。 |
| イベントテンプレート変数 | データ入力としてイベントテンプレート変数を指定します。詳細については、Tealium のテンプレート変数ガイドを参照してください。 |
| 購入 | このフィールドを使用して、Braze の購入オブジェクトのようなユーザー購入属性をトラッキングおよびマッピングします。 - マッピングされた各購入には、購入属性 Product ID、Currency、Price が必須です。- 購入属性 Time は、明示的にマッピングされない限り、自動的に現在時刻に設定されます。- デフォルトでは、購入が存在しない場合は新しい購入が作成されます。 Update Existing Only を true に設定すると、既存の購入のみが更新され、新しい購入は作成されません。- 複数の購入アイテムを追加するには、配列型属性をマッピングします。配列型属性は同じ長さである必要があります。 - 単一値属性を使用して、各アイテムに適用できます。 |
| 購入テンプレート | テンプレートを使用して、Braze に送信する前にデータを変換できます。 - ネストされたオブジェクトのサポートが必要な場合は、購入テンプレートを定義します。 - 購入テンプレートが定義されると、アクションの購入セクションで設定された構成は無視されます。 - 詳細については、Tealium のテンプレートガイドを参照してください。 |
| 購入テンプレート変数 | データ入力として商品テンプレート変数を指定します。詳細については、Tealium のテンプレート変数ガイドを参照してください。 |

このアクションでは、Braze ダッシュボードからユーザーを削除できます。
| パラメーター | 説明 |
|---|---|
| ユーザー ID | このフィールドを使用して、Tealium ユーザー ID フィールドを Braze の対応するフィールドにマッピングします。 - 1つ以上のユーザー ID 属性をマッピングします。複数の ID が指定された場合、最初の空でない値が次の優先順位で選択されます: External ID、Braze ID、Alias Name、Alias Label。 - ユーザーエイリアスを指定する場合は、Alias Name と Alias Label の両方を設定する必要があります。 詳細については、Braze の /users/delete エンドポイントを参照してください。 |

このアクションでは、Braze の SMS またはメール購読グループにユーザーを追加または削除できます。
| パラメーター | 説明 |
|---|---|
| グループタイプ | このフィールドを使用して、SMS またはメールの購読グループかを指定します。 |
| 更新タイプ | このアクションを購読解除または購読イベントにマッピングします。 |
| 属性 | - 購読グループ ID(必須): 前のフィールドでマッピングされたグループタイプに関連する購読グループの ID。 - External ID: ユーザーの external ID。 メールグループ固有: - メール: ユーザーのメールアドレス。 external ID が定義されていない場合は、メールが必須です。 SMS グループ固有: - 電話番号: E.164形式の電話番号。例: +14155552671。 external ID が定義されていない場合は、電話番号が必須です。 |

Finish を選択します。
サマリー
作成したコネクターのサマリーを確認します。選択したオプションを変更する場合は、Back を選択して編集するか、Finish を選択して完了します。
コネクターが Tealium ホームページのコネクターリストに表示されます。
完了したら、コネクターを保存または公開してください。設定したアクションは、トリガー接続条件が満たされたときに実行されます。
ステップ4: Tealium コネクターをテストする
コネクターが稼働したら、正しく動作していることを確認するためにテストする必要があります。最も簡単なテスト方法は、Tealium の Trace Tool を使用することです。Trace の使用を開始するには、Tealium Tools ブラウザ拡張機能が追加されていることを確認してください。
- 新しいトレースを開始するには、Server-Side オプション配下のサイドバーから Trace を選択します。Start をクリックし、Trace ID を取得します。
- ブラウザ拡張機能を開き、AudienceStream Trace に Trace ID を入力します。
- リアルタイムログを確認します。
- 検証するアクションを確認するには、Actions Triggered エントリをクリックして展開します。
- 検証するアクションを見つけ、ログステータスを確認します。
Tealium の Trace ツールの実装に関する詳細な手順については、Tealium の Trace ドキュメントを参照してください。
連携デモ
データポイントの超過料金が発生する可能性
Tealiumを通じてBrazeを統合する際に、意図せずデータの超過料金が発生する主な原因が3つあります。
重複データの送信 - Brazeには属性の差分のみを送信する
Tealiumはユーザー属性のBrazeデルタを送信しません。例えば、ユーザーの名、メールアドレス、携帯電話番号をトラッキングするEventStreamアクションがある場合、アクションがトリガーされるたびにTealiumは3つの属性すべてをBrazeに送信します。Tealiumは何が変更または更新されたかを確認してその情報のみを送信するということはしません。
ソリューション:
バックエンドで属性が変更されたかどうかを確認し、変更があった場合はTealiumの関連メソッドを呼び出してユーザープロファイルを更新できます。これは、Brazeを直接統合するユーザーが通常行う方法です。
または
バックエンドにユーザープロファイルの独自バージョンを保存しておらず、属性が変更されたかどうかを判断できない場合は、AudienceStreamを使用してエンリッチメントを作成し、値が変更された場合にのみユーザー属性を送信できます。
無関係なデータの送信やデータの不必要な上書き
同じイベントフィードをターゲットとする複数のEventStreamがある場合、そのコネクターで有効化されているすべてのアクションは、1つのアクションがトリガーされるたびに自動的に発火します。これにより、Brazeでデータが上書きされる可能性もあります。
ソリューション:
各アクションをトラッキングするために、個別のイベント仕様またはフィードを設定します。
または
Tealiumダッシュボードのトグルを使用して、発火させたくないアクション(またはコネクター)を無効化します。
Brazeの初期化が早すぎる
Braze Web SDKタグを使用してTealiumと統合している場合、MAUが大幅に増加する可能性があります。ページ読み込み時にBrazeが初期化されると、WebユーザーがWebサイトに初めてアクセスするたびに、Brazeは匿名プロファイルを作成します。これにはボットトラフィックも含まれ、アクティブユーザー数が膨らむ可能性があります。MAU数を抑えるために、「サインイン済み」や「動画視聴済み」など、ユーザーが特定のアクションを完了した場合にのみユーザー行動をトラッキングしたい場合もあるでしょう。
ソリューション:
読み込みルールを設定して、サイト上でタグがいつどこで読み込まれるかを正確に制御します。ボットトラフィックのフィルタリングやSDKの条件付き初期化に関するより包括的なガイダンスについては、ボットトラフィックのフィルタリングを参照してください。