Ce guide explique comment utiliser analytics.js pour mesurer l'activité des pages sur des sites dont le contenu est chargé dynamiquement, sans chargement complet de page classique.
Présentation
Une application monopage (SPA) est une application ou un site Web qui charge toutes les ressources nécessaires à la navigation sur le site dès le premier chargement de la page. Lorsque l'utilisateur clique sur des liens et interagit avec la page, le contenu qui suit est chargé de manière dynamique. L'application met souvent à jour l'URL figurant dans la barre d'adresse pour émuler la navigation sur les pages classique, mais aucune autre demande de page complète n'est effectuée.
La balise Google Analytics par défaut fonctionne bien avec les sites Web traditionnels, car l'extrait de code est exécuté chaque fois que l'utilisateur charge une nouvelle page. Toutefois, pour une application monopage où le site charge le nouveau contenu de la page de manière dynamique plutôt que sous forme de chargement complet d'une page, l'extrait de code analytics.js ne s'exécute qu'une seule fois. Cela signifie que les pages vues (virtuelles) ultérieures doivent être enregistrées manuellement lors du chargement du nouveau contenu.
Suivi des pages vues virtuelles
Lorsque votre application charge le contenu de manière dynamique et met à jour l'URL dans la barre d'adresse, les données stockées dans votre système de suivi doivent également être mises à jour.
Pour mettre à jour l'outil de suivi, utilisez la commande set et fournissez la nouvelle valeur page:
ga('set', 'page', '/new-page.html');
Une fois que vous avez défini la valeur de la nouvelle page, celle-ci est utilisée pour tous les appels suivants envoyés. Pour enregistrer une page vue, envoyez un appel de page vue immédiatement après avoir mis à jour l'outil de suivi.
ga('set', 'page', '/new-page.html');
ga('send', 'pageview');
Bien que, techniquement, la commande send pour les appels de page vue accepte un champ page facultatif comme troisième paramètre, il n'est pas recommandé de transmettre le champ page de cette manière lors de la mesure des applications monopages. En effet, les champs transmis via la commande send ne sont pas définis dans l'outil de suivi. Ils ne s'appliquent qu'à l'appel actuel. Si vous ne mettez pas à jour l'outil de suivi, des problèmes seront rencontrés si votre application envoie des appels qui ne sont pas des pages vues (par exemple, des événements ou des interactions sur les réseaux sociaux), car ces appels seront associés à la valeur page de l'outil de suivi au moment de sa création.
Gérer plusieurs URL pour la même ressource
Certaines applications monopages ne mettent à jour la partie de hachage de l'URL que lors du chargement dynamique du contenu. Cette pratique peut entraîner des situations dans lesquelles de nombreux chemins de page différents pointent vers la même ressource. Dans ce cas, il est généralement préférable de choisir une URL canonique et de n'envoyer que la valeur page à Google Analytics.
Prenons l'exemple d'un site Web dont la page "À propos de nous" est accessible via l'une des URL suivantes:
/about.html/#about.html/home.html#about.html
Pour éviter de générer des rapports en double, il est préférable de comptabiliser toutes ces pages vues avec la valeur /about.html.
Remarques importantes
Ne pas mettre à jour l'URL de provenance du document
Lorsque vous créez un objet de suivi à l'aide de la commande create, la valeur de document.referrer est stockée dans le champ referrer de l'outil de suivi. Dans le contexte d'une application monopage qui n'utilise pas le chargement complet de la page, le champ referrer reste toujours le même.
Malgré cela, il n'est pas nécessaire de mettre à jour manuellement le champ de provenance avant d'envoyer des appels de page vue. Google Analytics est capable de déterminer automatiquement le chemin de navigation approprié.
Ne pas mettre à jour l'emplacement du document
De la même manière que l'outil de suivi utilise document.referrer pour le champ referrer, il utilise document.location pour le champ location, qui peut contenir des données de campagne ou d'autres métadonnées sous la forme de paramètres de requête ajoutés à la fin de l'URL.
Si vous mettez à jour l'un des champs de campagne ou d'autres métadonnées que Google Analytics recherche, la session en cours peut se terminer et une nouvelle session peut commencer. Pour éviter ce problème, ne mettez pas à jour le champ location lorsque vous mesurez les pages vues virtuelles dans une application monopage. Utilisez plutôt le champ page.
Ne pas créer de nouveaux indicateurs
Ne créez pas d'outils de suivi dans une application monopage dans le but de simuler le fonctionnement de l'extrait de suivi JavaScript pour les sites Web traditionnels. Cela risquerait d'envoyer une URL de provenance incorrecte ainsi que des données de campagne incorrectes, comme décrit ci-dessus.