数据分析(Cocos)

Cocos 封装暴露了一个紧凑的数据分析接口:关卡开始/结束事件。每款游戏都应该上报这些事件,它们驱动 FRVR 侧的漏斗看板。

关卡漏斗

// 关卡开始时
FRVRSDK.instance.levelStart('level_1');

// ...玩家在玩...

// 关卡结束时 —— 传入与开始时相同的 id
FRVRSDK.instance.levelEnd('level_1');

levelStart 必须与同一个 id 的 levelEnd 一一配对。配对不完整会导致完成率看板失真。

命名规范

• 关卡 id: 使用 snake_case,带作用域(用 world1_level3,而不是单独的 level3)。
• 游戏模式限定符: 折叠到 id 中(endless_hard、daily_2026_04_24),而不是另传字段。

你不必做的事

• 不要自己批量 —— 底层 SDK 会排队事件。
• 不要按授权状态卡门 —— 事件会先排队,等 CMP 完成后再按结果分发或丢弃。
• 内置事件(page_loading、game_loaded、device_info)会自动触发。

相关

• 完整事件分类、FTUE 模式、自定义事件、logValuedEvent:Web SDK 数据分析。这些是底层 SDK 已暴露但当前 Cocos 封装尚未包装的接口。