使用Web SDK发送Adobe客户端数据层数据
Adobe客户端数据层(ACDL)会收集页面上的数据和事件,但不会将这些数据和事件发送到任何位置。 要将它们发送到Adobe Experience Platform Edge Network,请通过以下方式之一将ACDL事件连接到Web SDK:
本页的每个部分都显示了这两种方法。
先决条件 prerequisites
您的网站代码会推送您要发送的数据和事件。 此页面上的示例为每个页面视图使用以下推送:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
event: "page view",
page: { title: "Home", language: "en" }
});
根据您的方法,您还需要以下各项:
选择如何映射数据 mapping
Web SDK在两个对象中发送数据。 选择一项或两项:
选择值的来源 value-sources
当ACDL事件触发代码或规则时,您可以从两个位置读取数据层值:
event.page.title,其中event是侦听器的参数%event.message.page.title%将推送对象用于描述事件本身的值,例如购物车附加中的产品。 对之前推送的值(如用户详细信息)使用计算状态。 当代码或规则运行时,计算状态已包含来自触发该代码或规则的推送的数据。 查看侦听器接收的内容和在规则中使用推送的数据。
发送XDM数据 xdm
以下示例使用推送对象中的页面标题发送页面查看。
侦听事件并调用sendEvent:
| code language-js |
|---|
|
有关所有侦听器选项,请参阅addEventListener()。
-
创建具有Web SDK扩展的 变量 数据元素。 选择XDM,然后选择您的沙盒和架构。 此示例将数据元素命名为
XDM variable。 -
创建规则并添加事件:
- 扩展: Adobe客户端数据层
- 事件类型:数据层推送
- 在上触发: 特定命名事件,事件名称为
page view - 时间范围:全部
-
添加填充XDM对象的操作:
- 扩展:Adobe Experience Platform Web SDK
- 操作类型: 更新变量
- 数据元素:
XDM variable - 将
web.webPageDetails.name设置为%event.message.page.title%,并将web.webPageDetails.pageViews.value设置为1。
-
添加发送事件的操作:
- 扩展:Adobe Experience Platform Web SDK
- 操作类型: 发送事件
- 类型:
web.webpagedetails.pageViews - XDM:
%XDM variable%
-
保存规则,将其添加到库中,然后构建库。
有关所有事件选项,请参阅数据层推送。
每次在您的网站推送page view事件时,该代码或规则都会将页面查看发送到Edge Network。
以相同的方式发送交互。 例如,对于推送(如{ event: "cart add", eventInfo: { sku: "HT105" } }),在cart add上侦听或触发,并从eventInfo中读取产品。 有关描述商务交互的XDM字段,请参阅收集商务、产品和订单信息。
发送数据层以在数据流中映射 data
要在数据流中映射,而不是在代码或规则中映射,请在data对象中发送数据层值,并包含XDM eventType,以便该事件正确分类。
| code language-js |
|---|
|
在ACDL侦听器中,this引用数据层,因此this.getState()返回计算状态。 要仅发送其中的一部分,请传递一个路径,如this.getState("page")。
-
创建具有ACDL扩展的 数据层计算状态 数据元素。 选择整个计算状态,或选择特定路径,然后输入要发送的数据的路径。 此示例将数据元素命名为
ACDL state。 -
创建与发送XDM数据具有相同 数据层推送 事件的规则。
-
从Web SDK扩展添加 发送事件 操作:
- 类型:
web.webpagedetails.pageViews - 数据:
%ACDL state%
- 类型:
-
保存规则,将其添加到库中,然后构建库。
然后,在数据流中,映射您发送到XDM架构的字段。 查看用于数据收集🔗的数据准备。 不映射且未配置服务读取的数据不会存储。 发送整个计算状态也会增加每个请求的大小,因此,对于具有大数据层的页面,只发送您映射的部分。
单页应用程序 spa
在单页应用程序中,当访客查看许多虚拟页面时,页面保持打开状态,并且数据层历史记录继续增长。 为每个虚拟页面视图推送page view事件,并在发送该事件后清除历史记录。 清除历史记录不会更改计算状态或删除侦听器和规则。
计时和重复项 timing
请按照以下步骤操作,以便每个事件只发送一次:
- 使用
all作用域。 在两种方法中,它是默认值:JavaScript中的scope选项和标记中的 时间范围 设置。 它会发送在侦听器或规则开始侦听之前推送的事件,例如在加载脚本或标记库之前推送的页面视图。 仅当您的实施的其他部分已发送较早的事件时,才使用future。 查看作用域。 - 从一个位置发送每个事件。 如果您自己的代码和标记规则都发送了相同的数据层事件,则Adobe会收到两次。
- JavaScript库:使用命名函数,并将每个侦听器添加一次。 对于同一事件,ACDL会忽略同一函数的第二次注册。 但是,如果每次重复运行的代码都传递一个新的匿名函数,则ACDL每次都会添加一个新的侦听器,并且每个事件都会发送多次。
- 标记扩展:针对特定事件名称触发。 在 所有数据更改 上触发的规则针对每次数据推送运行,这会发送比您预期多很多的事件。
相关页面 related
sendEvent命令和 发送事件 操作:用于发送事件的所有Web SDK选项。addEventListener()和数据层推送:用于侦听ACDL事件的所有选项。