Интеграция Битрикс24 с Roistat
Маркетолог отчитывается: «Мы потратили на рекламу 400 тысяч, получили 120 лидов». Директор спрашивает: «А сколько из них дошло до оплаты и с какого канала?» Тишина. Штатная аналитика Б24 показывает источники по UTM, но не связывает расходы с конкретными сделками по всей воронке. Roistat закрывает эту задачу — сквозная аналитика от клика до оплаты. Но «подключить Roistat» и «получить работающую аналитику» — разные вещи. Настраиваем интеграцию так, чтобы данные сходились.
Как работает связка Roistat + Битрикс24
Roistat отслеживает посетителя с момента захода на сайт. При первом визите ставится cookie roistat_visit — уникальный идентификатор визита. Этот номер привязывает всю цепочку: рекламный клик → поведение на сайте → заявка → лид в CRM → сделка → оплата.
Схема передачи данных:
- Посетитель заходит на сайт. Скрипт Roistat (счётчик) присваивает
roistat_visitи сохраняет в cookie. - Посетитель оставляет заявку. Форма на сайте передаёт
roistat_visitв скрытом поле. - Roistat перехватывает заявку и создаёт лид в Битрикс24 через REST API (
crm.lead.add) или через штатную интеграцию. В лиде заполняется пользовательское полеUF_CRM_ROISTAT_VISIT— номер визита. - Менеджер обрабатывает лид, конвертирует в сделку. Поле визита наследуется.
- Сделка закрывается с суммой. Roistat забирает данные через
crm.deal.listи связывает выручку с рекламным каналом.
Критически важно: если roistat_visit не передаётся в CRM — Roistat не свяжет сделку с рекламой. Визит останется «без конверсии», а сделка — «без источника». Поэтому первое, что проверяем при настройке — корректность передачи этого поля.
Настройка передачи roistat_visit в CRM
Roistat предлагает два варианта интеграции с Битрикс24:
| Параметр | Штатная интеграция (из кабинета Roistat) | Кастомная через REST API |
|---|---|---|
| Сложность | Низкая — настройка в интерфейсе | Средняя — нужна доработка форм и обработчиков |
| Создание лидов | Автоматически через коннектор | Через crm.lead.add с полем roistat_visit |
| Статусы сделок | Маппинг стадий воронки в интерфейсе Roistat | Вебхук onCrmDealUpdate → Roistat API |
| Мультиворонки | Поддержка с ограничениями | Полная гибкость маппинга |
| Телефония | Интеграция через коллтрекинг Roistat | Требуется отдельная настройка |
Штатная интеграция подключается в кабинете Roistat: Настройки → Интеграции → Битрикс24. Указывается URL портала и токен REST API с правами на CRM. Roistat автоматически создаёт пользовательское поле UF_CRM_ROISTAT_VISIT в лидах и сделках.
Для кастомной интеграции поле создаётся вручную через crm.lead.userfield.add:
-
FIELD_NAME:UF_CRM_ROISTAT_VISIT -
USER_TYPE_ID:string -
LABEL:Roistat Visit ID
Аналогичное поле — в сделках через crm.deal.userfield.add.
Коллтрекинг и офлайн-конверсии
Roistat подменяет номера телефонов на сайте — аналогично CoMagic и Calltouch. Каждый посетитель видит уникальный номер, привязанный к его roistat_visit. При звонке Roistat знает источник и передаёт данные в CRM.
Для работы коллтрекинга:
- В Roistat настраивается пул подменных номеров и привязка к рекламным каналам.
- Звонки передаются в Б24 через
telephony.externalcall.registerс привязкой кroistat_visit. - Запись разговора подгружается через
telephony.externalcall.attachRecord. - Лид создаётся автоматически с заполненным источником.
Офлайн-конверсии (оплата через кассу, подписание договора в офисе) передаются обратно в Roistat через статус сделки. Когда менеджер переводит сделку в стадию «Успешно завершена» — вебхук отправляет данные в Roistat API вместе с суммой.
ROI по каналам, кампаниям и ключевым словам
Roistat импортирует расходы из рекламных платформ:
- Яндекс.Директ — расходы по кампаниям, группам, ключевым словам
- Google Ads — аналогично, включая Performance Max
- VK Реклама, myTarget — расходы по кампаниям
- Facebook / Instagram Ads — через бизнес-аккаунт Meta
Данные о расходах сопоставляются с выручкой из CRM. В отчётах Roistat видно:
- Расход и доход по каждому каналу
- ROI = (доход − расход) / расход × 100%
- CPL (стоимость лида), CPO (стоимость заказа), LTV
- Детализация вплоть до ключевого слова — какой запрос в Директе принёс оплаченные сделки
Для корректного расчёта ROI менеджеры обязаны закрывать сделки с заполненной суммой. Сделка без суммы = нулевой доход. Это организационная задача, но без неё техническая интеграция бессмысленна.
Кастомные отчёты и мультиканальная атрибуция
Стандартные отчёты Roistat покрывают 80% задач. Для остальных 20% используются:
- Мультиканальная аналитика — Roistat учитывает все касания клиента, а не только первое или последнее. Модели: линейная, с затуханием, по позиции, кастомная.
- Когортный анализ — выручка от клиентов, привлечённых в конкретный месяц, растянутая во времени. Показывает реальный LTV.
- Отчёт по менеджерам — кто из менеджеров эффективнее конвертирует лиды с платного трафика.
Для выгрузки данных в сторонние BI-системы используется Roistat API: /project/analytics/data — возвращает сырые данные по визитам, лидам и сделкам.
Сроки внедрения
| Масштаб | Что входит | Срок |
|---|---|---|
| Базовый | Штатная интеграция, одна воронка, 1-2 рекламных канала, проверка передачи roistat_visit |
3-5 дней |
| Стандартный | Мультиворонки, коллтрекинг, 3-5 рекламных каналов, настройка отчётов | 1-2 недели |
| Расширенный | Кастомная интеграция через REST, мультиканальная атрибуция, офлайн-конверсии, обучение команды | 2-3 недели |
Что настраиваем
- Установка счётчика Roistat на сайт, проверка корректности
roistat_visitв cookie - Подключение Битрикс24 к Roistat: авторизация, маппинг полей, создание
UF_CRM_ROISTAT_VISIT - Настройка передачи номера визита через формы сайта (скрытые поля, JavaScript)
- Маппинг стадий воронки CRM → статусы в Roistat
- Подключение рекламных кабинетов для импорта расходов
- Настройка коллтрекинга: пул номеров, подмена на сайте, передача звонков в CRM
- Настройка вебхуков для передачи закрытых сделок и сумм обратно в Roistat
- Проверка сквозной цепочки: клик → визит → лид → сделка → оплата → ROI
- Обучение маркетолога: чтение отчётов, выбор модели атрибуции, типичные ошибки (потерянный
roistat_visit, сделки без суммы)