Open RTB 2.5 Bid Response
The response for a bid request will have the following structure:
Bid Response Object
Attribute | Required? | Description |
---|---|---|
id | Yes | ID of the bid request (string) |
seatbid | Yes | Collection of bids made by the bidder on behalf of a specific seat. |
seatbid
Attribute | Required? | Description |
---|---|---|
bid | Yes | ID of the impression object to which this bid applies (string) |
seatbid.bid
Attribute | Required? | Description |
---|---|---|
id | Yes | ID for the bid object chosen by the bidder (string) |
impid | Yes | ID of the impression object to which this bid applies (string) |
price | Yes | Bid price in CPM or CPC (float) |
adm | Yes | EXADS XML/JSON Ad Markup (string) |
nurl | No | Win notification URL (string) |
cid | No | Campaign ID to assist with ad quality checking (string) |
crid | No | Creative ID to assist with ad quality checking (string) |
adid | No | Ad ID to assist with ad quality checking (same as crid) (string) |
adomain | No | Advertiser domain, or exchange domain (array of strings) |
cat | Yes | IAB content categories of the creative (string array) |
w | No | Width of creative (integer) |
h | No | Height of creative (integer) |
ext | No | EXADS specific extension (object) |
seatbid.bid.ext
Attribute | Required? | Description |
---|---|---|
btype | Recommended | Pricing Model. Values: 1 = CPM, 2 = CPC. Default = 1 (int). |
JSON Examples
Banner: JSON
{
"id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
"seatbid": [{
"bid": [{
"id": "1737294d31e606ef366cbf9fd30ca409c8819978",
"impid": "974090632",
"price": 0.55,
"adm": "<EXADS_XML_OR_JSON_OR_HTML_AD_MARKUP>",
"ext": {
"btype": 1
},
"nurl": "http:\/\/network-domain.com\/not.php?zid=4068569&data=TVRZeE56STJOekl3T1h3ek9UVTROMkUyWmpObE16bGxObUZsTTJVek5UZ3lNakF6T0RBMVpUTXpaZy0tfDIwMjEtMDQtMDEgMDQ6NTM6Mjl8MTAuNDIuMC4xfFhYWHw0MXxiYmFraXJlLmNvbXw0MzI0Mzd8NDQ2MDc1fDc3NjE4Nnw0MDY4NTY5fDUwOHw0MTM5ODQ3fDQ1MzA4NDM1fDExfDJ8NDN8MHwwfDExMTF8MHwwfFVTRHxVU0R8MXwxfDIxfDMwMHgyNTB8MXxYWFh8fDE4fDJ8MXx8NTc1OTJmMzMzZjg5ODMuMDQzNTg3MTYyMjgyNDE1MDY1fDY1NThjNGRmYjM5NTdhOTk0NTg0NmMzY2MzMTExZmNjfHNpdGVkb21haW4uY29tfDB8MHwwfDB8ZDRiNWM2OTctNDFmMy00YzFjLWEzZDUtNWZkMDFiNWVmMmFhfDB8MTAyMHwwfFdJTk5FUnx8MXwwLjV8MHwwfDJ8MHwwfDB8MHwtMXwwfDB8fHx8MHwyMjIyfDMzMzN8fHx8ODd8MHwwfDEwfE9LfDUxNGE0MmQ5ZDgwZWY5OGQ4MTRmMzM2YmQyMzgwYjYw",
"cid" : "123456",
"crid" : "22334455",
"adid" : "22334455",
"adomain" : ["wwww.advertiser.com"],
"w" : 300,
"h" : 250
}]
}]
}
Full Page Interstitial: JSON
{
"id": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
"seatbid": [
{
"bid": [
{
"id": "6cf48ee722a1a7b27f954fc87c6bd5dc7fcef269",
"impid": "974090632",
"price": 0.05,
"adm": "<URL_AD_MARKUP>",
"ext": {
"btype": 1
},
"nurl": "https://mysite.com/my_notification_url",
"iurl": "https://mysite.com/my_image.jpg",
"cid": "7562017",
"crid": "195600_115116297",
"adid": "115116297",
"cat": [],
"adomain": ["www.exads.com"],
"w": 1600,
"h": 900,
"attr": []
}
]
}
],
"bidid": "d4b5c697-41f3-4c1c-a3d5-5fd01b5ef2aa",
"cur": "EUR"
}
ADM Examples
Banner: HTML (a tag)
<a href=\"https:\/\/sitedomain.com\/click.php?data=H4sIAAAAAAAAA0WOO27DQAxEr6LG7YLf_ZRp0qTIGVarFSzEtgJZhh2Ahw.jJjNkRc7gCXLJkkwB7Lzv3_cTv53o3ef5fIblNvVXOG9m6DKMmCgmgmLjWL.WrYe2Xg0hCAUIaKIMWVhNIGaNxWuzmaCRFxiYsDHAixTM28w0aaGZmedcMgfwaE4YiTIJKkT1TFTNTaZ55KKpliKaJTZujR1pbs3.iu_L3qf1WpfbQQSHh8sy9_v.c.nD.XFdH9tgx_O_zRedkFzmGGw5HQfntc8P40I6TalC6dgrjyipdaxjS5hkAvoFeR9FKz4BAAA-\" target=\"_blank\" ontouchstart=\"\" onclick=\"var href='https:\/\/sitedomain.com\/click.php?data=H4sIAAAAAAAAA0WOO27DQAxEr6LG7YLf_ZRp0qTIGVarFSzEtgJZhh2Ahw.jJjNkRc7gCXLJkkwB7Lzv3_cTv53o3ef5fIblNvVXOG9m6DKMmCgmgmLjWL.WrYe2Xg0hCAUIaKIMWVhNIGaNxWuzmaCRFxiYsDHAixTM28w0aaGZmedcMgfwaE4YiTIJKkT1TFTNTaZ55KKpliKaJTZujR1pbs3.iu_L3qf1WpfbQQSHh8sy9_v.c.nD.XFdH9tgx_O_zRedkFzmGGw5HQfntc8P40I6TalC6dgrjyipdaxjS5hkAvoFeR9FKz4BAAA-'; this.href = href + '&clickX=' + event.clientX + '&clickY=' + event.clientY;\"><img width=\"300\" height=\"250\" src=\"https:\/\/sitedomain.com\/library\/432437\/c506e8224d74d30b946f3398fe7bf9f90a9bf5ec.jpg\" border=\"0px\" style=\"\"><\/a><img src=\"https:\/\/sitedomain.com\/cimp.php?data=TVRZeE56STJOekl3T1h3ek9UVTROMkUyWmpObE16bGxObUZsTTJVek5UZ3lNakF6T0RBMVpUTXpaZy0tfC9saWJyYXJ5LzQzMjQzNy9jNTA2ZTgyMjRkNzRkMzBiOTQ2ZjMzOThmZTdiZjlmOTBhOWJmNWVjLmpwZ3xodHRwc3wxMC40Mi4wLjF8WFhYfDQxfGJiYWtpcmUuY29tfDQzMjQzN3w0NDYwNzV8Nzc2MTg2fDQwNjg1Njl8NTA4fDQxMzk4NDd8NDUzMDg0MzV8MTF8Mnw0M3wwfDB8MTExMXw1MDB8OTB8VVNEfFVTRHwxfDF8MjF8MzAweDI1MHwxfHx8MTh8MnwxfHw1NzU5MmYzMzNmODk4My4wNDM1ODcxNjIyODI0MTUwNjV8NjU1OGM0ZGZiMzk1N2E5OTQ1ODQ2YzNjYzMxMTFmY2N8MXwwfHNpdGVkb21haW4uY29tfDB8MHwwfDEuMDJ8MXwwfGV4Y2hhbmdlX2Jhbm5lcnwwfDB8MHwtMXwwfDB8fHwwfDB8fDB8MjIyMnwzMzMzfDg3fDB8MHwxfE9LfDc0MDYzMzg1ZTIxYmMwNDU2NTNhNDU0ZTQ2ZjAxYjEx\" width=\"1\" height=\"1\" border=\"0\" \/>
Full Page Interstitial
https://sitedomain.com/fpi-render.php?data=TVRjME9UUTNPRGsxT0h3NE5qTmxNR1JoTnpNeVptSm1NalppTnpka1ptRTVOVFF6TkdVek1URmhZUS0tfGh0dHBzJTNBJTJGJTJGd3d3LmV4YWRzLmNvbXwvbGlicmFyeS8xOTU2MDAvYjQwMjg1ZDYyOGJhODJhNDllYmJiNTA0NDkyZmQzOTE2MGQ5MDAwNS5qcGd8aHR0cHN8MTAuNDIuMC4wfFhYWHw0MXx0aXRrb3NmbG9ydC5jb218MTk1NjAwfDE5NTYwMHw3MTkxNzR8NTYyMjk1OXw1MDh8NzU2MjAxN3wxMTUxMTYyOTd8MTV8MnwwfDB8MHwxMjIxfDEwfDUwfEVVUnxFVVJ8MXwxLjEyMTl8NDV8MTYwMHg5MDB8MXx8MTAuNDIuMC4xfHw0fDF8fGE1OTIwZTBjMWQ5YjM5NWU4Mjk5MTgxOGY4ODQ1ZjM2fDY1NThjNGRmYjM5NTdhOTk0NTg0NmMzY2MzMTExZmNjfDF8MHxzaXRlZG9tYWluLmNvbXwwfDB8MHwwLjA0fDF8MHxleGNoYW5nZV9kZXNrdG9wX2Z1bGxwYWdlX2ludGVyc3RpdGlhbHwwfHwwfC0xfDB8MHx8fDB8MHx8MHwwfDB8MHwwfDB8MXwwfHw4fDF8TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNTEuMC4yNzA0LjYzIFNhZmFyaS81MzcuMzZ8fDIxNjB8MzZ8MHwxfDB8fHw2M3wwfDAuMXwwLjF8NTB8MXwwfDB8cnRiLmV4b2NsaWNrLmV4YWRzLnJvY2tzfHx8fDEwfHwxNzQ5NDc4OTU4fHwgbGlmZXN0eWxlIGh1bW91ciB8fHwwfHwwfDB8MHwwfDB8aW1nX2Jhbm5lcnwwLjE3fDkzMWY5MmM0ZDc5MzEwYjE2NDljN2QwOWIzODBkYmFi&cb=e2e_6846ee2e491844.83333767
No Bid Response
To answer a bid request without making an actual bid, an HTTP response code 204 "No Content" will be sent.
Win Notification
When the parameter Bid Response Object -> Seat Bid Object -> Bid Object -> nurl is in the bid response, a GET request must be performed to such URL.