banner
Получить статистику показов и переходов по баннерам одной кампании.
Формат запроса
https://api.adfox.ru/v1/API.php
? loginAccount=<string>
& loginPassword=<string>
& object=campaign
& action=info
& actionObject=banner
& objectID=<integer>
& dateStart=<YYYY-MM-DD>
& [dateEnd=<YYYY-MM-DD>]
Query-параметры | |
objectID * | ID кампании. |
dateStart * | Дата, начиная с которой нужно получить данные. |
dateEnd | Дата, до которой нужно получить данные. Значение по умолчанию: по текущий день. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
<data>
<row0>
<bannerID>{integer}</bannerID>
<impressions>{integer}</impressions>
<clicks>{integer}</clicks>
</row0>
</response>
Параметры ответа
code
Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.
rows
Количество элементов в дереве ответа.
rowN
Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе).
day
Дата.
impressions
Общее количество показов баннеров.
clicks
Общее количество кликов по баннерам.
Пример запроса и ответа
Запрос:
https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=campaign&action=info&actionObject=banner&objectID=474205&dateStart=2016-01-27
Ответ:
<response>
<status>
<code>0</code>
</status>
<data>
<row0>
<bannerID>1318267</bannerID>
<impressions>0</impressions>
<clicks>1</clicks>
</row0>
</response>
Другие действия с объектом
См. также другие действия с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, разделе, площадке;
- разместить кампанию на рекламной сети, категории сети, сайте.