如何向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购买状态发生更改。补充字段：
  • currency — 符合ISO 4217标准的三字母国家/地区代码。
  • value — 票面购买金额。
  • transaction_id — 艾克索拉系统中的支付ID。
  • coupon — 优惠券代码。
  • items — 商品参数。

内容事件

事件描述
content_view显示超过75%的内容。对于具有组状态的内容不发送此事件。补充字段：
  • content_name — 内容ID。
  • content_name — 内容名称。
  • content_type — 内容类型。
  • banner_type — 横幅类型。
  • target_game_id — 链接跳转到的游戏在发布商帐户中的ID或其Steam应用ID。
  • content_link — URL地址（如内容类型是链接或视频）。
content_click用户点击了一个内容元素。

用户认证事件

事件描述
login用户在启动器中成功认证。补充字段：
  • auth_type — 身份认证方式。
  • method — 用于身份认证的社交网络。

如何获取

  1. 注册Google Analytics（分析）并登录您的帐户。
  2. 按下表所示在Google Analytics（分析）中创建及编辑自定义维度。
字段维度Scope描述
analytics_target_game_idAnalytics Target Game IDEvent链接跳转到的游戏在发布商帐户中的ID或其Steam应用ID。
auth_typeAuth TypeEvent在JWT中传递的认证方式。可能值：
  • social — 社交网络登录。
  • phone — 通过发送到手机的一次性验证码进行免密登录。
  • email — 通过发送到邮箱的一次性验证码进行免密登录。
  • xsolla_login — 通过用户名/邮箱和密码进行经典登录（使用艾克索拉登录数据存储）。
  • firebase — 通过用户名/邮箱和密码进行经典登录（使用Firebase数据存储）。
  • playfab — 通过用户名/邮箱和密码进行经典登录（使用Playfab数据存储）。
  • proxy — 通过用户名/邮箱和密码进行经典登录（使用自定义数据存储）。
  • device — 使用设备ID登录。
  • server_custom_id — 使用自定义ID登录（用户ID在您的服务器上生成）。
content_idContent IDEvent内容卡片ID。
content_linkContent LinkEventURL地址（如内容类型是链接或视频）。
content_nameContent NameEvent内容卡片名称（英文）。
content_typeContent TypeEvent内容类型。可能值：news、link internal、link external、video。
distribution_platformDistribution PlatformEvent用于打开启动器的平台。
可能值：Xsolla、Steam。
game_nameGame NameEvent游戏名称（英文）。
game_platformGame PlatformEvent游戏平台。可能值：Xsolla、Steam。
build_numberLauncher Build NumberEvent编译版本号。
示例：如启动器版本是3.0.49-latest.1，则编译版本号是1。
launcher_project_idLauncher Project IDEvent发布商帐户中的启动器项目ID。
示例：147是https://publisher.xsolla.com/72209/projects/173640/new-launcher/147的项目ID
app_versionLauncher VersionEvent启动器代码版本。
示例：如启动器的版本是3.0.49-latest.1，则启动器代码版本是3.0.49-latest。
login_project_idLogin Project IDEvent登录管理器项目ID。
platform_game_idPlatform Game IDEvent平台上的游戏ID。如平台是艾克索拉，则传入发布商帐户项目ID。
publisher_account_game_idPublisher Account Game IDEvent内容所关联的游戏在发布商帐户中的ID。如内容与游戏不相关，此字段为空。
target_game_idTarget Game IDEvent链接跳转到的游戏在发布商帐户中的ID或其Steam应用ID。
window_sizeWindow SizeEvent启动器窗口大小。
示例：800x600。
  1. 在侧边栏中单击管理。
  2. 创建Google Analytics（分析）4媒体资源。
  3. 添加数据流：
    1. 选择Web类型。
    2. 在URL字段中输入任意URL地址。
  4. 复制数据流设置衡量ID字段中的值。
  5. 在发布商帐户中打开您的项目。
  6. 在侧边栏中单击启动器。
  7. 在仪表板上找到启动器，然后单击编辑启动器。
  8. 前往设置 > 一般信息 > 分析。
  9. 在Google Analytics（分析）4衡量ID字段中粘贴衡量ID。
  10. 单击保存更改。
本文对您的有帮助吗？
谢谢！
我们还有其他可改进之处吗？ 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2024年1月22日

发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈！