la dernière ligne de L’extrait de mesure JavaScript ajoute une commande send à la file d’attente de commandes ga() pour envoyer une pageview à Google Analytics:
ga('create', 'UA-XXXXX-Y', 'auto');ga('send', 'pageview');
st le tracker qui a été planifié pour la création dans la ligne de code précédente, et les données qui sont envoyées sont les données stockées sur ce tracker.,
Ce guide décrit les différentes façons d’envoyer des données à Google Analytics et explique comment contrôler les données envoyées.
Hits, types de hit et Protocole de mesure
lorsqu’un tracker envoie des données à Google Analytics, cela s’appelle envoyer un hit, et chaque hit doit avoir un type de hit., La balise Google Analytics envoie un hit de type pageview; d’autres types succès include screenview, event, transaction, item, social, exception et timing. Ce guide décrit les concepts et méthodes communs à tous les types d’accès. Des guides individuels pour chaque type d’accès peuvent être trouvés sous la section mesurer les interactions utilisateur courantes dans la navigation de gauche.,
Le hit est une requête HTTP, composée de paires de champs et de valeurs codées sous forme de chaîne de requête, et envoyées au Protocole de mesure.
Si les outils de développement de votre navigateur sont ouverts lorsque vous chargez une page qui utilise analytics.js, vous pouvez voir les hits envoyés dans l’onglet Réseau. Recherchez les requêtes envoyées à google-analytics.com/collect.
quelles données sont envoyées
lors de l’envoi d’un hit au Protocole de mesure, les trackers envoient tous les champs actuellement stockés et sont des paramètres de protocole de mesure valides., Par exemple, les champs comme title et location sont envoyés mais cookieDomain et hitCallback ne le sont pas.
Dans certains cas, vous souhaitez envoyer des champs à Google Analytics pour l’accès actuel, mais pas pour les accès suivants. Un exemple de ceci est un accès d’événement où les champseventAction EteventLabel ne sont pertinents que pour l’accès actuel.
pour envoyer des champs avec le hit actuel uniquement, vous pouvez les passer comme arguments à la méthode send., Pour que les données de champ soient envoyées avec tous les accès suivants, vous devez mettre à jour le tracker à l’aide de la méthode set.
la méthode send
La méthodesendD’un tracker peut être appelée directement sur l’objet tracker lui-même ou en ajoutant une commandesendà la file d’attente de commandesga(). Étant donné que la plupart du temps, vous n’avez pas de référence à l’objet tracker, l’utilisation de la file d’attente de commandes ga() est le moyen recommandé d’envoyer des données tracker à Google Analytics.,
en utilisant la file d’attente de commandes ga ()
la signature pour ajouter une commande send à la file d’attente de commandes ga() est la suivante:
ga('send', , , );comme mentionné ci-dessus, les valeurs 659c730955″>,...fields, etfieldsObject les paramètres sont envoyés pour le hit actuel uniquement. Ils ne sont pas stockés sur l’objet tracker, ni envoyés avec des hits ultérieurs.,
Si l’un des champs transmis avec la commandesend est déjà défini sur l’objet tracker, Les valeurs transmises dans la commande seront utilisées plutôt que les valeurs stockées sur le tracker.
Les appels à la commandesend doivent spécifier un hitType et, selon le type spécifié, d’autres paramètres peuvent également être requis. Voir les guides individuels pour mesurer les interactions utilisateur courantes dans la navigation de gauche pour plus de détails.,
la façon la plus simple d’utiliser la commandesend, qui fonctionne pour tous les types d’accès, est de passer tous les champs en utilisant le paramètrefieldsObject. Par exemple:
ga('send', { hitType: 'event', eventCategory: 'Video', eventAction: 'play', eventLabel: 'cats.mp4'});pour plus de commodité, certains types d’accès permettent de passer directement les champs couramment utilisés en tant qu’arguments à la commande send., Par exemple, la commande send ci-dessus pour le type d’accès « event » peut être réécrite comme suit:
ga('send', 'event', 'Video', 'play', 'cats.mp4');pour une liste complète des champs pouvant être passés en tant qu’arguments pour les différents types d’accès, voir la section « Paramètres » de la référence de la méthode send.
utilisation d’un tracker nommé
Si vous utilisez un tracker nommé au lieu du tracker par défaut, vous pouvez passer son nom dans la chaîne de commande.,
la commande send suivante sera appelée Sur le tracker nommé « myTracker »:
ga('myTracker.send', 'event', 'Video', 'play', 'cats.mp4');sur l’objet tracker lui-même
Si vous avez une référence à l’objet tracker, vous pouvez appeler la méthode send directement:
ga(function(tracker) { tracker.send('event', 'Video', 'play', 'cats.mp4');});savoir quand le hit a été envoyé
dans certains cas, vous devez savoir quand un hit est envoyé à Google Analytics, afin que vous puissiez agir immédiatement après., Ceci est courant lorsque vous devez enregistrer une interaction particulière qui éloignerait un utilisateur de la page en cours. De nombreux navigateurs cessent D’exécuter JavaScript dès que la page commence à se décharger, ce qui signifie que vos analyses.les commandes js pour envoyer des hits peuvent ne jamais s’exécuter.
un exemple de ceci est lorsque vous souhaitez envoyer un événement à Google Analytics pour enregistrer qu’un utilisateur a cliqué sur le bouton Soumettre d’un formulaire. Dans la plupart des cas, cliquer sur le bouton Soumettre commencera immédiatement à charger la page suivante et aucune commande ga('send', ...) ne s’exécutera.,
la solution consiste à intercepter l’événement pour empêcher la page de se décharger. Vous pouvez ensuite envoyer votre hit à Google Analytics comme d’habitude, et une fois que le hit est envoyé, vous pouvez soumettre à nouveau le formulaire par programme.
hitCallback
pour être averti lorsqu’un hit est envoyé, vous définissez le champhitCallback. hitCallback est une fonction qui est appelée dès que le coup a été envoyé avec succès.,
l’exemple suivant montre comment annuler l’action d’envoi par défaut d’un formulaire, envoyer un hit à Google Analytics, puis soumettre à nouveau le formulaire en utilisant la fonction hitCallback:
gestion des délais d’attente
l’exemple ci-dessus fonctionne bien, mais il a un problème sérieux. Si (pour une raison quelconque)l’analyse.la bibliothèque js ne se charge pas, la fonction hitCallback ne s’exécutera jamais. Et si la fonction hitCallback ne s’exécute jamais, les utilisateurs ne pourront jamais soumettre le formulaire.,
chaque fois que vous placez une fonctionnalité de site Critique dans la fonctionhitCallback, vous devez toujours utiliser une fonction timeout pour gérer les cas où l’analyse.bibliothèque js ne parvient pas à charger.
l’exemple suivant met à jour le code ci-dessus pour utiliser un délai d’expiration. Si une seconde passe après que l’utilisateur ait cliqué sur le bouton Soumettre et que le hitCallback ne s’est pas exécuté, le formulaire est de toute façon soumis à nouveau.
Si vous utilisez le modèle ci-dessus à de nombreux endroits de votre site, il est probablement plus facile de créer une fonction utilitaire pour gérer les délais d’attente.,
voici la fonction d’utilité accepte une fonction en entrée et renvoie une nouvelle fonction. Si la fonction renvoyée est appelée avant le délai d’expiration (le délai d’expiration par défaut est d’une seconde), elle efface le délai d’expiration et appelle la fonction d’entrée. Si la fonction renvoyée n’est pas appelée avant le délai d’expiration, la fonction d’entrée est appelée indépendamment.
Maintenant, vous pouvez facilement encapsuler toutes les fonctionshitCallback avec un délai d’attente pour vous assurer que votre site fonctionne comme prévu, même dans les cas où vos résultats ne parviennent pas à envoyer ou les analyses.bibliothèque js ne se charge jamais.,
la Spécification de différents mécanismes de transport
Par défaut, google analytics.js choisit la méthode HTTP et le mécanisme de transport avec lequel envoyer de manière optimale les hits. Les trois options sont 'image' (à l’aide d’un Image objet), 'xhr' (à l’aide d’un XMLHttpRequest objet), ou 'beacon' à l’aide de la navigator.sendBeacon méthode.
Les deux premières méthodes partagent le problème décrit dans la section précédente (où les accès ne sont souvent pas envoyés si la page est déchargée)., La méthode navigator.sendBeacon, en revanche, est une nouvelle fonctionnalité HTML créée pour résoudre ce problème.
Si le navigateur de votre utilisateur prend en charge lenavigator.sendBeacon, vous pouvez spécifier'beacon' en tant que mécanismetransport et ne pas avoir à vous soucier de définir un rappel d’accès.
Le code suivant définit le mécanisme de transport de 'beacon' dans les navigateurs qui le supportent.
ga('create', 'UA-XXXXX-Y', 'auto');// Updates the tracker to use `navigator.sendBeacon` if available.ga('set', 'transport', 'beacon');La mesure de certains types d’interactions utilisateur peut parfois nécessiter des implémentations complexes., Cependant, dans de nombreux cas, ces implémentations ont déjà été développées et mises à disposition sous forme d’analyses.js plugins. Le guide suivant explique comment utiliser analytics.plugins js avec la file d’attente de commandesga().
