Как отправлять данные в 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 ID | ID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте. |
| Stream name | Название лаунчера. |
| Launcher project ID | ID проекта лаунчера из Личного кабинета. Пример: 147 ID проекта лаунчера https://publisher.xsolla.com/72209/projects/173640/new-launcher/147. |
| Login project ID | ID проекта Авторизации. |
| 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 ID | ID игры, к которой относится контент, из Личного кабинета. Если контент не связан с конкретной игрой, то поле будет пустым. |
| 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_start | Launcher начал проверку обновлений. |
| launcher_update_check_complete | Launcher закончил проверку обновлений. Дополнительное поле value принимает значение update_found, если на CDN найдена более новая версия, чем на устройстве пользователя и no_updates, если нет. |
| launcher_update_check_skip | Пользователь пропустил обновление лаунчера. |
| launcher_update_download_start | Лаунчер начал загрузку обновления. |
| launcher_update_download_complete | Лаунчер закончил загрузку обновления. |
| launcher_update_start | Launcher закончил обновление. |
| launcher_update_complete | Launcher успешно обновлен. |
События владения игрой
| Событие | Описание |
|---|---|
| purchase | Изменение статуса владения игрой. Дополнительные поля:
|
События контента
| Событие | Описание |
|---|---|
| content_view | Более 75% контента отображено на экране пользователя. Для контента с типом Группа событие не отправляется. Дополнительные поля:
|
| content_click | Пользователь нажал на элемент контента. |
События авторизации
| Событие | Описание |
|---|---|
| login | Пользователь авторизовался. Дополнительные поля:
|
Как настроить
- Зарегистрируйтесь в Google Analytics и войдите в ваш аккаунт.
- Настройте специальные параметры в Google Analytics как показано в таблице ниже.
| Поле | Показатель | Область действия | Описание |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | ID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте. |
| auth_type | Auth Type | Event | Тип аутентификации, который передается в поле type JWT. Возможные значения:
|
| content_id | Content ID | Event | ID плитки контента. |
| content_link | Content Link | Event | URL-адрес, если тип контента — ссылка или видео. |
| content_name | Content Name | Event | Название плитки контента на английском. |
| content_type | Content Type | Event | Тип контента. Возможные значения: news, link internal, link external, video. |
| distribution_platform | Distribution Platform | Event | Платформа, с которой был запущен лаунчер. Возможные значения: Xsolla, Steam. |
| game_name | Game Name | Event | Название игры на английском. |
| game_platform | Game Platform | Event | Платформа игры. Возможные значения: Xsolla, Steam. |
| build_number | Launcher Build Number | Event | Номер сборки. Пример: Если версия лаунчера 3.0.49-latest.1, то номер cборки — 1. |
| launcher_project_id | Launcher Project ID | Event | ID проекта лаунчера из Личного кабинета. Пример: 147 ID проекта лаунчера https://publisher.xsolla.com/72209/projects/173640/new-launcher/147. |
| app_version | Launcher Version | Event | Версия кода лаунчера. Пример: Если версия лаунчера 3.0.49-latest.1, то версия кода — 3.0.49-latest. |
| login_project_id | Login Project ID | Event | ID проекта Авторизации. |
| platform_game_id | Platform Game ID | Event | ID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте. |
| publisher_account_game_id | Publisher Account Game ID | Event | ID игры, к которой относится контент, из Личного кабинета. Если контент не связан с конкретной игрой, то поле будет пустым. |
| target_game_id | Target Game ID | Event | ID из Личного кабинета или Steam App ID игры, на которую ведет ссылка в контенте. |
| window_size | Window Size | Event | Размер окна лаунчера. Пример: 800x600. |
- Нажмите Admin в боковом меню.
- Создайте ресурс Google Analytics 4.
- Добавьте поток данных:
- Выберите тип Web.
- В поле URL укажите любой URL-адрес.
- Скопируйте значение поля Measurement ID в настройках созданного потока данных.
- В проекте в Личном кабинете перейдите в раздел Дистрибуция > Лаунчер.
- Найдите нужный лаунчер на дашборде и нажмите Редактировать.
- Перейдите в раздел Настройки > Общая информация > Аналитика.
- Вставьте Measurement ID, скопированный ранее, в поле Идентификатор потока данных.
- Нажмите Сохранить изменения.
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
