En esta página, se explica cómo usar la etiqueta gtag.js para enviar eventos de Google Analytics.
Enviar eventos
Para enviar eventos de Google Analytics a una página web donde se agregó la etiqueta de Google, usa el comando event
de gtag.js con la siguiente sintaxis:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
Nombre | Tipo | Valor predeterminado | Descripción |
---|---|---|---|
<action> |
string |
Es el valor que aparecerá como la acción del evento en los informes de eventos de Google Analytics. | |
<category> |
string |
"general" |
Es la categoría del evento. |
<label> |
string |
La etiqueta del evento. | |
<value> |
number |
Es un número entero no negativo que aparecerá como el valor del evento. |
A continuación, se envía un evento con una acción de 'aaa'
, una categoría de 'bbb'
y una etiqueta de 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
Si se omiten <category>
o <label>
, se establecerán en los valores predeterminados de "(not set)"
.
Consulta la anatomía de los parámetros de eventos de Google Analytics para obtener más información sobre cómo Google Analytics interpreta la estructura de los eventos.
Eventos predeterminados de Google Analytics
Debes usar los eventos de Google Analytics predeterminados, que tienen categorías y etiquetas predefinidas. El uso de estos eventos facilita la generación de informes y la interoperabilidad con funciones futuras.
En la siguiente tabla, se enumeran los eventos predeterminados de Google Analytics, sus categorías
y los tipos de etiquetas predeterminadas (si están disponibles). Para los nombres de eventos que no aparecen en esta tabla (p.ej., los nombres de eventos arbitrarios que creas), la categoría predeterminada es "engagement"
y la etiqueta predeterminada es "(not set)"
.
Nombre del evento | Categoría predeterminada | Tipo de etiqueta predeterminada |
---|---|---|
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 |
Envía eventos sin interacción
Para enviar un evento sin interacción, establece el parámetro non_interaction
en true
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});