Trabajar con el Protocolo de medición

En este documento se describe cómo enviar visitas habituales 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 hit habituales al protocolo de medición de Google Analytics. Consulta:

Envío de los valores necesarios

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

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

payload_data

Es necesario incluir los parámetros siguientes para cada carga:

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

Cada carga debe contener un tipo de hit válido y cada tipo de hit tiene su propio conjunto de campos obligatorios. Por eso, para enviar una página vista de la página /home, se debe utilizar la carga siguiente:

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

En las secciones siguientes se ofrecen ejemplos de los tipos de hit habituales.

Procesamiento por lotes de varios hits en una única solicitud

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

Por ejemplo, para enviar hits de páginas visitas para las páginas "Inicio", "Quiénes somos" y "Contacto" de un sitio web, puedes enviar la siguiente solicitud por lotes.

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 de lotes

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

  • Por cada solicitud, se pueden especificar 20 hits como máximo.
  • El tamaño total de todas las cargas útiles de los hits no puede sobrepasar 16 KB.
  • Ningún hit puede tener una carga útil superior a 8 KB.

Enviar tipos de hits habituales

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

Consulta la referencia de 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.

Consulta este hit en Hit Builder 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.

Consulta este hit en Hit Builder del Protocolo de medición.

Seguimiento de comercio electrónico mejorado

Los hits de comercio electrónico mejorado se deben usar en lugar de los de comercio electrónico. Si ya has implementado el seguimiento de comercio electrónico y quieres empezar a usar el seguimiento de comercio electrónico mejorado, cuentas con dos opciones:

Usar una nueva propiedad

Puedes crear una nueva propiedad y enviarle los hits de comercio electrónico mejorado.

Migrar a una propiedad

Migra los hits de comercio electrónico a los de comercio electrónico mejorado siguiendo los ejemplos siguientes. Los datos de transacción y de artículo recopilados anteriormente con los hits de comercio electrónico no se verán afectados por la migración y seguirán disponibles en las propiedades y en las vistas a las que se enviaron al principio.

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.

Consulta este hit en Hit Builder 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.
    

Consulta este hit en Hit Builder 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.
   

Consulta este hit en Hit Builder del Protocolo de medición.

Medición de las 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.
    

Consulta este hit en Hit Builder del Protocolo de medición.

Medición de devoluciones

Si debes enviar datos de devolución usando un evento y este no forma parte del comportamiento que se mide en el sitio de forma habitual (no lo inicia el usuario), te recomendamos que envíes un evento sin interacción. Esto evita que el evento afecte a métricas como la de porcentaje de rebote o de duración de la sesión.

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

Consulta este hit en Hit Builder 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.
    

Consulta este hit en Hit Builder del Protocolo de medición.

Medición del proceso de pedido

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

Consulta este hit en Hit Builder del Protocolo de medición.

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

Consulta este hit en Hit Builder del Protocolo de medición.

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

Consulta este hit en Hit Builder del Protocolo de medición.

Clics de 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.
    

Consulta este hit en Hit Builder del Protocolo de medición.

Seguimiento de comercio electrónico

Para enviar datos de comercio electrónico, envía un hit transaction que sirva como representación de una transacción completa y, a continuación, envía un hit item para cada elemento de la transacción. El ID de transacción ti enlaza todos los hits para que representen toda la compra.

Hit de 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.

Consulta este hit en Hit Builder del Protocolo de medición.

Hit de 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.

Consulta este hit en Hit Builder 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.

Consulta este hit en Hit Builder 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?

Consulta este hit en Hit Builder del Protocolo de medición.

Seguimiento de tiempos de usuario

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.

Consulta este hit en Hit Builder del Protocolo de medición.

Seguimiento en la aplicación o en la pantalla

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=4.2.0                   // App version.
&aid=com.foo.App            // App Id.
&aiid=com.android.vending   // App Installer Id.

&cd=Home                    // Screen name / content description.

Consulta este hit en Hit Builder del Protocolo de medición.

Utilización de un servidor proxy

Algunos entornos no pueden enviar hits directamente a Google Analytics. Por ejemplo, en el caso de los dispositivos móviles antiguos que no pueden ejecutar JavaScript o de las intranets empresariales que se protegen tras un firewall. En estos casos es habitual enviar solicitudes a un servidor proxy que después utiliza el protocolo de medición para reenviar los hits a Google Analytics.

Para recopilar la IP y el user-agent del dispositivo cliente y no el servidor proxy, puedes especificar ambos valores en el protocolo de medición y después anular los valores que Google Analytics suele recibir de los encabezados de 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.

Consulta este hit en Hit Builder del Protocolo de medición.