En esta página se explica cómo enviar eventos de Google Analytics mediante gtag.js.
Enviar eventos
Para enviar eventos de Google Analytics de una página web a la que se ha añadido 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 |
Valor correspondiente a la acción del evento en los informes "Eventos" de Google Analytics. | |
<category> |
string |
"general" |
Categoría del evento. |
<label> |
string |
Etiqueta del evento. | |
<value> |
number |
Número entero no negativo que corresponde al valor del evento. |
El código siguiente envía un evento con la acción 'aaa'
, la categoría 'bbb'
y la etiqueta 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
Si se omiten las cadenas <category>
o <label>
, se definirán con el valor predeterminado "(not set)"
.
Consulta la anatomía de los parámetros de eventos de Google Analytics para obtener más información sobre cómo interpreta Google Analytics la estructura de los eventos.
Eventos predeterminados de Google Analytics
Debes usar los eventos predeterminados de Google Analytics, que incluyen categorías y etiquetas predeterminadas. Así, tus informes serán más coherentes y podrás usar las nuevas funciones que vayan apareciendo sin problemas.
En la siguiente tabla se muestran los eventos predeterminados de Google Analytics, así como sus categorías y sus tipos de etiqueta predeterminados (si están disponibles). La categoría predeterminada de los nombres de eventos que no aparecen en la tabla (por ejemplo, nombres de eventos arbitrarios que hayas creado) 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 |
Enviar eventos sin interacción
Para enviar un evento sin interacción, asigna el valor true
al parámetro non_interaction
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});