Prebid / Open RTB 2.5 Bid Response

The response for a bid request will have the following structure:

Bid Response Object

AttributeRequired?Description
idYesID of the bid request (string)
seatbidYesCollection of bids made by the bidder on behalf of a specific seat.

 

seatbid

AttributeRequired?Description
bidYesID of the impression object to which this bid applies (string)

 

seatbid.bid

AttributeRequired?Description
idYesID for the bid object chosen by the bidder (string)
impidYesID of the impression object to which this bid applies (string)
priceYesBid price in CPM or CPC (float)
admYesEXADS XML/JSON Ad Markup (string)
nurlNoWin notification URL (string)
burlNoBilling notification URL. Called server-to-server when the impression or click becomes billable (CPM or CPC, per the btype field), so it can be counted from the billable event instead of the pixel. (string)
cidNoCampaign ID to assist with ad quality checking (string)
cridNoCreative ID to assist with ad quality checking (string)
extNoEXADS specific extension (object)

 

seatbid.bid.ext

AttributeRequired?Description
btypeRecommendedPricing 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.  

Billing Notification

When the parameter Bid Response Object -> Seat Bid Object -> Bid Object -> burl is in the bid response, a GET request is performed to that URL when the impression or click becomes billable (CPM or CPC, per the btype field). This allows the impression or click to be counted from the billable event rather than from pixel-based tracking.

If both nurl and burl are present, both should be called.  

← Prebid / Open RTB 2.5 Bid RequestEXADS RTB Integration →