report1
Получить статистику по площадке по дням за выбранный период.
Формат запроса
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
: