OpenRTB 2.6 for DSPs
Overview
- /Protocol: OpenRTB 2.6, JSON over HTTPS POST to the endpoint you register with us.
- /Header X-Openrtb-Version: 2.6.
- /Auction type: first price (at = 1). The winning bid pays its own price, in USD CPM.
- /Timeout: at most 100 ms, bounded by the inbound tmax and processing margin. Responses after the deadline are dropped.
- /One impression per request (imp.id = "1"), banner only for now.
Bid request
POST https://your-dsp.example/bid
Content-Type: application/json
X-Openrtb-Version: 2.6
{
"id": "q1b8c0f6e2a94d7f",
"imp": [{
"id": "1",
"tagid": "AD_UNIT_ID",
"banner": { "w": 300, "h": 250, "format": [{ "w": 300, "h": 250 }] },
"bidfloor": 0.5,
"bidfloorcur": "USD",
"secure": 1
}],
"site": {
"id": "AD_UNIT_ID",
"domain": "publisher.example",
"page": "https://publisher.example/article",
"publisher": { "id": "PUBLISHER_ID" }
},
"device": { "ua": "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 Chrome/130.0 Mobile Safari/537.36", "ip": "203.0.113.7" },
"at": 1,
"tmax": 100,
"cur": ["USD"],
"source": { "tid": "q1b8c0f6e2a94d7f" }
}Bid response
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "q1b8c0f6e2a94d7f",
"seatbid": [{
"bid": [{
"impid": "1",
"price": 1.25,
"adm": "<a href=\"https://advertiser.example\" target=\"_blank\"><img src=\"https://cdn.example/300x250.jpg\" width=\"300\" height=\"250\"></a>",
"crid": "creative-42"
}]
}]
}Rules we apply
- /Return HTTP 200 with a JSON body to bid. Any other status (e.g. 204) means no bid.
- /Only bids with impid "1", a non-empty adm and price ≥ imp.bidfloor are considered. The highest valid bid across all DSPs and house demand wins.
- /adm is rendered as HTML inside a sandboxed iframe of the banner size (scripts and popups allowed, same-origin not).
- /Response bodies over 256 KB are ignored.
- /nurl is fired on a winning tag auction; burl is fired once on the rendered impression. For inbound SSP auctions, both are forwarded only after the SSP fires its corresponding notice. Test traffic suppresses notices and billing.
Getting connected
Apply on the partners page with your endpoint URL and regions. Endpoints are enabled manually.