banner

Редактировать параметры баннера.

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

https://adfox.yandex.ru/api/v1
  ? object=banner
  & action=modify
  & actionObject=banner
  & objectID=<integer>
  & [name=<string>]
  & [targetingProfileID=<integer>]
  & [dateStart=<YYYY-MM-DD HH:mm>]
  & [dateEnd=<YYYY-MM-DD HH:mm>]
  & [priority=<integer>]
  & [status=<integer>]
  & [isEvents=<integer>]
  & [isUnplaced=<integer>]
  & [backgroundColor=<string>]
  & [width=<string>]
  & [height=<string>]
  & [imageURL=<string>]
  & [hitURL=<string>]
  & [target=<string>]
  & [alt=<string>]
  & [userN=<string>]
  & [eventN=<string>]
  & [hitURLN=<string>]
  & [maxImpressions=<integer>]
  & [maxImpressionsPerDay=<integer>]
  & [maxImpressionsPerHour=<integer>]
  & [maxClicks=<integer>]
  & [maxClicksPerDay=<integer>]
  & [maxClicksPerHour=<integer>]
  & [trackingURL=<string>]
  & [showMenu=<integer>]
  & [adLabel=<integer>]
  & [domain=<string>]
  & [sendToErir=<integer>]
  & [token=<string>]
  & [creativeContentType=<integer>]
  & [okveds[]=<string>]
  & [markingDescription=<string>]
  & [targetURL=<string>]
  & [textData[]=<string>]
  & [mediaData[]=<{"url": "media data URL", "description": "string"}>]
  & [sendToErir<ParameterN>=<integer>]

objectID*

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

name

Название баннера.

Может содержать русские и латинские буквы, цифры и любые символы.

targetingProfileID

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

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

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

dateStart

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

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

dateEnd

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

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

priority

Приоритет.

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

  • 1≤N≤1000, где N — от 1 до 1000 включительно.

status

Статус объекта. Могут быть показаны только объекты, находящиеся в статусе «активный».

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

  • 0 — активный — объект готов к началу открутки;
  • 1 — приостановленный — предполагается, что объект временно отключен. По умолчанию фильтры в веб-интерфейсе Adfox показывают приостановленные объекты в списке;
  • 2 — завершенный — предполагается, что объект завершил свою открутку. По умолчанию фильтры в веб-интерфейсе Adfox скрывают завершенные объекты.

isEvents

Получить ссылки на события.

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

  • 0 — выключено;
  • 1 — включено.

isUnplaced

Отключить размещение баннера на площадках, созданных после добавления баннера.

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

  • 0 — выключено;
  • 1 — включено.

Функционал зависит от подключенного в аккаунте модуля «Отключение размещения баннеров».

Если модуль подключен: значение по умолчанию 1.

Если модуль не подключен: значение по умолчанию 0.

backgroundColor

Цвет фона в формате HEX, например: #FFFFFF.

width

Ширина баннера.

height

Высота баннера.

imageURL

Ссылка на изображение графических баннеров, заглушку flash-баннеров.

hitURL

Ссылка для перехода на сайт рекламодателя.

target

Значение параметра target для ссылки — определяет, в каком окне открыть ссылку.

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

  • _blank — открыть страницу в новом окне браузера;
  • _parent — открыть страницу в текущем окне;
  • _top — открыть страницу в полном окне браузера.

alt

Значение параметра alt для тега img — альтернативный текст для изображения.

userN

Пользовательские параметры, где N — номер используемого параметра от 1 до 25.

В каждом шаблоне определен набор переменных. Получите список используемых переменных шаблона и передайте значения к этим переменным при добавлении или редактировании баннера.

Например, в шаблоне используются 2 пользовательских параметра: user1 и user3 с типом данных «строка».

Значит, при добавлении или редактировании баннера необходимо в запросе передать:

user1=text1&user3=text3

eventN

Названия событий, где N — номер события от 1 до 30.

В каждом шаблоне определен набор используемых событий. Получите список переменных шаблона и передайте названия к этим событиям при добавлении или редактировании баннера.

hitURLN

Укажите URL перехода для событий, где N в названии параметра — номер события от 1 до 30.

maxImpressions

Maximum number of banner impressions.

Acceptable values: an integer from 1 to 2,147,483,647.

maxImpressionsPerDay

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

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

maxImpressionsPerHour

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

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

maxClicks

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

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

maxClicksPerDay

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

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

maxClicksPerHour

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

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

trackingURL

Ссылка на промерочный пиксель.

В ссылке на пиксель обычно присутствует переменная, ожидающая на вход случайное число. Это число помогает защитить ссылку от кеширования в браузере.

В Adfox существует макрос для подстановки случайного числа к переменной  — %random%.

Например, в ссылках на пиксель Adfox, параметр для подстановки случайного числа pr, подставим к нему макрос:

http://ads.adfox.ru/166283/getCode?p1=borgd&p2=ezjv&
pfb=dwsey&pr=%random%

showMenu

Показывать меню на баннере.

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

  • 0 — не показывать меню;
  • 1 — показывать меню.

adLabel

Показывать метку «Реклама» или «Соцреклама» на баннере.

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

  • 0 — метка отключена;
  • 1 — показывать метку «Реклама»;
  • 2 — показывать метку «Соцреклама».

domain

Домен рядом с меткой «Реклама».

sendToErir

Передавать данные в ЕРИР.

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

  • 0 — не передавать данные в ЕРИР;
  • 1 — передавать данные в ЕРИР (маркировка включена).

token

Токен баннера, который был получен от стороннего ОРД, в том числе в ОРД Яндекса по API (не через стандартный механизм маркировки в Adfox).

Вы можете задать значение параметра token только в том случае, если sendToErir=0.

В поле Токен можно добавить только значение токена. Не добавляйте другие символы.

creativeContentType

Тип креатива.

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

  • 0 — иное;
  • 1 — баннер;
  • 2 — текстово-графический блок;
  • 3 — текстовый блок;
  • 4 — видео;
  • 5 — видеотрансляция в прямом эфире;
  • 6 — аудиотрансляция в прямом эфире;
  • 7 — аудиозапись.

okveds[]

Список с ОКВЭД-ами рекламируемых товаров. Поле необязательно для заполнения, если выполняется одно из условий:

  • ОКВЭД-ы указаны на уровне рекламной кампании;
  • заказчик по договору является юридическим лицом РФ (резидентом).

Чтобы добавить элемент, передайте все предыдущие элементы и все новые элементы.

Если вы хотите удалить элемент из массива, передайте все элементы, кроме удаляемого.

Вы также можете полностью очистить массив. Для этого передайте массив с пустым значением, например, okveds[]=.

Пример передачи двух значений ОКВЭД в запросе: &okveds[]=88.33&okveds[]=77.54.

markingDescription

Описание креатива.

targetURL

Целевая ссылка.

textData[]

Массив с текстовыми данными креативов. Поле обязательно для заполнения, если не были указаны параметры mediaData и sendToErir<ParameterName>.

Чтобы добавить элемент, передайте все предыдущие элементы и все новые элементы.

Если вы хотите удалить элемент из массива, передайте все элементы, кроме удаляемого.

Вы также можете полностью очистить массив. Для этого передайте массив с пустым значением, например, textData[]=.

mediaData[]

Массив с медиаданными креативов. Поле обязательно для заполнения, если не были указаны параметры textData и sendToErir<ParameterName>.

URL будет проверятся на доступность перед сохранением.

Поле description необязательно для заполнения.

Пример заполнения:

mediaData[]={"url": "https://avatars.mds.yandex.net/
get-adfox-content/2462621/221121_adfox_2033661_55944
82.379ba05374bcd6b6339273f47b5a1b64.jpeg/optimize.we
bp", "description": "Text_string"}

Чтобы добавить элемент, передайте все предыдущие элементы и все новые элементы.

Если вы хотите удалить элемент из массива, передайте все элементы, кроме удаляемого.

Вы также можете полностью очистить массив. Для этого передайте массив с пустым значением, например, mediaData[]=.

sendToErir<ParameterN>

Включение/отключение для определенной переменной передачи значения параметра (креатива) в ЕРИР. Где <ParameterN> — название переменной.

Если вы передаете предопределенные переменные, используйте следующие названия параметров:

  • sendToErirImageURL — для переменной Изображение;
  • sendToErirGetFLV — для переменной FLV-ролик.

Чтобы включить пользовательские переменные (user1-user25), используйте <ParameterN>. Где N — значение от 1 до 25. Например, sendToErirParameter2 — для дополнительной переменной user2.

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

  • 0 — отключить передачу данных в ЕРИР для переменной;
  • 1 — включить передачу данных в ЕРИР для переменной.

Поле обязательно для заполнения, если не были указаны параметры mediaData и textData.

Если опция передачи параметров не включена на шаблоне (в столбце Маркировка выбрана опция Не использовать в маркировке), параметр передать не получится (ошибка Incorrect value (-6)). Чтобы управлять передачей данных при создании баннера, перейдите в интерфейс Adfox и включите опцию в шаблоне.

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

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

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

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

code

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

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

Запрос:

https://adfox.yandex.ru/api/v1?object=banner&action=modify&actionObject=banner&objectID=234532

Ответ:

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

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

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

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