Ajouter le traqueur
Installez la balise script de votre site et vérifiez que les événements arrivent. Examinez vos obligations de consentement avant d'activer la collecte.
1. Copiez votre extrait
Connectez-vous, ouvrez votre site web et allez dans Settings → Installation → Scripts (Paramètres → Installation → Scripts). Votre extrait ressemble à ceci, avec votre propre jeton de site. Le style Minimal montré ici lit ses options depuis Installation → Dashboard (Tableau de bord) ; le style Explicit (Explicite) écrit les mêmes options comme attributs du script (voir Options du script).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Gardez les adresses du script et de l’API sur https://app.seean.io, comme ci-dessus, sauf si la collecte first-party est activée dans Installation ; le nom d’hôte généré <slug>-collect.seean.io — ou un domaine de collecte personnalisé actif qui vous appartient — est alors utilisé pour les deux. Un extrait existant utilisant ces adresses n’a pas besoin de changer lorsque Seean met à jour son infrastructure.
2. Collez-le avant </head>
Utilisez le document HTML commun ou le layout racine pour chaque page que vous voulez mesurer. Suivez votre guide de plateforme pour le bon emplacement. Installez le traqueur une seule fois : utiliser à la fois un layout et un gestionnaire de balises peut compter les visites deux fois.
Le traqueur observe les navigations prises en charge de l’API History, par exemple / → /pricing. Les chaînes de requête ne font pas partie du chemin de page ; les fragments sont ignorés sauf si vous définissez data-hash="true". Une campagne balisée différente ou une session expirée peut tout de même démarrer une nouvelle session et compter de nouveau le même chemin. Chargez le traqueur comme un script externe classique ; ne l’importez pas dans le bundle de votre application et n’ajoutez pas type="module".
3. Vérifiez
Ouvrez le site publié dans un onglet de navigateur normal, puis consultez Settings → Installation → Setup health (État de l’installation) pour le site web correspondant. Last pageview received (Dernière page vue reçue) affiche l’heure de la dernière page vue conservée ; avant toute page vue, Installation verified (Installation vérifiée) indique quand la page publiée a réussi la vérification pour la dernière fois. Utilisez Check installation (Vérifier l’installation) pour inspecter la page d’accueil publiée à la recherche du traqueur, du jeton et de la politique de sécurité. Seean vérifie aussi automatiquement la page d’accueil publiée en arrière-plan (chaque minute le premier jour du site web) ; l’installation est donc vérifiée dès que l’extrait est publié, même lorsque le tableau de bord est fermé. La bannière de la vue d’ensemble disparaît alors sans attendre une visite.
Une référence dans la source ou une ancienne visite ne prouve pas que votre dernier déploiement fonctionne. Faites correspondre un nouveau chemin de page et une heure dans Événements à l’aide des vérifications d’installation. Le guide de diagnostic de la configuration explique les résultats, les permissions et les limites.
Options du script
Installation → Dashboard contient les options de suivi du site web : campagnes UTM (activé), chemins de page avec fragment (désactivé), Web Vitals (activé), conversions automatiques (activé pour les sites web nouveaux et jamais configurés), journal de débogage (désactivé) et noms d’hôte inter-domaines. Save tracking options (Enregistrer les options de suivi) les enregistre ; un extrait minimal les applique à son prochain chargement de page. Le style d’extrait Explicit écrit plutôt les mêmes choix comme attributs :
| Attribut | Par défaut | Effet |
|---|---|---|
data-conversions="true" |
désactivé en HTML brut | Charge une fois par document les préréglages de conversion automatiques activés. Les extraits explicites générés l’incluent tant que les conversions automatiques sont activées. |
data-hash="true" |
désactivé | Compte les changements de location.hash comme des pages vues et rapporte le chemin avec son fragment, par exemple /docs#install. |
data-utm="off" |
activé | Cesse de lire utm_source, utm_medium et utm_campaign ; un lien balisé ne démarre plus de nouvelle session. |
data-vitals="off" |
activé | Ignore entièrement la mesure des Web Vitals (aucun observateur de performance). |
data-debug="true" |
désactivé | console.debug de chaque charge utile avant envoi. Sans risque lorsque la console est indisponible. |
data-domains="a.com,b.com" |
désactivé | Transmission inter-domaines : les liens vers les hôtes listés (et leurs sous-domaines) portent l’identifiant du visiteur, et une page d’atterrissage adopte un identifiant entrant. |
Lorsque l’un de ces attributs est présent, les options du tableau de bord sont ignorées pour cette page. Détails et valeurs par défaut : Script et options de suivi.
Ce que le traqueur envoie
| Champ | Ce que c’est |
|---|---|
| path | le chemin de la page, sans chaîne de requête (avec le fragment lorsque data-hash est activé) |
| hostname | le site web mesuré |
| referrer | l’URL référente du navigateur ; le collecteur ne conserve que son nom d’hôte |
| timezone | repli pour le pays lorsque la bordure du réseau n’en signale aucun |
| visitorId, sessionId | les identités par défaut sont dérivées sur le serveur par site web et jour UTC ; la transmission inter-domaines facultative porte l’identité dans le stockage de session de la journée |
| campaign | source, support, campagne, terme et contenu UTM lorsqu’ils sont présents, sauf avec data-utm="off" |
| click id | le nom d’un paramètre d’identifiant de clic publicitaire présent sur l’URL d’atterrissage (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid) ; la valeur n’est jamais lue. Désactivé avec data-utm="off" |
| title | document.title, 200 premiers caractères |
| uid | votre propre identifiant utilisateur après seean.identify(id), stocké uniquement lorsque Identify users (Identifier les utilisateurs) est activé pour le site web |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP et TTFB ; des mesures ultérieures peuvent mettre à jour un échantillon. Désactivé avec data-vitals="off" |
Le collecteur lit le pays, la région et la ville dans les en-têtes de bordure réseau de la requête, utilise l’agent utilisateur pour les catégories de navigateur, de système d’exploitation et d’appareil, enregistre la première balise Accept-Language du navigateur comme langue du visiteur, et peut utiliser la région de cette langue comme repli pour le pays. L’adresse IP est comparée aux règles d’exclusion uniquement et n’est jamais stockée. Les chaînes de requête autres que les champs UTM et le nom de l’identifiant de clic ne sont jamais collectées.
Le suivi par défaut utilise une empreinte serveur quotidienne limitée au site web, sans cookies ni stockage de mesure persistant dans le navigateur. La transmission inter-domaines, en option, utilise sessionStorage pour la journée. La collecte s’arrête pour Do Not Track, Global Privacy Control ou la désactivation dans le navigateur décrite dans Exclusions. Lorsqu’un consentement ou une désactivation s’applique, contrôlez le chargement du script via le mécanisme de consentement de votre site. Voir confidentialité technique et stockage et consentement.
Développement local
Le traqueur ignore localhost et 127.0.0.1 sauf si vous ajoutez data-local à la balise script. Utilisez un site web/jeton Seean distinct pour le trafic de test et copiez l’adresse de l’API depuis l’extrait de ce site. Les navigateurs automatisés, Do Not Track, Global Privacy Control et la désactivation dans le navigateur peuvent toujours arrêter la collecte ; data-local ne désactive pas ces contrôles.
Retirer ou mettre à jour une installation
Retirez le script de son layout ou de son gestionnaire de balises et publiez la modification pour arrêter la collecte future depuis cette installation. Les rapports existants restent. Renouveler le jeton de suivi d’un site invalide immédiatement ses anciens extraits ; mettez à jour chaque installation avec le nouveau jeton. Voir paramètres du site web.
Quelque chose n'est pas clair ? Contacter le support.