Prebid / OpenRTB 2.5 Bid Response

Note: The Prebid / OpenRTB 2.5 Bid Response will work with both Prebid and standard OpenRTB 2.5. You can read more about Prebid Server here.

 

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

Bid Response Object

AttributeRequired?Description
idYesID of the bid request, must match id sent in the 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, must match id sent in the request (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)
admYesAd markup (string)
nurlNoWin notification URL, it is recommended to use HTTP over HTTPS for nurl (string) - not mandatory
burlNoBilling notification URL, called by EXADS 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. Recommended to use HTTP over HTTPS for burl (string)
extNoEXADS specific extension (object)

 

seatbid.bid.ext

AttributeRequired?Description
btypeRecommendedPricing Model. Values: 1 = CPM, 2 = CPC. Default = 1 (int). Note: When response is for an Email Clicks zone request, 1 = Smart CPC.

 

JSON Examples

Banner (Stored Request): JSON

{
    "id": "c1218af9-65fc-4d55-9ad6-8795c2daad25",
    "seatbid": [
        {
            "bid": [
                {
                    "id": "7565485375107751077",
                    "impid": "some-impression-id",
                    "price": 17.076291896620397,
                    "adm":"<html><a href=\"http://www.rubicon.com\" target=\"_blank\"><img src =\"https://stagingva.rubicon.com:8443/image/300x250.jpg\" /></a></html>",
                    "adid": "266959495",
                    "adomain": [
                        "https://www.tudublin.ie"
                    ],
                    "iurl": "https://fra1-ib.adnxs.com/cr?id=266959495",
                    "cid": "1212",
                    "crid": "266959495",
                    "w": 300,
                    "h": 250,
                    "ext": {
                        "prebid": {
                            "targeting": {
                                "hb_bidder": "asqClassic",
                                "hb_bidder_asqClassic": "asqClassic",
                                "hb_pb": "17.00",
                                "hb_pb_asqClassic": "17.00",
                                "hb_size": "300x250",
                                "hb_size_asqClassic": "300x250"
                            },
                            "type": "banner",
                            "video": {
                                "duration": 0,
                                "primary_category": ""
                            }
                        },
                        "bidder": {
                            "appnexus": {
                                "brand_id": 791377,
                                "auction_id": 3048506780519985986,
                                "bidder_id": 101,
                                "bid_ad_type": 0
                            }
                        }
                    }
                }
            ],
            "seat": "asqClassic"
        },
        {
            "bid": [
                {
                    "id": "613673EF-A07C-4486-8EE9-3FC71A7DC73D",
                    "impid": "some-impression-id",
                    "price": 3.2940788932,
                    "adm": "<html><a href=\"http://www.pubmatic.com\" target=\"_blank\"><img src =\"https://stagingva.pubmatic.com:8443/image/336x280.jpg\" /></a></html>",
                    "adomain": [
                        "www.addomain.com"
                    ],
                    "iurl": "http://localhost11",
                    "crid": "FP_336x280_00",
                    "w": 336,
                    "h": 280,
                    "ext": {
                        "prebid": {
                            "targeting": {
                                "hb_bidder_pubmatic": "pubmatic",
                                "hb_pb_pubmatic": "3.25",
                                "hb_size_pubmatic": "336x280"
                            },
                            "type": "banner",
                            "video": {
                                "duration": 0,
                                "primary_category": ""
                            }
                        },
                        "bidder": {
                            "dspid": 6,
                            "BidType": 0
                        }
                    }
                }
            ],
            "seat": "pubmatic"
        }
    ],
    "cur": "EUR"
}

 

ADM Examples

The examples below shows example of the HTML used in this ADM parameter.  

Banner: HTML

<html><a href=\"http://www.examplesite.com\" target=\"_blank\"><img src =\"https://stagingva.pubmatic.com:8443/image/336x280.jpg\" /></a></html>

 

No Bid Response

To answer a bid request without making an actual bid, an HTTP response code 204 "No Content" should be sent.

 

Billing Notification

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

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

← Prebid / OpenRTB 2.5 Bid RequestEXADS RTB Integration →