Audience
v0.1.0A 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/AutomotiveAPI lead attribution ultimately draws from. Member records themselves are enumerated separately via signals.list_audience_members and are not embedded here.
signals.get_audiencesignals.list_audiencessignals.list_audience_members{
"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"
}
}