Publisher-Declared, Buyer-Selected Model
How It Works
- Publishers declare pricing options in their products via
pricing_optionsarray (each with uniquepricing_option_id) - Buyers discover available options through
get_products - Buyers select a specific option when creating a media buy via
pricing_option_id - Delivery is measured according to the declared
delivery_measurementprovider
Key Benefits
- Flexibility: Publishers can offer multiple pricing models for the same inventory
- Currency Support: Publishers specify supported currencies; buyers must match
- Market Standards: Each channel (TV, video, display, performance) can use its natural pricing unit
- Clear Expectations: Both parties agree on pricing before campaign launch
Measurement & Source of Truth
Measurement Provider as Source of Truth
The product declares the measurement provider, and the buyer accepts that provider as the source of truth for the buy. Publishers specify their measurement provider in the product:- Ad Servers: Google Ad Manager, Freewheel, SpringServe
- Attention Metrics: Adelaide, Lumen, TVision
- Third-Party Verification: IAS, DoubleVerify, Scope3
- TV/Audio Measurement: Nielsen, Comscore, iSpot.tv, Triton Digital
- DOOH: Geopath, Vistar, Place Exchange
Best Practices
For Publishers:- Clearly identify your measurement provider (ad server and any third-party verification)
- Explain your measurement methodology in plain language
- For DOOH, specify your audience measurement source (e.g., Geopath, venue sensors)
- Review the measurement provider before committing budget
- Ensure the provider meets your campaign requirements
- Negotiate audit rights in contracts if needed
Supported Pricing Models
CPM (Cost Per Mille)
Cost per 1,000 impressions - Traditional display advertising pricing. Use Cases: Display, native, banner advertising Example:vCPM (Viewable Cost Per Mille)
Cost per 1,000 viewable impressions - Payment only for impressions meeting MRC viewability standard. Use Cases: Display, native, video advertising with viewability guarantee Viewability Standard: MRC (Media Rating Council) standard requires:- Display ads: 50% of pixels in-view for at least 1 continuous second
- Video ads: 50% of pixels in-view for at least 2 continuous seconds
delivery_measurement field. Common providers include IAS (Integral Ad Science), DoubleVerify, MOAT, and Google Active View.
CPCV (Cost Per Completed View)
Cost per 100% video/audio completion - Payment only for fully completed views. Use Cases: Video campaigns, audio ads, pre-roll video Example:CPV (Cost Per View)
Cost per view at threshold - Payment when viewer reaches publisher-defined threshold. Use Cases: Video campaigns with shorter completion requirements Example:view_threshold: Decimal from 0.0 to 1.0 (e.g., 0.5 = 50% completion)
CPP (Cost Per Point)
Cost per Gross Rating Point - Traditional TV/radio buying metric. Use Cases: Connected TV, linear TV, radio, audio streaming Example:demographic: Target demographic (e.g., “A18-49”, “W25-54”, “M35+”)min_points: Minimum GRP commitment required
grps: Total Gross Rating Points deliveredreach: Unique individuals reachedfrequency: Average frequency per individual
- Nielsen DAR/TV: Industry-standard TV measurement
- Comscore: Campaign Ratings for CTV
- iSpot.tv: Advanced TV analytics
- Triton Digital: Audio/streaming measurement
CPC (Cost Per Click)
Cost per click - Performance-based pricing for engagement. Use Cases: Direct response campaigns, search ads, social advertising Example:CPA (Cost Per Acquisition)
Cost per conversion event - Advertiser pays when a defined conversion occurs. Use Cases: Retail media (pay per order), lead generation, app install campaigns, commerce media Example:event_type fires. The pricing option declares what event triggers billing — this is independent of optimization_goals, which controls delivery optimization.
Parameters:
event_type(required): The conversion event that triggers billing. Uses the standard event type enum (e.g.,purchase,lead,app_install,add_to_cart,subscribe).event_source_id(optional): When present, only events from this specific source count toward billing. Must match an event source configured viasync_event_sources. When omitted, any event of the specifiedevent_typecounts.
event_type (what triggers billing) is independent of the package’s optimization_goals (what the platform optimizes delivery toward). For example, a package can use CPA pricing on lead events while setting an event goal with event_sources containing purchase events and target: { kind: "per_ad_spend", value: 4.0 } — billing fires on leads, but delivery is optimized for downstream purchase return.
Refunds and adjustments: Refund handling and conversion adjustment policies are commercial terms between buyer and seller. The protocol does not govern clawbacks or billing credits for refunded conversions.
Note: CPA replaces the need for separate “CPO” (Cost Per Order) or “CPL” (Cost Per Lead) pricing models. A seller can offer multiple CPA options with different event types, event sources, and prices on the same product.
Flat Rate
Fixed cost - Single payment regardless of delivery volume. Use Cases: Sponsorships, takeovers, exclusive placements, branded content, DOOH fixed slots Example (sponsorship):parameters.type: "dooh"):
sov_percentage: Guaranteed share of voice as a percentage (0-100)loop_duration_seconds: Duration of ad loop rotation in secondsmin_plays_per_hour: Minimum guaranteed plays per hourvenue_package: Named collection of screensduration_hours: Duration of the slot in hours (e.g., 24 for a full-day takeover)daypart: Named daypart (e.g.,morning_commute,evening_rush)estimated_impressions: Audience impression estimate (informational, not a delivery guarantee)
parameters — the fixed price covers the placement without DOOH-specific constraints.
Time (Cost Per Time Unit)
Cost per time unit - Rate scales with campaign duration, enabling self-serve sponsorships. Use Cases: Homepage takeovers, section sponsorships, premium placements where price depends on booking duration Example:fixed_price x number of time_units in the campaign flight. For example, a 3-day campaign at 150,000 total.
Parameters:
time_unit(required):"hour","day","week", or"month"min_duration(optional): Minimum booking duration in time unitsmax_duration(optional): Maximum booking duration in time units
Comparison with Flat Rate:
Digital Out-of-Home (DOOH) Pricing
DOOH advertising uses existing pricing models—typically CPM or flat_rate—with optional parameters to describe the inventory allocation.Basic Concepts
- CPM for DOOH: Priced per thousand impressions, where impressions are calculated based on venue traffic (e.g., Geopath data)
- Flat rate for DOOH: Fixed cost for specific duration or allocation (hourly, daily, or exclusive takeover)
Simple Example: Billboard Takeover
DOOH parameters (optional)
For flat_rate DOOH inventory, publishers may include aparameters object with "type": "dooh". See the flat_rate pricing model section above for a complete example and full field list.
Note: DOOH measurement and buying practices vary by market. Publishers should clearly explain their measurement methodology and inventory allocation in the product description and delivery_measurement field.
Multi-Currency Support
Publishers can offer the same product in multiple currencies:Fixed vs. Auction Pricing
Fixed Pricing (fixed_price present)
- Publisher sets a fixed price
- Price is guaranteed and predictable
- Common for guaranteed inventory
- Include
fixed_pricefield
Auction Pricing (fixed_price absent)
- Final price determined through auction
- Publisher provides
floor_price(hard minimum) and optionalprice_guidance(percentile hints) - Bid-based auction models (
cpm,vcpm,cpc,cpcv,cpv) may also include optionalmax_bid: trueto explicitly signalbid_priceis treated as buyer maximum willingness to pay (ceiling mode) - Common for non-guaranteed inventory
- Buyer submits
bid_pricein media buy request
Buyer Selection Process
Each package specifies its own pricing option, which determines currency and pricing model:- Package selects
pricing_option_idfrom product (e.g., “cpcv_usd_auction”) - Pricing option determines currency, pricing model, and fixed vs auction
- Package
budgetis in the pricing option’s currency - Auction-based pricing requires
bid_price; it is the exact honored price unlessmax_bid: true, which switches it to a maximum-willingness-to-pay ceiling - Sellers validate currency compatibility across packages
Reporting Metrics by Pricing Model
Different pricing models report different primary metrics:Example: Multi-Model CTV Product
A publisher offering Connected TV inventory with multiple pricing options:Best Practices
For Publishers
- Offer relevant pricing models - Match pricing to your inventory type and buyer expectations
- Set appropriate minimums - Use
min_spend_per_packageto ensure campaign viability - Provide price guidance - For auction pricing, give realistic floor and percentile data
- Consider multi-currency - Support currencies of your target markets
- Document parameters - Clearly explain thresholds, demographics, and action types
For Buyers
- Select appropriate model - Choose pricing that aligns with campaign objectives
- Match currency - Ensure you select a currency the publisher supports
- Set realistic budgets - Account for minimum spend requirements
- Align goals with pricing - Set delivery goals that match your pricing model
- Monitor relevant metrics - Focus on the metrics that matter for your pricing model
Related Documentation
- Media Products - Product model reference
- Creating Media Buys - How to select pricing when buying
- Delivery Reporting - Understanding metrics by pricing model
- Glossary - Pricing and metric definitions