Envoyer des dynamic vars

Les dynamic vars sont des informations additionnelles sur la session qui peuvent être utilisées pour segmenter les utilisateurs.

Elles peuvent, par exemple, contenir des informations sur la variation d’A/B Test affichée à l’utilisateur.

Contrairement aux custom vars, les dynamic vars peuvent être envoyées à n’importe quel moment au cours de la session et ne nécessitent pas l’envoi d’une pageview.

Il est possible d’enregistrer jusqu’à 40 dynamic vars sur la même page. Si le serveur reçoit plus de dynamic vars, seules les 40 premières clés distinctes sont conservées.

Si vous associez plusieurs variables dynamiques à une même clé par pageview, seule la dernière valeur est conservée.

Chaque dynamic var étant composé d’une paire clé (512 caractères max.) et valeur (une chaîne de caractères de 255 caractères max ou un entier entre 0 et 4294967296). La clé et la valeur sont tronquées par le Tracking Tag avant l’envoi.

Définir les dynamic vars (trackDynamicVariable)

Section titled Définir les dynamic vars (trackDynamicVariable)

Pour définir une dynamic var qui sera aussitôt envoyée, utilisez la commande trackDynamicVariable :

<script type="text/javascript">
window._uxa = window._uxa || [];
window._uxa.push(["trackDynamicVariable", {key: my_key, value: my_value}]);
</script>

La valeur peut être soit un nombre (type number) soit une chaîne de caractères (type string) - chacune apporte différentes possibilités dans la solution Contentsquare:

  • Pour les nombres, des opérateurs de nombre seront disponibles (supérieur, inférieur, etc.)
  • Pour les chaînes de caractères, l’auto-complétion et les expressions régulières seront proposées.

Vérifier l’envoi de dynamic vars

Section titled Vérifier l’envoi de dynamic vars

L’extension Chrome Contentsquare Tracking Setup Assistant affiche chaque dynamic var envoyée.

Si vous ne pouvez pas utiliser notre extension Chrome, utilisez le cookie _cs_debug.

  1. Depuis la console de votre navigateur, exécutez ce script pour créer le cookie :

    document.cookie = "_cs_debug=compressionDisabled"
  2. Recharger la page.

  3. Dans l’onglet Réseau, cherchez dvar, sélectionnez la requête, et vérifiez la valeur du paramètre dv.

Pour vérifier l’envoi de chaque paquet de dynamic vars (plusieurs dynamic vars créées en même temps seront regroupées dans un même paquet), suivez la requête GET nvoyée à //c.contentsquare.net/dvar, avec ces paramètres :

NameDescriptionType
dvDynamic var (compressée)String
pidProject IDInteger
rUn chiffre aléatoire pour éviter la mise en cache de la requêteInteger
uuIdentifiant utilisateur uniqueString
pnNuméro de la page (chaque pageview incrémente de 1)Integer
snNuméro de sessionInteger