SDK events

Reference recorded event types and transport limits.

Event types

Type	Meaning
session_start	A playable session began.
heartbeat	The active session is still running.
visibility_change	The page changed between visible and hidden.
session_end	The session ended.
error	The SDK observed a game or transport error.
game_over	The game called window.Totem.gameOver.
custom	The game called window.Totem.event.

Transport limits

Limit	Value
Events per batch	25
Event payload	2,048 bytes
Request body	64 KB

The SDK batches events before sending them to the shell. The shell owns the API request.

Custom-event guidance

Use short stable names such as level_start, level_complete, or item_crafted. Keep properties small and JSON-serializable.

Do not send passwords, API keys, email addresses, or free-form personal text.