Envoyer des custom vars

Les custom vars sont des informations supplémentaires sur la page, l’utilisateur ou la session qui sont transmises au sein des pageviews.

Elles contiennent généralement des informations issues du datalayer, par exemple :

• le type de page,
• la catégorie du produit,
• le statut connecté ou non de l’utilisateur,
• le nombre d’articles dans le panier.

Ces informations permettent par exemple de segmenter les visiteurs ou de faire des regroupements de page, là où l’URL ne suffirait pas.

Chaque custom var est composé d’une clé (max 512 caractères) et d’une valeur (max 255 caractères).

Vous êtes limités à 20 custom vars par projet.
Vous pouvez mettre à jour jusqu’à 20 custom vars par page.

Chaque custom var porte un indice unique, strictement compris entre 1 et 20. Les custom vars avec des indexes en dehors de cette plage ne sont pas envoyées. Les indices sont disponibles pour les utilisateurs dans Contentsquare.

Utilisez un indice cohérent au sein d’un même projet - par exemple, si le “template de page” est enregistré sur l’indice 3, utilisez cet indice 3 sur toutes les pages du site.

Sauvegarder une custom var crée un cookie qui contient cette information sous forme de chaîne JSON. et dont la valeur est encodée en URI. Cette chaîne peut contenir tous les caractères autorisés dans une URI ↗.

Pour définir une custom var, utiliser la commande setCustomVariable :

<script type="text/javascript">
  window._uxa = window._uxa || [];
  window._uxa.push(["setCustomVariable", num, clé, valeur, scope]);
</script>

avec :

• index entier > 0 et <= 20
• name chaîne de caractères de 512 caractères max (le Tag tronque les caractères supplémentaires)
• value chaîne de caractères de 512 caractères max (le Tag tronque les caractères supplémentaires)
• scope (optionnel) définit le scope de la custom var et son comportement :
  • Pas de scope spécifié (défaut):
    • Scopes visit et page.
  • 2 ou visit:
    • Scope visit.
  • 3 ou page:
    • Scope page.
    • Supprimée après un pageview naturel.
  • 4 ou nextPageOnly:
    • Scope nextPageOnly.
    • Supprimée après un pageview naturel ou un pageview artificiel au prochain appel de la commande trackPageview.

Une fois définies, les custom vars sont automatiquement envoyées avec le pageview suivant (naturel ou artificiel).

Définir une custom var avec un index existant écrase les name et value définis.

Définir une custom var dans le scope visit, avec l’indice 5, le nom cname et la valeur cvalue.

<script type="text/javascript">
  window._uxa.push(["setCustomVariable", 5, "cname", "cvalue", 2]);
</script>

Définir une custom var dans les scopes visit et page, avec l’indice 6, le nom cname et la valeur cvalue.

<script type="text/javascript">
  window._uxa.push(["setCustomVariable", 6, "cname", "cvalue"]);
</script>

Définir une custom var avec le scope nextPageOnly.

<script type="text/javascript">
  // version courte
  window._uxa.push(["setCustomVariable", 6, "cname", "cvalue", 4]);
  // version longue
  window._uxa.push(["setCustomVariable", 6, "cname", "cvalue", "nextPageOnly"]);
</script>

• Une custom var peut être supprimée en passant une valeur vide au paramètre scope. L’indice à utiliser doit être celui de la custom var à supprimer.
• Les custom vars avec le scope nextPageOnly sont automatiquement supprimées à l’envoi du prochain pageview natural ou artificiel.

Supprimer la custom var avec le nom cname.

<script type="text/javascript">
  window._uxa.push(["setCustomVariable", 5, "cname", ""]);
</script>

Supprimer la custom var avec le nom cname du scope visit.

<script type="text/javascript">
  window._uxa.push(["setCustomVariable", 6, "cname", "", 2]);
</script>

Supprimer la custom var avec le nom cname des scopes visit et page, en passant une valeur vide.

<script type="text/javascript">
  window._uxa.push(["setCustomVariable", 6, "cname", ""]);
</script>

Pour vérifier que les custom vars partent bien, il faut regarder le paramètre cvarp du pageview correspondant (ou bien consulter l’extension Chrome).

En savoir plus sur les pageviews