Key Concepts
Sessions
The SDK produces ‘sessions’ of zipped performance data which are uploaded to the GameBench server. By default, i.e. assuming default configuration values and with no code being necessary, a session is started when the app is started or foregrounded, and is stopped when the app goes to the background. This is called “the automatic session”. But if you’d rather start and stop a session in response to player events - to their entering and exiting an area of gameplay, say - then it’s easy to do that via automation or APIs.
Metrics
A metric is a specific type of performance measurement that is typically sampled once per second.
Markers
Markers are used to delimit periods of interest within a session and will appear in the session timelines shown in the GameBench web dashboard. A marked period has ‘start’ and ‘stop’ markers which may be recorded either via our APIs, or via automation, or through the in-app overlay (if enabled). If your game is built with Unity you will see start and stop markers generated automatically each time the active scene changes.
Tags
Each session has a collection of text properties known as ’tags’ which can be used to group related sessions together and which are searchable in the web dashboard. Tags are settable both at run time and at build time through configuration.