Інтеграція рекламних витрат із CRM Бітрікс24
Реклама запущена, ліди йдуть, але окупність кожного каналу — темний ліс. Витрати на Директ — скільки з цього повернулося? Без зв'язки витрат із CRM ви не отримаєте відповіді. Ручний збір даних із трьох-п'яти кабінетів та об'єднання з CRM-звітами віднімає до 10 годин на місяць і містить помилки. Ми вирішуємо задачу через UTM-атрибуцію та автоматичний імпорт. Конфігурація вимагає роботи з API. Наші інженери мають сертифікати «1С-Бітрікс» та понад 7 років досвіду. Гарантуємо точність даних. Економія часу — до 95%, а бюджету — до 30% за рахунок оптимізації каналів.
Як підключити атрибуцію реклами?
Зв'язок «реклама → лід → угода → гроші» будується на UTM-мітках. Кожне оголошення позначається UTM-параметрами, які потрапляють у Бітрікс24 при створенні ліда. Після закриття угоди — виручка по цій угоді атрибутується до кампанії. Автоматизована зв'язка дає 100% точність обліку, що на 40% краще за ручний метод, і не потребує ручного втручання.
utm_source=yandex&utm_medium=cpc&utm_campaign=brand&utm_term=купити → Лід (UF_CRM_UTM_*) → Угода → Сума + Витрати по кампанії з Яндекс Директ API = ROI Ручний розрахунок ROI — це десятки людино-годин на місяць та помилки. Автоматизація скорочує час у 12 разів та повністю виключає людський фактор.
Структура користувацьких полів
В угодах Бітрікс24 потрібні поля для зберігання UTM-даних:
| Поле | Код | Тип |
|---|---|---|
| Джерело | UF_CRM_UTM_SOURCE | string |
| Кампанія | UF_CRM_UTM_CAMPAIGN | string |
| ID кампанії | UF_CRM_CAMPAIGN_ID | string |
| Канал | UF_CRM_UTM_MEDIUM | string |
| Ключове слово | UF_CRM_UTM_TERM | string |
| Оголошення (ID) | UF_CRM_AD_ID | string |
Поля створюються через crm.userfield.add або в інтерфейсі Бітрікс24. При створенні ліда з будь-якого рекламного каналу (Директ, VK, FB) — UTM-мітки зберігаються в ці поля. При конвертації ліда в угоду — поля копіюються (налаштування через «Джерела» в Б24 або через REST). Джерело: документація Бітрікс24 по користувацьких полях.
Чому щоденний імпорт витрат критичний?
Без щоденного імпорту ви працюєте з застарілими даними, а ROI розраховується із затримкою до тижня. Наш cron-скрипт завантажує витрати за попередній день з кожної рекламної системи в агрегаційну таблицю. Імпорт займає 2 хвилини на всю систему — це в 600 разів швидше ручного збирання. Автоматизований імпорт дає актуальну картину щоранку.
Приклад коду імпорту з Яндекс.Директа
// Яндекс.Директ: витрати по кампаніях за день public function importDirectCosts(string $date): void { $report = $this->directApi->getReport([ 'ReportType' => 'CAMPAIGN_PERFORMANCE_REPORT', 'DateRangeType' => 'CUSTOM_DATE', 'DateFrom' => $date, 'DateTo' => $date, 'FieldNames' => ['CampaignId', 'CampaignName', 'Cost', 'Clicks', 'Impressions'], ]); foreach ($report as $row) { AdCostTable::add([ 'DATE' => $date, 'SOURCE' => 'yandex', 'CAMPAIGN_ID' => $row['CampaignId'], 'CAMPAIGN' => $row['CampaignName'], 'COST' => $row['Cost'] / 1000000, // Директ віддає в мікрорублях 'CLICKS' => $row['Clicks'], ]); } } Аналогічно для VK Ads (ads.getStatistics) та Google Ads (Google Ads API, CampaignService). Імпорт працює стабільно, дані завжди актуальні.
Які дані потрібні для розрахунку ROI?
Для точного розрахунку достатньо трьох компонентів: витрати з рекламних кабінетів, виручка по закритих угодах з CRM та коректна зв'язка через UTM-мітки. Порівняння ручного та автоматичного підходу:
| Параметр | Ручний збір | Автоматизація |
|---|---|---|
| Час на зведення даних на місяць | до 10 годин | 0 годин |
| Точність атрибуції | 85% | 100% |
| Частота оновлення | раз на місяць | щоденно |
| Можливість оперативних рішень | ні | так |
Вартість автоматизації окупається за 2 місяці.
Звіт ROI в Бітрікс24
Підсумковий звіт будується запитом, що об'єднує витрати та виручку:
SELECT d.UF_CRM_UTM_SOURCE as source, d.UF_CRM_CAMPAIGN_ID as campaign_id, SUM(ac.COST) as ad_spend, COUNT(DISTINCT d.ID) as deals_count, SUM(d.OPPORTUNITY) as revenue, ROUND((SUM(d.OPPORTUNITY) - SUM(ac.COST)) / NULLIF(SUM(ac.COST), 0) * 100, 1) as roi_pct FROM b_crm_deal d LEFT JOIN local_ad_costs ac ON ac.CAMPAIGN_ID = d.UF_CRM_CAMPAIGN_ID AND ac.SOURCE = d.UF_CRM_UTM_SOURCE AND DATE(ac.DATE) = DATE(d.DATE_CREATE) WHERE d.STAGE_ID = 'WON' AND d.DATE_CLOSE BETWEEN :date_from AND :date_to GROUP BY d.UF_CRM_UTM_SOURCE, d.UF_CRM_CAMPAIGN_ID ORDER BY roi_pct DESC Звіт відображається в адміністративному розділі Бітрікс24 або в інтегрованому BI-інструменті (Yandex DataLens, Google Looker Studio). Завдяки автоматизації ROI кожного каналу стає видимим у реальному часі.
Типові помилки при конфігурації атрибуції
| Помилка | Наслідок | Рішення |
|---|---|---|
| Неправильна структура UTM-параметрів | Ліди не прив'язуються до кампаній | Впровадити єдиний шаблон міток |
| Відсутність поля для ID кампанії | Неможливість зіставити витрати | Додати UF_CRM_CAMPAIGN_ID |
| Імпорт витрат без урахування ПДВ | Завищений ROI | Налаштувати коректний розрахунок вартості |
| Рідке оновлення даних | Прийняття невірних рішень | Налаштувати щоденний cron |
Передача витрат назад до Яндекс.Метрики
Для відображення ROI прямо в Метриці — завантаження витрат через counter.uploadOfflineConversions (застарілий) або через Data2 API. За наявності наскрізної аналітики через Метрику — підключення через «Імпорт даних про витрати» з файлу CSV, який генерує Бітрікс.
Що входить в роботу
- Створення користувацьких полів в угодах Б24
- Налаштування передачі UTM при створенні ліда (всі канали)
- Розробка імпортерів витрат: Директ, VK Ads, FB/Instagram
- Агрегаційна таблиця
local_ad_costs - Звіт ROI по кампаніях з фільтрами за періодом та каналом
- Налаштування cron-розкладу імпорту
- Документація з розгортання та підтримки
- Навчання менеджерів роботі зі звітами
- Повна конфігурація під ключ: створення полів, імпортери, звіт, навчання.
Вартість робіт — від 25 000 грн.
Процес роботи
- Оцінка проекту безкоштовно за 1 день.
- Аналіз: вивчаємо ваші рекламні кабінети, схему UTM, структуру CRM.
- Проектування: визначаємо користувацькі поля, таблиці, логіку імпорту.
- Реалізація: пишемо код інтеграцій, налаштовуємо cron, налагоджуємо на тестових даних.
- Тестування: перевіряємо коректність атрибуції на реальних угодах.
- Деплой: розгортаємо на бойовому середовищі, передаємо документацію.
Терміни орієнтовно
- Базова зв'язка (Директ + один канал) — 1–2 тижні.
- Мультиканальний ROI-звіт з BI-дашбордом — 3–4 тижні. Вартість базової зв'язки — від 25 000 грн.
Замовте аудит ваших рекламних каналів — ми знайдемо втрати в атрибуції. Пишіть нам для безкоштовної консультації. Налаштування під ключ за 14 днів. Оцінимо проект безкоштовно. Наші сертифіковані інженери гарантують прозорість та підтримку.