Dépannage

La plupart des problèmes tiennent à une poignée de causes. Commencez par Aucune donnée ne s'affiche, qui couvre aussi les pixels publicitaires manquants.

Aucune donnée ne s'affiche

Passez ces points en revue dans l'ordre. Chacun se vérifie rapidement.

1. Lisez la carte d'état de l'installation. Ouvrez Settings → Projects, dépliez votre site et regardez la carte du panneau Install snippet. « Waiting for data » signifie que rien n'est jamais arrivé. « Installed » avec un « Last data » ancien signifie que ça a fonctionné une fois, puis que ça s'est arrêté. Cliquez sur Check again après avoir visité votre site.

2. Le tracker est-il sur la page ? Affichez le code source de votre page et cherchez le script t.js, avec data-key="pk_…". Il doit figurer sur chaque page que vous voulez suivre, dans le <head>. Avec le package npm, vérifiez que le provider enveloppe toute votre application, et ajoutez debug: true à sa configuration pour voir les messages [klickbee] dans la console du navigateur (la balise script n'a pas d'option de debug).

3. La clé est-elle correcte ? Le data-key (ou projectKey) doit être exactement la clé affichée sous Settings → Projects. Une faute de frappe, une clé copiée depuis un autre site, ou une clé renouvelée depuis votre installation sont les causes habituelles. Si vous avez renouvelé la clé, l'ancienne a cessé de fonctionner immédiatement.

4. Les origines autorisées sont-elles correctes ? Si Allowed origins n'est pas vide, les événements ne sont acceptés que depuis ces origines exactes. Vérifiez le schéma, l'hôte et le port : example.com et www.example.com sont des origines différentes, tout comme http et https. Les domaines de staging et de preview ont besoin de leur propre ligne. Ou videz la liste le temps de déboguer. Lorsque l'origine est erronée, les statistiques comme les pixels publicitaires échouent en silence.

5. Testez-vous comme un visiteur ? Les visites provenant d'outils automatisés (navigateurs headless, curl, scripts, crawlers et assimilés) sont volontairement écartées. Testez dans une fenêtre de navigateur ordinaire.

6. Quelque chose bloque-t-il le script ? Les bloqueurs de publicité et certaines extensions de confidentialité bloquent les scripts d'analytics. Ouvrez votre site dans une fenêtre privée avec les extensions désactivées, ou cherchez t.js dans l'onglet réseau du navigateur.

7. Le navigateur demande-t-il à ne pas être suivi ? Si le navigateur du visiteur envoie Do Not Track, le tracker ne fait rien, par conception. Testez avec ce réglage désactivé. Votre propre navigateur peut l'avoir activé sans que vous le sachiez.

8. Le mode consentement est-il en attente ? Avec le package npm et requireConsent: true, rien n'est enregistré tant que grantConsent() n'a pas été exécuté. Un visiteur qui a refusé n'est pas suivi non plus. Voir Confidentialité et consentement.

9. Le site a-t-il atteint la limite de son offre, ou est-il suspendu ? Un site Free inclut 1 000 sessions par mois. Lorsque la limite de l'offre est appliquée et qu'un site l'a atteinte, les nouvelles sessions ne sont plus enregistrées jusqu'à la remise à zéro du compteur le 1er du mois (UTC) ou jusqu'à ce que vous passiez en Pro. Un site suspendu n'enregistre rien du tout. Le haut du dashboard affiche le compteur mensuel des sites Free, et Settings → Billing affiche le statut du site. Voir Facturation.

10. La période est-elle trop étroite ? Les pages proposent 24h, 7 days, 30 days et 90 days. Un site tout neuf peut n'avoir rien sur une fenêtre plus ancienne.

11. Le bon site est-il sélectionné ? Le sélecteur de site en haut de la barre latérale détermine le site que vous consultez.

Si vous ne voyez toujours rien, ouvrez les outils de développement de votre navigateur, allez dans l'onglet Network, rechargez votre site et cherchez une requête vers /api/ingest. Son code de statut vous indique ce qui se passe :

S'il n'y a aucune requête, le script ne s'exécute pas ou n'envoie rien : revoyez les points 2, 6, 7 et 8.

Le tracker fonctionne, mais quelque chose cloche

Les nombres de sessions ou de visiteurs diffèrent d'un autre outil. Une session correspond à un onglet du navigateur : un nouvel onglet démarre une nouvelle session, et un visiteur qui efface les données de son navigateur compte comme un nouveau visiteur. Les visiteurs dont le navigateur envoie Do Not Track, les visites bloquées par un bloqueur de publicité et les bots ne sont pas comptés.

Un changement de page dans mon application monopage n'a pas été compté. Avec la balise script, un nouveau pageview exige un changement de chemin. Un changement de ?query ou de #hash seul ne compte pas. Avec le client npm simple, vous devez appeler pageview() vous-même.

Je vois $scroll dans Top events. C'est un événement du tracker, pas un bug. Voir Suivre des événements.

Les heatmaps affichent « No recording of this page yet ». Les heatmaps s'appuient sur un enregistrement de la page. Vérifiez que le replay est activé (data-replay n'est pas à false, ou replay: true avec le package npm) et parcourez la page une fois. Les heatmaps de clics nécessitent aussi l'autocapture.

Les goals de clic ne sont jamais accomplis. Les goals de clic nécessitent l'autocapture, et le libellé doit correspondre exactement au texte ou à l'aria-label de l'élément, majuscules et minuscules comprises. Voir Goals.

Les pixels Meta, Google Ads ou LinkedIn ne se déclenchent pas. La liste des pixels est récupérée avec la même vérification des origines autorisées que les événements : passez donc d'abord par le point 4. Assurez-vous ensuite que le pixel est Enabled, et utilisez son bouton Test sur la page Pixels : une superposition liste chaque pixel comme « fired » ou « no request yet ». Un bloqueur de publicité peut supprimer les requêtes des pixels. Un identifiant mal saisi ne suit rien non plus, sans aucune erreur. Voir Pixels publicitaires.

Les conversions n'arrivent pas dans Meta ou Google Ads. Les conversions envoyées par les serveurs de Klickbee sont traitées par lots : laissez passer quelques minutes. Pour les prérequis de chaque plateforme, voir Conversions.

L'étape de consentement n'arrête pas mon tracking. Si vous utilisez la balise script, elle ne peut pas attendre le consentement : ajoutez le script après l'accord du visiteur. Voir Confidentialité et consentement.

Compte et connexion

Je n'ai jamais reçu l'e-mail de vérification. Sur l'écran d'inscription, cliquez sur Resend email ; sur l'écran de connexion, cliquez sur Resend verification email. Vérifiez votre dossier de spams. Vous ne pouvez pas vous connecter tant que l'e-mail n'est pas vérifié.

Un lien d'invitation indique qu'il a expiré. Les invitations expirent au bout de 7 jours. Demandez à un owner ou à un admin du site de la renvoyer depuis Settings → Team. Voir Inviter votre équipe.

Toujours bloqué ?

Contactez-nous, ou écrivez à hello@klickbee.com, en indiquant :

• l'adresse de votre site et le nom du site dans Klickbee,
• comment vous avez installé le tracker (balise script ou package npm),
• ce que vous voyez dans la carte d'état de l'installation,
• le code de statut de la requête /api/ingest, si vous l'avez regardé.

La clé publique pk_… peut être communiquée sans risque.