Метрики статистики
Все методы статистики отдают набор метрик, полностью или частично включающих:
- shows — количество показов объявлений.
- clicks — количество кликов по объявлению.
- requests — количество запросов.
- requested_banners — общее число запрошенных баннеров. Каждый request к Рекламной сети VK может запрашивать несколько баннеров.
- 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-параметров:
| Параметр | Формат | Описание |
|---|---|---|
| date_from | YYYY-MM-DD | Начальная дата |
| date_to | YYYY-MM-DD | Конечная дата (включительно) |
| id | список идентификаторов, разделенных запятой | Список идентификаторов площадок или групп площадок. Вы можете получить список объектов с помощью API или найти object id (pad или group_pad id) в адресной строке браузера. Например:
|
Все параметры являются обязательными.
Вы можете запросить статистику не более чем за 92 дня и не более чем по 200 объектам в одном запросе.
Структура ответа:
- items — массив статистики за запрашиваемый период
- id — идентификатор объекта. Можно запрашивать статистику как по отдельным площадкам, так и по группам, в том числе в одном запросе.
- rows — массив статистики с разбивкой по датам
- total — суммарная статистика по объекту за весь запрашиваемый период
- total — суммарная статистика по всем объектам за весь запрашиваемый период
Пример запроса:
GET https://target.vk.ru/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-параметров:
| Параметр | Формат | Описание |
|---|---|---|
| date_from | YYYY-MM-DD | Начальная дата |
| date_to | YYYY-MM-DD | Конечная дата (включительно) |
| pads | список идентификаторов, разделенных запятой | Список идентификаторов площадок. Вы можете получить список объектов с помощью API или найти object id (pad или group_pad id) в адресной строке браузера. Например:
|
Все параметры являются обязательными.
Получение статистики по площадкам с разбивкой по гео
GET {host}/api/v2/statistics/geo/pads/{hour|day|summary}.json
Метод позволяет получать статистику по площадкам с разбивкой по географическим регионам и времени (hour — по часам, day — по дням, summary — суммарно).
Ограничения и фильтры задаются с помощью GET-параметров:
| Параметр | Формат | Описание |
|---|---|---|
| date_from | YYYY-MM-DD | Начальная дата |
| date_to | YYYY-MM-DD | Конечная дата (включительно) |
| id | список идентификаторов, разделенных запятой | Список идентификаторов площадок. Вы можете получить список объектов с помощью API или найти object id (pad или group_pad id) в адресной строке браузера. Например:
|
| level | строка | Уровень детализации. Значения:
Значение по умолчанию — country. |
| region | идентификатор региона | Идентификатор региона. Ограничивает статистику только по указанному региону и его дочерним регионам. |
Параметры date_from, date_to и id являются обязательными.
Получить список всех регионов можно с помощью метода https://target.vk.ru/api/v2/regions.json.
Структура ответа:
- items - массив статистики за запрашиваемый период
- id - идентификатор объекта
- rows - массив статистики с разбивкой по датам. Включает массив histogram - разбивку по географическим регионам, чьи идентификаторы указаны в поле geo
- total - суммарная статистика по объекту за весь запрашиваемый период с разбивкой по географическим регионам
- total - суммарная статистика по всем объектам за весь запрашиваемый период с разбивкой по географическим регионам
Пример запроса:
GET https://target.vk.ru/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" }] }}