modify
Редактировать параметры площадки.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=place
& action=modify
& objectID=<integer>
& [name=<string>]
& [categoryID=<integer>]
& [positionID=<integer>]
& [pct=<integer>]
& [plp=<integer>]
& [pli=<integer>]
& [pop=<integer>]
|
|
ID объекта, над которым производится действие. |
|
|
Название объекта. Может содержать русские и латинские буквы, цифры и любые символы. |
|
|
ID категории. Читайте также: |
|
|
ID расположения площадки. Читайте также: |
|
|
Настройка, разрешающая показы определенных типов рекламных кампаний на данной площадке. Допустимые значения:
|
|
|
Ограничение по частоте показов на уровне площадки. Период частоты показов. Допустимые значения:
|
|
|
Ограничение по частоте показов на уровне площадки. Количество показов за период, которое определяет, сколько показов баннеров на этой площадке будет совершено для уникального пользователя. Допустимые значения: целое число больше Если |
|
|
Ограничение по частоте показов на уровне площадки. Другой период (минуты) — собственный период действия ограничения показов в минутах. Допустимые значения: целое число больше Значение по умолчанию: Обязателен, если Если |
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=place&action=modify&objectID=543&name=site.ru/news/240Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом place:
- добавить площадку;
- удалить площадку;
- получить список площадок;
- получить список размещенных на площадке активных баннеров;
- добавить баннер по умолчанию;
- получить код вставки с уровня площадки.
ID объекта, над которым производится действие.
Название объекта.
Может содержать русские и латинские буквы, цифры и любые символы.
ID категории.
Читайте также:
ID расположения площадки.
Читайте также:
Настройка, разрешающая показы определенных типов рекламных кампаний на данной площадке.
Допустимые значения:
0— из URL запроса (по умолчанию). Тип кода определяется значением параметра, полученного из URL запроса за баннером. Если в запросе значение не было передано, по умолчанию площадка считается с типом кода обычный.1— обычный. Разрешены к показу баннеры из всех рекламных кампаний, кроме кампаний с типом сессионные на странице.2— неповторяющиеся. На странице сайта устанавливается несколько кодов вставки для данной площадки, по запросам которых будет подобрано для показа несколько разных баннеров, кроме кампаний с типом сессионные на странице.3— сессионный на странице. Разрешены к показу баннеры из рекламных кампаний, отмеченных как сессионные на странице (имеют приоритет перед обычными кампаниями), если сессионных кампаний для показа нет, будет выбрана для показа обычная рекламная кампания.4— неповторяющиеся кампании. На странице сайта устанавливается несколько кодов вставки для данной площадки, по запросам которых будет подобрано по одному баннеру из одной рекламной кампании, кроме кампаний с типом сессионные на странице.
Ограничение по частоте показов на уровне площадки. Период частоты показов.
Допустимые значения:
-1— из URL запроса (по умолчанию). Настройки ограничения показов будут использоваться из параметров URL запроса за баннером. Если в запросе значения не были переданы, то считается, что площадка без ограничений. Параметрыpli(количество показов за период) иpop(другой период) должны быть пустыми или отсутствовать в запросе.0— без ограничений. Показы баннеров на данной площадке не ограничиваются, даже если в параметрах запроса указано иное. Параметрыpli(количество показов за период) иpop(другой период) должны быть пустыми или отсутствовать в запросе.1— 1 час. Ограничение действует 1 час с момента первого показа баннера уникальному пользователю.2— 6 часов. Ограничение действует 6 часов с момента первого показа баннера уникальному пользователю.3— 12 часов. Ограничение действует 12 часов с момента первого показа баннера уникальному пользователю.4— 24 часа. Ограничение действует 24 часа с момента первого показа баннера уникальному пользователю.5— другой. Собственный период действия ограничения показов в минутах. Параметрpop(другой период) является обязательным.
Ограничение по частоте показов на уровне площадки. Количество показов за период, которое определяет, сколько показов баннеров на этой площадке будет совершено для уникального пользователя.
Допустимые значения: целое число больше 1.
Если plp=-1 или plp=0 (параметр Период частоты показов передается со значением из URL запроса или без ограничений), то параметр pli должен отсутствовать в запросе или передаваться с пустым значением.
Ограничение по частоте показов на уровне площадки. Другой период (минуты) — собственный период действия ограничения показов в минутах.
Допустимые значения: целое число больше 1.
Значение по умолчанию: 1.
Обязателен, если plp=5 (период частоты показов другой).
Если plp=-1 или plp=0 (параметр Период частоты показов передается со значением из URL запроса или без ограничений), то параметр pop должен отсутствовать в запросе или передаваться с пустым значением.
Обязательный параметр.