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
Shell flush	20 events or 10 seconds
Ingest batch maximum	25 events
Ingest event payload	2,048 bytes
Ingest request body	64 KiB
Custom event name	1–64 characters
Custom event props	1,024 serialized characters
Custom event rate	10 per rolling minute

The SDK posts each event to the trusted shell. The shell queues those events and sends the API batch. The ingest endpoint accepts 30 requests per minute per player.

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