开始使用 Analytics

要开始使用,您需要满足以下条件:

  • 注册 UGS。
  • 将后台项目关联到 Unity 编辑器项目。
  • 在游戏代码中初始化 UGS。
  • 查看计费信息。

注册

如果您还没有 Unity 帐户,请创建一个帐户创建一个新项目,以注册使用 Unity Gaming Services(Unity 游戏服务)。

重要:只有组织所有者才能注册使用 Analytics。

  1. 登录 Unity Services Dashboard
  2. 单击侧面板中的 Explore Services(探索服务)
  3. 单击顶部横幅中的 **Sign Up(注册)**并按照说明操作。

后续步骤安装 Analytics SDK 并将该服务与您的 Unity 项目关联

关联您的项目

需要在 Unity 编辑器中将您的本地项目版本与 Unity Project ID 关联。

  1. 转到 Edit(编辑)> Project Settings(项目设置)> Services(服务)
  2. 使用您现有的凭据登录。
  3. 从下拉列表中选择您的项目并单击 Link project ID(关联项目 ID)

注意Services(服务)> Analytics 设置页面与 Unity 旧版 Analytics 相关,而不是与新的 Gaming Services Analytics 相关。您无需在该页面上启用 Analytics 设置。

转到 Unity Dashboard(Unity 后台)中的 Analytics,开始分析您的数据。您还必须初始化 SDK

SDK 安装

在最新的 Unity 编辑器版本中,相应的包将显示在 Package Manager(包管理器)中。

Analytics 需要的最低编辑器版本为 2019.4。

要安装最新的 Unity Analytics 包,应使用最新的 Unity 编辑器版本并执行以下步骤:

  1. 在 Unity 编辑器中,打开 Window(窗口)> Package Manager(包管理器)
  2. 在 Package Manager(包管理器)中,选择 Unity Registry(Unity 注册表)列表视图。
  3. 搜索 Analytics,或在列表中找到 Analytics 包。
  4. 选择该包,然后单击 Install(安装)

请参阅 Package Manager(包管理器)文档,了解更多信息。

后续步骤:将服务关联到 Unity 项目并设置 SDK

注意:根据您使用的编辑器版本,您可能会看到最新版本的 UGS Analytics 显示在 Analytics Legacy(旧版 Analytics)下。

Analytics 计费

注意:要使用 Unity Analytics,您需要注册 Unity Gaming Services(Unity 游戏服务,简称 UGS)。

重要:从 2023 年 8 月 1 日起,Analytics 会更改定价模型。新客户和现有客户会按 MAU(每月活跃用户)数计费,而不是按事件和查询计费。这种设计是为了更好地估算成本。此变更将自动生效,您无需更改当前集成。

Analytics 是一种端到端数据和分析解决方案,可为整个工作室提供支持。Analytics 可供免费开始使用,并提供慷慨的免费套餐,超出此套餐后则按增量付费,您只需为额外的每月活跃用户数付费。随着游戏玩家数量的增加,这种计费方式有助于开发者更轻松地确定和预测成本。MAU 也是衡量用户参与度的公认行业标准,与其他模型相比,更容易理解。

当前基于事件和查询秒数的消费定价模型将停止,接下来将使用基于每月活跃用户 (MAU) 数的模型向客户收费。自 2023 年 8 月 1 日起,基于 MAU 的定价模型目前可供 Leaderboards 和 UGS Analytics 使用。使用量在每个月初重置。您无法切换到旧的定价模型。

基于 MAU 的定价

每月活跃用户数衡量每个环境在一个月内至少有一个会话的唯一用户 ID 的总数。该指标是通过 unityInstallationID 或传递给 Analytics 服务的任何自定义 userID 来衡量的,并与 Analytics 产品相关,不受 UGS 捆绑包中其他产品的影响。

当 MAU 数超过免费套餐或合理使用量限制时,您需要付费。

下表显示了不同的定价等级:

用户数每个 MAU 的成本
0 - 50,000$0.00(免费套餐)
50,001 - 150,000$0.00360
150,001 - 500,000$0.00315
500,001 - 1,000,000$0.00293
1,000,001 - 5,000,000$0.00225
5,000,001 及以上联系我们以了解更多定价选项

合理使用量限制

注意:从 2024 年 2 月 1 日开始,超出合理使用量限制的超额使用量将产生附加费。此附加费仅适用于超出每月免费套餐限制的使用量。

合理使用量限制是一个设定的使用量。如果您超出了合理使用量限制,并且您的使用量超出了每月免费套餐限制,则需要支付附加费。合理使用量限制主要是为了防止客户滥用 Unity 的服务,对每个 MAU 执行过多操作。Unity 预计只有极少数边缘情况会受到这些限制的影响。从后台的左侧菜单中选择 Cost and Usage Reporting(成本和使用情况报告)

成本报告

超过免费套餐限制后,您将受到合理使用量限制的约束,以确保合理性和可靠性。当您接近合理使用量限制时,您会收到通知。

限制如下:

  • 每个 MAU 的自定义事件数量为 500 个
  • 每个 MAU 的 SQL Data Explorer(SQL 数据资源管理器)查询时间为 0.05 秒

如果确实适用附加费并且超出了多个合理使用量限制,则会按照超出限制百分比最高的计量来收取附加费。超额使用量的附加费会反映在您的月度账单上。这些限制在每个日历月的月初重置。

合理使用量是一个平均值,随着 MAU 的累计数量增加,这个值可能会在一个月内波动;使用量和计费的真实来源将反映在每个月底的账单中。请注意,有效事件和无效事件都计入自定义事件限制。

如果您超出了合理使用量限制,但尚未提供付款详细信息,Unity 可能会与您联系,讨论减少使用量或接受特殊条款。

请遵循本文中提供的最佳做法。请注意,有效事件和无效事件都计入自定义事件限制。确保您的查询进行了效率优化,尤其是在处理大型数据集时。请参阅我们的说明书以获取指导信息。如有其他疑虑或问题,请联系我们的支持团队或联系您的 Unity 客户经理。

报告

您可以在 Unity Dashboard(Unity 后台)的多个位置监控您的限制情况,包括主后台上的 Service Usage(服务使用情况)选项卡和 Analytics 登陆页面

注意:报告后台中的数据有大约 14 小时的延迟。

有一个 MAU 使用量跟踪器和两个合理使用量跟踪器用于跟踪自定义事件数量和查询秒数。如果您超出了任何免费套餐,后台上会显示横幅来通知您。

成本报告

购买 Unity Analytics

Unity Analytics 是 Unity Gaming Services(Unity 游戏服务)的子产品,因此您必须购买整个 UGS 才能使用 Analytics。请参阅此处了解如何创建 Unity ID。

购买 UGS 后,可能需要等待长达一小时的时间才能使用和设置管线。但是,您可以立即访问 UI(例如后台)。如果取消 UGS,您将立即失去对 UI 的访问权限,并在 30 天后失去对 API 的访问权限。

如果您回归到 UGS,则您在取消后发送的所有 Analytics 事件都可能会得到处理,但在取消后将失去对摄取管线的访问权限。

历史数据(例如事件或玩家信息)将在取消 120 天后删除,并且无法恢复。

计费

新 Analytics MAU 定价模型的第一个计费周期将从 2023 年 8 月 1 日持续到 2023 年 8 月 31 日,客户有望在 9 月初收到新定价模型的第一笔账单。

新定价模型的第一笔账单基于组织中所有项目和环境的每月活跃用户 (MAU) 总数。如果您的 MAU 低于 50,000,您可以免费使用 Analytics 服务。如果您的 MAU 超过 50,000,则按超出的每个等级的不同费率向您收费。请参阅上面的定价表来估算您的成本,或提交请求与我们的支持团队讨论您的项目。

常见问题解答

如果我已经与 Unity 签订了合同,该怎么办?

新的定价模型适用于所有客户,无论是否存在任何现有合同或承诺。但是,如果您已签订协商合同,我们建议您与 Unity 客户经理联系,了解新的定价模型将如何影响您的计费。

我需要为旧版 Analytics 数据付费吗?

从旧版 Analytics 迁移到新版 UGS Analytics 的数据不计入 MAU 计费。

但是,从 UGS Analytics SDK 进入到 UGS Analytics 中的所有数据都需要付费。一旦客户将 UGS Analytics SDK 安装到他们的项目中并开始摄入数据,这些数据就会添加到 MAU 模型中并进行计费。

此外,如果使用 SQL Data Explorer(SQL 数据资源管理器)查询从旧版 Analytics 导入的数据,则会将其计入合理使用量限制。

我的其他 Unity 服务受影响吗?

每个 UGS 产品都有自己的计费单元,并且彼此独立。Analytics MAU 计量仅与 Analytics 服务相关,不会影响其他 UGS 服务的定价。超出免费套餐的 Analytics 使用量会显示为账单上的一个行项目。