Tealium
Tealium は、EventStream、AudienceStream、および iQ Tag Management で構成されるユニバーサルデータハブおよびカスタマーデータプラットフォームであり、サードパーティのソースのモバイルデータ、Web データ、および代替データを接続できます。Tealium を Braze と接続することで、カスタムイベント、ユーザー属性、購入のデータフローが実現し、リアルタイムでデータを操作できるようになります。
BrazeとTealiumインテグレーションを使用すると、ユーザーを追跡し、さまざまなユーザー 分析プロバイダーにデータをルーティングできます。Tealiumでは次の操作ができます。
- AudienceStreamで Tealium オーディエンスを Braze に同期し、Braze キャンペーンとキャンバスのパーソナライズ、またはセグメントの作成に使用できるようにします。
- プラットフォーム間でデータをインポートします。Braze は、Android、iOS、およびWeb アプリの各アプリケーションに並列SDKインテグレーションと、イベントデータにレポートできる任意のプラットフォーム内で使用できるserver-to-serverインテグレーションの両方を提供します。
Tealium EventStream は、データの中央に位置するデータ収集および API ハブです。EventStream は、セットアップとインストールから、受信ユーザーデータの識別、検証、および拡張まで、データサプライチェーン全体を処理します。EventStream は、イベントフィードとコネクターを使用してリアルタイムアクションを実行します。以下は、EventStreamを構成する機能です。
- データソース (インストールおよびデータ収集)
- ライブイベント(リアルタイムデータ検査)
- イベント仕様と属性s(データレイヤー要件と検証)
- イベントフィード (フィルタリングされたイベントタイプ)
- イベントコネクター(API ハブアクションs)
Tealium AudienceStreamはオムニチャネル 顧客 セグメンテーションでリアルタイムのアクションエンジンです。AudienceStream は EventStream に流入するデータを取得し、ブランドのカスタマーエンゲージメントの最も重要な属性を表す訪問者プロファイルを作成します。設定ステップについては、AudienceStreamを参照してください。
Tealium iQ では、Tealium iQ Tag Management UI でタグを使用してアプリでコードをトリガーできます。このタグにより、モバイルおよび Web プラットフォームからイベントデータが収集、制御、および配信されます。これにより、アプリケーションに Braze 固有のコードを追加することなく、ネイティブの Braze 実装を設定できます。ユーザーは、iQ Tag Management または JSON 設定ファイルを使用してモバイルリモートコマンドを統合できます (Tealium アプローチが推奨されます)。Braze Web SDK を使用するユーザーは、Web iQ タグを使用して統合を行う必要があります。
各メソッドの長所と短所について詳しくは、以下の Tealium iQ タグ マネージャー を参照してください。
Tealium は、バッチと非バッチの両方のコネクターアクションを提供します。非バッチコネクターは、リアルタイムリクエストがユースケースにとって重要であり、Braze の API レート制限指定に達する懸念がない場合にのみ使用してください。不明な点がある場合は、Brazeサポートまたは顧客のサクセスマネージャーにお問い合わせください。
バッチ・コネクターの場合、要求は、以下のいずれかのしきい値が満たされるまでキューに入れられます。
- 最大リクエスト数:75
- 最も古いリクエストからの最大経過時間:10分
- 要求の最大サイズ1 MB
Tealium は、デフォルトでは同意イベント (サブスクリプション設定) またはユーザー削除イベントをバッチ処理しません。
前提条件
| 必要条件 | 説明 |
|---|---|
| Tealium アカウント | この提携を進めるには、サーバーおよび/またはクライアントサイドアクセスを持つTealiumアカウントが必要です。 |
| インストールされたソースと Tealium ソースのライブラリ | モバイルアプリ、Web サイト、バックエンドサーバーなど、Tealium に送信されるデータの提供元。 適切な Tealium コネクターを設定できるようにするには、ライブラリをアプリ、サイト、サーバーにインストールしておく必要があります。 |
| Braze RESTとSDKエンドポイント | REST または SDK エンドポイントの URL。エンドポイントはインスタンスの Braze URL に応じて異なります。 |
| Braze アプリ 識別子鍵(横並びのみ) | アプリ識別子キー。 これは、Braze ダッシュボード > [設定の管理] > [API キー] で確認できます。 |
| コードバージョン(並列のみ) | SDK バージョンに対応し、major.minor 形式である必要があります (3.0.1ではなく3.2など)。コードバージョンは3.0以上である必要があります。 |
| REST API キー(サーバ間のみ) | users.track およびusers.delete 権限を持つBraze REST API キー。これは Brazeダッシュボード > [開発者コンソール] > [REST API キー] > [新しい API キーを作成] で作成できます。 |
統合タイプを選択する
| 統合 | 詳細 |
|---|---|
| サイドバイサイド | Tealium の SDK を使用して、イベントを Braze のネイティブ呼び出しに変換します。これにより、サーバー間統合よりも高度な機能にアクセスでき、Braze をより包括的に使用できるようになります。 Brazeのリモートコマンドを使用する場合は、TealiumがすべてのBraze方法(コンテンツカードなど)に対応しているわけではないことに注意してください。対応するリモートコマンドにマッピングされていない Braze メソッドを使用するには、ネイティブ Braze コードをコードベースに追加してメソッドを呼び出す必要があります。 |
| サーバー間 | Tealium から Braze REST API エンドポイントにデータを転送します。 アプリ メッセージング内、コンテンツカード、プッシュ通知などのBrazeのユーザーインターフェイス機能には対応していません。また、この方法では利用できないデバイスレベルのフィールドなど、自動的に取得されるデータも存在します。 これらの機能を使用する場合は、並列統合を検討してください。 |
サイドバイサイドの SDK 統合
リモートコマンド
リモートコマンドは、Tealium iOS および Android ライブラリの機能であり、Tealium SDK から Braze サーバーを介して Braze への呼び出しを実行できるようにします。Braze リモートコマンドモジュールは、必要な Braze ライブラリを自動的にインストールおよびビルドし、すべてのメッセージレンダリングと分析トラッキングを処理します。Braze モバイルリモートコマンドを使用するには、アプリs にインストールされているTealium ライブラリが必要です。
Tealium には、モバイルリモートコマンドを統合する2 つの方法があります。統合タイプ間で機能が失われることはなく、基礎となるネイティブコードは同じです。
| モバイルリモートコマンド方式 | 長所 | 短所 |
|---|---|---|
| リモートコマンドタグ | Tealium iQ UI を使用して、リモートコマンドに送信されるデータとマッピングを簡単に変更できます。 これにより、アプリがすでにアプリストアに入った後、クライアントがアプリを更新する必要なく、追加のデータまたはイベントをサードパーティSDKに送信できます。 |
アプリのタグマネジメントモジュールは、非表示のWeb ビューに依存してJavaScript を処理します。 |
| JSON構成ファイル (推奨) |
JSONメソッドを使用すると、アプリで非表示のWebビューを使用する必要がなくなり、メモリー使用量が大幅に削減されます。 JSON ファイルは、顧客のアプリ内でリモートまたはローカルにホストできます。 |
現時点では、これを管理するUIがないため、少し手間がかかります。 注:Tealium は、この問題を解決し、iQ Tag Management バージョンと同じレベルの柔軟性を JSON リモートコマンドに取り入れる Management UIの追加に取り組んでいます |
Braze モバイルリモートコマンドのデータマッピングを使用して、デフォルトのユーザー属性とカスタム属性を設定し、購入とカスタムイベントを追跡します。対応するBraze方法については、次の表を参照してください。
| リモートコマンド | Braze のメソッド |
|---|---|
| appendcustomarrayattribute | addToCustomAttributeArrayWithKey() |
| emailnotification | setEmailNotificationSubscriptionType() |
| incrementcustomattribute | incrementCustomAttribute() |
| Initalize | startWithApiKey() |
| logcustomevent | logCustomEvent() |
| logpurchase | logPurchase() |
| pushnotification | setPushNotificationSubscriptionType() |
| removecustomattribute | setCustomAttributeWithKey() |
| setcustomattribute | setCustomAttributeArrayWithKey() |
| setcustomarrayattribute | setCustomAttributeArrayWithKey() |
| setlastknownlocation | setLastKnownLocationWithLatitude() |
| unsetcustomattribute | unsetCustomAttributeWithKey() |
| useralias | addAlias() |
| userattribute | ABKUser() |
| useridentifier | changeUser() |
Braze モバイルリモートコマンドの設定方法の詳細と、サポートされている方法の概要については、Tealium 開発者 ドキュメントを参照してください。
Braze モバイルリモートコマンドは、すべての Braze メソッドとメッセージングチャネルをサポートしているわけではありません (コンテンツカードなど)。対応するリモートコマンドにマッピングされていない Braze メソッドを使用するには、ネイティブ Braze コードをコードベースに追加してメソッドを直接呼び出す必要があります。
Braze Web SDK タグ
Web サイトに Braze Web SDK をデプロイするには、Braze Web SDK タグを使用します。Tealium iQ Tag Management により、顧客は訪問者のアクティビティを追跡するために Tealium ダッシュボード内でタグとして Braze を追加できます。タグは一般的に、オンライン広告、メールマーケティング、およびサイトのパーソナライゼーションの効果を理解する目的でマーケターにより使用されます。
- Tealium で [iQ] > [Tags] > [+ Add Tag] > [Braze Web SDK] に移動します。
- [Tag Configuration] ダイアログボックスで、API キー (Braze アプリ識別子キー)、ベース URL (Braze SDK エンドポイント)、およびBraze Web SDK コードバージョン を入力します。また、ロギングを有効にして、デバッグ目的で Web コンソールに情報を記録することもできます。
- [Load Rules] ダイアログボックスで [Load on All Pages] を選択するか、または [Create Rule] を選択して、サイトでこのタグのインスタンスをいつどこに読み込むかを決定します。
- Data Mアプリingsダイアログボックスで、Create Mアプリingsを選択してTealiumデータをBrazeにマッピングします。Braze Web SDK タグの宛先変数は、タグの [Data Mapping] タブに組み込まれています。これらの表に、使用可能な宛先カテゴリと、それぞれの宛先名の説明が示されています。
- [Finish] を選択します。
サイドバイサイド統合のリソース
- iOS リモートコマンド:Tealium ドキュメント,Tealium GitHub リポジトリ
- Androidリモートコマンド:Tealium ドキュメント,Tealium GitHub リポジトリ
- Web SDK タグ:Tealium ドキュメント
サーバー間統合
この統合により、Tealium から Braze REST API にデータが転送されます。
サーバー間統合では、アプリ内メッセージング、コンテンツカード、プッシュ通知などの Braze UI 機能はサポートされていません。また、このメソッドでは使用できない、自動的にキャプチャされるデータ(デバイスレベルのフィールドなど) もあります。
このデータとこれらの機能を使用する場合は、並列SDKインテグレーションを検討してください。
ステップ1: ソースを設定する
Tealium では最初に、コネクターの取得元となる有効なデータソースを設定する必要があります。
- Tealium のサイドバーの [Server-Side] から [Sources] > [Data Sources] > [+ Add Data Source] に移動します。
- 使用可能なカテゴリ内で目的のプラットフォームを見つけ、ソースに名前を付けます。これは必須フィールドです。
- Event Specificationsオプションから、含めるイベント仕様を選択します。イベント仕様は、インストールで追跡するイベント名と必須属性を特定するのに役立ちます。これらの仕様は受信イベントに適用されます。
どのデータがあなたにとって最も価値があるのか、どの仕様があなたのユースケースに最も適しているのか、時間をかけて考えてみよう。カスタムイベント仕様も可能です。 - 次に、Get Codeステップに進みます。ここで提供されるベースコードとイベント追跡コードは、インストールガイドとして機能します。これらの指示を共有したい場合は、提供されたPDF を読み込むします。終了したらSave& Continueを選択する。
- これで、保存したソースを表示し、イベント仕様を追加または削除することができます。
詳細なデータソースビューから、次のアクションを実行できます。- データソース鍵の表示と複製
- インストール手順を表示する
- Get Codeページに戻る
- イベント仕様の追加または削除
- イベント仕様に関連するライブイベントを表示するために移動します
- その他
- 最後に、ページの上部にあるSave / Publishを選択します。ソースを公開しないと、Braze コネクターの設定時にソースを見つけることができません。
データソースの設定と編集の詳細な手順については、データソースを参照してください。
ステップ2:イベントコネクターを作成する
コネクターとは、Tealium と他のベンダーの間でデータを伝送するために使用される統合です。これらのコネクターには、パートナーがサポートするAPI を表すアクションが含まれています。
- Tealium のサイドバーの [Server-Side] から [EventStream] > [Event Connectors] に移動します。
- 青色の [＋Add Connector] ボタンを選択して、コネクターマーケットプレースを参照します。アプリが耳にする新しいダイアログボックスで、スポットライト検索を使用してBraze コネクターを見つけます。
- このコネクターを追加するには、Brazeコネクタータイルを選択します。クリックすると、接続の概要と、必要な情報、サポートされるアクション、および設定手順の一覧が表示されます。この設定は、ソース、設定、アクションの3つのステップで構成されています。
ソース
ソースの設定が完了したら、[EventStream] > [Event Connectors] > [+ Add Connector] > [Braze] の Braze コネクタページに戻ります。
作成したデータソースを選択し、Event FeedでAll Eventsまたは特定のイベント仕様を選択して、変更された値のみをBrazeに送信する推奨パスを選択します。Continueを選択します。
構成
次に、ページの下部でAdd Connector を選択します。コネクターに名前を付け、Braze エンドポイントと Braze REST API キーを指定します。
以前にコネクターを作成したことがある場合は、利用可能なコネクターのリストにある既存のコネクターを使用し、鉛筆アイコンでニーズに合わせて変更するか、ゴミ箱アイコンでコネクターを削除することができます。
アクション (Action)
次に、コネクターアクションに名前を付け、設定するマッピングに従ってデータを送信するアクションタイプを選択します。ここでは、Braze の属性、イベント、および購入をTealium の属性、イベント、および購入名にマッピングします。
提供されるすべてのフィールドが必要なわけではありません。
このアクションを使用すると、ユーザー、イベント、購入属性をすべて1回のアクションで追跡できます。
| パラメータ | 説明 |
|---|---|
| ユーザー ID | このフィールドを使用して、Tealium のユーザー ID フィールドを Braze の対応するフィールドにマッピングします。1 つ以上のユーザー ID 属性をマップします。複数のID が指定されている場合、最初の非ブランク値は、次の優先順位に基づいて選択されます。External ID、Braze ID、エイリアス名、エイリアスラベル。 - プッシュトークンs をインポートする場合は、外部ID とBraze ID を指定しないでください。 - ユーザーエイリアスを指定する場合、エイリアス名とエイリアスラベルの両方を設定する必要があります。 詳細については、Braze /users/track エンドポイント を参照してください。 |
| ユーザ属性 | 既存の Braze のユーザープロファイルのフィールド名を使用して、Braze ダッシュボードのユーザープロファイル値を更新するか、独自のカスタムユーザー属性データをユーザープロファイルに追加します。 - デフォルトでは、新規ユーザーが存在しない場合は作成されます。 - 設定では、** 更新 Existing Only** to true で、存在するユーザー のみが更新d になり、新しいユーザーは作成されません。- Tealium 属性が空の場合、その属性は NULL に変換され、Braze ユーザープロファイルから削除されます。ユーザー属性を削除する目的で Braze に NULL 値を送信すべきでない場合は、エンリッチメントを使用してください。 |
| ユーザー属性の変更 | このフィールドを使用して、特定のユーザー 属性を増減します - 整数属性は、正の整数または負の整数でインクリメントできます。 - 配列属性s は、既存の配列に数値を追加または削除することで修正できます。 |
| イベント | イベントは、タイムスタンプの時点で特定のユーザーによりカスタムイベントが 1回発生したことを表します。このフィールドは、Braze イベントオブジェクトの属性と同様にイベント属性を追跡、マッピングする場合に使用します。 - イベント属性 Name は、マッピングされたすべてのイベントで必要です。- イベント属性 Time は、明示的にマッピングされていない限り、自動的に現時点の時刻に設定されます。- デフォルトでは、新しいイベントは存在しない場合に作成されます。 Update Existing Only をtrue に設定すると、既存のイベントのみが更新され、新規のイベントは作成されません。- 配列型属性s をマップして、複数のイベントを追加します。配列型の属性s は等しい長さでなければなりません。 - 単一値属性を使用できます。単一値属性は各イベントに適用できます。 |
| イベントテンプレート | ボディデータで参照するイベントテンプレートを指定します。テンプレートを使用してデータを変換してから、Brazeに送信できます。詳細については、Tealiumのテンプレートガイドを参照してください。 |
| イベントテンプレート変数 | イベントテンプレート変数をデータ入力として指定します。詳細については、Tealiumのテンプレート変数ガイドを参照してください。 |
| 購入 | このフィールドは、Braze 購入オブジェクトの属性と同様に購入属性を追跡、マッピングする場合に使用します。 - 購入属性 Product ID、Currency、Price は、マッピングされたすべての購入に必要です。- 購入属性 Time は、明示的にマッピングされていない限り、自動的に現時点の時刻に設定されます。- デフォルトでは、新規購入が存在しない場合は作成されます。 Update Existing Only をtrue に設定すると、既存の購入のみが更新され、新規購入は作成されません。- 配列型属性s をマップして、複数の購入アイテムを追加します。配列型の属性s は等しい長さでなければなりません。 - 単一値属性を使用できます。単一値属性は各アイテムに適用されます。 |
| 購買テンプレート | テンプレートを使用して、Brazeに送信する前にデータを変換できます。 - ネストされたオブジェクトサポートが必要な場合は、購入テンプレートを定義します。 - 購入テンプレートを定義すると、アクションの購入セクションで設定された設定は無視されます。 - 詳細については、Tealiumのテンプレートガイドを参照してください。 |
| 購買テンプレート変数 | 商品テンプレートの項目を入力します。詳細については、Tealiumのテンプレート変数ガイドを参照してください。 |
このアクションでは、Braze ダッシュボードからユーザーを削除できます。
| パラメータ | 説明 |
|---|---|
| ユーザー ID | このフィールドを使用して、Tealium のユーザー ID フィールドを Braze の対応するフィールドにマッピングします。 - 1 つ以上のユーザー ID 属性をマップします。複数のID が指定されている場合、最初の非ブランク値は、次の優先順位に基づいて選択されます。External ID、Braze ID、エイリアス名、エイリアスラベル。 - ユーザーエイリアスを指定する場合、エイリアス名とエイリアスラベルの両方を設定する必要があります。 詳細については、Braze /users/delete エンドポイント を参照してください。 |
選択したオプションを変更する場合は、Back を選択して編集するか、Finish を選択して完了します。
Continueを選択します。
コネクターが Tealium ホームページのコネクターリストに表示されます。
完了したら、コネクタの [保存 / 公開] を選択してください。設定したアクションは、トリガー接続が満たされたときに実行されます。
ステップ3:Tealium コネクターをテストする
コネクターが稼動したら、正常に動作していることを確認するため、コネクターをテストする必要があります。これを検証する最も簡単な方法は、Tealiumトレースツールを使用することです。Trace の使用を開始するには、Tealium Tools ブラウザー拡張機能が追加されていることを確認します。
- 新しいトレースを開始するには、サイドバーの [Server-Side] のオプションから [Trace] を選択します。[開始] を選択し、トレース ID をキャプチャします。
- ブラウザー拡張機能を開き、AudienceStream Trace にトレース ID を入力します。
- リアルタイムログを調べます。
- Actions Triggeredエントリを選択して展開し、検証したいアクションをチェックする。
- 検証するアクションを探して、ログステータスを表示します。
Tealium の [Trace ツールの詳しい実装手順については、Tealium の Trace ドキュメントを参照してください。
統合デモ
潜在データポイント 超過料金s
Tealiumを通じてBrazeを統合する際に、誤って不必要なデータポイントを記録してしまう可能性がある主な方法は3つある：
重複データの送信- Brazeの属性の差分のみを送信します
Tealium はユーザー属性の Braze 差分を送信しません。たとえば、EventStream アクションでユーザーの名、メール、および携帯電話番号を追跡している場合、このアクションがトリガーされると、Tealium は3つの属性すべてを Braze に送信します。Tealium は、変更された内容や更新された内容を探してその情報のみを送信することはありません。
解決策:
バックエンドを確認して、属性が変更されているかどうかを評価し、変更されている場合は、Tealium の関連メソッドを呼び出してユーザープロファイルを更新できます。これは、Braze を直接統合するユーザーが通常行う作業です。
または
自分自身のユーザープロファイルをバックエンドに保存しておらず、属性が変更されたかどうかを判断できない場合は、AudienceStream を使用して
エンリッチメントを作成 値が変更されたときにのみユーザー 属性s を送信します。エンリッチメントルールに関する Tealium のドキュメントを参照してください。
無関係なデータの送信またはデータの不必要な上書き
同じイベントフィードをターゲットとする複数のEventStreamsがある場合、そのコネクタに対してイネーブルメントされたすべてのアクションは、単一のアクションがトリガーされるたびに自動的に発火する。その結果、Brazeでデータが上書きされ、不必要なデータポイントが記録される可能性もある。
解決策:
それぞれのアクションを追跡するために、個別のイベント指定またはフィードを設定します。
または
Tealium ダッシュボードのトグルを使用して、起動しないアクション (またはコネクター) を無効にします。
Brazeの初期化が早すぎる
Braze Web SDK タグを使用して Tealium と統合するユーザーの場合、MAU が大幅に増加する可能性があります。Braze がページ読み込むで初期化されている場合、Web ユーザーが初めてWeb サイトに移動するたびに、Braze によって匿名プロファイルが作成されます。ユーザーが”Signed In”または”Watched Video”など、いくつかのアクションを完了したときにのみ、MAU数を減らすためにユーザーの挙動を追跡することを望む人もいるかもしれません。
解決策:
読み込む規則 を設定して、タグ 読み込むがいつどこにあるかを正確に判断します。
GitHub でこのページを編集