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

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

インストール

拡張機能をインストールするには、拡張機能 UI またはデータ収集 UI のExperience Platformカタログに移動し、「Adobeクライアントデータレイヤー」を選択します。

拡張機能ビュー

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"}})