website
Разместить кампанию на сайте.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=campaign
& action=placing
& actionObject=website
& 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>]
|
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=website&objectID=474205&actionStatus=1&actionObjectID=3245
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на разделе, площадке.
ID объекта, над которым производится действие.
ID сайта.
Читайте также:
Включить или выключить размещение.
Допустимые значения:
-
0
— выключить; -
1
— включить.
Допустимые значения:
-
−1
— не переопределен (значение наследуется от уровня выше); -
0
— по приоритетности — использовать значения параметров «уровень» и «приоритет» для оценки вероятности показа рекламной кампании; -
1 — по % от трафика — использовать значение параметра процент от трафика для оценки вероятности показа рекламной кампании.
Значение по умолчанию: -1.
Максимальное количество показов баннера.
Допустимые значения: целое число от 1 до 2147483647
.
Максимальное количество показов в сутки.
Допустимые значения: целое число от 1 до 2147483647
.
Максимальное количество показов в час.
Допустимые значения: целое число от 1 до 2147483647
.
Максимальное количество кликов всего.
Допустимые значения: целое число от 1 до 2147483647
.
Максимальное количество кликов в сутки.
Допустимые значения: целое число от 1 до 2147483647
.
Максимальное количество кликов в час.
Допустимые значения: целое число от 1 до 2147483647
.
Дата начала открутки.
Значение по умолчанию: сегодня с 00:00.
Формат передачи даты и времени: YYYY-MM-DD HH:mm
Дата окончания открутки.
Формат передачи даты и времени: YYYY-MM-DD HH:mm
Профиль таргетирования позволяет объединить настройки нескольких видов таргетирования. При создании кампании или баннера можно указывать профиль, чтобы не тратить время на настройку каждого таргетирования в отдельности.
Как посмотреть список ID профилей, читайте в разделе list-targetingProfile.
Обязательный параметр