Hacer el seguimiento de eventos con gtag.js

En esta guía se explica cómo enviar eventos a Google Analytics con gtag.js.

Obtén más información sobre los eventos de Google Analytics.

Enviar eventos

Para enviar eventos de una página web a la que se ha añadido el fragmento de seguimiento, utiliza el comando event siguiente:

gtag('event', 'event_name', {
  // Event parameters
  'parameter_1': 'value_1',
  'parameter_2': 'value_2',
  // ...
});

En este fragmento, event_name puede ser uno de estos dos elementos:

  1. Un evento recomendado, asociado a los parámetros recomendados
  2. Un evento personalizado, asociado a los parámetros personalizados

Por ejemplo, el siguiente código permite registrar el evento que indica que un usuario ha iniciado sesión en una cuenta de Google:

gtag('event', 'login', {'method': 'Google'});

Al enviar eventos a Google Analytics, puedes indicar los grupos o las propiedades que los recibirán. Para obtener más información, consulta Especificar los grupos y las propiedades que recibirán los datos.

Parámetros de evento

Los eventos de Google Analytics incluyen los parámetros siguientes:

Nombre del parámetro Tipo de valor Obligatorio Descripción
event_category string No Categoría a la que pertenece el evento (p. ej., engagement)
event_action string Tipo de interacción (p. ej., login); el valor predeterminado event_action es event_name
event_label string No Información adicional del evento (p. ej., article; el tipo de contenido seleccionado)
value integer No Valor numérico positivo asociado al evento (p. ej., 42)

Para obtener una descripción detallada de estos parámetros, consulta Anatomía de los eventos.

El código de seguimiento gtag.js proporciona valores predeterminados de las categorías y de las etiquetas de evento de Google Analytics. Por ejemplo, si envías el siguiente evento:

gtag('event', 'login');

la categoría del evento es engagement, la acción es login y la etiqueta, (not set).

Para anular la categoría y la etiqueta de evento predeterminadas de Google Analytics, proporciona los valores de los parámetros event_category y event_label:

gtag('event', 'event_name', {
  'event_category': categoryName,
  'event_label': labelName
});

Por ejemplo, con el código siguiente se envía el evento login a Google Analytics. La categoría del evento se define con el valor access y la etiqueta del evento con el valor Google:

gtag('event', 'login', {
  'event_category': 'access',
  'event_label': 'Google'
});

Categorías y etiquetas de evento predeterminadas de Google Analytics

En la tabla siguiente se enumeran las categorías y las etiquetas de evento predeterminadas. El nombre del evento es el valor predeterminado de la acción del evento.

Nombre de evento Categoría predeterminada Etiqueta predeterminada (parámetro de evento)
add_payment_info ecommerce  
add_to_cart ecommerce  
add_to_wishlist ecommerce  
begin_checkout ecommerce  
checkout_progress ecommerce  
generate_lead engagement  
login engagement method
purchase ecommerce  
refund ecommerce  
remove_from_cart ecommerce  
search engagement search_term
select_content engagement content_type
set_checkout_option ecommerce  
share engagement method
sign_up engagement method
view_item engagement  
view_item_list engagement  
view_promotion engagement  
view_search_results engagement search_term

El código de seguimiento gtag.js incluye un modelo de eventos y parámetros que proporciona informes detallados, y con el que podrás beneficiarte de futuras funciones e integraciones a medida que estén disponibles. Te recomendamos que implementes los eventos siguientes, según proceda, con los parámetros correspondientes.

Evento Parámetros
add_payment_info
add_to_cart value, currency, items
add_to_wishlist value, currency, items
begin_checkout value, currency, items, coupon
checkout_progress value, currency, items, coupon
exception description, fatal
generate_lead value, currency, transaction_id
login method
page_view  
purchase transaction_id, value, currency, tax, shipping, items
refund transaction_id, value, currency, tax, shipping, items
remove_from_cart value, currency, items
screen_view screen_name
search search_term
select_content content_type, items, promotions
set_checkout_option checkout_step, checkout_option
share method, content_type, content_id
sign_up method
timing_complete name, value
view_item items
view_item_list items
view_promotion promotions
view_search_results search_term

En la tabla siguiente se enumeran los parámetros recomendados de los eventos recomendados:

Parámetro de evento Tipo de datos Descripción Valor de ejemplo
affiliation string Tienda o afiliación en la que se ha producido esta transacción 'example.com'
checkout_option string Opción de pago 'VISA'
checkout_step number Paso (representado mediante un número) del proceso de tramitación de compra 2
content_type string Tipo de contenido seleccionado 'vehicle'
currency string Moneda de compra en el formato estándar ISO_4217 de tres letras 'USD'
items array Matriz de objetos item
promotions array Matriz de objetos promotion
shipping currency Coste del envío '4.95'
method string Método utilizado para registrarse 'Facebook'
tax currency Importe de los impuestos '2.45'
transaction_id string ID único de la transacción 'T12345'
value number Valor (es decir, ingresos) asociado al evento 22

Parámetros de artículo

En la tabla siguiente se enumeran los parámetros recomendados de los artículos que se venden en tiendas online:

Parámetro de artículo Tipo de datos Descripción Valor de ejemplo
id string ID o SKU únicos del artículo 'P12345'
name string Nombre del artículo 'Android Warhol T-Shirt'
brand string Marca del artículo 'Google'
category string Categoría del artículo 'Apparel/T-Shirts'
coupon string Código de cupón del artículo que está a la venta 'SUMMER_FUN'
price currency Precio de compra del artículo '29.20'
quantity integer Cantidad de artículos 2
variant string Variante del artículo 'Black'
creative_name string Nombre de la creatividad utilizada 'summer_banner_2'
creative_slot string Nombre del espacio de la creatividad 'banner_slot_1'
list_name string Lista en la que se ha mostrado el artículo al usuario 'Search Results'
list_position integer Posición del artículo en la lista 4
origin string Origen del artículo (viajes) 'LHR'
destination string Destino del artículo (viajes) 'CDG'
start_date string Fecha de inicio según el formato estándar de calendario ISO 8601 (viajes) '20150931'
end_date string Fecha de finalización según el formato estándar de calendario ISO 8601 (viajes) '20150931'

Parámetros de promoción

En la tabla siguiente se enumeran los parámetros recomendados de una campaña de promoción:

Parámetro de promoción Tipo de datos Descripción Valor de ejemplo
id string ID de promoción 'promotion8'
name string Nombre de la promoción '20% discount'
creative_name string Nombre de la creatividad utilizada 'summer_banner_2'
creative_slot string Nombre del espacio de la creatividad 'banner_slot_1'

Eventos y parámetros personalizados

Además de los eventos recomendados, puedes usar gtag.js para registrar un evento personalizado con los parámetros asociados de cualquier acción que se produzca en una página web. Por ejemplo, podrías registrar este evento cuando los usuarios se registren para recibir tu boletín informativo:

gtag('event', 'newsletter_opt_in', {'value': 3});

Parámetros personalizados

Puedes añadir datos personalizados en forma de parámetros adicionales a cualquier evento (ya sea recomendado o personalizado). Por ejemplo, para hacer el seguimiento de los tipos de cuentas de los usuarios como parte del evento sign_up, podrías registrar el evento con este código:

gtag('event', 'sign_up', {
  'method': 'google',
  'account_type': 'basic'
});

Si, por ejemplo, deseas capturar los eventos del reproductor de vídeo de tu sitio web, podrías registrar un evento personalizado con este código:

gtag('event', 'video_play', {
  'video_title': 'My promotional video',
  'duration': '01:32'
});

Enviar eventos sin interacción

En algunos casos, es recomendable enviar los eventos como eventos sin interacción. Para ello, define el parámetro non_interaction con el valor true:

gtag('event', 'video_play', {
  'video_title': 'My promotional video',
  'duration': '01:32',
  'non_interaction': true
});

Si deseas obtener más información sobre los eventos sin interacción y cuándo deben enviarse, consulta Eventos sin interacción.