Отчеты

  • API
  • Отчеты

Отчеты

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

Отчет по кампаниям

Запрос:

{site_path}/{lang}/api/reports/campaign

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/campaign?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по медиа

Запрос:

{site_path}/{lang}/api/reports/media

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/media?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по сайтам

Запрос:

{site_path}/{lang}/api/reports/site

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/site?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по зонам

Запрос:

{site_path}/{lang}/api/reports/zone

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/zone?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по пулам

Запрос:

{site_path}/{lang}/api/reports/pool

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/pool?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по суперпулам

Запрос:

{site_path}/{lang}/api/reports/super-pool

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/super-pool?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по сегментам

Запрос:

{site_path}/{lang}/api/reports/segment

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/segment?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по рекламодателям

Запрос:

{site_path}/{lang}/api/reports/advertisers

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/advertisers?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по рекламодателям RTB

Запрос:

{site_path}/{lang}/api/reports/advertisers-dsp

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/advertisers-dsp?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по издателям

Запрос:

{site_path}/{lang}/api/reports/publishers

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/publishers?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}

Отчет по издателям RTB

Запрос:

{site_path}/{lang}/api/reports/publishers-dsp

Список GET параметров:

periodStart string Дата начала периода статистики. По умолчанию: текущая
periodEnd string Дата окончания периода статистики. По умолчанию: текущая
groups string|array Многоуровневая групировка статистики. Доступные значения:
  • hitDate
  • mediaID
  • campaignID
  • siteID
  • zoneID
  • poolID0
  • poolID1
  • poolID2
  • advertiserID
  • publisherID
  • countryID
  • cityID
  • os
  • browser
  • osType
  • domainID
  • sspSiteID
  • hour
  • typeID
  • subID1
  • subID2
  • subID3
  • subID4
  • subID5
id int ID сущности, по которой будет сформирована статистика
ids string|array ID сущностей, по которым будет сформирована статистика
countries string|array Фильтр по странам
regions string|array Фильтр по регионам
cities string|array Фильтр по городам
metric string|array Данные статистикиВозможные значения:
  • views
  • clicks
  • ctr
order string Позволяет передать порядковый номер страницы списка сущностей

Список полей ответа total

views int Показы
vp string Показы, %
clicks int Клики
cp string Клики, %
ctr string CTR
uniqueViews int Уникальные показы
uvp string Уникальные показы, %
uniqueClicks int Уникальные клики
ucp string Уникальные клики, %
uvr double Коэф. уникальных показов
cpm string Цена за 1000 показов
cpc string Цена за клик
cpa string Цена за действие
spend string Деньги

Список полей ответа items

group string параметр, по которому сгрупированы данные в текущем элементе
id string идентификатор группировки
value string название сущности, по которой выполнена группировка
total object данные статистики. Может содержать все поля описанные в таблице Список полей ответа total
itemsCount int количество строк данных
totalRowsCount int количество дочерних (сгруппированных) строк данных
items object данные статистики, каждый элемент может включать в себя все поля описанные в таблице Список полей ответа items

Ответ

Ответ передается в формате JSON. Список полей ответа:

status int Статус запроса. Возможные значения:
  • 1 - повтор запроса
  • 2 - ожидание ответа
  • 3 - ошибка
  • 4 - успех
  • 6 - слишком много запросов
error string Данные об ошибках.
result object Результат запроса согласно всем выбранным параметрам. Содержит элементы:
  • groups - содержит информацию о групировках
  • total - Общие данные статистики. Может содержать все элементы описанные в таблице Список полей ответа
  • itemsCount - количество строк данных
  • totalRowsCount - количество дочерних (сгруппированных) строк данных
  • items - данные сгруппированной статистики, каждый элемент может включать в себя все элементы описанные в таблице Список полей ответа items

Пример запроса:

{site_path}/{lang}/api/reports/publishers-dsp?periodStart=15-07-2020&periodEnd=15-07-2020&ids=2093693536&groups=hitDate,mediaID,campaignID,siteID&countries=43,42®ions=709,719,722&cities=711660,711390,709248&metric=views,clicks,ctr&order=-hitDate

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

{
  "status": 4,
  "error": null,
  "result": {
    "groups": [
      "hitDate",
      "mediaID",
      "campaignID",
      "siteID"
    ],
    "total": {
      "views": 871,
      "vp": 0,
      "clicks": 3,
      "cp": 0,
      "ctr": "0.34%",
      "uniqueViews": 0,
      "uvp": 0,
      "uniqueClicks": 0,
      "ucp": 0,
      "uvr": 0,
      "cpm": 0,
      "cpc": 0,
      "cpa": 0,
      "spend": 0
    },
    "itemsCount": 4,
    "totalRowsCount": 5,
    "items": {
      "group2020-07-15": {
        "group": "hitDate",
        "id": "2020-07-15",
        "value": "",
        "total": {
          "views": 871,
          "vp": 0,
          "clicks": 3,
          "cp": 0,
          "ctr": "0.34%",
          "uniqueViews": 0,
          "uvp": 0,
          "uniqueClicks": 0,
          "ucp": 0,
          "uvr": 0,
          "cpm": 0,
          "cpc": 0,
          "cpa": 0,
          "spend": 0
        },
        "totalRowsCount": 5,
        "itemsCount": 4,
        "items": {
          "group1412746748": {
            "group": "mediaID",
            "id": "1412746748",
            "value": "my_media",
            "total": {
              "views": 444,
              "vp": 0,
              "clicks": 2,
              "cp": 0,
              "ctr": "0.45%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 2,
            "itemsCount": 2,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "my_company",
                "total": {
                  "views": 444,
                  "vp": 0,
                  "clicks": 2,
                  "cp": 0,
                  "ctr": "0.45%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 1,
                "itemsCount": 2,
                "items": {
                  "group1933910528": {
                    "group": "siteID",
                    "id": "1933910528",
                    "value": "kino",
                    "total": {
                      "views": 21,
                      "vp": 0,
                      "clicks": 0,
                      "cp": 0,
                      "ctr": 0,
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  },
                  "group1335501087": {
                    "group": "siteID",
                    "id": "1335501087",
                    "value": "dyna",
                    "total": {
                      "views": 423,
                      "vp": 0,
                      "clicks": 2,
                      "cp": 0,
                      "ctr": "0.47%",
                      "uniqueViews": 0,
                      "uvp": 0,
                      "uniqueClicks": 0,
                      "ucp": 0,
                      "uvr": 0,
                      "cpm": 0,
                      "cpc": 0,
                      "cpa": 0,
                      "spend": 0
                    },
                    "totalRowsCount": 0,
                    "itemsCount": 1,
                    "items": []
                  }
                }
              }
            }
          },
          "group1200965557": {
            "group": "mediaID",
            "id": "1200965557",
            "value": "test_media",
            "total": {
              "views": 427,
              "vp": 0,
              "clicks": 1,
              "cp": 0,
              "ctr": "0.23%",
              "uniqueViews": 0,
              "uvp": 0,
              "uniqueClicks": 0,
              "ucp": 0,
              "uvr": 0,
              "cpm": 0,
              "cpc": 0,
              "cpa": 0,
              "spend": 0
            },
            "totalRowsCount": 1,
            "itemsCount": 1,
            "items": {
              "group2093693536": {
                "group": "campaignID",
                "id": "2093693536",
                "value": "test_camp",
                "total": {
                  "views": 427,
                  "vp": 0,
                  "clicks": 1,
                  "cp": 0,
                  "ctr": "0.23%",
                  "uniqueViews": 0,
                  "uvp": 0,
                  "uniqueClicks": 0,
                  "ucp": 0,
                  "uvr": 0,
                  "cpm": 0,
                  "cpc": 0,
                  "cpa": 0,
                  "spend": 0
                },
                "totalRowsCount": 0,
                "itemsCount": 1,
                "items": []
              }
            }
          }
        }
      }
    }
  }
}