インストール
Tealium CollectとTealium Data Layer EnrichmentをAdobe Experience Platform Launchにインストールする方法を学びます。
要件
仕組み
Adobe Experience Platform Launch用のTealium Collect拡張機能は、すべてのイベントと対応するデータをTealiumに送信し、Tealium Customer Data Hubで使用します。Adobe Experience Platform Launch用のTealium Collect拡張機能は、ページごとに一度Tealium Collect JavaScriptファイルをロードするカスタムテンプレートです。
トリガーされた各イベントについて、タグは自動的にdigitalData
オブジェクトをキー-値のペアにフラット化し、データをTealium Collectエンドポイントに投稿します。ファーストパーティデータコレクションを使用する場合、カスタムエンドポイントを指定することができます。
データレイヤー変数がどのようにフラット化されるかについては、データレイヤーを参照してください。
インストール
Tealium Collect
Tealium Collect拡張機能をインストールするには:
- Adobe Experience Platform Launch Marketplaceに移動します。
- 拡張機能メニューで、カタログタブをクリックし、Tealium Collect拡張機能を検索します。
- インストールをクリックします。
- 次の構成オプションを構成し、ライブラリに保存をクリックします:
- Tealiumアカウント(必須):あなたのTealiumアカウント名。
- Tealiumプロファイル(必須):あなたのTealiumプロファイル名。
- エンドポイント(オプション):ファーストパーティデータコレクションエンドポイントなど、Tealium Collectエンドポイントを上書きします。例:
https://collect.example.co.uk/event
。
Tealium Collect拡張機能を発火するルールを作成します。次の例は、ページビューイベントの拡張機能を実行します。
Data Layer Enrichment
Tealium Data Layer Enrichment拡張機能は、Tealium AudienceStreamからのサーバーサイド属性を取得し、それらをデータレイヤーに注入します。
Data Layer Enrichment拡張機能をインストールするには:
-
Adobe Extension CatalogでTealium Data Enrichment拡張機能を検索します。
-
拡張機能を追加するためにインストールボタンをクリックします。
-
Tealium Data Enrichmentのルールとアクションを追加します。
-
インストール済みの拡張機能の上にマウスを置き、構成をクリックし、次のオプションを構成します:
- Tealiumアカウント(必須):あなたのTealiumアカウント名。
- Tealiumプロファイル(必須):あなたのTealiumプロファイル名。
- データソースキー(オプション):サーバーサイドTealium構成からのデータソースキー。
- エンドポイント(オプション):ファーストパーティデータコレクションエンドポイントなど、Tealium Collectエンドポイントを上書きします。例:
https://collect.example.co.uk/event
。
-
Adobe Launchで新しいデータ要素を作成し、ローカル保存内のデータを読み取ります。
オブジェクトはlocalStorage
のキーteal_adobe_enrichment_data
の下に保存されます。キーを取得すると、DLEオブジェクトが返されます。次の例では、localStorage
からDLEオブジェクトを取得し、すべてのオーディエンスを配列に保存します:
var dle_object = JSON.parse(localStorage.getItem(
"teal_adobe_enrichment_data"));
var data = {audiences: []};
if (dle_object.audiences) {
for (var id in dle_object.audiences) {
if (dle_object.audiences.hasOwnProperty(id)) {
data.audiences.push(id);
}
}
}
トラッキング
_satellite.track
からの直接呼び出しイベントはTealium Collectによって処理されます。最初のパラメータはデータレイヤーの変数tealium_event
に構成されます。2番目のパラメータには、Tealium Collectエンドポイントに送信される追加のデータレイヤー属性が含まれます。
次の例は、イベントcontact_submit
の直接呼び出しです。キー-値のペアのデータレイヤーを推奨しますが、ネストされたadobeDataLayer
オブジェクトも渡すことができます。
_satellite.track('contact_submit', { name: 'John Doe' });
Tealium Collectでの結果のイベントは次のとおりです:
{
"tealium_event" : "contact_submit",
"name" : "John Doe"
}
イベントパラメータに加えて、_satellite.buildInfo
で見つかった値も直接呼び出しイベントトラッキングのためのデータレイヤーに含まれます。
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z",
environment: "development"
データレイヤーオブジェクトがネストされた値を含む場合、それは自動的にフラット化されてTealium Collectエンドポイントに送信されます。
Adobe Experience Platform Launchオブジェクトリファレンスについて詳しく学びましょう。
ソースコード
開発者であり、カスタム実装が必要な場合は、拡張機能コードをダウンロードし、必要に応じて修正します。
最終更新日 :: 2024年March月29日