Questa documentazione è per Universal Analytics. Se utilizzi Google Analytics 4, consulta Measurement Protocol (Google Analytics 4).

Utilizzare Measurement Protocol

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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:

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.