Adobe客户端数据层扩展

本文档提供了有关如何使用Adobe客户端数据层扩展的示例和最佳实践。

安装

要安装扩展，请在Experience PlatformUI或数据收集UI中导航到扩展目录，然后选择Adobe客户端数据层。

扩展视图

默认情况下，ACDL脚本使用变量名称创建新的数据层 adobeDataLayer. 扩展视图允许您根据需要更改此名称。 您设置的名称将在加载标记时实例化。

活动

通过扩展，您可以侦听Data Layer上的事件。 以下事件可用：

监听所有数据更改

如果选择此选项，事件侦听器将侦听对数据层所做的任何更改。

监听程序将跟踪以下示例推送事件：

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

监听程序将不会跟踪以下示例推送事件：

• adobeDataLayer.push({"event":"myevent"})

收听所有活动

如果选择此选项，事件侦听器将侦听推送到数据层的任何事件。

监听程序将跟踪以下示例推送事件：

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

监听程序将不会跟踪以下示例推送事件：

• adobeDataLayer.push({"data":"something"})

侦听特定事件

如果指定事件，则事件侦听器将跟踪与特定字符串匹配的任何事件。

例如，设置 myEvent 使用此配置时，会导致侦听器仅跟踪以下推送事件：

• adobeDataLayer.push({"event":"myEvent"})

您还可以更改事件侦听器的范围。 不同选项概述如下：

• all：这是默认选项，每当过去满足您以上选择的条件或将来的条件被推送时，就会触发该规则。 如果您使用异步实施，这是最安全的选项。
• future：仅当与您的条件匹配的新推送事件将发送到Data Layer时，此选项才会触发规则。
• past：此选项仅会为与您的条件匹配的旧推送事件触发规则。 与您的条件匹配的新推送将被忽略，并且不再触发规则。

操作

以下部分概述了扩展支持的操作。

重置数据层

扩展提供了一种重置数据层长度的方法，这有助于保持单页应用程序(SPA)的有限大小。

但是，当前不可能完全删除之前在推送方法期间设置的信息。

此 重置并设置计算状态 操作可复制上次计算状态、清空数据层对象并重新推送上次状态。

推送到Data Layer

扩展为您提供了一个将JSON内容推送到Data Layer本身的操作。该操作允许直接在JSON中使用数据元素。 在JSON编辑器中，应使用百分比表示法引用数据元素(例如， %dataElementName%)。

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

数据元素

以下各部分介绍了扩展提供的独特数据元素类型。

计算状态

根据配置方式， Data Layer Computed State数据元素可以返回以下两项之一：

• 完整的Data Layer状态：默认情况下，返回完整的Data Layer Computed State。
• 特定路径：您可以指定要在Data Layer中返回的路径。 使用点表示法指定路径(例如， data.foo)。

数据层大小

此数据元素返回数据层的大小。 Data Layer的大小由已推送到此对象的元素数量表示。

给定以下推送事件列表，此数据元素将返回整数 2：

adobeDataLayer.push({"event":"myEvent"})
adobeDataLayer.push({"data":{"foo":"bar"}})

Business.Adobe.com 资源