bannerPlacements

Получить информацию о размещении баннера.

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

Примечание

Доступна пагинация.

https://adfox.yandex.ru/api/v1
  ? object=account
  & action=list
  & actionObject=bannerPlacements
  & bannerID=<integer>

bannerID*

ID баннера, для которого нужно посмотреть информацию о размещении.

Читайте также:

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

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

<response>
  <status>
    <code>{integer}</code>
  </status>
  <data>
   <result>
    <row0>
     <websiteID>{integer}</websiteID>
     <websiteName>{string}</websiteName>
     <isWebsiteOn>{integer}</isWebsiteOn>
     <sectionID>{integer}</sectionID>
     <sectionName>{string}</sectionName>
     <isSectionOn>{integer}</isSectionOn>
     <placeID>{integer}</placeID>
     <placeName>{string}</placeName>
     <isPlaceOn>{integer}</isPlaceOn>
    </row0>
</response>

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

code

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

rows

Количество элементов в дереве ответа.

rowN

Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе).

websiteID

ID сайта, на котором размещен баннер.

websiteName

Название сайта, на котором размещен баннер.

isWebsiteOn

Признак размещения баннера на сайте:

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

sectionID

ID раздела сайта.

sectionName

Название раздела сайта.

isSectionOn

Признак размещения баннера в разделе сайта:

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

placeID

ID площадки.

placeName

Название площадки.

isPlaceOn

Признак размещения баннера на площадке:

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

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

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=bannerPlacements&bannerID=15376

Ответ:

<response>
  <status>
    <code>0</code>
  </status>
  <data>
   <result>
    <row0>
     <websiteID>39310</websiteID>
     <websiteName>4416</websiteName>
     <isWebsiteOn>1</isWebsiteOn>
     <sectionID>83286</sectionID>
     <sectionName>все страницы</sectionName>
     <isSectionOn>1</isSectionOn>
     <placeID>821550</placeID>
     <placeName>площадка</placeName>
     <isPlaceOn>1</isPlaceOn>
    </row0>
</response>
Предыдущая
Следующая