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)
admYesHTML (string)
nurlNoWin notification URL, it is recommended to use HTTP over HTTPS for nurl (string) - not mandatory
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.

 

← Prebid / OpenRTB 2.5 Bid RequestEXADS RTB Integration →