Eventos

En este artículo se explica cómo migrar eventos de Universal Analytics (UA) a eventos de Google Analytics 4 (GA4).

Como los modelos de medición de UA y GA4 son distintos, te recomendamos que te replantees la recogida de datos según el modelo de GA4 en lugar de trasladar tu estructura de eventos de UA a GA4.

Consulta más información sobre los eventos de GA4 en el artículo Acerca de Eventos.

Comparación entre los eventos de UA y de GA4

Universal Analytics

En el caso de UA, las mediciones se hacen enviando hits a Analytics. La mayoría de los tipos de hit se usan para medir interacciones específicas (por ejemplo, pageview), pero el tipo de hit event está disponible para hacer mediciones personalizadas o generales. Entre los datos que se envían con cada hit event se incluyen la categoría, la acción y la etiqueta.

A continuación, se muestran ejemplos de eventos de UA para las bibliotecas de 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 GA4, las mediciones se hacen enviando eventos a Analytics. Hay eventos que se registran automáticamente, eventos predefinidos y recomendados para que los envíes cuando corresponda, y eventos personalizados que puedes enviar cuando ni los eventos automáticos ni los recomendados se ajusten a tus necesidades.

A continuación, se muestra un ejemplo de un evento personalizado en GA4:

gtag.js (GA4)

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

Cambiar un evento de UA a GA4

Para migrar un evento de UA a GA4, debes determinar si hay un evento de GA4 equivalente. Para hacer la migración, sigue los pasos que se indican a continuación:

  1. Consulta la lista de eventos registrados automáticamente. Si un evento de GA4 registrado automáticamente es muy similar al evento de UA que quieres migrar, quita el evento de UA y usa el de GA4.

  2. Si no encuentras ningún evento adecuado en el paso anterior, consulta los eventos que se registran a través de la medición mejorada. Si encuentras un evento de GA4 que tenga un objetivo muy similar al del evento de UA, no migres el evento de UA. En su lugar, usa la medición mejorada para enviar el evento a Analytics. Asegúrate de que la medición mejorada esté configurada correctamente para que la propiedad GA4 recoja el evento.

  3. Si no encuentras ningún evento adecuado en el paso anterior, consulta la lista de eventos recomendados. Si el objetivo de un evento recomendado de GA4 es muy similar al del evento de UA, usa ese evento recomendado y define los parámetros de evento que se deben aplicar al enviarlo.

  4. Si no encuentras ningún evento de GA4 adecuado en el paso anterior, envía un evento personalizado.

Casos prácticos y ejemplos de migración

Eventos registrados automáticamente

Los eventos registrados automáticamente siempre se envían a Analytics y, por lo general, no se pueden inhabilitar, a menos que se puedan configurar mediante la medición mejorada. En general, no debes migrar eventos de UA que tengan un evento registrado automáticamente equivalente.

Por ejemplo, no sería necesario migrar a GA4 un evento de UA que se use para medir las interacciones de descarga de archivos, ya que el evento file_download de GA4 se recoge automáticamente.

Medición mejorada

En general, no tienes que migrar eventos de UA equivalentes a eventos de GA4 que se recojan a través de la medición mejorada. Por ejemplo, no sería necesario migrar los eventos de UA siguientes porque ya se registran en GA4 mediante la medición mejorada:

Anulación de la medición mejorada

Si un evento de medición mejorada tiene un objetivo equivalente al de tu evento de UA, pero no registra todos los datos que necesitas, puedes enviarlo manualmente con parámetros personalizados adicionales. Para ello, debes configurar o inhabilitar la medición mejorada en el evento correspondiente y enviar manualmente el evento de GA4.

Por ejemplo, el evento file_download que se recoge a través de la medición mejorada es muy similar a tu evento de UA, pero le falta información sobre el tamaño del archivo. Para anular el evento de medición mejorada e incluir información sobre el tamaño del archivo, haz lo siguiente:

  1. Inhabilita la opción Descargas de archivos en Medición mejorada.
  2. Cuando sea necesario, envía manualmente el evento file_download con parámetros personalizados.
    • Como el evento registrado automáticamente estará inhabilitado a través de la medición mejorada, deberás configurar de forma manual todos los parámetros cuyos valores suelen recogerse con el evento (por ejemplo, file_extension o file_name).
  3. Crea una dimensión/métrica personalizada para ver los valores de los parámetros personalizados en los informes.

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

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 hay un evento recomendado de GA4 equivalente a tu evento de UA, migra el de UA al recomendado.

En el siguiente ejemplo se muestra un evento de UA de analytics.js que se usa para medir los inicios de sesión:

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

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

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

Eventos personalizados

Si tu evento de UA no tiene un evento recogido automáticamente, de medición mejorada o recomendado equivalente, mígralo 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 interfaz de usuario:

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

No hay ningún evento de GA4 predefinido que mida ese evento de UA. En el siguiente ejemplo de gtag.js se muestra cómo usar 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 los informes, tendrás que crear las dimensiones correspondientes a partir de estos parámetros de evento. Consulta más información en el artículo Dimensiones y métricas personalizadas.