← Back to product·Simulmedia Switchboard Docs · v1 draft·Concepts / The deal model
Concepts

The deal model

Every trade on Switchboard composes a handful of orthogonal dimensions, so a buy is a combination, not one item off a fixed list. Three questions shape it: what you pay for, when you buy it, and how you place the order.

DimensionValues
PackageSelling-title daypart, program, genre, rotator, run of network, sponsorship, or custom. Seller-defined, versioned, and optionally market-scoped. See Packages.
Distributionnetwork, syndication, or spot: the layer the inventory sits in, composing with the package's optional market rather than duplicating it. See Packages.
Buy typepreemptible, non_preemptible, fixed_position, or audience_guaranteed. See Buy types and guarantees.
RateRate card keyed by advertiser class, creative length, buy type, clearance tier, and market class, within a card scoped open or to an agreement. Price locks at order time. See Rates.
WorkflowCatalog, document, or proposal. Wire values: the workflow enum.

What you pay for

The buy type states the pay basis, what the seller stands behind, and who picks the spots. There are four wire values and three spot-cost buying patterns. There is no non-guaranteed CPM cell: a CPM is priced against a delivery guarantee, while a buyer taking delivery risk buys a spot cost.

Buying patternWire valuePay basisSeller stands behind
PreemptiblepreemptibleSpot costNo contractual airing guarantee; clearance_tier states priority.
Non-Preemptiblenon_preemptibleSpot costThe spot airs; placement within the package remains the seller's.
Fixed Positionfixed_positionSpot costThe spot airs in the position bought.
Audience Guaranteedaudience_guaranteedCPMDelivered audience; shortfalls follow the make-good policy.

The wire values live at the buy_type enum. The full guarantee semantics live on Buy types and guarantees.

When you buy

The same inventory prices differently by how far ahead you commit. The market class on the rate card names the point on that spectrum:

Market classWhenWhat it is
upfrontAhead of the seasonCommit a budget early and lock rates, then draw it down order by order. See Upfront commitments.
scatterIn-quarterBuy at the going rate as the quarter unfolds, with no commitment.
remnantNear airDiscounted inventory still unsold as air approaches.
opportunisticNear airInventory that opens late, marked down with a signal agents can act on.

The commercial choice is guaranteed premium access versus flexible opportunistic access. Upfront and scatter are where that choice is expressed; remnant and opportunistic are its far end. Near-air discounted inventory remains preemptible.

How you place it

Send the seller a brief and let them build it, or take what is already published. Both are first-class:

  • Proposal. Send an audience plan, campaign specs, or an open brief. On the wire, the request uses workflow: "proposal" on POST /orders and carries a request instead of line items. The returned plan carries buy_type per line. Accepting it books one order whatever mix of buy types it contains. See Proposals.
  • Catalog order. Pick published packages, prices, and availability. Every order still passes the seller's gate: a person, or rules that person set. See Approve orders.

Sellers declare which buy types and market classes each package supports; buyers filter by them. Political buys are an advertiser_class that overlays any compatible buy type rather than a type of their own.