bannerPlaceReport
Получить статистику по кампаниям/баннерам/площадкам за день. Метод доступен только для пользователя с ролью «администратор».
Формат запроса
Примечание
Доступна пагинация.
https://adfox.yandex.ru/api/v1
? object=account
& action=list
& actionObject=bannerPlaceReport
& date=<YYYY-MM-DD>
|
Дата, за которую нужно получить данные. Значение по умолчанию: сегодня. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
<data>
<result>
<row0>
<campaignID>{integer}</campaignID>
<campaignName>{string}</campaignName>
<bannerID>{integer}</bannerID>
<bannerName>{string}</bannerName>
<siteID>{integer}</siteID>
<siteName>{string}</siteName>
<sectionID>{integer}</sectionID>
<sectionName>{string}</sectionName>
<placeID>{integer}</placeID>
<placeName>{string}</placeName>
<impressions>{integer}</impressions>
<clicks>{integer}</clicks>
<bannerTypeID>{integer}</bannerTypeID>
<bannerTypeIDName>{string}</bannerTypeIDName>
</row0>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе). |
|
ID кампании. |
|
Название кампании. |
|
ID баннера. |
|
Название баннера. |
|
ID сайта в управлении. |
|
Название сайта в управлении. |
|
ID раздела сайта. |
|
Название раздела сайта. |
|
ID площадки. |
|
Название площадки. |
|
Общее количество показов баннеров. |
|
Общее количество кликов по баннерам. |
|
ID типа баннера. |
|
Название типа баннера. |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=account&action=list&actionObject=bannerPlaceReport&date=2022-01-27
Ответ:
<response> <status> <code>0</code> </status> <data> <result> <row0> <campaignID>457410</campaignID> <campaignName>example</campaignName> <bannerID>1240863</bannerID> <bannerName>banner_test</bannerName> <siteID>35001</siteID> <siteName>site_test</siteName> <sectionID>73929</sectionID> <sectionName>section_test</sectionName> <placeID>772394</placeID> <placeName>place_test</placeName> <impressions>503</impressions> <clicks>0</clicks> <bannerTypeID>87751</bannerTypeID> <bannerTypeIDName>type_1</bannerTypeIDName> </row0> </response>
Дата, за которую нужно получить данные.
Значение по умолчанию: сегодня.
Обязательный параметр