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 les 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 de protocole.
- Parameter reference (Référence de paramètre) : liste de tous les paramètres acceptés par le protocole.
Envoyer 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 présentent des exemples de types d'appels courants.
Regrouper plusieurs appels dans une seule demande
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 les 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
Outre les limites standards qui s'appliquent aux 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 être supérieure à 16 000 octets.
- La charge utile d'un appel unique ne peut pas dépasser 8 000 octets.
Envoyer des types d'appels courants
Vous trouverez ci-dessous des exemples montrant comment envoyer les types d'appels courants à Google Analytics.
En plus de ces exemples, vous pouvez combiner différents paramètres pour établir de nouvelles relations entre les données. Par exemple, pour comprendre 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à mis en œuvre le suivi de l'e-commerce et que vous souhaitez commencer à utiliser le suivi de l'e-commerce amélioré, deux options s'offrent à vous:
Utiliser une nouvelle propriété
Vous pouvez créer une propriété et lui envoyer des appels d'e-commerce amélioré.
Migrer une propriété existante
Migrez tous les appels d'e-commerce vers des appels d'e-commerce amélioré, en suivant les exemples ci-dessous. Les données sur les transactions et les articles collectées précédemment à l'aide d'appels d'e-commerce ne seront pas affectées et resteront disponibles dans les propriétés et les vues auxquelles elles ont été envoyées initialement.
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.
Mesurer 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=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.
Mesurer les 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 de non-interaction. Ainsi, les métriques telles que le taux de rebond, la durée de la session, etc. ne seront pas 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.
Mesurer le processus de paiement
1. Mesurer les étapes de paiement
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. Mesurer les 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.
Mesurer les promotions internes
Impressions générées par 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 pour représenter une transaction entière, 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 / de l'écran
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 sont pas en mesure d'envoyer des appels directement à Google Analytics. Il peut s'agir, par exemple, de téléphones mobiles plus anciens qui ne peuvent pas exécuter JavaScript ou d'un intranet d'entreprise derrière un pare-feu. Dans ce cas, il est courant d'envoyer les demandes à 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 les valeurs normalement obtenues par Google Analytics à 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.