Seguimiento de eventos

En esta guía se explica cómo implementar el seguimiento de eventos con analytics.js.

Descripción general

Los eventos son interacciones del usuario con contenido cuyo seguimiento se puede realizar independientemente a partir de una página web o una carga de pantalla. Las descargas, los clics en anuncios para móviles, los gadgets, los elementos Flash, los elementos insertados AJAX y las reproducciones de vídeo son todos ejemplos de acciones de las que puedes realizar un seguimiento como eventos.

Si no estás familiarizado con los eventos en Google Analytics, primero lee el artículo Acerca de los eventos del Centro de Ayuda de Analytics.

Implementación

Los hits de evento se pueden enviar con el comando send y especificando un hitType de event. El comando send tiene la siguiente firma para el tipo de hit event:

ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Campos de evento

En la tabla siguiente se ofrece un resumen de los campos de evento:

Nombre del campo Tipo de valor Obligatorio Descripción
eventCategory texto Suele ser el objeto con el que se ha interactuado (p. ej., 'Video').
eventAction texto Tipo de la interacción (por ejemplo, 'play')
eventLabel texto no Útil para clasificar los eventos (p. ej., 'Fall Campaign').
eventValue entero no Valor numérico asociado al evento (por ejemplo, 42)

Si quieres obtener una descripción exhaustiva de cada uno de estos campos, consulta Anatomía de un evento en el Centro de Ayuda de Analytics.

Ejemplos:

El comando siguiente envía un evento a Google Analytics que indica que se ha reproducido el vídeo promocional de la campaña de otoño:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

Al igual que sucede con todos los comandos send, los campos que se pasan en los parámetros auxiliares también se pueden especificar en fieldsObject. El comando anterior se podría reescribir de la siguiente forma:

ga('send', {
  hitType: 'event',
  eventCategory: 'Videos',
  eventAction: 'play',
  eventLabel: 'Fall Campaign'
});

Cuando un usuario hace clic en un enlace que dirige a otra página de tu sitio, normalmente esta página envía un hit de página vista tan pronto como el usuario llega a ella. Dado que hay una serie de páginas vistas, Google Analytics puede determinar en segundo plano hacia y desde dónde ha navegado el usuario. No obstante, si un usuario hace clic en un enlace o envía un formulario a un dominio externo, esta acción solo se registra si indicas específicamente a Google Analytics lo que ha sucedido.

El seguimiento de enlaces y formularios externos puede realizarse enviando eventos y especificando la URL de destino en uno de los campos de evento. Puede usarse esta función de gestor de eventos para enviar eventos de clics en enlaces externos a Google Analytics:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href
  });
}

El seguimiento de enlaces y formularios externos puede resultar complicado porque la mayoría de los navegadores dejan de ejecutar el código JavaScript en la página actual cuando se empieza a cargar otra página. Una solución a este problema es definir el campo transport como beacon:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href,
    transport: 'beacon'
  });
}

En el caso de los navegadores que no admiten el método de transporte de emisores beacon, se deberá posponer la navegación a la página siguiente hasta que el evento haya terminado de enviar hits. En la sección Saber cuándo se ha enviado un hit de la guía Enviar datos a Google Analytics se explica más detalladamente cómo hacerlo.

Eventos sin interacción

En algunos casos, es recomendable que envíes un evento como un evento sin interacción. Para ello, define el campo nonInteraction como true en el parámetro fieldsObject del comando send:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign', {
  nonInteraction: true
});

Si quieres obtener más información sobre los hits sin interacción y saber cuándo puedes usarlos, consulta Eventos sin interacción en el Centro de Ayuda de Google Analytics.