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 des doutes sur une information, veuillez vous référer à la version anglaise.
Le modèle de Variable Personnalisée (CVar) vous permet de collecter des informations supplémentaires sur la page, l'utilisateur ou la session de vos visiteurs.
Ces instructions doivent être utilisées en complément de l'article sur le Configurateur de Tag Contentsquare, qui comprend des détails sur les prérequis et la création de Snippet.
Utilisé couramment pour
- Créer des mappages, au lieu de se fier aux URL (surtout si votre site Web inclut un dataLayer ou un autre objet global avec cette information)
Comment l'utiliser
Remarque
Actuellement, ce modèle ne doit pas être utilisé sur une application à page unique ou des pop-ups modaux où des vues de page artificielles sont déclenchées.
Une fois que vous avez créé votre Snippet, utilisez les étapes ci-dessous pour configurer ce modèle sélectionné et le déclencheur choisi.
Étape 1 : Complétez les champs suivants
- Contexte Itérable (optionnel) : Utilisé pour itérer à travers les tableaux dataLayer, par exemple, si vous devez accéder à une valeur de dataLayer[i].event. Cela peut être laissé vide si non applicable.
- Numéro d'index : Un nombre de 1 à 20. Assurez-vous d'assigner un index qui n'est pas déjà utilisé par d'autres CVAR sur votre site Web.
- Clé : la valeur clé
- Valeur : La valeur. Cela peut être une chaîne fixe ou une valeur d'un dataLayer, par exemple.
-
Portée : Sélectionnez parmi la portée suivante
- nextPageOnly (la valeur persiste jusqu'à la prochaine vue de page (sauf si écrasée). Le paramètre par défaut et recommandé.
- Page (la valeur persiste jusqu'au prochain rechargement de page (sauf si écrasée)).
- Visite (la valeur persiste pendant toute la session (sauf si écrasée)).
Définir un CVar
Si la valeur que vous souhaitez collecter en tant que CVar se trouve dans un objet global (comme un dataLayer), vous avez deux options :
- Si la valeur se trouve toujours à un emplacement fixe dans l'objet global, il vous suffit de la passer dans le champ de valeur tel quel, en utilisant l'interpolation. Par exemple : ${window.utag.data.pageName}
- Cependant, si l'emplacement de la valeur dans l'objet n'est pas fixe, vous devrez également remplir le champ contexte itérable.
Par exemple, si vous souhaitez récupérer le pageName du data layer, définissez les champs ci-dessous comme suit :- Contexte itérable : values(window.dataLayer)[?pageName]
- Index : choisissez un nombre entre 1 et 20
- Clé : Page Name
- Valeur : ${.pageName}
Pour plus de détails sur la définition des CVARS, visitez notre documentation technique.
Étape 2 : Sélectionnez un Déclencheur
Sélectionnez un déclencheur et définissez les conditions qui déclencheront le Snippet.
Déclencheurs disponibles