Skip to main content

​
Integration

Thrad SSP supports OpenRTB 2.6 with Native 1.2. Expose one HTTPS bid endpoint. The SSP calls it with a standard BidRequest on every auction. Respond with a BidResponse — or 204 for no-bid. Win/loss/billing outcomes are communicated via nurl, lurl, and burl you supply in the response. Authentication is Bearer token. Full request/response specs in the Bid API reference.

​
End-to-end flow

  • nurl fires on win, after the winning creative is committed for render. Does not confirm impression.
  • burl fires on impression confirmation. Use this for spend recognition.
  • lurl fires on loss with reason code. Does not block winner path. Fires for both cross-DSP losers and in-response losers — see Multi-bid responses below.

​
First-Price Auction

The SSP runs a first-price auction across all DSP responses:
  • Highest bid wins
  • Winner pays their own bid amount (first-price)
  • Bids below the floor price are rejected
  • In case of a tie (multiple DSPs bid the same amount), the winner is picked randomly

​
Multi-bid responses

You may return multiple seatbid entries and multiple bid[] per seatbid in a single BidResponse — useful when your DSP fronts several buyers or evaluates several creatives per opportunity. The SSP handles multi-bid responses in two stages:
  1. In-response pick. Across every bid in your response, the SSP selects the highest-priced bid as your DSP’s representative for the cross-DSP auction. Ties are broken by first-encountered (stable). Bids with bid.cur set to anything other than "USD" or with no price are dropped before this step.
  2. Cross-DSP auction. All representatives — one per DSP — are entered into a first-price auction. Highest price wins.

​
Loss notifications across both stages

Every bid that does not become the final auction winner receives an lurl GET (when set on the bid). The code says why: 102 (“lost to higher bid”) for a valid bid that was outbid, 100 for a bid under imp.bidfloor, 3 for a response the SSP could not use, and 205 / 209 / 215 for a blocked advertiser, category or app. Loss notices fire even when the auction had no winner, so a DSP priced out on every bid is told so rather than left in silence. This means even when your DSP wins the overall auction, the other bids you submitted in the same response still get a loss notice — they lost inside your own seatbid pick. This lets pacing/learning systems treat every submitted bid uniformly. See the Bid API reference for the full code table and the exact condition behind each code.

​
Buyer seat (seatbid[].seat)

If your DSP fronts multiple buyers (agencies, advertisers, trading desks), populate seatbid[].seat with the buyer id. The winning bid’s seat is recorded in Thrad analytics and surfaced per impression — useful for slicing revenue and quality metrics by buyer rather than only by DSP. If you have no seat concept, omit it or send empty.

​
Pricing & Commission

​
Bid Rounding

Bids should be specified with 2 decimal places (e.g., 7.50, 12.34). If you submit a bid with more than 2 decimals, the SSP will automatically round it using ROUND_HALF_UP — the standard “round half away from zero” rule:
  • 7.125 → 7.13
  • 7.135 → 7.14
  • 7.145 → 7.15
Bid values below the 2nd decimal that are not exactly .5 round normally (7.124 → 7.12, 7.126 → 7.13).

​
SSP Commission

Commission Rate: 10% of your bid
  • The SSP takes a 10% commission directly from your bid
  • Your actual payout is bid amount × 0.90
  • Commission is deducted before payment reaches the advertiser
  • The floor price check is on the gross bid (before commission)
  • On supply Thrad resells from another exchange, imp.bidfloor is already grossed up to cover that exchange’s floor: a bid at or above it always clears
Example:
  • You bid: $10.00 CPM
  • SSP commission (10%): $1.00
  • Net to advertiser: $9.00 CPM

​
Timeouts

Your endpoint must respond within strict time limits:

​
Payment and Billing

At the end of each calendar month, Thrad will send you an invoice for the amount due based on your winning bids.

​
How It Works

  1. Monthly Calculation: We calculate the gross value of your winning bids for the calendar month
  2. Invoice: You are invoiced that gross amount
  3. Commission: Thrad retains the 10% SSP commission from it and pays the publisher the remaining 90%
  4. Payment: Payment terms will be agreed upon during integration setup
Example:
  • Total winning bids for the month: $10,000
  • Your invoice: $10,000
  • Thrad commission (10%): $1,000
  • Publisher receives: $9,000
The invoice will include detailed reporting of all winning auctions, impressions, and any applicable adjustments.