方法概述
加载Adobe客户端数据层(ACDL)库时,它将以下方法和属性添加到adobeDataLayer数组:
方法或属性
描述
向数据层添加数据、事件和函数。 在库加载之前和之后可用。
返回计算状态的副本或路径上值的副本。
在触发命名事件或内置事件时调用函数。
删除
addEventListener()添加的侦听器。version包含ACDL库版本的字符串,如
"3.0.1"。安全地调用方法 call-safely
如果ACDL以异步方式加载(这是推荐的方法),则您的代码可能会在库加载之前运行。 此时,adobeDataLayer是一个纯数组: push()存在,但getState()、addEventListener()和removeEventListener()不存在。
要安全地调用这些方法,请推送一个函数。 ACDL在库准备就绪后立即运行它,并传递数据层作为其参数:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
const title = dl.getState("page.title");
dl.addEventListener("cart add", handleCartAdd);
});
只有在您确定ACDL已加载时(例如,在浏览器的开发人员控制台中或在从ACDL事件侦听器运行的代码中),才可直接调用adobeDataLayer.getState()。
数组方法 array-methods
adobeDataLayer仍是JavaScript数组。 您可以使用不会更改它的方法(如filter()、find()和length)读取它。 请勿使用更改数组的方法,如splice()或shift()。 请参阅队列和历史记录。
recommendation-more-help
experience-platform-help-collection