如何向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。如平台是艾克索拉，则传入发布商帐户项目ID。 |
| Stream name | 启动器名称。 |
| Launcher project ID | 发布商帐户中的启动器项目ID。 示例： 147是https://publisher.xsolla.com/72209/projects/173640/new-launcher/147的项目ID |
| Login project ID | 登录管理器项目ID。 |
| App version | 启动器版本。 |
| Build number | 编译版本号。 示例：如启动器版本是 3.0.49-latest.1，则编译版本号是1。 |
| Window size | 启动器窗口大小。 示例： 800x600。 |
| Screen resolution | 屏幕分辨率。 |
| Operating system, Operating system with version, OS version. | 用于检测用户操作系统的用户代理。 |
| 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_update_check_complete | 启动器结束检查更新。如CDN上有更新的版本，则补充value字段的值为update_found。否则值为no_updates。 |
| launcher_update_check_skip | 用户跳过了启动器更新。 |
| launcher_update_download_start | 启动器开始下载更新。 |
| launcher_update_download_complete | 启动器结束下载更新。 |
| launcher_update_start | 启动器结束更新。 |
| launcher_update_complete | 启动器成功更新。 |
游戏所有权事件
| 事件 | 描述 |
|---|---|
| purchase | 购买状态发生更改。补充字段： |
内容事件
| 事件 | 描述 |
|---|---|
| content_view | 显示超过75%的内容。对于具有组状态的内容不发送此事件。补充字段：
|
| content_click | 用户点击了一个内容元素。 |
用户认证事件
| 事件 | 描述 |
|---|---|
| login | 用户在启动器中成功认证。补充字段：
|
如何获取
- 注册Google Analytics（分析）并登录您的帐户。
- 按下表所示在Google Analytics（分析）中创建及编辑自定义维度。
| 字段 | 维度 | Scope | 描述 |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | 链接跳转到的游戏在发布商帐户中的ID或其Steam应用ID。 |
| auth_type | Auth Type | Event | 在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，则编译版本号是1。 |
| launcher_project_id | Launcher Project ID | Event | 发布商帐户中的启动器项目ID。 示例： 147是https://publisher.xsolla.com/72209/projects/173640/new-launcher/147的项目ID |
| 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。如平台是艾克索拉，则传入发布商帐户项目ID。 |
| publisher_account_game_id | Publisher Account Game ID | Event | 内容所关联的游戏在发布商帐户中的ID。如内容与游戏不相关，此字段为空。 |
| target_game_id | Target Game ID | Event | 链接跳转到的游戏在发布商帐户中的ID或其Steam应用ID。 |
| window_size | Window Size | Event | 启动器窗口大小。 示例： 800x600。 |
- 在侧边栏中单击管理。
- 创建Google Analytics（分析）4媒体资源。
- 添加数据流：
- 选择Web类型。
- 在URL字段中输入任意URL地址。
- 复制数据流设置衡量ID字段中的值。
- 在发布商帐户中打开您的项目，然后前往分发 > 启动器部分。
- 在仪表板上找到启动器，然后单击编辑启动器。
- 前往设置 > 一般信息 > 分析。
- 在Google Analytics（分析）4衡量ID字段中粘贴衡量ID。
- 单击保存更改。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
