> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/cases/case-google-analytics.md).

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

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

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

{% hint style="info" %}
Если что-то непонятно по ходу настройки — откройте чат со встроенным AI-ассистентом в личном кабинете и опишите задачу своими словами, он подскажет конкретные шаги под вашу ситуацию.
{% endhint %}

***

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

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

* Подробная инструкция по подключению бота — [«Подключение бота»](/ru/connect-bot.md). Есть три способа: авто-настройка по токену, проксирование или подключение через API — выберите любой удобный.
* Подробная инструкция по подключению канала — [«Подключение каналов»](/ru/connecting-channels.md).

{% hint style="info" %}
Можно подключить и бота, и канал одновременно — например, чтобы видеть всю цепочку «вступил в канал → запустил бота».
{% endhint %}

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

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

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

1. Создать лендинг на нужный бот/канал.
2. В разделе настроек лендинга «Аналитика и скрипты» указать **ID Google Analytics** — это Measurement ID вашего потока данных GA4 в формате `G-XXXXXXX`.
3. Использовать ссылку на этот лендинг (`tlin.cc/ваш-адрес`) в рекламе вместо прямой ссылки на бота/канал.

{% hint style="warning" %}
Лендинг здесь обязателен, и именно страница-посредник должна быть включена (а не мгновенный редирект) — только на ней tlin успевает подгрузить `gtag.js` и получить клиентский идентификатор `_ga` перед переходом в Telegram. Лендинги — платная функция.
{% endhint %}

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

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

1. Откройте страницу бота → раздел **«UTM-метки»** (правила обработки start) — подробности в [«Настройке обработки параметра start»](/ru/app/start-utm.md). Обратите внимание: сопоставление параметров работает только в режиме, где строка start разбирается на параметры, а не в упрощённом.
2. Заранее создайте кастомное поле пользователя (например, `ga_client_id`) в разделе [«Кастомные поля»](/ru/app/custom-fields.md), если такого поля ещё нет.
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 для выбранного потока — вводить его вручную не нужно.

{% hint style="warning" %}
Чтобы события из этого кейса влияли на биддинг в Google Ads, свяжите ресурс GA4 с аккаунтом Google Ads в самом интерфейсе Google Analytics: **Администрирование → Связи с продуктами → Google Ads**. graspil этого не делает — это настраивается один раз в самом Google Analytics.
{% endhint %}

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

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

1. Откройте **«Автоматизации»** → **«Создать автоматизацию»**, выберите бота/канал.
2. Откройте конструктор и добавьте **триггер** «По событию». По умолчанию для такого кейса логично выбрать:

   * `new_user` — пользователь запустил бота, или
   * `user_chat_new` — пользователь вступил в канал.

   Но можно выбрать **любое другое событие** — оплату (`successful_payment`), переход в мини-приложение, нажатие кнопки или ваше собственное событие. Полный список — в [«Списке событий»](/ru/app/reports/events.md).
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 с суммой и валютой платежа

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

***

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

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