创建数据层

数据层是网站上的JavaScript结构,用于公开Analytics实施收集的数据,例如页面名称、产品详细信息和订单ID。 网站代码将写入数据层,并且实施会从中读取数据以设置Analytics变量。 由于您的实施不依赖于页面的HTML,因此您可以重新设计网站而不会中断数据收集。

先决条件

创建解决方案设计文档:贵组织必须符合跟踪要求。 在联系组织中的开发团队之前,请确保您已准备好解决方案设计文档。 解决方案设计所需的数据将决定数据层包含的内容。

选择数据层规范 specifications

对于新的或重构的实现,Adobe建议使用Adobe客户端数据层 (ACDL)。 ACDL是一个开源JavaScript库,它为您的站点提供了一种将数据和事件推送到全局adobeDataLayer阵列的标准方法。 标记、Web SDK和AppMeasurement都可以从中读取,并且Adobe Experience Manager核心组件可以自动填充该变量。

您的组织可以自由使用其他规范,例如客户体验数字数据层 (CEDDL)(将数据存储在全局digitalData对象中)或自定义规范。 最重要的是贵组织需要符合一个规范,以满足其需求。

下表将ACDL与基于对象的数据层(如CEDDL)进行比较:

Adobe客户端数据层(adobeDataLayer)
基于对象的数据层,如CEDDL (digitalData)
站点代码如何写入数据
推送对象: adobeDataLayer.push({ page: { name: "Home" } })
设置属性: digitalData.page.pageInfo.pageName = "Home"
您的实施如何读取值
Adobe客户端数据层标记扩展中的adobeDataLayer.getState("page.name")或​ 数据层计算状态 ​数据元素
核心标记扩展中的digitalData.page.pageInfo.pageName或​ JavaScript变量 ​数据元素
您的实施如何知道数据已准备就绪
站点代码推送事件(如{ event: "page view" }),并且您的实施侦听该事件。 此外,侦听器也会针对添加之前推送的事件运行。
在网站代码完成填充后(例如,使用直接调用规则),您的实施必须读取对象。

示例数据层 example

ACDL不需要特定的数据结构。 围绕解决方案设计文档设计结构,并为写入或读取数据层的每个人记录该文档。 本指南中的示例使用以下结构。

加载页面时,网站代码推送页面数据和页面查看事件:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
  event: "page view",
  page: {
    name: "Home",
    section: "Products",
    url: "https://example.com/products",
    referrer: "https://example.com/"
  }
});

当访客完成购买时,网站代码会推送订单详细信息和购买事件:

window.adobeDataLayer.push({
  event: "purchase",
  transaction: { id: "ABC123" },
  products: [
    { name: "Example product", category: "Example category", quantity: 1, price: 25 }
  ]
});

ACDL将每次推送合并到一个名为计算状态的对象,您的实施将读取该状态。 事件对象告知您的实施何时读取它。 查看数据和计算状态和事件。

工作流 workflow

使用数据层实施 Adobe Analytics 时通常遵循以下步骤:

  1. 与网站开发团队合作实施数据层:网站开发团队主要负责确保数据层包含正确的值。 与您的网站开发团队一起审阅此页面,以确保各团队的期望是一致的。 请参阅安装Adobe客户端数据层。
  2. 使用浏览器控制台验证数据层:打开浏览器的开发人员控制台,在大多数浏览器中都可以使用F12键执行此操作。 运行adobeDataLayer.getState()以查看计算状态,或运行adobeDataLayer.getState("page.name")以查看单个值。 请参阅验证安装。
  3. 将数据层连接到Adobe Analytics:此步骤因您组织的实施方法而异。 请参阅将数据层连接到Adobe Analytics。

将数据层连接到Adobe Analytics connect

下表显示了每种实施方法如何从Adobe Client Data Layer读取:

实施方法
如何读取数据层
更多信息
Web SDK 标记扩展
通过Adobe客户端数据层扩展中的​ 数据层推送 ​事件触发规则。 将数据层值映射到XDM字段或通过Web SDK 更新变量​操作映射到data对象,然后通过​ 发送事件 ​操作发送它们。
使用Web SDK、XDM对象字段映射和数据对象字段映射发送Adobe客户端数据层数据
Web SDK JavaScript库
侦听具有addEventListener()的数据层事件,并在调用sendEvent时从数据层设置XDM或data字段。
使用Web SDK、XDM对象字段映射和数据对象字段映射发送Adobe客户端数据层数据
Analytics 扩展
使用​ 数据层推送 ​事件触发规则,并从Adobe客户端数据层扩展创建​ 数据层计算状态 ​数据元素。 在​ 设置变量 ​操作中将数据元素分配给Analytics变量,然后使用​ 发送信标 ​操作发送数据。
将数据层对象映射到数据元素和将数据元素映射到Analytics变量
AppMeasurement
在ACDL加载后读取带有getState()的值,然后调用s.t()。
使用AppMeasurement读取数据层

使用AppMeasurement读取数据层 appmeasurement

加载库时,ACDL将其getState()方法添加到adobeDataLayer数组。 要确保库已加载并且计算状态包含最新数据,请读取事件侦听器中的值:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("page view", function(event) {
    s.pageName = dl.getState("page.name");
    s.channel = dl.getState("page.section");
    s.t();
  });
});

侦听器针对每个page view事件(包括在添加侦听器之前推送的事件)运行一次。 本指南中的变量页面(如pageName)显示了如何使用getState()读取各个值。 在这样的侦听器中或​ 数据层推送 ​事件触发的Analytics扩展规则的自定义代码编辑器中使用这些示例。

如果您的实施每页发送多个点击,例如在单页应用程序中,请使用clearVars(),以便来自一次点击的值不会持续到下一次点击。

后续步骤

recommendation-more-help
analytics-help-implement