La última línea del fragmento de medición de JavaScript agrega un comando send a la cola de comandos ga() para enviar una vista de página a Google Analytics:
ga('create', 'UA-XXXXX-Y', 'auto');ga('send', 'pageview');
el objeto que está haciendo el envío es el rastreador que estaba programado para la creación en la línea de código anterior, y los datos que se envían son los datos almacenados en ese rastreador.,
esta guía describe las diversas formas de enviar datos a Google Analytics y explica cómo controlar qué datos se envían.
visitas, tipos de visitas y Protocolo de medición
cuando un rastreador envía datos a Google Analytics, se denomina envío de una visita, y cada visita debe tener un tipo de visita., La etiqueta de Google Analytics envía un golpe de tipo pageview; otros éxitos tipos include screenview, event, transaction, item, social, exception y timing. Esta guía describe los conceptos y métodos comunes a todos los tipos de visitas. Las guías individuales para cada tipo de visita se pueden encontrar en la sección medición de las interacciones comunes del usuario en la navegación del lado izquierdo.,
la visita es una solicitud HTTP, que consiste en pares de campos y valores codificados como una cadena de consulta, y enviados al Protocolo de medición.
Si tiene las herramientas de desarrolladores de su navegador abiertas cuando carga una página que utiliza analytics.js, puedes ver las visitas que se envían en la pestaña Red. Busque solicitudes enviadas a google-analytics.com/collect.
qué datos se envían
cuando se envía una visita al Protocolo de medición, los rastreadores envían todos los campos que están almacenados actualmente y son parámetros válidos del Protocolo de medición., Por ejemplo, en campos como title y location son enviados pero cookieDomain y hitCallback no lo son.
en algunos casos, desea enviar campos a Google Analytics para la visita actual, pero no para las visitas posteriores. Un ejemplo de esto es un evento golpear donde el eventAction y eventLabel campos son relevantes para el actual éxito solo.
para enviar campos solo con la visita actual, puede pasarlos como argumentos al método send., Para que los datos de campo se envíen con todas las visitas posteriores, debe actualizar el rastreador utilizando el método set.
el método de envío
el método send de un rastreador se puede llamar directamente en el objeto del rastreador o agregando un comando send a la cola de comandos ga(). Dado que la mayoría de las veces no tiene una referencia al objeto tracker, usar la cola de comandos ga() es la forma recomendada de enviar datos de tracker a Google Analytics.,
usando la cola de comandos ga ()
la firma para agregar un comando send a la cola de comandos ga() es la siguiente:
ga('send', , , );como se mencionó anteriormente, los valores»659c730955″>,...fields, yfieldsObject los parámetros se envían solo para la visita actual. No se almacenan en el objeto tracker, ni se envían con impactos posteriores.,
si alguno de los campos pasados con el comando send ya está establecido en el objeto tracker, se utilizarán los valores pasados en el comando en lugar de los valores almacenados en el tracker.
Las llamadas al comandosend deben especificar un hitType y, dependiendo del tipo especificado, también se pueden requerir otros parámetros. Consulte las guías individuales para medir las interacciones comunes del usuario en la navegación del lado izquierdo para obtener más detalles.,
la forma más sencilla de usar el comando send, que funciona para todos los tipos de visitas, es pasar todos los campos utilizando el parámetro fieldsObject. Por ejemplo:
ga('send', { hitType: 'event', eventCategory: 'Video', eventAction: 'play', eventLabel: 'cats.mp4'});para mayor comodidad, ciertos tipos de visitas permiten que los campos de uso común se pasen directamente como argumentos al comando send., Por ejemplo, el comando anterior send para el tipo de visita» evento»podría reescribirse como:
ga('send', 'event', 'Video', 'play', 'cats.mp4');para obtener una lista completa de los campos que se pueden pasar como argumentos para los diversos tipos de visita, consulte la sección» Parámetros » de la referencia del método de envío.
usando un rastreador con nombre
si está utilizando un rastreador con nombre en lugar del rastreador predeterminado, puede pasar su nombre en la cadena de comandos.,
el siguiente comando send se llamará en el rastreador llamado «myTracker»:
ga('myTracker.send', 'event', 'Video', 'play', 'cats.mp4');en el propio objeto del rastreador
Si tiene una referencia al objeto del rastreador, puede llamar al método send directamente:
ga(function(tracker) { tracker.send('event', 'Video', 'play', 'cats.mp4');});saber cuándo se ha enviado la visita
en algunos casos, necesita saber cuándo se envía una visita a Google Analytics, para que pueda tomar medidas inmediatamente después., Esto es común cuando necesita grabar una interacción particular que alejaría a un usuario de la página actual. Muchos navegadores dejan de ejecutar JavaScript tan pronto como la página comienza a descargarse, lo que significa que sus análisis.es posible que los comandos js para enviar visitas nunca se ejecuten.
un ejemplo de esto es cuando desea enviar un evento a Google Analytics para registrar que un usuario hizo clic en el botón enviar de un formulario. En la mayoría de los casos, al hacer clic en el botón Enviar se iniciará inmediatamente la carga de la página siguiente, y cualquier comando ga('send', ...) no se ejecutará.,
la solución para esto es interceptar el evento para detener la descarga de la página. A continuación, puede enviar su hit a Google Analytics como de costumbre, y una vez que el hit haya terminado de ser enviado, puede volver a enviar el formulario mediante programación.
hitCallback
para recibir una notificación cuando se realiza el envío de una visita, se establece el campo hitCallback. hitCallback es una función que se llama tan pronto como la visita se ha enviado correctamente.,
el siguiente ejemplo muestra cómo cancelar la acción de envío predeterminada de un formulario, enviar una visita a Google Analytics y luego volver a enviar el formulario utilizando la función hitCallback:
manejar los tiempos de espera
el ejemplo anterior funciona bien, pero tiene un problema grave. Si (por cualquier razón) el análisis.la biblioteca js no se carga, la función hitCallback nunca se ejecutará. Y si la función hitCallback nunca se ejecuta, los usuarios nunca podrán enviar el formulario.,
siempre que coloque la funcionalidad crítica del sitio dentro de la función hitCallback, siempre debe usar una función de tiempo de espera para manejar los casos en los que el análisis.la biblioteca js no se carga.
el siguiente ejemplo actualiza el código anterior para usar un tiempo de espera. Si pasa un segundo después de que el Usuario haga clic en el botón Enviar y el hitCallback no se ha ejecutado, el formulario se vuelve a enviar de todos modos.
si está utilizando el patrón anterior en muchos lugares de su sitio, probablemente sea más fácil crear una función de utilidad para manejar los tiempos de espera.,
La siguiente función de utilidad acepta una función como entrada y devuelve una nueva función. Si se llama a la función devuelta antes del período de tiempo de espera (el tiempo de espera predeterminado es de un segundo), borra el tiempo de espera e invoca la función de entrada. Si la función devuelta no se llama antes del período de tiempo de espera, La función de entrada se llama independientemente.
ahora puede empaquetar fácilmente todas las funciones hitCallback con un tiempo de espera para garantizar que su sitio funcione como se espera incluso en los casos en que sus visitas no se envían o los análisis.la biblioteca js nunca se carga.,
especificar diferentes mecanismos de transporte
de forma predeterminada, analytics.js elige el método HTTP y el mecanismo de transporte con el que enviar visitas de forma óptima. Las tres opciones son 'image' (usando un objeto Image), 'xhr' (usando un objeto XMLHttpRequest), o 'beacon' usando el nuevo método navigator.sendBeacon.
los dos métodos anteriores comparten el problema descrito en la sección anterior (donde las visitas a menudo no se envían si la página se está descargando)., El método navigator.sendBeacon, por el contrario, es una nueva característica HTML creada para resolver este problema.
si el navegador de su usuario admite el navigator.sendBeacon, puede especificar 'beacon' como el mecanismo transport y no tener que preocuparse por configurar una devolución de llamada de visita.
el siguiente código establece el mecanismo de transporte en 'beacon' en los navegadores que lo soportan.
ga('create', 'UA-XXXXX-Y', 'auto');// Updates the tracker to use `navigator.sendBeacon` if available.ga('set', 'transport', 'beacon'); medir ciertos tipos de interacciones de usuario a veces puede requerir implementaciones complejas., Sin embargo, en muchos casos estas implementaciones ya se han desarrollado y puesto a disposición como análisis.JS plugins. La siguiente guía explica cómo usar analytics.plugins js con la cola de comandos ga().
