Prebid / Open RTB 2.5 Bid Response

Posted10th February 2023

Updated10th February 2023

ByParadox

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	Paradox 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	Paradox 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": "<PARADOX_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.