Получение разрешений
Процесс получения разрешения позволяет проверять пользователей и приложения, которые будут получать доступ к Marketing API, и предоставлять им разрешения.
Роли в приложении
При необходимости на панели приложения вы можете назначить себе или участникам команды следующие роли: администратор, разработчик и тестировщик.
Примечание. В зависимости от предполагаемого сценария использования, возможно, вам потребуется отправить приложение на проверку, чтобы получить доступ к определенным разрешениям, связанным с управлением рекламой.
Уровни доступа, разрешения и функции
Для бизнес-приложений необходимо дополнительно получить разрешение под названием уровни доступа для Graph API. Кроме того, во время проверки приложения необходимо запросить для него права на использование нужных разрешений и функций.
Для каждого уровня доступа действуют свои ограничения и функции. Все разработчики обязаны соблюдать все Условия использования Платформы и Правила для разработчиков, предусмотренные Meta. При ЛЮБОМ уровне доступа вызовы выполняются к рабочим данным.
Уровни доступа к функциям
| Уровень доступа к функциям | Описание |
|---|---|
Бизнес-приложения автоматически получают стандартный уровень доступа ко всем разрешениям и функциям, доступным для бизнес-приложений. Это хороший вариант, если вы только начинаете работу. Вы можете создать полные сквозные рабочие процессы, после чего запрашивать полные разрешения, и можете получить доступ к неограниченному количеству рекламных аккаунтов. Некоторые вызовы API недоступны на стандартном уровне, так как они могут относиться к нескольким аккаунтам или не позволяют программным путем определить нужный аккаунт. | |
Расширенный уровень доступа предоставляется после проверки приложения и запрашивается отдельно для каждого разрешения и функции.
Вскоре Meta утвердит или отклонит вашу заявку. Если мы не сможем предоставить вашему приложению стандартный уровень доступа, то сообщим об этом. Если вам предоставят расширенный доступ, для поддержания этого статуса должны выполняться следующие условия:
|
Чтобы узнать свой текущий уровень доступа, нажмите Панель приложений > Проверка приложения > Разрешения и функции.
Доступ через Marketing API и стандартный доступ к управлению рекламой: сравнение
| Доступ через Marketing API | Стандартный доступ к управлению рекламой | Действие |
|---|---|---|
Доступ для разработки | Стандартный доступ | По умолчанию |
Стандартный доступ | Расширенный доступ | Применяется на панели приложений |
Разрешения и функции
Разрешения, которые вам нужно запросить, зависят от того, с каким API вы хотите работать.
Если приложение будет управлять только вашим собственным рекламным аккаунтом, достаточно стандартного уровня доступа и разрешений ads_read и ads_management. Если же оно будет использоваться и для чужих рекламных аккаунтов, вам потребуется расширенный доступ к разрешениям ads_read и (или) ads_management. Полный перечень доступных разрешений для бизнес-приложений см. в этом разделе.
Функции, которые нужно запросить, зависят от того, как вы планируете использовать наши API. Если вы управляете рекламой, как правило, запрашивается стандартный доступ к управлению рекламой. Полный список доступных функций для бизнес-приложений см. в этом разделе.
Чтобы получить расширенный доступ для стандартного доступа к управлению рекламой, ваше приложение должно соответствовать следующим требованиям:
- приложение должно успешно выполнить не менее 1 500 вызовов Marketing API за последние 15 дней;
- количество завершившихся ошибкой вызовов Marketing API за последние 15 дней должно быть меньше 10 %.
Если вы управляете чужой рекламой, используйте параметр scope, чтобы запросить у соответствующего пользователя разрешение ads_management или ads_read. Ваше приложение получит доступ, когда этот пользователь нажмет Разрешить.
https://www.facebook.com/v21.0/dialog/oauth?
client_id=<YOUR_APP_ID>
&redirect_uri=<YOUR_URL>
&scope=ads_management
Примечание. Заполняя поле YOUR_URL, поставьте в конце символ / (например: http://www.facebook.com/).
Примеры
| Ситуация | Что запрашивать |
|---|---|
Вам нужно управлять объявлениями из рекламных аккаунтов, которые принадлежат вам или другому лицу, предоставившему вам доступ к ним. |
|
Вам нужно просматривать отчеты по рекламе из аккаунтов, которые принадлежат вам или другому лицу, предоставившему вам доступ к ним. |
|
Вам нужно просматривать отчеты по рекламе, принадлежащей определенной группе клиентов, а также читать объявления другой группы клиентов и управлять ими. |
|
Уровни доступа и функции
В таблице ниже показано, как уровень доступа влияет на функции стандартного доступа к управлению рекламой.
| Стандартный доступ | Расширенный доступ | |
|---|---|---|
Ограничения количества аккаунтов | Управление неограниченным количеством рекламных аккаунтов. Администраторы или разработчики приложения могут выполнять вызовы API от имени администраторов рекламных аккаунтов или рекламодателей. | Управление неограниченным количеством рекламных аккаунтов, для которых получено разрешение |
Ограничения числа обращений | Существенное ограничение числа обращений на рекламный аккаунт. Только для разработки. Не подходит для рабочих приложений, в которых публикуется настоящая реклама. | Незначительное ограничение числа обращений на рекламный аккаунт. |
Business Manager | Ограниченный доступ к Business Manager API и Catalog API. Business Manager нельзя применять для управления рекламными аккаунтами, разрешениями пользователей и Страницами. | Доступ ко всем возможностям Business Manager API и Catalog API. |
Системный пользователь | Можно создать одного обычного системного пользователя и одного — с правами администратора. | Можно создать 10 обычных системных пользователей и одного — с правами администратора. |
Создание страниц | Создание Страниц с помощью API не поддерживается. | Создание Страниц с помощью API не поддерживается. |
Уровни доступа и стандартный доступ к управлению рекламой
Для разрешений и функций в приложениях предусмотрено два различных уровня доступа: стандартный и расширенный. Обратите внимание: термин "стандартный доступ" здесь не связан с функцией стандартного доступа к управлению рекламой. Для получения расширенного доступа для стандартного доступа к управлению рекламой приложение должно пройти проверку.
Подтверждение компании
Эта процедура позволяет нам убедиться в подлинности компании и проводится, если приложению требуется доступ к конфиденциальным данным. Подробнее о подтверждении компании см. в этой статье.