tabooharmony/roblox-brain

roblox-analytics

Use when adding, changing, or auditing Roblox analytics: AnalyticsService events, economy, funnels, onboarding traces, rate limits.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-analytics

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Roblox Analytics Reference

When to Load

Load when tracking player behavior, economy events, funnels, or onboarding traces, or 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.
  • 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.
  • 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.

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.

Cross-refs: roblox-growth-design (audit workflow); roblox-monetization (purchase funnel).

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

Tâches connexes

du même dépôt

Autres Skills

Tous les Skills