# Интеграции с рекламными системами Source: https://docs.botman.pro/a/3-integratsii-s-reklamnymi-sistemami Команда `/integrations` позволяет подключить [BotMan Radar](https://botman.pro/radar/) к рекламным платформам и автоматически передавать данные о подписках как офлайн-конверсии. Благодаря этому вы оптимизируете рекламу не просто по кликам, а по реальным подпискам. ## Зачем вообще нужны интеграции? Без интеграций вы видите только клики и подписки внутри Radar. С интеграциями данные о подписках попадают прямо в рекламный кабинет — и вы можете: - обучать алгоритмы рекламных платформ на реальных конверсиях - видеть стоимость подписчика (CPL) прямо в кабинете Яндекс Директа, Facebook\* или VK - автоматически оптимизировать ставки под подписчиков, а не под клики --- ## Яндекс Метрика ## **Что вы получаете** Подписки и отписки передаются в Метрику как цели. Вы видите конверсию из рекламы Яндекс Директа в подписчиков и можете оптимизировать кампании под неё. ## Как это работает: схема с лендингом Если вы запускаете рекламу через лендинг — важно понять, куда что ставить. Схема выглядит так: ![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/bb0b99761dd5090a8c94ae886b5d2dde638d506621743be45759b848bd0714b6.png) **Ссылку 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` → выберите ссылку → «📜 Скрипт для лендинга» → вставьте код перед `` на лендинге. ⚠️ Скрипт загружается с сервера Radar и обновляется автоматически — при изменении настроек ссылки переустанавливать его не нужно. ## Что передаётся в Метрику Данные/Когда передаются | \_ym\_uid (cookie Метрики) | Если пользователь был на лендинге со скриптом Radar | | --- | --- | | yclid (Яндекс Click ID) | Если пользователь пришёл из Директа | | Тип события | Подписка или отписка | | UTM-параметры | Считываются со страницы лендинга скриптом 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. (признана экстремистской организацией в РФ).