Prebid / 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) |
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"
}]
}]
}
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\" \/>
Banner: HTML
<html><a href=\"http:\/\/www.examplesite.com\" target=\"_blank\"><img src =\"https:\/\/examplesite.com:8443\/image\/336x280.jpg\" \/><\/a><\/html><img src=\"https:\/\/sitedomain.com\/cimp.php?data=TVRZeE56STJPVGcyTjN3ME56SXlaV1k0T1RGbU1tVTRNR1l6WlRZMVlqSTBOamt5WW1WaVl6SmxOdy0tfHxodHRwc3wxMC40Mi4wLjF8WFhYfDQxfGJiYWtpcmUuY29tfDQzMjQzN3w0NDYwNzV8Nzc2MTg2fDQwNjg1Njl8NTA4fDQxMzk4MDl8NDUzMDgzOTd8MTF8Mnw0M3wwfDB8MTExMXwzNDAuNjg2NDgzMjh8OTB8VVNEfFVTRHwxfDF8MjF8MzAweDI1MHwxfHx8MTh8MnwxfHw1NzU5MmYzMzNmODk4My4wNDM1ODcxNjIyODI0MTUwNjV8NjU1OGM0ZGZiMzk1N2E5OTQ1ODQ2YzNjYzMxMTFmY2N8MXwwfHNpdGVkb21haW4uY29tfDB8MHwwfDAuODJ8MXwwfGV4Y2hhbmdlX2Jhbm5lcnwwfDB8MHwtMXwzMjd8MHx8fDB8MHx8MHwyMjIyfDMzMzN8ODd8MHwwfDF8T0t8YjM0ODBiZjNkYjIwMzFjYmY5ZWZhMjE3NzM5MDE0NWY-\" width=\"1\" height=\"1\" border=\"0\" \/>
Banner: iFrame
<iframe src=\"https:\/\/examplesite.com\/testReturnMock.php?click_url=https:\/\/sitedomain.com\/click.php?data=H4sIAAAAAAAAA0WPy2oDMQxFfyWb2RrbkvxYtoRsSin0B4LH42mGeYV5QAr6.CpDIZK9kK98dYQGYiDDpI3l27bd1wreKnuRM6Yp_ZSxTJsqj9Ssaplzv4qwlXX7Ltu.TJ_you63ewWXPHS5v.7LUMG58u.v0p8r68pjvuauEQ3_B7KRYOOMt16bELiuU98tReV5ZKMVWqWVYSTQASEyahfIRQENzGjYigFrRmDQ.mFJs7gxk6doWwBoQwygNAIFb5y1waIh7Uj.OKKQsWlriORTjEgBXYacQZDanPlpvHZbaeYxddNBpI88DV0ry_8O5XTbx3lfTnw0v5LlGiG0EiwYwMEfgvDy1wdj8m1qnA9NyRZjzM.5VJMtPoBA_QF2muRLkAEAAA--;&exo_cid=4139851\" width=\"300\" height=\"250\" marginwidth=\"0\" marginheight=\"0\" frameborder=\"0\" sandbox=\"allow-pointer-lock allow-same-origin allow-popups allow-forms allow-scripts\" ><\/iframe><img src=\"https:\/\/sitedomain.com\/cimp.php?data=TVRZeE56STNNREU0T0h3d1lUTXhNRE01WWpneU9USm1aR015TldJM05EUTVNak00TWpabVlUZ3lZdy0tfHxodHRwc3wxMC40Mi4wLjF8WFhYfDQxfGJiYWtpcmUuY29tfDQzMjQzN3w0NDYwNzV8Nzc2MTg2fDQwNjg1Njl8NTA4fDQxMzk4NTF8NDUzMDg0Mzl8MTF8Mnw0M3wwfDB8MTExMXw1MDEyfDkwfFVTRHxVU0R8MXwxfDIxfDMwMHgyNTB8MXx8fDE4fDJ8MXx8NTc1OTJmMzMzZjg5ODMuMDQzNTg3MTYyMjgyNDE1MDY1fDY1NThjNGRmYjM5NTdhOTk0NTg0NmMzY2MzMTExZmNjfDF8MHxzaXRlZG9tYWluLmNvbXwwfDB8MHwwLjc2fDF8MHxleGNoYW5nZV9iYW5uZXJ8MHwwfDB8LTF8OTJ8MHx8fDB8MHx8MHwyMjIyfDMzMzN8ODd8MHwwfDF8T0t8NGEzNmVkMzJlOTA0NWNmYmIzNTJhYTc3OWM0Yjg5NjA-\" width=\"1\" height=\"1\" border=\"0\" \/>
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.