Документация / Google Analytics / Интеграция с Google Analytics 4

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

Содержание

Для чего нужна интеграция

Коннектор Google Analytics 4 (GA4) передаёт серверные события из Vakas-tools напрямую в ваш счётчик GA4 через Measurement Protocol. Это позволяет фиксировать конверсии (регистрации и оплаты), которые происходят на стороне сервера и не видны обычному JS-счётчику.

Типичные задачи:

  • Передавать оплаты из GetCourse, Prodamus или Tilda как событие purchase в GA4
  • Фиксировать регистрации как событие generate_lead
  • Отправлять произвольные события (прохождение урока, участие в вебинаре и т.д.)

Интеграция работает в одну сторону: Vakas-tools отправляет события в GA4. Обратной загрузки данных из GA4 нет.

Подключение Google Analytics 4

Для подключения понадобятся два параметра из вашего аккаунта GA4: Measurement ID и API Secret. OAuth-авторизация не требуется.

Где взять Measurement ID и API Secret

1 Откройте

Google Analytics и перейдите в нужный ресурс.

2 В левом нижнем углу нажмите

Администратор (значок шестерёнки).

3 В разделе ресурса выберите

Потоки данных (Data Streams) и откройте нужный поток.

4 Вверху страницы указан

Measurement ID в формате G-XXXXXXXXXX. Скопируйте его.

5 На этой же странице прокрутите вниз до раздела

Measurement Protocol API secrets.

6 Нажмите Create (Создать),

задайте произвольное название и скопируйте Secret value.

Добавление сервиса в Vakas-tools

1 Перейдите

в Сервисы и доступы вашей Базы.

2 Нажмите Добавить сервис

и выберите Google Analytics 4.

3 Заполните:

Название (произвольное), Measurement ID и API Secret.

4 Нажмите Добавить сервис

Если данные верные, сервис появится в списке.

Measurement ID должен быть в формате G-XXXXXXXXXX. Не путайте его со старым Universal Analytics (формат UA-XXXXXXX). Интеграция работает только с GA4.

Проверка подключения

После добавления сервиса нажмите кнопку Проверить подключение (в блоке сервиса). Система отправит тестовое событие в отладочный эндпоинт Google и покажет результат. Если подключение настроено верно, вы увидите сообщение «Подключение активно».

Общие настройки

В базах добавьте сервис именно к базе с помощью кнопки [+Сервис].

После откройте «Настройки» на странице сервиса. Единственная настройка: Своё поле для client_id. По умолчанию client_id берётся автоматически из куки _ga.

Если в вашей схеме client_id хранится в отдельном поле (например, в сделке amoCRM), укажите шорткод этого поля в настройках сервиса.

Например: {#ga_client_id#}

Значение должно быть в формате 123456789.1234567890 (цифры.цифры). Если указанное поле пустое или формат не подходит, система попробует взять стандартную куку _ga.

Большинству пользователей менять настройки не нужно. Client_id определяется автоматически из стандартной куки _ga.

Как работает привязка к посетителю (client_id)

GA4 привязывает серверные события к конкретному посетителю сайта через идентификатор client_id. Этот идентификатор берётся из куки _ga, которую ставит JS-счётчик GA4 на вашем сайте.

Как это работает:

  1. Посетитель заходит на ваш сайт, счётчик GA4 ставит куку _ga (формат: GA1.1.123456789.1234567890).
  2. Посетитель заполняет форму, кука передаётся вместе с данными в Vakas-tools.
  3. При срабатывании правила Vakas-tools берёт client_id из куки и отправляет событие в GA4 с этим идентификатором.
  4. GA4 связывает серверное событие с тем же посетителем, который был на сайте.

Без client_id события не отправляются. Если кука _ga не была передана вместе с данными контакта, действие вернёт ошибку «Нет client_id». Убедитесь, что на лендинге стоит счётчик GA4 и кука передаётся в вебхуке.

Как устроена передача данных

Интеграция с GA4 работает через серверную передачу событий (Measurement Protocol). В отличие от обычного JS-счётчика, который отслеживает действия в браузере, Vakas-tools отправляет события напрямую на серверы Google. Это позволяет передавать оплаты, регистрации и другие конверсии, которые происходят на стороне сервера и не видны браузерному счётчику.

1 Посетитель заходит на сайт

JS-счётчик GA4 на вашем сайте ставит куку _ga с уникальным идентификатором посетителя (client_id).

2 Посетитель заполняет форму или совершает оплату

Данные вместе с кукой _ga передаются в Vakas-tools через вебхук или процесс (из GetCourse, Tilda, Prodamus и других источников).

3 В Vakas-tools срабатывает правило

На вкладке Регистрации, Оплаты или Отчёты настроено действие Google Analytics 4. Система берёт client_id из куки контакта и формирует событие.

4 Событие уходит в GA4

Vakas-tools отправляет серверный запрос в Google Analytics через Measurement Protocol с идентификатором посетителя, названием события и параметрами (сумма, валюта, ID транзакции).

5 GA4 связывает событие с посетителем

Благодаря client_id Google Analytics привязывает серверное событие к той же сессии, которую зафиксировал JS-счётчик. Конверсия появляется в отчётах GA4.

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

Как устроена интеграция

Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке свой список правил.

  1. Условия: фильтр, определяющий, для каких данных сработает правило. Чтобы передавать все данные, обязательно создайте правило без условий.
  2. Действия: что именно отправить в Google Analytics 4 (регистрацию, покупку или произвольное событие).
  3. Параметры правила: порядок выполнения, название, флаг «Стоп» (не выполнять следующие правила после этого).

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

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

Доступные действия

Коннектор поддерживает 3 действия. Каждое действие отправляет одно событие в GA4.

Действие Событие GA4 Когда использовать
Регистрация generate_lead При регистрации на вебинар, заполнении формы, оставлении заявки
Покупка purchase При оплате. Передаёт сумму, валюту, ID транзакции и название товара
Произвольное событие Любое название Для нестандартных конверсий: прохождение урока, клик по кнопке и т.д.

Регистрация (generate_lead)

Отправляет событие generate_lead в GA4. Используйте для фиксации регистраций, заявок, подписок.

Поле Тип Обязательное По умолчанию Описание
Ценность события текст нет — Денежная ценность конверсии. Поддерживает шорткоды
Валюта выбор нет RUB RUB, USD, EUR, KZT, UAH, BYN

Если ценность не указана, событие отправляется без суммы (просто фиксирует факт регистрации).

Покупка (purchase)

Отправляет событие purchase в GA4. Передаёт сумму оплаты, валюту и ID транзакции для защиты от дублирования.

Поле Тип Обязательное По умолчанию Описание
Сумма оплаты текст да {#payedMoney#} Сумма оплаты. Обязательное поле
Валюта выбор нет RUB RUB, USD, EUR, KZT, UAH, BYN
ID транзакции текст нет автоматически Уникальный идентификатор покупки. Поддерживает шорткоды

Защита от дублирования

GA4 использует transaction_id для защиты от дублирования: если отправить два события purchase с одинаковым transaction_id, GA4 учтёт только первое.

Если вы не указали ID транзакции в настройках, система сформирует его автоматически:

  1. Если в данных есть номер оплаты (payment_number), используется он
  2. Иначе формируется из ID контакта и суммы
  3. В крайнем случае генерируется хеш из доступных данных

Если в данных контакта есть название тарифа или товара (поле positions), оно автоматически передаётся в параметр items события purchase. Это позволяет видеть названия товаров в отчётах GA4.

Произвольное событие

Отправляет событие с произвольным названием. Подходит для нестандартных конверсий, которых нет в готовых действиях.

Поле Тип Обязательное По умолчанию Описание
Название события текст да — Название события для GA4. Например: webinar_view, course_start
Ценность текст нет — Денежная ценность. Поддерживает шорткоды
Валюта выбор нет Не указывать Указывайте валюту, только если заполнили ценность

Ценность и валюта передаются только если заполнены оба поля. Если указать сумму без валюты, она не отправится.

Типичные сценарии настройки

Сценарий 1. Оплата с GetCourse в GA4

Самый распространённый сценарий: фиксировать оплаты из GetCourse как конверсию purchase в Google Analytics.

1 Настройте сбор оплат из GetCourse в Vakas-tools.

2 Подключите сервис Google Analytics 4.

3 Создайте правило на вкладке Оплаты.

4 Добавьте действие Покупка (purchase).

По умолчанию сумма уже заполнена шорткодом {#payedMoney#}.

5 Сохраните правило.

При каждой оплате событие purchase уйдёт в GA4.

Сценарий 2. Регистрация с Tilda в GA4

Фиксировать заявки с Tilda как лид (generate_lead) в GA4.

1 Настройте сбор регистраций с Tilda в Vakas-tools.

2 Подключите Google Analytics 4.

3 Создайте правило на вкладке Регистрации.

4 Добавьте действие Регистрация (generate_lead).

5 При необходимости укажите ценность лида.

Сценарий 3. Произвольное событие при определённом условии

Отправлять нестандартное событие (например, course_start), когда контакт получает доступ к курсу.

1 Подключите Google Analytics 4.

2 Создайте правило с нужным условием (например, по названию тарифа).

3 Добавьте действие Произвольное событие.

4 В поле «Название события» укажите course_start (или любое другое).

Шорткоды

В полях действий можно использовать шорткоды для подстановки данных из контакта:

Шорткод Описание
{#payedMoney#} Сумма оплаты
{#costMoney#} Стоимость заказа
{#positions#} Название тарифа или товара
{#payment_number#} Номер оплаты
{#payment_status#} Статус оплаты
{#email#} Email контакта
{#phone#} Телефон контакта
{#name#} Имя контакта
{#id#} ID контакта в Vakas-tools

Частые вопросы

Чем отличается серверная передача от обычного JS-счётчика?
JS-счётчик фиксирует действия в браузере (просмотры страниц, клики). Серверная передача через Measurement Protocol отправляет события с сервера Vakas-tools. Это нужно для оплат и других событий, которые происходят не в браузере пользователя.
Почему события не отправляются? Ошибка «Нет client_id».
GA4 требует client_id (из куки _ga) для привязки события к посетителю. Если на лендинге нет счётчика GA4 или кука не передаётся вместе с данными формы, client_id будет отсутствовать. Проверьте, что счётчик GA4 установлен на сайте и кука _ga передаётся в вебхуке.
Как быстро события появляются в GA4?
События обычно появляются в отчёте Realtime (В реальном времени) через несколько секунд. В стандартных отчётах GA4 данные могут появиться с задержкой до 24-48 часов.
Можно ли использовать со старым Universal Analytics (UA)?
Нет. Интеграция работает только с Google Analytics 4. Measurement Protocol для Universal Analytics (UA) использует другой формат и прекращён Google.
Как проверить, что события действительно приходят в GA4?
Используйте кнопку Проверить подключение в настройках сервиса. Также можно открыть GA4 → Отчёты → В реальном времени и проверить, появляются ли события после тестовой отправки.
Что происходит при повторной отправке той же оплаты?
Для события purchase автоматически формируется transaction_id, одинаковый для одного и того же заказа. GA4 дедуплицирует события с одинаковым transaction_id, поэтому повторная отправка не создаст двойную конверсию.
Нужен ли прокси для отправки?
Нет. Google Analytics доступен из России без ограничений. Прокси не требуется.
Можно ли передавать несколько событий в одном правиле?
В одном правиле можно добавить несколько действий. Например, при оплате отправить и purchase, и произвольное событие course_access.
Передаётся ли название товара в GA4?
Да. Если в данных контакта есть название тарифа (поле positions), оно автоматически попадает в параметр items события purchase. Это видно в отчётах GA4 по товарам.
Почему production-эндпоинт GA4 всегда отвечает 204?
Это особенность Measurement Protocol: рабочий эндпоинт всегда возвращает HTTP 204 (пустой ответ), даже если данные невалидные. Ошибки можно увидеть только через отладочный эндпоинт (кнопка «Проверить подключение» использует именно его).

Ограничения

  • Обязателен client_id (кука _ga). Без него события не отправляются. Нельзя отправить событие «анонимно».
  • Работает только с Google Analytics 4 (не Universal Analytics).
  • Событие должно быть не старше 72 часов с момента визита пользователя (ограничение Google).
  • Максимум 25 параметров в одном событии (ограничение GA4).
  • Рабочий эндпоинт GA4 не сообщает об ошибках (всегда отвечает 204). Ошибки видны только через отладочный эндпоинт.
  • Каждое действие отправляется отдельным запросом (без пакетной отправки).
×