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>]
|
ID объекта, над которым производится действие. |
|
ID площадки. Читайте также: |
|
Включить или выключить размещение. Допустимые значения:
|
|
Допустимые значения:
Значение по умолчанию: -1. |
|
Максимальное количество показов баннера. Допустимые значения: |
|
Максимальное количество показов в сутки. Допустимые значения: |
|
Максимальное количество показов в час. Допустимые значения: |
|
Максимальное количество кликов всего. Допустимые значения: |
|
Максимальное количество кликов в сутки. Допустимые значения: |
|
Максимальное количество кликов в час. Допустимые значения: |
|
Дата начала открутки. Значение по умолчанию: сегодня с 00:00. Формат передачи даты и времени: |
|
Дата окончания открутки. Формат передачи даты и времени: |
|
Профиль таргетирования позволяет объединить настройки нескольких видов таргетирования. При создании кампании или баннера можно указывать профиль, чтобы не тратить время на настройку каждого таргетирования в отдельности. Как посмотреть список ID профилей, читайте в разделе list-targetingProfile. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
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
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, площадке.
ID объекта, над которым производится действие.
ID раздела сайта.
Читайте также:
Включить или выключить размещение.
Допустимые значения:
-
0
— выключить; -
1
— включить.
Допустимые значения:
-
−1
— не переопределен (значение наследуется от уровня выше); -
0
— по приоритетности — использовать значения параметров «уровень» и «приоритет» для оценки вероятности показа рекламной кампании; -
1 — по % от трафика — использовать значение параметра процент от трафика для оценки вероятности показа рекламной кампании.
Значение по умолчанию: -1.
Дата начала открутки.
Значение по умолчанию: сегодня с 00:00.
Формат передачи даты и времени: YYYY-MM-DD HH:mm
Дата окончания открутки.
Формат передачи даты и времени: YYYY-MM-DD HH:mm
Профиль таргетирования позволяет объединить настройки нескольких видов таргетирования. При создании кампании или баннера можно указывать профиль, чтобы не тратить время на настройку каждого таргетирования в отдельности.
Как посмотреть список ID профилей, читайте в разделе list-targetingProfile.
Обязательный параметр