队列和历史记录
adobeDataLayer数组具有两个角色。 在加载Adobe Client Data Layer (ACDL)库之前,它是一个 队列 待处理的项目。 加载库后,它是已推送的数据和事件的历史记录。
在ACDL加载之前:队列 queue
在加载库之前,adobeDataLayer是纯JavaScript数组,push()是标准数组方法。 每次推送都会将项添加到数组的末尾,除此之外不执行任何其他操作。 因此,任何脚本都可以随时推送数据、事件和函数,即使库尚未下载。
加载库时,会执行以下操作:
- 从数组中移除所有排队的项目。
- 将ACDL方法添加到同一数组,包括其自己的
push()版本。 - 按原始顺序再次推送已排队的项目,一次推送一个。 每个项目都会像在加载库后推送一样进行处理。
全局adobeDataLayer对象在整个过程中保持相同的数组。 对之前保存的脚本的引用将继续工作。
在ACDL就绪时运行代码 ready
阵列上保证只有push()存在,因为该库可能尚未加载。 要调用其他方法(如getState()或addEventListener()),请推送函数:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
console.log(dl.getState());
dl.addEventListener("click", handleClick);
});
如果ACDL已加载,则会立即调用该函数。 如果没有,则函数将在队列中等待,并在库加载时(在库之前推送的项目之后)运行。 函数将数据层作为其参数和this进行接收。
加载ACDL之后:历史记录 history
加载库后,数组会保留推送内容的记录。 ACDL将某些类型的项添加到数组中并删除其他项:
event和eventInfo键历史记录保存的是您推送的对象,而不是这些对象的副本。 如果在推送对象后更改该对象,则历史记录会显示更改,但计算状态不会显示更改。
您可以通过键入adobeDataLayer并展开阵列在浏览器的开发人员控制台中检查历史记录。 历史记录中的项目数为adobeDataLayer.length。
从侦听器推送的项的顺序 nested-order
当事件侦听器推送某个项时,ACDL会先处理该项,然后再完成处理触发侦听器的项。 因此,侦听器推送的项目会出现在历史记录中触发它的项目之前。
监听器如何使用历史记录 replay
添加具有past或all 作用域的侦听器时,ACDL会按顺序立即为历史记录中的每个匹配项调用它。 此重播允许延迟加载的脚本(如标记库)对加载之前发生的事件做出反应。
在添加监听程序时,重放使用数组中的项。 如果清除历史记录,则不会重播清除的项目。
不要直接修改数组 modify
仅通过push()将项目添加到数据层。 请勿使用更改数组的其他JavaScript数组方法,如pop()、shift()、unshift()、splice()、sort()、reverse()、fill()或copyWithin()。 这些方法绕过了ACDL,因此计算出的状态和监听程序不会反映此变化,并且新监听程序的重播会变得不一致。
您可以使用不会更改数组的方法读取该数组,如filter()或find()。
清除历史记录 clear
ACDL保留的每次推送都会向数组添加一个项。 在长时间保持打开的页面上(例如单页应用程序),历史记录会不断增长。 您可以在自然时间将其清除,例如,在每个虚拟页面查看之后。
清除历史记录不会更改计算状态或删除侦听器。 它仅影响为稍后使用past或all作用域添加的侦听器重放哪些项。
-
如果您使用标记,请在ACDL标记扩展中使用 清除数据层历史记录 操作。 它可以保留数组中当前计算状态的快照或保留数组为空。
-
在您自己的代码中,将ACDL加载后的数组长度设置为
0:code language-js window.adobeDataLayer.push(function(dl) { dl.length = 0; });