Roblox Analytics

TabooHarmony/roblox-brain/skills/design/roblox-analytics

作者 TabooHarmony38826be57ee37bcf023e9c2b85681bea3909281c无许可证收录于 2026年10月9日更新于 2026年10月9日

Use when tracking player behavior, economy events, or funnels with AnalyticsService, including event taxonomy, rate limits, and batching.

仅含说明Data & Analytics
AI 生成的概览

关于使用 AnalyticsService 为 Roblox 游戏埋点的参考:事件类型、速率限制、批处理与经济健康信号。

功能
该技能是一份参考指南,介绍如何使用 Roblox 内置的 AnalyticsService 跟踪玩家行为、经济事件和漏斗。内容涵盖三类事件(Custom、Economy、Funnel)、速率限制与批处理、事件与字段数量上限、日志记录规则以及仪表盘显示时间。它还描述经济健康信号,如消耗/来源比、通胀、鲸鱼玩家集中度和同期群留存,并指向更完整的参考文件以获取代码示例和 API 表格。
适用场景
适用于在 Roblox 体验中添加或审查 AnalyticsService 埋点,或需要跟踪玩家行为、货币流动与漏斗进度时。也用于依据遥测信号诊断游戏内经济失衡。
运行要求
无需脚本,仅为说明文档。假定可使用 Roblox 内置的 AnalyticsService 与 Creator Hub 仪表盘,并引用附加文件 references/full.md 以获取详细示例。

Roblox Analytics Reference

When to Load

Load when tracking player behavior, economy events, or funnels, or when building AnalyticsService instrumentation.

Quick Reference

Key rules:

  • Use AnalyticsService (built-in). No third-party analytics SDK needed.
  • Three event types: Custom (counters/values), Economy (currency flow), Funnel (step progression)
  • Rate limit: 120 + (20 × CCU) calls per minute. Batch where possible.
  • Max 100 custom events, 10 resource types, 10 funnels, 3 custom fields per event.
  • Log events AFTER successful operations, not on attempt. Failed attempts log nothing.
  • Report the balance the authoritative mutation RETURNED at commit, unchanged. Never recompute it from the leaderstats replica: it already reflects the grant; re-adding double-counts.
  • Custom fields (up to 3) slice data without burning event cardinality.
  • Economy events track sources (earned) and sinks (spent) separately.
  • Funnel steps need not fire in order; skipped intermediate steps are auto-back-filled as completed when a later step logs.
  • Events appear on Creator Hub dashboard after ~24 hours. Use "View Events" for real-time validation.
  • Prefer server-side logging for accuracy; client-side only for UI interaction tracking.
  • Creator Rewards: no AnalyticsService grant event. Analytics for leading indicators (session duration, onboarding, referral milestones); Creator Dashboard for payout attribution.

Economy health (decision layer):

  • Instrument from day one; you cannot backfill history when the economy breaks.
  • Log source AND sink per currency with SKUs + the committed mutation's returned balance.
  • Health signals: sink/source ratio, inflation (CurrencySources - CurrencySinks), whale concentration (high ARPPU + low ARPDAU), price elasticity, sink sufficiency, D1/D7 cohorts. Thresholds are heuristics, not Roblox statements.
  • Economy breaks: verify events exist + correct, read narrowest broken signal, change ONE lever, re-check. Telemetry reports what broke; the user owns the design decision.

Cross-refs: roblox-growth-design for audit workflow; roblox-monetization for the purchase funnel.

Need more detail? Load references/full.md for the complete reference with code examples, API tables, and edge cases.

来源与署名

来源:TabooHarmony/roblox-brain位于skills/design/roblox-analytics提交38826be

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架