SDK events - Totem Docs

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.

​Event types

​Transport limits

​Custom-event guidance

Event types

Transport limits

Custom-event guidance