mcpField
R
roblox-analytics

roblox-analytics

github.com/tabooharmony数据与数据库1381.9k 次安装2 周前更新
代码仓库

关于 roblox-analytics

roblox-analytics 是供开发者追踪 Roblox 玩家行为、经济事件、漏斗和新手引导的参考技能。内容涵盖内置 AnalyticsService 的事件上报、调用限制及经济信号解读。

主要功能

  1. 01自定义、经济与漏斗事件
  2. 02AnalyticsService 调用频率指南
  3. 03按已提交余额上报的规则
  4. 04经济健康信号与群组指标
  5. 05服务端日志记录建议

适用场景

  1. 01追踪玩家的新手引导步骤
  2. 02衡量货币来源与消耗
  3. 03诊断经济健康状况变化
  4. 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