← всі звіти · brief.md

Ad Analytics Hub — Brief

Створено: 2026-04-15 (Gemini + хмарний Claude)

Проблема / навіщо

Відсутність єдиної точки правди для аналізу рекламних кампаній по всьому MCC (191-068-9182). Дані розпорошені по платформах, міграція з Looker на PowerBI виявила критичні проблеми: змішані валюти (UAH/USD для UZ/KZ), відсутній Reach у Google Ads, динамічні назви таблиць у BigQuery (p_ads_*_<MCC_ID>), опечатки в назвах брендів.

Користувач і ціль

Хто: Digital Lead (Сергій), менеджери брендів, аналітики
Ціль: Автоматизований дашборд — витрати, конверсії, ефективність по брендах/ринках без ручного збору звітів
Критерій успіху: Відмова від ручного Excel → повністю автоматичний зріз по будь-якому бренду за будь-який період

Чому саме такий підхід

Node.js + BigQuery + Google Ads API — пряма робота з сирими даними у сховищі компанії. Гнучка обробка специфічних форматів (динамічні префікси таблиць, мультивалютність), кастомний UI під фарм-ринок, що неможливо в стандартних BI-інструментах. BigQuery Data Transfer вже налаштований — це обхід обмежень Basic Access Google Ads API.

MVP — мінімальна версія що вже дає цінність

Список кампаній + витрати + конверсії з BigQuery з фільтрацією по MCC акаунту і даті.
Готовність: ~70% — бекенд і інтеграції готові, потрібна візуалізація і деплой.

Блокери

Наступні кроки до MVP

  1. Сергій надає service-account.json → кладемо в /srv/passepartout/google/ad-pipeline-worker-sa.json (SA ad-pipeline-worker@ad-analytics-hub). ⚠️ Файл bigquery-sa.json поряд — це expense-bot SA, не ad-analytics; не використовувати.
  2. Видалити дублікати explore_data*.js
  3. Побудувати фільтри на фронтенді (дати, бренди, валюти)
  4. Деплой на VPS → /srv/services/ad-analytics/
  5. Подати заявку на Google Ads Standard Access

Канали і дані що плануються

Канал Метод Статус
Google Ads BigQuery Data Transfer 🟡 підключено, потрібен SA key
Meta Excel-експорт → скрипт 🔵 планується
TikTok Excel-експорт → скрипт 🔵 планується
DV360 BigQuery Reporting API 🔵 планується
Tabletki.ua Cowork skill → Excel 🟢 готово
Bloggers Cowork skill → Excel 🟢 готово