Права доступа Meta Ads
Коннектор Meta Ads требует определённый набор разрешений (scopes) для доступа к рекламным данным через Facebook Graph API. Ниже приведён полный список запрашиваемых разрешений с описанием и категорией обязательности.
Обязательные разрешения
ads_read
- Назначение: Чтение рекламных данных
- Описание: Доступ к кампаниям, группам объявлений, объявлениям и статистике
- API-эндпоинты:
/act_{ad_account_id}/campaigns,/act_{ad_account_id}/adsets,/act_{ad_account_id}/ads,/act_{ad_account_id}/insights - Без этого разрешения: Невозможно получить какие-либо рекламные данные
read_insights
- Назначение: Чтение статистики
- Описание: Доступ к метрикам эффективности через Insights API
- API-эндпоинт:
/act_{ad_account_id}/insights - Без этого разрешения: Доступны структурные данные (кампании, группы, объявления), но не метрики
Опциональные разрешения
business_management
- Назначение: Управление бизнес-аккаунтами
- Описание: Доступ к списку рекламных аккаунтов в Business Manager
- API-эндпоинт:
/me/businesses - Важность: Рекомендуется для аккаунтов, управляемых через Business Manager. Без него список аккаунтов может быть неполным.
pages_show_list
- Назначение: Список страниц
- Описание: Просмотр списка Facebook-страниц пользователя
- API-эндпоинт:
/me/accounts - Важность: Необходимо для получения Instagram-аккаунтов, связанных со страницами
pages_read_engagement
- Назначение: Вовлечённость страниц
- Описание: Доступ к статистике вовлечённости Facebook-страниц
- API-эндпоинт:
/{page_id}/insights - Важность: Требуется для коннектора Meta Pages
instagram_basic
- Назначение: Базовый доступ к Instagram
- Описание: Доступ к базовым данным Instagram-аккаунтов (имя, username, подписчики)
- API-эндпоинт:
/{ig_user_id}?fields=id,username,name - Важность: Требуется для коннектора Instagram Insights
instagram_manage_insights
- Назначение: Статистика Instagram
- Описание: Доступ к метрикам Instagram-аккаунтов (охват, показы, вовлечённость)
- API-эндпоинт:
/{ig_user_id}/insights - Важность: Требуется для коннектора Instagram Insights
Проверка прав доступа
Вы можете проверить текущий набор разрешений через Facebook Access Token Debugger. Вставьте токен доступа, чтобы увидеть:
- Список активных разрешений
- Дату истечения токена
- Приложение, выдавшее токен
Обновление токена
Токены доступа Meta имеют ограниченный срок действия:
- Краткосрочный токен: действует 1-2 часа
- Долгосрочный токен: действует 60 дней, обновляется автоматически при активности пользователя
LightLead автоматически обновляет долгосрочные токены. Если токен истёк, потребуется повторная авторизация — см. Переподключение коннектора.