clickCollection
La variable clickCollection contient plusieurs variables qui vous aident à contrôler les données de lien collectées automatiquement. Utilisez ces variables lorsque vous souhaitez inclure ou exclure des types de liens de la collecte de données.
Cela nécessite clickCollectionEnabled à activer.
Elle est prise en charge sur le SDK Web 2.25.0 ou version ultérieure.
Les variables suivantes sont disponibles dans la variable clickCollection objet :
-
clickCollection.internalLinkEnabled: valeur booléenne qui détermine si les liens du domaine actif sont automatiquement suivis. Par exemple :https://example.com/index.htmltohttps://example.com/product.html. -
clickCollection.downloadLinkEnabled: valeur booléenne qui détermine si la bibliothèque effectue le suivi des liens qualifiés de téléchargements en fonction de la variabledownloadLinkQualifier. -
clickCollection.externalLinkEnabled: valeur booléenne qui détermine si les liens vers des domaines externes sont automatiquement suivis. Par exemple :https://example.comtohttps://example.net. -
clickCollection.eventGroupingEnabled: valeur booléenne qui détermine si la bibliothèque attend jusqu’à la page suivante pour envoyer les données de suivi des liens. Lorsque la page suivante se charge, combinez les données de suivi des liens à l’événement de chargement de page. L’activation de cette option réduit le nombre d’événements que vous envoyez à Adobe. IfinternalLinkEnabledest désactivée, alors cette variable ne fait rien. -
clickCollection.sessionStorageEnabled: valeur booléenne qui détermine si les données de suivi des liens sont stockées dans l’enregistrement de session au lieu des variables locales. IfinternalLinkEnabledoueventGroupingEnabledsont désactivées, alors cette variable ne fait rien.Adobe recommande vivement d’activer cette variable lorsque vous utilisez
eventGroupingEnabled. IfeventGroupingEnabledest activé pendantsessionStorageEnabledest désactivée, le fait de cliquer sur une nouvelle page entraîne la perte des données de suivi des liens, car elles ne sont pas conservées dans l’enregistrement de session. Bien qu’il soit acceptable de désactiversessionStorageEnableddans les applications d’une seule page, il n’est pas idéal pour les pages non SPA. -
filterClickDetails: fonction de rappel qui fournit des contrôles complets sur les données de suivi des liens que vous collectez. Vous pouvez utiliser cette fonction de rappel pour modifier, obscurcir ou interrompre l’envoi de données de suivi des liens. Ce rappel est utile lorsque vous souhaitez omettre des informations spécifiques, telles que des informations d’identification personnelle dans les liens.
Cliquez sur les paramètres de collecte à l’aide de l’extension de balise SDK Web.
Sélectionnez la variable Activer la collecte de données de clic , configuration de l’extension de balise. L’activation de cette case à cocher affiche les options suivantes relatives à la collection de clics :
-
Liens internes
- Activation du regroupement d’événements
- Activation du stockage de session
-
Liens externes
-
Liens de téléchargement
-
Filtrer les propriétés de clic
- Connexion à experience.adobe.com à l’aide de vos informations d’identification Adobe ID.
- Accédez à Collecte de données > Balises.
- Sélectionnez la propriété de balise de votre choix.
- Accédez à Extensions, puis cliquez sur Configurer sur le SDK Web Adobe Experience Platform carte.
- Faites défiler l’écran vers le bas jusqu’à Collecte de données , puis cochez la case Activer la collecte de données de clic.
- Sélectionnez les paramètres de collection de clics souhaités.
- Cliquez sur Enregistrer, puis publiez vos modifications.
La variable Filtrer les propriétés de clic callback ouvre un éditeur de code personnalisé qui vous permet d’insérer le code souhaité. Dans l’éditeur de code, vous avez accès aux variables suivantes :
content.clickedElement: élément DOM sur lequel l’utilisateur a cliqué.content.pageName: nom de la page lorsque le clic s’est produit.content.linkName: nom du lien cliqué.content.linkRegion: région du lien sur lequel l’utilisateur a cliqué.content.linkType: type de lien (sortie, téléchargement ou autre).content.linkURL: URL de destination du lien cliqué.return true: quittez immédiatement le rappel avec les valeurs de variable actuelles.return false: quittez immédiatement le rappel et abandonnez la collecte des données.
Toute variable définie en dehors de content peuvent être utilisées, mais ne sont pas incluses dans la payload envoyée à Adobe.
Cliquez sur Paramètres de collection à l’aide de la bibliothèque JavaScript SDK Web
Définissez les variables de votre choix dans le clickCollection lors de l’exécution de l’objet configure . Si elle n’est pas définie, les paramètres par défaut de cet objet dépendent de la valeur de clickCollectionEnabled.
internalLinkEnabled: correspond àclickCollectionEnableddownloadLinkEnabled: correspond àclickCollectionEnabledexternalLinkEnabled: correspond àclickCollectionEnabledeventGroupingEnabled: la valeur par défaut estfalse; doit être explicitement activé.sessionStorageEnabled: la valeur par défaut estfalse; doit être explicitement activé.filterClickDetails: ne contient pas de fonction ; doit être explicitement enregistré.
eventGroupingEnabled, car cela permet de réduire le nombre d’événements qui sont pris en compte dans l’utilisation contractuelle.alloy("configure", {
edgeConfigId: "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";
}
}
}
});