Documentation

Documentation

  • General
  • Advertisers
  • Publishers
  • RTB
  • API
  • News

›Advertisers

Advertisers

  • Advertisers RTB Overview
  • Open RTB

    • Open RTB Integration
    • Open RTB Bid Request
    • Open RTB Bid Response
    • Prebid / OpenRTB 2.5 Bid Request
    • Prebid / OpenRTB 2.5 Bid Response

    EXADS RTB

    • EXADS RTB Integration
    • EXADS RTB Bid Request
    • EXADS RTB Bid Response

Publishers

  • Publishers RTB Overview
  • Open RTB

    • Open RTB Integration
    • Open RTB Bid Request
    • Open RTB Bid Response

    EXADS RTB

    • EXADS RTB Integration
    • EXADS RTB Bid Request
    • EXADS RTB Bid Response

IP Networks

  • IP Networks

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

 

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 for Advertisers →
  • Bid Response Object
    • seatbid
    • seatbid.bid
    • seatbid.bid.ext
  • JSON Examples
    • Banner (Stored Request): JSON
  • ADM Examples
    • Banner: HTML
  • No Bid Response
Documentation
Community
Github
Useful Links
EXADS
Copyright © 2021 EXADS