ReportStartupStat.md

启动留存数据上报统计

一、概述

在小游戏环境下，玩家对启动时长与体验非常敏感（尤其从“广告”等买量场景进入的玩家）。开发者往往需要分析玩家从点击到进入游戏核心玩法的整个过程流失率。 Unity Loader的数据统计功能如下：

1. Unity Loader插件自动统计了代码包、首包资源、代码编译、引擎与首场景初始化，无需手动上报
2. 通过C# SDK接口让开发者上报自定义启动阶段，分析每个环节可能存在的流失

二、上报自定义阶段

为了详细统计玩家的流失情况以便开发者进行优化，我们拆分了三个部分。 其中自动上报为Unity Loader自动完成开发者无需关注，但自定义阶段与启动加载完成需开发者主动调用接口进行上报。详细接口可参考C# SDK中的WX.cs，此处列出关键接口：

1. 定义阶段

设置游戏当前阶段，通过此接口，插件能感知到游戏业务所处阶段。

    WX.SetGameStage(int stageType)

stageType取值范围：[200,10000]

2. 上报阶段耗时 上报当前自定义阶段耗时

      WX.ReportGameStageCostTime(int costTime, string extJsonStr)

3. 游戏完成所有加载时上报

当游戏完成所有加载阶段，进入核心玩法时(如进入新手引导或大厅)调用

      WX.ReportGameStart(int costTime, string extJsonStr)

4. 上报当前自定义阶段错误信息

      WX.ReportGameStageError(int errorType, string errStr, string extJsonStr)

errorType取值：[0,10000]

三、获取数据统计

数据报表包含Unity Loader自动上报与开发者自定义阶段。关注总体流失漏斗以确定需要优化的方向，同时分阶段的耗时分布有利于帮助我们分析该阶段的对应耗时的用户占比。

注： 目前该数据统计报表需要建联小游戏研发助手获取，未来会开放到《小游戏数据助手》。