队列和历史记录

adobeDataLayer数组具有两个角色。 在加载Adobe Client Data Layer (ACDL)库之前,它是一个​ 队列 ​待处理的项目。 加载库后,它是已推送的数据和事件的​历史记录。

在ACDL加载之前:队列 queue

在加载库之前,adobeDataLayer是纯JavaScript数组,push()是标准数组方法。 每次推送都会将项添加到数组的末尾,除此之外不执行任何其他操作。 因此,任何脚本都可以随时推送数据、事件和函数,即使库尚未下载。

加载库时,会执行以下操作:

  1. 从数组中移除所有排队的项目。
  2. 将ACDL方法添加到同一数组,包括其自己的push()版本。
  3. 按原始顺序再次推送已排队的项目,一次推送一个。 每个项目都会像在加载库后推送一样进行处理。

全局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进行接收。

IMPORTANT
如果排队函数在库加载时引发错误,则ACDL将停止处理队列。 在该函数之后排队的项目将丢失。 捕获您推送的函数中的错误。

加载ACDL之后:历史记录 history

加载库后,数组会保留推送内容的记录。 ACDL将某些类型的项添加到数组中并删除其他项:

已推送的项目
保留在数组中
数据对象
是
事件对象,包括其event和eventInfo键
是
函数
没有。 ACDL会调用它,但不会保留它。
无效项目,例如字符串或数字
没有。 ACDL会记录错误,但不会保留该错误。

历史记录保存的是您推送的对象,而不是这些对象的副本。 如果在推送对象后更改该对象,则历史记录会显示更改,但计算状态不会显示更改。

您可以通过键入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;
    });
    
recommendation-more-help
experience-platform-help-collection