roblox-analytics

name	roblox-analytics
description	Use when tracking player behavior, economy events, or funnels with AnalyticsService, including event taxonomy, rate limits, and batching.
last_reviewed	"2026-07-13T00:00:00.000Z"
sources	["https://create.roblox.com/docs/reference/engine/classes/AnalyticsService","https://create.roblox.com/docs/creator-rewards","https://devforum.roblox.com/t/creator-rewards-is-live/3838257"]

Roblox Analytics Reference

When to Load

Load when tracking player behavior, economy events, or funnels; building custom event instrumentation; or understanding AnalyticsService rate limits and batching.

Quick Reference

Load Full Reference below only when you need specific API signatures or implementation patterns.

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 economy resource types, 10 funnels, 3 custom fields per event.
• Log events AFTER successful operations, not on attempt (avoids inflated metrics).
• Custom fields (up to 3) let you slice data without burning event cardinality.
• Economy events track sources (earned) and sinks (spent) separately.
• Funnel events must fire steps in order. Skipped steps break the funnel.
• Events appear on Creator Hub dashboard after ~24 hours. Use "View Events" for real-time validation.
• Server-side logging preferred for accuracy. Client-side only for UI interaction tracking.
• 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.

---

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