---

type: project-umbrella name: Ad Analytics Hub slug: ad-analytics-hub status: active readiness_pct: 68 owner_agent: TODO products: [all] created: 2026-04-14 last_updated: 2026-05-11 sub_projects: [google-ads, meta-ads, tabletki-ua, ga4, gtm, tiktok-ads] aliases: [ad-analytics, ad-analyzer]

Ad Analytics Hub — парасоля рекламної аналітики Deltamedical

Об'єднана точка доступу до всіх рекламних і аналітичних інтеграцій Deltamedical. Підпроекти живуть у підпапках. Спільна шина даних — BigQuery ad-analytics-hub.

Meta

Why this exists:

• Один Source-of-Truth для всіх рекламних KPI: витрати / покази / кліки / продажі / CR / CPA по кожному бренду в межах одного запиту BQ.
• Спільна SA ad-pipeline-worker для всіх ETL-процесів — централізована аутентифікація + IAM-аудит.
• Єдиний BQ-проект ad-analytics-hub з датасетами per-source (google_ads, meta_ads, tabletki, ga4, etc.).
• Денний звіт у Telegram про delta-зміни витрат/перформансу — agreement з Сергієм 2026-04-15.

KPIs (orient):

• Активні джерела: 3 з 5 (Google Ads ✅, Tabletki ✅ свіжий cron, daily-Telegram-monitor ✅; Meta Ads 🟡 у процесі; GA4/GTM 🔴 ще не підключено)
• BQ tables: ~6+ (mcc_, tabletki_, google_ads.* meta_ads.* (TODO), ga4.* (TODO))
• Денний health-чек: daily_delta_monitor — щодня 04:30 UTC

Status snapshot (2026-05-05):

• Google Ads MCC pipeline стабільний (3 cron-jobs)
• Tabletki weekly cron щойно налаштовано (Tue 06:00 UTC)
• Meta Ads — інтеграція в активному стані, ETL стабільний (TODO: дописати точний стан)
• GA4 — задача на старт
• GTM — задача на старт

Stakeholders:

• Owner: Сергій
• ETL/Data: VPS Claude
• Analyst (planned): TODO

---

Підпроекти

Підпроект	Статус	Wiki
google-ads	🟢 active (MCC + delta-monitor + crew)	./google-ads/
meta-ads	🟡 in-progress	./meta-ads/
tabletki-ua	🟢 active (weekly cron Tue 06:00 UTC)	./tabletki-ua/
ga4	🔴 not started	./ga4/
gtm	🔴 not started	./gtm/
tiktok-ads	🔴 blocked-on-app-review (re-submitted 30.04)	./tiktok-ads/

🗑 «Інтеграція через дашборд» (Looker Studio dashboard) — рішення Сергія 2026-05-05: забути, не актуально.

---

Спільна інфраструктура

BigQuery

• Проект: ad-analytics-hub
• SA: ad-pipeline-worker@ad-analytics-hub.iam.gserviceaccount.com
• Файл SA: /srv/passepartout/google/ad-pipeline-worker-sa.json
• Локація даних: дивиться по датасеті — ad-analytics-hub.tabletki у EU/europe-west, banner-analytics-fluvir у europe-central2 (cross-project IAM-grant).

Cron jobs

Реєстр всіх крон-задач — у глобальному розділі «⏰ Крони» / MEMORY.md + agents_inventory.md.

Цей hub підвішений до 4 крон-задач (власники зазначені в MEMORY.md):

• MCC download / MCC analyzer / daily_delta_monitor (Google Ads pipeline + umbrella delta-monitor)
• Tabletki weekly (sales + UTM)

---

Cross-references

• BigQuery: /integrations/bigquery.md
• Google Cloud SA: /integrations/google-cloud.md
• Telegram Bot API: /integrations/telegram-bot-api.md
• Passepartout: /srv/passepartout/google/
• Memory: project_priorities.md, ad_data_collection.md, project_tabletki_integration.md

Legacy

• Стара umbrella wiki: /srv/wiki/ad-analytics/ (deprecated 2026-05-05, лишається для git-історії)
• Стара wiki: /srv/wiki/projects/deltamedical/ad-analyzer/ (deprecated, мусить редиректити сюди)
• Looker Studio «Humer (копія)» dashboard — лишається у Looker, але як проект НЕ супроводжується (Сергій 2026-05-05).

🤖 PM Changelog

2026-05-11

Що зроблено сьогодні

• Запущено першу версію інструменту перевірки посадкових сторінок (Landing Checker): автоматично знаходить биті посилання в активних рекламних кампаніях.
• Проведено автоматизовані аудити рекламних кабінетів Meta та Google Ads із визначенням Health Score та пошуком вузьких місць (напр., вигорання креативів).
• Описано та задокументовано існуючий процес щоденного копіювання даних з Google Ads MCC до бази BigQuery для подальшої аналітики.

Що далі

• Розробка системи регулярних алертів (Anomaly Watchdog) та інтеграція з даними GA4.

2026-05-07

Що зроблено сьогодні

• До щоденного MCC-звіту додано новий блок із відхиленими оголошеннями для оперативного виявлення та реагування на блокування.

Що далі

• Впровадження аналітичного блоку: порівняння показників із вчорашнім днем та генерація рекомендацій щодо проблемних кампаній (заплановано як наступний апгрейд).

2026-05-05

Що зроблено сьогодні

• Налаштовано автоматичний щотижневий збір аналітики продажів з Tabletki.ua (запуск щовівторок).
• Проведено аудит доступів: підтверджено стабільну роботу з Meta Ads (26 акаунтів) та частковий доступ до GA4 (Medizine).
• Структуровано документацію проекту (додано 5 саб-проектів, оновлено статуси інтеграцій).

Що далі

• Вирішити питання з відсутнім доступом до GTM.
• Продовжити розширення джерел даних для єдиного дашборду.