Команда /integrations  позволяет подключить BotMan Radar к рекламным платформам и автоматически передавать данные о подписках как офлайн-конверсии. Благодаря этому вы оптимизируете рекламу не просто по кликам, а по реальным подпискам.

Зачем вообще нужны интеграции?

Без интеграций вы видите только клики и подписки внутри Radar. С интеграциями данные о подписках попадают прямо в рекламный кабинет — и вы можете:

• обучать алгоритмы рекламных платформ на реальных конверсиях
• видеть стоимость подписчика (CPL) прямо в кабинете Яндекс Директа, Facebook* или VK
• автоматически оптимизировать ставки под подписчиков, а не под клики

Яндекс Метрика

Что вы получаете

Подписки и отписки передаются в Метрику как цели. Вы видите конверсию из рекламы Яндекс Директа в подписчиков и можете оптимизировать кампании под неё.

Как это работает: схема с лендингом

Если вы запускаете рекламу через лендинг — важно понять, куда что ставить. Схема выглядит так:

Ссылку Radar нужно ставить в кнопку на лендинге, а не в рекламную кампанию. В рекламу идёт обычный URL лендинга с UTM-метками.

UTM-метки не нужно добавлять в саму ссылку Radar. Скрипт Radar автоматически читает UTM-параметры из адресной строки страницы, на которой находится пользователь. Ничего не затирается — в кнопке остаётся чистая ссылка вида https://s.botman.pro/t/xxxxx .

Если у вас 10 рекламных кампаний — 10 лендингов делать не нужно. Достаточно одного лендинга с одной ссылкой Radar. UTM-метки в рекламных кампаниях сами разделят трафик по источникам. Если хотите видеть разбивку ещё и внутри Radar — создайте отдельную ссылку на каждую кампанию через /new .

Шаг 1. Подключить Яндекс аккаунт

1. Отправьте /integrations  и выберите «Яндекс Метрика» → «Подключить»
2. Нажмите на ссылку OAuth-авторизации — она откроется в браузере
3. Войдите в Яндекс-аккаунт, в котором есть нужные счётчики, и разрешите доступ
4. Готово — аккаунт привязан

⚠️Если у вас несколько Яндекс-аккаунтов — можно подключить каждый отдельно. Все подключённые аккаунты будут доступны при настройке ссылок.

Шаг 2. Привязать счётчик и настроить цели для каждой ссылки

Выбор счётчика и настройка целей делаются не в /integrations , а через настройки конкретной трекинг-ссылки:

1. Отправьте /links  и выберите нужную ссылку
2. Нажмите ⚙️ (настройки ссылки)
3. Нажмите 📈 Настроить аналитику
4. Выберите счётчик из списка
5. Выберите способ настройки целей:
   - 🔧 Создать стандартные цели — бот сам создаст в счётчике цели trkClick , trkSubscribe , trkUnsubscribe
   - 📋 Выбрать из существующих — если цели в счётчике уже есть, можно привязать их вручную

⚠️ Если у вас несколько трекинг-ссылок — настройку нужно повторить для каждой.

Шаг 3. Установить скрипт Radar на лендинг

Без скрипта Radar не сможет собрать _ym_uid  и yclid  — и Метрика не сможет сопоставить визит на сайт с подпиской в Telegram. Конверсии не появятся.

Как получить скрипт: /links  → выберите ссылку → «📜 Скрипт для лендинга» → вставьте код перед </body> на лендинге.

⚠️ Скрипт загружается с сервера Radar и обновляется автоматически — при изменении настроек ссылки переустанавливать его не нужно.

Что передаётся в Метрику

Данные/Когда передаются

Важно: скрипт на лендинге обязателен

Что проверить, если конверсии не поступают

1. Установлен ли скрипт Radar на лендинге?
2. Установлен ли счётчик Яндекс Метрики на том же лендинге?
3. Подключена ли Метрика в /integrations?
4. Выбран ли счётчик и настроены ли цели для конкретной ссылки? (/links → ссылка → 📈 Настроить аналитику)

Facebook Pixel* (Conversions API)

Что вы получаете

Конверсии передаются через Conversions API — это серверная передача, которая не зависит от блокировщиков рекламы и даёт точные данные для оптимизации кампаний в Facebook и Instagram.

Что нужно заранее

• Pixel ID (он же Dataset ID) — найдёте в Facebook* Events Manager
• Access Token (System User Token) — создаётся там же, в разделе настроек пикселя

Как подключить

1. Отправьте /integrations  и выберите «Facebook Pixel*» → «Добавить пиксель»
2. Введите Pixel ID
3. Введите Access Token
4. Radar проверит данные и подключит пиксель

Несколько пикселей

Если вы работаете с несколькими рекламными аккаунтами — можно добавить несколько пикселей. Для каждого повторите шаги выше через:
/integrations  → «Facebook Pixel*» → «Добавить пиксель».

VK Ads Pixel

Что вы получаете

Конверсии передаются в VK Рекламу для оптимизации таргетированных кампаний.

Как подключить

Доступно через /integrations  — выберите «VK Ads Pixel» и следуйте инструкциям в боте.

Частые вопросы

Конверсии передаются для всех ссылок или только для выбранных? 
По умолчанию — для всех. Но для каждой ссылки можно индивидуально включить или отключить передачу: /links  → выберите ссылку → раздел «Аналитика».

Яндекс Метрика получает конверсии, но без yclid  — почему? 
yclid  передаётся только если пользователь пришёл из Яндекс Директа. Если трафик из другого источника — будет только _ym_uid  (при наличии скрипта на лендинге).

Можно подключить несколько пикселей Facebook*? 
Да, добавляйте столько пикселей, сколько нужно — через /integrations  → «Facebook Pixel*» → «Добавить пиксель».

Интеграция подключена, но данные не идут — что делать?
Для Яндекс Метрики — смотрите чеклист выше.
Для Facebook — проверьте, что Pixel ID и Access Token введены верно, и что токен не истёк. Также убедитесь, что интеграция включена для нужных ссылок.

Radar видит содержание переписки подписчиков? 
Нет. Radar отслеживает только факт подписки/отписки и источник перехода. Содержание сообщений не обрабатывается и никуда не передаётся.

Метрика подключена, цели создались, но данных нет («Нет данных по цели») — почему?
Скорее всего, на лендинге не установлен скрипт Radar. Без него сервис не может собрать _ym_uid  и yclid  — и Метрике просто нечего сопоставлять с подпиской.

Что сделать: /links  → выберите ссылку → «📜 Скрипт для лендинга» → скопируйте код и вставьте на лендинг перед </body>. Убедитесь, что счётчик Яндекс Метрики тоже установлен на той же странице. После этого подождите новых переходов — конверсии начнут фиксироваться.

Ссылку Radar нужно ставить в рекламу или в кнопку на сайте?
В кнопку на лендинге. В рекламную кампанию идёт обычный URL лендинга с UTM-метками. Подробнее — в разделе «Как это работает: схема с лендингом» выше.

Нужно ли добавлять UTM-метки в ссылку Radar на кнопке? 
Нет, это штатный сценарий работы Radar. Вот что происходит по шагам:

1. Пользователь переходит на лендинг по рекламной ссылке с UTM-метками
2. Скрипт Radar при клике на кнопку сам читает все utm_* параметры из адресной строки лендинга, а заодно _ym_uid из cookie и yclid из URL
3. Все эти данные сохраняются на сервере и привязываются к уникальному click_id
4. Пользователь переходит в Telegram по этому click_id
5. Когда он подписывается — Radar достаёт все сохранённые UTM и прикладывает к событию подписки

UTM не потеряются — попадут и в статистику Radar, и в отчёты.

Важный нюанс для сшивки с Метрикой: на лендинге должны стоять оба скрипта одновременно — стандартный счётчик Яндекс Метрики (в <head>) и скрипт Radar (перед </body>). Без счётчика Метрики cookie _ym_uid не появится, и Метрика не сможет связать конверсию с источником визита. Radar при этом событие всё равно отправит — но в Метрике оно будет выглядеть как анонимное, без привязки к рекламной кампании.

Полный правильный контур: реклама с UTM → лендинг (счётчик Метрики + скрипт Radar) → кнопка с чистой ссылкой Radar.

Хочу сменить счётчик Метрики — как это сделать?
Выбор счётчика делается через настройки конкретной ссылки, а не через /integrations:

1. Отправьте /links в боте
2. Нажмите ⚙️ <название ссылки>
3. Нажмите 📈 Настроить аналитику
4. Если Метрика сейчас включена — сначала нажмите ❌ Выключить, затем снова откройте 📈 Настроить аналитику
5. Появится список счётчиков из вашего аккаунта — выберите нужный
6. Настройте цели: создайте стандартные или привяжите существующие

Повторите для каждой трекинг-ссылки.

Какой уровень прав в Яндекс Метрике нужен для подключения? 
Нужна роль «Редактор» (или выше — «Представитель владельца» / «Владелец») в том счётчике, который хотите подключить. Это нужно для получения списка целей и для кнопки «🔧 Создать стандартные цели» — без права записи она вернёт ошибку.

Роль «Только просмотр» не подойдёт. Если вы планируете использовать только «📋 Выбрать из существующих» и цели уже созданы вручную — теоретически просмотра хватит, но на практике безопаснее сразу давать «Редактор».

Если доступ выдаёт владелец счётчика другому логину — это делается в Яндекс Метрике: Настройки → Доступ → Добавить пользователя → Редактор.

Через сколько времени подписка появится в Метрике? 
Обычно в течение 1–5 минут. Radar отправляет конверсию сразу в момент подписки через real-time API. После этого отображение зависит от самой Метрики: в отчётах по целям и Real-Time данные появляются за 1–5 минут, полная агрегация — до часа. Исключение: если ссылка пришла с меткой yclid из Директа, но без клиентского ID — событие уйдёт как офлайн-конверсия, и там задержка до 4 часов. Это ограничение API Яндекса, не Radar.

Можно ли привязать несколько ботов к одному счётчику Метрики?
Да, ограничений нет. Один счётчик можно выбрать для любого числа трекинг-ссылок и ботов. Заново создавать цели не нужно — если trkClick, trkSubscribe, trkUnsubscribe уже есть в счётчике, они подхватятся автоматически, дубликатов не будет.

Важный нюанс: события со всех ботов попадут в один счётчик с одинаковыми названиями целей. В отчётах Метрики вы увидите общее количество подписок, но не сможете различить, какой бот сколько принёс. Чтобы разделять — используйте отдельный счётчик на каждого бота или добавляйте UTM-метки в рекламные кампании и фильтруйте по ним в Метрике.

Скрипт для лендинга — один на все ссылки или отдельный для каждой? 
Отдельный для каждой трекинг-ссылки. В скрипте зашит идентификатор конкретной ссылки, её счётчик и цели. Если вставить скрипт от ссылки A на страницу с кнопкой ссылки B — конверсии будут уходить в счётчик ссылки A. Для каждого лендинга берите скрипт той ссылки, которая на нём размещена: /links → выберите нужную ссылку → «📜 Скрипт для лендинга».

*Facebook принадлежит Meta Platforms Inc. (признана экстремистской организацией в РФ).