ads

ads.createCampaigns

Создает рекламные кампании.

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

Параметры

account_id

integer

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

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

data

text

Сериализованный JSON-массив объектов, описывающих создаваемые кампании. Описание объектов campaign_specification смотрите ниже.

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

campaign_specification

client_id Обязательный параметр, int (числовое значение). Только для рекламных агентств. id клиента, в рекламном кабинете которого будет создаваться кампания.

type Тип кампании:

  • •
    normal — обычная кампания, в которой можно создавать любые объявления, кроме описанных в следующих пунктах;
  • •
    promoted_posts — кампания, в которой можно рекламировать только записи в сообществе;
  • •
    adaptive_ads — кампания, в которой можно рекламировать только объявления адаптивного формата.

name Название рекламной кампании. Строка длиной от 3 до 60 символов.

day_limit Дневной лимит в рублях. Положительное число.

all_limit Общий лимит в рублях. Положительное число.

start_time Время запуска кампании в формате unixtime. Положительное число.

stop_time Время остановки кампании в формате unixtime. Положительное число.

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

Результат

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

Коды ошибок

601
Permission denied. You have requested too many actions this day. Try later.
602
Some part of the request has not been completed

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