Способы работы со статистикой в API myTarget: - Как на самом деле работает сбор статистики в myTarget; - Форматы статистики в API myTarget; - Быстрая статистика: faststat vs uniquestat - Статистика по конверсиям; - Статистика по демографии; - Правильные практики работы со статистикой; - Вопросы от аудитории и ответы на них.

1. Статистика в APIСтатистика в API
target.my.com
Александр Покатилов

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

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

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

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

6. APIAPI
/api/v1/statistics/{object}/{id}/{type}
/{from}-{to}.json

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

8. АгрегацияАгрегация
hour — по часам (последний месяц)
day — по дням (три месяца)
Формат дат исторически: DD.MM.YYYY

9. ЗапросЗапрос
/api/v1/statistics/campaigns/123;456
/day/01.01.2016-01.02.2016.json

10. [
{
"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
},
...
],
}
]

12. Статистика по кампаниямСтатистика по кампаниям
аккаунтааккаунта
/api/v1/campaigns/statistics.json?date_from=
{from}&date_to={to}

13. {
"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"
}

14. Статистика поСтатистика по
объявлениям кампанииобъявлениям кампании
/api/v1/campaigns/statistics
/{campaign_id}.json?date_from={from}&
date_to={to}

15. {
"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"
}

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

17. APIAPI
/api/v1/statistics/{type}/{object}/{id}.json
Доступна для campaigns, banners, users

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

19. faststat vs. uniquestatfaststat vs. uniquestat
uniquestat: клики, показы + уникальные пользователи
Отстаёт от faststat на несколько минут.

20. ЗапросЗапрос
/api/v1/statistics/uniquestat/campaigns
/123.json

21. {
"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": [],

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

23. APIAPI
/api/v1/statistics/{object}/{id}/conversions
/{from}-{to}.json
Для campaigns и banners

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

25. УсловияУсловия
Тип источника определяется по URL объявления.
Должен быть настроен счётчик/трекер/группа
/приложение.
Mytracker и партнёры: Appsflyer, MAT, Ad-X, Tapstream,
Adjust, Gameloft, Kochava, Yandex, Apsalar.

26. Установка приложенияУстановка приложения
{
"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"
},
...
]
},
...
]
},
...
]
}

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

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

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

30. ЗапросЗапрос
/api/v1/statistics/campaigns
/123/detailed_exact_demography.json?date_from=01.03
date_to=02.03.2016

31. {
"campaigns": [
{
"id": 5249186
"histogram": [
{
"age": 35,
"ctr": "0.0682",
"sex": "M",
"share_clicks": "0.03602",
"share_shows": "0.02581"
},
...
],
},
...
]
}

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

33. API кампаний иAPI кампаний и
объявленийобъявлений
/api/v1/campaigns/123.json
{
...
"stats_full": {},
"stats_today": {},
"stats_yesterday": {},
...
}

34. ТротлингТротлинг
2 RPS
1000 RPH

35. Определяем кампанииОпределяем кампании
/api/v1
/campaigns.json?fields=id,last_stats_updated

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

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

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

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