Référence

Dépannage

Les causes les plus fréquentes quand une visite n'apparaît pas, ou apparaît incomplète.

#Activer le mode debug

js
window.TrackerConfig = { token: 'VOTRE_CODE', debug: true };

Le tracker écrit alors dans la console du navigateur chaque étape : chargement, ouverture de la page, envois.

#Aucune visite n'apparaît

Cause Solution
Token de suivi invalide Vérifiez le code dans TrackerConfig, et que le site est actif.
Domaine non autorisé pour ce site Le domaine de la page doit être celui du site, ou l'un de ses sous-domaines.
Navigateur automatisé Les robots et navigateurs pilotés ne sont pas enregistrés. Testez dans un navigateur normal.
Bloqueur de publicité Certains bloquent les scripts d'analytics. Servez l'API depuis un sous-domaine à vous.
CSP Autorisez le domaine de l'API dans script-src et connect-src. Voir Installer le tracker.

#Le replay est vide ou incomplet

  • Visite très courte : une page quittée avant la première réponse du serveur ne peut rien enregistrer.
  • Contenu dans un cadre : les iframe d'un autre domaine ne sont pas enregistrées.
  • Canvas et vidéos : leur contenu n'est pas enregistré, seul leur emplacement l'est.

#Les requêtes n'ont pas de payload

Symptôme Cause
Méthode — et mention « Partie avant le chargement du tracker » Le snippet est en async ou placé après vos scripts. Mettez-le en premier dans <head>, sans async.
Ni en-têtes ni corps, sur toutes les requêtes Contenu des requêtes est désactivé pour le site.
Corps marqué « coupé » Il dépasse 100 Ko, ou la page a dépassé 4 Mo de contenu.