Google Analytics 4 — data contract (audience export at egress; not affiliated with Google)
Outbound GA4 audience row at egress, for an ads partner or reverse ETL. Not affiliated with Google. Sample ids are fake.
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 stages
Derived from ga4_events_raw
- Egress3ga4_audience_exportThis contract
Derived from ga4_events_staged
Fields
| Name | Type | Required | Rule | Description |
|---|---|---|---|---|
| export_id | string | required | pattern /^aud_demo_[A-Za-z0-9_]+$/ | Stable id for this outbound audience row (demo prefix aud_demo_). |
| event_date | string | required | pattern /^[0-9]{4}-[0-9]{2}-[0-9]{2}$/ | — |
| event_name | string | required | — | — |
| platform | string | required | one of: web, android, ios | — |
| status | string | required | one of: ready, held, sent | Whether the row is ready to send, held, or already sent. |
| generated_at | string | required | pattern /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$/ | — |
Sample rows
One synthetic row we wrote. It validates against this contract with zero violations. No real customer data.
[
{
"event_date": "2026-01-15",
"event_name": "page_view",
"export_id": "aud_demo_page_view_20260115",
"generated_at": "2026-01-16T07:00:00Z",
"platform": "web",
"status": "ready"
}
]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.