ads.updateAds

ad_edit_specification

ad_id integer, обязательный Идентификатор редактируемого объявления.

cpc number Если cost_type = 0 — цена за переход. Цена указывается в рублях с копейками в дробной части.

cpm number Если cost_type = 1 — цена за 1000 показов. Цена указывается в рублях с копейками в дробной части.

ocpm number Если cost_type = 3 — цена за действие для oCPM. Цена указывается в рублях с копейками в дробной части.

impressions_limit integer Если ad_format = 9 или 11 и cost_type = 1 — ограничение количества показов данного объявления на одного пользователя.

Возможные значения: 1, 2, 3, 5, 10, 15, 20.

impressions_limited integer, [0,1] Если cost_type = 1 и impressions_limit не может быть задан — признак того, что количество показов объявления на одного пользователя ограничено.

• •
  0 — нет ограничения;
• •
  1 — не более 100 показов на одного пользователя.

impressions_limit_period Если ad_format = 9 или 11 и cost_type = 1 — может быть задан период ограничения на количество показов на одного пользователя. Значение задаётся в секундах, должно быть кратно суткам (86400 секунд), максимум 90 суток. При наступлении нового периода счетчик показов сбрасывается.

• •
  0 — отключает сброс счётчика показов. int (числовое значение).

ad_platform integer, string Ркламные площадки, на которых будет показываться объявление:

• •
  (если ad_format = 1 и cost_type = 0)

  • •
    0 — ВКонтакте и сайты-партнёры,
  • •
    1 — только ВКонтакте.
• •
  (если ad_format = 9 или ad_format = 11)

  • •
    all — все площадки,
  • •
    desktop — полная версия сайта,
  • •
    mobile — мобильный сайт и приложения.
• •
  (если ad_format = 12)

  • •
    all — все площадки.

ad_platform_no_wall integer, [0,1] Только для ad_format = 9 или 11. 1 — не показывать объявление на стенах сообществ (по умолчанию 0). Используется только вместе с ad_platform.

ad_platform_no_ad_network integer, [0,1] Только для ad_format = 9 или 11. 1 — не показывать объявление в рекламной сети (по умолчанию 0). Используется только вместе с ad_platform.

publisher_platforms string Только для ad_format = 9 или 11. На каких площадках будет показываться объявление:

• •
  all — все площадки (по умолчанию),
• •
  social — все соцсети (ВКонтакте и Одноклассники),
• •
  vk — только ВКонтакте.

day_limit integer Дневной лимит в рублях.

all_limit integer Общий лимит в рублях.

category1_id integer Идентификатор тематики или подраздела тематики объявления. Если объявление имеет несколько тематик, то дополнительную можно задать в параметре category2_id. См. ads.getCategories.

category2_id integer Идентификатор тематики или подраздела тематики объявления.

age_restriction integer Отображение отметки возрастного ограничения на объявлении. Возможные значения:

• •
  0 — не отображать отметку;
• •
  1 — использовать отметку 0+;
• •
  2 — использовать отметку 6+;
• •
  3 — использовать отметку 12+;
• •
  4 — использовать отметку 16+;
• •
  5 — использовать отметку 18+.

status integer, [0,1] Статус рекламного объявления (0 — остановлено, 1 — запущено).

name string, от 3 до 60 символов Название объявления (для использования в рекламном кабинете).

title string Заголовок объявления. Может быть задан только для некоторых рекламных форматов. Строка длиной от 3 до 33 символов; для ad_format = 11 — до 25 символов.

description string Описание объявления. Может быть задано только для некоторых рекламных форматов. Строка длиной от 3 до 70 символов; дляad_format=11` — до 90 символов.

link_url string Ссылка на рекламируемый объект в формате http://yoursite.cоmили http://vk.cоm/club1

Если в ссылке содержатся строки "{ad_id}" или "{campaign_id}", то они заменяются соответственно на ID объявления и ID кампании в момент перехода пользователя по такой ссылке. Если необходимо обновить ссылку у видеорекламы, то в параметре video нужно передать 1.

link_domain string Домен рекламируемого объекта в формате yoursite.cоm.

link_title string Заголовок рядом с кнопкой или ссылкой. Может быть задан только для некоторых рекламных форматов. Строка длиной от 3 до 25 символов.

link_button string Идентификатор кнопки объявления. Может быть задан только для некоторых рекламных форматов. Список возможных значений.

photo string Основное изображение. Может быть передано только для некоторых рекламных форматов. В качестве значения должен быть передан результат загрузки изображения на сервер.

photo_icon string Логотип. Может быть передано только для некоторых рекламных форматов. В качестве значения должен быть передан результат загрузки изображения на сервер.

video string Если ad_format = 2 или 3 — значение, полученное в результате загрузки видеозаписи на сервер (1 — если необходимо обновить link_url, не меняя видеозапись).

repeat_video integer, [0,1] Зацикливание видео. Возможные значения:

• •
  0 — не зацикливать видео,
• •
  1 — зацикливать видео.

disclaimer_medical integer, [0,1] Отображение предупреждения: «Есть противопоказания. Требуется консультация специалиста».

• •
  1 — включить отображение.

disclaimer_specialist integer, [0,1] Отображение предупреждения: «Необходима консультация специалистов».

• •
  1 — включить отображение.

disclaimer_supplements integer, [0,1] Отображение предупреждения: «БАД. Не является лекарственным препаратом».

• •
  1 — включить отображение.

start_time integer Время запуска объявления в формате Unixtime. Укажите 0 для сброса времени запуска.

stop_time integer Время остановки объявления в формате unixtime. Укажите 0 для сброса времени остановки.

weekly_schedule_hours array Расписание показа объявления по часам. Массив из семи строк. Каждая из строк соответствует дню недели и содержит последовательность символов 0 или 1. 0 — не показывать объявление в час, номер которого равен позиции символа. 1 — показывать.

weekly_schedule_use_holidays integer, [0,1] Использовать ли расписание воскресенья в праздничные дни.

stats_url Пиксель внешней статистики. Доступно в избранных кабинетах.

stats_url2 Пиксель внешней статистики. Доступно в избранных кабинетах.

autobidding Автоматическое управление ценой:

• •
  0 — выключено;
• •
  1 — включено.

Флаг, может принимать значения 0 или 1.

autobidding_max_cost integer, string Максимальное ограничение автоматической ставки в рублях с копейками, 0 - снятие ограничения.

Настройки таргетинга Набор полей, соответствующих настройкам таргетинга. См. описание возможных полей на отдельной странице.

Возвращает массив ответов на каждый запрос в массиве data. Соответствующий объект в выходном массиве содержит идентификатор изменяемого объявления и, в случае возникновения ошибки, поля error_code и error_desc.