AdRiver - система управления интернет-рекламой
О компании Справочное руководство Вход в систему
Рекламным агентствам  AdRiver DSP 
Владельцам сайтов  AdRiver SSP 
Управление рекламой  AdRiver DMP 
Новости

5. Получение статистики с помощью программного интерфейса AdRiver

С помощью программного интерфейса можно получить разнообразные статистические данные о происходящих событиях в системе. Соответствующие запросы позволяют получить статистику:

  • для сайтов;
  • для рекламных кампаний;
  • для сценариев;
  • для слайсов;
  • для баннеров

по следующим показателям:

  • показы;
  • клики;
  • программные события (действия пользователя по отношению к баннеру, вызывающие обращения к серверу, например, наведение курсора мыши, перемещение внутри баннера и т.п.)

по заданному временному периоду. Период получения статистических данных задается с помощью указания даты начала и даты окончания периода.

Внимание! При указании периода получения статистики необходимо иметь в виду, что ненулевые статистические данные могут быть получены только за период реального выполнения рекламных кампаний на сайте. Срок хранения статистической информации системы для сайтов, рекламных кампаний, сценариев и баннеров составляет 365 суток.

Возможны два уровня детализации отображения статистики по заданному периоду – по дням и по часам.

Более подробную информацию о статистике в системе AdRiver можно получить из документации.

Обязательными параметрами запроса на получение статистических данных являются:

  • start_date — дата начала периода получения статистики в формате YYYY-MM-DD;
  • stop_date — дата окончания периода получения статистики в формате YYYY-MM-DD;
  • granularity — уровень детализации: daily — по дням; hourly — по часам.

Необязательными параметрами запроса на получение статистических данных являются (при запросе статистики по сайту):

  • site_zone - id — сайтзоны сайта;
  • page_zone - id — зона страницы сайта;
  • banner_type — тип баннера;
  • banner_spec — баннер спек;
  • banner_number — номер баннера.
Пример запроса для получения статистики по рекламной кампании
GET/stat/ads/309582?start_date=2011-11-11&stop_date=2011-11-12&granularity=daily
Content-Type:application/atom+xml
X-Auth-UserID: 171322
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29
Пример запроса для получения статистики по сетевой рекламной кампании
GET/stat/net_ads/309582?start=&stop=&granularity={daily,hourly}&site_zone= 
Content-Type:application/atom+xml 
X-Auth-UserID: 171322 
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29

В запросе используются следующие параметры:

  • идентификатор рекламной кампании (309532), для которой требуется получить статистику;
  • дата начала периода (2011-11-11), по которому требуется получить статистику;
  • дата окончания периода (2011-11-12), по которому требуется получить статистику;
  • уровень детализации, с которым требуется выдавать статистику — по дням (daily).

Ответ системы возвращает текущие данные статистики рекламной кампании в соответствии с запрошенными параметрами:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2012-03-06T17:11:21+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <title>AD Stat Atom Entry</title>
  <id>https://api.adriver.ru/stat/ads/309582?granularity=daily&amp;start_date=2011-11-11&amp;stop_date=2011-11-12</id>
  <content type="text/xml">
    <statObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="AD" id="309582"/>
      <period>
        <startDate>2011-11-11</startDate>
        <stopDate>2011-11-12</stopDate>
      </period>
      <stat>
        <item>
          <exp>113</exp>
          <click>2</click>
          <subevent>              <item index="0">0</item>              <item index="1">0</item>              <item index="2">0</item>              <item index="3">0</item>              <item index="4">0</item>              <item index="5">0</item>              <item index="6">0</item>              <item index="7">0</item>              <item index="8">0</item>              <item index="9">0</item>           </subevent>
          <date>2011-11-11</date>
        </item>
        <item>
          <exp>67</exp>
          <click>1</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2011-11-12</date>
        </item>
      </stat>
    </statObject>
  </content>
</entry>

Примечания к коду:

  • id="309582" — идентификатор рекламной кампании, по которой выдается статистика;
  • <exp>113</exp> — количество показов за день;
  • <click>2</click> — количество кликов за день;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за день (отдельно по каждому номеру события);
  • <date>2011-11-11</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по суммарным показам/кликам и по уникальным показам/кликам за последний месяц для РК
GET /stat/ads/id_РК/total
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token
Пример запроса для получения статистики по суммарным показам/кликам и по уникальным показам/кликам за последний месяц для сетевой РК
GET /stat/net_ads/id_РК/total
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество показов, кликов, событий и уникальных показов за месяц, неделю и вчерашний день у РК. Пример ответа системы: 

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:41:03+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statTotalObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="AD" id="1"/>
      <stat>
        <item>
          <exp>98899901</exp>
          <click>12</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <uniq>
            <exp>
              <month>1528161</month>
              <week>331566</week>
              <yesterday>55077</yesterday>
            </exp>
            <click>
              <month>0</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </click>
            <reach>
              <month>1528161</month>
              <week>272112</week>
              <yesterday>42802</yesterday>
            </reach>
          </uniq>
        </item>
      </stat>
    </statTotalObject>
  </content>
</entry>

Примечания к коду:

  • 1 - идентификатор рекламной кампании, по которой запрашивается статистика;
  • 98899901 - количество показов за месяц;
  • 12 - количество кликов за месяц;
  • subevent - количество событий за месяц;
  • uniq - количество уникальных показов (exp), кликов (click) за месяц/неделю/вчерашний день;
  • reach - охват аудитории за месяц/неделю/вчерашний день.
Пример запроса для получения статистики по уникальным показам для РК (за последний месяц с разбивкой по дням)
GET /stat/ads/id_РК/unique 
Content-Type:application/atom+xml  
X-Auth-UserID: UserID
X-Auth-Passwd: Token
Пример запроса для получения статистики по уникальным показам для сетевой РК (за последний месяц с разбивкой по дням)
GET /stat/net_ads/id_РК/unique  
Content-Type:application/atom+xml  
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество уникальных показов по дням за прошедший месяц. Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:43:58+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statUniqueObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="AD" id="1"/>
      <stat>
        <item>
          <exp>64050</exp>
          <click>0</click>
          <reach>64050</reach>
          <date>2014-04-12</date>          
        </item>
        <item>
          <exp>63131</exp>
          <click>0</click>
          <reach>121096</reach>
          <date>2014-04-13</date>          
        </item>
        <item>
          <exp>68225</exp>
          <click>0</click>
          <reach>181534</reach>
          <date>2014-04-14</date>          
        </item>
        <item>
          <exp>89410</exp>
          <click>0</click>
          <reach>259340</reach>
          <date>2014-04-15</date>          
        </item>
        <item>
          <exp>81742</exp>
          <click>0</click>
          <reach>385552</reach>
          <date>2014-04-16</date>          
        </item>
               ...
        <item>
          <exp>37891</exp>
          <click>0</click>
          <reach>1432816</reach>
          <date>2014-05-09</date>          
        </item>
        <item>
          <exp>65867</exp>
          <click>0</click>
          <reach>1485359</reach>
          <date>2014-05-10</date>          
        </item>
        <item>
          <exp>55077</exp>
          <click>0</click>
          <reach>1528161</reach>
          <date>2014-05-11</date>          
        </item>
      </stat>
    </statUniqueObject>
  </content>
</entry>

Примечания к коду:

  • exp - количество уникальных показов за день;
  • click - количество уникальных кликов за день;
  • reach - охват аудитории к этому дню;
  • date - дата, по которой приведена статистика выше.
Запрос на получение списка РК за период

В запросе указывается дата начала периода и дата окончания периода. В ответе возвращается массив объектов кампаний и их сценариев, которые проводились в указанный промежуток времени. Также возможно запросить данные со статистикой, указав параметр stat=1. Доступны данные по обычным и сетевым кампаниям, а также делегированным кампаниям с правами на просмотр статистики.

Пример запроса на получение списка кампаний за период:

GET /monitoring/traffic_period?start_date=2014-01-01&stop_date=2015-05-01
Content-Type: application/atom+xml
X-Auth-UserID: 123456
X-Auth-Passwd: token
  • start_date - дата начала периода в формате ГГГГ-ММ-ДД
  • stop_date - дата окончания периода в формате ГГГГ-ММ-ДД
  • 123456 - ID пользователя
  • token - ключ, полученный при отправке запроса на аутентификацию

Пример ответа:

[ { "ad_id":"123456",
     "profile_id":123456,
     "ad_delegated":0,
     "ad_name":"Campaign-Name",
     "ad_type":1,
     "profile_name":"Profile-Name"
  },
  {  "ad_id":"523456",
     "profile_id":523457,
     "ad_delegated":0,
     "ad_name":"Campaign-Name",
     "ad_type":1,
     "profile_name":"Profile-Name"
  },
  { "ad_id":"1234567",
     "profile_id":1234567,
     "ad_delegated":0,
     "ad_name":"Campaign-Name",
     "ad_type":1,
     "profile_name":"Profile-name"
  }
]

Пример запроса на получение списка кампаний за период со статистикой:

GET /monitoring/traffic_period?start_date=2014-01-01&stop_date=2015-05-01&stat=1
Content-Type: application/atom+xml
X-Auth-UserID: 123456
X-Auth-Passwd: token

Пример ответа:

[
    {
        "ad_id": 123456,
        "profile_id": 123456,
        "ad_delegated": 0,
        "ad_name": "CampaignName",
        "ad_type": 1,
        "stat": {
            "sub0": 0,
            "exp": 9,
            "uclk": 0.00393,
            "clk": 1,
            "uexp": 2007560
        },
        "profile_name": "ProfileName"
    },
    {
        "ad_id": 1234567,
        "profile_id": 1234567,
        "ad_delegated": 0,
        "ad_name": "CampaignName",
        "ad_type": 1,
        "stat": {
            "sub0": 0,
            "exp": 127,
            "uclk": 0,
            "clk": 0,
            "uexp": 26
        },
        "profile_name": "ProfileName"
    },
    {
        "ad_id": 12345678,
        "profile_id": 12345678,
        "ad_delegated": 0,
        "ad_name": "CampaignName",
        "ad_type": 1,
        "stat": {
            "sub0": 0,
            "exp": 127,
            "uclk": 0,
            "clk": 0,
            "uexp": 1
        },
        "profile_name": "Profilename"
    }
]
  • sub0 - количество нулевых событий в текущем сценарии
  • exp - количество показов в текущем сценарии
  • uclk - количество уникальных показов в текущем сценарии
  • clk - количество кликов в текущем сценарии
  • uexp - количество уникальных показов в текущем сценарии

Подсчет количества уникальных показов и уникальных кликов в сценарии реализован с помощью алгоритма HLL.

Суммировать данные по уникальным показам и кликам сценариев с целью получения количества уникальных показов и кликов по рекламной кампании в целом нельзя. Данное решение не предоставляет возможности получения суммарных данных по уникальным показам и кликам кампании.

Пример запроса для получения статистики по сценарию
GET/stat/profiles/717428?start_date=2011-11-11&stop_date=2011-11-12&granularity=daily
Content-Type:application/atom+xml
X-Auth-UserID: 174652
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29

В запросе используются следующие параметры:

  • идентификатор сценария (717428), для которого требуется получить статистику;
  • дата начала периода (2011-11-11), по которому требуется получить статистику;
  • дата окончания периода (2011-11-12), по которому требуется получить статистику;
  • уровень детализации, с которым требуется выдавать статистику — по дням (daily).

Ответ системы возвращает текущие данные статистики сценария в соответствии с запрошенными параметрами:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2012-03-06T17:12:57+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <title>Profile Stat Atom Entry</title>
  <id>https://api.adriver.ru/stat/profiles/717428?granularity=daily&amp;start_date=2011-11-11&amp;stop_date=2011-11-12</id>
  <content type="text/xml">
    <statObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="PROFILE" id="717428"/>
      <period>
        <startDate>2011-11-11</startDate>
        <stopDate>2011-11-12</stopDate>
      </period>
      <stat>
        <item>
          <exp>38</exp>
          <click>2</click>
          <subevent>              <item index="0">0</item>              <item index="1">0</item>              <item index="2">0</item>              <item index="3">0</item>              <item index="4">0</item>              <item index="5">0</item>              <item index="6">0</item>              <item index="7">0</item>              <item index="8">0</item>              <item index="9">0</item>           </subevent>
          <date>2011-11-11</date>
        </item>
        <item>
          <exp>17</exp>
          <click>1</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2011-11-12</date>
        </item>
      </stat>
    </statObject>
  </content>
</entry>

Примечания к коду:

  • id="717428" — идентификатор сценария, по которому выдается статистика;
  • <exp>38</exp> — количество показов за день;
  • <click>2</click> — количество кликов за день;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за день (отдельно по каждому номеру события);
  • <date>2011-11-11</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по уникальным показам и суммарным показам/кликам для сценария (за последний месяц)
GET /stat/profiles/id_Сценария/total
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:50:26+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statTotalObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="PROFILE" id="1"/>
      <stat>
        <item>
          <exp>45859681</exp>
          <click>10</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <uniq>
            <exp>
              <month>948233</month>
              <week>209455</week>
              <yesterday>34240</yesterday>
            </exp>
            <click>
              <month>0</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </click>
            <reach>
              <month>948233</month>
              <week>179182</week>
              <yesterday>27934</yesterday>
            </reach>
          </uniq>
        </item>
      </stat>
    </statTotalObject>
  </content>
</entry>

Примечания к коду:

  • id="1" — идентификатор сценария, по которому выдается статистика;
  • <exp>45859681</exp> — количество показов за месяц;
  • <click>10</click> — количество кликов за месяц;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за месяц (отдельно по каждому номеру события);
  • uniq (exp, click) - количесвто уникальных показов, кликов за месяц/неделю/вчерашний день;
  • reach - охват аудитории (за месяц, неделю, вчерашний день).
Пример запроса для получения статистики по уникальным показам для сценария (за последний месяц с разбивкой по дням)
GET /stat/profiles/ID_сценария/unique   
Content-Type:application/atom+xml 
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество уникальных показов по дням за прошедший месяц. Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:51:58+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statUniqueObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="PROFILE" id="1"/>
      <stat>
        <item>
          <exp>37887</exp>
          <click>0</click>
          <reach>37887</reach>
          <date>2014-04-12</date>          
        </item>
        <item>
          <exp>37622</exp>
          <click>0</click>
          <reach>72543</reach>
          <date>2014-04-13</date>          
        </item>
        <item>
          <exp>40044</exp>
          <click>0</click>
          <reach>108833</reach>
          <date>2014-04-14</date>          
        </item>
        <item>
          <exp>52739</exp>
          <click>0</click>
          <reach>156037</reach>
          <date>2014-04-15</date>          
        </item>
        <item>
          <exp>47298</exp>
          <click>0</click>
          <reach>195318</reach>
          <date>2014-04-16</date>          
        </item>
               ...
        <item>
          <exp>23485</exp>
          <click>0</click>
          <reach>886063</reach>
          <date>2014-05-09</date>          
        </item>
        <item>
          <exp>41100</exp>
          <click>0</click>
          <reach>920299</reach>
          <date>2014-05-10</date>          
        </item>
        <item>
          <exp>34240</exp>
          <click>0</click>
          <reach>948233</reach>
          <date>2014-05-11</date>          
        </item>
      </stat>
    </statUniqueObject>
  </content>
</entry>

Примечания к коду:

  • 1 - идентификатор сценария, по которому выдается статистика;
  • exp - количество уникальных показов за день;
  • click - количество уникальных кликов за день;
  • reach - охват аудитории к этому дню;
  • <date>2014-04-12</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по слайсу
GET/stat/slices/953752?start_date=2012-03-06&stop_date=2012-03-06&granularity=hourly
Content-Type:application/atom+xml
X-Auth-UserID: 177982
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29

В запросе используются следующие параметры:

  • идентификатор слайса (953752), для которого требуется получить статистику;
  • дата начала периода (2012-03-06), по которому требуется получить статистику;
  • дата окончания периода (2012-03-06), по которому требуется получить статистику;
  • уровень детализации, с которым требуется выдавать статистику — по часам (hourly).

Ответ системы возвращает текущие данные статистики слайса в соответствии с запрошенными параметрами:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2012-03-12T13:13:00+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <title>Slice Stat Atom Entry</title>
  <id>https://api.adriver.ru/stat/slices/953752?granularity=hourly&amp;start_date=2012-03-06&amp;stop_date=2012-03-06</id>
  <content type="text/xml">
    <statObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="SLICE" id="953752"/>
      <period>
        <startDate>2012-03-06</startDate>
        <stopDate>2012-03-06</stopDate>
      </period>
      <stat>
        <item>
          <exp>2</exp>
          <click>0</click>
          <subevent>              <item index="0">0</item>              <item index="1">0</item>              <item index="2">0</item>              <item index="3">0</item>              <item index="4">0</item>              <item index="5">0</item>              <item index="6">0</item>              <item index="7">0</item>              <item index="8">0</item>              <item index="9">0</item>           </subevent>
          <date>2012-03-06</date>
          <time>00:00:00</time>
        </item>
        <item>
          <exp>3</exp>
          <click>0</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2012-03-06</date>
          <time>01:00:00</time>
        </item>
        . . . .
        <item>
          <exp>25</exp>
          <click>4</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2012-03-06</date>
          <time>12:00:00</time>
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2012-03-06</date>
          <time>13:00:00</time>
        </item>
        . . . .
        <item>
          <exp>12</exp>
          <click>2</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2012-03-06</date>
          <time>22:00:00</time>
        </item>
        <item>
          <exp>10</exp>
          <click>2</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <date>2012-03-06</date>
          <time>23:00:00</time>
        </item>
      </stat>
    </statObject>
  </content>
</entry>

Примечания к коду:

  • id="953752" — идентификатор слайса, по которому выдается статистика;
  • <exp>2</exp> — количество показов за час;
  • <click>0</click> — количество кликов за час;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за час (отдельно по каждому номеру события);
  • <time>00:00:00</time> — час, статистика по которому приведена выше.
Пример запроса для получения статистики по уникальным показам и суммарным показам/кликам для слайса (за  последний месяц)
GET /stat/slices/ID_слайса/total 
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:53:26+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statTotalObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="SLICE" id="1"/>
      <stat>
        <item>
          <exp>1739</exp>
          <click>0</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <uniq>
            <exp>
              <month>1</month>
              <week>1</week>
              <yesterday>0</yesterday>
            </exp>
            <click>
              <month>0</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </click>
            <reach>
              <month>1</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </reach>
          </uniq>
        </item>
      </stat>
    </statTotalObject>
  </content>
</entry>

Примечания к коду:

  • id="1" — идентификатор слайса, по которому выдается статистика;
  • <exp>1739</exp> — количество показов за месяц;
  • <click>0</click> — количество кликов за месяц;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за месяц (отдельно по каждому номеру события);
  • uniq - количество уникальных показов (exp) и кликов (click) за месяц/неделю/вчерашний день;
  • reach - охват аудитории (за месяц, неделю, вчерашний день).
Пример запроса для получения статистики по уникальным показам для слайса (за последний месяц с разбивкой по дням)
GET /stat/slices/ID_Слайса/unique   
Content-Type:application/atom+xml 
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество уникальных показов по дням за прошедший месяц. Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:51:58+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statUniqueObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="SLICE" id="1"/>
      <stat>
        <item>
          <exp>1</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-04-12</date>          
        </item>
        <item>
          <exp>1</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-04-13</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-04-14</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-04-15</date>          
        </item>
               ...
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-09</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-10</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-11</date>          
        </item>
      </stat>
    </statUniqueObject>
  </content>
</entry>

Примечания к коду:

  • 1 - идентификатор слайса, по которому выдается статистика;
  • exp - количество уникальных показов за день;
  • click - количество уникальных кликов за день;
  • reach - охват аудитории к этому дню;
  • <date>2014-05-11</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по баннеру
GET/stat/banners/1429086?start_date=2011-11-11&stop_date=2011-11-12&granularity=daily
Content-Type:application/atom+xml
X-Auth-UserID: 177532
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29

В запросе используются следующие параметры:

  • идентификатор баннера (1429086), для которого требуется получить статистику;
  • дата начала периода (2011-11-11), по которому требуется получить статистику;
  • дата окончания периода (2011-11-12), по которому требуется получить статистику;
  • уровень детализации, с которым требуется выдавать статистику — по дням (daily).

Ответ системы возвращает текущие данные статистики баннера в соответствии с запрошенными параметрами:

<?xml  version="1.0"  encoding="utf-8"?>
<entry  xmlns="http://www.w3.org/2005/Atom"  xmlns:adriver="http://adriver.ru/ns/restapi/atom">
    <updated>2012-03-06T17:13:59+04:00</updated>
    <author>
        <name>Adriver::RestAPI::Statistics</name>
    </author>
    <title>Banner  Stat  Atom  Entry</title>
    <id>https://api.adriver.ru/stat/banners/1429086?granularity=daily&amp;start_date=2011-11-11&amp;stop_date=2011-11-12</id>
    <content  type="text/xml">
        <statObject  xmlns="http://adriver.ru/ns/restapi/atom">
            <object  type="BANNER"  id="1429086"/>
            <period>
                <startDate>2011-11-11</startDate>
                <stopDate>2011-11-12</stopDate>
            </period>
            <stat>
                <item>
                    <exp>38</exp>
                    <click>2</click>
                    <subevent>                         <item  index="0">0</item>                         <item  index="1">0</item>                         <item  index="2">0</item>                         <item  index="3">0</item>                         <item  index="4">0</item>                         <item  index="5">0</item>                         <item  index="6">0</item>                         <item  index="7">0</item>                         <item  index="8">0</item>                         <item  index="9">0</item>                     </subevent>
                    <date>2011-11-11</date>
                </item>
                <item>
                    <exp>17</exp>
                    <click>1</click>
                    <subevent>
                       <item  index="0">0</item>
                       <item  index="1">0</item>
                       <item  index="2">0</item>
                       <item  index="3">0</item>
                       <item  index="4">0</item>
                       <item  index="5">0</item>
                       <item  index="6">0</item>
                       <item  index="7">0</item>
                       <item  index="8">0</item>
                       <item  index="9">0</item>
                    </subevent>
                    <date>2011-11-12</date>
                </item>
            </stat>
        </statObject>
    </content>
</entry>

Примечания к коду:

  • id="1429086" — идентификатор баннера, по которому выдается статистика;
  • <exp>38</exp> — количество показов за день;
  • <click>2</click> — количество кликов за день;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за день (отдельно по каждому номеру события);
  • <date>2011-11-11</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по уникальным показам и суммарным показам/кликам для баннера (за последний месяц)
GET /stat/banners/ID_Баннера/total 
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:55:26+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statTotalObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="BANNER" id="1"/>
      <stat>
        <item>
          <exp>53040220</exp>
          <click>2</click>
          <subevent>
            <item index="0">0</item>
            <item index="1">0</item>
            <item index="2">0</item>
            <item index="3">0</item>
            <item index="4">0</item>
            <item index="5">0</item>
            <item index="6">0</item>
            <item index="7">0</item>
            <item index="8">0</item>
            <item index="9">0</item>
          </subevent>
          <uniq>
            <exp>
              <month>580194</month>
              <week>122169</week>
              <yesterday>20845</yesterday>
            </exp>
            <click>
              <month>0</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </click>
            <reach>
              <month>580194</month>
              <week>92979</week>
              <yesterday>14875</yesterday>
            </reach>
          </uniq>
        </item>
      </stat>
    </statTotalObject>
  </content>
</entry>

Примечания к коду:

  • id="1" — идентификатор баннера, по которому выдается статистика;
  • <exp>53040220</exp> — количество показов за месяц;
  • <click>2</click> — количество кликов за месяц;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за месяц;
  • uniq - количество уникальных показов (exp) и кликов (click) за месяц/неделю/вчерашний день;
  • reach - охват аудитории за месяц, неделю, вчерашний день.
Пример запроса для получения статистики по уникальным показам для баннера (за последний месяц с разбивкой по дням)
GET /stat/banners/ID_Баннера/unique  
Content-Type:application/atom+xml 
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество уникальных показов по дням за прошедший месяц. Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:51:58+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statUniqueObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="BANNER" id="1"/>
      <stat>
        <item>
          <exp>26172</exp>
          <click>0</click>
          <reach>26172</reach>
          <date>2014-04-12</date>          
        </item>
        <item>
          <exp>25521</exp>
          <click>0</click>
          <reach>48572</reach>
          <date>2014-04-13</date>          
        </item>
        <item>
          <exp>28192</exp>
          <click>0</click>
          <reach>72729</reach>
          <date>2014-04-14</date>          
        </item>
        <item>
          <exp>36691</exp>
          <click>0</click>
          <reach>103347</reach>
          <date>2014-04-15</date>          
        </item>
        <item>
          <exp>34459</exp>
          <click>0</click>
          <reach>129111</reach>
          <date>2014-04-16</date>          
        </item>
               ...
        <item>
          <exp>14414</exp>
          <click>0</click>
          <reach>546999</reach>
          <date>2014-05-09</date>          
        </item>
        <item>
          <exp>24782</exp>
          <click>0</click>
          <reach>565319</reach>
          <date>2014-05-10</date>          
        </item>
        <item>
          <exp>20845</exp>
          <click>0</click>
          <reach>580194</reach>
          <date>2014-05-11</date>          
        </item>
      </stat>
    </statUniqueObject>
  </content>
</entry>

Примечания к коду:

  • id="1" - идентификатор баннера, по которому приводится статистика;
  • exp - количество уникальных показов за день;
  • click - количество уникальных кликов за день;
  • reach - охват аудитории к этому дню;
  • date - дата, по которой приводится статистика выше.
Пример запроса для получения статистики по сайту
GET/stat/sites/178094?start_date=2011-12-13&stop_date=2011-12-14&granularity=daily
Content-Type:application/atom+xml
X-Auth-UserID: 179512
X-Auth-Passwd: %FD%A6%DC%C7%08%EB%3C%83%1C%D0N%29

В запросе используются следующие параметры:

  • идентификатор сайта (178094), для которого требуется получить статистику;
  • дата начала периода (2011-11-11), по которому требуется получить статистику;
  • дата окончания периода (2011-11-12), по которому требуется получить статистику;
  • уровень детализации, с которым требуется выдавать статистику — по дням (daily).

Ответ системы возвращает текущие данные статистики сайта в соответствии с запрошенными параметрами:

<?xml  version="1.0"  encoding="utf-8"?>
<entry  xmlns="http://www.w3.org/2005/Atom"  xmlns:adriver="http://adriver.ru/ns/restapi/atom">
    <updated>2012-03-06T17:15:42+04:00</updated>
    <author>
        <name>Adriver::RestAPI::Statistics</name>
    </author>
    <title>Site  Stat  Atom  Entry</title>
    <id>https://api.adriver.ru/stat/sites/178094?granularity=daily&amp;start_date=2011-12-13&amp;stop_date=2011-12-14</id>
    <content  type="text/xml">
        <statObject  xmlns="http://adriver.ru/ns/restapi/atom">
            <object  type="SITE"  id="178094"/>
            <period>
                <startDate>2011-12-13</startDate>
                <stopDate>2011-12-14</stopDate>
            </period>
            <stat>
                <item>
                    <exp>59</exp>
                    <click>17</click>
                    <subevent>                          <item  index="0">0</item>                          <item  index="1">0</item>                          <item  index="2">0</item>                          <item  index="3">0</item>                          <item  index="4">0</item>                          <item  index="5">0</item>                          <item  index="6">0</item>                          <item  index="7">0</item>                          <item  index="8">0</item>                          <item  index="9">0</item>                     </subevent>
                    <date>2011-12-13</date>
                </item>
                <item>
                    <exp>6</exp>
                    <click>2</click>
                    <subevent>
                        <item  index="0">0</item>
                        <item  index="1">0</item>
                        <item  index="2">0</item>
                        <item  index="3">0</item>
                        <item  index="4">0</item>
                        <item  index="5">0</item>
                        <item  index="6">0</item>
                        <item  index="7">0</item>
                        <item  index="8">0</item>
                        <item  index="9">0</item>
                    </subevent>
                    <date>2011-12-14</date>
                </item>
            </stat>
        </statObject>
    </content>
</entry>

Примечания к коду:

  • id="178094" — идентификатор сайта, по которому выдается статистика;
  • <exp>59</exp> — количество показов за день;
  • <click>17</click> — количество кликов за день;
  • <subevent>
    <item index="0">0</item>
    <item index="1">0</item>
    ...
    <item index="9">0</item>
    </subevent> — количество программных событий за день (отдельно по каждому номеру события);
  • <date>2011-12-13</date> — день, статистика по которому приведена выше.
Пример запроса для получения статистики по уникальным показам и суммарным показам для сайта (за последний месяц)
GET /stat/sites/ID_сайта/total 
Content-Type:application/atom+xml
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:58:26+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statTotalObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="SITE" id="1"/>
      <stat>
        <item>
          <exp>1599</exp>
          <click>3</click>
          <uniq>
            <exp>
              <month>1</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </exp>
            <click>
              <month>0</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </click>
            <reach>
              <month>1</month>
              <week>0</week>
              <yesterday>0</yesterday>
            </reach>
          </uniq>
        </item>
      </stat>
    </statTotalObject>
  </content>
</entry>

Примечания к коду:

  • 1 - идентификатор сайта, по которому приводится статистика;
  • 1599 - количество показов за месяц;
  • 3 - количество кликов за месяц;
  • uniq - количество уникальных показов (exp) и кликов (click) за месяц/неделю/вчерашний день;
  • reach - охват аудитории за месяц/неделю/вчерашний день;
Пример запроса для получения статистики по уникальным показам для сайта (за последний месяц с разбивкой по дням)
GET /stat/sites/ID_Сайта/unique  
Content-Type:application/atom+xml 
X-Auth-UserID: UserID
X-Auth-Passwd: Token

Ответ системы возвращает количество уникальных показов по дням за прошедший месяц. Пример ответа системы:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xmlns:adriver="http://adriver.ru/ns/restapi/atom">
  <updated>2014-05-12T13:51:58+04:00</updated>
  <author>
    <name>Adriver::RestAPI::Statistics</name>
  </author>
  <content type="text/xml">
    <statUniqueObject xmlns="http://adriver.ru/ns/restapi/atom">
      <object type="SITE" id="1"/>
      <stat>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>0</reach>
          <date>2014-04-12</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>0</reach>
          <date>2014-04-13</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>0</reach>
          <date>2014-04-14</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>0</reach>
          <date>2014-04-15</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>0</reach>
          <date>2014-04-16</date>          
        </item>
               ...
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-09</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-10</date>          
        </item>
        <item>
          <exp>0</exp>
          <click>0</click>
          <reach>1</reach>
          <date>2014-05-11</date>          
        </item>
      </stat>
    </statUniqueObject>
  </content>
</entry

Примечания к коду:

  • 1 - идентификатор сайта, по которому приводится статистика;
  • exp - количество уникальных показов за день;
  • click - количество уникальных кликов за день;
  • reach - охват аудитории к этому дню;
  • date - день, по которому приведена статистика выше.

Наверх

К оглавлению

 

Последнее обновление: 10.02.2016