Pour un premier diagnostic, suivez d’abord Vérifier l’installation.

​
Aucune donnée dans le dashboard

  • Les événements partent par lots : attendez 5 secondes ou changez d’onglet.
  • La clé est vide : avec un provider conditionnel, le SDK n’est pas chargé. Vérifiez la variable d’environnement dans le build déployé.
  • Après une modification du .env, le serveur de dev n’a pas été redémarré. Next.js et Vite intègrent les variables au démarrage.
La clé est invalide ou a été régénérée. Copiez la clé actuelle depuis Paramètres → Clés API. Le SDK conserve les événements : ils partiront au prochain chargement avec la bonne clé.
  • Vérifiez l’environnement sélectionné en haut du dashboard : il doit correspondre au préfixe de la clé (jch_sb_, jch_st_, jch_pr_).
  • Si la réponse contient "accepted": 0 pour de nouveaux événements, le quota mensuel est atteint : voir Paramètres → Usage.
  • Élargissez la période affichée.
L’API hébergée accepte toutes les origines. Une erreur CORS signifie presque toujours que endpoint pointe vers une mauvaise URL ou un proxy. Retirez l’option endpoint. Pour une API locale, vérifiez qu’elle est démarrée.

​
Données incorrectes

  • Plusieurs instances du SDK sont créées : un AnalyticsProvider monté à plusieurs endroits, ou createAnalytics() appelé dans un composant. Gardez une seule instance.
  • Vous appelez page() ou usePageviewTracker() alors que le provider suit déjà la navigation. Retirez ces appels.
L’identité est stockée dans le localStorage. Effacez analytics_user_id et analytics_user_traits, puis recréez l’instance. Voir Déconnexion.
L’élément n’est ni un lien, ni un bouton, ni un champ. Ajoutez role="button" ou data-track sur l’élément, ou utilisez un vrai <button>.
Votre poste local utilise la clé de production. Utilisez la clé Bac à sable en local. Voir Environnements.

​
Écrans vides

​
La heatmap n’a pas de capture d’écran

Les clics s’affichent sur un fond vide ou un message d’état apparaît.
  1. L’URL du site est renseignée et correspond au domaine visité.
  2. La page est publique : pas de connexion, de 401/403 ou de mur de cookies.
  3. Cliquez sur Recapturer cette page.
Voir Heatmaps.

​
Contacter le support

Joignez à votre message :
  • l’URL de la page concernée ;
  • la valeur de l’en-tête X-Request-Id d’une requête en erreur ;
  • la version du SDK (properties.sdk.version dans un événement).