name: Ad Data Collection Architecture
description: Архітектура збору рекламних даних по каналах для Deltamedical — стан станом на 2026-04-23
type: project
originSessionId: f0cf7b57-64e1-42d9-b441-a9ecf0bd61ef
Поточний стан джерел (2026-04-23)
| Канал |
Доступ |
Метод |
Статус |
| Google Ads |
API + BigQuery |
Напряму через Google Ads API (нативний доступ) + BQ dataset |
✅ Працює |
| Meta Ads |
API + BigQuery |
Marketing API через app delta-graph (user/System User token) + BQ |
✅ Працює (API live з 2026-04-23) |
| DV360 |
Supermetrics → Looker Studio |
Через дашборд Humer |
✅ |
| TikTok |
Supermetrics → Looker Studio |
Через дашборд Humer |
✅ |
| Bloggers |
Ручно + Looker Studio |
Сторінки Reach/Engagement |
✅ |
| GA4 |
Screenshots (Playwright) |
/srv/projects/ga4-access/ |
✅ |
| Tabletki.ua |
⏳ партнерський канал |
Продажі мають підʼїхати (очікується надання доступу) |
🟡 TBD |
Meta Marketing API (свіже — 2026-04-23)
- App:
delta-graph (ID 1327888782563204), Live Mode ✓
- Token:
/srv/passepartout/meta/vova-user-token-longlived-2026-04-23.txt (59 днів)
- Тулкит:
/srv/tools/meta-ads/ — audit.py, list-accounts.py
- Деталі:
infra_meta_ads_toolkit.md
- 26 ad accounts доступні. Через Marketing API читаємо кампанії, ad sets, ads, insights, placements breakdown.
Google Ads — двоколійний доступ
- API напряму — для програмного витягу (скрипти, CrewAI).
- BigQuery dataset — для аналітики і Looker Studio джерел. Дозволяє SQL-запити без rate-limit'у Ads API.
- Historical MCC Export (Playwright) → CSV —
/srv/projects/google-ads-crew/mcc_report_downloader.py. Все ще працює як fallback, але не основний шлях.
- MCC ID: 191-068-9182 (ocid=231991170 в URL), куки
/srv/passepartout/google/cookies-google-ads.json.
Looker Studio дашборд (Humer копія)
- URL: https://datastudio.google.com/reporting/44d79983-93d7-4807-8cfd-9fc7181eb7a2
- 12 сторінок: Google Ads, Search, Search Brand, Meta Ads, Meta Ads tabl, DV360, TikTok ads, Bloger Reach/Engagement, Blogs
- Куки:
/srv/passepartout/google/cookies-looker-studio.json
- Джерела: Supermetrics connectors для Meta/FB, DV360, TikTok; окремі конектори на кожен Google Ads кабінет
- Фільтр "Humer" на рівні діаграм — можна знімати щоб бачити всі бренди
- ПРАВИЛО: можна додавати нові елементи, не можна редагувати джерела даних (за згодою 15.04)
Pipeline "Partners" (PBI pipeline)
/srv/projects/ad-analytics/ — зберігання консолідованих даних у partners_*.xlsx форматі.
- TikTok, Bloggers — у pipeline
- Tabletki.ua — очікуємо продажі (коли доступ буде надано, інтегруємо)
- Google Ads — тепер через API+BQ, не через MCC CSV
- Meta — тепер через API, не через Supermetrics-Export
Що зміниилось проти версії 15.04
- ✅ Google Ads: з MCC-CSV-scraping перейшли на API + BigQuery
- ✅ Meta Ads: з Supermetrics-only перейшли на власний delta-graph app + API + BigQuery
- 🟡 Tabletki.ua: продажі плануються підвезти найближчим часом (пріоритет — партнер надає доступ)
- Історичні MCC Export / Supermetrics залишаються як fallback і для тих частин дашборду що працюють через Looker джерела
⚠️ DEPRECATED 2026-05-11 — cookies-based підключення прибрано
cookies-google-ads.json → перенесено у _archive-2026-05-11/cookies-looker-studio.json → перенесено у _archive-2026-05-11/ (Looker dashboard deprecated 2026-05-05)cookies-sergey.json → перенесено у _archive-2026-05-11/
Активний шлях для Google Ads даних: BQ Data Transfer Service → ad-analytics-hub.ad_data.* (через /srv/passepartout/google/ad-pipeline-worker-sa.json). Деталі: google-ads wiki
Cron disabled 2026-05-11:
mcc_report_downloader.py campaigns (cookies expired з 16.04, CSV не оновлювалось 25 днів)daily_analyzer.py (читав той самий старий CSV, надсилав bit-identical звіти — буде переписано на BQDTS)