banner
Получить список баннеров одной рекламной кампании.
Формат запроса
Примечание
Доступна пагинация.
https://adfox.yandex.ru/api/v1
? object=campaign
& action=info
& actionObject=targeting
& objectID=<integer>
|
Идентификатор рекламной кампании. Читайте также: |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
<result>
<rows>{integer}</rows>
<data>
<row0>
<ID>{integer}</ID>
<name>{string}</name>
<status>{integer}</status>
<statusName>{string}</statusName>
<priority>{integer}</priority>
<bannerTypeID>{integer}</bannerTypeID>
<bannerTypeName>{string}</bannerTypeName>
<impressions>{integer}</impressions>
<impressionsToday>{integer}</impressionsToday>
<clicks>{integer}</clicks>
<clicksToday>{integer}</clicksToday>
<dateStart>{date}</dateStart>
<dateEnd>{date}</dateEnd>
<dateAdded>{date}</dateAdded>
</row0>
<row1>...</row1>
</data>
</result>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Количество элементов в дереве ответа. |
|
Порядковый номер элемента в дереве ответа, где N — число от 0 до rows-1 (где rows — общее количество элементов в ответе). |
|
Идентификатор баннера. |
|
Название баннера. |
|
Статус. Возможные значения:
|
|
Название статуса. |
|
Приоритет. |
|
ID типа баннера. |
|
Название типа баннера. |
|
Общее количество показов баннеров. |
|
Показов сегодня. |
|
Общее количество кликов по баннерам. |
|
Кликов сегодня. |
|
Дата начала открутки. |
|
Дата окончания открутки. |
|
Дата добавления. |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=campaign&action=list&actionObject=banner&objectID=474205
Ответ:
<response> <status> <code>0</code> </status> <result> <rows>2</rows> <data> <row0> <ID>1262260</ID> <name>test</name> <status>0</status> <statusName>active</statusName> <priority>100</priority> <bannerTypeID>77524</bannerTypeID> <bannerTypeName>240x400 js</bannerTypeName> <impressions>1</impressions> <impressionsToday>0</impressionsToday> <clicks>0</clicks> <clicksToday>0</clicksToday> <dateStart>2022-04-06 00:00:00</dateStart> <dateEnd/> <dateAdded>2022-04-06 15:25:20</dateAdded> </row0> <row1>...</row1> </data> </result> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию;
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- разместить кампанию на сайте, разделе, площадке.
Идентификатор рекламной кампании.
Читайте также:
Обязательный параметр