$npx -y skills add TabooHarmony/roblox-brain --skill roblox-analyticsUse when tracking player behavior, economy events, or funnels with AnalyticsService, including event taxonomy, rate limits, and batching.
| 1 | # Roblox Analytics Reference |
| 2 | |
| 3 | ## When to Load |
| 4 | |
| 5 | Load when tracking player behavior, economy events, or funnels; building custom event instrumentation; or understanding AnalyticsService rate limits and batching. |
| 6 | |
| 7 | ## Quick Reference |
| 8 | |
| 9 | **Load Full Reference below only when you need specific API signatures or implementation patterns.** |
| 10 | |
| 11 | Key rules: |
| 12 | - Use `AnalyticsService` (built-in). No third-party analytics SDK needed. |
| 13 | - Three event types: Custom (counters/values), Economy (currency flow), Funnel (step progression) |
| 14 | - Rate limit: 120 + (20 × CCU) calls per minute. Batch where possible. |
| 15 | - Max 100 custom events, 10 economy resource types, 10 funnels, 3 custom fields per event. |
| 16 | - Log events AFTER successful operations, not on attempt (avoids inflated metrics). |
| 17 | - Custom fields (up to 3) let you slice data without burning event cardinality. |
| 18 | - Economy events track sources (earned) and sinks (spent) separately. |
| 19 | - Funnel events must fire steps in order. Skipped steps break the funnel. |
| 20 | - Events appear on Creator Hub dashboard after ~24 hours. Use "View Events" for real-time validation. |
| 21 | - Server-side logging preferred for accuracy. Client-side only for UI interaction tracking. |
| 22 | - Creator Rewards has no AnalyticsService grant event. Use analytics for leading indicators such as session duration, onboarding, and referral-flow milestones; use Creator Dashboard for reward attribution and payout data. |
| 23 | |
| 24 | --- |
| 25 | **Need more detail?** Load `references/full.md` for the complete reference with code examples, API tables, and edge cases. |