ads

ads.getAdsTargeting

Возвращает параметры таргетинга рекламных объявлений

Для вызова метода можно использовать:
• ключ доступа пользователя (требуется право доступа: ads — выдаётся в исключительных случаях через запрос в поддержку по электронной почте [email protected])

Параметры

account_id

integer

Идентификатор рекламного кабинета.

Обязательный параметр

client_id

integer

Для рекламных агентств.

id клиента, у которого запрашиваются рекламные объявления.

include_deleted

checkbox

Флаг, задающий необходимость вывода архивных объявлений.

  • •
    0 — выводить только активные объявления;
  • •
    1 — выводить все объявления.
only_deleted

checkbox

campaign_ids

text

Фильтр по рекламным кампаниям. Сериализованный JSON-массив, содержащий id кампаний. Если параметр равен null, то будут выводиться рекламные объявления всех кампаний.

ad_ids

text

Фильтр по рекламным объявлениям. Сериализованный JSON-массив, содержащий id объявлений. Если параметр равен null, то будут выводиться все рекламные объявления.

limit

integer

Ограничение на количество возвращаемых объявлений. Используется, только если параметр ad_ids равен null, а параметр campaign_ids содержит id только одной кампании.

offset

integer

Смещение, необходимо для выборки определенного подмножества значений.

Замечание Если одновременно включены фильтры campaign_ids и ad_ids, то выведены будут следующие объявления:

  1. 1.
    Если id объявления указано в ad_ids, то оно выводится.
  2. 2.
    Если объявление принадлежит рекламной кампании, чей id указан в campaign_ids, то оно выводится.
  3. 3.
    Если существует объявление с id, указанным в ad_ids и оно принадлежит кампании, чей id указан в campaign_ids, то эта рекламная кампания игнорируется, т.е. для нее правило 2 не работает.

Выводится не более 2000 объявлений из не более чем 2000 кампаний.

Результат

Возвращает массив объектов-описаний таргетинга объявлений. Отрицательные id в поле cities означают id регионов, взятых с обратным знаком. Поле count содержит размер целевой аудитории на момент сохранения объявления.

Коды ошибок

601
Permission denied. You have requested too many actions this day. Try later.

В ходе выполнения могут произойти общие ошибки

Связанные версии

Перейти на страницу версий API
5.22

Убрано ошибочное разделение параметра schools на два. В запросах теперь снова используется один параметр schools. Список идентификаторов для этого параметра следует получать с помощью метода ads.getSuggestions.

5.16

Параметр schools разделён на два: schools и universities. Теперь id этих объектов такие же, как и в методах database.