Vérifier et dépanner une installation
Diagnostiquer le consentement, les domaines et la réception des données.
Utilisez un site de test qui vous appartient et des données synthétiques. La démo Lunetric est en lecture seule : elle ne peut pas recevoir votre collecte.
Première collecte
- Dans Configuration → Installation, retrouvez le domaine, l’origine du tracker et la clé publique du bon site.
- Ouvrez les outils développeur de votre navigateur, onglet Réseau. Rechargez votre site sans consentement :
tracker.jspeut se charger, mais aucun événement analytics ne doit être envoyé. - Acceptez la catégorie analytics de votre gestionnaire de consentement. Vérifiez que
window.lunetric.getVisitorId()renvoie un identifiant et que/collectreçoit une réponse 200. - Appelez
window.lunetric.flush()pour tenter l’envoi immédiat. Ouvrez le même site dans Lunetric et choisissez une période incluant maintenant, sans filtre de source ou de page. - Dans une SPA, changez de route une fois : attendez une seule page vue pour cette navigation. Retirez le consentement : les identifiants deviennent
nullet la collecte s’arrête.
Un 200 sur /collect confirme la réception HTTP. Lisez aussi accepted dans sa réponse et vérifiez le parcours : un événement déjà reçu ne doit pas être compté une seconde fois.
Rien n’apparaît
| Observation | Contrôle |
|---|---|
window.lunetric est absent | Script chargé une seule fois, URL correcte, CSP, bloqueur et erreur réseau |
Identifiant null | Script chargé et catégorie analytics explicitement autorisée |
| 400 du collector | Corps JSON, nom d’événement, propriétés et horodatage valides |
| 403 | Domaine de la page autorisé ; domaine et origine du collector ne sont pas interchangeables |
| 429 | Quota ou limite HTTP ; consulter le corps et Retry-After s’il est présent |
| Données reçues mais graphique vide | Bon site, période, fuseau, devise et filtres ; le revenu exige un paiement confirmé |
| Pages vues en double | Deux scripts ou un appel manuel en plus du suivi SPA automatique |
Pour un test local, ajoutez localhost ou 127.0.0.1 selon l’hôte réellement utilisé. Le port ne fait pas partie du domaine enregistré. Un sous-domaine est accepté si son domaine parent est autorisé.
Paiement absent ou non attribué
Pour Stripe, contrôlez la livraison du webhook, la signature et la file dans Configuration → Intégrations. Un secret enregistré ne prouve pas qu’un événement a été livré. En abonnement, la facture payée est canonique ; en achat ponctuel, le PaymentIntent l’est.
Un paiement reçu sans première visite dans les 90 jours reste Non attribué. Vérifiez la liaison de l’identité et les metadata, sans interrompre un paiement parce que l’identifiant analytics manque. Guide Stripe et attribution.
Avec un assistant
Le MCP check_installation retourne les données reçues et l’état de configuration Stripe. Il ne vérifie pas le code de votre site, votre CMP ou tous les parcours. Donnez à l’assistant les erreurs utiles, avec les secrets et identifiants personnels retirés. Référence MCP.