Cómo trabajar con el Protocolo de medición

En este documento, se describe cómo enviar hits comunes al Protocolo de medición.

Descripción general

En este documento, se muestra cómo dar formato a las solicitudes HTTP para enviar tipos de hits comunes al Protocolo de medición de Google Analytics. Lee lo siguiente:

Envía valores obligatorios

Para enviar datos de interacción del usuario, realiza una solicitud HTTP POST a este extremo.

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

payload_data

Los siguientes parámetros son obligatorios para cada carga útil:

v=1              // Version.
&tid=UA-XXXXX-Y  // Tracking ID / Property ID.
&cid=555         // Anonymous Client ID.
&t=              // Hit Type.

Cada carga útil debe contener un tipo de hit válido, y cada tipo de hit tiene su propio conjunto de campos obligatorios. Por lo tanto, para enviar una vista de página a la página /home, debes usar la siguiente carga útil:

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

En las siguientes secciones, se proporcionan ejemplos de tipos de hits comunes.

Agrupación en lotes de varios hits en una sola solicitud

Para enviar varios hits en una sola solicitud, usa el extremo /batch en lugar de /collect y especifica cada carga útil en su propia línea.

Por ejemplo, para enviar hits de vista de página a las páginas “Inicio”, “Acerca de nosotros” y “Contacto” de un sitio web, puedes enviar la siguiente solicitud de lote.

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

Limitaciones por lotes

Además de las limitaciones estándar de los hits del Protocolo de medición, las solicitudes por lotes tienen las siguientes limitaciones adicionales:

  • Se puede especificar un máximo de 20 hits por solicitud.
  • El tamaño total de todas las cargas útiles de hits no puede ser mayor que 16,000 bytes.
  • Ninguna carga útil de hit único puede superar los 8,000 bytes.

Cómo enviar tipos de hits comunes

A continuación, se muestran ejemplos de cómo enviar tipos de hits comunes a Google Analytics. Además de estos ejemplos, puedes mezclar y combinar varios parámetros para lograr nuevas relaciones de datos. Por ejemplo, para comprender en qué página ocurrió un evento, envía el parámetro pagePath, p, junto con los parámetros de seguimiento de eventos, como se describe a continuación.

Consulta la referencia de los parámetros para obtener una lista completa de todos los parámetros que puedes enviar a Google Analytics.

Seguimiento de páginas

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de eventos

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de comercio electrónico mejorado

Se deben usar los hits de Comercio electrónico mejorado en lugar de los hits de Comercio . Si ya implementaste el seguimiento de comercio electrónico y deseas comenzar a usar el seguimiento de comercio electrónico mejorado, hay dos opciones:

Cómo usar una propiedad nueva

Puedes crear una propiedad nueva y enviar hits de Comercio electrónico mejorado a esta.

Cómo migrar una propiedad existente

Sigue los ejemplos que se indican a continuación para migrar cualquier hit de comercio electrónico a los hits de Comercio electrónico mejorado. Los datos de transacciones y artículos recopilados anteriormente mediante los hits de comercio electrónico no se verán afectados y permanecerán disponibles en las propiedades y vistas a las que se enviaron originalmente.

Medición de impresiones

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Medición de acciones

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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Combinación de impresiones y acciones

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.
   

Puedes ver este hit en el creador de hits del protocolo de medición.

Medición de compras

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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Medición de reembolsos

Si necesitas enviar datos de reembolso con un evento y este no forma parte de un comportamiento que se mide normalmente en el sitio (es decir, no lo inicia el usuario), te recomendamos que envíes un evento sin interacción. Esto evitará que el evento afecte las métricas como el porcentaje de rebote, la duración de la sesión, etc.

 // 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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

 // 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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Medición del proceso de confirmación de la compra

1. Medición de los pasos de confirmación de la compra
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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

2. Medición de las opciones de confirmación de la compra
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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Medición de promociones internas

Impresiones de promoción
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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Clics en la promoción
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.
    

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de comercio electrónico

Para enviar datos de comercio electrónico, envía un hit transaction a fin de representar una transacción completa y, luego, envía un hit item para cada elemento de la transacción. El ID de transacción ti vincula todos los hits para representar la compra completa.

Hit de la transacción

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Éxito del artículo

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Interacciones sociales

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de excepciones

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?

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de los tiempos de los usuarios

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Seguimiento de apps o pantallas

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.

Puedes ver este hit en el creador de hits del protocolo de medición.

Usar un servidor proxy

Algunos entornos no pueden enviar hits directamente a Google Analytics. Algunos ejemplos son los teléfonos celulares más antiguos que no pueden ejecutar JavaScript ni intranets corporativas detrás de un firewall. En estos casos, es común enviar solicitudes a un servidor proxy que luego utiliza el Protocolo de medición para reenviar los hits a Google Analytics.

Para recopilar la IP y el usuario-agente del dispositivo cliente y no del servidor proxy, puedes especificar ambos valores en el Protocolo de medición, lo que anulará los valores que Google Analytics obtiene normalmente de los encabezados de la solicitud.

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.

Puedes ver este hit en el creador de hits del protocolo de medición.