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

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

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

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

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

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


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

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

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

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

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

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

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

Вы также можете использовать свой собственный лендинг, для этого у нас есть специальный скрипт на сайт, который аналогичным образом переносит данные в graspil.

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

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

  2. В разделе настроек лендинга «Аналитика и скрипты» указать ID Яндекс.Метрики — это счётчик, который установлен на вашем рекламном лендинге/сайте (или просто счётчик, в который вы хотите видеть конверсии).

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

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

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

  2. Найдите карточку Yandex Metrika в списке доступных интеграций и нажмите «Настроить».

  3. Нажмите «Подключить» — появится кнопка авторизации.

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

  5. После возврата в graspil укажите ID счётчика (число, которое можно найти в настройках вашего счётчика на metrika.yandex.ru) и нажмите «Сохранить настройки».

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Тип идентификатораclient_id (если использовался лендинг tlin), yclid (клик по рекламе Яндекс.Директ) или user_id (свой идентификатор).

    • Путь к идентификатору — переменная, откуда брать значение, по умолчанию {{ user.addition_fields.ym_client_id }}.

    • Цель — название цели (target), созданной в счётчике на Шаге 3.

    • Дополнительно можно передать сумму конверсии, валюту и дату/время — если это важно для ваших отчётов в Метрике.

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

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


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

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

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

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

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


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

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

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