clickCollectionEnabled

La propriété clickCollectionEnabled est une valeur booléenne qui détermine si le SDK Web collecte automatiquement les données de lien. Si vous ne définissez pas cette variable, sa valeur par défaut est true, ce qui signifie que les données de suivi des liens sont automatiquement collectées par défaut. La définition de cette propriété sur false est utile dans les cas où vous préférez effectuer le suivi manuel des données de lien.

Lorsque clickCollectionEnabled est activé, les éléments XDM suivants sont automatiquement renseignés avec des données :

Les liens internes, les liens de téléchargement et les liens de sortie sont tous automatiquement suivis par défaut lorsque cette valeur booléenne est activée. Pour mieux contrôler le suivi automatique des liens, Adobe recommande d’utiliser l’objet clickCollection .

Prise en charge des éléments de Shadow DOM ouverts

Web SDK prend en charge le suivi automatique des clics pour les liens à l’intérieur des éléments Shadow DOM ouverts.

De nombreux sites web modernes utilisent des composants web pour créer des éléments d’interface utilisateur réutilisables et encapsulés. Ces composants utilisent souvent une technologie appelée Shadow DOM pour séparer leur structure interne et leurs styles du reste de la page.

Il existe deux types de Shadow DOM :

Web SDK effectue automatiquement le suivi des clics sur les éléments <a> et <area> dans les éléments Shadow DOM, comme pour les liens dans le document principal. Cela garantit que les clics sur les liens dans les composants web à l’aide de Shadow DOM ouverts sont inclus dans vos données d’analyse. Les clics à l’intérieur des DOM fantômes fermés ne sont pas suivis, car leur structure interne est masquée du code JavaScript fonctionnant en dehors du composant.

Logique de tracking automatique des liens

Le SDK Web suit tous les clics sur les éléments <a> et <area> d’HTML s’il ne dispose pas d’un attribut onClick. Les clics sont capturés à l’aide d’un écouteur d’événement de clic capture joint au document. Lorsqu’un utilisateur clique sur un lien valide, la logique suivante est exécutée dans l’ordre :

Dans tous les cas, xdm.web.webInteraction.name est défini sur le libellé du texte du lien et xdm.web.webInteraction.URL sur l’URL de destination du lien. Si vous souhaitez également définir le nom du lien sur l’URL, vous pouvez remplacer ce champ XDM à l’aide du rappel filterClickDetails dans l’objet clickCollection .

Activer le suivi automatique des liens à l’aide de l’extension de balises Web SDK tag-extension

Cette variable est automatiquement gérée par l’extension de balise. Il n’est pas nécessaire de la définir explicitement. Si l’un des éléments suivants est sélectionné lors de la configuration de l’extension de balise, les données de suivi des liens applicables sont collectées :

Voir clickCollection pour plus d’informations.

Activer le suivi automatique des liens à l’aide de la bibliothèque JavaScript Web SDK library

Définissez la valeur booléenne clickCollectionEnabled lors de l’exécution de la commande configure. Si vous omettez cette propriété lors de la configuration de Web SDK, elle est définie par défaut sur true. Définissez cette valeur sur false si vous préférez définir xdm.web.webInteraction.type et xdm.web.webInteraction.value manuellement.

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