Migrating channels
AdCP 3.0 replaces v2’s 9 channels with 20 planning-oriented channels that reflect how buyers allocate budgets. Five channels carry over unchanged, the rest are split, removed, or renamed, and several channels — includingsponsored_intelligence for AI surfaces — are net-new in v3 with no v2 equivalent.
Why the channel model changed
v2 mixed format-oriented channels (video, audio, native) with planning-oriented ones (social, ctv, dooh). Buyers don’t plan budgets around rendering technology — they plan around media types. A video budget gets split between OLV, CTV, and cinema. An audio budget spans radio, streaming, and podcasts.
v3 channels consistently match how agencies structure media plans.
Channel mapping
Complete v3 channel enum
All 20 values from thechannels.json schema:
The
gaming channel covers all in-game advertising. Rewarded video in gaming apps could also be classified as olv — use gaming when the inventory comes from a gaming budget, olv when it comes from a video budget.Migrating video products
The v2 video channel must be split across 3 v3 channels based on distribution (ctv was already a separate v2 channel):
olv— Online video (web, mobile app, social): pre-roll, outstream, in-app videolinear_tv— Traditional broadcast and cable televisioncinema— Movie theater pre-show advertising
olv and ctv if their inventory serves both mobile and TV.
Migrating audio products
The v2 audio channel splits into 2 v3 channels (podcast was already a separate v2 channel):
radio— Traditional AM/FM radio broadcaststreaming_audio— Digital audio streaming services (music platforms)
Migrating native products
v3 removes native as a channel. Native is a rendering style, not a budget category.
If you have products tagged native in v2, assign the appropriate v3 channel based on how the budget is planned:
- Native display ads ->
display - Native social ads ->
social - Native content recommendations ->
displayoraffiliatedepending on model
Migrating retail products
Simple rename from retail to retail_media.
Multi-channel products
v3 products declare an array of channels, so a single product can span multiple channels. Here’s a capabilities response showing a seller that supports multiple channels:get_products, each product’s channels array declares which channels that product is sold as:
Declaring channel support in capabilities
Buyers should callget_adcp_capabilities before filtering get_products
requests. When present, portfolio.primary_channels is the seller’s complete
brief-routing channel allowlist, so a buyer may skip the seller when no requested
channel intersects it. Omission means unknown scope, not support for every
channel. A match is not an availability guarantee; call get_products to
resolve current inventory and the rest of the brief.
AdCP 3.2 applies the same exhaustive routing meaning to
portfolio.primary_countries. Sellers upgrading from 3.1 that populated either
primary_* array with only representative values MUST expand it to the complete
brief-routing scope or omit it until they can do so. Empty and duplicate arrays
remain wire-valid in 3.2 for compatibility but produce Canary advisories; 4.0 is
expected to require non-empty, unique declarations. The country array does not
replace media_buy.execution.targeting geo capabilities or product
overlay_support.
Migration steps
1
Audit channel usage
Find all places your code reads or writes channel values.
2
Map old to new
Use the mapping table above to convert each value. Note that
display, social, ctv, podcast, and dooh are unchanged.3
Handle multi-mapping
Where v2
video or audio maps to multiple v3 channels, classify each product by its distribution context.4
Update filters
If your buyer agent filters by channel, update to the new values.
5
Update capabilities
Implement
get_adcp_capabilities with correct channel declarations.6
Test validation
v3 schema validation will reject old channel values like
video, audio, native, and retail.Media channel taxonomy
Full definitions and design rationale for all 20 v3 channels.
Related: Pricing | Geo targeting | Creatives | Catalogs | Attribution | AdCP 3.0 overview