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