Skip to content
AutomotiveMCP
SchemasMarketing & Analytics · R07RFC / v0.1

Event

v0.1.0

A single signal in the read-only engagement/sale/service stream of the Marketing & Analytics (signals) domain (spec §4 R07 'Events'). Each Event is an immutable, append-only record of one thing that happened for one customer at one dealer — a page view, an ad click, a conversion, an inbound lead, an outbound email/SMS touch, or a fixed-ops (service) milestone. Events unify web analytics (page_view, input_tracking, ad_click, conversion), CRM/marketing engagement (lead, enrichment, email_*, sms_*), retail sale (sale), and service-lane activity (service_lead, service_appointment, service_ro, appointment) into one time-ordered feed. This domain is READ-ONLY: producers emit events, consumers (AI agents) subscribe via signals.list_events and signals.get_event, but no tool mutates an Event after it is written. ADF/AutomotiveAPI lineage: an inbound 'lead' event typically corresponds to the arrival of an ADF <adf><prospect> payload (see leads/lead.json), and 'sale'/'service_ro' events align with AutomotiveAPI DealJacket and RepairOrder milestones.

Resourcessignals.list_eventssignals.get_event

event.example.jsonJSON
{
  "id": "3f2a1c9e-7b4d-4e2a-9c1f-8a6b5d4e3c21",
  "schema_version": "0.1.0",
  "source_ids": [
    {
      "system": "ga4",
      "id": "GA4.2.1837465920.1719800000",
      "sequence": 1
    },
    {
      "system": "crm",
      "id": "evt_00219845",
      "sequence": 2
    }
  ],
  "type": "sale",
  "occurred_at": "2026-06-30T18:42:11Z",
  "customer_id": "b1e6d2f4-3a5c-4d8e-9f10-2c3b4a5d6e7f",
  "anonymous_id": "amcp_anon_1a2b3c4d5e6f",
  "dealer_id": "a0c9e8d7-6b5a-4c3d-2e1f-0a9b8c7d6e5f",
  "session_id": "sess_9f8e7d6c5b4a3210",
  "source": "dms",
  "channel": "showroom",
  "value": {
    "amount": 48250,
    "currency": "USD"
  },
  "currency_code": "USD",
  "test": false,
  "properties": {
    "deal_id": "c4d5e6f7-8a9b-4c1d-2e3f-4a5b6c7d8e9f",
    "vin": "1GNSKCKD7MR234891",
    "stock_number": "N24-8891",
    "sale_type": "finance",
    "front_gross": 2150,
    "back_gross": 1875,
    "salesperson_id": "d5e6f7a8-9b0c-4d1e-2f3a-4b5c6d7e8f90"
  },
  "attribution": {
    "campaign_id": "e6f7a8b9-0c1d-4e2f-3a4b-5c6d7e8f9012",
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "2026-summer-clearance",
    "utm_term": "chevy blazer rs lease",
    "utm_content": "responsive_ad_v3",
    "click_id": "Cj0KCQjw1234gclid5678",
    "attribution_model": "data_driven"
  },
  "consent": {
    "gdpr_applies": false,
    "analytics_allowed": true,
    "marketing_allowed": true,
    "gpc": false,
    "consent_string": "CPxrAAAPxrAAAAKAABAENAAAAAAAAAAAAAAAAAAA"
  },
  "page": {
    "url": "https://www.example-chevrolet.com/new/2024-blazer-rs/vin/1GNSKCKD7MR234891",
    "referrer": "https://www.google.com/",
    "title": "2024 Chevrolet Blazer RS | Example Chevrolet",
    "path": "/new/2024-blazer-rs/vin/1GNSKCKD7MR234891",
    "search": "?utm_source=google&utm_medium=cpc"
  },
  "device": {
    "type": "mobile",
    "os": "iOS",
    "browser": "Safari",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1",
    "ip_address": "203.0.113.47"
  },
  "geo": {
    "city": "Austin",
    "region": "TX",
    "country": "US"
  },
  "created_at": "2026-06-30T18:42:13Z",
  "extensions": {
    "acme:lot_zone": "front-line",
    "acme:desk_manager_id": "f7a8b9c0-1d2e-4f3a-4b5c-6d7e8f901234"
  }
}
Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.