bannerPlacements

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

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа

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

Примечание. Доступна пагинация.
https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=account
 & action=list
 & actionObject=bannerPlacements
 & bannerID=<integer>
Query-параметры
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

Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.

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://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&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>