← всі звіти · meta-app-delta-graph-activation.md

Meta App "delta-graph" — активація для Ads Library і Marketing API

Кому: Вова (Digital Lead) App: delta-graph (App ID 1327888782563204) Статус зараз: Development Mode → API блокує запити з помилкою "App role required" Мета: увімкнути перегляд реклами в кабінетах (Marketing API) і Ad Library (публічну бібліотеку реклами Meta) Дата: 2026-04-23

TL;DR — що треба зробити

Крок Що робити Час Коли обов'язково
1 Додати Привіт Вови+Сергія як Testers у Roles 2 хв Для першого тесту зараз
2 Заповнити Privacy Policy URL + App Icon + Category 10 хв Перед переводом у Live
3 App Mode: Development → Live 1 хв Для публічних даних (Ad Library)
4 Identity Confirmation (facebook.com/ID/confirm) 1-2 дні Тільки для Ad Library API
5 Products → Ad Library API → Accept Terms 2 хв Для /ads_archive
6 Створити System User у Business Manager 5 хв Для перегляду власних кабінетів

Крок 1 і 6 — достатньо щоб почати тестувати сьогодні. Кроки 2-5 — на production.

Крок 1. Додати testers у app Roles (швидкий старт)

Навіщо: щоб API запити з твого/Сергія облікового запису перестали повертати "App role required".

  1. Відкрий developers.facebook.com/apps → обери delta-graph
  2. Лівий сайдбар: App Roles → Roles
  3. Натисни Add People → обрати роль Tester (або Developer)
  4. Ввести Facebook ID або URL профілю:
    • Свій
    • Сергія
    • Мене (якщо треба тестувати з VPS — дам свій FB-акаунт окремо)
  5. Tester отримує email → приймає інвайт
  6. Після прийняття — API запити з його user token працюватимуть

Перевірка: відкрити Graph API Explorer, обрати app delta-graph, натиснути "Generate Access Token" → мають відкритись доступні endpoints.

Крок 2. Заповнити базові поля app (перед Live Mode)

Навіщо: Meta не дозволяє переключити app у Live без цих полів.

  1. delta-graph → Settings → Basic
  2. Заповни:
    • Display Name (якщо ще не повне)
    • App Icon — 1024×1024 PNG (можна логотип Deltamedical / medizine)
    • Privacy Policy URL — має бути публічним URL з Privacy Policy (напр. https://medizine.ua/privacy)
    • User Data Deletion — або URL інструкції, або callback (обираєш "Data Deletion Instructions URL" зі скріну)
    • Category — Business (вже стоїть)
    • Business Use — обери "Support my own business"
  3. Знизу — Save Changes

Без цього: перемикач "App Mode: Live" не буде доступним.

Крок 3. Перевести App Mode → Live

Навіщо: поки app у Development Mode, API обслуговує тільки testers/developers. Live Mode = публічні endpoints (Ad Library тощо) стають доступними по app token для всіх.

  1. На будь-якій сторінці app Dashboard — зверху біля назви є тумблер App Mode: Development / Live
  2. Клік → підтвердити
  3. Якщо щось не заповнено (крок 2) — Meta скаже що саме

Важливо: Live Mode ≠ App Review. Це різні речі.

Крок 4. Identity Confirmation (тільки для Ad Library)

Навіщо: Ad Library API має окрему вимогу — підтвердження особи адмінa app. Без цього /ads_archive не відкриється, навіть у Live Mode.

  1. Відкрий facebook.com/ID/confirm з акаунту, який є Admin app
  2. Процес:
    • Вибір країни (Ukraine)
    • Завантажити фото документа (паспорт / ID-карта / водійське)
    • Селфі у процесі
  3. Meta обробляє 1-2 робочих дні (іноді до 5)
  4. Коли статус стане "Confirmed" — повернись до app

Альтернатива якщо не хочеш особисто: можна зробити на Сергія, але він має бути Admin app (Roles → Administrators).

Крок 5. Activate Ad Library API

Навіщо: щоб /ads_archive (публічна бібліотека Meta) відповідала на запити.

  1. delta-graph → Add Products (ліворуч у сайдбарі)
  2. Знайти Ad Library API → Set Up
  3. Прийняти Terms
  4. На сторінці Ad Library API — активувати "Access Ad Library"
  5. Після активації + Identity Confirmation (крок 4) → тестовий запит:
    GET https://graph.facebook.com/v19.0/ads_archive
  ?search_terms=health
  &ad_reached_countries=['UA']
  &ad_type=ALL
  &access_token=<APP_ID>|<APP_SECRET>
    має повернути JSON зі списком реклам замість помилки.

Крок 6. Marketing API — System User у Business Manager

Навіщо: перегляд реклами у своїх кабінетах (Deltamedical, medizine, Demdizajn, masterdigital) через API. App Review для цього не потрібен — достатньо System User з BM.

6.1. Додати app до Business Manager

  1. Відкрий business.facebook.com/settings
  2. Лівий сайдбар: Business Assets → Apps → Add → обрати delta-graph
  3. Надати доступ до app одного з твоїх BM

6.2. Створити System User

  1. BM Settings → Users → System Users → Add
  2. Ім'я: наприклад API Reader Delta · Роль: Admin (або Employee якщо тільки read)
  3. Натиснути Add Assets → обрати:
    • Apps → delta-graph (Full Control)
    • Ad Accounts → обрати всі потрібні кабінети Deltamedical (View/Manage Campaigns достатньо для read)
    • Pages → якщо треба читати пост-рекламу

6.3. Згенерувати постійний token

  1. На сторінці System User — Generate New Token
  2. Обрати delta-graph як app
  3. Обрати scopes: ads_read, business_management (для Ad Library також ads_management, але не обов'язково для read-only)
  4. Token Expiration: Never (System User token не протухає)
  5. Копіюй токен і зберігай надійно — Meta не покаже його вдруге

Тестовий запит на перегляд реклами в кабінеті:

GET https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads
  ?fields=id,name,status,creative,effective_status,adset_id
  &limit=10
  &access_token=<SYSTEM_USER_TOKEN>

Коли може знадобитись App Review

НЕ потрібен для:

Потрібен ТІЛЬКИ якщо:

Для нашого use-case (Deltamedical + medizine + дочірні кабінети — всі свої) App Review не потрібен.

Де зберігаються credentials

Перевірка що все працює (чек-лист)

Якщо по якомусь пункту застрягнеш — кидай помилку, розберемо.

Коли зробиш кроки 1 і 6 (додав testers + створив System User) — кинь мені токен System User, я перевірю що API читає Deltamedical кабінети і дам код для first report.