Adobe クライアントデータレイヤー拡張機能

このドキュメントでは、Adobe クライアントデータレイヤー拡張機能の使用例とベストプラクティスを説明します。

インストール

拡張機能をインストールするには、Experience Platform UIまたはData Collection UIで拡張機能カタログに移動し、「Adobe Client Data Layer」を選択します。

拡張機能ビュー

ACDL スクリプトは、デフォルトでは、変数名 adobeDataLayer で新しいデータレイヤーを作成します。 この名前は、拡張機能ビューで必要に応じて変更できます。 設定した名前は、タグが読み込まれる際にインスタンス化されます。

イベント

拡張機能を使用すると、データレイヤー上のイベントをリッスンできます。 使用できるイベントは次のとおりです。

すべてのデータの変更をリッスン

このオプションを選択すると、イベントリスナーはこのデータレイヤーに加えられた変更をリッスンします。

次のプッシュイベントの例は、リスナーによってトラッキングされます。

次のプッシュイベントの例は、リスナーによってトラッキングされません。

すべてのイベントをリッスン

このオプションを選択すると、イベントリスナーは、データレイヤーにプッシュされたすべてのイベントをリッスンします。

次のプッシュイベントの例は、リスナーによってトラッキングされます。

次のプッシュイベントの例は、リスナーによってトラッキングされません。

特定のイベントをリッスン

イベントを指定すると、イベントリスナーで特定の文字列に一致するイベントをトラッキングできます。

例えば、myEvent を指定してこの設定を使用すると、リスナーは次のプッシュイベントのみをトラッキングします。

イベントリスナーの範囲を変更することもできます。 オプションの違いの概要を次に示します。

アクション

以下の節では、拡張機能がサポートするアクションの概要を説明します。

データレイヤーをリセット

拡張機能を使用すると、データレイヤーの長さをリセットでき、シングルページアプリケーション（SPA）で限られたサイズを維持するのに役立ちます。

ただし、前にプッシュメソッド中に設定した情報が完全に削除される可能性は、現在のところありません。

「計算済み状態のリセットと設定」アクションは、最後に計算された状態をコピーし、データレイヤーオブジェクトを空にして、最後の状態を再プッシュします。

データレイヤーにプッシュ

拡張機能は、JSON コンテンツをデータレイヤー自体にプッシュするアクションを提供します。このアクションにより、JSON内でデータ要素を直接使用できます。 JSON エディター内では、データ要素はパーセント表記（%dataElementName% など）を使用して参照する必要があります。

{
    "page": {
        "url": "%url%",
        "previous_url": "%previous_url%",
        "concatenated_values": "static string %dataElement%"
    }
}

データ要素

以下の節では、拡張機能が提供するユニークなデータ要素のタイプについて説明します。

計算済み状態

データレイヤーの計算済み状態のデータ要素は、設定に応じて、次の 2 つのいずれかを返すことができます。

データレイヤーサイズ

このデータ要素は、データレイヤーのサイズを返します。 データレイヤーのサイズは、このオブジェクトにプッシュされた要素の数で表されます。

以下のプッシュイベントのリストの場合、データ要素は整数 2 を返します。

adobeDataLayer.push({"event":"myEvent"})
adobeDataLayer.push({"data":{"foo":"bar"}})