ad_data_collection

name: Ad Data Collection Architecture description: Архітектура збору рекламних даних по каналах для Deltamedical — стан станом на 2026-04-23 type: project originSessionId: f0cf7b57-64e1-42d9-b441-a9ecf0bd61ef

Канал	Доступ	Метод	Статус
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

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.

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.

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)

/srv/projects/ad-analytics/ — зберігання консолідованих даних у partners_*.xlsx форматі.

✅ Google Ads: з MCC-CSV-scraping перейшли на API + BigQuery
✅ Meta Ads: з Supermetrics-only перейшли на власний delta-graph app + API + BigQuery
🟡 Tabletki.ua: продажі плануються підвезти найближчим часом (пріоритет — партнер надає доступ)
Історичні MCC Export / Supermetrics залишаються як fallback і для тих частин дашборду що працюють через Looker джерела