Ad Analytics Hub

Оновлено: 2026-04-14

GitHub

https://github.com/serhiivereschak/ad-analytics (private)

Overview

Дашборд аналітики рекламних кампаній Google Ads з інтеграцією BigQuery. Підтримує фільтрацію по акаунтах/брендах, мультивалютність, агрегацію даних по MCC.

Stack

Runtime: Node.js
Framework: Express v5
API: Google Ads API v23
Data Warehouse: BigQuery (@google-cloud/bigquery)
Auth: OAuth2 (googleapis), service account (keyFilename)
Frontend: Static HTML/CSS/JS у папці public/
Статус: 🟡 в процесі

Architecture

[Browser] → Express API (:3000)
  ├── /api/campaigns → BigQuery query → campaign metrics
  ├── /api/accounts  → Google Ads API → список акаунтів
  └── /public/       → static dashboard UI

Config (з .env):
  GCP_PROJECT_ID, BQ_DATASET, BQ_LOCATION
  GOOGLE_APPLICATION_CREDENTIALS (шлях до credentials/...)
  GOOGLE_ADS_MCC_ID, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET
  GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_REFRESH_TOKEN

Key Files

Файл	Опис
`server.js`	Express сервер v2, BigQuery + Ads API
`auth_google_ads.js`	OAuth2 flow для Google Ads
`explore_accounts.js`	Скрипт розвідки структури MCC
`check_google_ads_data.js`	Перевірка наявності даних
`credentials/`	⚠️ Service account JSON (не в git!)
`public/`	Frontend дашборду

Env / Secrets

GCP_PROJECT_ID=...
BQ_DATASET=ad_data
BQ_LOCATION=EU
GOOGLE_APPLICATION_CREDENTIALS=./credentials/service-account.json
GOOGLE_ADS_MCC_ID=...
GOOGLE_ADS_DEVELOPER_TOKEN=...
GOOGLE_ADS_CLIENT_ID=...
GOOGLE_ADS_CLIENT_SECRET=...
GOOGLE_ADS_REFRESH_TOKEN=...

Файл credentials/ — в .gitignore, не пушиться.

Current Status

✅ BigQuery інтеграція (підключення, таблиці p_ads_*_<MCC_ID>)
✅ Google Ads API підключення (MCC структура)
✅ Express API ендпоінти
🟡 Frontend дашборд — базовий UI
❌ Production деплой відсутній

Known Bugs / Issues

explore_data.js, explore_data2.js, explore_data3.js — дублікати розвідочних скриптів, потрібно прибрати
test_connection.py і test_connection.js — тестові файли
BigQuery таблиці мають динамічний MCC suffix — потрібна конфігурація

TODO

Прибрати дублікатні explore_data*.js скрипти
Побудувати повноцінний дашборд (charts, filters)
Деплой на VPS (/srv/services/ad-analytics)
Додати автооновлення даних (cron / Cloud Scheduler)