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

Audience

v0.1.0

A marketing audience or segment in the Marketing & Analytics (signals) domain (spec §4 R07 'Audiences'). An Audience is a named, reusable group of people or accounts assembled from a CDP, DMS, CRM, website behavior, manual upload, or a third-party source, and activated against advertising and messaging platforms. Static audiences are fixed membership snapshots; dynamic audiences are rule-driven and recomputed on refresh; lookalike audiences are modeled from a seed; suppression audiences exclude members from targeting. Audiences complement the Campaign entity (which references an audience for delivery) and provide the population that ADF lead attribution ultimately draws from. Member records themselves are enumerated separately via signals.list_audience_members and are not embedded here.

Resourcessignals.get_audiencesignals.list_audiencessignals.list_audience_members
audience.example.jsonJSON
{
  "id": "9c3d2b1a-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "source_ids": [
    {
      "system": "segment_cdp",
      "id": "aud_01HZXK4Q7M8N",
      "sequence": 1
    },
    {
      "system": "vinsolutions_crm",
      "id": "SEG-88213",
      "sequence": 2
    }
  ],
  "name": "In-Market SUV Shoppers - 30 Day",
  "description": "Contacts who viewed two or more SUV VDPs in the last 30 days, have no open sales deal, and opted in to marketing. Used to power the summer SUV clearance email and paid social push.",
  "type": "dynamic",
  "status": "active",
  "size": 4820,
  "size_is_estimated": false,
  "matchable_size": 4102,
  "definition": {
    "logic": "all",
    "time_window_days": 30,
    "filters": [
      {
        "field": "events.vdp_view.count_30d",
        "operator": "gt",
        "value": 1
      },
      {
        "field": "deal.status",
        "operator": "neq",
        "value": "open"
      },
      {
        "field": "consent.email_opt_in",
        "operator": "exists",
        "value": true
      }
    ],
    "groups": [
      {
        "logic": "any",
        "filters": [
          {
            "field": "vehicle.body_style",
            "operator": "in",
            "value": [
              "suv",
              "crossover"
            ]
          },
          {
            "field": "vehicle.segment",
            "operator": "eq",
            "value": "utility"
          }
        ]
      }
    ],
    "raw_query": "SELECT person_id FROM cdp.profiles WHERE (body_style IN ('suv','crossover') OR segment = 'utility') AND vdp_view_count_30d > 1 AND deal_status != 'open' AND email_opt_in IS NOT NULL"
  },
  "source": "cdp",
  "identity_keys": [
    "hashed_email",
    "email",
    "maid"
  ],
  "external_ids": [
    {
      "platform": "meta",
      "audience_id": "23851234567890321",
      "account_id": "act_100200300",
      "sync_status": "synced",
      "synced_at": "2026-06-29T14:05:00Z",
      "url": "https://business.facebook.com/adsmanager/audiences/detail/?id=23851234567890321"
    },
    {
      "platform": "google",
      "audience_id": "customers/1234567890/userLists/9988776655",
      "account_id": "1234567890",
      "sync_status": "failed",
      "sync_error": "Customer Match list below minimum matched size; upload rejected."
    }
  ],
  "match_stats": {
    "uploaded_count": 4820,
    "matched_count": 3611,
    "match_rate": 74.9,
    "computed_at": "2026-06-30T06:02:00Z"
  },
  "refresh_schedule": "daily",
  "membership_ttl_days": 30,
  "dealer_id": "1a2b3c4d-5e6f-4718-8a9b-0c1d2e3f4a5b",
  "region": "US",
  "campaign_ids": [
    "7f8e9d0c-1b2a-4c3d-9e8f-6a5b4c3d2e1f"
  ],
  "owner": {
    "user_id": "3d4e5f6a-7b8c-4d9e-8f01-2a3b4c5d6e7f",
    "name": {
      "first": "Dana",
      "last": "Okafor"
    },
    "email": {
      "address": "dana.okafor@example-dealer.com"
    }
  },
  "tags": [
    "summer-2026",
    "suv",
    "retargeting"
  ],
  "consent_basis": "opt_in",
  "consent_scope": [
    "email",
    "paid_social",
    "display"
  ],
  "privacy": {
    "retention_days": 540,
    "expires_at": "2027-12-31T00:00:00Z",
    "contains_sensitive_categories": false,
    "honor_do_not_sell": true,
    "data_processing_region": "US"
  },
  "refreshed_at": "2026-06-30T06:00:00Z",
  "created_at": "2026-05-12T09:30:00Z",
  "updated_at": "2026-06-30T06:00:12Z",
  "extensions": {
    "com.exampledealer.priority_tier": "gold"
  }
}
Object shapes draw on the industry’s ADF 1.0 lead format and on the DMS and CRM structures dealers already run, so a conformant server maps cleanly onto them. Lineage is noted per entity in the schema description.
Canonical URL

This schema is served at its $id: https://automotivemcp.ai/schemas/signals/audience.json. All 26 are listed in /schemas/index.json.

A field missing, mistyped, or wrong for how your system actually stores it?Propose a change →Opens an email with this entity and version already filled in. No account needed, and you keep your copyright.