> 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-yandex-metrika.md).

# Кейс: передача конверсий в Яндекс.Метрику

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

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

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

***

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

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

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

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

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

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

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

1. Создать лендинг на нужный бот/канал.
2. В разделе настроек лендинга «Аналитика и скрипты» указать **ID Яндекс.Метрики** — это счётчик, который установлен на вашем рекламном лендинге/сайте (или просто счётчик, в который вы хотите видеть конверсии).
3. Использовать ссылку на этот лендинг (`tlin.cc/ваш-адрес`) в рекламе вместо прямой ссылки на бота/канал.

{% hint style="warning" %}
Лендинг здесь обязателен. Без него у пользователя не будет идентификатора клиента (`client_id`/`yclid`), и Метрика не сможет связать конверсию с конкретным переходом по рекламе — отправлять данные будет не на что. Лендинги — платная функция.
{% endhint %}

## Шаг 3. Подключаем интеграцию с Яндекс.Метрикой

1. Перейдите в раздел **«Интеграции»** в личном кабинете.
2. Найдите карточку **Yandex Metrika** в списке доступных интеграций и нажмите **«Настроить»**.
3. Нажмите **«Подключить»** — появится кнопка авторизации.
4. Нажмите **«Подключить»** ещё раз — вы будете перенаправлены на страницу Яндекса для авторизации. Войдите в тот аккаунт Яндекса, к которому привязан нужный счётчик Метрики, и разрешите доступ.
5. После возврата в graspil укажите **ID счётчика** (число, которое можно найти в настройках вашего счётчика на `metrika.yandex.ru`) и нажмите **«Сохранить настройки»**.

{% hint style="warning" %}
**Важно:** в самом счётчике Яндекс.Метрики должна быть включена возможность принимать офлайн-конверсии (загрузка офлайн-данных), а цель (target), на которую вы будете отправлять данные, должна быть создана в настройках счётчика заранее. Название/идентификатор этой цели понадобится на следующем шаге.
{% endhint %}

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

Теперь нужно настроить сценарий: «когда произошло событие — отправить данные в Яндекс.Метрику». Это делается в разделе **«Автоматизации»** ([подробная документация](/ru/app/automations.md)).

### Быстрый способ — каталог готовых автоматизаций

В разделе **«Автоматизации»** → **«Создать автоматизацию»** откройте **каталог готовых автоматизаций** и выберите шаблон **«Отправка конверсии в Яндекс.Метрику»**. Шаблон уже содержит триггер и настроенное действие — останется выбрать бота/канал, нужное событие-триггер и вашу интеграцию из Шага 3, после чего опубликовать автоматизацию.

### Вручную — собрать схему самостоятельно

Если хочется собрать схему с нуля или настроить её нестандартно:

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

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

   Но можно выбрать **любое другое событие** — оплату (`successful_payment`), переход в мини-приложение, нажатие кнопки или ваше собственное событие. Полный список — в [«Списке событий»](/ru/app/reports/events.md).
3. Добавьте блок действия **«Интеграции»**, выберите тип **«Яндекс.Метрика»** и заполните:
   * **Интеграция** — та, что вы подключили в Шаге 3.
   * **Тип идентификатора** — `client_id` (если использовался лендинг tlin), `yclid` (клик по рекламе Яндекс.Директ) или `user_id` (свой идентификатор).
   * **Путь к идентификатору** — переменная, откуда брать значение, например `{{ user.ym_client_id }}`.
   * **Цель** — название цели (target), созданной в счётчике на Шаге 3.
   * Дополнительно можно передать сумму конверсии, валюту и дату/время — если это важно для ваших отчётов в Метрике.
4. Соедините триггер и действие стрелкой, нажмите **«Запустить тест»**, чтобы проверить схему, и опубликуйте автоматизацию.

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

***

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

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

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

> Вступление в канал → запуск бота → совершение покупки (конверсия) → отправка данных в Яндекс.Метрику

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

***

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

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