Из этой статьи вы узнаете, как переносить события из Universal Analytics в Google Аналитику 4.
Поскольку в UA и GA4 используются разные модели обработки данных, рекомендуем спроектировать новую схему сбора данных с учетом особенностей модели GA4, а не переносить существующую структуру событий из UA в GA4.
Подробнее о событиях GA4…
Сравнение событий UA и GA4
Universal Analytics
В Universal Analytics (UA) сбор данных обеспечивается за счет отправки обращений.
Многие типы обращений используются для отслеживания конкретных типов взаимодействий (например, pageview
– для отслеживания просмотров страниц). Однако с помощью типа обращения event
(событие) можно реализовать сбор произвольных данных. Вместе с обращением event
отправляются в том числе следующие данные: Category (категория), Action (действие) и Label (ярлык).
Ниже приведены примеры событий Universal Analytics с использованием библиотек analytics.js и gtag.js.
analytics.js (UA)
// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');
// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
hitType: 'event',
eventCategory: 'Settings',
eventAction: 'Enable',
eventLabel: 'Dark mode'
});
gtag.js (UA)
gtag('event', 'Enable', {
event_category: 'Settings',
event_label: 'Dark mode'
});
Google Аналитика 4
В Google Аналитике 4 (GA4) сбор данных обеспечивается за счет отправки событий. Есть три категории событий: автоматически регистрируемые (то есть включенные по умолчанию), рекомендуемые (их можно включать при необходимости), и специальные, которые вы можете настраивать сами, если стандартные события не отвечают всем потребностям вашего бизнеса.
Ниже приведен пример специального события в GA4.
gtag.js (GA4)
gtag('event', 'settings_update', {
setting: 'mode',
status : 'dark'
});
Сопоставление событий из UA и GA4
Чтобы перенести событие из UA в GA4, нужно определить, есть ли в GA4 аналог этого события. Рекомендуем использовать поэтапный подход:
Проверьте список автоматически регистрируемых событий. Если в GA4 есть автоматически регистрируемое событие, которое достаточно точно соответствует нужному событию из UA, просто удалите событие UA и используйте автоматически регистрируемое событие.
Если похожее событие не нашлось среди автоматически регистрируемых, проверьте список событий улучшенной статистики в GA4. Если среди них есть событие, достаточно близкое к нужному событию UA, можно использовать его, вместо того чтобы переносить событие из UA. Убедитесь, что улучшенная статистика правильно настроена для вашего ресурса GA4 и событие корректно регистрируется.
Если похожее событие не нашлось среди событий улучшенной статистики, проверьте список рекомендуемых событий. Если среди них есть событие, достаточно близкое к нужному событию UA, можно использовать его, настроив параметры согласно необходимости.
Если похожее событие не нашлось среди рекомендуемых, настройте специальное событие.
Возможные сценарии и примеры переноса событий
Автоматически регистрируемые события
Автоматически регистрируемые события обрабатываются всегда, и их нельзя отключить (кроме событий, настраиваемых через улучшенную статистику). Как правило, нет смысла переносить событие из UA, если среди автоматически собираемых событий есть достаточно близкое по функционалу.
Например, если у вас есть событие UA для отслеживания загрузок файлов, его не нужно переносить в GA4, так как есть автоматически регистрируемое событие file_download
.
Улучшенная статистика
Как правило, нет смысла переносить событие из UA, если среди событий расширенной статистики есть достаточно близкое по функционалу. Ниже приведены два примера таких сценариев.
- Событие UA для отслеживания исходящих кликов эквивалентно событию
click
в GA4. - Событие UA для отслеживания загрузок файлов эквивалентно событию
file_download
в GA4.
Переопределение событий улучшенной статистики
Если событие улучшенной статистики предназначено для тех же целей, что и ваше событие UA, но оно собирает не все нужные вам данные, вы можете переопределить его, вручную добавив специальные параметры. Для этого нужно отключить событие улучшенной статистики и вручную настроить отправку этого события в GA4.
Допустим, событие file_download
из улучшенной статистики передает те же данные, что и ваше событие UA, кроме одного важного для вас параметра – размера файла. Чтобы переопределить событие улучшенной статистики, добавив в него размер файла, выполните следующие действия:
- Отключите событие Загрузка файлов в улучшенной статистике.
- Вручную реализуйте отправку события
file_download
со специальными параметрами.- Поскольку автоматически регистрируемое событие отключено в настройках улучшенной статистики, вам нужно вручную задать все параметры события, которые иначе обрабатывались бы автоматически (например,
file_extension
,file_name
и т. д.).
- Поскольку автоматически регистрируемое событие отключено в настройках улучшенной статистики, вам нужно вручную задать все параметры события, которые иначе обрабатывались бы автоматически (например,
- Создайте специальные параметры и показатели для всех данных, которые вы хотите включить в отчеты.
В приведенном ниже примере для gtag.js реализована отправка события file_download
со специальным параметром file_size
в Google Аналитику 4.
gtag('event', 'file_download', {
file_extension: '.mp4',
file_name: 'tutorial.mp4',
link_url: '/videos/tutorial.mp4',
link_text: 'Download the tutorial!',
// Custom parameter.
file_size: '275 MB'
});
Рекомендуемое событие
Если среди рекомендуемых событий GA4 есть достаточно близкий эквивалент вашего события из UA, перейдите с события UA на рекомендуемое событие.
Ниже приведен пример события UA на базе analytics.js для отслеживания входов в аккаунты.
ga('send', 'event', 'login', 'google-sso');
Вместо него можно использовать эквивалентное событие login
из GA4, определив его следующим образом:
gtag('event', 'login', {
method: 'google-sso'
});
Специальное событие
Если среди автоматически регистрируемых, событий улучшенной статистики и рекомендуемых не нашлось достаточно близкого эквивалента вашему событию UA, перенесите его в специальное событие и создайте нужные вам специальные параметры и показатели.
Ниже приведен пример события UA на базе analytics.js для отслеживания изменений ориентации пользовательского интерфейса.
ga('send', 'event', 'orientation', 'layout', 'wide');
Среди стандартных событий GA4 нет близкого аналога. Однако можно реализовать специальное событие, которое будет передавать нужную информацию в GA4, как показано в следующем примере для gtag.js:
gtag('event', 'orientation_update', {
ui_element: 'layout',
configuration: 'wide'
});
Чтобы значения переменных ui_element
и configuration
появлялись в отчетах, необходимо создать соответствующие специальные параметры. Подробнее о специальных параметрах и показателях…