C’est une fonctionnalité vraiment intéressante pour la collecte de données Google Analytics, dont j’ai entendu très, très peu de buzz. C’est un moyen de déboguer tous les appels envoyés au point de terminaison Google Analytics à https://www.google-analytics.com/collect.
En toute simplicité, il vous suffit de copier l’URL complète de la requête HTTP dans votre presse-papiers, de la coller dans un navigateur Web et d’ajouter /debug entre le nom d’hôte et /collect.
Quelques mots sur le protocole de mesure
Prenons un peu de recul et rappelons-nous une chose importante. Chaque fois que vous envoyez un résultat à Google Analyticsque ce soit via des SDK d’applications mobiles, analytics.js sur votre site Web ou en utilisant des requêtes HTTP arbitraires, vous utilisez le “protocole de mesure”. En d’autres termes, MP n’est pas une méthode discrète et isolée de transfert de données, mais plutôt le protocole sous-jacent qui tous les SDK et les bibliothèques utilisent comme méthode d’envoi des données de charge utile à GA.
Ainsi, lorsque vous entendez une discussion du type :
JANE : Configurons simplement le ga('send'...) commandes sur la page pour intégrer cette fonctionnalité. JACK : Non, utilisons plutôt le protocole de mesure.
Ils parlent en fait de la même chose. Cependant, ce qu’est Jack Probablement référence est une requête HTTP créée manuellement à l’adresse /collect endpoint, en utilisant l’un des zillions de différentes façons de le faire. Lorsque vous utilisez le ga('send'...) syntaxe, vous communiquez avec le analytics.js bibliothèque et abstraction du processus de génération de requête HTTP avec une syntaxe abrégée simplifiée.
Vous pouvez le vérifier en naviguant sur un site Web compatible Universal-Analytics, en ouvrant les outils de débogage du navigateur et en examinant les requêtes réseau envoyées par le site :
Pourquoi est-ce important ? Pourquoi est-ce que je chipote sur la sémantique ? Eh bien, pour commencer, je amour pinailler. Mais aussi, en particulier avec tout le phénomène du spam de référence, les gens ont condamné le protocole de mesure car il introduit un lieu ouvert et non authentifié pour spammer un profil de rapport Google Analytics.
Eh bien, la raison pour laquelle il est ouvert et non authentifié est que votre site Web repose sur le même protocole. Si vous deviez y ajouter une couche d’authentification, cela devrait se produire côté serveur, car un spammeur pourrait simplement visiter votre site, copier la demande de charge utile et le spammer jusqu’à l’expiration de l’authentification. De plus, l’authentification ajouterait de la latence, ce qui affecterait les rapports en temps réel ainsi que le temps nécessaire pour que les données entrent dans vos rapports.
Mais je m’égare. Revenons au sujet.
Utilisation du débogueur
Comme je l’ai mentionné, cela n’a pas vraiment été annoncé, pour une raison étrange, mais c’est là. En fait, il existe même une page de support pour cette fonctionnalité.
Revenons donc à l’exemple de l’outil de développement du navigateur et inspectons la requête réseau à /collect. Copiez l’intégralité de l’URL de la demande (dans Chrome, c’est clic droit => Copier l’adresse du lien sur la demande), et collez-le dans une nouvelle fenêtre du navigateur.
Si vous appuyez maintenant sur Entrée, votre navigateur enverra simplement la demande à GA. Cependant, avant d’appuyer sur Entrée, ajoutez /déboguer dans l’URL, entre le nom d’hôte et /collectdonc ça ressemble à ça :
Et maintenant, appuyez sur Entrée. Vous devriez voir la réponse dans votre navigateur Web :
Étant donné que vous copiez une demande envoyée par votre site Web, vous devez espérer qu’elle est valide. Si ce n’est pas le cas, commencez à travailler sur un correctif !
Pourquoi c’est utile
Eh bien, pour commencer, vous pouvez déboguer vos hits et voir s’il y a quelque chose qui ne va pas avec eux. Les erreurs courantes incluent lorsque vous avez une mauvaise valeur de champ dans votre code ou lorsque vous avez oublié d’ajouter un champ obligatoire. Par exemple, la mise en place Valeur de l’événement à une chaîne vide ou à un nombre décimal renverrait une erreur, car si le champ est dans la requête, il doit toujours être un entier.
Un autre bon cas d’utilisation est lorsque vous utilisez réellement le protocole de mesure dans vos configurations personnalisées. Le débogueur Retour un objet de réponse, ce qui signifie que vous pouvez déboguer votre configuration sans envoyer de données à Google Analytics ! En analysant la réponse, vous pouvez facilement identifier si votre charge utile personnalisée fonctionne ou non.
Je sais que je suis dans le camp des geeks avec ça, mais cette fonctionnalité emballe définitivement une kilotonne de génial dans un petit espace. C’est un parfait moyen de tester vos configurations sans envoyer de données réelles à Google Analytics, et l’objet de réponse contient de nombreuses informations, toutes manquantes dans la demande réelle à /collect.
