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 | The store ID of the app in an app store (e.g., Apple App Store, Google Play). See OTT/CTV Store Assigned App Identification Guidelines for more details about expected strings for CTV app stores. For mobile apps in Google Play Store, these should be bundle or package names (e.g. com.foo.mygame). For apps in Apple App Store, these should be 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. |
| cattax default 1 | integer | The taxonomy in use. Refer to List: Category Taxonomies for values.Enum Category Taxonomies · 10 values1IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags. 2IAB Tech Lab Content Category Taxonomy 2.0: Deprecated, and recommend NOT be used since it does not have SCD flags. 3IAB Tech Lab Ad Product Taxonomy 1.0. 4IAB Tech Lab Audience Taxonomy 1.1 5IAB Tech Lab Content Taxonomy 2.1 6IAB Tech Lab Content Taxonomy 2.2 7IAB Tech Lab Content Taxonomy 3.0 8IAB Tech Lab Ad Product Taxonomy 2.0 9IAB Tech Lab Content Taxonomy 3.1 500+Vendor-specific codes. |
| cat | string[] | IAB Tech Lab content categories of the creative. The taxonomy to be used is defined by the cattax field. If no cattax field is supplied Content Taxonomy 1.0 is assumed |
| attr | integer[] | Set of attributes describing the creative. Refer to List: Creative Attributes in AdCOM 1.0.Enum Creative Attributes · 24 values1Audio 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 → |
| apis | integer[] | List of supported APIs for the markup. If an API is not explicitly listed, it is assumed to be unsupported. Refer to List: API Frameworks in AdCOM 1.0.Enum API Frameworks · 10 values1VPAID 1.0 2VPAID 2.0 3MRAID 1.0 4ORMMA 5MRAID 2.0 6MRAID 3.0 7OMID 1.0 8SIMID 1.0 9SIMID 1.1 500+Vendor-specific codes. |
| api deprecated | integer | NOTE: Deprecated in favor of apis. |
| protocol | integer | Video response protocol of the markup if applicable. Refer to List: Creative Subtypes - Audio/Video in AdCOM 1.0.Enum Creative Subtypes - Audio/Video · 16 values1VAST 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: Media Ratings in AdCOM 1.0.Enum Media Ratings · 3 values1All 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). Only one of language or langb should be present. |
| langb | string | Language of the creative using IETF BCP 47. Only one of language or langb should be present. |
| 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. |
| dur | integer | Duration of the video or audio creative in seconds. |
| mtype | integer | Type of the creative markup so that it can properly be associated with the right sub-object of the BidRequest.Imp.Values: 1 = Banner 2 = Video, 3 = Audio 4 = Native |
| slotinpod default 0 | integer | Indicates that the bid response is only eligible for a specific position within a video or audio ad pod (e.g. first position, last position, or any). Refer to List:Slot Position in Pod in AdCOM 1.0 for guidance on the use of this field. |
| ext | object | Placeholder for bidder-specific extensions to OpenRTB. |
Field descriptions are published in the official IAB Tech Lab OpenRTB 2.6 spec (CC-BY 3.0) · enumeration values sourced from AdCOM 1.0 · first-draft proofreading