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.Rate this page
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.