A game session record tracking a continuous period of user engagement with the application
tid
Timestamp-based ID
Properties
activitySummary
ref
#activitySummary
Optional
No description provided.
clientVersion
string
Required
Version of the client application
createdAt
string
datetime
Optional
When the session record was created
duration
integer
Optional
Total session duration in milliseconds (calculated when session ends)
minimum: 0endReason
string
Optional
Why the session ended
logout, timeout, inactivity, user_initiated, device_switch, app_close, forced_endendedAt
string
datetime
Optional
When the session ended (ISO 8601)
lastActivityAt
string
datetime
Optional
Timestamp of the last recorded activity in this session
metadata
ref
#metadata
Optional
No description provided.
parentSessionUri
string
Optional
URI of the previous session if this is a continuation (e.g., after brief inactivity)
platform
string
Required
Platform where the session occurred
web, mobile, desktop, pwarelatedLogUris
array
of
string
Optional
URIs of log records that occurred during this session
relatedProgressUris
array
of
string
Optional
URIs of progress records created during this session
relatedSessionUris
array
of
string
Optional
URIs of related sessions (e.g., same day, same device)
sessionContext
ref
#sessionContext
Optional
No description provided.
startedAt
string
datetime
Required
When the session began (ISO 8601)
status
string
Required
Current status of the session
active, ended, expired, invalidatedupdatedAt
string
datetime
Optional
When the session record was last updated
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"startedAt",
"status",
"platform",
"clientVersion"
],
"properties": {
"status": {
"enum": [
"active",
"ended",
"expired",
"invalidated"
],
"type": "string",
"description": "Current status of the session"
},
"endedAt": {
"type": "string",
"format": "datetime",
"description": "When the session ended (ISO 8601)"
},
"duration": {
"type": "integer",
"minimum": 0,
"description": "Total session duration in milliseconds (calculated when session ends)"
},
"metadata": {
"ref": "#metadata",
"type": "ref"
},
"platform": {
"enum": [
"web",
"mobile",
"desktop",
"pwa"
],
"type": "string",
"description": "Platform where the session occurred"
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "When the session record was created"
},
"endReason": {
"enum": [
"logout",
"timeout",
"inactivity",
"user_initiated",
"device_switch",
"app_close",
"forced_end"
],
"type": "string",
"description": "Why the session ended"
},
"startedAt": {
"type": "string",
"format": "datetime",
"description": "When the session began (ISO 8601)"
},
"updatedAt": {
"type": "string",
"format": "datetime",
"description": "When the session record was last updated"
},
"clientVersion": {
"type": "string",
"description": "Version of the client application"
},
"lastActivityAt": {
"type": "string",
"format": "datetime",
"description": "Timestamp of the last recorded activity in this session"
},
"relatedLogUris": {
"type": "array",
"items": {
"type": "string"
},
"description": "URIs of log records that occurred during this session"
},
"sessionContext": {
"ref": "#sessionContext",
"type": "ref"
},
"activitySummary": {
"ref": "#activitySummary",
"type": "ref"
},
"parentSessionUri": {
"type": "string",
"description": "URI of the previous session if this is a continuation (e.g., after brief inactivity)"
},
"relatedSessionUris": {
"type": "array",
"items": {
"type": "string"
},
"description": "URIs of related sessions (e.g., same day, same device)"
},
"relatedProgressUris": {
"type": "array",
"items": {
"type": "string"
},
"description": "URIs of progress records created during this session"
}
}
},
"description": "A game session record tracking a continuous period of user engagement with the application"
}