clickCollection
clickCollection
对象包含多个帮助您控制自动收集的链接数据的变量。 当您想要在数据收集中包含或排除类型的链接时,请使用这些变量。
它需要启用clickCollectionEnabled
。
Web SDK 2.25.0或更高版本支持此功能。
clickCollection
对象中有以下变量可用:
-
clickCollection.internalLinkEnabled
:一个布尔值,确定是否自动跟踪当前域中的链接。 例如,https://example.com/index.html
到https://example.com/product.html
。 -
clickCollection.downloadLinkEnabled
:一个布尔值,用于确定库是否根据downloadLinkQualifier
属性跟踪符合下载条件的链接。 -
clickCollection.externalLinkEnabled
:一个布尔值,确定是否自动跟踪到外部域的链接。 例如,https://example.com
到https://example.net
。 -
clickCollection.eventGroupingEnabled
:一个布尔值,用于确定库是否等到下一页发送链接跟踪数据。 加载下一页面时,将链接跟踪数据与页面加载事件相结合。 启用此选项可减少您发送到Adobe的事件数。 如果internalLinkEnabled
被禁用,则此变量不执行任何操作。 -
clickCollection.sessionStorageEnabled
:一个布尔值,用于确定链接跟踪数据是否存储在会话存储中而不是存储在本地变量中。 如果internalLinkEnabled
或eventGroupingEnabled
被禁用,则此变量不执行任何操作。Adobe强烈建议在使用
eventGroupingEnabled
的单页应用程序之外时启用此变量。 如果在sessionStorageEnabled
被禁用时启用了eventGroupingEnabled
,则单击到新页面会导致链接跟踪数据丢失,因为它未保留在会话存储中。 由于单页应用程序通常不会导航到新页面,因此SPA页面不需要会话存储。 -
filterClickDetails
:回调函数,对您收集的链接跟踪数据提供完全控制。 您可以使用此回调函数来更改、模糊处理或中止发送链接跟踪数据。 当您要忽略特定信息(如链接中的个人身份信息)时,此回调很有用。
单击使用Web SDK标记扩展的收藏集设置
在配置标记扩展时,选择以下任一选项:
-
收集内部链接
-
事件分组选项:
- 无事件分组
- 使用会话存储进行事件分组
- 使用本地对象进行事件分组
-
-
收集外部链接
-
收集下载链接
-
筛选点击属性
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到 数据收集 > 标记。
- 选择所需的标记属性。
- 导航到 扩展,然后单击Adobe Experience Platform Web SDK卡片上的 配置。
- 向下滚动到数据收集部分,然后选择所需的单击收集设置。
- 单击 保存,然后发布更改。
过滤器单击属性回调将打开一个自定义代码编辑器,允许您插入所需的代码。 在代码编辑器中,您可以访问以下变量:
content.clickedElement
:被单击的DOM元素。content.pageName
:发生点击时的页面名称。content.linkName
:点击链接的名称。content.linkRegion
:点击链接的区域。content.linkType
:链接类型(退出、下载或其他)。content.linkURL
:点击链接的目标URL。return true
:使用当前变量值立即退出回调。return false
:立即退出回调并中止收集数据。
在content
之外定义的任何变量都可以使用,但不包括在发送到Adobe的有效负载中。
单击使用Web SDK JavaScript库的收藏集设置
运行configure
命令时,在clickCollection
对象中设置所需变量。 如果未设置,则此对象的默认设置取决于clickCollectionEnabled
的值。
internalLinkEnabled
:匹配clickCollectionEnabled
downloadLinkEnabled
:匹配clickCollectionEnabled
externalLinkEnabled
:匹配clickCollectionEnabled
eventGroupingEnabled
:默认为false
;必须显式启用sessionStorageEnabled
:默认为false
;必须显式启用filterClickDetails
:不包含函数;必须显式注册
internalLinkEnabled
时启用eventGroupingEnabled
,因为它减少了计入合同使用的事件数。alloy("configure", {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
clickCollectionEnabled: true,
clickCollection: {
internalLinkEnabled: true,
downloadLinkEnabled: true,
externalLinkEnabled: true,
eventGroupingEnabled: true,
sessionStorageEnabled: true,
filterClickDetails: function(content) {
// If the link is a clickable telephone number, anonymize it
if(content.linkUrl?.includes("tel:")) {
content.linkName = content.linkUrl = "Phone number";
}
// If the link is an email address, anonymize it
if(content.linkUrl?.includes("mailto:")) {
content.linkName = content.linkUrl = "Email address";
}
}
}
});