Unity 游戏埋点：从安装 SDK 到验证第一局数据

Unity 游戏数据分析实战教程：同意管理、应用会话、单局生命周期、进度事件、版本上下文、离线上报与验证。

Unity SDK 初始化成功不代表接入正确。只有脚本化单局在在线与离线测试后都产生带正确版本上下文的会话、单局、进度和结束事件，接入才算通过。

核心要点

写代码前先定义应用会话开始/结束、单局开始/结束，以及三到五个进度里程碑。为每个事件写清触发条件、必填字段和示例值。版本 ID、发布渠道和 SDK 协议版本应来自中心配置，而不是散落在各场景。

使用持久服务或 SDK 单例管理应用会话，场景重载不能创建重复会话。只在玩法进入权威状态时开始单局，并用 completed、failed、quit、disconnected 等受控结果结束一次。

任务完成应在状态机确认后记录，购买应在权威余额变化后记录，匹配成功应在玩家真正进入比赛后记录。按钮点击可以作为 UX 事件，但不能代替游戏结果。

测试正常单局、退出到菜单、强制终止进程、断网后恢复，以及第二个版本/渠道。核对客户端诊断、接收事件和看板数量，并确认分析失败永远不会阻塞主线程或改变玩法。

看板显示绿色还不够：必须用已知试玩流程逐个核对事件 ID 与预期数量。

Unity 分析管理器应该放在哪里？+

使用跨场景存活的应用级持久服务。玩法系统只调用小型强类型接口，不应自行管理网络或队列状态。

Unity 埋点应该每帧发送吗？+

不应该。应采集有意义的状态转换和有界摘要；高频战斗或移动数据应先在本地聚合再上报。

竞品能力与价格可能变化。本文依据以下官方页面撰写，并以页面所示日期为最后核验时间。

由 G-Less 产品与工程团队撰写并审核。指南建立在真实 Steam Demo 与 PC 游戏版本所使用的事件模型上；涉及产品能力的表述会在发布前对照当前遥测协议进行核验。