Версия API Marketing

Справка по API Marketing

Корневые узлы API Marketing

Здесь приведен полный список корневых узлов API Marketing от Facebook со ссылками на справку по каждому узлу. Информацию об архитектуре API, вызове корневых узлов, границ контекста и т. д. см. в этом разделе.

Чтобы получить доступ ко всей информации, нужно войти на Facebook.

Узел Описание

/{AD_ACCOUNT_USER_ID}

Пользователь Facebook, создающий объявления. Один такой пользователь может иметь роли в нескольких рекламных аккаунтах.

/act_{AD_ACCOUNT_ID}

Компания, управляющая рекламой.

/{AD_ID}

Информация об объявлении (креативах, измерении эффективности и т. д.).

/{AD_CREATIVE_ID}

Формат объявления: изображение, кольцевая галерея, подборка или видео.

/{AD_SET_ID}

Содержит все объявления с одним и тем же бюджетом, графиком показа, ставками и настройками таргетинга.

/{AD_CAMPAIGN_ID}

Цель рекламной кампании. Может содержать одну или несколько групп объявлений.

User

Границы контекста

Граница контекста Описание

/adaccounts

Все рекламные аккаунты, связанные с этим пользователем.

/accounts

Все страницы и места, которые администрирует этот пользователь.

/promotable_events

Все мероприятия, которые можно рекламировать и которые создали вы или принадлежат администрируемым вами страницам.

Рекламный аккаунт

Все подборки рекламных объектов в API Marketing относятся к рекламному аккаунту.

Границы контекста

Наиболее популярные границы контекста, относящиеся к узлу рекламного аккаунта. Полный список см. в справке по границам контекста рекламного аккаунта.

Граница контекста Описание

/adcreatives

Дизайн и контент объявления.

/adimages

Библиотека изображений, используемых в рекламных креативах. Их можно загружать и управлять ими по отдельности.

/ads

Данные об объявлениях (креативах, измерении эффективности и т. д.).

/adsets

Группы объявлений. Содержат все объявления с одним и тем же бюджетом, графиком показа, ставками и настройками таргетинга.

/advideos

Библиотека видео, используемых в рекламных креативах. Их можно загружать и управлять ими по отдельности.

/campaigns

Рекламные кампании и их цели. Могут содержать одну или несколько групп объявлений.

/customaudiences

Пользовательские аудитории в рекламном аккаунте.

/insights

Аналитический интерфейс для сортировки, генерации асинхронных отчетов и удаления дубликатов в дочерних объектах.

/users

Список пользователей, связанных с рекламным аккаунтом.

Объявление из группы объявлений.

Границы контекста

Наиболее популярные границы контекста, относящиеся к узлу объявления. Полный список см. в справке по границам контекста объявления.

Граница контекста Описание

/adcreatives

Внешний вид и контент объявления.

/insights

Статистика по результативности рекламы.

/leads

Лиды, связанные с рекламой для лидов.

/previews

Предварительный просмотр готового объявления.

Группа объявлений

Группа объявлений — это набор объявлений с общим бюджетом (дневным или на весь срок действия группы), графиком показа, типом ставки, информацией о ставках и параметрами таргетинга.

Границы контекста

Наиболее популярные границы контекста, относящиеся к узлу группы объявлений. Полный список см. в справке по границам контекста группы объявлений.

Граница контекста Описание

/activities

Журнал действий в группе объявлений.

/adcreatives

Дизайн и контент объявлений.

/ads

Необходимые данные об объявлениях (креативах, измерении эффективности и т. д.).

/insights

Статистика по результативности рекламы.

Рекламная кампания

Кампания — это наиболее общая организационная структура в рекламном аккаунте, представляющая одну цель рекламы.

Границы контекста

Наиболее популярные границы контекста, относящиеся к узлу рекламной кампании. Полный список см. в справке по границам контекста рекламной кампании.

Граница контекста Описание

/ads

Необходимые данные об объявлениях (креативах, измерении эффективности и т. д.).

/adsets

Группы объявлений. Содержат все объявления с одним и тем же бюджетом, графиком показа, ставками и настройками таргетинга.

/insights

Статистика по результативности рекламы.

Рекламный креатив

Макет, представляющий формат и контент объявления.

Границы контекста

Наиболее популярные границы контекста, относящиеся к узлу рекламного креатива. Полный список см. в справке по границам контекста рекламного креатива.

Граница контекста Описание

/previews

Предварительный просмотр объявления на основе существующего объекта рекламного креатива.