place

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

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

https://adfox.yandex.ru/api/v1
  ? object=campaign
  & action=placing
  & actionObject=place
  & objectID=<integer>
  & actionObjectID=<integer>
  & actionStatus=<integer>
  & [rotationMethodID=<integer>]
  & [maxImpressions=<integer>]
  & [maxImpressionsPerDay=<integer>]
  & [maxImpressionsPerHour=<integer>]
  & [maxClicks=<integer>]
  & [maxClicksPerDay=<integer>]
  & [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` — по приоритетности: использовать значения параметров `level` и `priority` для оценки вероятности показа рекламной кампании; `1` — по проценту от трафика: использовать значение параметра `trafficPercents` для оценки вероятности показа рекламной кампании. Значение по умолчанию: `-1`.
`maxImpressions`	Максимальное количество показов баннера. Допустимые значения: целое число от `1` до `2147483647`.
`maxImpressionsPerDay`	Максимальное количество показов в сутки. Допустимые значения: целое число от `1` до `2147483647`.
`maxImpressionsPerHour`	Максимальное количество показов в час. Допустимые значения: целое число от `1` до `2147483647`.
`maxClicks`	Максимальное количество кликов всего. Допустимые значения: целое число от `1` до `2147483647`.
`maxClicksPerDay`	Максимальное количество кликов в сутки. Допустимые значения: целое число от `1` до `2147483647`.
`maxClicksPerHour`	Максимальное количество кликов в час. Допустимые значения: целое число от `1` до `2147483647`.
`dateStart`	Дата начала открутки. Формат передачи даты и времени: `YYYY-MM-DD HH:mm`. Значение по умолчанию: сегодня с 00:00.
`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=place&objectID=474205&actionStatus=1&actionObjectID=3245

Ответ:

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

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

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

добавить кампанию
получить список кампаний;
удалить кампанию;
редактировать кампанию;
получить список баннеров рекламной кампании;
разместить кампанию на сайте, разделе.

Была ли статья полезна?

modify

website