La bibliothèque analytics.js (également appelée "balise Google Analytics") est une bibliothèque JavaScript permettant de mesurer la manière dont les utilisateurs interagissent avec votre site Web. Ce document explique comment ajouter la balise Google Analytics à votre site.
Balise Google Analytics
La balise Google Analytics doit être ajoutée en haut de la balise <head> et avant toute autre balise de script ou CSS, et l'ID de la propriété Google Analytics que vous souhaitez utiliser.
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
Le code ci-dessus effectue quatre opérations principales:
- Il crée un élément
<script>qui commence à télécharger de manière asynchrone la bibliothèque JavaScript analytics.js à partir dehttps://www.google-analytics.com/analytics.js. - Initialise une fonction
gaglobale (appelée file d'attente de commandesga()) qui vous permet de programmer l'exécution des commandes une fois que la bibliothèque analytics.js est chargée et prête à être utilisée. - Ajoute une commande à la file d'attente de commandes
ga()pour créer un objet de suivi pour la propriété spécifiée via le paramètre'GA_MEASUREMENT_ID'. - Ajoute une autre commande à la file d'attente de commandes
ga()pour envoyer une page vue à Google Analytics pour la page active.
Vous devrez peut-être modifier les deux dernières lignes de la balise Google Analytics (commandes create et send) ou ajouter du code pour capturer plus d'interactions. Cependant, vous ne devez pas modifier le code qui charge la bibliothèque analytics.js ou initialise la fonction de file d'attente de commandes ga().
Autre balise asynchrone
Bien que la balise Google Analytics décrite ci-dessus assure le chargement et l'exécution asynchrone du script sur tous les navigateurs, elle présente l'inconvénient de ne pas autoriser les navigateurs récents à précharger le script.
La balise asynchrone alternative ci-dessous est compatible avec le préchargement. Elle permet d'améliorer légèrement les performances dans les navigateurs récents, mais peut se dégrader en termes de chargement et d'exécution synchrones dans IE 9 et sur les navigateurs mobiles plus anciens qui ne reconnaissent pas l'attribut de script async. N'utilisez cette configuration de balise que si vos visiteurs utilisent principalement des navigateurs récents pour accéder à votre site.
<!-- Google Analytics -->
<script>
window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>
<!-- End Google Analytics -->
Quelles sont les données collectées par la balise Google Analytics ?
Lorsque vous ajoutez l'une de ces balises à votre site Web, vous envoyez une page vue pour chaque page consultée par les utilisateurs. Google Analytics traite ces données et peut déduire un grand nombre d'informations, y compris:
- Temps total passé par un utilisateur sur votre site
- Temps passé par un utilisateur sur chaque page et dans quel ordre.
- Les liens internes sur lesquels l'utilisateur a cliqué (en fonction de l'URL de la page vue suivante)
En outre, l'adresse IP, la chaîne user-agent et l'inspection initiale de la page effectuées par analytics.js lors de la création d'un objet de suivi permettent de déterminer, entre autres :
- Situation géographique de l'utilisateur.
- Navigateur et système d'exploitation utilisés
- Taille de l'écran, et indiquant si Flash ou Java est installé.
- Site référent.
Étapes suivantes
Pour les besoins de base des rapports, les données collectées via la balise Google Analytics peuvent suffire, mais dans de nombreux cas, vous devez répondre à d'autres questions concernant vos utilisateurs.
Les guides de ce site expliquent comment mesurer les interactions qui vous intéressent avec analytics.js. Toutefois, avant d'implémenter une fonctionnalité particulière, nous vous recommandons vivement de lire les guides répertoriés dans la section Principes de base, dans le panneau de navigation de gauche. Ces guides offrent une vue d'ensemble de la bibliothèque analytics.js et vous aideront à mieux comprendre les exemples de code utilisés sur le site.
Le guide suivant de cette série explique le fonctionnement d'analytics.js.