На этой странице объясняется, как использовать gtag.js для отправки событий Google Analytics .
Отправить события
Чтобы отправить события Google Analytics на веб-страницу, на которую добавлен тег Google , используйте команду event
gtag.js со следующим синтаксисом:
gtag('event', <action>, {
'event_category': <category>,
'event_label': <label>,
'value': <value>
});
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
<action> | string | Значение, которое будет отображаться как действие события в отчетах о событиях Google Analytics. | |
<category> | string | "general" | Категория события. |
<label> | string | Метка события. | |
<value> | number | Неотрицательное целое число, которое будет отображаться в качестве значения события. |
Следующее отправляет событие с действием 'aaa'
, категорией 'bbb'
и меткой 'ccc'
:
gtag('event', 'aaa', {
'event_category' : 'bbb',
'event_label' : 'ccc'
});
Если <category>
или <label>
опущены, для них будут установлены значения по умолчанию "(not set)"
.
См. анатомию параметров событий Google Analytics для получения дополнительной информации о том, как структура событий интерпретируется Google Analytics.
События Google Analytics по умолчанию
Вы должны использовать события Google Analytics по умолчанию, которые имеют предустановленные категории и ярлыки. Использование этих событий обеспечивает согласованную отчетность и совместимость с будущими функциями.
В следующей таблице перечислены события Google Analytics по умолчанию, их категории по умолчанию и типы ярлыков по умолчанию (если они доступны). Для имен событий, не перечисленных в этой таблице (например, произвольные имена событий, которые вы создаете), категория по умолчанию — "engagement"
, а метка по умолчанию — "(not set)"
.
Название события | Категория по умолчанию | Тип метки по умолчанию |
---|---|---|
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 |
Отправка событий без взаимодействия
Чтобы отправить событие невзаимодействия , установите для параметра non_interaction
значение true
:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});