События

Из этой статьи вы узнаете, как переносить события из 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 аналог этого события. Рекомендуем использовать поэтапный подход:

  1. Проверьте список автоматически регистрируемых событий. Если в GA4 есть автоматически регистрируемое событие, которое достаточно точно соответствует нужному событию из UA, просто удалите событие UA и используйте автоматически регистрируемое событие.

  2. Если похожее событие не нашлось среди автоматически регистрируемых, проверьте список событий улучшенной статистики в GA4. Если среди них есть событие, достаточно близкое к нужному событию UA, можно использовать его, вместо того чтобы переносить событие из UA. Убедитесь, что улучшенная статистика правильно настроена для вашего ресурса GA4 и событие корректно регистрируется.

  3. Если похожее событие не нашлось среди событий улучшенной статистики, проверьте список рекомендуемых событий. Если среди них есть событие, достаточно близкое к нужному событию UA, можно использовать его, настроив параметры согласно необходимости.

  4. Если похожее событие не нашлось среди рекомендуемых, настройте специальное событие.

Возможные сценарии и примеры переноса событий

Автоматически регистрируемые события

Автоматически регистрируемые события обрабатываются всегда, и их нельзя отключить (кроме событий, настраиваемых через улучшенную статистику). Как правило, нет смысла переносить событие из UA, если среди автоматически собираемых событий есть достаточно близкое по функционалу.

Например, если у вас есть событие UA для отслеживания загрузок файлов, его не нужно переносить в GA4, так как есть автоматически регистрируемое событие file_download.

Улучшенная статистика

Как правило, нет смысла переносить событие из UA, если среди событий расширенной статистики есть достаточно близкое по функционалу. Ниже приведены два примера таких сценариев.

Переопределение событий улучшенной статистики

Если событие улучшенной статистики предназначено для тех же целей, что и ваше событие UA, но оно собирает не все нужные вам данные, вы можете переопределить его, вручную добавив специальные параметры. Для этого нужно отключить событие улучшенной статистики и вручную настроить отправку этого события в GA4.

Допустим, событие file_download из улучшенной статистики передает те же данные, что и ваше событие UA, кроме одного важного для вас параметра – размера файла. Чтобы переопределить событие улучшенной статистики, добавив в него размер файла, выполните следующие действия:

  1. Отключите событие Загрузка файлов в улучшенной статистике.
  2. Вручную реализуйте отправку события file_download со специальными параметрами.
    • Поскольку автоматически регистрируемое событие отключено в настройках улучшенной статистики, вам нужно вручную задать все параметры события, которые иначе обрабатывались бы автоматически (например, file_extension, file_name и т. д.).
  3. Создайте специальные параметры и показатели для всех данных, которые вы хотите включить в отчеты.

В приведенном ниже примере для 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 появлялись в отчетах, необходимо создать соответствующие специальные параметры. Подробнее о специальных параметрах и показателях