Перейти к основному содержимому

Интеграция Facebook Ads с PostTrack (через System User)

Подключение делает администратор вашего Business Manager. Все шаги занимают 10–15 минут.

Что потребуется​

  • Доступ администратора к вашему Business Manager.
  • Наш App ID (приложение PostTrack в Meta for Developers).
  • Возможность создавать System User в вашем BM.
  • Токен System User с правом ads_read (опционально business_management для чтения структуры BM).

Шаг 1. Добавьте приложение PostTrack в ваш BM​

  1. Откройте Business Settings.
  2. Перейдите Accounts → Apps → Add → Connect an App ID.
  3. Вставьте App ID PostTrack и подтвердите.

Добавить приложение — скрин

Шаг 2. Создайте System User (только чтение)​

  1. Business Settings → Users → System Users → Add.
  2. Тип: Employee.
  3. Имя: например, PostTrack Read SU.

Создать System User — скрин

Шаг 3. Привяжите System User к приложению​

  1. Откройте карточку созданного System User.
  2. Add Assets → Apps → выберите PostTrack → Assign.

Привязка SU к App — скрин

Шаг 4. Дайте System User доступ к рекламным аккаунтам​

  1. В карточке System User нажмите Add Assets → Ad Accounts.
  2. Отметьте все нужные аккаунты.
  3. Роль: Ad Account Analyst (read-only).
  4. Если доступно — включите опцию на все текущие и будущие аккаунты.

    Для чтения креативов/каталогов дополнительно выдайте Read на Catalogs / Pixels.

Назначить Ad Accounts — скрин

Шаг 5. Сгенерируйте токен доступа System User​

  1. В карточке System User нажмите Generate New Token.
  2. Приложение: PostTrack.
  3. Срок: максимально доступный.
  4. Разрешения (scopes): минимум ads_read и read_insights, опционально business_management (read).
  5. Скопируйте Access Token и сохраните.

Сгенерировать токен — скрин

Шаг 6. Вставьте токен в PostTrack​

  1. В PostTrack: Integrations → Meta Ads → Надёжный режим (System User).
  2. Вставьте Access Token и сохраните — начнётся проверка и импорт.

Вставить токен в PostTrack — скрин

Что делает PostTrack после вставки токена​

  1. Валидация токена:
    • GET https://graph.facebook.com/v19.0/me?access_token=...
    • (опционально) GET /debug_token с App Token.
  2. Импорт аккаунтов:
    • GET https://graph.facebook.com/v19.0/me/adaccounts?limit=500 (с пагинацией).
    • Сохраняем act_id, имя, валюту, статус, visible=true.
  3. Сверка с ожидаемыми (если загружен CSV с act_id).
  4. Синхронизации:
    • Инсайты каждый час: https://graph.facebook.com/v19.0/act_{AD_ACCOUNT_ID}/insights на уровнях account|campaign|adset|ad, окно сегодня + последние 7–14 дней.
    • Discovery каждые 30–60 мин: повтор me/adaccounts.
    • Backfill истории — пакетами.
  5. Мониторинг:
    • 403/permissions → visible=false, уведомление.
    • Rate-limit → автоматический бэкофф и сужение окна.

Проверка (чек-лист)​

  • SU привязан к App, роль Ad Account Analyst на нужных аккаунтах.
  • Токен имеет ads_read (опционально business_management).
  • GET /me/adaccounts возвращает все нужные act_....
  • В PostTrack виден источник, список аккаунтов и свежие данные (сегодня/вчера).
  • В логах нет постоянных 403/190.

Частые ошибки и решения​

СимптомПричинаРешение
В назначениях видны только Apps/WhatsApp, нет «Ad Accounts»Назначение не у System User или нет прав AdminОткрывайте Users → System Users → ваш SU → Add Assets → Ad Accounts; проверьте роль Business Admin
Не все аккаунты видныSU не выдан Analyst на части аккаунтовSystem User → Add Assets → Ad Accounts и добавьте недостающие
190: Token expired/invalidТокен просрочен/создан без нужных scopeСгенерируйте новый токен с ads_read и замените
200/10: Insufficient permissionsНедостаточно прав на уровне аккаунтаУбедитесь, что SU имеет Analyst на этом аккаунте
429/Rate limitСлишком частые запросыПодождите; PostTrack замедлит частоту и сузит окно

Безопасность​

  • Токены храним зашифрованно (field-level AES-GCM; ключи в KMS).
  • Выдавайте только read-only доступы, регулярно ревокуйте старые токены.
  • Доступ к интеграциям — только для доверенных пользователей.

FAQ​

Нужен ли ads_management? Нет, достаточно ads_read.
Аккаунты из разных BM? Да, если владельцы тех BM выдадут вашему SU роль Analyst или дадут партнёрский доступ вашему BM.
Как добавить новые аккаунты позже? Выдайте SU роль Analyst на них — PostTrack найдёт их автоматически в течение часа.
Разные валюты? Не проблема: анализируйте по аккаунтам или используйте конвертацию в PostTrack.