Статистика в APIСтатистика в APItarget.my.com

Александр Покатилов

СтатистикаСтатистикаОценка эффективности кампаний и баннеровУправление ставками и изменениями таргетинговГенерация отчётов и закрывающих документов

Как собираетсяКак собираетсястатистика?статистика?

Каждое действие (клик, показ) фиксируется в логахДалее логи агрегируются и обрабатывются антифродомПолученные данные попадают в чарджинг, которыйпишет статистику и транзакции в биллинг

Как следствиеКак следствиеСтатистика отстаёт на ~15 минут.

APIAPI/api/v1/statistics/{object}/{id}/{type}

/{from}-{to}.json

Типы объектовТипы объектовbanners — по отдельным объявлениямcampaigns — по кампаниямusers — по аккаунтамpad_groups — по партнёрским площадкамpads — по блокам партнёрских площадок

АгрегацияАгрегацияhour — по часам (последний месяц)day — по дням (три месяца)

Формат дат исторически: DD.MM.YYYY

ЗапросЗапрос/api/v1/statistics/campaigns/123;456

/day/01.01.2016-01.02.2016.json

[ { "id": 123, "name": "Test campaign 1"

"total": { "amount": "64578.3", "clicks": 12685, "ctr": "1.29", "shows": 983341

}, "detailed_stat": [ { "date": "01.01.2016", "amount": "8055.13", "clicks": 1055, "ctr": "0.2565", "shows": 411308

}, ... ], }]

Статистика по кампаниямСтатистика по кампаниямаккаунтааккаунта

/api/v1/campaigns/statistics.json?date_from={from}&date_to={to}

{ "campaigns": [ { "campaign_id": 5249186, "campaign_name": "Test campaign", "date": "2016-03-01", "general": { "amount": "11024.8", "clicks": 1999, "ctr": "0.0489", "shows": 4091243, "uniques": 38532540, "uniques_increment": 154380

}},

... ], "common": { "general": { "amount": "30775.17", "clicks": 6499, "ctr": "0.0551", "shows": 11789521, "uniques": 0, "uniques_increment": 0

}},

"date_from": "2016-03-01", "date_to": "2016-03-01"}

Статистика поСтатистика пообъявлениям кампанииобъявлениям кампании

/api/v1/campaigns/statistics/{campaign_id}.json?date_from={from}&

date_to={to}

{ "banners": [ { "banner_id": 20367520, "banner_title": "Test banner", "date": "2016-03-01", "general": { "amount": "86.6", "clicks": 29, "ctr": "0.0733", "shows": 39574, "uniques": 85772, "uniques_increment": 3195

}},

... ], "common": { "general": { "amount": "1162.4", "clicks": 387, "ctr": "0.0726", "shows": 532989, "uniques": 0, "uniques_increment": 0

}},

"date_from": "2016-03-01", "date_to": "2016-03-01"}

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

APIAPI/api/v1/statistics/{type}/{object}/{id}.json

Доступна для campaigns, banners, users

Быстрая, потому что расчитывается до антифрода,отставание меньше минуты. Отличается от основной

статистики в большую сторону (фрод, перекруты).

faststat vs. uniquestatfaststat vs. uniquestatuniquestat: клики, показы + уникальные пользователи

Отстаёт от faststat на несколько минут.

ЗапросЗапрос/api/v1/statistics/uniquestat/campaigns

/123.json

{"campaigns": {"123": {"timestamp": 1457045513,"total": {"clicks": [68],"customs": {"1000": {"events": [1234],"uniques": [876],"deltas": [456]

} },

"shows": [6800],"uniques": [5780]

},"daily": {"clicks": [0, 0, 0, 0, 0, 64, 4],"customs": {},"deltas": [0, 0, 0, 0, 0, 5561, 219],"shows": [0, 0, 0, 0, 0, 6371, 429],"uniques": [0, 0, 0, 0, 0, 5561, 422]

},"hourly": {

... },

"minutely": { ... },

"seven_days_stat": {"customs": {},"daily": [],"total": 5780

Статистика поСтатистика поконверсиямконверсиям

APIAPI/api/v1/statistics/{object}/{id}/conversions

/{from}-{to}.json

Для campaigns и banners

Источники данныхИсточники данныхmobile_app — установка мобильных приложенийok_group_join — вступление в группы ОКok_game_join — установка приложения OKtopmailru — цели счётчиков top.mail.ru

УсловияУсловияТип источника определяется по URL объявления.

Должен быть настроен счётчик/трекер/группа/приложение.

Mytracker и партнёры: Appsflyer, MAT, Ad-X, Tapstream,Adjust, Gameloft, Kochava, Yandex, Apsalar.

Установка приложенияУстановка приложения{ "conversions": [ { "object_id": 123, "conversions": [ { "date": "03.03.2016", "sources": [ { "goals": [ { "achievement_count": 26, "counter_id": null, "counter_name": null, "description": "Установка приложения", "name": "mobile_app"

} ], "source": "mobile_install"

}, ... ]

}, ... ]

}, ... ]}

Цели top.mail.ruЦели top.mail.ru{ "achievement_count": 2, "counter_id": 123, "counter_name": "w3c.org", "description": "Вход в систему", "name": "login-as-member"}

ДемографияДемографияРаспределение кликов и показов по полу и возрасту

APIAPI/api/v1/statistics/campaigns/{ids}/detailed_exact_demography.json

/api/v1/statistics/campaigns/exact_demography.json

ЗапросЗапрос/api/v1/statistics/campaigns

/123/detailed_exact_demography.json?date_from=01.03.2016&date_to=02.03.2016

{ "campaigns": [ { "id": 5249186

"histogram": [ { "age": 35, "ctr": "0.0682", "sex": "M", "share_clicks": "0.03602", "share_shows": "0.02581"

}, ... ], }, ... ]}

СинхронизацияСинхронизациястатистикистатистики

API кампаний иAPI кампаний иобъявленийобъявлений

/api/v1/campaigns/123.json{ ..."stats_full": {},"stats_today": {},"stats_yesterday": {},

...}

ТротлингТротлинг2 RPS

1000 RPH

Определяем кампанииОпределяем кампании/api/v1

/campaigns.json?fields=id,last_stats_updated

Запрашиваем статистикуЗапрашиваем статистику/api/v1/statistics/campaigns/123;456/day/{your_last_sync}-{now}.json

ОбъявленияОбъявления/api/v1/banners.json?fields=id&

last_stats_updated__gte={your_last_sync}

Запрашиваем статистикуЗапрашиваем статистику/api/v1/statistics/banners/123;456/day/{your_last_sync}-{now}.json

Спасибо за вниманиеСпасибо за внимание