SeatBid Object
A bid response can contain multiple SeatBid objects, each on behalf of a different bidder seat and each containing one or more individual bids. If multiple impressions are presented in the request, the group attribute can be used to specify if a seat is willing to accept any impressions that it can win or if it is only interested in winning any if it can win them all as a group.
Attribute | Triplelift Required | Type | Description |
---|---|---|---|
bid | yes | array of objects | Array of 1+ Bid objects each related to an impression. Multiple bids can relate to the same impression |
seat | no | string | ID of the buyer seat on whose behalf this bid is made |
group | no | integer | 0 = impressions can be won individually; 1 = impressions must be won or lost as a group |
ext | no | object | Placeholder for bidder-specific extensions to OpenRTB |
Bid Object
A SeatBid object contains one or more Bid objects, each of which relates to a specific impression in the bid request via the impid attribute and constitutes an offer to buy that impression for a given price.
Attribute | Triplelift Required | Type | Description |
---|---|---|---|
id | yes | string | Bidder generated bid ID to assist with logging/tracking |
impid | yes | string | ID of the Imp object in the related bid request |
price | yes | float | Bid price expressed as CPM although the actual transaction is for a unit impression only |
adid | no | string | ID of a preloaded ad to be served if the bid wins |
nurl | no | string | Win notice URL called by the exchange if the bid wins |
burl | no | string | Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy |
lurl | no | string | Loss notice URL called by the exchange when a bid is known to have been lost |
adm | no | string | Optional means of conveying ad markup in case the bid wins |
adomain | no | array of strings | Advertiser domain for blocklist checking |
bundle | no | string | A platform-specific application identifier intended to be unique to the app and independent of the exchange |
iurl | no | string | URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking |
cid | no | string | Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative |
crid | no | string | Creative ID to assist with ad quality checking |
cat | no | array of strings | IAB content categories of the creative |
attr | no | array of integers | Set of attributes describing the creative |
dealid | no | string | Reference to deal.id from the bid request if this bid pertains to a private marketplace direct deal |
w | no | integer | Width of the creative in device independent pixels |
h | no | integer | Height of the creative in device independent pixels |
language | no | string | Language of the creative using ISO-639-1-alpha-2 |
exp | no | integer | Advisory as to the number of seconds the bidder is willing to wait between the auction and the actual impression |
ext | no | object | Placeholder for bidder-specific extensions to OpenRTB |
Updated over 1 year ago