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 interpreted response from the bidder server for each bid request.
| 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 |
bid | Array of Objects; required | The Bid Object. |
Bid object
| Field | Type | Description |
|---|
adid | String; optional | TBD |
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. |
cat | Array of Strings; optional | The IAB Category of the Advertiser. |
cid | String; optional | TBD |
crid | String; optional | The unique Creative ID |
dealid | String; optional | A unique identifier to represent a deal. |
cur | string; required | The currency of the bid response. For more information, see List of currencies. |
w | Integer; required | Width of the creative in device-independent pixels. |
h | Integer; required | Height of the creative in device-independent pixels. |
mediatype | String; required | One of: banner, video. |
adm | String; required | The actual ad markup: XHTML if responding to a Banner Object; VAST URL if responding to a Video Object. |
meta | Object; required | The Meta Object. |
burl | String; required | The billing notice URL. |
dsp_id | String; required | The DSP id. |
| Field | Type | Description |
|---|
advertiserDomains | Array of strings; required | |
ext | Object; optional | Meta Ext Object |
This object is an arbitrary JSON with reserved fields.
The field app is reserved for the App Object.
The field win_notice_ext is reserved for the Win Notice Ext Object. It is used to pass extra data to the win notice.
| Field | Type | Description |
|---|
app | Object; optional | The App Object |
inventory_source | String; optional | The inventory source |
dsp_auction_id | String; optional | The auction id of the DSP auction. |
win_notice_ext | Object; optional | The Win Notice Ext Object |
App Object
| Field | Type | Description |
|---|
app_bundle | String; optional | The id of the App Bundle on the App Store |
app_id | String; optional | The AIDEM generated App ID |
app_name | String; optional | The name of the App |
app_store_url | String; optional | The store url or the App |
