关于 roblox-analytics
roblox-analytics 是供开发者追踪 Roblox 玩家行为、经济事件、漏斗和新手引导的参考技能。内容涵盖内置 AnalyticsService 的事件上报、调用限制及经济信号解读。
主要功能
- 01自定义、经济与漏斗事件
- 02AnalyticsService 调用频率指南
- 03按已提交余额上报的规则
- 04经济健康信号与群组指标
- 05服务端日志记录建议
适用场景
- 01追踪玩家的新手引导步骤
- 02衡量货币来源与消耗
- 03诊断经济健康状况变化
- 04不依赖第三方 SDK 记录行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tabooharmony/ roblox-brain --skill roblox-analytics安装后在 Claude Code 中输入/roblox-analytics确认已加载。
附带文件references/full.md
详细介绍
Roblox Analytics 参考
加载时机
在跟踪玩家行为、经济事件、漏斗或新手引导轨迹,或构建 AnalyticsService 埋点时加载。
快速参考
关键规则:
- 内置
AnalyticsService;无需第三方 SDK。 - 事件类型:自定义(计数器/数值)、经济(货币流动)、漏斗(步骤进度)
- 速率限制:每分钟 120 +(20 × CCU)次调用。尽可能批量处理。
- 经济事件报告已提交的变更;诊断事件可以记录失败的尝试。
- 报告已提交变更返回的余额;切勿根据
leaderstats副本重新计算,否则会重复计入。 - 经济事件分别跟踪来源(赚取)和去向(花费)。
- 漏斗步骤不必按顺序触发;记录后续步骤时,会补记跳过的步骤。
- 控制面板约有 24 小时延迟;“查看事件”可实时验证。
- 优先在服务端记录;仅在跟踪 UI 交互时使用客户端记录。
- Creator Rewards:没有 AnalyticsService 发放事件。跟踪先行指标(会话时长、新手引导、推荐);奖励发放由 Creator Dashboard 管理。
- 首次会话轨迹:使用有界缓冲区、共享保存负责人、RTBF + 保留策略。根据玩家历史判断资格,而非依据轨迹是否缺失;尝试次数也很重要。full.md §8。
经济健康度(决策层):
- 从第一天起就开始埋点;历史数据无法补录。
- 为每种货币记录来源和去向,并包含 SKU 及变更返回的余额。
- 健康信号:去向/来源比、通胀、鲸鱼集中度、弹性、去向充足度、D1/D7 队列。阈值仅供参考。
- 经济系统出现问题时:验证事件,查看最具体的异常信号,只调整一个杠杆,然后重新检查。
交叉参考: roblox-growth-design(审计工作流);roblox-monetization(购买漏斗)。
需要更多详情? references/full.md:代码示例、API 表格、边缘情况。
评论
支持 Markdown