Traduit de l’anglais à l’aide de l’IA
Veuillez noter que cet article a été traduit à l’aide de la technologie IA. Bien que nous travaillions à maintenir l’exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez un doute sur une information, veuillez vous référer à la version anglaise.
Le zoning relie chaque interaction à un élément de page en identifiant l’élément dans le HTML de votre site. Si
une mise à jour du site modifie cette structure HTML, les zones existantes peuvent ne plus correspondre aux mêmes éléments et afficher des données nulles ou inattendues.
Cet article explique comment attribuer un identifiant stable aux éléments importants de la page afin que vos données de zoning restent cohérentes lorsque votre site change.
Aucune des options présentées dans cet article n’est rétroactive. Chaque option commence à fonctionner à partir du jour de sa mise en ligne.
Avant de commencer
Décidez quels éléments vous souhaitez protéger. Commencez par les éléments que vos équipes analysent sur de longues périodes, tels que :
- Blocs fixes de la page d’accueil
- Entrées de menu
- Boutons de la page produit dont la position peut changer selon le stock ou le contenu
- Composants répétés, tels que les vignettes produit
Pour chaque bloc important, envisagez de protéger à la fois le bloc et son bouton principal. Protéger le bloc empêche les changements à l’extérieur d’affecter les éléments à l’intérieur. Protéger le bouton séparément empêche les changements à l’intérieur du bloc d’affecter le bouton.
Choisissez des valeurs d’identifiant qui :
- Utilisent uniquement des lettres, chiffres, tirets et underscores
- Sont uniques sur la page
- Restent identiques entre les versions
- N’incluent pas d’espaces, accents ou points
- N’incluent pas de noms de campagne ni de dates
Une valeur non valide ou dupliquée est ignorée. L’ID HTML existant de l’élément est également ignoré dans ce cas.
Options disponibles
Examinez les options ci-dessous et utilisez celle qui correspond à votre plan, configuration du site et exigences d’implémentation.
Option A : Utiliser un attribut ou une classe CSS
Disponible sur les offres Pro et Enterprise
Utilisez cette option lorsque votre site possède déjà un attribut ou une classe CSS qui reste stable entre les versions, comme un ID produit ou un nom de composant.
1. Vérifiez que l’identifiant est stable et unique
Confirmez que :
- L’attribut ou la classe reste identique
- La valeur apparaît une seule fois sur la page
- L’élément n’a pas de doublon temporaire, comme une version mobile et desktop affichées simultanément
Si la même valeur apparaît plusieurs fois, Contentsquare ne peut pas l’utiliser pour ces éléments. Il peut essayer ensuite une classe CSS unique, puis l’ID HTML de l’élément, et enfin utiliser la position de l’élément en dernier recours.
2. Ouvrez les paramètres de collecte de données
- Dans la Console, ouvrez les paramètres de collecte de données pour le zoning, CS Live et les Heatmaps.
- Dans Attributs uniques, ajoutez le nom de l’attribut. Saisissez uniquement le nom, pas une valeur. Par exemple, saisissez data-product-id.
- Dans Classes CSS uniques, ajoutez une classe qui apparaît une seule fois par page. Saisissez le nom de la classe sans le point. Par exemple, saisissez store-locator.
Lors de l’implémentation, votre Implementation Manager peut vous aider à configurer ce paramètre. Si vous identifiez un problème après l’implémentation, contactez le Support ou votre Technical Account Manager.
Ce paramètre s’applique à l’ensemble du site à partir du jour où il est enregistré. Chaque élément dont la valeur d’attribut ou la classe est unique sur la page reçoit un nouveau nom à ce moment-là, sauf s’il possède déjà un ID de remplacement.
Les éléments à l’intérieur d’un élément correspondant reçoivent également un nouveau nom, sauf s’ils ont déjà leur propre ID de remplacement, un attribut unique ou un ID HTML stable.
Option B : Ajouter un ID avec le configurateur de tag Contentsquare
Disponible sur les offres Pro et Enterprise
Utilisez cette option pour ajouter un ID stable sans changer le code de votre site.
Les extraits du configurateur de tag ne peuvent pas atteindre les éléments à l’intérieur des composants web qui utilisent le shadow DOM. Si l’élément que vous souhaitez protéger se trouve dans le shadow DOM, utilisez l’Option C : Ajouter un ID dans le code de votre site.
Créer un extrait
- Dans la Console, ouvrez le configurateur de tag Contentsquare.
- Créez un nouvel extrait.
- Nommez l’extrait d’après l’élément qu’il protège. Par exemple, Override ID – HP Enchanting Gift.
- Sélectionnez le template Element ID Override.
Sélectionner l’élément
Dans Sélecteur CSS, ciblez exactement un élément en utilisant un sélecteur peu susceptible de changer.
Vous pouvez cibler un élément en utilisant :
- Sa destination de lien, comme a[href*="store-locator"]
- Un aria-label
- Un attribut data qui reste stable entre les versions
Évitez les sélecteurs qui utilisent :
- Des positions telles que :nth-child
- Des noms de classes générés
- Des valeurs qui changent entre les versions
Si le sélecteur correspond à plusieurs éléments, l’extrait applique l’attribut uniquement au premier élément dans l’ordre DOM. Contentsquare n’affiche pas d’avertissement.
Saisir l’ID de remplacement
Dans Valeur d’attribut, saisissez la valeur d’ID stable que vous avez choisie.
Ne laissez pas ce champ vide. Une valeur vide fait que Contentsquare ignore l’ID HTML de l’élément, ce qui peut renommer l’élément et tout ce qu’il contient.
Utilisez uniquement des lettres, des chiffres, des tirets et des underscores. Assurez-vous que la valeur est unique sur la page.
Sélectionner le déclencheur
Sélectionnez Avant la page vue comme déclencheur.
- Activez les deux :
Pages vues naturelles
Pages vues artificielles
Les pages vues artificielles couvrent les changements de page qui ne rechargent pas la page.
Option C : Ajouter un ID dans le code de votre site
Disponible sur les offres Growth, Pro et Enterprise
Utilisez cette option lorsque vous souhaitez que l’identifiant soit intégré au composant et reste en place lors des futures versions.
Mettre en œuvre l’ID de remplacement dans le code de votre site
1. Ajoutez l’ID de remplacement au composant
Ajoutez l’attribut data-cs-override-id au template du composant.
Par exemple :
<section data-cs-override-id="hp-enchanting-gift">
Choisissez une valeur stable et unique sur la page.
2. Donnez des valeurs uniques aux composants répétés
Pour les composants répétés, construisez la valeur à partir d’une référence produit ou composant.
Par exemple :
<div data-cs-override-id="plp-tile-VCARA12345">
Cela fonctionne uniquement lorsque chaque produit apparaît une seule fois sur la page. Si le même produit apparaît plusieurs fois, la valeur résultante n’est pas unique et ne peut pas être utilisée de manière fiable.
3. Réutilisez les ID de remplacement existants lorsque c’est possible
Si un élément a déjà un ID attribué par un extrait du configurateur de tags, utilisez la même valeur et conservez le même type d’élément.
Cela permet à vos zones existantes de continuer à correspondre sans interruption supplémentaire lorsque le changement de code est mis en ligne. Après la mise en ligne, supprimez l’extrait du configurateur de tags.
Préparez-vous à une interruption dans vos données
La plupart des changements donnent à l’élément un nouveau nom dans Contentsquare à partir du jour où le changement est mis en ligne. Les zones créées avant ce changement peuvent cesser de correspondre.
Pour limiter l’Impact :
- Regroupez les changements d’identifiants liés dans la même version.
- Prenez de nouvelles captures d’écran après la mise en ligne.
- Redessinez vos zones sur les nouvelles captures d’écran.
- Commencez vos périodes d’analyse après le changement d’identifiant.
Testez l’implémentation
- Ouvrez la page en direct.
- Faites un clic droit sur l’élément et sélectionnez Inspecter.
- Vérifiez que l’élément a l’ID, l’attribut ou la classe CSS attendue.
- Dans le panneau Éléments, recherchez la valeur dans le HTML.
- Confirmez que la valeur apparaît exactement une fois.
Testez l’élément dans des états où des doublons peuvent apparaître temporairement, tels que :
- Diapositives clonées de carrousel
- Menus mobile et desktop affichés ensemble
- Modals
- Autres états temporaires de la page
Dans Contentsquare, prenez une nouvelle capture d’écran et confirmez que vos zones affichent des données.
Maintenez l’identifiant stable après chaque mise en ligne
Après chaque mise en ligne du site :
- Confirmez que l'identifiant est toujours présent.
- Confirmez qu'il n'apparaît toujours qu'une seule fois sur la page.
- Gardez le même type d'élément. Par exemple, changer un div en section peut faire en sorte que la zone ne corresponde plus.
- Revérifiez les extraits du configurateur de tag. Un changement de site peut invalider le sélecteur CSS sans afficher d'avertissement.
- Incluez les vérifications d'identifiant dans vos tests de release.