Questo documento descrive come inviare hit comuni a Measurement Protocol.
Panoramica
Questo documento mostra come formattare le richieste HTTP per inviare tipi di hit comuni al Measurement Protocol di Google Analytics. Leggi i:
- Riferimento protocollo: una descrizione completa di come formattare le richieste di protocollo.
- Riferimento parametro: un elenco di tutti i parametri accettati dal protocollo.
Invio dei valori richiesti
Per inviare dati sulle interazioni dell'utente, effettua una richiesta POST HTTP a questo endpoint.
POST /collect HTTP/1.1 Host: www.google-analytics.com payload_data
Per ogni payload sono richiesti i seguenti parametri:
v=1 // Version. &tid=UA-XXXXX-Y // Tracking ID / Property ID. &cid=555 // Anonymous Client ID. &t= // Hit Type.
Ogni payload deve contenere un tipo di hit valido e ogni tipo di hit ha il proprio set di campi obbligatori. Per inviare una visualizzazione di pagina per la pagina /home
, dovresti usare il seguente payload:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
Le sezioni seguenti forniscono esempi di tipi di hit comuni.
Raggruppamento di più hit in un'unica richiesta
Per inviare più hit in una singola richiesta, utilizza l'endpoint /batch
anziché /collect
e specifica ogni payload su una riga separata.
Ad esempio, per inviare hit di visualizzazione di pagina per le pagine "Home", "Chi siamo" e "Contatti" di un sito web, potresti inviare la seguente richiesta batch.
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
Limitazioni batch
Oltre ai limiti standard degli hit di Measurement Protocol, le richieste batch presentano le seguenti limitazioni aggiuntive:
- È possibile specificare un massimo di 20 hit per richiesta.
- La dimensione totale di tutti i payload di hit non può essere superiore a 16.000 byte.
- Nessun payload per hit singolo può superare gli 8.000 byte.
Invio di tipi di hit comuni
Di seguito sono riportati alcuni esempi di come inviare tipi di hit comuni a Google Analytics.
Oltre a questi esempi, puoi combinare vari parametri per ottenere nuove relazioni tra i dati. Ad esempio, per capire
su quale pagina si è verificato un evento, invia il parametro pagePath,
p
, insieme ai parametri di monitoraggio eventi come descritto di seguito.
Leggi il riferimento dei parametri per un elenco completo di tutti i parametri che puoi inviare a Google Analytics.
Monitoraggio pagine
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio eventi
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio e-commerce avanzato
Gli hit di E-commerce avanzato devono essere utilizzati al posto degli hit di e-commerce . Se hai già implementato il monitoraggio e-commerce e vuoi iniziare a utilizzare il monitoraggio e-commerce avanzato, hai due opzioni:
Utilizza una nuova proprietà
Puoi creare una nuova proprietà e inviare hit di e-commerce avanzato alla nuova proprietà.
Eseguire la migrazione di una proprietà esistente
Esegui la migrazione di tutti gli hit di e-commerce agli hit di e-commerce avanzato, seguendo gli esempi riportati di seguito. I dati sulle transazioni e sugli articoli raccolti in precedenza utilizzando gli hit di e-commerce non saranno interessati e rimarranno disponibili nelle proprietà e nelle viste a cui erano stati originariamente inviati.
Misurazione delle impressioni
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Azioni di misurazione
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Combinazione di impressioni e azioni
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Misurazione degli acquisti
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Misurazione dei rimborsi
Se devi inviare i dati di rimborso utilizzando un evento e quest'ultimo non fa parte del comportamento sul sito misurato normalmente (ovvero non è avviato dall'utente), ti consigliamo di inviare un evento di non interazione. In questo modo, eviterai che l'evento influisca su metriche come la frequenza di rimbalzo, la durata della sessione e così via.
// 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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
// 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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Misurazione del processo di pagamento
1. Misurazione dei passaggi di pagamento
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
2. Misurazione delle opzioni di pagamento
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Misurazione delle promozioni interne
Impressioni promozione
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Clic su promozione
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio e-commerce
Per inviare i dati e-commerce, invia un hit transaction
che rappresenti un'intera transazione, quindi un hit item
per ogni articolo della transazione. L'ID transazione ti
collega tutti gli hit per rappresentare l'intero acquisto.
Hit transazione
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Hit articolo
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Interazioni social
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio eccezioni
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?
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio tempi utenti
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Monitoraggio app / schermo
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.
Utilizzo di un server proxy
Alcuni ambienti non sono in grado di inviare hit direttamente a Google Analytics. I telefoni cellulari meno recenti che non possono eseguire JavaScript o le intranet aziendali protette da un firewall sono un esempio. In questi casi è comune inviare richieste a un server proxy che utilizza Measurement Protocol per inoltrare gli hit a Google Analytics.
Per raccogliere l'IP e lo user agent dal dispositivo client e non dal server proxy, puoi specificare entrambi i valori nel Measurement Protocol, che sostituiranno i valori che Google Analytics normalmente ottiene dalle intestazioni delle richieste.
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.
Visualizza questo hit in Hit Builder di Measurement Protocol.