report2

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

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

Отчет содержит данные о количестве загрузок точек учета действия с разбивкой по баннерам рекламной кампании.

Отчет доступен только для рекламных кампаний, у которых:
  1. включен "учет действий" в параметрах рекламной кампании: postView, postClick или postView и postClick;
  2. у рекламодателя данной рекламной кампании должны быть созданы точки учета действия;
  3. коды точек учета действия должны быть установлены на посадочные страницы сайта рекламодателя, чтобы пользователь после контакта с рекламой (просмотра баннера или клика по нему), на сайте рекламодателя контактировал с точками учета действия рекламодателя.

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

Примечание. Доступна пагинация.
https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=campaign
 & action=info
 & actionObject=report2
 & 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>
   <bannerName>{string}</bannerName>
   <tracingPointID>{integer}</tracingPointID>
   <tracingPointName>{string}</tracingPointName>
   <actionsPostView>{integer}</actionsPostView>
   <actionsPostClick>{integer}</actionsPostClick>
   <actions>{integer}</actions>
   </row0>
</response>

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

code

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

rows

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

rowN

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

bannerID

ID баннера.

bannerName

Название баннера.

tracingPointID

ID точки учета действия.

tracingPointName

Название точки учета действия.

actionsPostView

Статистика показов PostView — количество загрузок точки учета действия на сайте рекламодателя пользователями, которые видели рекламное объявление, либо производили переход по рекламному объявлению более суток назад.

actionsPostClick

Статистика показов PostClick — количество загрузок точки учета действия на сайте рекламодателя пользователями в течение суток с момента совершения перехода по рекламному объявлению.

actions

Общее количество загрузок точек учета действия.

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

Запрос:

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

Ответ:

<response>
 <status>
  <code>0</code>
 </status>
 <result>
  <data>
   <row0>
      <bannerID>2346514</bannerID>
      <bannerName>TP api click</bannerName>
      <tracingPointID>182249823</tracingPointID>
      <tracingPointName>TPapi</tracingPointName>
      <actionsPostView>0</actionsPostView>
      <actionsPostClick>6</actionsPostClick>
      <actions>6</actions>
    </row0>
    <row1>
      <bannerID>2347489</bannerID>
      <bannerName>TP api view</bannerName>
      <tracingPointID>186821544</tracingPointID>
      <tracingPointName>TP api view</tracingPointName>
      <actionsPostView>0</actionsPostView>
      <actionsPostClick>3</actionsPostClick>
      <actions>3</actions>
    </row1>
   </data>
 </result>
</response>

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

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