Tag : SPA

Tous les articles du blog avec ce tag.

Analytics sur application monopage : la recette avant mise en ligne

Analytics sur application monopage : la recette avant mise en ligne

Un développeur installe le script de mesure sur une application web. La page d'accueil apparaît dans le dashboard, le statut d'installation est vert, et le ticket est fermé. Pourtant, les pages internes n'apparaissent presque jamais. À l'inverse, certains changements de route sont comptés deux fois. Dans une application monopage, ou SPA, le navigateur peut afficher plusieurs écrans successifs sans recharger le document HTML initial. Un outil de mesure d'audience qui détecte seulement le chargement de la page ne voit pas nécessairement ces transitions. Une configuration qui capte à la fois les changements d'historique et les déclenchements manuels peut, elle, multiplier les événements. La bonne question avant production n'est donc pas « le script est-il chargé ? », mais « quel événement mesurons-nous pour chaque changement de vue réel, et comment savons-nous qu'il n'est ni absent ni dupliqué ? » Comprendre ce qui change dans une SPA Une navigation classique charge un nouveau document. Un changement d'écran en SPA est souvent piloté par le routeur JavaScript, qui modifie le contenu visible et parfois l'URL. Les méthodes de l'History API permettent notamment d'ajouter ou de remplacer une entrée d'historique sans créer une nouvelle page complète. La documentation MDN précise un détail important : appeler « pushState » ou « replaceState » ne déclenche pas à lui seul l'événement « popstate ». Ce dernier intervient notamment lors d'un retour ou d'une avance dans l'historique. Une instrumentation fondée uniquement sur « popstate » peut donc rater les navigations initiées par l'application. À l'inverse, écouter plusieurs mécanismes sans les coordonner peut compter une seule transition plusieurs fois. Le routeur, un tag manager et une mesure améliorée automatique peuvent se chevaucher. Google recommande, dans sa documentation SPA, de vérifier les événements de page et les valeurs de référent après chaque transition. Il signale également le risque de doubles pages vues lorsque plusieurs méthodes suivent les mêmes changements. Commencer par définir une page vue utile Chaque transition technique n'est pas nécessairement une nouvelle page au sens du reporting. L'ouverture d'un menu, la modification d'un filtre ou l'affichage d'une fenêtre modale peut changer l'état de l'interface sans constituer une page à suivre séparément. Définissez une règle adaptée aux décisions de l'équipe. Pour un site marketing, une route qui correspond à un contenu distinct peut justifier une page vue. Dans un outil authentifié, une étape de formulaire ou une vue produit peut nécessiter un événement différent. Le choix doit être explicite. Une définition de travail pourrait être : « Une page vue est enregistrée après l'affichage réussi d'un nouvel écran de contenu, identifié par son chemin canonique, lorsque ce changement correspond à une unité de lecture du rapport. » Ce n'est pas une norme universelle : c'est un contrat de mesure à adapter. Documentez séparément les vues non instrumentées : paramètres d'interface, onglets internes, états de chargement et écrans privés exclus. L'absence volontaire de collecte doit pouvoir être distinguée d'un défaut. Préparer une matrice de routes représentatives Il n'est pas nécessaire de tester chaque URL du site pour détecter les familles de défauts. Choisissez des scénarios qui couvrent des comportements distincts : première visite, navigation interne, retour, avance, redirection, modification de paramètres et reprise de session.Scénario Observation attendueChargement direct de la page d'accueil Une page vue si la mesure est activéeClic vers une route interne Une nouvelle page vue pour l'écran affichéRetour navigateur Retour cohérent vers le chemin précédentAvance navigateur Chemin et référent conformes à la définitionRedirection automatique Écran final compté sans doublon indésirableChangement d'un filtre de liste Pas de page vue si ce n'est pas un nouvel écranOuverture puis fermeture d'une modale Événement dédié uniquement si justifiéChargement interrompu ou erreur Politique de comptage expliciteURL avec paramètres sensibles fictifs Aucune valeur interdite dans la requêtePour chaque scénario, notez le chemin précédent, le chemin suivant, la méthode de navigation, la requête envoyée et l'entrée visible dans le rapport. Six défauts à rechercher méthodiquement 1. Une seule page vue pour toute la session Si l'outil observe uniquement le chargement initial, il peut enregistrer le site comme une page unique. Les pages internes paraissent alors désertées, et les taux d'engagement deviennent difficiles à interpréter. Vérifiez que l'instrumentation comprend les transitions du routeur réellement utilisé. Ne supposez pas qu'une intégration universelle gère tous les frameworks et toutes les versions. 2. Des pages vues doubles après chaque navigation Un événement automatique et un événement manuel peuvent décrire la même transition. Comptez les requêtes réseau immédiatement après un clic de navigation. Deux requêtes pour un seul écran sont un signal d'investigation, pas nécessairement une preuve de double comptage dans le rapport final : examinez également leur contenu. La documentation de Google sur les pages vues explique comment désactiver le comportement automatique lorsqu'un suivi manuel est souhaité. Le principe général est de n'avoir qu'une autorité pour décider d'une page vue. 3. Un référent incohérent Une page peut être correctement comptée tout en conservant le mauvais référent. Le parcours est alors faussé : une visite à la documentation peut apparaître comme venant d'une source antérieure plutôt que de la route immédiatement précédente. Inspectez la règle d'attribution du fournisseur. Ne confondez pas le référent HTTP du navigateur et une notion de page précédente reconstruite par le produit. Les deux ne sont pas équivalents dans toutes les architectures. 4. Des URL contenant des données imprévues Les routes peuvent embarquer des identifiants de compte, des termes de recherche, des adresses électroniques ou des jetons dans le chemin ou la chaîne de requête. Envoyer mécaniquement l'URL complète à l'analytics risque de créer une collecte disproportionnée. Établissez une politique de chemins canoniques et de filtrage des paramètres, y compris pour les routes privées. Le guide Pomelo sur les paramètres d'URL donne des exemples concrets. Testez avec des valeurs fictives reconnaissables et vérifiez qu'elles n'apparaissent jamais dans les requêtes. 5. Des événements attachés au mauvais écran Une conversion émise pendant une transition peut être associée à la route précédente, à une route provisoire ou à une confirmation rechargée. Vérifiez la chronologie exacte : changement de vue, résultat du serveur, émission de l'événement et actualisation du rapport. Un clic sur « Envoyer » n'est pas une preuve de demande réussie. Il faut isoler les événements d'intention et de confirmation, notamment lorsque les formulaires sont gérés de façon asynchrone. 6. Des doublons dus au cycle de vie du composant En développement, certains frameworks montent, démontent ou réexécutent des effets pour détecter des erreurs. Si le code de collecte se trouve dans un effet qui n'est pas idempotent, il peut produire des événements multiples. Ne déduisez pas la cause d'un doublon à partir d'un seul environnement. Comparez le comportement en développement et dans une version de production, avec la même séquence d'actions. Un problème constaté uniquement en développement mérite une correction de robustesse, mais ne doit pas être présenté comme un incident de production sans preuve. La méthode de recette en quatre étapes Instrumenter les tests, pas les utilisateurs Utilisez un environnement isolé, des comptes de test et des valeurs fictives. Activez les outils réseau, la console et, si disponible, un mode de débogage du fournisseur. Conservez une capture des requêtes et leur chronologie. Évitez de mettre en place un suivi supplémentaire de données réelles uniquement pour faciliter la recette. Un journal technique local et un identifiant de scénario fictif suffisent souvent. Faire tourner un parcours stable Exécutez toujours la même suite d'actions, dans le même navigateur, puis répétez-la dans un second navigateur ou mode de navigation. Incluez explicitement la navigation avec les boutons du navigateur et les liens directs vers les pages internes. L'important n'est pas de produire beaucoup de tests, mais de couvrir les transitions qui changent la manière dont les écrans sont affichés. Comparer trois niveaux de preuve Comparez l'action humaine notée dans la grille, les requêtes réellement envoyées et les lignes agrégées dans le produit. Les divergences peuvent venir d'un délai de restitution, d'un filtre anti-bots, d'un refus de consentement ou d'un défaut de collecte. Ne marquez pas « échec » une donnée absente avant d'avoir vérifié le fonctionnement documenté de l'outil et sa fenêtre de traitement. Rédiger le résultat pour une équipe Documentez chaque anomalie avec le chemin, le déclencheur, le comportement observé, l'effet sur les chiffres et l'action corrective. Un défaut de double comptage doit être reproductible avant de choisir entre automatisation et déclenchement manuel. Rattachez ce contrôle au processus de déploiement : les tests de route et d'événements critiques doivent être rejoués après un changement de routeur, de formulaire ou de configuration de tracking. Protéger les données et les limites de mesure Une SPA rend parfois les parcours plus complexes, mais cela ne justifie pas une collecte exhaustive. Un inventaire de pages vues et d'actions sélectionnées reste souvent suffisant pour les besoins d'un site marketing ou d'une documentation. Attention à ne pas exporter vers l'analytics des identifiants propres à l'application sous prétexte qu'ils facilitent le débogage. Distinguez la télémétrie technique, les journaux d'incident et la mesure d'audience destinée au pilotage. Les obligations relatives au consentement et à la transparence ne disparaissent pas parce que les événements sont envoyés à partir d'une SPA. Les conditions d'une éventuelle exemption pour certaines mesures d'audience restent spécifiques, comme le rappelle la CNIL. Comment évaluer une solution analytics sur ce sujet ? Demandez quelles transitions sont prises en charge, comment sont évités les doubles déclenchements, comment les URL sont normalisées et quels tests de recette sont documentés. Un fournisseur peut très bien nécessiter une configuration manuelle pour certains routeurs : l'important est qu'il l'explique et permette d'obtenir un résultat reproductible. Pour Pomelo comme pour tout autre outil, la compatibilité effective doit être vérifiée sur l'application et la version du script utilisées. Une compatibilité annoncée pour tous les frameworks sans tests précis ne suffit pas à garantir une collecte fiable. Conclusion : la bonne page vue est un contrat testé Le succès d'une installation ne se résume pas au chargement d'une balise. Il se mesure à la cohérence entre un écran réellement vu, la requête transmise et l'indicateur consulté. Avant de livrer, choisissez des routes représentatives, testez les transitions, inspectez les payloads et conservez les résultats. Une telle recette apporte davantage de fiabilité qu'un compteur « installé » sans vérification. FAQ Une SPA doit-elle envoyer une page vue à chaque clic ? Non. Une page vue correspond à une définition de changement d'écran ou de contenu, pas à chaque interaction. Les clics importants peuvent être mesurés par des événements distincts. Est-ce que « popstate » détecte toutes les navigations ? Non. Selon MDN, les appels à « pushState » et « replaceState » ne déclenchent pas automatiquement « popstate ». Le routeur doit être pris en compte. Pourquoi mes pages vues sont-elles doublées ? Un mélange de déclencheurs automatiques et manuels est une cause possible. Inspectez les requêtes réseau et les règles de votre outil avant de corriger. Faut-il envoyer l'URL complète à l'analytics ? Pas sans examen. Les chemins et paramètres peuvent contenir des données personnelles ou sensibles. Préférez une normalisation et un filtrage adaptés aux finalités. SourcesGoogle for Developers, Measure single-page applications Google for Developers, Measure pageviews MDN, History API MDN, événement popstate CNIL, outils de mesure d'audience et conditions d'exemption

La juste mesure, pour tous vos sites.

Pomelo ouvre progressivement ses accès. Rejoignez les premières équipes à mesurer juste et contribuez aux prochaines évolutions du produit.