place

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

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа
  4. Другие действия с объектом

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

https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=placement
 & action=info
 & mode=place
 & placeID=<integer>
 & synchronousFactor=<integer>
 & parametersDivider=<integer>
 & [nonRepeatingPlaces=<integer>]
Query-параметры
placeID *

ID площадки.

См. также:

synchronousFactor *

Вид кода.

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

  • 0 — синхронный;
  • 1 — асинхронный;
  • 2 — асинхронный с проверкой скролла;
  • 3 — адаптивный.
parametersDivider *

Разделитель параметров запроса, не используется в кодах вставки с библиотекой loader.js.

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

  • 0 — &amp;
  • 1 — &.
nonRepeatingPlaces

Получить указанное количество кодов вставки для неповторяющихся площадок.

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

Значение по умолчанию: 1.

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

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

<response>
  <status>
   <code>0</code>
  </status>
  <result>
   <HTML>{string}</HTML>
   <flashURL>{string}</flashURL>
   <imageURL>{string}</imageURL>
   <trackingURL>{string}</trackingURL>
   <hitURL>{string}</hitURL>
  </result>
</response>

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

code

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

HTML

Код вставки.

flashURL

Ссылка для получения flash.

imageURL

Ссылка для получения изображения.

trackingURL

Ссылка для получения пикселя.

hitURL

Ссылка на переход.

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=placement&action=info&mode=place&placeID=264752

Ответ:

<response>
  <status>
   <code>0</code>
  </status>
  <result>
   <HTML><!--AdFox START--> <!--sites--> <!--Площадка: 4416 / все страницы / 300x300--> <!--Категория: <не задана>--> <!--Тип баннера: 300x300--> 
    <script type="text/javascript"> <!-- if (typeof(pr) == 'undefined') { var pr = Math.floor(Math.random() * 1000000); } var addate = new Date(); var scrheight = '', scrwidth = ''; if (self.screen) { scrwidth = screen.width; scrheight = screen.height; } else if (self.java) { var jkit = java.awt.Toolkit.getDefaultToolkit(); var scrsize = jkit.getScreenSize(); scrwidth = scrsize.width; scrheight = scrsize.height; } document.write('<iframe src="//ads.adfox.ru/166283/getCode?p1=buvnk&amp;p2=bg&amp;p3=a&amp;p4=a&amp;pct=a&amp;plp=a&amp;pli=a&amp;pop=a&amp;pfc=a&amp;pfb=a&amp;pr=' + pr + '&amp;pt=b&amp;pd=' + addate.getDate() + '&amp;pw=' + addate.getDay() + '&amp;pv=' + addate.getHours() + '&amp;puid1=&amp;puid2=&amp;puid6=&amp;puid7=&amp;puid8=&amp;pdw=' + scrwidth + '&amp;pdh=' + scrheight + '" frameBorder="0" width="300" height="300" marginWidth="0" marginHeight="0" scrolling="no" style="border: 0px; margin: 0px; padding: 0px;"><a href="//ads.adfox.ru/166283/goDefaultLink?p1=buvnk&amp;p2=bg" target="_top"><img src="//ads.adfox.ru/166283/getDefaultImage?p1=buvnk&amp;p2=bg" border="0" alt=""><\/a><\/iframe>'); //--> 
    </script> 
    <noscript> 
    <iframe src="//ads.adfox.ru/166283/getCode?p1=buvnk&amp;p2=bg&amp;p3=a&amp;p4=a&amp;pct=a&amp;plp=a&amp;pli=a&amp;pop=a&amp;pfc=a&amp;pfb=a&amp;puid1=&amp;puid2=&amp;puid6=&amp;puid7=&amp;puid8=" frameBorder="0" width="300" height="300" marginWidth="0" marginHeight="0" scrolling="no" style="border: 0px; margin: 0px; padding: 0px;"><a href="//ads.adfox.ru/166283/goDefaultLink?p1=buvnk&amp;p2=bg" target="_top"><img src="//ads.adfox.ru/166283/getDefaultImage?p1=buvnk&amp;p2=bg" border="0" alt=""></a></iframe> 
    </noscript> 
    <!--AdFox END-->
   </HTML>
   <flashURL>http://ads.adfox.ru/166283/getCode;p1=buvnk,p2=bg,pj=b,pr=etmxuqv,pfc=a,pfb=a,puid1=,puid2=,puid6=,puid7=,puid8=,pext=.swf@</flashURL>
    <imageURL>http://ads.adfox.ru/166283/getCode?p1=buvnk&p2=bg&pe=b&pfc=a&pfb=a&puid1=&puid2=&puid6=&puid7=&puid8=&pr=etmxuqv</imageURL>
    <trackingURL>http://ads.adfox.ru/166283/getCode?p1=buvnk&p2=bg&ptrc=b&pfc=a&pfb=a&puid1=&puid2=&puid6=&puid7=&puid8=&pr=etmxuqv</trackingURL>
    <hitURL>http://ads.adfox.ru/166283/goLink?p1=buvnk&p2=bg&pj=b&pe=b&pr=etmxuqv&puid1=&puid2=&puid6=&puid7=&puid8=</hitURL>
  </result>
</response>

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

См. также другие действия с объектом place: