Votre suivi des conversions cesse de se déclencher. Le trafic disparaît. Un événement ne se déclenche plus. Quelque chose a cassé, mais vous ne savez pas quoi. Le débogage consiste à trouver et à corriger le problème.
La plupart des problèmes de suivi ont des causes évidentes, une fois que vous savez où regarder. Apprendre à déboguer vous évite des heures de tâtonnement.
Le processus de débogage
Étape 1 : confirmer que le problème existe
Le suivi est-il vraiment défaillant, ou avez-vous mal lu les données ? Consultez plusieurs vues. Consultez différentes périodes. Confirmez que le problème est réel et durable.
Étape 2 : identifier quand il a commencé
Quand le suivi s'est-il arrêté ? Hier ? La semaine dernière ? Pouvez-vous situer le jour exact ? Regardez les données passées. Quand la chute a-t-elle eu lieu ? Cela réduit le champ des causes.
Étape 3 : vérifier si quelque chose a changé
Avez-vous déployé du code récemment ? Modifié la configuration ? Lancé une nouvelle fonctionnalité ? Les changements causent souvent des problèmes. Qu'est-ce qui a changé à l'époque où le suivi a cassé ?
Étape 4 : utiliser les outils de débogage
Utilisez le mode de débogage de votre outil de statistiques. Utilisez les outils de développement du navigateur. Utilisez la surveillance du réseau. Regardez les requêtes se produire en temps réel pour voir où elles échouent.
Étape 5 : tester à la main
Créez du trafic de test. Testez la conversion. Testez l'événement. Si votre test déclenche le suivi mais pas le vrai trafic, le problème est en production. Si le test ne marche pas non plus, le problème est dans la mise en place.
Étape 6 : corriger et vérifier
Appliquez la correction. Testez à nouveau. Vérifiez que la correction fonctionne avant de la déclarer terminée.
Problèmes de suivi courants et comment les déboguer
Le code de suivi ne se déclenche pas
Ouvrez les outils de développement du navigateur. Allez dans l'onglet Réseau. Cherchez des requêtes vers votre domaine de statistiques. Les voyez-vous ? Sinon, le code ne se déclenche pas.
Regardez la console du navigateur pour trouver des erreurs JavaScript. Les erreurs empêchent le code de suivi de s'exécuter. Corrigez l'erreur et le suivi se déclenchera.
Le code de suivi se charge mais les données n'apparaissent pas dans les rapports
La requête est bien envoyée (vous la voyez dans l'onglet Réseau), mais elle n'apparaît pas dans les rapports. Causes possibles : un pare-feu bloque la requête, un bloqueur de publicités la bloque, mauvais identifiant de propriété, objectif de conversion mal configuré.
Vérifiez que vous suivez la bonne propriété. Vérifiez qu'aucun filtre n'exclut les données de test. Vérifiez que le filtrage des robots n'attrape pas votre test.
Le suivi se déclenche parfois mais pas de façon régulière
Les problèmes intermittents sont plus difficiles à déboguer. Ce peut être des conditions de concurrence (le suivi se déclenche avant que les données soient prêtes). Ce peut être des délais d'attente réseau. Ce peut être du code conditionnel qui ne s'exécute pas toujours.
Regardez le code. Y a-t-il des conditions qui empêchent parfois le suivi de se déclencher ? Y a-t-il des délais d'attente ? Le suivi a-t-il lieu au bon moment ?
Le suivi des conversions se déclenche mais les conversions n'apparaissent pas
Le code de suivi se déclenche. La requête atteint le serveur. Mais les conversions n'apparaissent pas dans les rapports. Causes possibles : l'objectif de conversion n'est pas configuré, l'URL de l'objectif ne correspond pas à la vraie page de conversion, l'objectif se déclenche plusieurs fois par session (compté comme un seul).
Vérifiez la configuration de votre objectif de conversion. L'URL correspond-elle ? L'objectif se déclenche-t-il sur le bon événement ? Est-il configuré pour compter une fois ou plusieurs fois ?
Le suivi des événements se déclenche mais les données sont incomplètes
Les événements se déclenchent, mais certains paramètres d'événement manquent. Le chiffre d'affaires affiche 0 $. L'identifiant de produit est vide. L'événement est suivi, mais de façon incomplète.
Vérifiez votre code de suivi. Les paramètres sont-ils captés correctement ? Sont-ils transmis à l'appel de suivi ? Les données sont-elles disponibles au moment du suivi ?
Outils de débogage
Outils de développement du navigateur
Onglet Réseau : voir les requêtes envoyées. Onglet Console : voir les erreurs JavaScript. Les deux sont indispensables pour déboguer le suivi côté client.
Mode de débogage des statistiques
La plupart des outils ont un mode de débogage. Google Analytics a DebugView. Les plateformes de statistiques produit ont une vue des événements en direct. Elles montrent les événements en temps réel au moment où ils se déclenchent.
Extensions de navigateur
Des extensions comme Tag Assistant et d'autres extensions de débogage aident à inspecter le code de suivi et à déboguer les problèmes.
Journaux de serveur
Les journaux de serveur montrent toutes les requêtes, y compris les requêtes de suivi. Consultez-les pour voir si les requêtes de suivi atteignent seulement votre serveur.
Éviter les problèmes de suivi
Testez avant le déploiement
Ne déployez pas de changements de code de suivi en production sans les tester. Testez d'abord en préproduction. Vérifiez que le suivi marche en préproduction avant la mise en ligne.
Surveillez après le déploiement
Après un déploiement, surveillez pendant 24 heures. Guettez les chutes de trafic ou de conversions. Repérez vite les problèmes.
Tenez un journal des changements
Documentez chaque changement fait au code de suivi. Quand il a eu lieu, ce qui a changé, pourquoi. Cela vous aide à remonter des problèmes à leur cause.
Utilisez la gestion de versions
Gardez le code de suivi dans un système de gestion de versions (Git). Vous pouvez ainsi comparer les versions si quelque chose casse. Vous pouvez revenir à la version précédente si besoin.
Questions fréquentes
Comment savoir si mon suivi est défaillant ou si le trafic est simplement faible ?
Comparez avec les schémas habituels. Si le trafic tourne d'ordinaire autour de 1 000 et tombe soudain à 100, quelque chose ne va pas. S'il tombe à 800 et que vous n'avez lancé aucune campagne cette semaine-là, tout va probablement bien. Avec le créateur de site web de WEMASY, vous pouvez le configurer directement sur votre site.
Puis-je déboguer le suivi sans outils de développement ?
Pas facilement. Les outils de développement sont essentiels. Si vous n'êtes pas à l'aise avec eux, demandez de l'aide à un développeur ou utilisez les fonctions de débogage intégrées à votre outil de statistiques.
Combien de temps doit durer le débogage ?
Problèmes simples (mauvais identifiant de propriété, objectif mal configuré) : 15 à 30 minutes. Problèmes complexes (conditions de concurrence, soucis réseau) : 1 à 4 heures. Ayez un développeur disponible si le débogage dépasse une heure.
Que faire si je ne trouve pas le problème ?
Documentez ce que vous avez déjà vérifié. Demandez de l'aide à l'éditeur de votre outil de statistiques ou à un consultant. Parfois, un regard neuf repère le problème.
Dois-je annuler les changements si le suivi casse après un déploiement ?
Si vous venez de déployer et que le suivi casse, oui. Annulez tout de suite. Déboguez ensuite en préproduction avant de redéployer.
Les bloqueurs de publicités peuvent-ils casser mon suivi de façon permanente ?
Les bloqueurs ne cassent pas le suivi pour les visiteurs qui n'en ont pas. Ils le bloquent seulement pour ceux qui en ont. Votre suivi fonctionne bien pour la majorité des visiteurs sans bloqueur.