git:20261015.28be409 to git:20261015.be33683

21 added, 25 removed. Audit A to A.

---

name: roblox-analytics

- description: "Use for AnalyticsService events, economy telemetry, funnels, or per-player onboarding traces, including limits and offline analysis."

- last_reviewed: 2026-10-04

+ description: "Use when adding, changing, or auditing Roblox analytics: AnalyticsService custom, economy and funnel events, taxonomy, rate limits."

+ when_to_use: "Also when reading stats, tracking where players drop off, measuring an update or experiment, instrumenting a feature, or checking events are logged correctly."

+ last_reviewed: 2026-08-11

sources:

- https://create.roblox.com/docs/reference/engine/classes/AnalyticsService

- https://create.roblox.com/docs/production/analytics/event-types

- https://create.roblox.com/docs/production/analytics/custom-fields

- https://create.roblox.com/docs/production/analytics/analytics-dashboard

- https://create.roblox.com/docs/production/analytics/monetization

- https://create.roblox.com/docs/creator-rewards

- https://devforum.roblox.com/t/creator-rewards-is-live/3838257

- - https://create.roblox.com/docs/cloud-services/data-stores/error-codes-and-limits

- - https://create.roblox.com/docs/cloud-services/data-stores/right-to-be-forgotten

- - https://create.roblox.com/docs/cloud/reference/features/storage

- - https://create.roblox.com/docs/reference/engine/classes/DataModel

---

# Roblox Analytics Reference

## When to Load

- Load when tracking player behavior, economy events, funnels, or onboarding traces, or building `AnalyticsService` instrumentation.

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

## Quick Reference

Key rules:

- - Built-in `AnalyticsService`; no third-party SDK.

- - Event types: Custom (counters/values), Economy (currency flow), Funnel (step progression)

- - Rate limit: 120 + (20 × CCU) calls/minute. Batch where possible.

- - Max 100 custom events, 10 resource types, 10 funnels, 3 custom fields/event.

- - Economy events report committed changes; diagnostic events can record failed attempts.

- - Report the balance the committed mutation RETURNED; never recompute it from the `leaderstats` replica — re-adding double-counts.

- - Up to 3 custom fields slice data without burning event cardinality.

+ - 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 steps back-fill when a later step logs.

- - Dashboard ~24-hour delay; "View Events" validates in real time.

- - Server-side logging preferred; client-side only for UI interaction tracking.

- - Creator Rewards: no AnalyticsService grant event. Track leading indicators (session duration, onboarding, referrals); Creator Dashboard owns payouts.

- - First-session traces: bounded buffer, shared save owner, RTBF + retention. Eligibility from player history, not missing traces; attempts matter. full.md §8.

+ - 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.

- - Log source AND sink per currency with SKUs + the mutation's returned balance.

- - Health signals: sink/source ratio, inflation, whale concentration, elasticity, sink sufficiency, D1/D7 cohorts. Thresholds are heuristics.

- - Economy breaks: verify events, read narrowest broken signal, change ONE lever, re-check.

+ - 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` (audit workflow); `roblox-monetization` (purchase funnel).

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

- **Need more detail?** `references/full.md`: code examples, API tables, edge cases.

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