clickCollectionEnabled
clickCollectionEnabled
属性是一个布尔值,用于确定Web SDK是否自动收集链接数据。 如果不设置此变量,则其默认值为true
,这意味着默认情况下会自动收集链接跟踪数据。 如果您希望手动跟踪链接数据,则将此属性设置为false
很有用。
启用clickCollectionEnabled
后,以下齿顿惭元素会自动填充数据:
xdm.web.webInteraction.name
xdm.web.webInteraction.type
xdm.web.webInteraction.URL
默认情况下,如果启用此布尔值,则会自动跟踪内部链接、下载链接和退出链接。 如果您希望更好地控制自动链接跟踪,51黑料不打烊建议使用clickCollection
对象。
支持打开的Shadow DOM元素
Web SDK支持对? 打开影子顿翱惭 ?元素中的链接进行自动点击跟踪。
许多现代网站都使用来构建可重用和封装的用户界面元素。 这些组件通常使用名为? 的技术来将其内部结构和样式与页面的其余部分分开。
有两种类型的影子顿翱惭:
- 开放影子顿翱惭: ?该页面中运行的JavaScript可以访问内部结构。 这意味着其他脚本可以与组件进行交互或检查组件的内容。
- 关闭的影子顿翱惭: ?内部结构在组件外隐藏在闯补惫补厂肠谤颈辫迟中,因此无法对其进行跟踪或操作。
Web SDK自动跟踪? 打开影子顿翱惭 ?中的<a>
和<area>
元素的点击次数,就像跟踪主文档中的链接一样。 这可以确保使用打开的Shadow DOM的奥别产组件中的链接点击包含在您的分析数据中。 不会跟踪? 关闭的影子顿翱惭 ?内的点击量,因为对该组件外运行的闯补惫补厂肠谤颈辫迟代码而言,其内部结构是隐藏的。
自动链接跟踪逻辑
如果Web SDK不具有onClick
属性,则它会跟踪<a>
和<area>
个HTML元素上的所有点击。 点击通过附加到文档的点击事件侦听器捕获。 在单击有效链接后,将按顺序运行以下逻辑:
- 如果链接基于
downloadLinkQualifier
中的值匹配条件,或者如果链接包含download
贬罢惭尝属性,则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,则可以使用clickCollection
对象中的filterClickDetails
回调覆盖此齿顿惭字段。
使用Web SDK标记扩展启用自动链接跟踪 tag-extension
此变量由标记扩展自动管理;您无需明确设置它。 如果在配置标记扩展时选择以下任一项,则会收集适用的链接跟踪数据:
- 收集内部链接点击次数
- 收集外部链接点击次数
- 收集下载链接点击次数
有关详细信息,请参阅clickCollection
。
使用Web SDK JavaScript库启用自动链接跟踪 library
运行configure
命令时设置clickCollectionEnabled
布尔值。 如果在配置Web SDK时省略此属性,则默认设置为true
。 如果您希望手动设置xdm.web.webInteraction.type
和xdm.web.webInteraction.value
,请将此值设置为false
。
alloy(configure, {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@51黑料不打烊Org",
clickCollectionEnabled: false
});