from: Desktop Claude topic: fluvir-banner-analytics priority: normal date: 2026-04-29

Context

Проект кастомного трекінгу для інтерактивних DV360-банерів Флувір. Архітектура: HTML-банер → sendBeacon → Cloud Function → BigQuery → Looker Studio.

GCP Project: banner-analytics-fluvir Region: europe-central2 (Warsaw) BigQuery:

• Dataset: banner_analytics
• Table: events
• Партиція по event_date

Cloud Function:

• Назва: track
• URL: https://track-<hash>-lm.a.run.app (перевір актуальний: gcloud functions describe track --region=europe-central2 --project=banner-analytics-fluvir)
• Runtime: Node.js 20, Gen 2, allow-unauthenticated
• SA: banner-tracker-sa@banner-analytics-fluvir.iam.gserviceaccount.com

Події в таблиці (ALLOWED_EVENTS):

• impression — банер ініціалізувався
• view_start — ≥50% у viewport
• game_start — почав гру
• game_finish — дограв до кінця
• cta_click — клік на CTA
• exit — пішов до game_finish/cta_click

Корисні поля в events:

• session_id, event_name, event_date, event_ts
• product (зараз: fluvir), size (300x250, 300x600), ver, device
• cid (campaign_id), crid (creative_id), site
• payload (JSON, додаткові дані)

Приклад SQL для аналізу:

SELECT
  event_name,
  COUNT(*) AS total,
  COUNT(DISTINCT session_id) AS unique_sessions
FROM `banner-analytics-fluvir.banner_analytics.events`
WHERE event_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
GROUP BY event_name
ORDER BY total DESC

Вирва (funnel) по product='fluvir':

SELECT
  event_name,
  COUNT(DISTINCT session_id) AS users
FROM `banner-analytics-fluvir.banner_analytics.events`
WHERE product = 'fluvir'
GROUP BY event_name

Код проекту на Desktop: D:\Claude Code\banners\Інтерактивні банери\tracking\

Credentials

[PASSEPARTOUT: google/banner-analytics-fluvir-reader.md] Щоб VPS Claude міг читати BQ у цьому проекті — найпростіше: додай ad-pipeline-worker@ad-analytics-hub.iam.gserviceaccount.com як BigQuery Data Viewer у проект banner-analytics-fluvir:

gcloud projects add-iam-policy-binding banner-analytics-fluvir
--member="serviceAccount:ad-pipeline-worker@ad-analytics-hub.iam.gserviceaccount.com"
--role="roles/bigquery.dataViewer"

Після цього VPS може читати через вже існуючий /srv/passepartout/google/ad-pipeline-worker-sa.json [/PASSEPARTOUT]