Tealium

Tealiumは、EventStream、AudienceStream、およびiQ Tag Managementで構成されるユニバーサルデータハブおよび顧客データプラットフォームであり、サードパーティのソースからモバイルデータ、Webデータ、および代替データを接続できます。TealiumをBrazeと接続することで、カスタムイベント、ユーザー属性、購入のデータフローが実現し、リアルタイムでデータに基づいたアクションを実行できるようになります。

BrazeとTealiumの統合により、ユーザーを追跡し、さまざまなユーザー分析プロバイダーにデータをルーティングできます。Tealiumでは次の操作ができます。

• AudienceStreamでTealiumオーディエンスをBrazeに同期し、Brazeキャンペーンやキャンバスのパーソナライズ、またはセグメントの作成に使用できるようにします。
• プラットフォーム間でデータをインポートします。Brazeは、Android、iOS、およびWebアプリケーション向けのサイドバイサイドSDK統合と、イベントデータをレポートできる任意のプラットフォームで使用できるサーバー間統合の両方を提供します。
  
  

• eventstream
• audiencestream
• iq tag management

前提条件

必要条件	説明
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メソッド（Content Cardsなど）に対応しているわけではないことに注意してください。対応するリモートコマンドにマッピングされていないBrazeメソッドを使用するには、ネイティブBrazeコードをコードベースに追加してメソッドを呼び出す必要があります。
サーバー間	TealiumからBraze REST APIエンドポイントにデータを転送します。 アプリ内メッセージング、Content Cards、プッシュ通知などのBraze UI機能はサポートされていません。また、このメソッドでは利用できないデバイスレベルのフィールドなど、自動的にキャプチャされるデータも存在します。 これらの機能を使用する場合は、サイドバイサイド統合を検討してください。

サイドバイサイドSDK統合

リモートコマンド

リモートコマンドは、Tealium iOSおよびAndroidライブラリの機能であり、Tealium SDKからBrazeサーバーを介してBrazeへの呼び出しを実行できるようにします。Brazeリモートコマンドモジュールは、必要なBrazeライブラリを自動的にインストールおよびビルドし、すべてのメッセージレンダリングと分析トラッキングを処理します。Brazeモバイルリモートコマンドを使用するには、アプリに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()
initialize	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 Web SDKタグ

Braze Web SDKタグを使用して、WebサイトにBraze Web SDKをデプロイします。Tealium iQ Tag Managementにより、顧客は訪問者のアクティビティを追跡するためにTealiumダッシュボード内でタグとしてBrazeを追加できます。タグは一般的に、オンライン広告、メールマーケティング、およびサイトのパーソナライゼーションの効果を理解する目的でマーケターにより使用されます。

1. TealiumでiQ > Tags > + Add Tag > Braze Web SDKに移動します。
2. Tag Configurationダイアログボックスで、APIキー（Brazeアプリ識別子キー）、ベースURL（Braze SDKエンドポイント）、およびBraze Web SDKコードバージョンを入力します。また、ロギングを有効にして、デバッグ目的でWebコンソールに情報を記録することもできます。
3. Load Rulesダイアログボックスで「Load on All Pages」を選択するか、Create Ruleを選択して、サイトでこのタグのインスタンスをいつどこに読み込むかを決定します。
4. Data Mappingsダイアログボックスで、Create Mappingsを選択してTealiumデータをBrazeにマッピングします。Braze Web SDKタグの宛先変数は、タグのData Mappingタブに組み込まれています。これらの表に、使用可能な宛先カテゴリと、それぞれの宛先名の説明が示されています。
5. Finishを選択します。

サイドバイサイド統合のリソース

• iOSリモートコマンド：Tealiumドキュメント、Tealium GitHubリポジトリ
• Androidリモートコマンド：Tealiumドキュメント、Tealium GitHubリポジトリ
• Web SDKタグ：Tealiumドキュメント

サーバー間統合

この統合により、TealiumからBraze REST APIにデータが転送されます。

サーバー間統合では、アプリ内メッセージング、Content Cards、プッシュ通知などのBraze UI機能はサポートされていません。また、このメソッドでは利用できないデバイスレベルのフィールドなど、自動的にキャプチャされるデータも存在します。

このデータとこれらの機能を使用する場合は、サイドバイサイドSDK統合を検討してください。

ステップ1:ソースを設定する

Tealiumでは最初に、コネクターの取得元となる有効なデータソースを設定する必要があります。

1. TealiumのサイドバーのServer-SideからSources > Data Sources > + Add Data Sourceに移動します。
2. 使用可能なカテゴリ内で目的のプラットフォームを見つけ、ソースに名前を付けます。これは必須フィールドです。
   
3. Event Specificationsオプションから、含めるイベント仕様を選択します。イベント仕様は、インストールで追跡するイベント名と必須属性を特定するのに役立ちます。これらの仕様は受信イベントに適用されます。
   
   どのデータが最も価値があるか、どの仕様がユースケースに最も適しているか、時間をかけて検討してください。カスタムイベント仕様も利用可能です。
   
4. 次のダイアログでGet Codeステップに進みます。ここで提供されるベースコードとイベント追跡コードは、インストールガイドとして機能します。これらの手順をチームと共有したい場合は、提供されたPDFをダウンロードしてください。完了したらSave & Continueを選択します。
   
5. これで、保存したソースを表示し、イベント仕様を追加または削除できます。
   
   詳細なデータソースビューから、次のアクションを実行できます。
   • データソースキーの表示とコピー
   • インストール手順の表示
   • Get Codeページに戻る
   • イベント仕様の追加または削除
   • イベント仕様に関連するライブイベントの表示
   • その他
     
6. 最後に、ページの上部にあるSave / Publishを選択します。ソースを公開しないと、Brazeコネクターの設定時にソースを見つけることができません。

データソースの設定と編集の詳細な手順については、データソースを参照してください。

ステップ2:イベントコネクターを作成する

コネクターとは、Tealiumと他のベンダーの間でデータを伝送するために使用される統合です。これらのコネクターには、パートナーがサポートするAPIを表すアクションが含まれています。

1. TealiumのサイドバーのServer-SideからEventStream > Event Connectorsに移動します。
2. 青色の+ Add Connectorボタンを選択して、コネクターマーケットプレースを参照します。表示される新しいダイアログボックスで、スポットライト検索を使用してBrazeコネクターを見つけます。
3. このコネクターを追加するには、Brazeコネクタータイルを選択します。クリックすると、接続の概要と、必要な情報、サポートされるアクション、および設定手順の一覧が表示されます。この設定は、ソース、設定、アクションの3つのステップで構成されています。

ソース

ソースの設定が完了したら、EventStream > Event Connectors > + Add Connector > BrazeのBrazeコネクターページに戻ります。

作成したデータソースを選択し、Event FeedでAll Eventsまたは特定のイベント仕様を選択します。変更された値のみをBrazeに送信する推奨パスです。Continueを選択します。

設定

次に、ページの下部でAdd Connectorを選択します。コネクターに名前を付け、BrazeのAPIエンドポイントとBraze REST APIキーを指定します。

以前にコネクターを作成したことがある場合は、利用可能なコネクターリストにある既存のコネクターを使用し、鉛筆アイコンでニーズに合わせて変更するか、ゴミ箱アイコンで削除することができます。

アクション

次に、コネクターアクションに名前を付け、設定するマッピングに従ってデータを送信するアクションタイプを選択します。ここでは、Brazeの属性、イベント、および購入をTealiumの属性、イベント、および購入名にマッピングします。

• ユーザーの追跡 - バッチおよび非バッチ
• ユーザーの削除 - 非バッチ

Continueを選択します。

コネクターがTealiumホームページのコネクターリストに表示されます。

完了したら、コネクターのSave / Publishを選択してください。設定したアクションは、トリガー接続が満たされたときに実行されます。

ステップ3:Tealiumコネクターをテストする

コネクターが稼動したら、正常に動作していることを確認するためにテストする必要があります。これを検証する最も簡単な方法は、Tealiumのトレースツールを使用することです。トレースの使用を開始するには、Tealium Toolsブラウザー拡張機能が追加されていることを確認してください。

1. 新しいトレースを開始するには、サイドバーのServer-SideのオプションからTraceを選択します。Startを選択し、トレースIDをキャプチャします。
2. ブラウザー拡張機能を開き、AudienceStream TraceにトレースIDを入力します。
3. リアルタイムログを調べます。
4. Actions Triggeredエントリを選択して展開し、検証したいアクションを確認します。
5. 検証するアクションを探して、ログステータスを表示します。

Tealiumのトレースツールの詳しい実装手順については、Tealiumのトレースドキュメントを参照してください。

統合デモ

データポイントの潜在的な超過料金

Tealiumを通じてBrazeを統合する際に、誤って不必要なデータポイントを記録してしまう可能性がある主な方法は3つあります。

重複データの送信 - Brazeの属性の差分のみを送信する

Tealiumはユーザー属性のBraze差分を送信しません。たとえば、EventStreamアクションでユーザーの名、メール、および携帯電話番号を追跡している場合、このアクションがトリガーされると、Tealiumは3つの属性すべてをBrazeに送信します。Tealiumは、変更された内容や更新された内容を探してその情報のみを送信することはありません。

解決策：
バックエンドを確認して、属性が変更されているかどうかを評価し、変更されている場合は、Tealiumの関連メソッドを呼び出してユーザープロファイルを更新できます。これは、Brazeを直接統合するユーザーが通常行う作業です。
または
自分自身のユーザープロファイルをバックエンドに保存しておらず、属性が変更されたかどうかを判断できない場合は、AudienceStreamを使用してエンリッチメントを作成し、値が変更されたときにのみユーザー属性を送信します。エンリッチメントルールに関するTealiumのドキュメントを参照してください。

無関係なデータの送信またはデータの不必要な上書き

同じイベントフィードをターゲットとする複数のEventStreamがある場合、そのコネクターに対して有効化されたすべてのアクションは、単一のアクションがトリガーされるたびに自動的に発火します。その結果、Brazeでデータが上書きされ、不必要なデータポイントが記録される可能性もあります。

解決策：
それぞれのアクションを追跡するために、個別のイベント仕様またはフィードを設定します。
または
Tealiumダッシュボードのトグルを使用して、起動しないアクション（またはコネクター）を無効にします。

Brazeの初期化が早すぎる

Braze Web SDKタグを使用してTealiumと統合するユーザーの場合、MAUが大幅に増加する可能性があります。Brazeがページ読み込み時に初期化されている場合、WebユーザーがWebサイトに初めてアクセスするたびに、Brazeによって匿名プロファイルが作成されます。これにはボットトラフィックも含まれ、アクティブユーザー数が膨らむ可能性があります。MAU数を減らすために、「Signed In」や「Watched Video」などのアクションをユーザーが完了したときにのみユーザーの行動を追跡したい場合もあるでしょう。

解決策：
読み込みルールを設定して、サイトでタグがいつどこに読み込まれるかを正確に決定します。ボットトラフィックのフィルタリングとSDKの条件付き初期化に関するより包括的なガイダンスについては、ボットトラフィックのフィルタリングを参照してください。