zone

Разместить кампанию в разделе сайта.

Формат запроса

https://adfox.yandex.ru/api/v1
  ? object=campaign
  & action=placing
  & actionObject=zone
  & objectID=<integer>
  & actionObjectID=<integer>
  & actionStatus=<integer>
  & [rotationMethodID=<integer>]
  & [[maxImpressions](*maxImpressions)=<integer>]
  & [[maxImpressionsPerDay](*maxImpressionsPerDay)=<integer>]
  & [[maxImpressionsPerHour](*maxImpressionsPerHour)=<integer>]
  & [[maxClicks](*maxClicks)=<integer>]
  & [[maxClicksPerDay](*maxClicksPerDay)=<integer>]
  & [[maxClicksPerHour](*maxClicksPerHour)=<integer>]
  & [dateStart=<YYYY-MM-DD HH:mm>]
  & [dateEnd=<YYYY-MM-DD HH:mm>]
  & [targetingProfileID=<integer>]

objectID*

ID объекта, над которым производится действие.

actionObjectID*

ID площадки.

Читайте также:

actionStatus*

Включить или выключить размещение.

Допустимые значения:

  • 0 — выключить;
  • 1 — включить.

rotationMethodID

Метод ротации.

Допустимые значения:

  • −1 — не переопределен (значение наследуется от уровня выше);
  • 0 — по приоритетности — использовать значения параметров «уровень» и «приоритет» для оценки вероятности показа рекламной кампании;
  • 1 — по % от трафика — использовать значение параметра процент от трафика для оценки вероятности показа рекламной кампании.

Значение по умолчанию: -1.

maxImpressions

Максимальное количество показов баннера.

Допустимые значения: целое число от 1 до 2147483647.

maxImpressionsPerDay

Максимальное количество показов в сутки.

Допустимые значения: целое число от 1 до 2147483647.

maxImpressionsPerHour

Максимальное количество показов в час.

Допустимые значения: целое число от 1 до 2147483647.

maxClicks

Максимальное количество кликов всего.

Допустимые значения: целое число от 1 до 2147483647.

maxClicksPerDay

Максимальное количество кликов в сутки.

Допустимые значения: целое число от 1 до 2147483647.

maxClicksPerHour

Максимальное количество кликов в час.

Допустимые значения: целое число от 1 до 2147483647.

dateStart

Дата начала открутки.

Значение по умолчанию: сегодня с 00:00.

Формат передачи даты и времени: YYYY-MM-DD HH:mm

dateEnd

Дата окончания открутки.

Формат передачи даты и времени: YYYY-MM-DD HH:mm

targetingProfileID

ID профиля таргетирования.

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

Как посмотреть список ID профилей, читайте в разделе list-targetingProfile.

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

Формат ответа

<response>
<status>
  <code>{integer}</code>
</status>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=campaign&action=placing&actionObject=zone&objectID=474205&actionStatus=1&actionObjectID=3245

Ответ:

<response>
<status>
  <code>0</code>
</status>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом campaign:

Предыдущая
Следующая