---

type: subproject parent: media-planner name: Audience Research — пошук та замір аудиторій slug: audience-research status: partial-skill-exists readiness_pct: 30 created: 2026-05-05 last_updated: 2026-05-05

Media Planner — Audience Research (5-й підпроект)

Пошук та замір об'єму цільових аудиторій per канал/таргет. Сергій (voice 05.05): «у тебе частково є дані — ми використовуємо існуючий конектор до Meta для виміру об'ємів цільових аудиторій».

Why

Перед плануванням бюджету треба розуміти скільки людей можемо охопити в певному каналі/таргеті:

• Meta: «жінки 35-50, Київ, інтерес — велнес» — N reachable
• TikTok: «20-30, Україна, активні у фітнес» — M reachable
• DV360: «батьки дітей до 5 років» — K reachable
• Helsi: «діагноз остеохондроз, 45-65, Київщина» — L reachable (orenда)

Існуючий інструмент — Meta Marketing API (Delivery Estimate)

🟢 Вже маємо інфраструктуру (ad-analytics-hub/meta-ads):

• App: delta-graph (Meta Business)
• Token Вови — валідний (перевірено 2026-05-05)
• 26 ad accounts підключено
• Marketing API access live з 23.04.2026
• Helper-скрипти: audit.py, list-accounts.py (/srv/projects/ad-analytics-hub/meta/)

Meta API endpoint для аудиторій: act_<account_id>/delivery_estimate

• Input: targeting spec (geo, age, gender, interests, behaviors, custom_audiences)
• Output: estimate_ready boolean + estimate_dau / estimate_mau / estimate_dau_lower_bound / upper_bound

Тобто можемо вже зараз програмно міряти аудиторії в Meta для конкретного targeting-опису, без UI Ads Manager.

TBD per канал

Канал	Статус	Approach
Meta (FB+IG)	🟢 існуючий конектор delta-graph	act_/delivery_estimate API
TikTok	🔴 чекає App approval	TikTok Marketing API → audience/get_reach_estimate (TBD endpoint)
Google Ads	🟡 MCC є, audience reach API окремо	audienceInsights:generateInsightsFinderReport + Reach Planner API
DV360	🔴 інтеграції ще нема	DV360 Reach Planner API — потребує OAuth
Helsi	🟡 партнерська оренда	Запитуємо у партнера (їх сторона), не API

Vision (MVP)

Простий tool який:

1. Бере таргет-опис у природній мові: «жінки 35-50 з Києва, інтерес — велнес/здоров'я»
2. Конвертує у targeting spec для кожного каналу
3. Запитує API кожного каналу: Meta → TikTok → Google → DV360
4. Вертає sumary table: «Meta: 850K, TikTok: ~600K, Google: 1.2M, DV360: 400K, Helsi (orenda): 50K»

TBD

• [ ] Скрипт audience_estimator.py — Meta delivery_estimate для один targeting spec → reach
• [ ] Розширити: батч-запит для multiple targeting variations
• [ ] Інтеграція з MP-creation: коли користувач описує ЦА → estimator показує reach потенціал per канал → допомагає планувати spend
• [ ] Після TikTok app approve — додати TikTok API
• [ ] Google Ads + DV360 — окремі OAuth handoffs

Cross-references

• Umbrella: ../index.md
• Meta-ads (інфра-джерело): ../../ad-analytics-hub/meta-ads/index.md
• Meta toolkit memory: infra_meta_ads_toolkit
• Helsi context: campaign-types-playbook → "Інше → Helsi"
• Source: voice Сергій 2026-05-05 15:27 UTC

🤖 PM Changelog

2026-05-05

• Створено зі stub'у. Status переведено з 🔴 на 🟡 (30%) — Meta-конектор вже існує, можна стартувати MVP.