创建数据层
数据层是网站上的JavaScript结构,用于公开Analytics实施收集的数据,例如页面名称、产品详细信息和订单ID。 网站代码将写入数据层,并且实施会从中读取数据以设置Analytics变量。 由于您的实施不依赖于页面的HTML,因此您可以重新设计网站而不会中断数据收集。
先决条件
创建解决方案设计文档:贵组织必须符合跟踪要求。 在联系组织中的开发团队之前,请确保您已准备好解决方案设计文档。 解决方案设计所需的数据将决定数据层包含的内容。
选择数据层规范 specifications
对于新的或重构的实现,Adobe建议使用Adobe客户端数据层 (ACDL)。 ACDL是一个开源JavaScript库,它为您的站点提供了一种将数据和事件推送到全局adobeDataLayer阵列的标准方法。 标记、Web SDK和AppMeasurement都可以从中读取,并且Adobe Experience Manager核心组件可以自动填充该变量。
您的组织可以自由使用其他规范,例如客户体验数字数据层 (CEDDL)(将数据存储在全局digitalData对象中)或自定义规范。 最重要的是贵组织需要符合一个规范,以满足其需求。
下表将ACDL与基于对象的数据层(如CEDDL)进行比较:
adobeDataLayer)digitalData)adobeDataLayer.push({ page: { name: "Home" } })digitalData.page.pageInfo.pageName = "Home"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 时通常遵循以下步骤:
- 与网站开发团队合作实施数据层:网站开发团队主要负责确保数据层包含正确的值。 与您的网站开发团队一起审阅此页面,以确保各团队的期望是一致的。 请参阅安装Adobe客户端数据层。
- 使用浏览器控制台验证数据层:打开浏览器的开发人员控制台,在大多数浏览器中都可以使用
F12键执行此操作。 运行adobeDataLayer.getState()以查看计算状态,或运行adobeDataLayer.getState("page.name")以查看单个值。 请参阅验证安装。 - 将数据层连接到Adobe Analytics:此步骤因您组织的实施方法而异。 请参阅将数据层连接到Adobe Analytics。
将数据层连接到Adobe Analytics connect
下表显示了每种实施方法如何从Adobe Client Data Layer读取:
data对象,然后通过 发送事件 操作发送它们。addEventListener()的数据层事件,并在调用sendEvent时从数据层设置XDM或data字段。使用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(),以便来自一次点击的值不会持续到下一次点击。
后续步骤
- 将数据层对象映射到数据元素:在Adobe Experience Platform标记中使用网站的数据层。
- Adobe客户端数据层文档:了解每个ACDL方法、事件和最佳实践。