Для чего нужна интеграция
Интеграция работает в одну сторону: Vakas-tools отправляет события в GA4. Обратной загрузки данных из GA4 нет.
Подключение Google Analytics 4
Где взять Measurement ID и API Secret
Measurement ID должен быть в формате G-XXXXXXXXXX. Не путайте его со старым Universal Analytics (формат UA-XXXXXXX). Интеграция работает только с GA4.
Проверка подключения
Как работает привязка к посетителю (client_id)
Без client_id события не отправляются. Если кука _ga не была передана вместе с данными контакта, действие вернёт ошибку «Нет client_id». Убедитесь, что на лендинге стоит счётчик GA4 и кука передаётся в вебхуке.
Своё поле для client_id
Доступные действия
| Действие |
Событие GA4 |
Когда использовать |
| Регистрация |
generate_lead |
При регистрации на вебинар, заполнении формы, оставлении заявки |
| Покупка |
purchase |
При оплате. Передаёт сумму, валюту, ID транзакции и название товара |
| Произвольное событие |
Любое название |
Для нестандартных конверсий: прохождение урока, клик по кнопке и т.д. |
Регистрация (generate_lead)
| Поле |
Тип |
Обязательное |
По умолчанию |
Описание |
| Ценность события |
текст |
нет |
— |
Денежная ценность конверсии. Поддерживает шорткоды |
| Валюта |
выбор |
нет |
RUB |
RUB, USD, EUR, KZT, UAH, BYN |
Покупка (purchase)
| Поле |
Тип |
Обязательное |
По умолчанию |
Описание |
| Сумма оплаты |
текст |
да |
{#payedMoney#} |
Сумма оплаты. Обязательное поле |
| Валюта |
выбор |
нет |
RUB |
RUB, USD, EUR, KZT, UAH, BYN |
| ID транзакции |
текст |
нет |
автоматически |
Уникальный идентификатор покупки. Поддерживает шорткоды |
Дедупликация покупок
Произвольное событие
| Поле |
Тип |
Обязательное |
По умолчанию |
Описание |
| Название события |
текст |
да |
— |
Название события для GA4. Например: webinar_view, course_start |
| Ценность |
текст |
нет |
— |
Денежная ценность. Поддерживает шорткоды |
| Валюта |
выбор |
нет |
Не указывать |
Указывайте валюту, только если заполнили ценность |
Ценность и валюта передаются только если заполнены оба поля. Если указать сумму без валюты, она не отправится.
Типичные сценарии настройки
Сценарий 1. Оплата с GetCourse в GA4
Сценарий 2. Регистрация с Tilda в GA4
Сценарий 3. Произвольное событие при определённом условии
Быстрые действия
| Действие |
Описание |
| Проверить подключение |
Отправляет тестовое событие в отладочный эндпоинт GA4 и проверяет, что Measurement ID и API Secret корректны |
Шорткоды
| Шорткод |
Описание |
{#payedMoney#} |
Сумма оплаты |
{#costMoney#} |
Стоимость заказа |
{#positions#} |
Название тарифа или товара |
{#payment_number#} |
Номер оплаты |
{#payment_status#} |
Статус оплаты |
{#email#} |
Email контакта |
{#phone#} |
Телефон контакта |
{#name#} |
Имя контакта |
{#id#} |
ID контакта в Vakas-tools |
Частые вопросы
Ограничения
- Обязателен client_id (кука
_ga). Без него события не отправляются. Нельзя отправить событие «анонимно».
- Работает только с Google Analytics 4 (не Universal Analytics).
- Событие должно быть не старше 72 часов с момента визита пользователя (ограничение Google).
- Максимум 25 параметров в одном событии (ограничение GA4).
- Рабочий эндпоинт GA4 не сообщает об ошибках (всегда отвечает 204). Ошибки видны только через отладочный эндпоинт.
- Каждое действие отправляется отдельным запросом (без пакетной отправки).
