Ce document explique comment envoyer des appels courants au protocole de mesure.
Présentation
Ce document explique comment mettre en forme les requêtes HTTP pour envoyer des types d'appels courants au protocole de mesure Google Analytics. Consultez les ressources suivantes:
- Documentation de référence sur le protocole : description complète du formatage des requêtes Protocol.
- Référence des paramètres : liste de tous les paramètres acceptés par le protocole.
Envoi des valeurs requises
Pour envoyer les données d'interaction utilisateur, envoyez une requête HTTP POST à ce point de terminaison.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
Les paramètres suivants sont obligatoires pour chaque charge utile:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
Chaque charge utile doit contenir un type d'appel valide, et chaque type d'appel possède son propre ensemble de champs obligatoires. Ainsi, pour envoyer une page vue pour la page /home, vous devez utiliser la charge utile suivante:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
Les sections ci-dessous donnent des exemples de types d'appels courants.
Regrouper plusieurs appels dans une seule requête
Pour envoyer plusieurs appels dans une même requête, utilisez le point de terminaison /batch au lieu de /collect, et spécifiez chaque charge utile sur sa propre ligne.
Par exemple, pour envoyer des appels de page vue pour les pages "Accueil", "À propos de nous" et "Contact" d'un site Web, vous pouvez envoyer la requête groupée suivante.
POST /batch HTTP/1.1 Host: www.google-analytics.com v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fabout v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fcontact
Limites des lots
En plus des limites standards concernant les appels du protocole de mesure, les requêtes par lot présentent les limites supplémentaires suivantes:
- Vous pouvez spécifier jusqu'à 20 appels par demande.
- La taille totale de toutes les charges utiles d'appel ne peut pas dépasser 16 000 octets.
- La charge utile d'un appel unique ne peut pas dépasser 8 000 octets.
Envoi de types d'appels courants
Vous trouverez ci-dessous des exemples illustrant comment envoyer des types d'appels courants à Google Analytics.
Outre ces exemples, vous pouvez combiner différents paramètres pour établir de nouvelles relations entre les données. Par exemple, pour savoir sur quelle page un événement s'est produit, envoyez le paramètre pagePath p, ainsi que les paramètres de suivi des événements, comme décrit ci-dessous.
Consultez la documentation de référence pour obtenir la liste complète des paramètres que vous pouvez envoyer à Google Analytics.
Suivi des pages
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi des événements
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=video // Event Category. Required. &ea=play // Event Action. Required. &el=holiday // Event label. &ev=300 // Event value.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi de l'e-commerce amélioré
Les appels d'e-commerce amélioré doivent être utilisés à la place des appels E-commerce . Si vous avez déjà implémenté le suivi de l'e-commerce et que vous souhaitez commencer à l'utiliser, deux options s'offrent à vous:
Utiliser une nouvelle propriété
Vous pouvez créer une propriété et lui envoyer des appels de commerce électronique amélioré.
Migrer une propriété existante
Migrez tous les appels d'e-commerce vers des appels d'e-commerce amélioré, à l'aide des exemples ci-dessous. Les données sur les transactions et les articles collectées précédemment à l'aide des appels d'e-commerce ne seront pas affectées. Elles resteront disponibles dans les propriétés et les vues auxquelles ils ont été envoyés.
Mesure des impressions
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &il1nm=Search%20Results // Impression list 1. Required. &il1pi1id=P12345 // Product Impression 1 ID. Either ID or name must be set. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. Either ID or name must be set. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position. &il1pi1cd1=Member // Custom dimension. &il2nm=Recommended%20Products // Impression list 2. &il2pi1nm=Yellow%20T-Shirt // Product Impression 1 name. &il2pi2nm=Red%20T-Shirt // Product Impression 2 name.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Mesure des actions
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=click // Product action (click). Required. &pal=Search%20Results // Product Action List. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Combiner les impressions et les actions
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=UX // Event Category. Required. &ea=click // Event Action. Required. &el=Results // Event label. &pa=detail // Product action (detail). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position. &il1nm=Related%20Products // Impression list. &il1pi1id=P12345 // Product Impression 1 ID. &il1pi1nm=Android%20Warhol%20T-Shirt // Product Impression 1 name. &il1pi1ca=Apparel%2FT-Shirts // Product Impression 1 category. &il1pi1br=Google // Product Impression 1 brand. &il1pi1va=Black // Product Impression 1 variant. &il1pi1ps=1 // Product Impression 1 position.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Mesurer les achats
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/receipt // Page. &dt=Receipt%20Page // Title. &ti=T12345 // Transaction ID. Required. &ta=Google%20Store%20-%20Online // Affiliation. &tr=37.39 // Revenue. &tt=2.85 // Tax. &ts=5.34 // Shipping. &tcc=SUMMER2013 // Transaction coupon. &pa=purchase // Product action (purchase). Required. &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1ps=1 // Product 1 position.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Mesure des remboursements
Si vous devez envoyer des données de remboursement à l'aide d'un événement et que celui-ci ne fait pas partie d'un comportement normalement mesuré sur site (c'est-à-dire non déclenché par l'utilisateur), nous vous recommandons d'envoyer un événement non-interaction. Cela permet d'éviter que des métriques telles que le taux de rebond, la durée de la session, etc. ne soient affectées par l'événement.
// Refund an entire transaction and send with a non-interaction event. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
// Refund a single product. v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type. &ec=Ecommerce // Event Category. Required. &ea=Refund // Event Action. Required. &ni=1 // Non-interaction parameter. &ti=T12345 // Transaction ID. Required. &pa=refund // Product action (refund). Required. &pr1id=P12345 // Product 1 ID. Required. &pr1qt=1 // Product 1 quantity. Required.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Mesure du processus de paiement
1. Mesurer les étapes du règlement
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/checkout // Page. &dt=Checkout // Title. &pa=checkout // Product action (checkout). &pr1id=P12345 // Product 1 ID. Either ID or name must be set. &pr1nm=Android%20Warhol%20T-Shirt // Product 1 name. Either ID or name must be set. &pr1ca=Apparel // Product 1 category. &pr1br=Google // Product 1 brand. &pr1va=Black // Product 1 variant. &pr1pr=29.20 // Product 1 Price. &pr1qt=1 // Product 1 quantity. &cos=1 // Checkout step #1. &col=Visa // Checkout step option.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
2. Mesure des options de paiement
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Checkout // Event Category. Required. &ea=Option // Event Action. Required. &pa=checkout_option // Product action (checkout_option). &cos=2 // Checkout step. &col=FedEx // Checkout step option.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Mesure des promotions internes
Impressions de la promotion
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &dh=mydemo.com // Document hostname. &dp=/home // Page. &dt=homepage // Title. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Nombre de clics sur la promotion
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=event // Event hit type &ec=Internal%20Promotions // Event Category. Required. &ea=click // Event Action. Required. &el=Summer%20Sale // Event label. &promoa=click // Promotion action (click). Required. &promo1id=PROMO_1234 // Promotion 1 ID. Either ID or name must be set. &promo1nm=Summer%20Sale // Promotion 1 name. Either ID or name must be set. &promo1cr=summer_banner2 // Promotion Creative. &promo1ps=banner_slot1 // Promotion Position.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi du e-commerce
Pour envoyer des données d'e-commerce, envoyez un appel transaction représentant l'intégralité d'une transaction, puis envoyez un appel item pour chaque article de la transaction. L'ID de transaction ti associe tous les appels pour représenter l'achat complet.
Appel de transaction
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=transaction // Transaction hit type. &ti=12345 // transaction ID. Required. &ta=westernWear // Transaction affiliation. &tr=50.00 // Transaction revenue. &ts=32.00 // Transaction shipping. &tt=12.00 // Transaction tax. &cu=EUR // Currency code.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Appel avec élément
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=item // Item hit type. &ti=12345 // Transaction ID. Required. &in=sofa // Item name. Required. &ip=300 // Item price. &iq=2 // Item quantity. &ic=u3eqds43 // Item code / SKU. &iv=furniture // Item variation / category. &cu=EUR // Currency code.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Interactions associées aux réseaux sociaux
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=social // Social hit type. &sa=like // Social Action. Required. &sn=facebook // Social Network. Required. &st=/home // Social Target. Required.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi des exceptions
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=exception // Exception hit type. &exd=IOException // Exception description. &exf=1 // Exception is fatal?
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi du temps utilisateur
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=timing // Timing hit type. &utc=jsonLoader // Timing category. &utv=load // Timing variable. &utt=5000 // Timing time. &utl=jQuery // Timing label. // These values are part of browser load times &dns=100 // DNS load time. &pdt=20 // Page download time. &rrt=32 // Redirect time. &tcp=56 // TCP connect time. &srt=12 // Server response time.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Suivi des applications / des écrans
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=screenview // Screenview hit type. &an=funTimes // App name. &av=1.5.0 // App version. &aid=com.foo.App // App Id. &aiid=com.android.vending // App Installer Id. &cd=Home // Screen name / content description.
Affichez cet appel dans le générateur d'appels du protocole de mesure.
Utilisation d'un serveur proxy
Certains environnements ne permettent pas d'envoyer des appels directement à Google Analytics. Il peut s'agir, par exemple, des téléphones mobiles plus anciens qui ne peuvent pas exécuter JavaScript ou des intranets d'entreprise derrière un pare-feu. Dans ce cas, il est courant d'envoyer des requêtes à un serveur proxy qui utilise ensuite le protocole de mesure pour transmettre les appels à Google Analytics.
Pour collecter l'adresse IP et l'user-agent à partir de l'appareil client et non du serveur proxy, vous pouvez spécifier les deux valeurs dans le protocole de mesure. Elles remplaceront alors celles que Google Analytics obtient normalement à partir des en-têtes de requête.
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t=pageview // Pageview hit type. &uip=1.2.3.4 // IP address override. &ua=Opera/9.80 // User agent override.
Affichez cet appel dans le générateur d'appels du protocole de mesure.