En esta página, se explica cómo usar 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. |
El siguiente envío 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 predeterminados de Google Analytics, que tienen categorías y etiquetas predefinidas. El uso de estos eventos facilita los informes y la interoperabilidad coherentes con funciones futuras.
En la siguiente tabla, se enumeran los eventos predeterminados de Google Analytics, sus categorías
predeterminadas y los tipos de etiquetas predeterminados (si están disponibles). Para los nombres de eventos que no aparecen en esta tabla (p.ej., 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 predeterminado |
---|---|---|
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
});