Analytics 入门

要开始使用,您需要:

  • 注册 UGS。
  • 将您的控制面板项目链接到 Unity 编辑器项目。
  • 在您的游戏代码中初始化 UGS。
  • 查看账单信息。

注册 UGS

如果您没有 Unity 帐户,请参阅Unity 组织UGS 入门以注册 Unity Gaming Services。

重要提示:只有组织所有者才能注册 Analytics。

  1. 登录Unity 云控制面板
  2. 选择顶部横幅中的注册,然后按照说明操作。

设置 Analytics

要从 Unity 云控制面板设置和管理 Analytics,请执行以下操作:

  1. 转到cloud.unity.com
  2. 在左侧面板的快捷方式下选择+
  3. 搜索Analytics 并选择将其固定到左侧。
  4. 选择以打开 Analytics。

首次启动 Analytics 时,这会将 Analytics 添加到侧边栏上的“快捷方式”部分,并打开“游戏性能”页面。

要在 Unity 编辑器中将本地项目构建链接到 Unity 云项目,请执行以下操作:

  1. 转到编辑 > 项目设置 > 服务
  2. 使用您的现有凭据登录。
  3. 从下拉列表中选择您的项目,然后选择链接项目 ID

Note: The Services > Analytics settings page relates to Unity Legacy Analytics, not the new Gaming Services Analytics. You don't need to enable the Analytics settings on that page.

SDK 安装

要为 Unity 安装最新的 Analytics 软件包,请使用最新版本的 Unity 编辑器并按照以下步骤操作:

  1. 在 Unity 编辑器中,打开窗口 > Package Manager
  2. 在 Package Manager 中,选择“Unity Registry”列表视图。
  3. 搜索 Analytics,或在列表中找到 Analytics 软件包。
  4. 选择软件包,然后选择安装

有关更多信息,请参阅Package Manager 文档

SDK 设置

即使已安装 SDK,也必须先手动启动它,然后才能开始收集数据。

首先,在游戏开始时调用 UnityServices.InitializeAsync() 函数,以初始化 Analytics SDK 以及您已安装的任何其他 UGS SDK。

作为游戏开发者,您有责任保护玩家的隐私。除非您通知 SDK 玩家已同意使用分析功能,否则不会收集数据。

Note: For more information about managing privacy and obtaining player consent, refer to the Privacy overview.

确认您已获得玩家同意后,请调用 AnalyticsService.Instance.StartDataCollection() 以启用数据收集。

您可以随时使用以下方法更改玩家的同意状态:

  • 如果玩家想要选择退出,请调用 StopDataCollection() 方法。
  • 如果玩家想要删除其数据,请调用 RequestDataDeletion() 方法。
  • 如果玩家想要选择加入(再次),请调用 StartDataCollection() 方法。

启用数据收集后,SDK 会在您的游戏运行时开始收集事件并定期上传。

SDK 会自动记录一些事件,以便您可以直接转到 Unity 云控制面板中的Analytics,开始分析您的数据。

现在 SDK 已启动并运行,请参阅我们的教程以构建和记录您自己的事件:

要了解 SDK 在幕后的作用,请参阅SDK 行为

重要提示:请注意,必须在每个会话开始时调用 StartDataCollection() 才能启用数据收集。SDK 不会记住玩家的同意状态。

账单信息

Analytics 可以免费开始使用,并为每月最多 50,000 名活跃用户 (MAU) 提供免费套餐。在此免费套餐之上,您必须升级整个 UGS 的套餐才能继续使用 Analytics。有关更多信息,请参阅我们的账单页面