name: Meta Ads toolkit (credentials + helper scripts) description: Де зберігаються Meta app credentials і як швидко прогнати аудит будь-якої кампанії через хелпер-скрипти /srv/tools/meta-ads/ type: reference originSessionId: 0f7ae096-671e-429e-ae6b-4a01a0ea09ca

Meta Ads toolkit

App: delta-graph (ID 1327888782563204), намес namespace medizine.ua, DPO: Volodymyr Nikolaychuk (Deltaswiss) Business Manager: DMAG KZ (ID 358625660399717) Власник app на боці Deltamedical: Вова (Digital Lead)

Credentials (passepartout)

• /srv/passepartout/meta/vova-ads-app.txt — App ID + App Secret (600)
• /srv/passepartout/meta/vova-ads-app.meta — опис, скоупи
• /srv/passepartout/meta/vova-user-token-YYYY-MM-DD.txt — short-lived user token (1-2 год, для ad-hoc тестів)
• /srv/passepartout/meta/vova-systemuser-token.txt — ще не створений. System User token для регулярного read-only доступу. TODO: попросити Вову зробити read-only System User (Role Employee, scope ads_read, permissions View Performance на ad accounts).

Стан app (2026-04-23)

• App Mode: Live ✓
• Products: Marketing API ✓, Facebook Login for Business ✓
• Ad Library API: ❌ чекає identity confirmation Вови (facebook.com/ID/confirm)
• App Review: не потрібен для власних кабінетів через BM

Чи API працює

Через токен Вови доступні 26 ad accounts (з них 17 ACTIVE): SH, CHC, WHC, PHC1/PHC2, Delta Medical (CY), Medizine, Deltaswiss AG/New, DM KZ/UZ, Humer, Bjola, BRauto, Opora ads, Schonen, Humanist, Up&Do World, і т.д. Повний список у /srv/tools/meta-ads/README.md.

Хелпер-скрипти

• python3 /srv/tools/meta-ads/list-accounts.py — усі доступні кабінети зі статусами
• python3 /srv/tools/meta-ads/audit.py <account_id> "<campaign_substring>" — повний audit кампанії: metrics, ad sets, placements breakdown, best-practices check (Audience Network, застарілі об'єктиви, creative fatigue, stop dates). Формат виводу — таблички з 🔴-маркерами.
• Токен автоматично береться з ENV META_ACCESS_TOKEN → System User token → найсвіжіший short-lived.

How to apply:

• Коли Сергій просить "перевір кампанію X у кабінеті Y" — перший запуск: audit.py Y "X". Скрипт дає 80% аудиту за 30 секунд.
• Для кастомного періоду: --since 2026-04-01 --until 2026-04-23
• Результат — копіювати у markdown-звіт і через Reports Hub віддавати Сергію (див. report_delivery.md).

Якщо токен протух:

• Попросити нового через Graph API Explorer (швидко) або створити System User token у BM (надовго).
• Скрипт сам підхопить найсвіжіший файл vova-user-token-*.txt.

Приклад повного audit (2026-04-23 Perfectil | cpc у WHC)

Звіт: /srv/research/2026-04-23/meta-ads-audit-perfectil-cpc-whc.md Ключове: 77% бюджету летіло в Audience Network, об'єктив застарів, кампанія жива 2+ роки без рестарту.