Лаунчер / Как получать аналитику на endpoint URL

Как получать аналитику на endpoint URL

Как это работает

Вы можете получать данные об активности пользователей, ошибках и сбоях в работе лаунчера на ваш endpoint URL с помощью событий и анализировать их любыми инструментами аналитики. Ниже приведен список отправляемых событий, сгруппированных по типам.

События открытия или активации экранов и окон лаунчера

СобытиеОписание
Game install windowОткрытие или активация окна Установка игры.
Launcher update windowОткрытие или активация экрана Аутентификация.
Login screenОткрытие или активация экрана Аутентификация.
MailRu login screenОткрытие или активация экрана Аутентификация Mail.ru.
Steam login screenОткрытие или активация экрана Аутентификация Steam.
Stone login screenОткрытие или активация экрана Аутентификация Stone.
Game screenОткрытие или активация экрана игры.
Maintenance windowОткрытие или активация окна Техническое обслуживание.
Home screenОткрытие или активация домашнего экрана.
News screenОткрытие или активация экрана Новости.
One news screenОткрытие или активация экрана выбранной новости.
Store screenОткрытие или активация экрана Магазин.
Store windowОткрытие или активация окна Магазин.
Redeem windowОткрытие или активация окна Активация ключа.
Settings windowОткрытие или активация окна Настройки.

События взаимодействия пользователя с элементами интерфейса лаунчера

СобытиеОписание
StartPage Event: Push InstallНажатие на кнопку Установить.
StartPage Event: Push startНажатие на кнопку Играть.
StartPage Event: Open GameОткрытие экрана игры.
StartPage Event: Push Redeem keyАктивация ключа.
StartPage Event: Open newsПереход к Новостям.
StartPage Event: Open buyПереход к покупке.

События взаимодействия пользователя с элементами интерфейса лаунчера

СобытиеОписание
UI Event: Push InstallНажатие на кнопку Установить.
UI Event: Push PlayНажатие на кнопку Играть.
UI Event: Push UpdateНажатие на кнопку Обновление.
UI Event: Push MaintenanceОткрытие или активация окна Техническое обслуживание.
UI Event: Push AdsBannerНажатие на рекламный баннер.
UI Event: Push SettingНажатие на кнопку Настройки.
UI Event: Push LogoutНажатие на кнопку Выйти.
UI Event: Push UninstallНажатие на кнопку Установить.
UI Event: Push RepairНажатие на кнопку Восстановить.
UI Event: Push SupportНажатие на кнопку Поддержка.
UI Event: Push CommunityНажатие на кнопку Сообщество.
UI Event: Push Create AccountНажатие на кнопку Создать аккаунт.
UI Event: Push Forgot PasswordНажатие на кнопку Забыл пароль.
UI Event: Push Sign In With SocialНажатие на кнопку Войти через социальные сети.
UI Event: Push Sign InНажатие на кнопку Войти.
UI Event: Auto Sign InАвтоматическая аутентификация.
UI Event: Game install window: Changed the installation pathИзменение пути установки.
UI Event: Game install window: Changed the installation driveИзменение диска установки.
UI Event: Game install window: Not enough disk space for game installОшибка при нехватке свободного места на диске для установки.

События аутентификации пользователя

СобытиеОписание
Launcher Login Event: Login finishУспешная аутентификация.
Launcher Login Event: Login failedОшибка при аутентификации.
Launcher Login Event: Login social finishУспешная аутентификация через социальные сети.
Launcher Login Event: Login social failedОшибка при аутентификации через социальные сети.
Launcher Login Event: Login captcha openОткрытие CAPTCHA.
Launcher Login Event: Login privacy policy openОткрытие политики конфиденциальности.

События установки, удаления, запуска игры и распространяемых пакетов

СобытиеОписание
Game Installation Event: Game installation startНачало установки игры.
Game Installation Event: Game installation stoppedПауза при установке игры.
Game Installation Event: Game installation finishedОкончание установки игры.
Game Installation Error: Game installation failedОшибка при установке игры.
Game Installation Event: Game updating startНачало обновления игры.
Game Installation Event: Game updating stoppedОстановка обновления игры.
Game Installation Event: Game updating finishedОкончание установки игры.
Game Installation Error: Game updating failedОшибка при установке игры.
Game Installation Event: Game repairing startНачало восстановления игры.
Game Installation Error: Game repairing failedОшибка при восстановления игры.
Game Installation Event: Game repairing stoppedОстановка восстановления игры.
Game Installation Event: Game repairing finishedОкончание восстановления игры.
Game Uninstallation Event: Game uninstall startНачало удаления игры.
Game Uninstallation Event: Game uninstall finishedОкончание удаления игры.
Game Event: Game startНачало игры.
Game Event: Game stoppedОстановка игры.
Game Error: Game crashedСбой в игре.
Redist Event: Redist install startНачало установки распространяемых пакетов.
Redist Event: Redist install finishОкончание установки распространяемых пакетов.
Redist Error: Redist install failedОшибка при установке распространяемых пакетов.

События ошибок при скачивании, распаковке, патчинге игры или обновлении лаунчера

СобытиеОписание
Error: Extractor: Can't open fileОшибка при открытии файлов во время распаковки игры.
Error: Extractor: Archive isn't supportedОшибка при открытии архива во время распаковки игры.
Error: Extractor: Extraction exceptionОшибка при распаковке игры.
Error: CreateFileAction: Can't save file is already existОшибка при попытке создания уже существующего файла.
Error: CreateFileAction: Can't save filetОшибка при сохранении файла.
Error: DownloadAction: Network error, codeСетевая ошибка при скачивании игры.
Error: TorrentDownloadAction: Network error, codeСетевая ошибка при скачивании игры через торрент.
Error: DownloadAction: Can't start download. Destination dir is undefinedОшибка при старте скачивания игры: не задана директория.
Error: ExtractAction: Unpacking errorОшибка при распаковке обновлений лаунчера.
Error: CopyFileAction: Can't copy fileОшибка при копировании файла.
Error: MoveFileAction: Can't move fileОшибка при перемещении файла.
Error: DeleteFileAction: Can't delete fileОшибка при удалении файла.
Error: CreateDirAction: Can't create directoryОшибка при создании директории.
Error: PatchAction: Can't patch filesОшибка при патчинге файлов.
Error: InstallAction: Failed to startОшибка при попытке установить игру.
Error: CopyDirAction: Can't copy dirОшибка при копировании директории.
Error: MoveDirAction: Can't move directoryОшибка при перемещении директории.
Error: RestartLauncherAction: Can't restart launcherОшибка при попытке перезапуска лаунчера.
Error: DeleteDirAction: Can't delete dirОшибка при удалении директории.
Error: VerifyAction: Verify file finished with errorВерификация файла не пройдена.
Error: VerifyAction: Can't find patch rulesНе найдены правила для верификации файла.
Error: VerifyAction: Can't verify filesОшибка при запуске верификации.
Error: LauncherUpdater: Can't open fileОшибка при открытии файлов во время обновления лаунчера.
Error: LauncherUpdater: Can't extract archiveОшибка при распаковке архива во время обновления лаунчера.
Error: Steam: Overlay disabledОшибка при открытии оверлея Steam.

События Магазина

СобытиеОписание
Store event: Redeem key successfulКлюч успешно активирован.
Store event: Redeem key failedНеудачная попытка активации ключа.
Store event: Buy the virtual itemПокупка виртуального предмета.
Store event: Buy the gameПокупка игры.

Для кого подходит

Для партнеров, у которых уже подключен продукт Лаунчер.

Как настроить

Добавьте в файл Config.json объект c custom_analytics и укажите следующие параметры:

  • Url — URL, на который вы хотите получать события;
  • sendIntervalMsec — интервал между отправками событий;
  • custom_fields — массив собственных полей и их значений, отправляемых вместе с событием (опционально).

Пример объекта custom_analytics:

Copy
Full screen
Small screen
"custom_analytics": {
  "Url": "endpoint_URL",
  "sendIntervalMsec": 2000,
  "custom_fields": [
    "custom_field1_name": "custom_field1_value",
    "custom_field2_name": "custom_field2_value",
  ]
}

Пример события:

Copy
Full screen
Small screen
{
  "EntityType": "title",
  "EventId": "launcher1597240611",
  "EventName": "UI Event: Push Sign In",
  "Timestamp": "2020-08-12T15:56:51Z",
  "EventAttributes": "{\"SessionID\": \"138171e4426385405becd842f7265d7a746280ce1597240501\", \"UserId\": \"\"}",
  "ReceivedTimestamp": 1597240613.3814895
}

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 25 июня 2021

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!