Skip to main content

​
Liste de vérification

Utilisez cette liste après l’installation du snippet pour confirmer que tout fonctionne :

​
1. Vérifier la requête réseau

  1. Ouvrez votre site dans Chrome ou Firefox
  2. Ouvrez les DevTools (F12 ou clic droit → Inspecter)
  3. Allez à l’onglet Network
  4. Filtrez sur /ct
  5. Rechargez en forçant le cache (Ctrl+Maj+R / Cmd+Maj+R)
Vous devriez voir une requête POST vers https://t.scanova.io/ct avec le statut 200.

​
2. Inspecter le payload de la requête

Cliquez sur la requête /ct → onglet Payload. Vérifiez que :
  • site_id correspond à l’ID de votre site de suivi dans le tableau de bord
  • event_type vaut pageview (si autoPageview: true)
  • scan_session_id est présent (si vous êtes arrivé avec un paramètre ?scnv=)
Exemple de payload correct :

​
3. Tester l’attribution QR

Visitez votre page avec un paramètre ?scnv= pour simuler un scan :
Vérifiez le payload : scan_session_id doit correspondre à la valeur utilisée.

​
4. Activer temporairement le mode debug

Ajoutez debug: true à votre appel init et rechargez. Le SDK affiche toute son activité dans la console :
La sortie console devrait afficher :
Retirez debug: true avant tout déploiement en production.

​
Erreurs fréquentes et correctifs

​
Aucune requête /ct n’apparaît

​
400 — Requête invalide

Le site_id est invalide, vide, ou appartient à un site inactif. Vérifiez que :
  • Vous utilisez le site_id du bon site de suivi dans le tableau de bord
  • Le site est actif (vérifiez son statut dans le tableau de bord)

​
403 — Domaine non autorisé

Le domaine de votre site ne figure pas dans la liste Allowed Domains de ce site de suivi.
  1. Ouvrez Analyses → Suivi des conversions
  2. Sélectionnez votre site → cliquez sur Edit
  3. Ajoutez le nom d’hôte exact (par exemple yoursite.com, www.yoursite.com, staging.yoursite.com)
  4. Enregistrez
La vérification du domaine s’appuie sur l’en-tête Origin ou Referer de la requête. Ajoutez exactement le nom d’hôte affiché dans la barre d’adresse : inclure ou non www change tout.

​
422 — Erreur de validation

Le payload de l’événement n’a pas passé la validation. Causes fréquentes :
  • event_type est absent ou vide
  • Un champ dépasse la longueur autorisée
  • metadata contient une adresse e-mail en clair : utilisez user_identifiers avec une valeur hachée
  • metadata dépasse 10 Ko

​
429 — Limite de débit dépassée

Votre site envoie des événements plus vite que la limite autorisée (100 événements/min par IP pour les événements navigateur). C’est rare en usage normal. Si cela survient en test, espacez vos événements.

​
Les événements apparaissent dans le réseau mais pas dans le tableau de bord

  • Patientez jusqu’à 60 secondes : il y a un court délai de traitement
  • Vérifiez que vous consultez le bon site de suivi dans le tableau de bord
  • Vérifiez que le site_id du payload correspond au site du tableau de bord

​
Aucune requête /ct pour une visite donnée

Si une visite ne génère aucune requête, la personne est très probablement arrivée sans scan de QR Code : le paramètre ?scnv= est absent. Sans scan_session_id, le SDK n’envoie aucun événement. C’est le comportement attendu : le SDK ne suit que le trafic issu d’un scan.

​
Deux événements par chargement de page

Vous avez à la fois autoPageview: true et un appel manuel scanova('track', 'page_view', ...). Supprimez-en un. Voir Événements automatiques pour le détail.