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

Этот гайд поможет подключить рекламные аккаунты Facebook (Meta) к PostTrack.
Вставляйте свои скриншоты в отмеченные места — имена файлов даны как подсказка.

---

Содержание

1. Что понадобится
2. Шаг 1. Создать приложение в Meta for Developers
3. Шаг 2. Привязать приложение к бизнесу
4. Шаг 3. Пполучить токен
5. Шаг 4. Выдать доступ к рекламным аккаунтам
6. Шаг 5. Добавить интеграцию в PostTrack
7. Шаг 6. Импорт и проверка аккаунтов
8. Проверка работоспособности
9. Частые ошибки и решения
10. Примечания по безопасности
11. FAQ
12. Глоссарий

---

Что понадобится

• Доступ в Meta for Developers (developers.facebook.com).
• Business Manager (Business Settings) с вашими рекламными аккаунтами.
• App ID и App Secret будущего приложения.
• System User токен с правами ads_read (и при необходимости read_insights).

---

Шаг 1. Создать приложение в Meta for Developers

1. Зайдите на developers.facebook.com → My Apps → Create App.

   

2. В следующем окне ввыдети название приложение и нажмите Далее

   

3. Выберите "Отслеживайте данные по результативности рекламы, используя Marketing API" и нажмите Далее

   

4. Выберите "Business" и нажмите Далее

   

5. На странице требование просто нажимаем далее

   

6. Нажмите кнопку создать приложениие

   

---

Шаг 2. Получение данных

1. Переходите в панель приложение и далее переходи в пункт "Настройки"

   

2. Получение EAA токена, переходим в пункт "Инструменты", включаем ads_read и генерируем маркер доступа, сохраняем

   

3. Получение APP ID и APP Secret, переходив в пункт "Настройки приложения" => "Основное", получаем данные и сохраняем

   

---

Шаг 3. Добавление данных в PostTrack

1. Перейдите в пункт Агентсва

2. Нажимаем кнопку добавить и добавляем данные приложения

   

3. Импорт аккаунтов, переходим в пункт "Аккаунты Facebook" импортируем нужные аккаунты Facebook или добавляем все

   

Проверка работоспособности

• Перейдите на вкладку Статистика.
• Выберите период (по умолчанию — последние 7 дней) и нажмите Показать.
• При необходимости нажмите Синхронизировать — сервис подтянет свежие Insights и обновит таблицу.

---

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

Симптом	Возможная причина	Что сделать
Пустой список при импорте	У System User нет доступа к Ad Account	Выдайте доступ в Business Settings → Ad Accounts → Assign
401/403 при запросах	Токен просрочен/неверный, нет нужных прав	Сгенерируйте новый токен с ads_read и, при необходимости, read_insights
Нет данных в отчёте	Для выбранного периода не было трафика или аккаунт не импортирован	Проверьте период и импорт; выполните Синхронизацию
Ошибка валидации App	App ID/Secret не соответствуют токену	Проверьте связку App + System User Token
Разные валюты	Разные аккаунты в разных валютах	Группируйте по аккаунтам и анализируйте отдельно

---

Примечания по безопасности

• Не делитесь App Secret и Access Token в открытых каналах.
• Ограничьте доступ к PostTrack только доверенным пользователям.
• Регулярно ревокуйте (отзывайте) старые токены System User и генерируйте новые.
• Логируйте действия интеграции и настраивайте алерты на ошибки.

---

FAQ

Нужны ли права ads_management?
Нет, достаточно ads_read (и при необходимости read_insights).

Можно ли подключить несколько приложений?
Да. Добавьте каждое приложение отдельно и импортируйте его аккаунты.

А если у меня только ID без act_?
Поддерживается оба формата — act_123 или 123.

Сколько времени занимает синхронизация?
Зависит от числа аккаунтов и периода — обычно от секунд до нескольких минут.

---

Глоссарий

• App ID / App Secret — идентификаторы вашего приложения в Meta for Developers.
• System User Token — сервисный токен, от имени системного пользователя бизнеса.
• Business Manager — админ-панель компании (бизнеса) в Meta.
• ads_read / read_insights — права (пермишены) для доступа к данным Ads/Insights.
• act_XXXXXXXXXXXX — идентификатор рекламного аккаунта.

---