report1

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

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

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

Примечание. Доступна пагинация.
https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=place
 & action=info
 & actionObject=report1
 & objectID=<integer>
 & dateStart=<YYYY-MM-DD>
 & [dateEnd=<YYYY-MM-DD>]
Query-параметры
objectID *ID объекта, над которым производится действие.
dateStart *

Дата, начиная с которой нужно получить данные.

dateEnd

Дата, до которой нужно получить данные.

Значение по умолчанию: по текущий день.

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

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

 <response>
  <status>
   <code>{integer}</code>
  </status>
  <data>
   <row0>
   <date>{date}</date>
   <loads>{integer}</loads>
   <bannerLoads>{integer}</bannerLoads>
   <impressions>{integer}</impressions>
   <impressionsDefault>{integer}</impressionsDefault>
   <clicks>{integer}</clicks>
   <clicksDefault>{integer}</clicksDefault>
   <CTR>{integer}</CTR>
   <impressionsTotal>{integer}</impressionsTotal>
   </row0>
</response>

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

code

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

rows

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

rowN

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

date

Дата.

loads

Количество запросов кода.

bannerLoads

Количество загрузок баннеров.

impressions

Общее количество показов баннеров.

impressionsDefault

Общее количество показов баннеров по умолчанию.

clicks

Общее количество кликов по баннерам.

clicksDefault

Общее количество кликов по баннерам по умолчанию.

CTR

CTR — процентное отношение числа кликов по рекламному баннеру к числу его показов.

impressionsTotal

Сумма показов баннеров и загрузок баннеров по умолчанию.

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=place&action=info&actionObject=report1&objectID=474205&dateStart=2016-01-27

Ответ:

<response>
 <status>
  <code>0</code>
 </status>
 <data>
  <row0>
   <date>17.04.17</date>
   <loads>19</loads>
   <bannerLoads>16</bannerLoads>
   <impressions>4</impressions>
   <impressionsDefault>3</impressionsDefault>
   <clicks>0</clicks>
   <clicksDefault>0</clicksDefault>
   <CTR>0.00%</CTR>
   <impressionsTotal>7</impressionsTotal>
  </row0>
</response>

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

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