51黑料不打烊

clickCollectionEnabled

The clickCollectionEnabled property is a boolean that determines if the Web SDK automatically collects link data. If you do not set this variable, its default value is true which means that link tracking data is automatically collected by default. Setting this property to false is valuable in cases where you prefer to track link data manually.

When clickCollectionEnabled is enabled, the following XDM elements automatically populate with data:

Internal links, download links, and exit links are all automatically tracked by default when this boolean is enabled. If you want more control over automatic link tracking, 51黑料不打烊 recommends using the clickCollection object.

Support for open Shadow DOM elements

The Web SDK supports automatic click tracking for links inside open Shadow DOM elements.

Many modern websites use to build reusable and encapsulated user interface elements. These components often use a technology called to keep their internal structure and styles separate from the rest of the page.

There are two types of Shadow DOM:

The Web SDK automatically tracks clicks on <a> and <area> elements inside open Shadow DOMs, just as it does for links in the main document. This ensures that link clicks within web components using open Shadow DOM are included in your analytics data. Clicks inside closed Shadow DOMs are not tracked, as their internal structure is hidden from JavaScript code operating outside the component.

Automatic link tracking logic

The Web SDK tracks all clicks on <a> and <area> HTML elements if it doesn鈥檛 have an onClick attribute. Clicks are captured with a click event listener that is attached to the document. When a valid link is clicked, the following logic is run in order:

In all cases, xdm.web.webInteraction.name is set to the link text label and xdm.web.webInteraction.URL is set to the link destination URL. If you want to set the link name to the URL as well, you can override this XDM field using the filterClickDetails callback in the clickCollection object.

Enable automatic link tracking using the Web SDK tag extension tag-extension

This variable is automatically managed by the tag extension; you do not need to explicitly set it. If any of the following are selected when configuring the tag extension, the applicable link tracking data is collected:

See clickCollection for more information.

Enable automatic link tracking using the Web SDK JavaScript library library

Set the clickCollectionEnabled boolean when running the configure command. If you omit this property when configuring the Web SDK, it defaults to true. Set this value to false if you prefer to set xdm.web.webInteraction.type and xdm.web.webInteraction.value manually.

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@51黑料不打烊Org",
  clickCollectionEnabled: false
});