Статистика v2

API-методы статистики v2 позволяют получать различную статистику по рекламным объектам.

Ограничения и фильтры в этих методах задаются с помощью GET-параметров, а не в теле адреса, как это происходит в API v1.

Ограничения запросов

  • Статистика с разбивкой по дням возвращается не более чем за последние 365 дней. 
  • В одном запросе можно получить статистику не более чем по 200 объектам. 

Обработка ошибок

В случае ошибки возвращается ответ вида:

{
    "error":
    {
        "message": "message_text",
        "code": "CODE"
    }
}

Возможные ошибки

HTTP-код Code Описание
400 ERR_WRONG_PARAMETER Некорректное значение параметра, либо не указан обязательный параметр
400 ERR_LIMIT_EXCEEDED Превышен лимит запрашиваемых дат или количества объектов
400 ERR_WRONG_DATE Указана некорректная дата
400 ERR_WRONG_BANNERS Запрашиваемые баннеры не существуют или недоступны для данного API-пользователя
400 ERR_WRONG_CAMPAIGNS Запрашиваемые кампании не существуют или недоступны для данного API-пользователя
400 ERR_WRONG_USERS Пользователя не существует или статистика по нему недоступна для данного API-пользователя
403 ERR_ACCESS_DENIED Нет прав для доступа к API-методу
404 ERR_WRONG_RESOURCE API-метода не существует
500 ERR_INTERNAL Внутренняя ошибка сервера

 

Методы

Общая статистика

GET {host}/api/v2/statistics/{banners|campaigns|users}/{day|summary}.json

Ресурс возвращает суммарную за все время открутки или подневную за выбранный период статистику по аккаунтам, кампаниям, баннерам.

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

Параметр Формат Значение по умолчанию Описание
date_from YYYY-MM-DD   Начальная дата. Только для day.json.
date_to YYYY-MM-DD   Конечная дата (включительно). Только для day.json.
id список идентификаторов, разделенных запятой   Список идентификаторов баннеров, кампаний или пользователей.
metrics список текстовых идентификаторов, разделенных запятой base Список наборов метрик. Доступные варианты: all, base, events, video, viral, uniques, tps, playable, romi.
attribution impression default атрибуцировать по времени события, времени показа. Игнорируется для summary

Все параметры кроме metrics являются обязательными.

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

    • shows - количество показов;
    • clicks - количество кликов;
    • goals - количество достижений целей (цели Top@Mail.ru для сайтов и установок для мобильных приложений);
    • spent - списания;
    • cpm - среднее списание за 1000 просмотров;
    • cpc - среднее списание за 1 клик;
    • cpa - среднее списание за достижение 1 цели;
    • ctr - процентное отношение количества кликов к количеству просмотров;
    • cr - процентное отношение количества достижений целей к количеству кликов.
    • opening_app - количество открытий рекламируемого приложения соцсетей;
    • opening_post - количество открытий рекламируемого сообщения в ленте соцсетей;
    • moving_into_group - количество переходов на страницу группы из рекламируемого сообщения;
    • clicks_on_external_url - количество кликов по внешней ссылке в рекламируемом сообщении;
    • launching_video - количество запусков видео в рекламируемом сообщении;
    • comments - количество оставленных комментариев в рекламируемом сообщении;
    • joinings - количество присоединений к группе через рекламируемое сообщение;
    • likes - количество лайков рекламируемого сообщения;
    • shares - количество действий "Поделиться" для рекламируемого сообщения;
    • votings - количество действий голосования в рекламируемом сообщении.
    • reach - количество уникальных пользователей, увидевших объявление за указанный период;
    • total - общее количество уникальных пользователей, увидевших объявление за всё время;
    • increment - количество новых уникальных пользователей, увидевших объявление за указанный период;
    • frequency - средняя частота показа объявлений одному уникальному пользователю.
    • started - количество стартов воспроизведения видео;
    • paused - количество пауз воспроизведения видео;
    • resumed_after_pause - количество воспроизведения видео после паузы;
    • fullscreen_on - количество включений полноэкранного режима воспроизведения видео;
    • fullscreen_off - количество выключений полноэкранного режима воспроизведения видео;
    • sound_turned_off - количество выключений звука видео;
    • sound_turned_on - количество включений звука видео;
    • viewed_10_seconds - количество просмотров первых 10 секунд видео;
    • viewed_25_percent - количество просмотров первых 25% длительности видео;
    • viewed_50_percent - количество просмотров первых 50% длительности видео;
    • viewed_75_percent - количество просмотров первых 75% длительности видео;
    • viewed_100_percent - количество просмотров 100% длительности видео;
    • viewed_10_seconds_rate - процент просмотров с достижением первых 10 секунд видео;
    • viewed_25_percent_rate - процент просмотров с достижением первых 25% длительности видео;
    • viewed_50_percent_rate - процент просмотров с достижением первых 50% длительности видео;
    • viewed_75_percent_rate - процент просмотров с достижением первых 75% длительности видео;
    • viewed_100_percent_rate - процент просмотров с достижением 100% длительности видео;
    • depth_of_view - средняя глубина просмотра видео (в процентах);
    • view_10_seconds_cost - средняя стоимость просмотра первых 10 секунд видео;
    • viewed_25_percent_cost - средняя стоимость просмотра первых 25% длительности видео;
    • viewed_50_percent_cost - средняя стоимость просмотра первых 50% длительности видео;
    • viewed_75_percent_cost - средняя стоимость просмотра первых 75% длительности видео;
    • viewed_100_percent_cost - средняя стоимость просмотра 100% длительности видео.
    • impressions - количество показов расшаренного рекламного сообщения в социальных сетях;
    • reach - количество уникальных пользователей, увидивших расшаренное рекламное сообщение за указанный период;
    • total - общее количество уникальных пользователей, увидевших расшаренное рекламное сообщение за всё время;
    • increment - количество новых уникальных пользователей, увидевших расшаренное рекламное сообщение за указанный период;
    • frequency - средняя частота показа расшаренного рекламного сообщения одному уникальному пользователю;
    • opening_app - количество открытий рекламируемого приложения из расшаренного рекламного сообщения;
    • opening_post - количество открытий расшаренного рекламируемого сообщения в ленте соцсетей;
    • moving_into_group - количество переходов на страницу группы из расшаренного рекламируемого сообщения;
    • clicks_on_external_url - количество кликов по внешней ссылке в расшаренном рекламируемом сообщении;
    • launching_video - количество запусков видео в расшаренном рекламируемом сообщении;
    • comments - количество оставленных комментариев в расшаренном рекламируемом сообщении;
    • joinings - количество присоединений к группе через расшаренное рекламируемое сообщение;
    • likes - количество лайков расшаренного рекламируемого сообщения;
    • shares - количество действий "Поделиться" для расшаренного рекламируемого сообщения;
    • votings - количество действий голосования в расшаренном рекламируемом сообщении.
    • slide_N_shows - количество показов слайда N;
    • slide_N_clicks - количество кликов по слайду N;
    • slide_N_ctr - процентное отношение количества кликов к количеству просмотров по слайду N;
    • tps - дополнительные списания за использование сервиса moat;
    • tpd - дополнительные списания за использование сторонних данных (от dmp). 
    • impressions - количество показов;
    • in_view - количество видимых показов;
    • never_focused - количество показов в неактивной вкладке;
    • never_visible - количество показов вне зоны видимости;
    • never_50_perc_visible - количество показов с зоной видимости объявления менее 50%;
    • never_1_sec_visible - количество показов с длительностью видимости менее 1 секунды;
    • human_impressions - количество верифицированных показов;
    • impressions_analyzed - количество анализируемых показов;
    • in_view_percent - процент видимых показов;
    • human_and_viewable_perc - процент верифицированных показов;
    • never_focused_percent - процент показов в неактивной вкладке;
    • never_visible_percent - процент показов вне зоны видимости;
    • never_50_perc_visible_percent - процент оказов с зоной видимости объявления менее 50%;
    • never_1_sec_visible_percent - процент показов с длительностью видимости менее 1 секунды;
    • in_view_diff_percent - разница в количестве видимых показов;
    • active_in_view_time - среднее время нахождения объявления в зоне видимости;
    • attention_quality - уровень вовлечения;
    • playable_game_open - открытие игры;
    • playable_game_close - закрытие игры;
    • playable_call_to_action - клики;
    • value - заданная ценность события
    • romi - показатель возврата инвестиций
    • adv_cost_share - доля рекламных расходов

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

  • items - массив статистики за запрашиваемый период
    • id - идентификатор объекта
    • rows - массив статистики за конкретную дату
      • date - дата
      • metrics - массивы запрошенных метрик
    • total - суммарная статистика по объекту за запрашиваемый период
  • total - суммарная статистика по всем объектам за запрашиваемый период

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

{
    "items": [
        {
            "id": 8372481,
            "rows": [
                {
                    "date": "2017-10-30",
                    "base": {
                        "shows": 75881,
                        "clicks": 270,
                        "goals": 0,
                        "spent": "23328.92",
                        "a_amount": "23328.92",
                        "n_amount": "0",
                        "cpm": "307.44",
                        "cpc": "86.4",
                        "cpa": "0",
                        "ctr": 0.355820297571197,
                        "cr": 0
                    },
                    "events": {
                        "opening_app": 0,
                        "opening_post": 438,
                        "moving_into_group": 8,
                        "clicks_on_external_url": 5,
                        "launching_video": 64707,
                        "comments": 3,
                        "joinings": 0,
                        "likes": 22,
                        "shares": 0,
                        "votings": 0,
                        "sending_form": 0
                    },
                    "uniques": {
                        "reach": 66370,
                        "total": 786752,
                        "increment": 53327,
                        "frequency": 1.1433026970016573
                    },
                    "video": {
                        "started": 80266,
                        "paused": 233,
                        "resumed_after_pause": 68,
                        "fullscreen_on": 13,
                        "fullscreen_off": 21,
                        "sound_turned_off": 11,
                        "sound_turned_on": 22,
                        "viewed_10_seconds": 0,
                        "viewed_25_percent": 33684,
                        "viewed_50_percent": 25182,
                        "viewed_75_percent": 20488,
                        "viewed_100_percent": 18142,
                        "viewed_10_seconds_rate": 0,
                        "viewed_25_percent_rate": 41.965464829442105,
                        "viewed_50_percent_rate": 31.373184162659157,
                        "viewed_75_percent_rate": 25.525128946253705,
                        "viewed_100_percent_rate": 22.602347195574715,
                        "depth_of_view": 32.12134790000132,
                        "measurement_rate": 87.5,
                        "vr": 78.57,
                        "viewed_10_seconds_cost": "0",
                        "viewed_25_percent_cost": "0.69",
                        "viewed_50_percent_cost": "0.93",
                        "viewed_75_percent_cost": "1.14",
                        "viewed_100_percent_cost": "1.29"
                    },
                    "viral": {
                        "impressions": 33,
                        "reach": 31,
                        "total": 1505,
                        "increment": 37,
                        "frequency": 1.064516129032258,
                        "opening_app": 0,
                        "opening_post": 0,
                        "moving_into_group": 0,
                        "clicks_on_external_url": 0,
                        "launching_video": 13,
                        "comments": 0,
                        "joinings": 0,
                        "likes": 0,
                        "shares": 0,
                        "votings": 0,
                        "sending_form": 0
                    },
                    "carousel": {
                        "slide_1_clicks": 0,
                        "slide_1_shows": 0,
                        "slide_2_clicks": 0,
                        "slide_2_shows": 0,
                        "slide_3_clicks": 0,
                        "slide_3_shows": 0,
                        "slide_4_clicks": 0,
                        "slide_4_shows": 0,
                        "slide_5_clicks": 0,
                        "slide_5_shows": 0,
                        "slide_6_clicks": 0,
                        "slide_6_shows": 0,
                        "slide_1_ctr": 0,
                        "slide_2_ctr": 0,
                        "slide_3_ctr": 0,
                        "slide_4_ctr": 0,
                        "slide_5_ctr": 0,
                        "slide_6_ctr": 0
                    },
                    "playable": {
                        "playable_game_open": 67,
                        "playable_game_close": 75,
                        "playable_call_to_action": 24
                    },
                    "tps": {
                        "tps": "758.81",
                        "tpd": "0"
                    },
                    "moat": {
                        "impressions": 529459,
                        "in_view": 91454,
                        "never_focused": 7005,
                        "never_visible": 410753,
                        "never_50_perc_visible": 4658,
                        "never_1_sec_visible": 15589,
                        "human_impressions": 529973,
                        "impressions_analyzed": 529973,
                        "in_view_percent": 17.273104,
                        "human_and_viewable_perc": 17.273104,
                        "never_focused_percent": 1.3230486,
                        "never_visible_percent": 77.57976,
                        "never_50_perc_visible_percent": 0.8797659,
                        "never_1_sec_visible_percent": 2.9443262,
                        "in_view_diff_percent": -17.028236,
                        "active_in_view_time": 0,
                        "attention_quality": 0
                    },
                    "romi": {
                        "value": "2479.5",
                        "romi": 188.5152431929253,
                        "adv_cost_share": 34.66021375277274
                    }
                }
            ],
            "total": {
                "base": {
                    "shows": 75881,
                    "clicks": 270,
                    "goals": 0,
                    "spent": "23328.92",
                    "a_amount": "23328.92",
                    "n_amount": "0",
                    "cpm": "307.44",
                    "cpc": "86.4",
                    "cpa": "0",
                    "ctr": 0.355820297571197,
                    "cr": 0
                },
                "events": {
                    "opening_app": 0,
                    "opening_post": 438,
                    "moving_into_group": 8,
                    "clicks_on_external_url": 5,
                    "launching_video": 64707,
                    "comments": 3,
                    "joinings": 0,
                    "likes": 22,
                    "shares": 0,
                    "votings": 0,
                    "sending_form": 0
                },
                "uniques": {
                    "reach": 53327,
                    "total": 786752,
                    "increment": 53327,
                    "frequency": 1.4229377238547078
                    "frequency_total": 17.937582846444224
                },
                "video": {
                    "started": 80266,
                    "paused": 233,
                    "resumed_after_pause": 68,
                    "fullscreen_on": 13,
                    "fullscreen_off": 21,
                    "sound_turned_off": 11,
                    "sound_turned_on": 22,
                    "viewed_10_seconds": 0,
                    "viewed_25_percent": 33684,
                    "viewed_50_percent": 25182,
                    "viewed_75_percent": 20488,
                    "viewed_100_percent": 18142,
                    "viewed_10_seconds_rate": 0,
                    "viewed_25_percent_rate": 41.965464829442105,
                    "viewed_50_percent_rate": 31.373184162659157,
                    "viewed_75_percent_rate": 25.525128946253705,
                    "viewed_100_percent_rate": 22.602347195574715,
                    "vr": 78.57,
                    "depth_of_view": 32.12134790000132,
                    "viewed_10_seconds_cost": "0",
                    "viewed_25_percent_cost": "0.69",
                    "viewed_50_percent_cost": "0.93",
                    "viewed_75_percent_cost": "1.14",
                    "viewed_100_percent_cost": "1.29"
                },
                "viral": {
                    "impressions": 33,
                    "reach": 37,
                    "total": 1505,
                    "increment": 37,
                    "frequency": 0.8918918918918919,
                    "opening_app": 0,
                    "opening_post": 0,
                    "moving_into_group": 0,
                    "clicks_on_external_url": 0,
                    "launching_video": 13,
                    "comments": 0,
                    "joinings": 0,
                    "likes": 0,
                    "shares": 0,
                    "votings": 0,
                    "sending_form": 0
                },
                "carousel": {
                    "slide_1_clicks": 0,
                    "slide_1_shows": 0,
                    "slide_2_clicks": 0,
                    "slide_2_shows": 0,
                    "slide_3_clicks": 0,
                    "slide_3_shows": 0,
                    "slide_4_clicks": 0,
                    "slide_4_shows": 0,
                    "slide_5_clicks": 0,
                    "slide_5_shows": 0,
                    "slide_6_clicks": 0,
                    "slide_6_shows": 0,
                    "slide_1_ctr": 0,
                    "slide_2_ctr": 0,
                    "slide_3_ctr": 0,
                    "slide_4_ctr": 0,
                    "slide_5_ctr": 0,
                    "slide_6_ctr": 0
                },
                "playable": {
                    "playable_game_open": 67,
                    "playable_game_close": 75,
                    "playable_call_to_action": 24
                },
                "tps": {
                    "tps": "758.81",
                    "tpd": "0"
                },
                "moat": {
                    "impressions": 529459,
                    "in_view": 91454,
                    "never_focused": 7005,
                    "never_visible": 410753,
                    "never_50_perc_visible": 4658,
                    "never_1_sec_visible": 15589,
                    "human_impressions": 529973,
                    "impressions_analyzed": 529973,
                    "in_view_percent": 17.273104,
                    "human_and_viewable_perc": 17.273104,
                    "never_focused_percent": 1.3230486,
                    "never_visible_percent": 77.57976,
                    "never_50_perc_visible_percent": 0.8797659,
                    "never_1_sec_visible_percent": 2.9443262,
                    "in_view_diff_percent": -17.028236,
                    "active_in_view_time": 0,
                    "attention_quality": 0
                },
                "romi": {
                    "value": "2479.5",
                    "romi": 188.5152431929253,
                    "adv_cost_share": 34.66021375277274
                }
            }
        }
    ],
    "total": {
        "base": {
            "shows": 75881,
            "clicks": 270,
            "goals": 0,
            "spent": "23328.92",
            "a_amount": "23328.92",
            "n_amount": "0",
            "cpm": "307.44",
            "cpc": "86.4",
            "cpa": "0",
            "ctr": 0.355820297571197,
            "cr": 0
        },
        "events": {
            "opening_app": 0,
            "opening_post": 438,
            "moving_into_group": 8,
            "clicks_on_external_url": 5,
            "launching_video": 64707,
            "comments": 3,
            "joinings": 0,
            "likes": 22,
            "shares": 0,
            "votings": 0,
            "sending_form": 0
        },
        "video": {
            "started": 80266,
            "paused": 233,
            "resumed_after_pause": 68,
            "fullscreen_on": 13,
            "fullscreen_off": 21,
            "sound_turned_off": 11,
            "sound_turned_on": 22,
            "viewed_10_seconds": 0,
            "viewed_25_percent": 33684,
            "viewed_50_percent": 25182,
            "viewed_75_percent": 20488,
            "viewed_100_percent": 18142,
            "viewed_10_seconds_rate": 0,
            "viewed_25_percent_rate": 41.965464829442105,
            "viewed_50_percent_rate": 31.373184162659157,
            "viewed_75_percent_rate": 25.525128946253705,
            "viewed_100_percent_rate": 22.602347195574715,
            "depth_of_view": 32.12134790000132,
            "viewed_10_seconds_cost": "0",
            "viewed_25_percent_cost": "0.69",
            "viewed_50_percent_cost": "0.93",
            "viewed_75_percent_cost": "1.14",
            "viewed_100_percent_cost": "1.29"
        },
        "viral": {
            "impressions": 33,
            "opening_app": 0,
            "opening_post": 0,
            "moving_into_group": 0,
            "clicks_on_external_url": 0,
            "launching_video": 13,
            "comments": 0,
            "joinings": 0,
            "likes": 0,
            "shares": 0,
            "votings": 0,
            "sending_form": 0
        },
        "carousel": {
            "slide_1_clicks": 0,
            "slide_1_shows": 0,
            "slide_2_clicks": 0,
            "slide_2_shows": 0,
            "slide_3_clicks": 0,
            "slide_3_shows": 0,
            "slide_4_clicks": 0,
            "slide_4_shows": 0,
            "slide_5_clicks": 0,
            "slide_5_shows": 0,
            "slide_6_clicks": 0,
            "slide_6_shows": 0,
            "slide_1_ctr": 0,
            "slide_2_ctr": 0,
            "slide_3_ctr": 0,
            "slide_4_ctr": 0,
            "slide_5_ctr": 0,
            "slide_6_ctr": 0
        },
        "playable": {
            "playable_game_open": 67,
            "playable_game_close": 75,
            "playable_call_to_action": 24
        },
        "tps": {
            "tps": "758.81",
            "tpd": "0"
        },
        "moat": {
            "impressions": 529459,
            "in_view": 91454,
            "never_focused": 7005,
            "never_visible": 410753,
            "never_50_perc_visible": 4658,
            "never_1_sec_visible": 15589,
            "human_impressions": 529973,
            "impressions_analyzed": 529973,
            "in_view_percent": 17.273104,
            "human_and_viewable_perc": 17.273104,
            "never_focused_percent": 1.3230486,
            "never_visible_percent": 77.57976,
            "never_50_perc_visible_percent": 0.8797659,
            "never_1_sec_visible_percent": 2.9443262,
            "in_view_diff_percent": -17.028236,
            "active_in_view_time": 0,
            "attention_quality": 0
        },
        "romi": {
            "value": "2479.5",
            "romi": 188.5152431929253,
            "adv_cost_share": 34.66021375277274
        }
    }
}

Статистика по целям

GET {host}/api/v2/statistics/goals/{banners|campaigns|users}/day.json

Ресурс возвращает статистику по конверсиям Top@Mail.ru и установкам мобильных приложений по кампаниям и баннерам в разрешении 1 день. 

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

Параметр Формат Описание
date_from YYYY-MM-DD Начальная дата 
date_to YYYY-MM-DD Конечная дата (включительно)
id список идентификаторов, разделенных запятой Список идентификаторов баннеров или кампаний
attribution impression Атрибуцировать по времени события, времени показа
conversion_type postviewpostclicktotal или их комбинации разделенные через запятую Тип конверсии: postclick - постклик, postview - поствью, total - суммарно

Все параметры являются обязательными.

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

  • items - массив статистики за запрашиваемый период
    • id - идентификатор объекта
    • rows - массив статистики за конкретную дату
      • date - дата
      • goals - массивы данных статистики по целям
        • conversion_type - тип конверсии: postclick - постклик, postview - поствью, total - суммарно
        • source - тип события: topmail - конверсии счётчика, mobile - мобильные конверсии
        • goal - название цели счётчика или тип для мобильных (сейчас только install)
        • counter_id - идентификатор счётчика
        • count - количество конверсий
        • cr - коэффициент конверсии
        • cpa - стоимость одной конверсии
        • value - заданная ценность события
        • romi - показатель возврата инвестиций
        • adv_cost_share - доля рекламных расходов
    • total - суммарная статистика по объекту за весь запрашиваемый период
  • total - суммарная статистика по всем объектам за весь запрашиваемый период

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

{
    "items": [
        {
            "id": 1,
            "rows": [
                {
                    "date": "2017-03-13",
                    "goals": [
                        {
                            "conversion_type": "postclick",
                            "source": "topmail",
                            "goal": "my-goal",
                            "counter_id": 1,
                            "count": 0,
                            "cr": 0.0,
                            "cpa": "0.0",
                            "value": "0",
                            "romi": -100,
                            "adv_cost_share": 0
                        },
                        {
                            "conversion_type": "postclick",
                            "source": "mobile",
                            "goal": "install",
                            "counter_id": 0,
                            "count": 10,
                            "cr": 0.0,
                            "cpa": "0.0",
                            "value": "0",
                            "romi": -100,
                            "adv_cost_share": 0
                        },
                        {
                            "conversion_type": "postview",
                            "source": "mobile",
                            "goal": "install",
                            "counter_id": 0,
                            "count": 5,
                            "cr": 0.0,
                            "cpa": "0.0",
                            "value": "0",
                            "romi": -100,
                            "adv_cost_share": 0
                        },
                        {
                            "conversion_type": "total",
                            "source": "mobile",
                            "goal": "install",
                            "counter_id": 0,
                            "count": 15,
                            "cr": 0.0,
                            "cpa": "0.0",
                            "value": "0",
                            "romi": -100,
                            "adv_cost_share": 0
                        }
                    ]
                }
            ],
            "total": {
                "goals": [
                    {
                        "conversion_type": "postclick",
                        "source": "topmail",
                        "goal": "my-goal",
                        "counter_id": 1,
                        "count": 0,
                        "cr": 0.0,
                        "cpa": "0.0",
                        "value": "0",
                        "romi": -100,
                        "adv_cost_share": 0
                    },
                    {
                        "conversion_type": "postclick",
                        "source": "mobile",
                        "goal": "install",
                        "counter_id": 0,
                        "count": 10,
                        "cr": 0.0,
                        "cpa": "0.0",
                        "value": "0",
                        "romi": -100,
                        "adv_cost_share": 0
                    },
                    {
                        "conversion_type": "postview",
                        "source": "mobile",
                        "goal": "install",
                        "counter_id": 0,
                        "count": 5,
                        "cr": 0.0,
                        "cpa": "0.0",
                        "value": "0",
                        "romi": -100,
                        "adv_cost_share": 0
                    },
                    {
                        "conversion_type": "total",
                        "source": "mobile",
                        "goal": "install",
                        "counter_id": 0,
                        "count": 15,
                        "cr": 0.0,
                        "cpa": "0.0",
                        "value": "0",
                        "romi": -100,
                        "adv_cost_share": 0
                    }
                ]
            }
        }
    ],
    "total": {
        "goals": [
            {
                "conversion_type": "postclick",
                "source": "topmail",
                "goal": "my-goal",
                "counter_id": 1,
                "count": 0,
                "cr": 0.0,
                "cpa": "0.0",
                "value": "0",
                "romi": -100,
                "adv_cost_share": 0
            },
            {
                "conversion_type": "postclick",
                "source": "mobile",
                "goal": "install",
                "counter_id": 0,
                "count": 10,
                "cr": 0.0,
                "cpa": "0.0",
                "value": "0",
                "romi": -100,
                "adv_cost_share": 0
            },
            {
                "conversion_type": "postview",
                "source": "mobile",
                "goal": "install",
                "counter_id": 0,
                "count": 5,
                "cr": 0.0,
                "cpa": "0.0",
                "value": "0",
                "romi": -100,
                "adv_cost_share": 0
            },
            {
                "conversion_type": "total",
                "source": "mobile",
                "goal": "install",
                "counter_id": 0,
                "count": 15,
                "cr": 0.0,
                "cpa": "0.0",
                "value": "0",
                "romi": -100,
                "adv_cost_share": 0
            }
        ]
    }
}

Статистика по событиям внутри приложения

GET {host}/api/v2/statistics/inapp/{banners|campaigns|users}/day.json

Ресурс возвращает статистику по аттрибуцированным с рекламными показами myTarget событиями мобильных приложений по кампаниям и баннерам в разрешении 1 день. 

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

Параметр Формат Описание
date_from YYYY-MM-DD Начальная дата 
date_to YYYY-MM-DD Конечная дата (включительно)
id список идентификаторов, разделенных запятой Список идентификаторов пользователей, баннеров или кампаний
attribution impression Атрибуцировать по времени события, времени показа
conversion_type postview, postclick, total или их комбинации разделенные через запятую Тип конверсии: postclick - постклик, postview - поствью, total - суммарно

Все параметры являются обязательными.

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

  • items - массив статистики за запрашиваемый период
    • id - идентификатор объекта
    • rows - массив статистики за конкретную дату
      • date - дата
      • inapps - массивы данных статистики по событиям
        • conversion_type - тип конверсии: postclick - постклик, postview - поствью, total - суммарно
        • cpa - стоимость одной конверсии
        • cr - коэффициент конверсии
        • count - количество конверсий
        • event - название события
        • app - идентификатор мобильного приложения
        • tracker - идентификатор трекера мобильных приложений
        • value - заданная ценность события
        • romi - показатель возврата инвестиций
        • adv_cost_share - доля рекламных расходов
    • total - суммарная статистика по объекту за весь запрашиваемый период
  • total - суммарная статистика по всем объектам за весь запрашиваемый период

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

{
  "total": {
    "inapps": [
      {
        "conversion_type": "postclick",
        "cpa": "256.17",
        "cr": 3.0446194225721785,
        "count": 58,
        "event": "af_add_to_cart",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "postclick",
        "cpa": "43.96",
        "cr": 17.74278215223097,
        "count": 338,
        "event": "af_content_view",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "postclick",
        "cpa": "4.84",
        "cr": 160.997375328084,
        "count": 3067,
        "event": "af_list_view",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "postclick",
        "cpa": "137.57",
        "cr": 5.669291338582677,
        "count": 108,
        "event": "af_view_cart",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "postclick",
        "cpa": "7428.97",
        "cr": 0.10498687664041995,
        "count": 6,
        "event": "af_purchase",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "postview",
        "cpa": "7428.97",
        "cr": 0.10498687664041995,
        "count": 4,
        "event": "af_purchase",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      },
      {
        "conversion_type": "total",
        "cpa": "7428.97",
        "cr": 0.10498687664041995,
        "count": 10,
        "event": "af_purchase",
        "app": 461,
        "tracker": 1,
        "value": 10.1,
        "romi": 1.1,
        "adv_cost_share": 0.5
      }
    ]
  },
  "items": [
    {
      "total": {
        "inapps": [
          {
            "conversion_type": "postclick",
            "cpa": "256.17",
            "cr": 3.0446194225721785,
            "count": 58,
            "event": "af_add_to_cart",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "postclick",
            "cpa": "43.96",
            "cr": 17.74278215223097,
            "count": 338,
            "event": "af_content_view",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "postclick",
            "cpa": "4.84",
            "cr": 160.997375328084,
            "count": 3067,
            "event": "af_list_view",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "postclick",
            "cpa": "137.57",
            "cr": 5.669291338582677,
            "count": 108,
            "event": "af_view_cart",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "postclick",
            "cpa": "7428.97",
            "cr": 0.10498687664041995,
            "count": 2,
            "event": "af_purchase",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "postview",
            "cpa": "7428.97",
            "cr": 0.10498687664041995,
            "count": 4,
            "event": "af_purchase",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          },
          {
            "conversion_type": "total",
            "cpa": "7428.97",
            "cr": 0.10498687664041995,
            "count": 10,
            "event": "af_purchase",
            "app": 461,
            "tracker": 1,
            "value": 10.1,
            "romi": 1.1,
            "adv_cost_share": 0.5
          }
        ]
      },
      "rows": [
        {
          "inapps": [],
          "date": "2017-11-21"
        },
        {
          "inapps": [],
          "date": "2017-11-22"
        },
        {
          "inapps": [
            {
              "conversion_type": "postclick",
              "cpa": "124.89",
              "cr": 7.785888077858881,
              "count": 32,
              "event": "af_add_to_cart",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "23.51",
              "cr": 41.3625304136253,
              "count": 170,
              "event": "af_content_view",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "2.26",
              "cr": 430.17031630170317,
              "count": 1768,
              "event": "af_list_view",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "50.59",
              "cr": 19.22141119221411,
              "count": 79,
                "event": "af_view_cart",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            }
          ],
          "date": "2017-11-23"
        },
        {
          "inapps": [
            {
              "conversion_type": "postclick",
              "cpa": "153.79",
              "cr": 6.356968215158925,
              "count": 26,
              "event": "af_add_to_cart",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "23.8",
              "cr": 41.075794621026894,
              "count": 168,
              "event": "af_content_view",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "3.08",
              "cr": 317.6039119804401,
              "count": 1299,
              "event": "af_list_view",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "1999.27",
              "cr": 0.4889975550122249,
              "count": 2,
              "event": "af_purchase",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postview",
              "cpa": "7428.97",
              "cr": 0.10498687664041995,
              "count": 4,
              "event": "af_purchase",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "total",
              "cpa": "7428.97",
              "cr": 0.10498687664041995,
              "count": 10,
              "event": "af_purchase",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            },
            {
              "conversion_type": "postclick",
              "cpa": "137.88",
              "cr": 7.090464547677261,
              "count": 29,
              "event": "af_view_cart",
              "app": 461,
              "tracker": 1,
              "value": 10.1,
              "romi": 1.1,
              "adv_cost_share": 0.5
            }
          ],
          "date": "2017-11-24"
        }
      ],
      "id": 24120913
    }
  ]
}

Оффлайн конверсии

Ресурс возвращает статистику по аттрибуцированным с рекламными показами myTarget событиями из списков оффлайн конверсий по кампаниям в разрешении 1 день.

GET api/v2/statistics/offline_conversions/campaigns/day.json

Параметр Формат Описание
date_from YYYY-MM-DD Начальная дата 
date_to YYYY-MM-DD Конечная дата (включительно)
id список идентификаторов, разделенных запятой Список идентификаторов кампаний


Фильтры даты учитывают дату события, к которой атрибутирована конверсия

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

"rate" conversion rate = пользователи, которые сконвертировались и видели РК / все пользователи, видевшие РК
в процентах
"cost" фактическая стоимость привлечения = стоимость РК / пользователи, которые сконвертировались и видели рекламу 
"offline" Количество конверсий 

Быстрая статистика

GET {host}/api/v2/statistics/faststat/{banners|campaigns|users}.json

Ресурс возвращает базовую статистику по рекламным объектам в режиме реального времени, без учёта фильтрации некорректного траффика. Значения в итоговой статистике могут значительно отличаться. 

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

Параметр Формат Описание
id список идентификаторов, разделенных запятой Список идентификаторов баннеров или кампаний

Все параметры являются обязательными.

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

  • campaigns|banners|advertisers - массив статистики по запрашиваемому объекту
    • campaign_id|banner_id|user_id - массив статистики по конкретному объекту
      • timestamp - время последнего учтенного события по данному объекту
      • minutely|total - поминутный|суммарный массивы данных статистики по объекту. Для поминутного массива в подмассивах возвращаются значения за последние 60 минут. Последний элемент каждого массива со статистикой соответствует временному интервалу с указанным таймстэмпом.
        • clicks - количество кликов;
        • shows - количество показов;
  • last_seen_msg_time - время (в разных форматах) обработки последнего массива статистики. 

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

{
    last_seen_msg_time: {
        timestamp: 1550072300,
        string: "2019-02-13 18:38:20",
        ago: 5267        
    },
    banners: {},
    campaigns: {
        12121212: {
            timestamp: 1550071760,
            total: {
                clicks: [10311],
                shows: [72332],
                }                
            },
            minutely: {
                clicks: [140,
                92,
                176,
                275,
                237,
                151,
                192
                ],
                shows: [1253,
                ...,
                2331
                ],
                deltas: [...],
                                
            },
        21212121: {
            timestamp: 1550071333,
            total: {...},
            minutely: {...}
        }
    },
    advertisers: {}    
}

                            "