BidResponse
Your bidding API should respond with the parameters outlined below. Bid responses may contain multiple bids that correspond to a single impression.
BidResponse object
The top level Bid Response Object and accompanying fields are below, followed by each lower level object contained within it.
Field | Type | Description |
---|---|---|
id | String; required | A unique identifier for this request, as indicated in the id field of the Bid Request Object. Note: This must be equal to the value received in the bid request. |
bidid | String; optional | TBD |
cur | String; required | The currency of the bid response. For more information, see List of currencies. |
seatbid | Array of Objects; required | The Seat Bid Object. |
SeatBid object
Field | Type | Description |
---|---|---|
seat | String; required | Unique identifier for the agency (when multiple agencies or independent direct clients use a DSP). |
group | Integer; optional | TBD |
bid | Array of Objects; required | The Bid Object. |
Bid object
Field | Type | Description |
---|---|---|
adid | String; optional | TBD |
adomain | Array of Strings; required | The domain/landing page/brand to identify the advertiser; limited to 128 characters. |
adm | String; required | The actual ad markup: XHTML if responding to a Banner Object; VAST XML if responding to a Video Object. |
bundle | String; optional | The app name or bundle being advertised (e.g. com.foo.mygame ) if applicable; |
burl | String; required | The billing notice URL called by an exchange when a winning bid becomes billable based on publisher criteria (begin-to-render for web). Note: - It should contain the ${AUCTION_PRICE} notification macro and should be a part of a valid URL. - It may contain the ${AUCTION_PRICE} notification macro in both the burl and adm fields. However, only impressions tracked from burl are considered billable. |
cat | Array of Strings; optional | The IAB Category of the Advertiser. |
cid | String; optional | TBD |
crid | String; optional | TBD |
dealid | String; optional | A unique identifier to represent a deal. |
dsp_id | String; optional | Added by AIDEM after receiving the response. If sent it will be overwritten. |
h | Integer; required | Height of the creative in device-independent pixels. |
id | String; required | A unique identifier to represent this bid. |
impid | String; required | A unique identifier for this impression (indicated in the id field of the Impression Object); must be equal to the value received in the bid request. |
price | Float; required | The bid price represented as cost per thousand impressions (CPM). By default, bidding is in dollars represented as floating point numbers (for example, 2.71828 ). |
w | Integer; required | Width of the creative in device-independent pixels. |