使用Web SDK发送Adobe客户端数据层数据

Adobe客户端数据层(ACDL)会收集页面上的数据和事件,但不会将这些数据和事件发送到任何位置。 要将它们发送到Adobe Experience Platform Edge Network,请通过以下方式之一将ACDL事件连接到Web SDK:

  • JavaScript库:您自己的代码监听ACDL事件并调用Web SDK sendEvent命令。
  • 标记扩展:标记规则使用ACDL扩展在ACDL事件上触发,使用Web SDK扩展发送数据。

本页的每个部分都显示了这两种方法。

先决条件 prerequisites

您的网站代码会推送您要发送的数据和事件。 此页面上的示例为每个页面视图使用以下推送:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
  event: "page view",
  page: { title: "Home", language: "en" }
});

根据您的方法,您还需要以下各项:

JavaScript库

Web SDK基本代码将命令排入队列,直到其库加载为止,而ACDL将项目排入队列,直到其库加载为止。 由于这些队列,您可以将代码添加到此页面上的Web SDK基础代码之后的任意位置,而不管哪个库先加载。

标记扩展

选择如何映射数据 mapping

Web SDK在两个对象中发送数据。 选择一项或两项:

对象
映射的工作方式
使用时机
xdm
您可以从数据层值、代码或标记规则中构建与XDM架构匹配的对象。
您希望完全控制有效负载,或者您的数据层已经与架构类似。
data
您可以按原样发送数据层值。 您通过为数据收集准备数据,将它们映射到数据流中的XDM。
您希望将映射逻辑保留在页面代码和标记规则之外,或者多个网站共享一个管理良好的数据层。

选择值的来源 value-sources

当ACDL事件触发代码或规则时,您可以从两个位置读取数据层值:

源
JavaScript library
标记扩展
包含
推送的对象
event.page.title,其中event是侦听器的参数
%event.message.page.title%
仅触发事件的对象。
计算状态
adobeDataLayer.getState("page.title")
路径为page.title的 数据层计算状态 数据元素
迄今为止,所有数据都是通过每次推送合并而来的。

将推送对象用于描述事件本身的值,例如购物车附加中的产品。 对之前推送的值(如用户详细信息)使用计算状态。 当代码或规则运行时,计算状态已包含来自触发该代码或规则的推送的数据。 查看侦听器接收的内容和在规则中使用推送的数据。

发送XDM数据 xdm

以下示例使用推送对象中的页面标题发送页面查看。

JavaScript库

侦听事件并调用sendEvent:

code language-js
window.adobeDataLayer = window.adobeDataLayer || [];

function sendPageView(event) {
  alloy("sendEvent", {
    xdm: {
      eventType: "web.webpagedetails.pageViews",
      web: {
        webPageDetails: {
          name: event.page.title,
          pageViews: { value: 1 }
        }
      }
    }
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendPageView);
});

有关所有侦听器选项,请参阅addEventListener()。

标记扩展
  1. 创建具有Web SDK扩展的 变量 数据元素。 选择​XDM,然后选择您的沙盒和架构。 此示例将数据元素命名为XDM variable。

  2. 创建规则并添加事件:

    • 扩展: Adobe客户端数据层
    • 事件类型:数据层推送
    • 在​上触发: 特定命名事件,事件名称为page view
    • 时间范围:全部
  3. 添加填充XDM对象的操作:

    • 扩展:Adobe Experience Platform Web SDK
    • 操作类型: 更新变量
    • 数据元素: XDM variable
    • 将web.webPageDetails.name设置为%event.message.page.title%,并将web.webPageDetails.pageViews.value设置为1。
  4. 添加发送事件的操作:

    • 扩展:Adobe Experience Platform Web SDK
    • 操作类型: 发送事件
    • 类型: web.webpagedetails.pageViews
    • XDM: %XDM variable%
  5. 保存规则,将其添加到库中,然后构建库。

有关所有事件选项,请参阅数据层推送。

每次在您的网站推送page view事件时,该代码或规则都会将页面查看发送到Edge Network。

以相同的方式发送交互。 例如,对于推送(如{ event: "cart add", eventInfo: { sku: "HT105" } }),在cart add上侦听或触发,并从eventInfo中读取产品。 有关描述商务交互的XDM字段,请参阅收集商务、产品和订单信息。

发送数据层以在数据流中映射 data

要在数据流中映射,而不是在代码或规则中映射,请在data对象中发送数据层值,并包含XDM eventType,以便该事件正确分类。

JavaScript库
code language-js
function sendWithDataPrep(event) {
  alloy("sendEvent", {
    xdm: { eventType: "web.webpagedetails.pageViews" },
    data: this.getState()
  });
}

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", sendWithDataPrep);
});

在ACDL侦听器中,this引用数据层,因此this.getState()返回计算状态。 要仅发送其中的一部分,请传递一个路径,如this.getState("page")。

标记扩展
  1. 创建具有ACDL扩展的​ 数据层计算状态 ​数据元素。 选择​整个计算状态,或选择​特定路径,然后输入要发送的数据的路径。 此示例将数据元素命名为ACDL state。

  2. 创建与发送XDM数据具有相同​ 数据层推送 ​事件的规则。

  3. 从Web SDK扩展添加​ 发送事件 ​操作:

    • 类型: web.webpagedetails.pageViews
    • 数据: %ACDL state%
  4. 保存规则,将其添加到库中,然后构建库。

然后,在数据流中,映射您发送到XDM架构的字段。 查看用于数据收集🔗的数据准备。 不映射且未配置服务读取的数据不会存储。 发送整个计算状态也会增加每个请求的大小,因此,对于具有大数据层的页面,只发送您映射的部分。

单页应用程序 spa

在单页应用程序中,当访客查看许多虚拟页面时,页面保持打开状态,并且数据层历史记录继续增长。 为每个虚拟页面视图推送page view事件,并在发送该事件后清除历史记录。 清除历史记录不会更改计算状态或删除侦听器和规则。

JavaScript库

清除页面视图侦听器末尾的历史记录:

code language-js
function sendPageView(event) {
  alloy("sendEvent", { /* ... */ });
  this.length = 0;
}

请参阅清除历史记录。

标记扩展
添加来自ACDL扩展的 清除数据层历史记录 操作作为页面查看规则的最后一个操作。

计时和重复项 timing

请按照以下步骤操作,以便每个事件只发送一次:

  • 使用all作用域。 在两种方法中,它是默认值:JavaScript中的scope选项和标记中的​ 时间范围 ​设置。 它会发送在侦听器或规则开始侦听之前推送的事件,例如在加载脚本或标记库之前推送的页面视图。 仅当您的实施的其他部分已发送较早的事件时,才使用future。 查看作用域。
  • 从一个位置发送每个事件。 如果您自己的代码和标记规则都发送了相同的数据层事件,则Adobe会收到两次。
  • JavaScript库:使用命名函数,并将每个侦听器添加一次。 对于同一事件,ACDL会忽略同一函数的第二次注册。 但是,如果每次重复运行的代码都传递一个新的匿名函数,则ACDL每次都会添加一个新的侦听器,并且每个事件都会发送多次。
  • 标记扩展:针对特定事件名称触发。 在​ 所有数据更改 ​上触发的规则针对每次数据推送运行,这会发送比您预期多很多的事件。
recommendation-more-help
experience-platform-help-collection