Интеграция с Google Analytics 4

Какие события отправляет Vakas-tools

В интеграции доступны три действия. Их достаточно, чтобы передавать основные результаты воронки и отдельные серверные события без собственного запроса к Measurement Protocol.

Для покупки используйте стабильный transaction_id: один и тот же платёж должен получать один и тот же идентификатор. GA4 использует этот параметр, чтобы не учитывать повторную отправку той же покупки как новую, но дубли также нужно контролировать в самом сценарии.

Как работает серверная передача

Событие в исходном сервисе → правило Vakas-tools → Measurement Protocol → веб-поток GA4

Для запроса нужны несколько реквизитов и идентификаторов:

• Measurement ID определяет поток данных GA4 и имеет формат G-…;
• API Secret разрешает серверную отправку через Measurement Protocol;
• client_id указывает экземпляр пользователя и помогает связать событие с браузерной активностью;
• user_id можно передать дополнительно, если проект использует собственный идентификатор авторизованного пользователя.

client_id должен происходить из тега Google Analytics на сайте. Если передать случайное или заново созданное значение, событие может попасть в GA4, но связь с исходным сеансом и источником трафика будет ограничена.

Что потребуется для подключения

1. Ресурс GA4 и настроенный веб-поток.
2. Measurement ID нужного потока.
3. API Secret, созданный в настройках Measurement Protocol.
4. Тег GA4 или Google Tag Manager на сайте.
5. Доступный client_id, если серверное событие нужно связать с онлайн-сеансом.
6. Правило Vakas-tools с выбранным действием и сопоставленными параметрами.

Measurement Protocol дополняет сбор через тег GA4, Google Tag Manager или Firebase. Google не рекомендует использовать протокол как полную замену клиентского сбора.

API Secret нужно хранить как пароль: не вставляйте его в публичный код, инструкции или скриншоты. Пошаговые материалы по коннекторам находятся в документации Vakas-tools, а доступные источники событий: в каталоге интеграций.

Примеры сценариев

Регистрация в форме или CRM → generate_lead

После создания подтверждённой заявки правило отправляет событие регистрации. client_id нужно сохранить при отправке формы и передать дальше вместе с контактом; иначе GA4 не сможет полноценно связать серверное событие с браузерным сеансом.

Подтверждённая оплата → purchase

Платёжный сервис или CRM сообщает об успешной оплате, после чего Vakas-tools передаёт покупку с суммой, валютой и ID транзакции. Для связи с исходным визитом client_id должен пройти по воронке от сайта до записи об оплате.

Нужный этап воронки → произвольное событие

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

Для нестандартной передачи полей заранее проверьте схему в разделе для технических специалистов.

Measurement Protocol и тег GA4: в чём разница

Серверная отправка не отменяет требования к согласию пользователя и не восстанавливает автоматически данные, которые не были собраны на сайте. Для связной аналитики клиентская и серверная части должны использовать согласованные идентификаторы.

Как проверить отправку

1. Сверьте Measurement ID и API Secret с выбранным потоком.
2. Запустите правило на тестовой регистрации, покупке или событии.
3. Проверьте результат действия в журнале Vakas-tools.
4. Найдите событие в доступных отчётах и инструментах диагностики GA4.
5. Если событие не связано с сеансом, проверьте источник и формат client_id.

Факт отправки запроса ещё не подтверждает корректность итоговой отчётности. Имя события, идентификаторы и параметры должны соответствовать правилам GA4.

Ограничения интеграции

• Имя произвольного события должно начинаться с буквы, содержать только допустимые символы и не входить в список зарезервированных имён GA4.
• Если передаётся денежное значение, вместе с ним нужна корректная валюта.
• Для purchase нужен осмысленный и стабильный ID транзакции.
• Без клиентского тега и корректного client_id отчётность и атрибуция могут быть неполными.
• В события нельзя включать персональные данные, запрещённые правилами Google.
• Повторную отправку событий нужно контролировать на стороне правила и идентификаторов.

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