`clickCollectionEnabled`

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

开发人员

clickCollectionEnabled属性是一个布尔值，用于确定Web SDK是否自动收集链接数据。如果不设置此变量，则其默认值为true，这意味着默认情况下会自动收集链接跟踪数据。如果您希望手动跟踪链接数据，则将此属性设置为false很有用。

启用clickCollectionEnabled后，以下XDM元素会自动填充数据：

xdm.web.webInteraction.name
xdm.web.webInteraction.type
xdm.web.webInteraction.URL

默认情况下，如果启用此布尔值，则会自动跟踪内部链接、下载链接和退出链接。如果您希望更好地控制自动链接跟踪，Adobe建议使用clickCollection对象。

自动链接跟踪逻辑

如果Web SDK不具有<a>属性，则它会跟踪<area>和onClick个HTML元素上的所有点击。点击通过附加到文档的捕获点击事件侦听器捕获。在单击有效链接后，将按顺序运行以下逻辑：

如果链接基于downloadLinkQualifier中的值匹配条件，或者如果链接包含download HTML属性，则xdm.web.webInteraction.type设置为"download"（如果已启用clickCollection.downloadLinkEnabled）。
如果链接目标域与当前window.location.hostname不同，xdm.web.webInteraction.type将设置为"exit"（如果已启用clickCollection.exitLinkEnabled）。
如果该链接不符合"download"或"exit"的条件，则xdm.web.webInteraction.type将设置为"other"。

在所有情况下，xdm.web.webInteraction.name都设置为链接文本标签，xdm.web.webInteraction.URL设置为链接目标URL。如果您还想将链接名称设置为URL，则可以使用filterClickDetails对象中的clickCollection回调覆盖此XDM字段。

运行clickCollectionEnabled命令时设置configure布尔值。如果在配置Web SDK时省略此属性，则默认设置为true。如果您希望手动设置false和xdm.web.webInteraction.type，请将此值设置为xdm.web.webInteraction.value。

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});

支持打开的Shadow DOM元素

Web SDK支持对 打开影子DOM 元素中的链接进行自动点击跟踪。

许多现代网站都使用Web组件来构建可重用和封装的用户界面元素。这些组件通常使用名为 影子DOM 的技术来将其内部结构和样式与页面的其余部分分开。

有两种类型的影子DOM：

开放影子DOM：该页面中运行的JavaScript可以访问内部结构。其他脚本可以与组件进行交互或检查组件的内容。
关闭的影子DOM：内部结构在组件外隐藏在JavaScript中，因此无法对其进行跟踪或操作。

Web SDK自动跟踪<a>打开影子DOM<area>中的和元素的点击次数，就像跟踪主文档中的链接一样。此跟踪可确保使用打开的Shadow DOM的Web组件中的链接点击包含在您的分析数据中。不会跟踪 关闭的影子DOM 内的点击量，因为对该组件外运行的JavaScript代码而言，其内部结构是隐藏的。

启用或禁用Web SDK标记扩展的点击收集

请参阅Web SDK扩展文档中的数据收集配置设置，了解如何使用标记执行这些操作。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1