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を使う最初のステップは、属性を作成することです。属性を使用して、訪問者の習慣、好み、アクション、ブランドへのエンゲージメントを表す重要な特性を定義できます。
訪問属性:訪問属性は、ユーザーの現在の訪問(またはセッション)に関連します。これらの属性に保存されたデータは、訪問期間中持続します。訪問属性の例をいくつか挙げます。
- Visit Duration(数値)
- Current Browser(文字列)
- Current Device(文字列)
- Page View Count(数値)
訪問者属性:訪問者属性は現在のユーザーに関連します。これらの属性に保存されるデータは、ユーザーの存続期間全体にわたって持続します。訪問者属性の例としては、以下のものがあります。
- Lifetime Order Value(数値)
- First Name(文字列)
- Birthdate(日付)
- Purchases Brands(集計)
利用可能なデータタイプの全リストはTealiumを参照してください。
属性エンリッチメント
必要な属性を特定したら、それをエンリッチメント(属性の値をいつ、どのように更新するかを決定するビジネスルール)で構成できます。それぞれのデータ型は、属性の値を操作するための独自のエンリッチメントの選択肢を提供します。これは「WHEN」設定と関連しています。各訪問属性および訪問者属性で利用可能なオプションを以下に示します。
- New Visitor:訪問者がサイトに初めてアクセスしたときに発生します。
- New Visit:訪問者が新規に訪問した際に発生します。
- Any Event:任意のイベントで発生します。
- Visit Ended:訪問が終了したときに発生します。
また、エンリッチメントが発生するタイミングを決定するカスタム条件(ルール)を作成することもできます。
バッジ
バッジは、価値の高い行動パターンを表す特別な訪問者属性です。バッジは、訪問者のエンリッチメントのロジックに基づいて割り当てられたり、外されたりします。このロジックは通常、訪問者セグメントを捕捉するために複数の条件を組み合わせたり、特定の値に達したときのしきい値を設定したりします。
属性とバッジの例
すべての完了した注文(購入イベント)での顧客の累積支出額(order_total)を計算する訪問者属性「Lifetime Order Value」を作成します。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を選択して、バッジ割り当てのルールを作成します。このルールにタイトルを割り当て、前回作成した属性を使用して、ルールを「…属性 “Lifetime Order Value greater than 500” を持つ」と設定します。
- Saveをクリックし、Finishをクリックします。
ステップ2:オーディエンスを作成する
Tealiumのホームページから、サイドバーナビゲーションのAudienceStreamのAudiencesを選択します。ここでは、共通の属性を持つユーザーのオーディエンスを作成できます。このオーディエンスへのユーザーの出入りが、次のステップで設定するConnector Actionのトリガーとなり、この情報がBrazeのユーザープロファイルに渡されます。
まず、オーディエンスに名前を付けてから、作成するオーディエンスのタイプに適用する属性を検討します。たとえばVIPユーザーのオーディエンスを作成するには、VIPバッジを持つ訪問者のオーディエンスを作成することができます。
終了したら、オーディエンスを必ずSave / Publishしてください。
ステップ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、エイリアス名、エイリアスラベル。 - プッシュトークンをインポートする場合は、External IDとBraze IDを指定しないでください。 - ユーザーエイリアスを指定する場合、エイリアス名とエイリアスラベルの両方を設定する必要があります。 詳細については、Brazeの /users/trackエンドポイントを参照してください。 |
| ユーザー属性 | 既存のBrazeのユーザープロファイルのフィールド名を使用して、Brazeダッシュボードのユーザープロファイル値を更新するか、独自のカスタムユーザー属性データをユーザープロファイルに追加します。 - デフォルトでは、新規ユーザーが存在しない場合は作成されます。 - Update Existing Onlyを trueに設定すると、既存のユーザーのみが更新され、新しいユーザーは作成されません。- Tealium属性が空の場合、その属性はNULLに変換され、Brazeユーザープロファイルから削除されます。ユーザー属性を削除する目的でBrazeにNULL値を送信すべきでない場合は、エンリッチメントを使用してください。 |
| ユーザー属性の変更 | このフィールドを使用して、特定のユーザー属性を増減します。 - 整数属性は、正の整数または負の整数でインクリメントできます。 - 配列属性は、既存の配列に値を追加または削除することで変更できます。 |
| イベント | イベントは、タイムスタンプの時点で特定のユーザーによりカスタムイベントが1回発生したことを表します。このフィールドは、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、エイリアス名、エイリアスラベル。 - ユーザーエイリアスを指定する場合、エイリアス名とエイリアスラベルの両方を設定する必要があります。 詳細については、Brazeの /users/deleteエンドポイントを参照してください。 |

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

Finishを選択します。
まとめ
作成したコネクターの概要を表示します。選択したオプションを変更する場合は、Backを選択して編集するか、Finishを選択して完了します。
コネクターがTealiumホームページのコネクターリストに表示されます。
終了したら、必ずコネクターを保存またはパブリッシュしてください。設定したアクションは、トリガー接続が満たされたときに実行されます。
ステップ4:Tealiumコネクターをテストする
コネクターが稼動したら、正常に動作していることを確認するためにテストする必要があります。最も簡単なテスト方法は、TealiumのTraceツールを使用する方法です。Traceを使い始めるには、Tealium Toolsブラウザー拡張機能を追加していることを確認してください。
- 新しいトレースを開始するには、サイドバーのServer-SideのオプションからTraceを選択します。Startをクリックし、トレースIDをキャプチャします。
- ブラウザー拡張機能を開き、AudienceStream 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によって匿名プロファイルが作成されます。これにはボットトラフィックも含まれるため、アクティブユーザー数が膨らむ可能性があります。ユーザーが「Signed In」や「Watched Video」などのアクションを完了したときにのみユーザーの行動を追跡し、MAU数を減らしたい場合もあるでしょう。
解決策:
読み込みルールを設定して、タグがサイト上でいつどこで読み込まれるかを正確に制御します。ボットトラフィックのフィルタリングとSDKの条件付き初期化に関するより包括的なガイダンスについては、ボットトラフィックのフィルタリングを参照してください。