Google Data Layer扩展

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

Helper Library提供了与AdobeClient Data Dayer (ACDL)类似的事件驱动功能。 Google Data Layer扩展的数据元素、规则和操作提供了与 ACDL扩展.

成熟度

版本1.2.x是后期测试版,正在生产使用。

安装

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

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

扩展视图

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

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

注意

无论是Google还是Adobe代码先加载并创建数据层,这都无关紧要。 两个系统的行为相同 — 如果数据层不存在或使用现有的数据层,则创建数据层。

活动

注意

单词 事件 在Adobe Experience Platform Tags中使用事件驱动的数据层时过载。 事件 可以是:

  • Adobe Experience Platform Tags事件(Library Loaded等)。
  • JavaScript事件。
  • 使用推送至数据层的数据 事件 关键字。

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

注意

了解如何使用 事件 关键字(类似于Adobe客户端数据层)将数据推送到Google数据层时。 此 事件 关键字会更改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"})

操作

推送到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)中使用。 在前一种情况下,数据元素返回在数据层改变时从计算状态中取出的值。 在后一种情况下,使用规则执行时的计算状态。

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

因此,数据元素可以返回:

  • 空字段:数据层计算状态。
  • 带键的字段(例如上面示例中的page.previous_url):事件对象或计算状态中键的值。

其他信息

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

其他一般信息请参见 项目自述文件

在此页面上