DataContractGate

Cloud Free needs no credit card

Sign inSign up
← Catalog
Analytics

Google Analytics 4 — data contract (raw GA4 BigQuery event at ingest; not affiliated with Google)

Raw GA4 BigQuery events row at ingest. Compatible with Google Analytics 4's documented BigQuery export; not affiliated with Google. Root of the GA4 events contract family.

This contract is one boundary in the GA4 events pipeline chain. Validate the payload at that boundary, then follow the neighbors.

Download YAML

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.

  1. 1ga4_events_rawThis contract
    Ingest
  2. Derived from ga4_events_raw

    Between stages
  3. Derived from ga4_events_staged

    Egress
View pipeline

Fields

NameTypeRequiredRuleDescription
event_datestringrequiredpattern /^[0-9]{8}$/Date the event was logged, YYYYMMDD in the property's reporting time zone.
event_timestampintegerrequired≥ 0Client time in microseconds UTC.
event_namestringrequired——
user_pseudo_idstringoptional——
platformstringrequiredone of: WEB, ANDROID, IOSData stream platform from the BigQuery export.
stream_idstringoptional——

Sample rows

One synthetic row we wrote. It validates against this contract with zero violations. No real customer data.

[
  {
    "event_date": "20260115",
    "event_name": "page_view",
    "event_timestamp": 1768491000000000,
    "platform": "WEB",
    "stream_id": "1234567",
    "user_pseudo_id": "1234567890.0987654321"
  }
]

Provenance

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.