Google Data Layer 拡張機能
Google Data Layer 拡張機能を使用すると、タグ実装でGoogleデータレイヤーを使用できます。 この拡張機能は、単独で、またはGoogleソリューションと同時に、Googleのオープンソースと共に使用できます データレイヤーヘルパーライブラリ.
ヘルパーライブラリは、イベントクライアントデータレイヤー (ACDL) と同様のAdobe駆動型機能を提供します。 Google Data Layer 拡張機能のデータ要素、ルールおよびアクションは、 ACDL 拡張機能.
インストール
拡張機能をインストールするには、データ収集 UI の拡張機能カタログに移動し、「 」を選択します。 Google Data Layer.
インストールすると、この拡張機能は、Adobe Experience Platform Tags ライブラリの読み込みのたびに、データレイヤーを作成するか、データレイヤーにアクセスします。
拡張機能ビュー
拡張機能の設定を使用して、拡張機能が使用するデータレイヤーの名前を定義できます。 Adobe Experience Platformタグの読み込み時に設定済みの名前のデータレイヤーが存在しない場合、拡張機能によって作成されます。
データレイヤー名のデフォルトは、Googleのデフォルト名です。 dataLayer
.
イベント
- Adobe Experience Platform Tags イベント(「Library Loaded」など)。
- JavaScript イベント。
- を使用してデータレイヤーにプッシュされたデータ イベント キーワード。
拡張機能を使用すると、データレイヤーの変更をリッスンできます。
この点について不明な点がある場合は、 Googleのドキュメントを読むか、調査してください。
Google Event Types
Googleは、次の 2 つのプッシュ方法をサポートしています。 Google Tag Manager は、 push()
メソッドとGoogle Analytics4、を使用 gtag()
メソッド。
1.2.1 より前のGoogle Data Layer 拡張機能バージョンでは、 push()
に含めることができます。
バージョン 1.2.1 以降では、 gtag()
. これはオプションで、拡張機能設定ダイアログで有効にできます。
詳しくは、 push()
および gtag()
イベントについては、 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"})
アクション
データレイヤーにプッシュ push-to-data-layer
拡張機能では、JSON をデータレイヤーにプッシュする 2 つのアクションを提供します。プッシュする JSON を手動で作成する自由テキストフィールドと、キーと値のペアのマルチフィールドダイアログのバージョン 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