For the complete documentation index, see llms.txt. This page is also available as Markdown.

Кейс: передача конверсий в Google Analytics (GA4)

Пошаговая инструкция: как подключить бота или канал, настроить лендинг tlin и автоматически отправлять конверсии (постбеки) в Google Analytics 4 при наступлении любого события — вступление в канал, за

Эта инструкция показывает весь путь целиком — от подключения бота/канала до автоматической отправки данных в Google Analytics 4, без участия программиста.

Что в итоге получится: пользователь переходит по вашей рекламной ссылке → попадает в бота или канал → совершает нужное вам действие (вступление, запуск бота, оплата и т.д.) → graspil автоматически отправляет данные об этом в GA4 через Measurement Protocol как событие конверсии. Вы сразу видите в Google Analytics, какая реклама приносит реальных пользователей, а не просто переходы.

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


Шаг 1. Подключаем бота или канал

Чтобы graspil видел действия ваших пользователей, сначала нужно подключить ресурс — бота или Telegram-канал.

  • Подробная инструкция по подключению бота — «Подключение бота». Есть три способа: авто-настройка по токену, проксирование или подключение через API — выберите любой удобный.

  • Подробная инструкция по подключению канала — «Подключение каналов».

Можно подключить и бота, и канал одновременно — например, чтобы видеть всю цепочку «вступил в канал → запустил бота».

Шаг 2. Настраиваем лендинг tlin

Лендинг tlin.cc — это короткая ссылка, которую вы ставите в рекламу вместо прямой ссылки на бота/канал. Она переносит UTM-метки из рекламы и (это важно для нашего кейса) передаёт на сервер клиентский идентификатор GA4 (ga_uid, значение куки _ga), который потом понадобится для отправки конверсии именно по этому пользователю.

Полная инструкция по созданию и настройке лендинга — «Лендинги (переадресация tlin.cc)». Коротко, что нужно сделать:

  1. Создать лендинг на нужный бот/канал.

  2. В разделе настроек лендинга «Аналитика и скрипты» указать ID Google Analytics — это Measurement ID вашего потока данных GA4 в формате G-XXXXXXX.

  3. Использовать ссылку на этот лендинг (tlin.cc/ваш-адрес) в рекламе вместо прямой ссылки на бота/канал.

Шаг 3. Прокидываем идентификатор клиента в поле пользователя

Идентификатор ga_uid приходит в стартовом параметре диплинка бота вместе с остальными UTM-метками. Чтобы дальше обращаться к нему в автоматизации как к переменной, удобнее всего один раз замаппить его в кастомное поле пользователя:

  1. Откройте страницу бота → раздел «UTM-метки» (правила обработки start) — подробности в «Настройке обработки параметра start». Обратите внимание: сопоставление параметров работает только в режиме, где строка start разбирается на параметры, а не в упрощённом.

  2. Заранее создайте кастомное поле пользователя (например, ga_client_id) в разделе «Кастомные поля», если такого поля ещё нет.

  3. В блоке «Параметры в кастомные поля» добавьте маршрут: параметр ga_uid → поле ga_client_id.

После этого идентификатор будет доступен в шаблонах автоматизации как {{ user.addition_fields.ga_client_id }}.

Шаг 4. Подключаем интеграцию с Google Analytics

  1. Перейдите в раздел «Интеграции» в личном кабинете.

  2. Найдите карточку Google Analytics (GA4) в списке доступных интеграций и нажмите «Настроить».

  3. Нажмите «Подключить через Google» — вы будете перенаправлены на страницу авторизации Google. Войдите в тот аккаунт, к которому привязан нужный ресурс GA4, и разрешите доступ.

  4. После возврата в graspil выберите ресурс GA4 (property), затем поток данных (data stream) — веб-поток, в который должны попадать конверсии.

  5. Нажмите «Сохранить». graspil сам создаст (или переиспользует) секрет Measurement Protocol для выбранного потока — вводить его вручную не нужно.

Шаг 5. Создаём автоматизацию

Готового шаблона для Google Analytics в каталоге автоматизаций пока нет — схему нужно собрать вручную, это делается в разделе «Автоматизации» (подробная документация).

  1. Откройте «Автоматизации»«Создать автоматизацию», выберите бота/канал.

  2. Откройте конструктор и добавьте триггер «По событию». По умолчанию для такого кейса логично выбрать:

    • new_user — пользователь запустил бота, или

    • user_chat_new — пользователь вступил в канал.

    Но можно выбрать любое другое событие — оплату (successful_payment), переход в мини-приложение, нажатие кнопки или ваше собственное событие. Полный список — в «Списке событий».

  3. Добавьте блок действия «Интеграции», выберите тип «Google Analytics (GA4)» и заполните:

    • Интеграция — та, что вы подключили в Шаге 4.

    • Имя события — название события GA4, например purchase или sign_up. Можно константу или шаблон с переменными.

    • Поле с идентификатором клиента (client_id) — путь к полю из Шага 3, например {{ user.addition_fields.ga_client_id }}.

    • Игнорировать отсутствие client_id — если включено, при пустом идентификаторе (например, у органического пользователя без лендинга) шаг просто пропускается без ошибки.

    • Дополнительно можно включить передачу суммы конверсии (value), валюты и произвольных параметров события в формате JSON — пригодится для отчётов внутри GA4.

  4. Соедините триггер и действие стрелкой, нажмите «Запустить тест», чтобы проверить схему, и опубликуйте автоматизацию.

С этого момента, при каждом наступлении выбранного события, данные будут автоматически отправляться в Google Analytics — без вашего участия.


Любое событие и сквозная аналитика

По умолчанию проще всего настроить отправку по событию вступления в канал или запуска бота — это покрывает базовый случай «реклама → подписка». Но событие для триггера можно выбрать абсолютно любое — оплату, заполнение формы, любое пользовательское событие из вашей системы.

Также можно построить сквозную цепочку из нескольких шагов, например:

Вступление в канал → запуск бота → совершение покупки (конверсия) → отправка данных в Google Analytics с суммой и валютой платежа

Для этого используются блоки «Условие» и «Ожидание события» внутри одной автоматизации (например, дождаться оплаты после запуска бота, не дольше определённого времени) — подробнее об этих блоках в разделе «Автоматизации». Так GA4 получит конверсию только тогда, когда пользователь прошёл всю цепочку до конца, а не просто на первом шаге.


Нужна помощь с настройкой?

Если что-то не получается или остались вопросы — обратитесь в поддержку graspil, мы поможем настроить передачу конверсий в Google Analytics под вашу ситуацию.

Последнее обновление