Event Schema

{
  "event_id": "evt_123abc",
  "event_type": "conversion",
  "timestamp": "2024-12-12T14:30:00.000Z",
  "received_at": "2024-12-12T14:30:01.234Z",
  
  // User identification
  "user_id": "user_123",
  "anonymous_id": "anon_456",
  "session_id": "sess_789",
  
  // Source attribution
  "source": {
    "platform": "google_ads",
    "campaign_id": "camp_123",
    "ad_group_id": "ag_456",
    "ad_id": "ad_789",
    "keyword": "marketing software"
  },
  
  // UTM parameters
  "utm": {
    "source": "google",
    "medium": "cpc",
    "campaign": "q4_holiday",
    "content": "banner_a",
    "term": "marketing software"
  },
  
  // Event properties
  "properties": {
    "page_url": "https://example.com/checkout",
    "referrer": "https://google.com",
    "revenue": 99.99,
    "currency": "USD",
    "product_id": "prod_123",
    "quantity": 1
  },
  
  // Device & context
  "context": {
    "ip": "192.168.1.1",
    "user_agent": "Mozilla/5.0...",
    "locale": "en-US",
    "timezone": "America/New_York",
    "device": {
      "type": "desktop",
      "os": "Windows",
      "browser": "Chrome"
    },
    "geo": {
      "country": "US",
      "region": "NY",
      "city": "New York"
    }
  }
}