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 lorsque 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 :
xdm.web.webInteraction.name
xdm.web.webInteraction.type
xdm.web.webInteraction.URL
Les liens internes, les liens de téléchargement et les liens de sortie sont automatiquement suivis par défaut lorsque cette valeur booléenne est activée. Si vous souhaitez plus de contrôle sur le suivi automatique des liens, Adobe recommande d’utiliser l’objet clickCollection
.
Logique de suivi des liens automatique
Le SDK Web effectue le suivi de tous les clics sur les éléments d’HTML <a>
et <area>
s’il n’a pas d’attribut onClick
. Les clics sont capturés avec 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 :
- Si le lien correspond à des critères basés sur des valeurs dans
downloadLinkQualifier
, ou si le lien contient un attribut d’HTMLdownload
,xdm.web.webInteraction.type
est défini sur"download"
(siclickCollection.downloadLinkEnabled
est activé). - Si le domaine cible du lien diffère du
window.location.hostname
actif,xdm.web.webInteraction.type
est défini sur"exit"
(siclickCollection.exitLinkEnabled
est activé). - Si le lien ne remplit pas les critères pour
"download"
ou"exit"
,xdm.web.webInteraction.type
est défini sur"other"
.
Dans tous les cas, xdm.web.webInteraction.name
est défini sur l’étiquette de 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
.
Activation du suivi automatique des liens à l’aide de l’extension de balise SDK Web tag-extension
Cette variable est automatiquement gérée par l’extension de balise ; vous n’avez pas besoin 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 :
- Collecter les clics sur les liens internes
- Collecter les clics sur les liens externes
- Collecter les clics sur les liens de téléchargement
Voir clickCollection
pour plus d’informations.
Activation du suivi automatique des liens à l’aide de la bibliothèque JavaScript du SDK Web 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 du SDK Web, 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
});