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.
- Click Launcher in the side menu.
- 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.