Les objets de suivi (ou "outils de suivi") sont des objets qui 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 spécifie la façon dont les cookies sont stockés. La valeur recommandée est : 'auto' : Configuration automatique du domaine des cookies.
Si aucun cookie n'existe pour le domaine spécifié, un ID client est généré et stocké dans le cookie. L'utilisateur est alors identifié comme nouveau. Si un cookie contient une valeur d'ID client, cet ID client est défini sur 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 de l'écran, la taille de la fenêtre d'affichage et l'encodage des documents. Lorsque vous devez envoyer des données à Google Analytics, toutes les informations actuellement stockées sur l'outil de suivi sont envoyées.
Méthode de création
La bibliothèque analytics.js offre différentes façons de créer des outils de suivi, mais la plus courante consiste à utiliser la commande create et à transmettre les champs ID de suivi et Domaine de cookie en tant que deuxième et troisième paramètres:
ga('create', 'UA-XXXXX-Y', 'auto');
Nommer les outils de suivi
Vous pouvez également nommer l'outil de suivi en transmettant le champ name en tant que quatrième argument de la commande create. Le nom d'un outil de suivi est nécessaire lorsque vous devez créer plusieurs outils de suivi pour la même page. Pour en savoir plus sur les raisons pour lesquelles vous devrez peut-être effectuer cette opération, 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, vous créez un outil de suivi par défaut. Un outil de suivi par défaut est nommé en interne par le terme "t0".
Spécifier des champs au moment de la création
Vous pouvez également transmettre un objet "fields" facultatif qui vous permettra de définir n'importe quel champ analytics.js au moment de sa création. Il sera alors stocké dans l'outil de suivi et appliqué à tous les appels envoyés.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Comme pour tous les appels de 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 coachs électroniques
Dans certains cas, vous pouvez envoyer des données vers plusieurs propriétés à partir d'une même page. Cette fonctionnalité est utile pour les sites dont plusieurs propriétaires supervisent les différentes sections d'un site. 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 un doit être 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
Pour exécuter les commandes analytics.js pour un outil de suivi spécifique, ajoutez le nom de l'outil au début, suivi d'un point. Lorsque vous n'indiquez pas de nom pour l'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, vous devez exécuter les deux commandes suivantes:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
Les futurs guides reviendront plus en détail sur la syntaxe permettant d'exécuter des commandes spécifiques. Vous pouvez également consulter la documentation de référence sur les files d'attente de commandes pour découvrir la syntaxe complète de toutes les commandes analytics.js.
Étapes suivantes
Une fois l'outil de suivi créé, vous aurez peut-être besoin d'accéder aux données qui y sont stockées. Le guide suivant explique comment obtenir et définir des données de suivi.