Le tableau de bord affiche zéro visiteur
Cause : la raison la plus fréquente est une extension de cache qui sert une version mise en cache de l’endpoint du script de suivi.
Solution : ajoutez les endpoints de collecte de Statnive (/wp-json/statnive/v1/hit, /wp-json/statnive/v1/event, /wp-json/statnive/v1/engagement) à la liste d’exclusion de votre extension de cache. Si vous utilisez Cloudflare, créez une règle de page pour contourner le cache sur /wp-json/statnive/*.
Le nombre de visiteurs semble trop faible
Cause : Statnive utilise des hachages à rotation quotidienne pour identifier les visiteurs. Si votre site reçoit de nombreux visiteurs récurrents sur la même journée, les comptages devraient être précis. S’ils paraissent faibles, la cause la plus probable est qu’une règle d’exclusion filtre du trafic légitime.
Solution : ouvrez le tableau de bord Statnive, allez dans Réglages, puis examinez la section Exclusions. Vérifiez qu’aucun rôle connecté que vous souhaitez réellement suivre ne figure dans Rôles exclus, et qu’aucune plage IP active ne figure dans IP exclues.
Le compteur en temps réel ne se met pas à jour
Cause : le compteur en temps réel repose sur l’API REST de WordPress. Certaines extensions de sécurité bloquent l’accès à l’API REST pour les utilisateurs non authentifiés.
Solution : assurez-vous que l’endpoint wp-json/statnive/v1/realtime est accessible. Testez en visitant l’URL directement dans votre navigateur lorsque vous êtes connecté. Si vous voyez une réponse JSON, l’endpoint fonctionne. Si vous voyez une erreur 403, vérifiez les réglages d’API REST de votre extension de sécurité.
Le Rapport de chiffre d’affaires WooCommerce est vide après l’activation
Cause : à la première activation de la v1.0.0, le remplissage rétroactif des commandes historiques s’exécute en arrière-plan via Action Scheduler. Sur les grandes boutiques, il peut s’écouler quelques minutes avant que le Rapport de chiffre d’affaires se remplisse.
Solution : ouvrez WooCommerce → État → Actions planifiées et filtrez par statnive/wc/backfill/chunk. Vous devriez voir une ou plusieurs actions en file d’attente ou en cours d’exécution. Si vous préférez déclencher ou surveiller l’opération depuis la ligne de commande, exécutez :
wp statnive woocommerce-backfillLa commande est idempotente (la relancer pendant un remplissage en cours renvoie un code 409). La taille d’un lot est de 500 commandes par hook Action Scheduler ; les commandes aux statuts processing, completed et refunded sont comptabilisées. Consultez la documentation de l’intégration WooCommerce pour les détails.