Google Data Layer 拡張機能

Google データレイヤー拡張機能を使用すると、タグ実装で Google データレイヤーを使用できます。この拡張機能は、単独で、またはGoogleソリューションと同時に、Googleのオープンソースと共に使用できます データレイヤーヘルパーライブラリ.

ヘルパーライブラリは、イベントクライアントデータデイヤー (ACDL) と同様のAdobe駆動型機能を提供します。 Google Data Layer 拡張機能のデータ要素、ルールおよびアクションは、 ACDL 拡張機能.

成熟度

バージョン 1.2.x は実稼動環境で使用される遅延ベータです。

インストール

拡張機能をインストールするには、データ収集 UI の拡張機能カタログに移動し、「 」を選択します。 Google Data Layer.

インストールすると、この拡張機能は、Adobe Experience Platform Tags ライブラリの読み込みのたびに、データレイヤーを作成するか、データレイヤーにアクセスします。

拡張機能ビュー

拡張機能の設定を使用して、拡張機能が使用するデータレイヤーの名前を定義できます。 Adobe Experience Platformタグの読み込み時に設定済みの名前のデータレイヤーが存在しない場合、拡張機能によって作成されます。

データレイヤー名のデフォルトは、Googleのデフォルト名です dataLayer.

メモ

GoogleまたはAdobeコードが最初に読み込まれて、データレイヤーが作成されるかどうかは関係ありません。 両方のシステムが同じように動作します。データレイヤーが存在しない場合や既存のデータレイヤーを使用する場合は、データレイヤーを作成します。

イベント

メモ

次の単語 イベント イベント駆動型データレイヤーがAdobe Experience Platformタグで使用されている場合はオーバーロードされます。 イベント は次のいずれかになります。

  • Adobe Experience Platform Tags イベント（「Library Loaded」など）。
  • JavaScript イベント。
  • を使用してデータレイヤーにプッシュされたデータ イベント キーワード。

拡張機能を使用すると、データレイヤーの変更をリッスンできます。

メモ

この イベント キーワード。データがGoogleデータレイヤーに (Adobeクライアントデータレイヤーと同様に ) プッシュされたときに使用します。 この イベント キーワードは、Googleデータレイヤー（したがってこの拡張）の動作を変更します。
この点について不明な点がある場合は、 Googleのドキュメントを読むか、調査してください。

データレイヤーへのすべてのプッシュをリッスンします

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

イベントを除くプッシュのリッスン

このオプションを選択した場合、イベントリスナーは、データレイヤーへのデータのプッシュ（イベントを除く）をリッスンします。

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

dataLayer.push({"data":"something"})

次のサンプルのプッシュイベントは、リスナーによって追跡されません。

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

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

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

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

dataLayer.push({"event":"myevent"})
dataLayer.push({"event":"myevent","data":"something"})

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

dataLayer.push({"data":"something"})

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

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

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

dataLayer.push({"event":"myEvent"})

(ECMAScript/JavaScript) 正規表現を使用して、イベント名を照合できます。

例えば、'myEvent\d'を設定すると、 myEvent 数字 (\d):

dataLayer.push({"event":"myEvent1"})
dataLayer.push({"event":"myEvent2"})

アクション

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

拡張機能では、JSON をデータレイヤーにプッシュする 2 つのアクションを提供します。プッシュする JSON を手動で作成するための自由テキストフィールド、およびキーと値の対応する multifield ダイアログのバージョン 1.2.0 から。

フリーテキスト JSON

フリーテキストアクションを使用すると、JSON 内で直接データ要素を使用できます。 JSON エディター内では、データ要素は、パーセント表記を使用して参照する必要があります。例： %dataElementName%.

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

キーと値の複数フィールド

新しいキーと値のペアのマルチフィールドダイアログは、JSON を手動で書かずにプッシュを設定できる、より使いやすいインターフェイスです。

Google DL の計算済み状態へのリセット

拡張機能では、データレイヤーをリセットするアクションを提供します。 Googleのデータレイヤーの変更を処理するルールで使用すると、データレイヤーは、ルールがトリガーされた時点で、データレイヤーの計算済み状態にリセットされます。 Googleのデータレイヤーの変更を処理しないルールでアクションが使用される場合、このアクションはデータレイヤーを空にします。

データ要素

提供されたデータ要素は、Googleデータレイヤーの変更（プッシュイベント）によってトリガーされるルールの実行中に、または Library Loaded などの関連のないルールで使用できます。 前者の場合、データ要素は、データレイヤーの変更時に計算された状態から取得された値を返します。 後者の場合は、ルール実行時の計算済み状態が使用されます。

切り替えスイッチを使用すると、データ要素が計算済み状態全体から値を返すか、イベント情報（データレイヤーの変更によってトリガーされるルール内で使用される場合）から値を返すかを選択できます。

したがって、データ要素は次の値を返すことができます。

  • 空のフィールド：データレイヤーの計算済み状態。
  • キーを持つフィールド（上記の例の page.previous_url など）:イベントオブジェクトまたは計算済み状態のキーの値。

追加情報

拡張機能のデータ要素ダイアログとイベントダイアログには、使用に関する詳細な情報と例が含まれています。

その他の一般情報については、 project README

このページ