Questo documento descrive come inviare hit comuni a Measurement Protocol.
Panoramica
Questo documento illustra come formattare le richieste HTTP per inviare i tipi di hit più comuni a Google Analytics Measurement Protocol. Leggi:
- Riferimento protocollo: una descrizione completa di come formattare le richieste di protocollo.
- Riferimento parametri: un elenco di tutti i parametri accettati dal protocollo.
Invio dei valori richiesti
Per inviare i 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 obbligatori 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 un proprio insieme di campi obbligatori. Pertanto, per inviare una visualizzazione di pagina della pagina /home, devi utilizzare il seguente payload:
v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome
Le seguenti sezioni forniscono esempi di tipi di hit comuni.
Raggruppare più hit in una singola 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 visualizzazione di pagina per le pagine di home page "Informazioni su di noi" e "Contatti", puoi inviare la seguente richiesta in 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 alle limitazioni standard degli hit di Measurement Protocol, le richieste in batch presentano le seguenti limitazioni aggiuntive:
- È possibile specificare un massimo di 20 hit per richiesta.
- Le dimensioni totali di tutti i payload di hit non possono essere superiori a 16.000 byte.
- Il payload di un singolo hit non può superare i 8.000 byte.
Inviare i tipi di hit più comuni
Di seguito sono riportati alcuni esempi di come inviare i tipi di hit più comuni a Google Analytics.
Oltre a questi esempi, puoi combinare vari parametri per ottenere nuove relazioni di dati. Ad esempio, per capire su quale pagina si è verificato un evento, invia il parametro pagePath p e i parametri di monitoraggio eventi come descritto di seguito.
Leggi il riferimento ai 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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
Monitoraggio e-commerce avanzato
Gli hit E-commerce avanzato devono essere utilizzati al posto degli hit e-commerce. Se hai già implementato il monitoraggio e-commerce e vuoi iniziare a utilizzare il monitoraggio e-commerce avanzato, hai due possibilità:
Utilizzare una nuova proprietà
Puoi creare una nuova proprietà e inviare gli hit e-commerce avanzato alla nuova proprietà.
Eseguire la migrazione di una proprietà esistente
Esegui la migrazione di eventuali hit E-commerce a hit E-commerce avanzato, seguendo gli esempi riportati di seguito. I dati sulle transazioni e sugli articoli precedentemente raccolti utilizzando gli hit e-commerce non saranno interessati e rimarranno disponibili nelle proprietà e nelle viste a cui erano stati inviati in origine.
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 Measurement Protocol Hit Builder.
Misurazione delle 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=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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
Misurazione dei rimborsi
Se devi inviare dati relativi ai rimborsi utilizzando un evento e quest'ultimo non fa parte del normale comportamento in loco (ovvero non viene avviato dall'utente), ti consigliamo di inviare un evento non di interazione. In questo modo le metriche quali frequenza di rimbalzo, durata della sessione e così via non saranno interessate dall'evento.
// 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 Measurement Protocol Hit Builder.
// 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 Measurement Protocol Hit Builder.
Misurazione della procedura 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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
Monitoraggio e-commerce
Per inviare i dati di e-commerce, invia un hit transaction per rappresentare un'intera transazione, quindi invia un hit item per ogni articolo nella 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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
Monitoraggio delle 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 Measurement Protocol Hit Builder.
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 Measurement Protocol Hit Builder.
Monitoraggio schermo / app
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 Measurement Protocol Hit Builder.
Utilizzo di un server proxy
Alcuni ambienti non possono inviare hit direttamente a Google Analytics. Ne sono un esempio i telefoni cellulari meno recenti che non possono eseguire JavaScript o le intranet aziendali protette da un firewall. In questi casi è comune inviare richieste a un server proxy che utilizza poi 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 protocollo di misurazione e verranno sostituiti dai valori che Google Analytics ottiene normalmente 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 Measurement Protocol Hit Builder.