数据分析(Unity)

FRVRSDK.Analytics 覆盖每款游戏都该上报的事件:新手引导(FTUE)、关卡漏斗、任意自定义事件。

必备事件

FTUE(新用户首次体验)

步骤是顺序的 —— 重复上报靠前的步骤会被忽略。新手引导是线性的就用 LogFTUE。

FRVRSDK.Analytics.LogFTUE(1, "learn_to_jump");
FRVRSDK.Analytics.LogFTUE(2, "learn_to_doublejump");

关卡 start / end

FRVRSDK.Analytics.LogLevelStart("level_1");
// ... 玩
FRVRSDK.Analytics.LogLevelEnd("level_1");

每一个 LogLevelStart 都要配一个 LogLevelEnd —— 漏斗看板就是用这一对来算通关率的。

自定义事件

FRVRSDK.Analytics.LogEvent("shop_open", "{}");
FRVRSDK.Analytics.LogEvent("bought_skin", "{\"skin\":\"red_hat\",\"slot\":\"head\"}");

payload 是 JSON 字符串。字段名用 snake_case,尽量保持扁平。

命名规范

• 事件名: snake_case,已完成的动作用过去时(bought_skin、opened_shop)。
• 字段键: snake_case。
• 游戏名一致: 每个事件都会被打上 FRVR 流水线注入的 gameId —— 不要在自定义字段里再写一遍。

你不必做的事

• 不要自己合批事件 —— 底层 SDK 会排队。
• 不要自己卡同意 —— 事件会缓存到 CMP 决议为止,然后按情况派发或丢弃。
• 不要自己上报 page_loading / game_loaded / device_info —— 封装包会在合适的时机自动触发。

相关

• 事件分类、同意管控、内置事件:Web SDK 数据分析参考。