Кейс: передача конверсий в Google Analytics (GA4)
Пошаговая инструкция: как подключить бота или канал, настроить лендинг tlin и автоматически отправлять конверсии (постбеки) в Google Analytics 4 при наступлении любого события — вступление в канал, за
Эта инструкция показывает весь путь целиком — от подключения бота/канала до автоматической отправки данных в Google Analytics 4, без участия программиста.
Шаг 1. Подключаем бота или канал
Чтобы graspil видел действия ваших пользователей, сначала нужно подключить ресурс — бота или Telegram-канал.
Подробная инструкция по подключению бота — «Подключение бота». Есть три способа: авто-настройка по токену, проксирование или подключение через API — выберите любой удобный.
Подробная инструкция по подключению канала — «Подключение каналов».
Шаг 2. Настраиваем лендинг tlin
Лендинг tlin.cc — это короткая ссылка, которую вы ставите в рекламу вместо прямой ссылки на бота/канал. Она переносит UTM-метки из рекламы и (это важно для нашего кейса) передаёт на сервер клиентский идентификатор GA4 (ga_uid, значение куки _ga), который потом понадобится для отправки конверсии именно по этому пользователю.
Полная инструкция по созданию и настройке лендинга — «Лендинги (переадресация tlin.cc)». Коротко, что нужно сделать:
Создать лендинг на нужный бот/канал.
В разделе настроек лендинга «Аналитика и скрипты» указать ID Google Analytics — это Measurement ID вашего потока данных GA4 в формате
G-XXXXXXX.Использовать ссылку на этот лендинг (
tlin.cc/ваш-адрес) в рекламе вместо прямой ссылки на бота/канал.
Лендинг здесь обязателен, и именно страница-посредник должна быть включена (а не мгновенный редирект) — только на ней tlin успевает подгрузить gtag.js и получить клиентский идентификатор _ga перед переходом в Telegram. Лендинги — платная функция.
Шаг 3. Прокидываем идентификатор клиента в поле пользователя
Идентификатор ga_uid приходит в стартовом параметре диплинка бота вместе с остальными UTM-метками. Чтобы дальше обращаться к нему в автоматизации как к переменной, удобнее всего один раз замаппить его в кастомное поле пользователя:
Откройте страницу бота → раздел «UTM-метки» (правила обработки start) — подробности в «Настройке обработки параметра start». Обратите внимание: сопоставление параметров работает только в режиме, где строка start разбирается на параметры, а не в упрощённом.
Заранее создайте кастомное поле пользователя (например,
ga_client_id) в разделе «Кастомные поля», если такого поля ещё нет.В блоке «Параметры в кастомные поля» добавьте маршрут: параметр
ga_uid→ полеga_client_id.
После этого идентификатор будет доступен в шаблонах автоматизации как {{ user.addition_fields.ga_client_id }}.
Шаг 4. Подключаем интеграцию с Google Analytics
Перейдите в раздел «Интеграции» в личном кабинете.
Найдите карточку Google Analytics (GA4) в списке доступных интеграций и нажмите «Настроить».
Нажмите «Подключить через Google» — вы будете перенаправлены на страницу авторизации Google. Войдите в тот аккаунт, к которому привязан нужный ресурс GA4, и разрешите доступ.
После возврата в graspil выберите ресурс GA4 (property), затем поток данных (data stream) — веб-поток, в который должны попадать конверсии.
Нажмите «Сохранить». graspil сам создаст (или переиспользует) секрет Measurement Protocol для выбранного потока — вводить его вручную не нужно.
Чтобы события из этого кейса влияли на биддинг в Google Ads, свяжите ресурс GA4 с аккаунтом Google Ads в самом интерфейсе Google Analytics: Администрирование → Связи с продуктами → Google Ads. graspil этого не делает — это настраивается один раз в самом Google Analytics.
Шаг 5. Создаём автоматизацию
Готового шаблона для Google Analytics в каталоге автоматизаций пока нет — схему нужно собрать вручную, это делается в разделе «Автоматизации» (подробная документация).
Откройте «Автоматизации» → «Создать автоматизацию», выберите бота/канал.
Откройте конструктор и добавьте триггер «По событию». По умолчанию для такого кейса логично выбрать:
new_user— пользователь запустил бота, илиuser_chat_new— пользователь вступил в канал.
Но можно выбрать любое другое событие — оплату (
successful_payment), переход в мини-приложение, нажатие кнопки или ваше собственное событие. Полный список — в «Списке событий».Добавьте блок действия «Интеграции», выберите тип «Google Analytics (GA4)» и заполните:
Интеграция — та, что вы подключили в Шаге 4.
Имя события — название события GA4, например
purchaseилиsign_up. Можно константу или шаблон с переменными.Поле с идентификатором клиента (client_id) — путь к полю из Шага 3, например
{{ user.addition_fields.ga_client_id }}.Игнорировать отсутствие client_id — если включено, при пустом идентификаторе (например, у органического пользователя без лендинга) шаг просто пропускается без ошибки.
Дополнительно можно включить передачу суммы конверсии (value), валюты и произвольных параметров события в формате JSON — пригодится для отчётов внутри GA4.
Соедините триггер и действие стрелкой, нажмите «Запустить тест», чтобы проверить схему, и опубликуйте автоматизацию.
С этого момента, при каждом наступлении выбранного события, данные будут автоматически отправляться в Google Analytics — без вашего участия.
Любое событие и сквозная аналитика
По умолчанию проще всего настроить отправку по событию вступления в канал или запуска бота — это покрывает базовый случай «реклама → подписка». Но событие для триггера можно выбрать абсолютно любое — оплату, заполнение формы, любое пользовательское событие из вашей системы.
Также можно построить сквозную цепочку из нескольких шагов, например:
Вступление в канал → запуск бота → совершение покупки (конверсия) → отправка данных в Google Analytics с суммой и валютой платежа
Для этого используются блоки «Условие» и «Ожидание события» внутри одной автоматизации (например, дождаться оплаты после запуска бота, не дольше определённого времени) — подробнее об этих блоках в разделе «Автоматизации». Так GA4 получит конверсию только тогда, когда пользователь прошёл всю цепочку до конца, а не просто на первом шаге.
Нужна помощь с настройкой?
Если что-то не получается или остались вопросы — обратитесь в поддержку graspil, мы поможем настроить передачу конверсий в Google Analytics под вашу ситуацию.
Последнее обновление