Utilizzare Measurement Protocol

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:

Invio dei valori richiesti

Per inviare dati sulle interazioni degli utenti, effettua una richiesta POST HTTP a questo endpoint.

POST /collect HTTP/1.1
Host: www.google-analytics.com

payload_data

Per ogni payload sono necessari 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 set di campi obbligatori. Pertanto, per inviare una visualizzazione di pagina per la pagina /home, dovresti utilizzare il seguente payload:

v=1&tid=UA-XXXXX-Y&cid=555&t=pageview&dp=%2Fhome

Le seguenti sezioni forniscono esempi dei tipi di hit più 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, puoi 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 alle limitazioni standard degli hit di Measurement Protocol, le richieste batch hanno 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 con hit può superare gli 8.000 byte.

Invio di tipi di hit 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 tra i dati. Ad esempio, per capire in quale pagina si è verificato un evento, invia il parametro pagePath, p, insieme ai parametri di monitoraggio eventi, come descritto di seguito.

Leggi il riferimento parametro 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 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 sono 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit di Measurement Protocol.

Misurazione dei rimborsi

Se devi inviare i dati di rimborso utilizzando un evento e l'evento non fa parte del comportamento sul sito normalmente misurato (ovvero non avviato dall'utente), ti consigliamo di inviare un evento non di interazione. In questo modo, l'evento non influirà su metriche quali frequenza di rimbalzo, 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit di Measurement Protocol.

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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit di Measurement Protocol.

Monitoraggio e-commerce

Per inviare i dati di e-commerce, invia un hit transaction che rappresenti un'intera transazione, poi 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit di Measurement Protocol.

Monitoraggio dei tempi utente

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 nello Strumento di creazione degli hit 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 nello Strumento di creazione degli hit di Measurement Protocol.

Utilizzo di un server proxy

Alcuni ambienti non sono in grado di inviare hit direttamente a Google Analytics. Alcuni esempi sono i telefoni cellulari meno recenti che non supportano JavaScript o le intranet aziendali protette da un firewall. In questi casi, è normale 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 nello Strumento di creazione degli hit di Measurement Protocol.