Версия API Marketing

Справка по API Marketing

Здесь приведен полный список корневых узлов API Marketing от Facebook со ссылками на справку по каждому узлу. Границы контекста перечислены отдельно. Подробнее о том, как использовать API Graph: как устроена архитектура, как вызывать корневые узлы и границы контекста и т. д.

Главные корневые узлы:

Корневой узел Значение

/{USER}

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

/act_{AD_ACCOUNT_ID}

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

/{CAMPAIGN_ID}

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

/{AD_SET_ID}

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

/{AD_ID}

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

Пользователь

Границы

Граница контекста Значение

/adaccountgroups

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

/adaccounts

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

/accounts

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

/promotable_events

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

/promotable_domains

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

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

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

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

Граница контекста Значение

/campaigns

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

/adsets

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

/ads

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

/adcreatives

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

/adimages

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

/advideos

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

/activities

Журнал действий в рекламном аккаунте.

/adtags

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

/adcampaignconversions

Данные о конверсиях по группам объявлений в рекламном аккаунте.

/adgroupconversions

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

/customaudiences

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

/generatepreviews

Генерация предварительного просмотра объявления.

/offsitepixels

Пиксели, связанные с этим аккаунтом.

/reachestimate

Генерация приблизительного охвата рекламы с заданными спецификациями таргетинга.

/reportstats

API Reporting: получение данных о рекламном аккаунте и планирование отчетов.

/adcampaignstats

Статистика по группам объявлений в рекламном аккаунте.

/adgroupstats

Статистика по объявлениям в рекламном аккаунте.

/targetingsentencelines

Генерация описания таргетинга группы объявлений в понятной для человека форме.

/users

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

/insights

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

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

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

Граница контекста Значение

/adsets

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

/ads

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

/adtags

Метки кампаний (помогают быстро находить похожие кампании).

Общая статистика по кампаниям.

/insights

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

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

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

Граница контекста Значение

/ads

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

/adcreatives

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

/activities

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

/adtags

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

/conversions

Данные о конверсиях группы объявлений.

/insights

Аналитический интерфейс Предоставляет такие функции, как устранение дублирования результатов по дочерним объектам, сортировка и асинхронное получение отчетов.

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

Граница контекста Значение

/adcreatives

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

/adtags

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

/conversions

Данные о конверсиях объявления.

/keywordstats

Статистика по целевому ключевому слову, используемому в объявлении.

/previews

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

/reachestimate

Приблизительный охват объявления.

Статистика объявления.

/targetingsentencelines

Описание таргетинга группы объявлений в понятной для человека форме.

/trackingtag

Назначение объявлению тегов кликов (позволяют отслеживать клики). Для этого укажите URL, по которому пользователь будет переходить после нажатия объявления.

/insights

Аналитический интерфейс Предоставляет такие функции, как устранение дублирования результатов по дочерним объектам, сортировка и асинхронное получение отчетов.

Оформление

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

Граница контекста Значение

/previews

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