clickCollection

clickCollection对象包含多个帮助您控制自动收集的链接数据的变量。 当您想要在数据收集中包含或排除类型的链接时,请使用这些变量。

它需要启用clickCollectionEnabled

Web SDK 2.25.0或更高版本支持此功能。

clickCollection对象中有以下变量可用:

  • clickCollection.internalLinkEnabled:一个布尔值,确定是否自动跟踪当前域中的链接。 例如,https://example.com/index.htmlhttps://example.com/product.html

  • clickCollection.downloadLinkEnabled:一个布尔值,用于确定库是否根据downloadLinkQualifier属性跟踪符合下载条件的链接。

  • clickCollection.externalLinkEnabled:一个布尔值,确定是否自动跟踪到外部域的链接。 例如,https://example.comhttps://example.net

  • clickCollection.eventGroupingEnabled:一个布尔值,用于确定库是否等到下一页发送链接跟踪数据。 加载下一页面时,将链接跟踪数据与页面加载事件相结合。 启用此选项可减少您发送到Adobe的事件数。 如果internalLinkEnabled被禁用,则此变量不执行任何操作。

  • clickCollection.sessionStorageEnabled:一个布尔值,用于确定链接跟踪数据是否存储在会话存储中而不是存储在本地变量中。 如果internalLinkEnabledeventGroupingEnabled被禁用,则此变量不执行任何操作。

    Adobe强烈建议在使用eventGroupingEnabled的单页应用程序之外时启用此变量。 如果在sessionStorageEnabled被禁用时启用了eventGroupingEnabled,则单击到新页面会导致链接跟踪数据丢失,因为它未保留在会话存储中。 由于单页应用程序通常不会导航到新页面,因此SPA页面不需要会话存储。

  • filterClickDetails:回调函数,对您收集的链接跟踪数据提供完全控制。 您可以使用此回调函数来更改、模糊处理或中止发送链接跟踪数据。 当您要忽略特定信息(如链接中的个人身份信息)时,此回调很有用。

单击使用Web SDK标记扩展的收藏集设置

配置标记扩展时,选择以下任一选项:

  • 收集内部链接

    • 事件分组选项:

      • 无事件分组
      • 使用会话存储进行事件分组
      • 使用本地对象进行事件分组
  • 收集外部链接

  • 收集下载链接

  • 筛选点击属性

  1. 使用您的Adobe ID凭据登录experience.adobe.com
  2. 导航到​ 数据收集 > 标记
  3. 选择所需的标记属性。
  4. 导航到​ 扩展,然后单击Adobe Experience Platform Web SDK卡片上的​ 配置
  5. 向下滚动到数据收集部分,然后选择所需的单击收集设置。
  6. 单击​ 保存,然后发布更改。

过滤器单击属性回调将打开一个自定义代码编辑器,允许您插入所需的代码。 在代码编辑器中,您可以访问以下变量:

  • 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:不包含函数;必须显式注册
TIP
Adobe建议在启用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";
      }
    }
  }
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636