Ravensight

Extended raw-event retention

Studio owners can choose 90, 180 or 400 days in each game's Settings. The default is 90 days. A longer window preserves raw events that remain in storage; it cannot recover expired data. Lifetime aggregate history is separate, and existing programmatic query limits still apply.

Reading retained data: Monetization, Economy, Health, Builds, Progression, Retention and Explore offer 180- and 400-day dashboard ranges when the game's storage setting supports them. Retention uses weekly cohorts for ranges longer than 90 days so the full window fits; Explore keeps its 14-day limit for hourly grouping. Overview still uses aggregate history for ranges beyond 90 days; extending storage does not turn those views into raw-event queries or rebuild expired history. Structured MCP and REST analytics requests remain limited to a 31-day window per call, which can be placed within retained history. Guarded SQL can query retained raw rows under its existing result, time and scan limits. Other page pickers and experiment result windows retain their existing limits.

Extended storage costs one weighted event per stored event older than 90 days each month, including synthetic traffic. This uses the studio's shared included event allowance first, then prepaid balance. At the current rate, one million older events use one million weighted events, at most $0.50 per month after the allowance. Enabling extended storage requires the owner's recurring-charge confirmation. The displayed estimate uses the current older-event count; future volume can change.

A longer window requires a positive prepaid balance. Before extending it, Ravensight settles pending monthly storage snapshots, including the current month's snapshot, using the included allowance first. If funds cannot cover the work, the longer window is not applied. Retrying resumes the same payment records without charging completed work twice.

For an existing extended window, refused payment starts a 14-day grace period. Add balance or resolve the usage limit before the deadline. If payment still cannot finish, retention returns to 90 days and older raw events expire. Switching tiers, including a return to 90 days, does not erase an unpaid snapshot or reset its grace. Free 90-day retention remains available; completed storage charges remain.

Dashboard account authentication is required for GET and PUT /api/v1/games/{gameId}/retention. Both are owner-only. A PUT accepts {"retentionDays":180,"recurringConsent":true}; 90 days does not require recurring consent. Shared-game viewers and studio admins cannot authorize these charges.