Google数据层扩展

Google数据层扩展允许您在标记实施中使用Google数据层。 该扩展可以独立使用，也可以与Google解决方案以及Google的开源数据层帮助程序库同时使用。

帮助程序库提供了与Adobe客户端数据层(ACDL)类似的事件驱动功能。 Google Data Layer扩展的数据元素、规则和操作提供了与ACDL扩展中类似的功能。

安装

要安装扩展，请导航到数据收集UI中的扩展目录，然后选择​ Google Data Layer。

安装后，扩展会在每次加载Adobe Experience Platform Tags库时创建或访问数据层。

扩展视图

扩展配置可用于定义扩展所使用的数据层的名称。 如果在加载Adobe Experience Platform Tags时不存在具有已配置名称的数据层，则扩展将创建一个数据层。

数据层名称默认为Google默认名称dataLayer。

活动

通过扩展，您可以侦听数据层上的更改。

Google事件类型

Google支持两种推送事件的方式：使用push()方法的Google Tag Manager和使用gtag()方法的Google Analytics4。

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”将用数字(\d)跟踪myEvent：

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

操作

推送到Data Layer push-to-data-layer

扩展提供了两个用于将JSON推送到数据层的操作：一个是自由文本字段，用于手动创建要推送的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）中使用。 在前一种情况下，数据元素返回在数据层改变时从计算状态中取出的值。 在后一种情况下，使用规则执行时的计算状态。

切换开关允许您选择数据元素是应从整个计算状态返回值，还是仅从事件信息返回值（如果在由数据层更改触发的规则中使用）。

因此，数据元素可以返回：

其他信息

扩展的数据元素和事件对话框包含详细的使用信息和示例。

其他一般信息位于项目README中