Google Analytics · Schema

Event

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.
View JSON Schema on GitHub

JSON Schema

google-analytics-event-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Event",
  "title": "Event",
  "type": "object",
  "required": [
    "name"
  ],
  "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."
        }
      }
    }
  }
}