Adobe客户端数据层故障排除
使用此页可以诊断Adobe客户端数据层(ACDL)的常见问题。 大多数检查使用浏览器的开发人员控制台。
检查数据层 inspect
在控制台中运行以下命令:
命令
结果
adobeDataLayer.versionACDL版本,如
"3.0.1"。 如果是undefined,则尚未加载ACDL。adobeDataLayer.getState()计算状态。
adobeDataLayer数据和事件对象的history(按处理顺序)。
要在事件发生时监视这些事件,请添加临时侦听器:
adobeDataLayer.addEventListener("adobeDataLayer:event", function(event) {
console.log("ACDL event:", event.event, event);
}, { scope: "future" });
控制台消息 console-messages
消息
原因和解决方案
The following item cannot be handled by the data layer because it does not have a valid format: ...某些内容推送的值不是纯对象或函数,例如字符串或数组。 查找用于推送消息中显示的值的代码。 查看无效项。
Adobe Client Data Layer v... has already been imported/initialized on this page. You may be erroneously loading it a second time.库已加载多次。 第一个版本继续运行。 删除多余的副本。 请参阅仅加载库一次。
TypeError: adobeDataLayer.getState is not a function (或addEventListener,removeEventListener)在加载库之前调用了ACDL方法的代码。 请从您推送的函数中调用它。 查看安全调用方法。
ReferenceError: structuredClone is not defined浏览器比ACDL 3.x支持的版本旧。 请参阅浏览器要求。
TypeError: Cannot read properties of null (reading 'event')已推送代码
null或undefined。RangeError: Maximum call stack size exceeded侦听器会推送触发自身的某些内容。 请参阅避免无穷循环。
JavaScript错误消息的措辞在不同浏览器之间略有不同。 例如,Safari报告ReferenceError: Can't find variable: structuredClone。
ACDL未加载 not-loaded
如果adobeDataLayer.version是undefined,请检查以下各项:
- 该库不在页面上。 检查
adobe-client-data-layer.min.js的网络面板,或标签库的网络面板(如果标签扩展加载ACDL)。 确保您的内容安全策略允许该脚本。 adobeDataLayer不是数组。 如果在ACDL加载之前,其他脚本将window.adobeDataLayer设置为数组以外的其他内容,则ACDL不会附加到它。- 脚本替换了数组。 诸如
window.adobeDataLayer = [];之类的代码会将数据层替换为新的空数组,这会丢失ACDL方法、计算状态和所有侦听器。 始终使用window.adobeDataLayer = window.adobeDataLayer || [];。 请参阅创建数据层数组。 - 排队函数引发错误。 如果在加载ACDL之前推送的函数引发错误,则控制台中会显示该错误,并且在该函数之后排队的项目将丢失。 捕获您推送的函数中的错误。
监听程序未运行 listener-not-called
检查以下各项:
- 事件名称不匹配。 事件名称区分大小写,且必须完全匹配,包括空格。
- 该事件是在添加侦听器之前推送的,侦听器使用
future作用域。 使用默认all范围。 查看作用域。 - 历史记录在添加侦听器之前已被清除,因此没有任何可重播的内容。 请参阅清除历史记录。
- 该
path选项筛选出了推送。 具有路径的侦听器只针对包含该路径的推送运行。 查看路径。 - 从未添加侦听器。 如果侦听器参数不是函数或范围无效,则ACDL不会添加侦听器。 相反,诸如
on和handler的键出现在adobeDataLayer.getState()中。 - 已为该事件注册了相同的函数。 ACDL会忽略第二个注册,即使使用不同的选项也是如此。
- 早期侦听器为同一推送抛出错误,从而停止其余侦听器。 检查控制台是否有错误。
- 推送不是事件。 缺少
event值、该值为空或不包含字符串的对象被视为数据。 它触发adobeDataLayer:change侦听器,而不是事件侦听器。
侦听器运行的频率高于预期 listener-called-too-often
- 它会重播过去的活动。 使用默认
all范围,将运行新的侦听器以匹配历史记录中已存在的事件。 此行为是符合预期的。 如果已处理早期事件,则使用future范围。 - 已添加多次。 重复运行且每次都传递新的匿名函数的代码,每次都添加一个新的侦听器。 使用命名函数。 请参阅使用命名函数。
- 它使用路径。 具有路径的侦听器会为包含该路径的每次推送运行,即使值未发生更改也是如此。
计算状态中数据缺失或错误 state-issues
历史记录中缺少项目 history-issues
- 未保留函数和无效项。 只保留数据对象和事件对象。 查看ACDL加载后的:历史记录。
- 侦听器引发错误。 当侦听器抛出错误时,触发它的项会更新计算状态,但不会添加到历史记录中。
- 一个
push()调用包含多种项目。 在单独的调用中推送每个项目。 查看每次调用推送一个项目。 - 历史记录已清除,例如由标记扩展中的 清除数据层历史记录 操作清除。
recommendation-more-help
experience-platform-help-collection