Reporting API: Статистика


Метрики статистики

Все методы статистики по партнёрским площадкам и группам площадок отдают набор метрик, полностью или частично включающих:

  • shows - количество показов объявлений на площадке
  • clicks - количество кликов по объявлению на площадке
  • requests - количество запросов для площадки
  • requested_banners - общее количество баннеров, запрошенных для площадки. В одном запросе может быть запрошено более 1 баннера.
  • responses - количество баннеров, подобранных на запросы
  • noshows - количество запрашиваемых баннеров, для которых не было подобрано объявление
  • fill_rate - заполняемость: отношение подобранных баннеров к общему количеству запрошенных баннеров
  • amount - сумма начислений за показы объявлений
  • cpm - средняя стоимость показа одного объявления на площадке
  • ctr - процент показов, которые привели к клику по объявлению
  • currency - валюта аккаунта
  • show_rate - процентное соотношение показов баннеров к количеству баннеров в ответах.
  • vtr - процентное соотношение завершённых просмотров к количеству запусков видео, умноженное на 100%
  • vr - процентное соотношение видимых просмотров ко всем просмотрам по MRC

Получение статистики по партнёрским площадкам

GET {host}/api/v2/statistics/partner/pads/day.json
Ресурс возвращает статистику по площадкам и группам площадок в разрешении 1 день.

Ограничения и фильтры задаются с помощью GET-параметров:
Все параметры являются обязательными.

Вы можете запросить статистику не более чем за 92 дня и не более чем по 200 объектам в одном запросе.

Структура ответа:

  • items - массив статистики за запрашиваемый период
    • id - идентификатор объекта. Можно запрашивать статистику как по отдельным площадкам, так и по группам, в том числе в одном запросе.
    • rows - массив статистики с разбивкой по датам
    • total - суммарная статистика по объекту за весь запрашиваемый период
  • total - суммарная статистика по всем объектам за весь запрашиваемый период
Пример запроса:
GET https://target.my.com/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 {host}/api/v2/statistics/geo/pads/{hour|day|summary}.json
Метод позволяет получать статистику по площадкам с разбивкой по географическим регионам и времени (hour - по часам, day - по дням, summary - суммарно).

Ограничения и фильтры задаются с помощью GET-параметров:
Параметры date_from, date_to и id являются обязательными.

Получить список всех регионов можно с помощью метода https://target.my.com/api/v2/regions.json.

Структура ответа:

  • items - массив статистики за запрашиваемый период
    • id - идентификатор объекта
    • rows - массив статистики с разбивкой по датам. Включает массив histogram - разбивку по географическим регионам, чьи идентификаторы указаны в поле geo
    • total - суммарная статистика по объекту за весь запрашиваемый период с разбивкой по географическим регионам
  • total - суммарная статистика по всем объектам за весь запрашиваемый период с разбивкой по географическим регионам

Пример запроса:
GET https://target.my.com/api/v2/statistics/geo/pads/day.json?date_from=2017-10-01&date_to=2017-10-12&id=571843
Пример ответа:
{
    
    "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"
        }]
    }
}
Вам помогла эта статья?
Да
Нет