Google Analytics · Schema
Event
Event schema from Google Analytics API
AnalyticsDataGoogleMetricsReportingWeb AnalyticsMachine LearningAttribution
Properties
| Name | Type | Description |
|---|---|---|
| name | string | The name of the event. Must not use reserved names (ad_click, app_exception, error, session_start, etc.) or reserved prefixes (_, firebase_, ga_, google_, gtag.). |
| params | object | Event parameters as key-value pairs. Common parameters include session_id, engagement_time_msec, and timestamp_micros. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/google-analytics/refs/heads/main/json-schema/measurement-protocol-event-schema.json",
"title": "Event",
"description": "Event schema from Google Analytics API",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the event. Must not use reserved names (ad_click, app_exception, error, session_start, etc.) or reserved prefixes (_, firebase_, ga_, google_, gtag.).",
"example": "Example Name"
},
"params": {
"type": "object",
"description": "Event parameters as key-value pairs. Common parameters include session_id, engagement_time_msec, and timestamp_micros.",
"additionalProperties": true,
"properties": {
"session_id": {
"type": "string",
"description": "Session identifier for accurate session metrics."
},
"engagement_time_msec": {
"type": "integer",
"description": "User engagement duration in milliseconds."
},
"timestamp_micros": {
"type": "integer",
"format": "int64",
"description": "Unix epoch time in microseconds to override event timestamp."
}
}
}
},
"required": [
"name"
]
}