Bid§4.2.3 · Bid Response

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	Type	Description
id required	string	Bidder generated bid ID to assist with logging/tracking.
impid required	string	ID of the Imp object in the related bid request.
price required	float	Bid price expressed as CPM although the actual transaction is for a unit impression only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).
nurl	string	Win notice URL called by the exchange if the bid wins (not necessarily indicative of a delivered, viewed, or billable ad); optional means of serving ad markup. Substitution macros (Section 4.4) may be included in both the URL and optionally returned markup.
burl	string	Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., typically delivered, viewed, etc.). Substitution macros (Section 4.4) may be included.
lurl	string	Loss notice URL called by the exchange when a bid is known to have been lost. Substitution macros (Section 4.4) may be included. Exchange-specific policy may preclude support for loss notices or the disclosure of winning clearing prices resulting in ${AUCTION_PRICE} macros being removed (i.e., replaced with a zero-length string).
adm	string	Optional means of conveying ad markup in case the bid wins; supersedes the win notice if markup is included in both. Substitution macros (Section 4.4) may be included.
adid	string	ID of a preloaded ad to be served if the bid wins.
adomain	string[]	Advertiser domain for block list checking (e.g., "ford.com"). This can be an array of for the case of rotating creatives. Exchanges can mandate that only one domain is allowed.
bundle	string	A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is a numeric ID.
iurl	string	URL without cache-busting to an image that is representative of the content of the campaign for ad quality/safety checking.
cid	string	Campaign ID to assist with ad quality checking; the collection of creatives for which iurl should be representative.
crid	string	Creative ID to assist with ad quality checking.
tactic	string	Tactic ID to enable buyers to label bids for reporting to the exchange the tactic through which their bid was submitted. The specific usage and meaning of the tactic ID should be communicated between buyer and exchanges a priori.
cat	string[]	IAB content categories of the creative. Refer to List 5.1.
attr	integer[]	Set of attributes describing the creative. Refer to List 5.3. Enum Creative Attributes · 24 values 1Audio Ad (Autoplay) 2Audio Ad (User Initiated) 3Expandable (Automatic) 4Expandable (User Initiated - Click) 5Expandable (User Initiated - Rollover) 6In-Banner Video Ad (Autoplay) 7In-Banner Video Ad (User Initiated) 8Pop (e.g., Over, Under, or Upon Exit) 9Provocative or Suggestive Imagery 10Shaky, Flashing, Flickering, Extreme Animation, Smileys 11Surveys 12Text Only 12 more values in the enumerations overview →
api	integer	API required by the markup if applicable. Refer to List 5.6.
protocol	integer	Video response protocol of the markup if applicable. Refer to List 5.8. Enum Creative Subtypes - Audio/Video · 16 values 1VAST 1.0 2VAST 2.0 3VAST 3.0 4VAST 1.0 Wrapper 5VAST 2.0 Wrapper 6VAST 3.0 Wrapper 7VAST 4.0 8VAST 4.0 Wrapper 9DAAST 1.0 10DAAST 1.0 Wrapper 11VAST 4.1 12VAST 4.1 Wrapper 4 more values in the enumerations overview →
qagmediarating	integer	Creative media rating per IQG guidelines. Refer to List 5.19. Enum Media Ratings · 3 values 1All Audiences 2Everyone Over Age 12 3Mature Audiences
language	string	Language of the creative using ISO-639-1-alpha-2. The non-standard code "xx" may also be used if the creative has no linguistic content (e.g., a banner with just a company logo).
dealid	string	Reference to the deal.id from the bid request if this bid pertains to a private marketplace direct deal.
w	integer	Width of the creative in device independent pixels (DIPS).
h	integer	Height of the creative in device independent pixels (DIPS).
wratio	integer	Relative width of the creative when expressing size as a ratio. Required for Flex Ads.
hratio	integer	Relative height of the creative when expressing size as a ratio. Required for Flex Ads.
exp	integer	Advisory as to the number of seconds the bidder is willing to wait between the auction and the actual impression.
ext	object	Placeholder for bidder-specific extensions to OpenRTB.

Field descriptions reconciled against the official 2.6 draft; 2.5-specific fields come from a third-party Go implementation source (Apache 2.0), proofread against the official PDF · first-draft proofreading