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 el siguiente artículo:
- Referencia del protocolo: Es una descripción completa de cómo dar formato a las solicitudes del protocolo.
- Referencia de parámetros: Es una lista de todos los parámetros que acepta el protocolo.
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 debe tener 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.
Agrupa varios hits en una única 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 para las páginas “Página principal”, “Acerca de nosotros” 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 los 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 superior a 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.
Consulta 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Seguimiento de comercio electrónico mejorado
Se deben usar hits de comercio electrónico mejorado en lugar de hits de comercio electrónico . Si ya implementaste el seguimiento de comercio electrónico y deseas comenzar a usar el seguimiento de Comercio electrónico mejorado, hay dos opciones:
Usar una propiedad nueva
Puedes crear una propiedad nueva y enviarle hits de Comercio electrónico mejorado.
Cómo migrar una propiedad existente
Migra los hits de comercio electrónico a los hits de Comercio electrónico mejorado. Para ello, sigue los ejemplos que se indican a continuación. 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 las 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.
Consulta 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.
Consulta 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.
Consulta 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Medición de reembolsos
Si necesitas enviar datos de reembolsos mediante un evento y este no forma parte del comportamiento que se mide normalmente en el sitio (es decir, no es iniciado por 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.
Consulta 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Medición del proceso de pago
1. Mide 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
2. Medir 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Mide las 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 el Creador de hits del Protocolo de medición.
Clics de 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 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 de transaction que represente una transacción completa y, luego, envía un hit de 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Hit 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.
Consulta 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.
Consulta 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?
Consulta 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.
Consulta este hit en el Creador de hits del Protocolo de medición.
Seguimiento de apps / 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=1.5.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 el Creador de hits del Protocolo de medición.
Usa 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 o intranets corporativas detrás de un firewall. En estos casos, es común enviar solicitudes a un servidor proxy que luego use 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, que anularán 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.
Consulta este hit en el Creador de hits del Protocolo de medición.