Comment utiliser le Configurateur de balises Contentsquare (CSTC)

Le Configurateur de Tag Contentsquare (CSTC) est un outil de gestion de vos fonctionnalités liées aux Tags, vous fournissant des extraits de code personnalisables, afin que vous puissiez adapter le suivi à vos besoins.

Vous, ou votre équipe impliquée dans la mise en œuvre de Contentsquare, utiliserez généralement le CSTC lors de la mise en œuvre initiale et par la suite pour effectuer des mises à jour à mesure que les besoins de votre entreprise évoluent.

Aller à la section

• Cas d'utilisation
• Bon à savoir
• Comment ça fonctionne
  • Extraits, modèles et déclencheurs
  • Utilisation de la syntaxe : interpolation, contexte itérable, entrées de sélecteur CSS
• Comment créer, gérer et déployer des extraits
• FAQs

Cas d'utilisation

• Masquage des données personnelles : masquer et démasquer sélectivement certains éléments de page dans la Relecture de Session pour améliorer votre expérience de relecture, en veillant à ne masquer que ce qui est nécessaire.
• Vues de page artificielles : envoyer et suivre des « vues de page » supplémentaires dans les cas où l'interaction d'un utilisateur avec une page ne l'enregistre pas comme une autre vue de page unique (par exemple, pop-up, SPA, etc.).
• Erreurs personnalisées : collecter les erreurs rencontrées par vos visiteurs, telles que les messages de validation de formulaire ou les avertissements de produit indisponible (avec jusqu'à 5 paires clé/valeur pour catégoriser les erreurs).
• Variable personnalisée (CVAR) : collecter des informations supplémentaires sur la page, l'utilisateur ou la session, envoyées dans les vues de page.
• Variable dynamique (DVAR) : collecter des informations supplémentaires au niveau de la session qui peuvent être utilisées pour la segmentation.
• Événement de page : collecter des informations supplémentaires au niveau de la session qui peuvent être utilisées pour la segmentation.
• Requêtes réseau - Masquer les URL : enregistrer des modèles pour masquer les URL collectées pour les erreurs API et les détails réseau.

Vous trouverez ci-dessous des modèles spécifiques listés et liés, disponibles pour chacun des cas d'utilisation.

Bon à savoir

Propriété du CSTC

Vous devez identifier le ou les membres de l'équipe appropriés pour mettre à jour et gérer le CSTC, car des connaissances techniques sont requises. Notez que le CSTC ne peut être accessible et géré que par des utilisateurs ayant des autorisations d'administrateur de console.

CSTC et autres gestionnaires de Tags tiers

Il est important de revoir et de suivre vos configurations lorsque vous utilisez plusieurs plateformes de tagging pour éviter les conflits.

SRI et projets Contentsquare auto-hébergés

Après avoir apporté des modifications aux extraits CSTC et publié, vous devrez :

• SRI : générer manuellement un nouvel instantané

• Auto-hébergement : récupérer le nouveau Tag

Comment ça fonctionne

Extraits, modèles et déclencheurs

Le CSTC utilise des extraits qui exécutent une commande de Tag. Vous créez et configurez des extraits individuels en utilisant deux composants : un modèle et un déclencheur.

• Étape 1 - Créer un extrait : Exécute la commande de Tag
  • Étape 2 - Sélectionner et configurer le modèle : L'action qui sera effectuée
  • Étape 3 - Sélectionner et configurer un déclencheur : L'événement qui exécutera l'action

Utilisation de la syntaxe : entrées de sélecteur CSS, interpolation et contexte itérable

Vous pouvez utiliser les conseils suivants pour vous aider à configurer les champs d'entrée disponibles pour différents modèles et déclencheurs.

Entrées de sélecteur CSS

Dans certains modèles de CSTC, tels que le Masquage d'Éléments, nous utilisons des sélecteurs CSS pour cibler des éléments spécifiques.

Les extraits qui s'appuient sur des sélecteurs CSS (y compris dans leurs déclencheurs) prennent en charge une syntaxe similaire à celle de votre navigateur lors de l'utilisation de la méthode document.querySelectorAll.

Utilisation de contenu dynamique avec interpolation

Pour tirer parti à la fois des textes simples à envoyer en tant que valeurs, ainsi que du contenu dynamique récupéré d'un dataLayer (par exemple), CSTC utilise un mécanisme appelé interpolation.

Contexte itérable

Il permet de récupérer des valeurs à partir de tableaux, tels que des variables Javascript. Le contexte itérable doit être utilisé lorsque la position de la valeur que vous souhaitez récupérer d'un tableau n'est pas connue.

Il peut vous aider à filtrer des valeurs d'un tableau pour extraire la charge utile utile et ensuite les utiliser dans vos modèles.

values(window.example)[?key] | [1:2]

NomÉvénement

Valeur : ${$.value}

values(window.example)

[
 { key: un, value: 5 }, 
 { value: 4}, 
 { key: deux, value: 3}
]

[?key]

[
 { key: un, value: 5 }, 
 { key: deux, value: 3}
]

[1:2]

[
 { key: deux, value: 3}
]

values(window.dataLayer)[?google_tag_params]

values(window.dataLayer)[?google_tag_params] | [1:2]

${$.google_tag_params.make}

Retourner en haut

Comment créer, gérer et déployer des Snippets

Tout d'abord, vous devez naviguer vers le Configurateur de Tag en cliquant sur votre icône de profil (en haut à droite), puis sur 'Configurateur de Tag'.

Le flux de travail pour créer et gérer des Snippets dans le CSTC est le suivant :

Étape 1 : Créer (ou modifier) un Snippet

1. Sélectionnez ‘+ Nouveau snippet’.

2. Donnez un nom à votre snippet (quelque chose de descriptif qui vous indique ce qu'il fait).

3. Sélectionnez votre modèle choisi.

4. Sélectionnez l'un des déclencheurs disponibles (les déclencheurs diffèrent selon le modèle).

5. Cliquez sur ‘Enregistrer’.

Étape 2 : Déployer vos Snippets

Pour déployer votre/vos Snippet/s, vous devrez publier la nouvelle version du Tag, y compris tous les changements apportés aux Snippets nouveaux ou existants.

1. Vérifiez et mettez à jour le ‘statut de publication’ de vos Snippets si nécessaire.

• ‘Activé’ : Ceux-ci seront déployés sur le Tag lors de la publication. Les Snippets nouvellement créés sont définis sur ‘Activé’ par défaut.
• ‘Désactivé’ : Ceux-ci seront désactivés du Tag lors de la publication.

2. Cliquez sur le bouton ‘Publier [x] changement(s)’. Pour approuver et publier vos changements, un e-mail sera envoyé à votre adresse e-mail enregistrée contenant un code à quatre chiffres.

3. Dans la nouvelle fenêtre qui apparaît, entrez le code que vous avez reçu par e-mail pour approuver les changements.

4. Cliquez sur ‘Publier tous les snippets’ et le nouveau Tag sera déployé, y compris tous vos Snippets et tous les changements effectués.

Étape 3 : Tester votre implémentation

1. Téléchargez l’extension Contentsquare Tracking Setup Assistant pour Chrome. 

2. Laissez passer 5 minutes, videz le cache de votre navigateur et ouvrez (ou rechargez) la page où votre snippet nouvellement créé est censé se déclencher.

3. Allez sur votre site web (ou la page spécifique de votre site web) où le snippet publié est censé se déclencher et effectuez l'action sur laquelle votre snippet publié est censé se déclencher.

4. Cliquez pour ouvrir l'extension Contentsquare Tracking Setup Assistant et vérifiez sous la dernière section "Nouvelle vue de page envoyée" si votre Variable Personnalisée/Dynamique ou Événement de Page a été collecté avec succès.

Notez que le masquage/démasquage des snippets doit être vérifié à l'intérieur de la plateforme Contentsquare elle-même.

Activer/Désactiver les Snippets

Vous pouvez activer et désactiver les Snippets en utilisant les interrupteurs sous le statut de publication :

‘Activé’ : pour activer un snippet.

‘Désactivé’ : pour désactiver un extrait. Utilisez ceci si vous souhaitez désactiver temporairement un extrait sans le supprimer complètement du projet (ce qui nécessiterait de supprimer un extrait).

Vous devrez toujours publier les modifications pour les déployer sur le Tag.

Supprimer un extrait

Important : Vous devez faire preuve de prudence avant de supprimer des extraits, en particulier ceux liés au masquage, pour valider l'impact de cette action (comme l'exposition de données personnelles dans le cas du masquage).

Pour supprimer définitivement un extrait et l'enlever du CSTC (y compris votre projet Contentsquare), cliquez sur le menu à trois points à côté d'un extrait et cliquez sur ‘Supprimer’. Notez que cela ne peut pas être annulé.

FAQs

Retour en haut