Звіти
Звіти дозволяють отримати доступ до детальної статистики по всіх сутностях, які представлені в цій документації.
Доступ до звітів надається всім користувачам, в яких є відповідний дозвіл в особистому кабінеті.
Для звітів передбачені наступні запити:
Звіт по кампаніям
Запит:
{site_path}/{lang}/api/reports/campaign
Список GET параметрів:
| periodStart | string | Дата початку періоду статистики. По замовчуваню: поточна |
| periodEnd | string | Дата завершеня периоду статистики. По замовчуваню: поточна |
| groups | string|array | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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-hour/{advertiserID}
Список GET параметрів:
| date | string | Дата початку періоду вибіоки даних у форматі РРРРММДДГ (Г-година у 24 годинному форматі без ведучого нуля). Дані будуть вибрані за 1 годину, починаючи з вказаного періоду. За замовчанням початковий період встановлено на попередню годину. |
Відповідь
Відповідь передається у форматі JSON. Список полів відповіді:
| status | int | Код HTTP відповіді. Можливі значення:
|
| error | array |
Дані про помилки. |
| result | string | Результат в csv форматі |
Приклад запиту:
{site_path}/{lang}/api/reports/advertisers-hour/1839110433?date=2020111815
Приклад відповіді:
{
"status": 200,
"error": null,
"result":
siteID;zoneID;campaignID;mediaID;countryID;os;osVer;browser;brVer;views;clicks;cpm;cpc;spend
1831664483;1839110212;1664162812;1700281405;20;20;4;11;18;1;0;1.398837;0;1183
1520052043;1741484376;1563462602;1700281405;20;20;9;1;74;1;0;0.144259;0;122
}
}
Звіт по рекламодавцям
Запит:
{site_path}/{lang}/api/reports/advertisers
Список GET параметрів:
| periodStart | string | Дата початку періоду статистики. По замовчуваню: поточна |
| periodEnd | string | Дата завершеня периоду статистики. По замовчуваню: поточна |
| groups | string|array | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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 | Багаторівневе групування статистики. Доступні значения:
|
| id | int | ID об'єкту, по котрому буде сформована статистика |
| ids | string|array | ID об'єктів, по котрим буде сформована статистика |
| countries | string|array | Фільтр по країнах |
| regions | string|array | Фільтр по регіонах |
| cities | string|array | Фільтр по містах |
| metric | string|array | Дані статистики. Можливі значення:
|
| 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 | Статус запиту. Можливі значення:
|
| error | string |
Дані про помилки. |
| result | object | Результат запиту відповідно до всіх обраних параметрів. Містить елементи:
|
Приклад запиту:
{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": []
}
}
}
}
}
}
}
}