インストール

要件

Tealium Customer Data Hubアカウント。

動作原理

Adobe Experience Platform Launch用のTealium Collect拡張機能は、すべてのイベントと対応するデータをTealiumに送信し、Tealium Customer Data Hubで使用します。Adobe Experience Platform Launch用のTealium Collect拡張機能は、ページごとに一度Tealium CollectのJavaScriptファイルを読み込むカスタムテンプレートです。

トリガーされた各イベントについて、タグは構成で指定されたデータレイヤーのエンリッチメントオブジェクトをキーと値のペアに自動的にフラット化し、データをTealium Collectエンドポイントに投稿します。ファーストパーティデータ収集を使用する場合は、カスタムエンドポイントを指定できます。

データレイヤー変数がどのようにフラット化されるかの詳細については、データレイヤーを参照してください。

Tealium Collect

Tealium Collect拡張機能をインストールするには、以下の手順を使用します：

Adobe Experience Platform Launch Marketplaceにアクセスします。
拡張機能メニューでカタログタブをクリックし、Tealium Collect拡張機能を検索します。
インストールをクリックします。
次の構成オプションを構成し、ライブラリに保存をクリックします：
- Tealiumアカウント：必須。あなたのTealiumアカウント名。
- Tealiumプロファイル：必須。あなたのTealiumプロファイル名。
- データソースキー：オプション。サーバーサイドTealium構成からのデータソースキー。
- Collect Tag URL：オプション。デフォルトのTealium Collect URLを独自のカスタムファーストパーティデータホストファイルURLで上書きします。例：https://collect.example.co.uk/collect.min.js。
- エンドポイント：オプション。Tealium Collectエンドポイントをファーストパーティデータ収集エンドポイントで上書きします。例：https://collect.example.co.uk/event。
Tealium Collect拡張機能を発火させるルールを作成します。次の例は、ページビューイベントのための拡張機能を実行します。

データレイヤーエンリッチメント

Tealium Data Layer Enrichment拡張機能は、Tealium AudienceStreamからのサーバーサイド属性を取り込み、データレイヤーに注入します。

Data Layer Enrichment拡張機能をインストールするには、以下の手順を使用します：

Adobe Extension CatalogでTealium Data Enrichment拡張機能を検索します。
拡張機能を追加するためにインストールボタンをクリックします。
Tealium Data Enrichmentのためのルールとアクションを追加します。
インストールされた拡張機能にマウスオーバーし、構成をクリックして、次のオプションを構成します：
- Tealiumアカウント：必須。あなたのTealiumアカウント名。
- Tealiumプロファイル：必須。あなたのTealiumプロファイル名。
- データソースキー：オプション。サーバーサイドTealium構成からのデータソースキー。
- Collect Tag URL：オプション。デフォルトのTealium Collect URLを独自のカスタムファーストパーティデータホストファイルURLで上書きします。
- エンドポイント：オプション。Tealium Collectエンドポイントをファーストパーティデータ収集エンドポイントで上書きします。例：https://collect.example.co.uk/event。
- データオブジェクト：オプション。データレイヤーエンリッチメントオブジェクトとして使用するJavaScript変数の名前。例えば、データレイヤーエンリッチメントオブジェクトとしてdigitalDataを使用している場合は、これを入力します。拡張機能は、Direct Callイベントの_satellite.track呼び出しの第二パラメータを自動的に使用します。
- adobeDataLayerのイベントリスナーを追加：オプション。adobeDataLayerのイベントを自動的にトラックします。デフォルトおよびカスタムのAdobe Client Data Layerイベントの両方をトラックします。
Adobe Launchでローカル保存内のデータを読み取るための新しいデータエレメントを作成します。

data layer enrichment objectはlocalStorageのキーteal_adobe_enrichment_dataの下に保存されます。キーを取得すると、データレイヤーエンリッチメントオブジェクトが返されます。次の例では、localStorageからデータレイヤーエンリッチメントオブジェクトを取得し、すべてのオーディエンスを配列に格納します：

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に構成され、第二パラメータには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: Adobe Experience Platform Launchオブジェクトリファレンスを参照してください。

ソースコード

カスタム実装が必要な開発者の場合は、拡張コードをダウンロードして必要に応じて修正してください。