How to send data to Google Analytics 4
How it works
When you receive data about users’ activity and the launcher’s behavior from Google Analytics 4 as events, the data is sent in the payload as listed in the table below.
| Dimension | Description |
|---|---|
| Distrubution platform | The platform that was used to open the launcher. Possible values: Xsolla, Steam. |
| Language | Launcher language. |
| Page title | Launcher screen. Possible values: Starting screen, Login screen, Game screen, Game store screen, Game news screen, Opened content screen, Settings screen, Custom tab screen. |
| Platform game ID | Game ID on the platform. If the platform is Xsolla, then a Publisher Account project ID is passed. |
| Stream name | Launcher name. |
| Launcher project ID | Launcher project ID from Publisher Account. Example: 147 is a project ID for https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| Login project ID | Login project ID. |
| App version | Launcher version. |
| Build number | Build number. Example: If the launcher version is 3.0.49-latest.1 then the build number is 1. |
| Window size | Launcher window size. Example: 800x600. |
| Screen resolution | Screen resolution. |
| Operating system, Operating system with version, OS version. | User agent for detection of user’s operating system. |
| Publisher Account game ID | ID from Publisher Account of the game to which the content is related. The field will be empty if the content is not game-related. |
| City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent ID | Geographical data. |
General events
| Event | Description |
|---|---|
| launcher_start | Launcher starts. This is not sent when the launcher is started after an update. |
| close_app | Launcher closing. This is not sent when the launcher is closed before an update. |
UI events
| Event | Description |
|---|---|
| page_view | A user opened a launcher screen. |
| logout | A user clicked Log out. |
Launcher update events
| Event | Description |
|---|---|
| launcher_update_check_start | Launcher starts to check for updates. |
| launcher_update_check_complete | Launcher finished checking for updates. The additional value field has the update_found value if there is a newer version found on CDN. Otherwise, the value is no_updates. |
| launcher_update_check_skip | A user skipped the launcher update. |
| launcher_update_download_start | Launcher started downloading the update. |
| launcher_update_download_complete | Launcher finished downloading the update. |
| launcher_update_start | Launcher finished the update. |
| launcher_update_complete | Launcher is updated successfully. |
Game ownership events
| Event | Description |
|---|---|
| purchase | A change of a purchase status. Additional fields:
|
Content events
| Event | Description |
|---|---|
| content_view | More than 75% of a content was displayed. For the content that has the group status the event is not sent. Additional fields:
|
| content_click | A user clicked a content element. |
Authorization events
| Event | Description |
|---|---|
| login | A user was successfully authenticated in the launcher. Additional fields:
|
How to get it
- Sign up for Google Analytics and log in to your account.
- Create and edit custom dimensions in Google Analytics as shown in the table below.
| Field | Dimension | Scope | Description |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | An ID from Publisher Account or a Steam App ID of the game, the link leads to. |
| auth_type | Auth Type | Event | Authentication option passed in JWT. Possible values:
|
| content_id | Content ID | Event | Content tile ID. |
| content_link | Content Link | Event | URL address if the content type is link or video. |
| content_name | Content Name | Event | Content tile name in English. |
| content_type | Content Type | Event | Content type. Possible values: news, link internal, link external, video. |
| distribution_platform | Distribution Platform | Event | The platform that was used to open the launcher. Possible values: Xsolla, Steam. |
| game_name | Game Name | Event | Game name in English. |
| game_platform | Game Platform | Event | Game platform. Possible values: Xsolla, Steam. |
| build_number | Launcher Build Number | Event | Build number. Example: If the launcher version is 3.0.49-latest.1 then the build number is 1. |
| launcher_project_id | Launcher Project ID | Event | Launcher project ID from Publisher Account. Example: 147 is a project ID for https://publisher.xsolla.com/72209/projects/173640/new-launcher/147 |
| app_version | Launcher Version | Event | Launcher code version. Example: If the launcher version is 3.0.49-latest.1 then the launcher code version is 3.0.49-latest. |
| login_project_id | Login Project ID | Event | Login project ID. |
| platform_game_id | Platform Game ID | Event | Game ID on the platform. If the platform is Xsolla, then a Publisher Account project ID is passed. |
| publisher_account_game_id | Publisher Account Game ID | Event | ID from Publisher Account of the game to which the content is related. The field will be empty if the content is not game-related. |
| target_game_id | Target Game ID | Event | An ID from Publisher Account or a Steam App ID of the game, the link leads to. |
| window_size | Window Size | Event | Launcher window size. Example: 800x600. |
- Click Admin in the side menu.
- Create a Google Analytics 4 property.
- Add a data stream:
- Select the Web type.
- In the URL field enter any URL address.
- Copy the value of the Measurement ID field in the settings of the data stream.
- Open your project in Publisher Account and go to the Distribution > Launcher section.
- Find the launcher on the dashboard and click Edit launcher.
- Go to Settings > General information > Analytics.
- Paste the Measurement ID in the Google Analytics 4 Measurement ID field.
- Click Save changes.
Was this article helpful?
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.Found a typo or other text error? Select the text and press Ctrl+Enter.
