stat.getFromServer

Получение игровой статистики. Аналог данных, отображаемых на странице игровой статистики в ОК.

НазваниеОбязательныйТипОписание
id Да String

Тип статистики:

  • application_ltv_external - статистика по LTV;
  • application_notification_external - статистика по игровым оповещенииям;
  • application_retention_external - статистика по возврату пользователей;
  • application_arpu - статистика по ARPU;
  • ad_shown_android - статистика по реклама на платформе Android;
  • application_external2 - общая статистика по пользователям и платежам в игре;
  • sessions_by_user_daytime_full - статистика по продолжительности пользовательской сессии;
  • app_video_adv_external - статистика по видеорекламе на вебе и мобильном вебе;
  • application_ltv_basic_external - статистика по LTV для пользователей, установивших игру из “базовых” источников, не включающих фичеринг;
  • application_installs_external - статистика по “честным” установкам игры;
  • application_notification_exp2 - статистика по A/B-экспериментам в нотификациях (см. notifications.sendMass);
  • application_feature - статистика по позициям игры в топе для фичеринга на платформах.
periodType Да String

Период группировки данных:

  • DAY - группировка по дням.
from Да Date

Начало периода, за который получаются данные, в формате yyyy-mm-dd

to Нет Date

Конец периода, за который получаются данные, в формате yyyy-mm-dd

Авторизация

Сессия запрещена

Необходимые права

  • VALUABLE_ACCESS

Структура ответа полностью зависит от типа статистики, который был запрошен.

Ответ состоит из объектов двух типов:

  • fields - список полей статистики, возвращаемых в поле data. Список полей уникален для каждого типа статистики.
  • data - список статистических записей.

Статистика по LTV - application_ltv_external

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
Total1intВсего пользователей за 1 день
Total2intВсего пользователей за 2 дня
Total3intВсего пользователей за 2 дня
Total7intВсего пользователей за 7 дней
Total14intВсего пользователей за 14 дней
Total30intВсего пользователей за 30 дней
Returned2intВозвратившихся пользователей за 2 дня
Returned3intВозвратившихся пользователей за 3 дня
Returned7intВозвратившихся пользователей за 7 дней
Returned14intВозвратившихся пользователей за 14 дней
Returned30intВозвратившихся пользователей за 30 дней
Amount1intСумма платежей за 1 день
Amount3intСумма платежей за 2 дня
Amount7intСумма платежей за 7 дней
Amount14intСумма платежей за 14 дней
Amount30intСумма платежей за 30 дней
Payers1intКоличество плательщиков за 1 день
Payers3intКоличество плательщиков за 2 дня
Payers7intКоличество плательщиков за 7 дней
Payers14intКоличество плательщиков за 14 дней
Payers30intКоличество плательщиков за 30 дней
ts1intПроведенное в игре время за 1 день
ts3intПроведенное в игре время за 2 дня
ts7intПроведенное в игре время за 7 дней
ts14intПроведенное в игре время за 14 дней
ts30intПроведенное в игре время за 30 дней

Статистика по игровым оповещенииям - application_notification_external

Это статистика по всем типам игровых оповещений - notifications.sendSimple, notifications.sendMass, user-to-user оповещения, инвайты в игру.

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
NotificationUsersintКоличество получателей оповещений notifications.sendMass
InstallUsersintКоличество установок из оповещения notifications.sendMass
ClickUsersintКоличество кликов на оповещения notifications.sendMass
SimpleUsersintКоличество получателей оповещений notifications.sendSimple
SimpleInstallUsersintКоличество установок из оповещения notifications.sendSimple
SimpleClickUsersintКоличество кликов на оповещения notifications.sendSimple
InvitationUsersintКоличество получателей инвайтов в игру
InvitationInstallUsersintКоличество установок из инвайтов в игру
InvitationClickUsersintКоличество кликов на инвайты в игру
SuggestUsersintКоличество получателей user-to-user оповещений
SuggestInstallUsersintКоличество установок из user-to-user оповещений
SuggestClickUsersintКоличество кликов на user-to-user оповещения

Статистика по возврату пользователей - application_retention_external

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
Total1intВсего пользователей за первый день
Returned1intВернувшихся пользователей за первый день
Total7intВсего пользователей на седьмой день
Returned7intВернувшихся пользователей на седьмой день
Total30intВсего пользователей на 30-й день
Returned30intВернувшихся пользователей на 30-й день

Статистика по ARPU - application_arpu

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
users7intПользователей на 7 день
amount7intПлатежей на 7 день
payers7intПлательщиков на 7 день
users30intПользователей на 30 день
amount30intПлательщиков на 30 день
payers30intПлательщиков на 30 день
users90intПользователей на 90 день
amount90intПлательщиков на 90 день
payers90intПлательщиков на 90 день

Статистика по реклама на платформе Android - ad_shown_android

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
CallsintКоличество показов рекламы

Общая статистика по пользователям и платежам в игре - application_external2

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
UniqueUsersintУникальные пользователи
InstallUsersintНовые пользователи
AmountintКоличество платежей
PaymentsintСумма платежей

Статистика по продолжительности пользовательской сессии - sessions_by_user_daytime_full

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
averagedoubleСредняя длина сессии
mediandoubleМедианное значение длины сессии
95pdouble95-й персентиль длины сессии
usersintКоличество пользователей
sessionsintКоличество сессий
SPUdoubleКоличество сессий на пользователя

Статистика по видеорекламе на вебе и мобильном вебе - app_video_adv_external

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
PlatformenumПлатформа: mob - все мобильные платформы, web - desktop web
ValueintКоличество показов рекламы

Статистика по LTV для пользователей, установивших игру из “базовых” источников - application_ltv_basic_external

Базовые установки - это установки приложения за вычетом тех, на которые оказывает непосредственное влияние сама платформа. Т.е. к базовым установкам относятся установки из каталога, установки через приглашения, посты пользователей и т.д., и не относятся установки из фичеринга и других дополнительных способов продвижения платформой. Метрики базовых установок необходимы, что разработчики могли более точно понимть “чистые” метрики игры.

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
Total1intВсего пользователей за 1 день
Total2intВсего пользователей за 2 дня
Total3intВсего пользователей за 2 дня
Total7intВсего пользователей за 7 дней
Total14intВсего пользователей за 14 дней
Total30intВсего пользователей за 30 дней
Returned2intВозвратившихся пользователей за 2 дня
Returned3intВозвратившихся пользователей за 3 дня
Returned7intВозвратившихся пользователей за 7 дней
Returned14intВозвратившихся пользователей за 14 дней
Returned30intВозвратившихся пользователей за 30 дней
Amount1intСумма платежей за 1 день
Amount3intСумма платежей за 2 дня
Amount7intСумма платежей за 7 дней
Amount14intСумма платежей за 14 дней
Amount30intСумма платежей за 30 дней
Payers1intКоличество плательщиков за 1 день
Payers3intКоличество плательщиков за 2 дня
Payers7intКоличество плательщиков за 7 дней
Payers14intКоличество плательщиков за 14 дней
Payers30intКоличество плательщиков за 30 дней

Статистика по “честным” установкам игры - application_installs_external

Честной установкой и запуском игры считается тот запуск, после которого игра в течение 30 секунд после него вызвала любой метод OK API в рамках полученной при запуске сессии пользователя.

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
InstallUsersintНовые пользователи

Статистика по A/B-экспериментам в нотификациях - application_notification_exp2

Это статистика по ключевым метрикам при проведении A/B-экспериментов в оповещениях с помощью метода notifications.sendMass

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web
genderintПол пользователя: 0 - мужской, 1 - женский
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет
QualifierenumИдентификатор эксперимента (game1, game2 и т.д.)
GroupintНомер test_group, в которую попадает пользователь для эксперимента. 0 - базовая группа, 1 - экспериментальная группа
OperationenumДействие с оповещением: view - просмотр оповещения, click_LINK_APP - запуск игры из оповещения
CallsintКоличество действий (Operation) с оповещениями

Статистика по позициям игры в топе для фичеринга на платформах. - application_feature

Это статистика, которая показывает относительную позицию игры по сравнению с играми, которые попали в фичеринг на витринах игр в конкретную неделю.

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

  • мужчины до 24 лет;
  • женщины до 24 лет;
  • мужчины от 25 лет;
  • женщины от 25 лет.

За базовое значение (Ret14LTV14Ratio = 1) принимается игра, попавшая в фичеринг на 10 позиции среди всех игр по этой метрике.

В ответе метода же возвращается относительное число того, какую долю значения игры на 10 позиции имеет ваша игра по этой метрике.

Например, если ваша игра имеет значение в 2 раза меньше, чем игры из топ-10, то Ret14LTV14Ratio для вашей игры будет равен 0.5.

Если ваша игра имеет метрику >=1, то она попадает в фичеринг (но с условием того, что игра не была в фичеринге на прошлой неделе).

ПолеТипОписание
datedatetimeДата в формате yyyy-mm-dd HH-MM-SS
platformenumПлатформа: mob - все мобильные платформы, web - desktop web, All - все пользователи
genderintПол пользователя: 0 - мужской, 1 - женский, All - все пользователи
ageenumВозраст пользователя: <25 - до 25 лет, >=25 - от 25 лет, All - все пользователи
Ret14LTV14RatioenumЗначение метрики, Ret14*LTV14, используемое для формирования топа

Тип

{ "data": [ "Object" ], "fields": [ "String" ] }

Параметры приложения

Данные о сессии пользователя

Метод

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

Используем для подписи secret_key = session_secret_key
Используем для подписи secret_key = application_secret_key
Используем для подписи secret_key = MD5(access_token + application_secret_key)
secret_key =
Сортируем и склеиваем параметры запроса и secret_key
Рассчитываем MD5 от полученной строки и получаем параметр sig