Documentation Index
Fetch the complete documentation index at: https://agenticadvertisingorg-changeset-release-main.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
This guide covers how AdCP represents audio advertising formats for streaming audio, podcasts, and radio.
Audio formats include:
- Hosted Audio - Direct audio file URLs (MP3, M4A)
- VAST Audio - DAAST/VAST tags for programmatic audio
- With Companion Banners - Audio + synchronized display companion
- Podcast Insertion - Dynamic ad insertion (DAI) for podcasts
Audio ads are typically non-skippable and play during natural content breaks.
Streaming Audio (15s, 30s, 60s)
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "30s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps",
"max_file_size_mb": 5
}
}
]
}
Audio with Companion Banner
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_companion"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "30s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps"
}
},
{
"asset_id": "companion_banner",
"asset_type": "image",
"asset_role": "companion_banner",
"required": false,
"requirements": {
"width": 640,
"height": 640,
"file_types": ["jpg", "png", "webp"],
"notes": "Displays during audio playback on screen-enabled devices"
}
}
]
}
Podcast Mid-Roll (60s)
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "podcast_midroll_60s"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "60s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps",
"max_file_size_mb": 10
}
}
]
}
Dynamic Audio Creative (DAC)
Multi-segment audio assembled dynamically:
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_dynamic_30s"
},
"type": "audio",
"assets": [
{
"asset_id": "intro_audio",
"asset_type": "audio",
"asset_role": "intro",
"required": true,
"requirements": {
"duration": "5s",
"format": ["MP3"]
}
},
{
"asset_id": "product_audio",
"asset_type": "audio",
"asset_role": "product_message",
"required": true,
"requirements": {
"duration": "15s",
"format": ["MP3"]
}
},
{
"asset_id": "cta_audio",
"asset_type": "audio",
"asset_role": "call_to_action",
"required": true,
"requirements": {
"duration": "10s",
"format": ["MP3"]
}
}
],
"delivery": {
"method": "server_side_stitching"
}
}
Creative Manifests
Hosted Audio Manifest
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s"
},
"assets": {
"audio_file": {
"asset_type": "audio",
"url": "https://cdn.brand.com/audio_spring_30s.mp3",
"duration": 30,
"format": "audio/mpeg"
},
"impression_tracker": {
"asset_type": "url",
"url_type": "tracker_pixel",
"url": "https://track.brand.com/imp?buy={MEDIA_BUY_ID}&station={APP_BUNDLE}&cb={CACHEBUSTER}"
},
"landing_url": {
"asset_type": "url",
"url_type": "clickthrough",
"url": "https://brand.com/spring?campaign={MEDIA_BUY_ID}"
}
}
}
VAST Audio Tag Manifest
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_vast"
},
"assets": {
"vast_tag": {
"asset_type": "vast",
"delivery_type": "url",
"url": "https://ad-server.brand.com/audio-vast?campaign={MEDIA_BUY_ID}&cb={CACHEBUSTER}"
}
}
}
Audio with Companion Banner Manifest
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_companion"
},
"assets": {
"audio_file": {
"asset_type": "audio",
"url": "https://cdn.brand.com/audio_spring_30s.mp3",
"duration": 30,
"format": "audio/mpeg"
},
"companion_banner": {
"asset_type": "image",
"url": "https://cdn.brand.com/companion_640x640.jpg",
"width": 640,
"height": 640
},
"landing_url": {
"asset_type": "url",
"url_type": "clickthrough",
"url": "https://brand.com/spring-sale?source=audio&cb={CACHEBUSTER}"
}
}
}
Audio-Specific Macros
In addition to universal macros, audio formats support:
Content Context
{CONTENT_GENRE} - podcast, music, news, talk
{CONTENT_RATING} - Explicit, Clean
{COLLECTION_NAME} - Podcast or collection name
{INSTALLMENT_ID} - Episode identifier
{ARTIST_NAME} - Currently playing artist (music platforms)
{TRACK_GENRE} - Music genre of current track
Platform Context
{APP_BUNDLE} - Streaming app ID (Spotify, Apple Music, etc.)
{STATION_ID} - Radio station ID
{LISTENING_MODE} - Free tier, Premium, Trial
{DEVICE_TYPE} - Mobile, Desktop, Smart Speaker, Auto
Ad Insertion
{INSERTION_TYPE} - preroll, midroll, postroll
{TIME_OF_DAY} - morning, afternoon, evening, night
{DAY_PART} - Commute, Workout, Work, Relaxation
Streaming Music (Spotify, Pandora, Apple Music)
- Free tier: Non-skippable audio between songs
- Typical durations: 15s or 30s
- Optional companion banner on screen-enabled devices
Podcast Insertion
- Baked-in: Permanently encoded in installment
- Dynamic insertion (SSAI): Personalized, with targeting and reporting
Companion Banners
Appear alongside audio on screen-enabled devices:
- Mobile apps, desktop players, smart speakers with displays
- Common sizes: 640x640 (square), 320x50 (mobile banner)
Common File Specifications
Audio Files
- Format: MP3 or M4A
- Bitrate: Minimum 128kbps, recommended 192kbps
- Sample Rate: 44.1kHz or 48kHz
- Channels: Stereo or mono
Durations
- 15s: Quick message, high frequency
- 30s: Standard, most common
- 60s: Story-driven, common in podcasts