Les objets de suivi (également appelés "outils de suivi") peuvent collecter et stocker des données, puis les envoyer à Google Analytics.
Lorsque vous créez un outil de suivi, vous devez spécifier un ID de suivi (identique à l'ID de propriété correspondant à l'une de vos propriétés Google Analytics) ainsi qu'un domaine de cookie, qui indique comment les cookies sont stockés. (La valeur recommandée 'auto' spécifie la configuration automatique du domaine de cookie.)
Si aucun cookie n'existe pour le domaine spécifié, un ID client est généré et stocké dans le cookie, et l'utilisateur est identifié comme nouveau. S'il existe un cookie contenant une valeur d'ID client, cet ID client est défini dans l'outil de suivi, et l'utilisateur est identifié comme connu.
Lors de leur création, les objets de suivi recueillent également des informations sur le contexte de navigation actuel, telles que le titre et l'URL de la page, ainsi que des informations sur l'appareil, telles que la résolution d'écran, la taille de la fenêtre d'affichage et l'encodage du document. Au moment d'envoyer des données à Google Analytics, toutes les informations actuellement stockées sur le traceur sont envoyées.
Méthode "create"
La bibliothèque analytics.js propose différentes méthodes pour créer des outils de suivi, mais la plus courante consiste à utiliser la commande create, et à transmettre les champs ID de suivi et domaine du cookie en tant que deuxième et troisième paramètres:
ga('create', 'UA-XXXXX-Y', 'auto');
Nommer les indicateurs
Vous pouvez également, si vous le souhaitez, nommer l'outil de suivi en transmettant le champ name comme quatrième argument de la commande create. Il est nécessaire de nommer un outil de suivi si vous devez créer plusieurs indicateurs pour la même page. Pour en savoir plus sur l'utilité de procéder ainsi, consultez la section ci-dessous sur l'utilisation de plusieurs outils de suivi.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
Lorsque vous créez un outil de suivi sans définir le champ name, on parle de création d'un outil de suivi "par défaut". Un outil de suivi par défaut est nommé "t0" en interne.
Spécifier des champs au moment de la création
Vous pouvez également transmettre un objet de champs facultatif qui vous permet de définir n'importe quel champ analytics.js au moment de la création. Il sera ainsi stocké dans l'outil de suivi et s'appliquera à tous les appels envoyés.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Comme pour tous les appels à la fonction ga(), vous pouvez également utiliser l'objet "fields" pour spécifier tous les champs ensemble:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
Pour en savoir plus, consultez la documentation de référence sur la méthode create.
Utiliser plusieurs outils de suivi
Dans certains cas, il se peut que vous souhaitiez envoyer des données à plusieurs propriétés à partir d'une même page. Cette fonctionnalité est utile pour les sites dont plusieurs propriétaires supervisent des sections (chaque propriétaire peut afficher sa propre propriété).
Pour effectuer le suivi des données de deux propriétés distinctes, vous devez créer deux outils de suivi distincts, dont au moins l'un doit être un outil de suivi nommé. Les deux commandes suivantes créent un outil de suivi par défaut et un outil de suivi nommé "clientTracker":
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
Exécuter des commandes pour un coach électronique spécifique
Afin d'exécuter des commandes analytics.js pour un outil de suivi spécifique, ajoutez le nom de l'outil de suivi avant le nom de la commande, suivi d'un point. Lorsque vous ne spécifiez pas de nom d'outil de suivi, la commande est exécutée sur l'outil de suivi par défaut.
Pour envoyer les pages vues pour les deux outils de suivi ci-dessus, exécutez les deux commandes suivantes:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
Les prochains guides approfondiront la syntaxe d'exécution de commandes spécifiques. Vous pouvez également consulter la documentation de référence sur les files d'attente de commandes pour connaître la syntaxe complète de commande pour toutes les commandes analytics.js.
Étapes suivantes
Une fois que vous avez créé un outil de suivi, vous devrez peut-être accéder aux données stockées sur cet objet de suivi. Le guide suivant explique comment obtenir et définir les données de suivi.