Eventos

En este artículo, se proporciona orientación para migrar eventos de Universal Analytics (UA) a eventos de Google Analytics 4 (GA4).

Dado que los modelos de medición de UA y GA4 son diferentes, te recomendamos que reconsideres la recopilación de datos en función del modelo de GA4, en lugar de trasladar tu estructura de eventos de UA existente a GA4.

Para obtener más información sobre los eventos de GA4, consulta el artículo Acerca de los eventos.

Comparación de los eventos de UA y GA4

Universal Analytics

En el caso de Universal Analytics (UA), la medición se realiza mediante el envío de hits. La mayoría de los tipos de hits se usan para medir interacciones específicas (p.ej., pageview), pero el tipo de hit event está disponible para la medición personalizada o general. Los datos que se envían con un hit event incluyen Categoría, Acción y Etiqueta.

A continuación, se muestran ejemplos de eventos de Universal Analytics para las bibliotecas analytics.js y gtag.js:

analytics.js (UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics 4

En el caso de Google Analytics 4 (GA4), la medición se realiza mediante el envío de eventos. Hay eventos que se recopilan automáticamente, eventos predefinidos y recomendados para que los envíes cuando corresponda, y eventos personalizados que puedes enviar en casos en los que los eventos automáticos o recomendados no se ajusten a tu caso de uso.

El siguiente es un ejemplo de un evento personalizado en GA4:

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

Cómo asignar un evento de UA a GA4

Para migrar un evento de UA a GA4, debes identificar si hay un evento de GA4 equivalente. Para asignar un evento de UA a GA4, utiliza el siguiente enfoque escalonado:

  1. Revisa la lista de eventos recopilados automáticamente. Si un evento recopilado automáticamente de GA4 coincide con el evento de UA, quita el evento de UA y utiliza el evento recopilado automáticamente.

  2. Si no encontraste una coincidencia en el paso anterior, revisa los eventos recopilados a través de la medición optimizada. Si un evento de medición optimizada de GA4 coincide estrechamente con el propósito del evento de UA, no lo migres y, en su lugar, dependas de la medición optimizada para enviarlo. Asegúrate de confirmar que la medición optimizada esté configurada correctamente para que tu propiedad GA4 recopile el evento.

  3. Si no encontraste una coincidencia en el paso anterior, revisa la lista de Eventos recomendados. Si un evento recomendado de GA4 coincide estrechamente con el propósito del evento de UA, utiliza el evento recomendado y configura los parámetros de evento aplicables cuando se envíe el evento.

  4. Si no encontraste una coincidencia en el paso anterior, envía un evento personalizado.

Situaciones y ejemplos de migración

Eventos recopilados automáticamente

Los eventos recopilados automáticamente se envían siempre y, por lo general, no se pueden inhabilitar, a menos que se puedan configurar a través de la medición optimizada. En general, no debes migrar eventos de UA para los que hay un evento recopilado automáticamente lo suficientemente equivalente.

Por ejemplo, es probable que un evento de UA que se envía para medir una interacción de descarga de archivos no necesite migrar a GA4, ya que el evento file_download en GA4 se recopila automáticamente.

Medición optimizada

En general, no es necesario migrar los eventos de UA a GA4 cuando se recopila un evento de GA4 suficientemente equivalente a través de la medición optimizada. Por ejemplo, es probable que los siguientes eventos de UA no deban migrarse a GA4, ya que ya se miden en GA4 a través de la medición optimizada:

Anulación de la medición optimizada

Si un evento de medición optimizada tiene un propósito equivalente al de tu evento de UA, pero no captura todos los datos que necesitas, puedes enviar el evento de forma manual con parámetros personalizados adicionales. Esto requiere que configures o inhabilites la medición mejorada para el evento correspondiente y que envíes el evento de GA4 de forma manual.

Por ejemplo, el evento file_download recopilado a través de la medición optimizada coincide con tu evento de UA, pero falta información sobre el tamaño del archivo. Para anular el evento de medición optimizada e incluir información sobre el tamaño del archivo, haz lo siguiente:

  1. Inhabilita las descargas de archivos en Medición optimizada.
  2. Cuando corresponda, envía de forma manual el evento file_download con parámetros personalizados.
    • Dado que el evento recopilado automáticamente está inhabilitado mediante la medición mejorada, deberás configurar de forma manual los parámetros que normalmente se recopilarían con el evento (p. ej., file_extension, file_name, etcétera).
  3. Crea una dimensión o métrica personalizada para ver los valores de parámetros personalizados en los informes.

El siguiente ejemplo de gtag.js envía un evento file_download de GA4 con un parámetro personalizado file_size.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

Si tu evento de UA tiene un Evento recomendado de GA4 lo suficientemente equivalente , migra tu evento de UA al evento recomendado.

El siguiente ejemplo es un evento de UA de analytics.js para medir un acceso:

ga('send', 'event', 'login', 'google-sso');

El evento login de GA4 se puede utilizar para migrar el evento de UA a GA4. El siguiente es el equivalente de gtag.js de GA4:

gtag('event', 'login', {
  method: 'google-sso'
});

Evento personalizado

Si tu evento de UA no tiene los parámetros Recopilados automáticamente, Medición optimizada o Evento recomendado correspondientes, migra el evento de UA a un evento personalizado y crea Dimensiones y métricas personalizadas según sea necesario.

En el siguiente ejemplo, se muestra un evento de UA de analytics.js que mide los cambios en las opciones de orientación de la IU:

ga('send', 'event', 'orientation', 'layout', 'wide');

No hay ningún evento de GA4 predefinido para medir el evento de UA anterior. En cambio, el siguiente ejemplo de gtag.js muestra cómo se utiliza un evento personalizado para medir la misma interacción en GA4:

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

Para incluir ui_element y configuration en tus informes, deberás crear las dimensiones correspondientes a partir de estos parámetros de eventos. Para obtener más información, consulta Dimensiones y métricas personalizadas.