Панель

Реклама (Google Ads, Meta Ads, AdSense)

OAuth, дашборд кампаній, UTM ↔ контакти, sync метрик.

Навіщо модуль

Розділ Маркетинг → Реклама (/ads) обʼєднує рекламні акаунти з аналітикою контактів Epsenta. Ви бачите кампанії Google Ads і Meta Ads, витрати за 30 днів і звʼязок utm_campaign з контактами в CRM/діалогах.

Модуль доповнює вбудовану UTM-аналітику (/analytics → вкладка UTM): тут саме привʼязка до зовнішніх ad-кабінетів через OAuth.

Підключення в проєкті

Відкрийте /ads у потрібному проєкті
Натисніть **Google Ads**, **Meta Ads** або **AdSense** — OAuth від імені вашого акаунта
Після redirect — статус «підключено» у блоці OAuth
Прив’яжіть рекламний кабінет (external account ID) і натисніть **Sync**
Якщо кнопки OAuth немає або з’являється помилка налаштування — зверніться до підтримки Epsenta

UTM ↔ кампанія

Таблиця ads_campaign_utm_map зберігає відповідність external_campaign_id ↔ utm_campaign. Коли контакт заходить з utm_campaign у flow або віджеті, його можна знайти в блоці UTM ↔ контакти на /ads.

Приклад: utm_campaign=summer_sale → список контактів з цією змінною у flow_state.

utm_source, utm_medium, utm_campaign — стандартні UTM-мітки
Звʼязок працює з embed-віджетами, deep link і flow set_variable

Дашборд і метрики

**Кампанії (snapshot)** — назва, статус, provider, час останнього sync
**Метрики 30 днів** — impressions, clicks, spend_micros (Google Ads API / Meta Graph)
**Bindings** — які ad-акаунти привʼязані до проєкту
**UTM maps** — збережені відповідності кампаній

Обмеження поточної версії

Немає керування бюджетом/pause кампаній з панелі (read-only sync)
Flow-блоки google_ads_* — у roadmap
Google Ads sync потребує схвалений Developer Token у Google Ads API Center
Токени OAuth зберігаються зашифровано per staff user