Отслеживание событий Google Analytics | Google Analytics для сайтов (gtag.js)

В этом руководстве описывается, как применять тег gtag.js для отправки событий в Google Analytics.

Отправка событий

Для отправки событий с веб-страницы, на которую добавлен код отслеживания, используйте следующие настройки команды event:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});

<action> – это строка, которая указывается в отчетах Google Analytics как действие по событию.
<category> – категория события.
<label> – ярлык события.
<value> – ценность события, выраженная целым неотрицательным числом.

Пример ниже активирует событие Google Analytics с действием xyz, категорией по умолчанию general и ярлыком по умолчанию (not set).

gtag('event', 'xyz');

Вы можете переопределить значения по умолчанию, задав в коде собственные. Пример ниже активирует событие Google Analytics с действием aaa, категорией по умолчанию bbb и ярлыком по умолчанию ccc.

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

Подробную информацию о компонентах событий Google Analytics ("Категория", "Действие", "Ярлык" и "Значение") вы найдете здесь.

События Google Analytics по умолчанию

Как правило, вам необходимо использовать события Google Analytics по умолчанию, для которых уже заданы категории и ярлыки. Это обеспечивает единообразие данных в отчетах и поддержку новых функций в будущем.

Пример ниже активирует событие Google Analytics с действием login, категорией по умолчанию engagement и ярлыком по умолчанию Google.

gtag('event', 'login', { method : '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
});