Google Analytics 4 — data contract (cleaned GA4 event between stages; not affiliated with Google)
Cleaned GA4 event between stages: ISO event_date, lowercase platform, UTC event_at. Not affiliated with Google.
This contract is one boundary in the GA4 events pipeline chain. Validate the payload at that boundary, then follow the neighbors.
Also available: ODCS v3.1.0 YAML. “Use this contract” forks it into your org, then opens the validation playground so you can upload the client file.
Contract family
GA4 events pipeline
GA4 BigQuery events as they move from the raw daily export, through a cleaned event stage, to an audience export. Not affiliated with Google. Sample ids are fake.
- Ingest
- Between stages2ga4_events_stagedThis contract
Derived from ga4_events_raw
- Egress
Derived from ga4_events_staged
Fields
| Name | Type | Required | Rule | Description |
|---|---|---|---|---|
| event_date | string | required | pattern /^[0-9]{4}-[0-9]{2}-[0-9]{2}$/ | Reporting date as an ISO calendar date. |
| event_name | string | required | — | — |
| platform | string | required | one of: web, android, ios | Stream platform, lowercased from the export's WEB / ANDROID / IOS. |
| event_at | string | required | pattern /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$/ | Event time in UTC, converted from the microsecond timestamp. |
| user_pseudo_id | string | optional | — | — |
Sample rows
One synthetic row we wrote. It validates against this contract with zero violations. No real customer data.
[
{
"event_at": "2026-01-15T16:50:00Z",
"event_date": "2026-01-15",
"event_name": "page_view",
"platform": "web",
"user_pseudo_id": "1234567890.0987654321"
}
]Provenance
- Verified against
- https://support.google.com/analytics/answer/7029846
- Checked
- 2026-11-14
- Version
- v1.0
- Author
- DataContractGate
- License
- MIT
Spotted a mismatch with the vendor’s current schema? Report an issue.
Stripe, Shopify, QuickBooks, Xero, HubSpot, Salesforce, Google Analytics and Square are trademarks of their respective owners. DataContractGate is not affiliated with or endorsed by them. These contracts describe data shaped like these vendors’ documented schemas; they are not official and are not certified by any vendor.