Installer le tracker

Options du tracker

Toutes les options de window.TrackerConfig.

Le tracker se configure avec l'objet window.TrackerConfig, défini avant le chargement du script.

html
<script>
  window.TrackerConfig = {
    token: "VOTRE_CODE_DE_SUIVI",
    debug: false,
  };
</script>

#Options

Option Type Par défaut Rôle
token texte — Obligatoire. Le code de suivi du site, visible sur sa carte dans le dashboard.
debug booléen false Écrit dans la console du navigateur ce que fait le tracker. À couper en production.
apiBase URL domaine du script L'adresse de l'API sessio. Par défaut, celle d'où le script a été chargé.
canvasFps nombre 4 Photos de chaque <canvas> par seconde, si le site enregistre ses canvas (voir Jeux et canvas).
canvasQuality nombre 0.6 Qualité WebP de ces photos, de 0 à 1.
rrwebUrl URL apiBase + /assets/sio-r.js Pour servir la librairie d'enregistrement depuis votre propre CDN.
autoIdentify booléen true Reconnaît l'utilisateur connecté dans le stockage du navigateur et les cookies, et l'identifie par son email ou son nom. false la coupe. Voir Identification automatique.
visitorToken texte — Impose l'identifiant du visiteur, par exemple pour retrouver un même utilisateur sur plusieurs appareils.

#Identifier un visiteur

Sessio attribue à chaque navigateur un identifiant anonyme, gardé dans un cookie et dans le stockage local. Si le navigateur refuse tout stockage, le serveur en calcule un, stable pour la journée.

Pour relier les visites à vos propres comptes, passez votre identifiant interne dans visitorToken. Il doit faire 8 à 40 caractères, en minuscules et chiffres uniquement ([0-9a-z]) : un identifiant d'une autre forme est ignoré et le visiteur reçoit un identifiant anonyme.

Attention

N'y mettez jamais un email ou un nom : l'identifiant est visible dans le dashboard. Un hachage de votre identifiant interne convient.