Обзор

Marketing API работает по протоколу HTTP, и с его помощью можно программным путем запрашивать данные, создавать объявления и управлять ими, а также выполнять множество других задач. В этом разделе приведена общая информация об использовании Marketing API, получении доступа, управлении версиями и т. д.

Этот API работает по протоколу HTTP и поэтому совместим со всеми языками и программными решениями, поддерживающими HTTP (включая cURL и почти все современные браузеры). В основе Marketing API лежит Meta Graph API, поэтому практически все запросы следует передавать на URL хоста graph.facebook.com.

Основные понятия

Ниже перечислены понятия, в которых нужно разбираться для эффективной работы с Marketing API.

Структура рекламных кампаний

Реклама на Meta упорядочена на трех уровнях: кампания, группа объявлений и отдельное рекламное объявление. API открывает разработчикам доступ к четвертому уровню рекламы — креативам.

Получение разрешений

Чтобы использовать конечные точки Marketing API, приложение должно получить разрешения для Graph API на нескольких уровнях.

Аутентификация

Узнайте, как получить и сохранить маркер доступа, необходимый для вызовов API.

Ограничение числа обращений

В Marketing API действует собственная логика ограничения числа обращений. Ограничения Graph API на него не распространяются.

Управление версиями

На платформе Meta используются две модели управления версиями: основная и расширенная. Подробнее о предстоящих изменениях и упраздненных функциях см. в разделах, посвященных управлению версиями и миграции: График выпуска новых версий, Миграция и Журнал изменений.

Проверка приложения

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

Разрешения

Существует два основных вида разрешений для рекламы: ads_management и ads_read. Их следует предоставить приложению, которое будет выполнять вызовы. Разрешения можно запросить во время проверки приложения. См. список доступных разрешений для бизнес-приложений.

Коды ошибок

При использовании API могут выводиться сообщения об ошибках с указанием кода. В статье по ссылке приведена подробная информация о каждой ошибке.

Последующая обработка запросов

Узнайте, как обрабатываются полученные Meta запросы.