clickCollection
L’objet 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.
clickCollectionEnabled doit être activé.
Elle est prise en charge sur le SDK Web 2.25.0 ou version ultérieure.
Les variables suivantes sont disponibles dans l’objet clickCollection :
-
clickCollection.internalLinkEnabled: valeur booléenne qui détermine si les liens du domaine actuel sont automatiquement suivis. Par exemple,https://example.com/index.htmlàhttps://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 propriétédownloadLinkQualifier. -
clickCollection.externalLinkEnabled: valeur booléenne qui détermine si les liens vers des domaines externes sont automatiquement suivis. Par exemple,https://example.comàhttps://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. SiinternalLinkEnabledest désactivé, 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. SiinternalLinkEnabledoueventGroupingEnabledsont désactivés, cette variable ne fait rien.Adobe recommande vivement d’activer cette variable lors de l’utilisation de
eventGroupingEnableden dehors des applications d’une seule page. SieventGroupingEnabledest activé alors quesessionStorageEnabledest désactivé, 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. Comme les applications d’une seule page ne naviguent généralement pas vers une nouvelle page, le stockage de session n’est pas nécessaire pour SPA pages. -
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 l’une des options suivantes lors de la configuration de l’extension de balise :
-
Collecter les liens internes
-
Options de regroupement d’événements :
- Aucun regroupement d’événements
- Groupement d’événements à l’aide de l’enregistrement de session
- Groupement d’événements à l’aide d’un objet local
-
-
Collecter des liens externes
-
Collect download links
-
Propriétés de clic du filtre
- Connectez-vous à 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 la carte SDK Web Adobe Experience Platform.
- Faites défiler l’écran jusqu’à la section Collecte de données, puis sélectionnez les paramètres de collecte de clics de votre choix.
- Cliquez sur Enregistrer, puis publiez vos modifications.
Le rappel Propriétés de clic de filtre 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 de données.
Toutes les variables définies 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 souhaitées dans l’objet clickCollection lors de l’exécution de la commande 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éesessionStorageEnabled: la valeur par défaut estfalse; doit être explicitement activéefilterClickDetails: ne contient pas de fonction ; doit être explicitement enregistré
eventGroupingEnabled lorsque internalLinkEnabled est activé, car cela réduit le nombre d’événements qui sont pris en compte dans l’utilisation contractuelle.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";
}
}
}
});