Bid Request Samples
Complete bodies you can post at rtb.adon3-ads.com as they stand. Each one is
valid against the reference on Bid Request and carries
the four fields adon3 requires: id, device.ua, an address in device.ip or
device.ipv6, and site.domain or app.bundle.
All four declare x-openrtb-version: 2.6. Under 2.5, drop the fields marked
2.6 in the reference and everything else stands.
Banner on mobile web
A 300x250 above the fold, with a declared supply chain.
JSON
{
"id": "8f2a1c30-6b4e-4d9a-9f11-2c7e3b5a8d40",
"at": 2,
"tmax": 200,
"cur": ["USD"],
"test": 0,
"cattax": 2,
"imp": [
{
"id": "1",
"tagid": "hdr-300x250-atf",
"bidfloor": 0.45,
"bidfloorcur": "USD",
"secure": 1,
"banner": {
"format": [{ "w": 300, "h": 250 }, { "w": 320, "h": 250 }],
"pos": 1,
"mimes": ["image/jpeg", "image/png"],
"battr": [1, 3],
"topframe": 1
}
}
],
"site": {
"id": "s-4471",
"name": "Example Gazette",
"domain": "gazette.example.com",
"page": "https://gazette.example.com/markets/open-exchange",
"cat": ["IAB13"],
"publisher": {
"id": "p-90ab12cd",
"name": "Example Media Group",
"domain": "example.com"
}
},
"device": {
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15",
"ip": "203.0.113.44",
"devicetype": 4,
"make": "Apple",
"model": "iPhone",
"os": "iOS",
"osv": "17.4",
"language": "en",
"connectiontype": 2,
"js": 1,
"geo": { "country": "USA", "region": "NY", "city": "New York", "type": 2 }
},
"user": {
"id": "u-3d9f7a2b6c1e",
"buyeruid": "abc123xyz"
},
"source": {
"fd": 1,
"tid": "t-1a9c44f0",
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [
{ "asi": "example-ssp.com", "sid": "4471", "hp": 1, "rid": "8f2a1c30" }
]
}
},
"regs": { "coppa": 0 },
"bcat": ["IAB25", "IAB26"],
"badv": ["competitor.example"]
}
Video pre-roll
A skippable in-stream pre-roll. plcmt is the 2.6 placement field; placement
is still read when you send 2.5.
JSON
{
"id": "b41d7e08-2f56-4a13-89cc-51f0a9d3e772",
"at": 2,
"tmax": 250,
"cur": ["USD"],
"imp": [
{
"id": "1",
"tagid": "preroll-main",
"bidfloor": 8.5,
"bidfloorcur": "USD",
"secure": 1,
"video": {
"mimes": ["video/mp4", "video/webm"],
"minduration": 5,
"maxduration": 30,
"protocols": [2, 3, 5, 6, 7, 8],
"w": 1280,
"h": 720,
"startdelay": 0,
"plcmt": 1,
"linearity": 1,
"skip": 1,
"skipafter": 5,
"playbackmethod": [1],
"playbackend": 1,
"delivery": [2],
"pos": 7,
"api": [2],
"battr": [13, 14]
}
}
],
"site": {
"id": "s-6620",
"domain": "video.example.com",
"page": "https://video.example.com/watch/44812",
"cat": ["IAB1-7"],
"content": {
"id": "c-44812",
"title": "Market Open",
"genre": "news",
"livestream": 0,
"len": 480,
"language": "en"
},
"publisher": { "id": "p-90ab12cd", "domain": "example.com" }
},
"device": {
"ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"ipv6": "2001:db8:85a3::8a2e:370:7334",
"devicetype": 2,
"os": "macOS",
"language": "en",
"connectiontype": 2,
"w": 2560,
"h": 1440,
"geo": { "country": "GBR", "region": "ENG", "city": "London", "type": 2 }
},
"source": {
"fd": 1,
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [{ "asi": "example-ssp.com", "sid": "6620", "hp": 1 }]
}
},
"regs": { "gdpr": 1 }
}
Native in-feed
Note that imp.native.request is a JSON-encoded string, not a nested object.
JSON
{
"id": "c9e3a761-40b8-4f22-9d0e-7b1c85af3021",
"at": 2,
"tmax": 200,
"cur": ["USD"],
"imp": [
{
"id": "1",
"tagid": "feed-native-1",
"bidfloor": 1.2,
"bidfloorcur": "USD",
"secure": 1,
"native": {
"ver": "1.2",
"request": "{\"ver\":\"1.2\",\"context\":1,\"plcmttype\":4,\"plcmtcnt\":1,\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":90}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":600,\"hmin\":400}},{\"id\":3,\"required\":0,\"data\":{\"type\":2,\"len\":140}}]}",
"battr": [1, 3]
}
}
],
"site": {
"id": "s-4471",
"domain": "gazette.example.com",
"page": "https://gazette.example.com/markets",
"publisher": { "id": "p-90ab12cd", "domain": "example.com" }
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36",
"ip": "203.0.113.90",
"devicetype": 4,
"make": "Google",
"model": "Pixel 8",
"os": "Android",
"osv": "14",
"connectiontype": 6,
"geo": { "country": "USA", "type": 2 }
},
"source": {
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [{ "asi": "example-ssp.com", "sid": "4471", "hp": 1 }]
}
},
"regs": { "us_privacy": "1YNN" }
}
In-app banner with a deal
A private auction, so only the listed deal may transact and an open-market bid does not compete.
JSON
{
"id": "d7b02f95-8c41-4e6a-b3d8-90fe2c714a63",
"at": 2,
"tmax": 200,
"cur": ["USD"],
"imp": [
{
"id": "1",
"tagid": "app-320x50-bottom",
"bidfloor": 2.0,
"bidfloorcur": "USD",
"secure": 1,
"instl": 0,
"rwdd": 0,
"displaymanager": "example-sdk",
"displaymanagerver": "6.4.0",
"banner": {
"format": [{ "w": 320, "h": 50 }],
"pos": 3,
"battr": [1]
},
"pmp": {
"private_auction": 1,
"deals": [
{ "id": "deal-77c40e", "bidfloor": 4.5, "bidfloorcur": "USD", "at": 1 }
]
}
}
],
"app": {
"id": "a-8812",
"name": "Example Reader",
"bundle": "com.example.reader",
"domain": "example.com",
"storeurl": "https://play.google.com/store/apps/details?id=com.example.reader",
"ver": "4.2.1",
"cat": ["IAB13"],
"paid": 0,
"publisher": { "id": "p-90ab12cd", "domain": "example.com" }
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 13; SM-G991B) AppleWebKit/537.36",
"ip": "192.0.2.201",
"devicetype": 4,
"make": "Samsung",
"model": "SM-G991B",
"os": "Android",
"osv": "13",
"ifa": "38400000-8cf0-11bd-b23e-10b96e40000d",
"lmt": 0,
"connectiontype": 5,
"geo": { "country": "DEU", "type": 2 }
},
"user": { "buyeruid": "xyz987abc" },
"source": {
"fd": 1,
"schain": {
"complete": 1,
"ver": "1.0",
"nodes": [
{ "asi": "example-ssp.com", "sid": "8812", "hp": 1 },
{ "asi": "reseller.example", "sid": "R-114", "hp": 1 }
]
}
},
"regs": { "gdpr": 1, "coppa": 0 }
}
Next: Bid Response Samples.