Adobe客户端数据层故障排除

使用此页可以诊断Adobe客户端数据层(ACDL)的常见问题。 大多数检查使用浏览器的开发人员控制台。

检查数据层 inspect

在控制台中运行以下命令:

命令
结果
adobeDataLayer.version
ACDL版本,如"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

  • 值已推送为event或eventInfo。 这些键不会以计算状态存储。 推送其他键下的数据。
  • 数组丢失了项。 推送一个数组将替换整个数组。 推送整个数组。 请参阅数组。
  • 对象未替换字符串、数字或布尔值。 首先通过推送null删除键,然后推送对象。 查看更改值的类型。
  • 日期或函数成为空对象。 将日期存储为字符串或数字。 查看值类型。
  • 对getState()的结果所做的更改无效。 getState()返回副本。 改为推送更改。
  • 带有路径的​getState()返回undefined. 检查路径中每个键的拼写。 将点用于数组索引,如items.0.sku,而不是括号。 查看在路径处获取值。

历史记录中缺少项目 history-issues

  • 未保留函数和无效项。 只保留数据对象和事件对象。 查看ACDL加载后的:历史记录。
  • 侦听器引发错误。 当侦听器抛出错误时,触发它的项会更新计算状态,但不会添加到历史记录中。
  • 一个push()调用包含多种项目。 在单独的调用中推送每个项目。 查看每次调用推送一个项目。
  • 历史记录已清除,例如由标记扩展中的​ 清除数据层历史记录 ​操作清除。
recommendation-more-help
experience-platform-help-collection