Рекомендации по наименованию событий Google Analytics 4

События (Events) - один из ключевых компонентов Google Analytics 4. Вокруг событий в новом счетчике строится вся аналитика и происходят различные отслеживания. Именно поэтому вы должны не только уметь настраивать нужные вам события с целью последующего их анализа в стандартных отчетах, Исследованиях и облачном хранилище Google BigQuery, но и придерживаться некоторых правил и рекомендаций по наименованию этих самых событий и параметров событий в Google Analytics 4, о которых я расскажу ниже.

Про события

Как вы уже знаете, в GA4 перешли с традиционной модели Сеансы (Sessions) и Просмотры страниц (Pageviews), которая существовала в Google Analytics с давних времен, на модель данных, управляемую на основе событий (Event-Driven Data Model). Эта модель очень хорошо подходит к аналитике мобильных приложений. Фактически, в приложениях любое действие -> событие. Листаете вы ленту в Facebook / Instagram * / VK, пишите комментарий под постом, загружаете новую фотографию в профиль, добавляете пользователя в черный список, просматриваете видео друга/подруги, отмечаете геолокацию - все это события с точки зрения отслеживания. И здесь нет как таковых сеансов и просмотренных страниц.

* Деятельность американской компании Meta (бывшая Facebook) запрещена в России, организация признана экстремистской.

Тот же самый принцип теперь используется и для веб-сайтов. Все, что вы будете отслеживать, будет являться событием. События в Google Analytics предназначены для отслеживания взаимодействий пользователей с любыми элементами сайта:

• клик по конкретной кнопке;
• отправка формы;
• отправка данных о транзакции;
• отслеживание звонков;
• просмотр видео;
• подписка на рассылку;
• скроллинг страницы;
• пролистывание галереи с фотографиями;
• переключение чек-боксов или любых других элементов;
• клики по иконкам социальных сетей;
• открытие / закрытие всплывающих окон на сайте;
• отслеживание действий в онлайн-консультантах, чатах (JivoSite, Callbackhunter, Venyoo, Talk-Me и т.д.);
• отслеживание событий, которые активируются после определенного времени или действия (например, когда пользователь увел курсор мыши с какого-нибудь объекта);
• и т.д.

Именно поэтому так важно разбираться в этой теме. Перед тем, как вы будете настраивать события на своем сайте, обязательно прочтите эти материалы:

• Введение в события
• Автоматически регистрируемые события
• Улучшенная статистика
• Взаимодействия с формами в улучшенной статистике
• Рекомендуемые события
• Специальные события
• Еще про события Google Analytics 4
• Конверсии в Google Analytics 4

В них подробно разбираются все типы событий, а также даются практические примеры настроек для различных проектов, включая отслеживание конверсий. Также на моем YouTube-канале есть лекция по событиям Google Analytics 4:

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

Типы событий

В Google Analytics 4 можно отслеживать 4 типа событий:

1. автоматически регистрируемые события - события, которые Google собирает автоматически после создания и установки счетчика;
2. улучшенная статистика - дополнительные события, которые Google также собирает автоматически, но при условии, что в настройках ресурса вы включили эту функцию;
3. рекомендуемые события - события, которые уже заложены в систему Google Analytics 4 для различных видов деятельности со стандартными именами и параметрами, прописанные в официальной документации, но которые вам необходимо донастроить под свои задачи;
4. специальные события - события, которые вы создаете самостоятельно под свои нужды.

Нижеприведенные рекомендации в этой статье по наименованию событий и параметров, по большей части, будут относиться именно к последнему типу событий - специальным, поскольку для трех других типов Google самостоятельно отслеживает события и некоторые параметры, у которых уже предопределены имена.

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

Автоматически регистрируемые события (Automatically collected events) - события, которые Google собирает автоматически после создания и установки счетчика. Для их фиксации в GA4 дополнительный код и никаких действий с вашей стороны не требуется.

По умолчанию для всех событий, в том числе специальных, регистрируются параметры, приведенные в официальной справке Google. Таблица очень большая, поскольку содержит события как для сайтов, так и приложений. Поэтому я приложу лишь ее часть.

• ad_click
• ad_exposure
• ad_impression
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_remove
• app_store_refund
• app_store_subscription_cancel
• app_store_subscription_convert
• app_store_subscription_renew
• app_update
• click (для сайта)
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• file_download (для сайта)
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit (для сайта)
• form_start (для сайта)
• form_submit (для сайта)
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• page_view (для сайта)
• screen_view
• scroll (для сайта)
• session_start (для сайта)
• user_engagement (для сайта)
• video_complete (для сайта)
• video_progress (для сайта)
• video_start (для сайта)
• view_search_results (для сайта)

В таблице также представлены события из улучшенной статистики (enhanced measurement) со всеми дополнительными параметрами (столбец Параметры).

Параметры для событий веб-потоков:

• click - link_classes, link_domain, link_id, link_url, outbound;
• file_download - file_extension, file_name, link_classes, link_domain, link_id, link_text, link_url;
• first_visit - page_title, page_location, ga_session_number, ga_session_id;
• form_start - form_id, form_name, form_destination;
• form_submit - form_id, form_name, form_destination, form_submit_text;
• page_view - page_location, page_referrer, engagement_time_msec;
• scroll - percent_scrolled, engagement_time_msec;
• session_start - page_title, page_location, ga_session_number, ga_session_id;
• user_engagement - engagement_time_msec;
• video_complete - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;
• video_progress - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;
• video_start - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;
• view_search_results - search_term, q_[дополнительный_параметр_запроса], unique_search_term.

Как видите, для автоматически регистрируемых событий (automatically collected events) уже есть ряд зарезервированных названий имен и параметров, которые используются при отслеживании. Всех у них есть несколько важных деталей, которые в будущем пригодятся вам для наименования собственных событий:

1. все события и параметры события пишутся строчными/маленькими буквами;
2. между словами в событиях и параметрах нет пробелов -> между ними используется знак подчеркивания;
3. везде используются буквы латинского алфавита;
4. в названиях событий и параметров нет цифр и других символов.

События улучшенной статистики

Улучшенная статистика (Enhanced measurement) - дополнительные события, которые Google собирает автоматически, но после того, как в настройках ресурса вы активируете эту функцию. Она предназначена только для веб-потоков (сайтов).

К событиям улучшенной статистики относятся:

Просмотры страниц

• page_view - page_location, page_referrer, engagement_time_msec;

Прокрутка

• scroll - percent_scrolled, engagement_time_msec;

Исходящие ссылки

• click - link_classes, link_domain, link_id, link_url, outbound;

Поиск по сайту

• view_search_results - search_term, q_[дополнительный_параметр_запроса], unique_search_term.

Взаимодействия с формами

• form_start - form_id, form_name, form_destination;
• form_submit - form_id, form_name, form_destination, form_submit_text;

Взаимодействия с видео

• video_complete - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;
• video_progress - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;
• video_start - video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible;

Скачивание файлов

• file_download - file_extension, file_name, link_classes, link_domain, link_id, link_text, link_url;

По сути, это те же автоматически регистрируемые события, но отслеживаются они только после их активации.

Рекомендуемые события

Рекомендуемые события (Recommended events) - события, которые уже заложены в систему Google Analytics 4 для различных видов деятельности со стандартными именами и параметрами, прописанные в официальной документации Google, но которые вам необходимо донастроить под свои задачи. Другими словами, разработчики позаботились о нас, чтобы мы не думали о том, как назвать событие и какие данные передавать вместе с ним.

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

На момент написания данной статьи в Google все рекомендуемые события делят на три категории:

1. события, которые относятся ко всем ресурсам;
2. для онлайн-торговли;
3. для игр.

Несмотря на то, что в официальной справке Google представлены все события и категории, параметры по ним в таблице отдельным столбцом (как это было для автоматически регистрируемых событий) отсутствуют. По этой причине я рекомендую использовать вам очень простую и полезную утилиту - GA4 Events and Parameters Cheatsheet.

В ней представлен список всех рекомендуемых событий и параметров с подробной расшифровкой каждого из них:

• add_payment_info
• add_shipping_info
• add_to_cart
• add_to_wishlist
• app_open
• begin_checkout
• campaign_details
• earn_virtual_currency
• generate_lead
• join_group
• level_end
• level_start
• level_up
• login
• post_score
• purchase
• refund
• remove_from_cart
• screen_view
• search
• select_content
• select_item
• select_promotion
• share
• sign_up
• spend_virtual_currency
• ad_impression
• tutorial_begin
• tutorial_complete
• unlock_achievement
• view_cart
• view_item
• view_item_list
• view_promotion

Например, выбрав событие share и кликнув по нему, вы увидите перечень доступных параметров, которые можно передавать вместе с ним - method, content_type и item_id.

Аналогично можно посмотреть и другие рекомендуемые события. А чтобы быстро найти нужное событие или параметр, воспользуйтесь поиском в самом верху страницы.

Наименование специальных событий и параметров

Теперь давайте перейдем к наименованию своих собственных событий и параметров в Google Analytics 4. Не знаю, использовали ли вы ранее такой подход или нет, но перед тем, как приступить к настройкам, я обязательно составляю список тех событий, который будут отслеживать, "на бумаге". И обычно для этого использую классические Google Таблицы. В них я прописываю, преимущественно, специальные (пользовательские) события, а не все события, которые будут отслеживаться.

Вот так выглядит таблица с определенным набором событий для одного из моих проектов:

Каждая строка - это отдельное событие (=отслеживание) в Google Analytics 4. В столбцах Название события и Параметры события я заранее задаю имена и значения для каждого параметра, которые буду использовать в настройке. Такой подход обладает рядом преимуществ:

• позволяет сразу видеть общую картину целиком;
• понятен объем выполняемой работы;
• каждое событие и параметр уже имеют свои названия, поэтому во время настройки я не думаю об этом, а просто следую исходным данным;
• сокращается количество ошибок и опечаток в отслеживании, поскольку при множестве настроек могут возникать ситуации, когда интернет-маркетолог на разные события задает одно и то же название или использует один и тот же параметр, хотя должен их переименовывать;
• заказчик (клиент), для которого выполняется работа, сможет самостоятельно "расшифровать" ваши настройки, поскольку у него будет подробный файл с каждым событием и его конфигурацией;
• в случае возникновения каких-то конфликтов и ошибок в отслеживании вы всегда сможете сопоставить то, что было согласовано (в файле) с тем, что фактически было настроено (в Google Tag Manager или напрямую).

Помимо этого, в некоторых компаниях и агентствах существует определенный регламент, согласно которому перед выполнением работы специалист связывается с клиентом и согласует все последующие настройки, включая имена событий и параметров. Правила хорошего тона никто не отменял.

Правильное наименование событий и параметров в Google Analytics 4 очень важно. Ведь как корабль назовете, так он и поплывет (с). Тем более, что при наименовании в GA4 накладывается ряд ограничений, о которых вы должны знать и помнить.

Конечно же, понятие "правильное наименование" - условное. Не существует идеального нейминга событий, впрочем как и неправильного. Но есть некоторые правила, которые позволяют свести количество ошибок в вашем счетчике аналитики к минимуму, и как следствие, улучшить качество сбора данных о ваших пользователях. Используя их, вам будет проще найти причину некорректного отслеживания и выявить неисправности.

Правила именования событий

Вот мы с вами и подошли к заключительной части этого руководства - наименованию событий и параметров в Google Analytics 4. Вернувшись немного назад, вспомните как выглядят автоматически регистрируемые события, рекомендуемые события и события улучшенной статистики. Помните мы нашли у всех них схожие паттерны при написании?

• все события и параметры события пишутся строчными/маленькими буквами;
• между словами в событиях и параметрах нет пробелов -> между ними используется знак подчеркивания;
• везде используются буквы латинского алфавита;
• в названиях событий и параметров нет цифр и других символов.

Фактически, это и есть основные правила, которых сам Google рекомендует придерживаться. Но есть и несколько других рекомендаций, о которых вы то же должны помнить. Итак, давайте по порядку.

Используйте нижний регистр написания

Названия событий чувствительны к регистру. Например, события otpravka_formi и Otpravka_Formi - это два разных события для Google Analytics 4, статистика которых будет отслеживаться по отдельности:

Поэтому для соблюдения принципа единства используйте нижний регистр, тем более, что остальные типы событий (автоматические, рекомендуемые и улучшенная статистика) отслеживаются так же.

Нельзя использовать зарезервированные префиксы и названия

В официальной справке Google представлен список зарезервированных префиксов и названий событий для сайтов и мобильных приложений (iOS, Android), которые вы не можете использовать. Он не является исчерпывающим и может периодически обновляться. Ниже представлен список для веб-потоков (сайтов) на момент публикации этого материала.

Зарезервированные названия событий

• app_remove
• app_store_refund
• app_store_subscription_cancel
• app_store_subscription_renew
• click
• error
• file_download
• first_open
• first_visit
• form_start
• form_submit
• in_app_purchase
• page_view
• scroll
• session_start
• user_engagement
• view_complete
• vide_progress
• video_start
• view_search_results

Зарезервированные названия параметров

Эти названия параметров зарезервированы, и вы не можете их использовать:

• engagement_time_msec
• gclid
• session_id
• session_number

Также названия параметров не могут начинаться со следующих префиксов:

• _ (символ подчеркивания)
• firebase_
• ga_
• google_
• gtag.

Зарезервированные названия свойств пользователей

Эти названия свойств пользователей зарезервированы, и вы не можете их использовать:

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

Также названия свойств пользователей не могут начинаться со следующих префиксов:

• _ (символ подчеркивания)
• firebase_
• ga_
• google_

Названия событий должны начинаться с буквы

Google просит вас придерживаться правила, при котором названия событий должны начинаться с буквы. Но если вы свое событие назовете 1form_send (с цифрой в самом начале), то при отладке события в режиме реального времени или в инструменте DebugView вы не заметите никаких странностей и не увидите никаких ошибок. Событие будет фиксироваться корректно:

Несмотря на это, я не рекомендую полагаться на авось и не соблюдать правило Google Analytics 4 при сборе данных. Оно может быть применено в любой момент, и тогда ваши отслеживания перестанут работать. Следуя простым рекомендациям Google, вы обеспечите безопасность сбора данных и их верного отображения в интерфейсе GA4.

Название события form_send1 (цифра в конце), form1_send (в середине ) или даже второй по счету после буквы f1orm_send будет являться корректным.

Не используйте пробелы в названиях

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

Есть вероятность, что при выгрузке данных событий с пробелами по API (Data API), вы будете получать ответ с ошибкой INVALID_ARGUMENT: ... names must only contain letters, numbers, or _

Чтобы не было проблем в работе с Google Analytics 4, выгрузкой данных по API, экспортом статистики в Google BigQuery, построении отчетности и создании Исследований, в названиях событий и параметров используйте только буквы, цифры и символы подчеркивания.

Например, если ваше событие состоит из нескольких слов, например, click po knopke, то самыми лучшими вариантами написания будут являться эти два:

1. вместо пробелов использовать символ подчеркивания -> click_po_knopke;
2. вместо пробелов использовать верблюжью нотацию (сamel case, camelCase) -> clickPoKnopke;

Первое слово пишется со строчной буквы, следующие - с заглавной, разделителей между составными частями нет. Торчащие посреди итогового названия заглавные буквы напомнили кому-то горбы верблюда - так возникло название нотации.

На самом деле, замена пробелов подчеркиванием - это тоже один из вариантов нотации в программировании. Она называется змеиной (snake case, snake-case). Слова разделяются символами подчеркивания - они как бы ползут по строке, в результате получается длииинное, как змея, название.

Примечание: Бонита Шариф и ее коллеги по университету Кент провели исследование, в котором показали, что имена, разделенные подчеркиваниями, быстрее распознаются. Чтобы это доказать, ученые записывали движения глаз участников эксперимента, пока те читали названия в разных нотациях. Подробнее об этом читайте по ссылке.

Я в своих проектах использую как змеиную, так и верблюжью нотации для событий и параметров событий.

Не используйте кириллицу без необходимости

Хоть в Google Analytics 4 и заложена возможность использования слов и букв английского и других языков, я рекомендую придерживаться простого правила - языка оригинала. Google - международная компания со штаб-квартирой в США. Английский язык является международным стандартом в IT-сфере, и разработки ведутся в основном именно на этом языке. Все типы, функции, методы являются английскими фразами, словами или сокращениями. Каждый язык программирования имеет свой алфавит и словарь, свой синтаксис и семантику.

Сам Google Analytics 4 - это сервис, который собирает статистику посетителей вашего веб-сайта с помощью кода, размещенного на отслеживаемых страницах. Этот код написан на языке программирования JavaScript. Следовательно, английский язык является основным и приоритетным. Вы можете не знать языка и никто не будет просить писать вас слова на английском языке, но использование латинского алфавита позволит снизить ошибки в вашем ресурсе GA4 к минимуму.

Например, вместо click_button можно просто написать klik_knopka. Это будет правильнее, чем событие на кириллице клик_кнопка. К тому же, в Google Analytics 4 есть ограничение на количество символов - оно одинаково для языков с однобайтовыми (например, английский) и двухбайтовыми (например, японский) символами. При оценке ограничения на количество символов учитывается длина (количество символов) закодированного URL.

Не используйте эмодзи и другие спецсимволы

Да, Universal Analytics и Google Analytics 4 поддерживает отображение эмодзи. Например, я некоторое время забавы ради передавал событие с эмодзи 🧡 в Google Analytics. Вот как оно отображалось в Universal Analytics в отчете по событиям:

А вот как отображается это событие в стандартном отчете Google Analytics 4:

Аналогично и в Исследовании. Тоже самое это может касаться и спецсимволов, например, + в названии события:

Точно также, как и с цифрой в начале, Google будет фиксировать событие корректно. Но нет никаких гарантий, что в какой-то момент это не сломается. Поэтому просто не используйте эмодзи и специальные символы в своих событиях (%, /, !, ?, ;, + и т.д.)

Не называйте событие и параметр события одним именем

Не называйте событие и параметр события одним именем, чтобы не запутаться. Например, если вы хотите отследить событие click_po_knopke и в параметрах события передать местоположение этой кнопки на странице (footer, header, center и т.д.), то не нужно называть сам параметр click_po_knopke. Придумайте для параметра другое название, отличное от самого события. Например, mesto_klika или любое другое.

Имена должны быть "говорящими"

Для специального события вы можете прописать любое название, хоть vasya_pupkin. Главное, чтобы потом вы понимали, для каких целей и в каком месте был добавлен этот код на сайт и за что он отвечает. Но если вы работаете не один, в вашем проекте участвует целая команда, или вы потом передадите проект кому-то другому, то позаботьтесь о том, чтобы названия событий и их параметры описывали отслеживаемые действия. Старайтесь использовать названия, соответствующие цели отслеживания.

Если вы отслеживаете клики по кнопкам, то во всех событиях можете использовать префикс click_, а далее уже конкретизировать условие срабатывания. Например, click_po_email, click_po_phone, click_po_akzii, click_po_calculator и т.д.

Осмысленно подходите к вопросу разметки событий в проекте, чтобы другие люди тоже понимали вашу логику и им было проще разобраться в настройках. Поступай с другими так, как хочешь, чтобы поступали с тобой (с). Представьте, что вам дадут проект с минимальным количеством исходных данных, в котором нужно самостоятельно разобраться со списком чужих событий. А у предыдущего исполнителя названия были настроены без какого-либо контекста - forma1, forma2, forma3, knopka1, knopka2, knopka3, podpiska и т.д. А у вас на сайте много разных форм, кнопок и мест с такими элементами. Как вы думаете, будет ли легко разобраться во всем многообразии таких событий? Уверен, что нет. А спросить уже некого. Вот и ищи потом корни и первоисточник... Поменяется команда, подрядчик, вам дадут новый проект с уже готовыми настройками - все может быть.

Не используйте длинные названия событий

После всего вышеописанного у вас может появиться соблазн максимально подробно называть каждое событие и давать ему уникальное имя с использованием подчеркивания, латинского алфавита и букв нижнего регистра. Например, moe_video_so_svadbi_portfolio_moskva

Но и здесь есть свои нюансы. Во-первых, при отладке событий в отчете реального времени или в DebugView события с такими длинными названиями будут отображаться сокращенно. Вы не сможете посмотреть полное название события, пока не наведете на него курсор мыши:

А во-вторых, согласно ограничениям по сбору данных Google Analytics 4, длина названия события не должно превышать 40 символов. Если это ограничение будет нарушено и вы зададите название, превышающее это значение, то Google сам обрежет последние символы, оставив только первые 40.

Например, событие moe_video_so_svadbi_portfolio_moskva_leto имеет 41 символ. Если отправить его в Google Analytics 4, то в интерфейсе вы увидите обрезанное до 40 символов значение, то есть moe_video_so_svadbi_portfolio_moskva_let:

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

Не используйте дефис в названиях событий

Наверняка, вы видели, что в интерфейсе Google Analytics 4 нельзя создать событие-конверсию, в названии которой используется дефис "-". Вы просто не сможете сохранить ее. Google выдаст вам ошибку - Входные данные могут содержать только буквы, цифры и символы подчеркивания (_):

Но в самих событиях символ дефиса допустим, и в разделе События у вас есть возможность отметить такое событие как конверсию, просто изменив переключатель в положение ВКЛ.

Таким образом, это может ввести вас в заблуждение и привести к дальнейшим трудностям. Я рекомендую вообще не использовать дефис "-" в названиях событий Google Analytics 4, а использовать вместо него символ подчеркивания _. Иначе у вас не получится выгрузить данные по конверсиям с помощью API. Причем длина названия события должна быть не более 40 символов. Если она будет больше, событие не будет регистрироваться как конверсия, потому что в название не будет добавляться дополнительная конструкция с символами _c.

Следите за ограничениями сбора данных от Google

В Google Analytics 4 не регистрируются события, параметры событий и свойства пользователей, которые превышают установленные ограничения:

• уникальные названия событий - до 500 на пользователя в день (для потока данных приложения). Например, если пользователи запускают разные события в разных экземплярах приложения, вы можете увидеть 700 разных имен событий. К веб-потокам (сайтам) ограничения на количество названий событий не применяются. Эти ограничения не распространяются на автоматически регистрируемые события и события улучшенной статистики;
• длина названия события - до 40 символов. Если в названии больше 40 символов, событие не будет регистрироваться как конверсия (если вы пометите его как таковую), потому что в название не будет добавляться _c;
• количество передаваемых параметров в событии - до 25;
• длина названия параметра события - до 40 символов;
• длина значения параметра события - до 100 символов;
• длина имени свойства пользователя - до 25 символов;
• длина значения свойства пользователя - до 36 символов;
• длина значения User-ID - до 256 символов;
• длина параметра page_location (адреса страницы) - до 1000 символов;
• длина параметра page_referrer - до 420 символов.