Reporting API: Статистика
Метрики статистики
Все методы статистики отдают набор метрик, полностью или частично включающих:
- shows - количество показов объявлений
- clicks - количество кликов по объявлению
- requests - количество запросов
- requested_banners - общее число запрошенных баннеров. Каждый request к myTarget может запрашивать несколько баннеров.
- responses - количество баннеров, подобранных на запросы
- noshows - количество запрашиваемых баннеров, для которых не было подобрано объявление
- fill_rate - отношение количества полученных баннеров к общему количеству запрошенных баннеров
- amount - сумма начислений за показы объявлений
- cpm - средняя цена за 1000 показов
- ctr - click-through rate, соотношение пользователей, которые нажали на объявление, к общему количеству просмотревших
- currency - валюта аккаунта
- show_rate - процент показов к количеству ответов.
- vtr - процентное завершённых просмотров к количеству запусков видео
- vr - процент просмотров по данным MRC
Получение статистики по партнёрским площадкам
GET {host}/api/v2/statistics/partner/pads/day.json
Ресурс возвращает статистику по площадкам и группам площадок в разрешении 1 день.
Ограничения и фильтры задаются с помощью GET-параметров:
Ограничения и фильтры задаются с помощью GET-параметров:
Все параметры являются обязательными.
Вы можете запросить статистику не более чем за 92 дня и не более чем по 200 объектам в одном запросе.
Структура ответа:
Вы можете запросить статистику не более чем за 92 дня и не более чем по 200 объектам в одном запросе.
Структура ответа:
- items - массив статистики за запрашиваемый период
- id - идентификатор объекта. Можно запрашивать статистику как по отдельным площадкам, так и по группам, в том числе в одном запросе.
- rows - массив статистики с разбивкой по датам
- total - суммарная статистика по объекту за весь запрашиваемый период
- total - суммарная статистика по всем объектам за весь запрашиваемый период
GET /api/v2/statistics/partner/pads/day.json?id=3359&date_from=2017-09-20&date_to=2017-09-21
Пример ответа:
{
"items": [
{
"id": 123456,
"rows": [
{
"date": "2020-11-29",
"currency": "USD",
"shows": 50436,
"clicks": 301,
"goals": 10,
"ctr": 0.5967959394083592,
"custom": 102320,
"requests": 1205055,
"requested_banners": 1205055,
"responsed_blocks": 136810,
"responses": 136810,
"noshows": 1068245,
"amount": "35.43257",
"cpm": "0.7025253786977556",
"fill_rate": 11.353008783831443,
"show_rate": 36.86572618960602,
"vtr": 94.82252044786786,
"vr": 100
},
{
"date": "2020-11-30",
"currency": "USD",
"shows": 37123,
"clicks": 273,
"goals": 15,
"ctr": 0.7353931524930636,
"custom": 183470,
"requests": 886809,
"requested_banners": 886809,
"responsed_blocks": 75472,
"responses": 75472,
"noshows": 811337,
"amount": "117.08865",
"cpm": "3.1540729466907308",
"fill_rate": 8.51051353786441,
"show_rate": 49.18777824888701,
"vtr": 95.34674001262512,
"vr": 100
}
],
"total": {
"shows": 679125,
"clicks": 3769,
"goals": 204,
"ctr": 0.5549788330572428,
"custom": 1918334,
"requests": 13179610,
"requested_banners": 13179610,
"responsed_blocks": 1966523,
"responses": 1966523,
"noshows": 11213087,
"amount": "961.09239",
"cpm": "1.4151921811154059",
"fill_rate": 14.920949861187092,
"show_rate": 34.53430242107517,
"vtr": 94.98171612084903,
"vr": 100
}
}
],
"total": {
"shows": 1829746,
"clicks": 20699,
"goals": 1799,
"ctr": 1.131249911189859,
"custom": 8177452,
"requests": 33520764,
"requested_banners": 33520764,
"responsed_blocks": 4652199,
"responses": 4652199,
"noshows": 28868565,
"amount": "3869.97049",
"cpm": "2.115031534431555",
"fill_rate": 13.878558973178535,
"show_rate": 39.33077669291447,
"vtr": 86.06228068868805,
"vr": 100
}
}
Получение статистики по сайтам площадок
GET {host}/api/v2/statistics/pad_with_sites/day.json
Ресурс возвращает статистику по сайтам площадок в разрешении 1 день.
Ограничения и фильтры задаются с помощью GET-параметров:
Ограничения и фильтры задаются с помощью GET-параметров:
Все параметры являются обязательными.
Получение статистики по площадкам с разбивкой по гео
GET {host}/api/v2/statistics/geo/pads/{hour|day|summary}.json
Метод позволяет получать статистику по площадкам с разбивкой по географическим регионам и времени (hour - по часам, day - по дням, summary - суммарно).
Ограничения и фильтры задаются с помощью GET-параметров:
Ограничения и фильтры задаются с помощью GET-параметров:
Параметры date_from, date_to и id являются обязательными.
Получить список всех регионов можно с помощью метода /api/v2/regions.json.
Структура ответа:
Пример запроса:
Получить список всех регионов можно с помощью метода /api/v2/regions.json.
Структура ответа:
- items - массив статистики за запрашиваемый период
- id - идентификатор объекта
- rows - массив статистики с разбивкой по датам. Включает массив histogram - разбивку по географическим регионам, чьи идентификаторы указаны в поле geo
- total - суммарная статистика по объекту за весь запрашиваемый период с разбивкой по географическим регионам
- total - суммарная статистика по всем объектам за весь запрашиваемый период с разбивкой по географическим регионам
Пример запроса:
GET /api/v2/statistics/geo/pads/day.json?date_from=2017-10-01&date_to=2017-10-12&id=7695
Пример ответа:
{
"items": [{
"id": 7695,
"rows": [{
"date": "2017-12-20",
"histogram": [{
"geo": 188,
"clicks": 0,
"shows": 697,
"goals": 0,
"noshows": 1,
"requests": 2390,
"requested_banners": 2390,
"responsed_blocks": 2389,
"responsed_banners": 2389,
"amount": "4.08"
},
...
{
"geo": 191,
"clicks": 0,
"shows": 5,
"goals": 0,
"noshows": 50,
"requests": 58,
"requested_banners": 58,
"responsed_blocks": 10,
"responsed_banners": 10,
"amount": "0"
}]
},
{
"date": "2017-12-21",
"histogram": [{
"geo": 188,
"clicks": 0,
"shows": 520,
"goals": 0,
"noshows": 1,
"requests": 1888,
"requested_banners": 1888,
"responsed_blocks": 1887,
"responsed_banners": 1887,
"amount": "2.57"
},
...
{
"geo": 191,
"clicks": 0,
"shows": 6,
"goals": 0,
"noshows": 64,
"requests": 88,
"requested_banners": 88,
"responsed_blocks": 25,
"responsed_banners": 25,
"amount": "0"
}]
}],
"total": {
"histogram": [{
"geo": 188,
"clicks": 0,
"shows": 1217,
"goals": 0,
"noshows": 2,
"requests": 4278,
"requested_banners": 4278,
"responsed_blocks": 4276,
"responsed_banners": 4276,
"amount": "6.65"
},
...
{
"geo": 191,
"clicks": 0,
"shows": 11,
"goals": 0,
"noshows": 114,
"requests": 146,
"requested_banners": 146,
"responsed_blocks": 35,
"responsed_banners": 35,
"amount": "0"
}]
}
}],
"total": {
"histogram": [{
"geo": 188,
"clicks": 0,
"shows": 1217,
"goals": 0,
"noshows": 2,
"requests": 4278,
"requested_banners": 4278,
"responsed_blocks": 4276,
"responsed_banners": 4276,
"amount": "6.65"
},
...
{
"geo": 191,
"clicks": 0,
"shows": 11,
"goals": 0,
"noshows": 114,
"requests": 146,
"requested_banners": 146,
"responsed_blocks": 35,
"responsed_banners": 35,
"amount": "0"
}]
}
}
Вам помогла эта статья?