Launcher / Как отправлять данные в Google Analytics 4
  На главную

Launcher

Как отправлять данные в Google Analytics 4

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

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

ПоказательОписание
Distrubution platformПлатформа, с которой был запущен лаунчер.
Возможные значения: Xsolla, Steam.
LanguageЯзык лаунчера.
Page titleЭкран лаунчера. Возможные значения: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen.
Platform game IDID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте.
Stream nameНазвание лаунчера.
Launcher project IDID проекта лаунчера из Личного кабинета.
Пример: 147 ID проекта лаунчера https://publisher.xsolla.com/72209/projects/173640/new-launcher/147.
Login project IDID проекта Авторизации.
App versionВерсия лаунчера.
Build numberНомер сборки.
Пример: Если версия лаунчера 3.0.49-latest.1, то номер cборки — 1.
Window sizeРазмер окна лаунчера.
Пример: 800x600.
Screen resolutionРазрешение экрана.
Operating system, Operating system with version, OS version.User agent для определения операционной системы.
Publisher Account game IDID игры, к которой относится контент, из Личного кабинета. Если контент не связан с конкретной игрой, то поле будет пустым.
City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent IDГеографические данные пользователя.
Некоторые события могут содержать дополнительные поля, информация о них приведена в следующих таблицах. Ниже приведен список отправляемых событий, сгруппированных по типам.

Общие события

СобытиеОписание
launcher_startЗапуск лаунчера. Не отправляется при запуске лаунчера после обновления.
close_appЗакрытие лаунчера. Не отправляется при закрытии лаунчера перед обновлением.

События UI

СобытиеОписание
page_viewПользователь открыл экран лаунчера.
logoutПользователь нажал Выйти.

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

СобытиеОписание
launcher_update_check_startLauncher начал проверку обновлений.
launcher_update_check_completeLauncher закончил проверку обновлений. Дополнительное поле value принимает значение update_found, если на CDN найдена более новая версия, чем на устройстве пользователя и no_updates, если нет.
launcher_update_check_skipПользователь пропустил обновление лаунчера.
launcher_update_download_startЛаунчер начал загрузку обновления.
launcher_update_download_completeЛаунчер закончил загрузку обновления.
launcher_update_startLauncher закончил обновление.
launcher_update_completeLauncher успешно обновлен.

События владения игрой

СобытиеОписание
purchaseИзменение статуса владения игрой. Дополнительные поля:
  • currency — валюта покупки в формате ISO 4217.
  • value — номинальная сумма покупки.
  • transaction_id — номер платежа в системе Xsolla.
  • coupon — код купона.
  • items — параметры товара.

События контента

СобытиеОписание
content_viewБолее 75% контента отображено на экране пользователя. Для контента с типом Группа событие не отправляется. Дополнительные поля:
  • content_name — ID контента;
  • content_name — название контента;
  • content_type — тип контента;
  • banner_type — тип баннера;
  • target_game_id — ID проекта из Личного кабинета или Steam App. ID игры, на которую ведет ссылка в контенте;
  • content_link — URL-адрес, если тип контента — ссылка или видео.
content_clickПользователь нажал на элемент контента.

События авторизации

СобытиеОписание
loginПользователь авторизовался. Дополнительные поля:
  • auth_type — вариант аутентификации;
  • method — название социальной сети, использованной для аутентификации.

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

  1. Зарегистрируйтесь в Google Analytics и войдите в ваш аккаунт.
  2. Настройте собственные измерения в Google Analytics как показано в таблице ниже.
ПолеПоказательОбласть действияОписание
analytics_target_game_idAnalytics Target Game IDEventID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте.
auth_typeAuth TypeEventТип аутентификации, который передается в поле type JWT. Возможные значения:
  • social — аутентификация с помощью социальной сети.
  • phone — аутентификация без пароля с помощью одноразового пароля, отправленного на номер телефона.
  • email — аутентификация без пароля с помощью одноразового пароля, отправленного на электронную почту.
  • xsolla_login — аутентификация c помощью пароля и электронной почты с использованием хранилища данных пользователей Xsolla Login.
  • firebase — аутентификация c помощью пароля и электронной почты с использованием хранилища данных пользователей Firebase.
  • playfab — аутентификация c помощью пароля и электронной почты с использованием хранилища данных пользователей Playfab.
  • proxy — аутентификация c помощью пароля и электронной почты с использованием собственного хранилища данных.
  • device — аутентификация c помощью ID устройства.
  • server_custom_id — аутентификация с помощью custom ID (ID пользователя, сформированный на вашем сервере).
content_idContent IDEventID плитки контента.
content_linkContent LinkEventURL-адрес, если тип контента — ссылка или видео.
content_nameContent NameEventНазвание плитки контента на английском.
content_typeContent TypeEventТип контента. Возможные значения: news, link internal, link external, video.
distribution_platformDistribution PlatformEventПлатформа, с которой был запущен лаунчер.
Возможные значения: Xsolla, Steam.
game_nameGame NameEventНазвание игры на английском.
game_platformGame PlatformEventПлатформа игры. Возможные значения: Xsolla, Steam.
build_numberLauncher Build NumberEventНомер сборки.
Пример: Если версия лаунчера 3.0.49-latest.1, то номер cборки — 1.
launcher_project_idLauncher Project IDEventID проекта лаунчера из Личного кабинета.
Пример: 147 ID проекта лаунчера https://publisher.xsolla.com/72209/projects/173640/new-launcher/147.
app_versionLauncher VersionEventВерсия кода лаунчера.
Пример: Если версия лаунчера 3.0.49-latest.1, то версия кода — 3.0.49-latest.
login_project_idLogin Project IDEventID проекта Авторизации.
platform_game_idPlatform Game IDEventID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте.
publisher_account_game_idPublisher Account Game IDEventID игры, к которой относится контент, из Личного кабинета. Если контент не связан с конкретной игрой, то поле будет пустым.
target_game_idTarget Game IDEventID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте.
window_sizeWindow SizeEventРазмер окна лаунчера.
Пример: 800x600.
  1. Нажмите Admin в боковом меню.
  2. Создайте ресурс Google Analytics 4.
  3. Добавьте поток данных:
    1. Выберите тип Web.
    2. В поле URL укажите любой URL-адрес.
  4. Скопируйте значение поля Measurement ID в настройках созданного потока данных.
  5. Откройте проект в Личном кабинете.
  6. Нажмите Launcher в боковом меню.
  7. Найдите нужный лаунчер на дашборде и нажмите Редактировать.
  8. Перейдите в раздел Настройки > Общая информация > Аналитика.
  9. Вставьте Measurement ID, скопированный ранее, в поле Идентификатор потока данных.
  10. Нажмите Сохранить изменения.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

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

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

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