Imp§3.2.4 · Bid Request
This object describes an ad placement or impression being auctioned. A single bid request can include multiple Imp objects, a use case for which might be an exchange that supports selling all ad positions on a given page. Each Imp object has a required ID so that bids can reference them individually. The presence of Banner (Section 3.2.6), Video (Section 3.2.7), and/or Native (Section 3.2.9) objects subordinate to the Imp object indicates the type of impression being offered. The publisher can choose one such type which is the typical case or mix them at their discretion. However, any given bid for the impression must conform to one of the offered type.
| Attribute | Type | Description |
|---|---|---|
| id required | string | A unique identifier for this impression within the content of the bid request (typically, starts with 1 and increments). |
| metric | object[] | An array of Metric object (section 3.2.5). |
| banner | object | A Banner object (section 3.2.6); required if this impression is offered as a banner ad opportunity. |
| video | object | A Video object (Section 3.2.7); required if this impression is offered as a video ad opportunity. |
| audio | object | An Audio object (Section 3.2.8); required if this impression is offered as an audio ad opportunity. |
| native | object | A Native object (Section 3.2.9); required if this impression is offered as a native ad opportunity. |
| pmp | object | A Pmp object (Section 3.2.11) containing any private marketplace deals in effect for this impression. |
| displaymanager | string | Name of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. Recommended for video and/or apps. |
| displaymanagerver | string | Version of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. Recommended for video and/or apps. |
| instl default 0 | integer | 1 = the ad is interstitial or full screen, 0 = not interstitial. |
| tagid | string | Identifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer. |
| bidfloor default 0 | float | Minimum bid for this impression expressed in CPM. |
| bidfloorcur default "USD" | string | Currency specified using ISO-4217 alpha codes. This may be different from bid currency returned by bidder if this is allowed by the exchange. This currency sets the default for all floors specified in the Imp object. |
| clickbrowser | integer | Indicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native. Note that the Safari View Controller in iOS 9.x devices is considered a native browser for purposes of this attribute. |
| secure | integer | Flag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure. If omitted, the secure state is unknown, but non-secure HTTP support can be assumed. |
| iframebuster | string[] | Array of exchange-specific names of supported iframe busters. |
| rwdd default 0 | integer | Indicates whether the user receives a reward for viewing the ad, where 0 = no, 1 = yes. Typically video ad implementations allow users to read an additional news article for free, receive an extra life in a game, or get a sponsored ad-free music session. The reward is typically distributed after the video ad is completed. |
| ssai default 0 | integer | Indicates if server-side ad insertion (e.g., stitching an ad into an audio or video stream) is in use and the impact of this on asset and tracker retrieval, where 0 = status unknown, 1 = all client-side (i.e., not server-side), 2 = assets stitched server-side but tracking pixels fired client-side, 3 = all server-side. |
| exp | integer | Advisory as to the number of seconds that may elapse between the auction and the actual impression. |
| qty | object | A means of passing a multiplier in the bid request, representing the total quantity of impressions for adverts that display to more than one person. |
| dt | float | Timestamp when the item is estimated to be fulfilled (e.g. when a DOOH impression will be displayed) in Unix format (i.e., milliseconds since the epoch). |
| refresh | object | Details about ad slots being refreshed automatically. (Section 3.2.33) |
| ext | object | Placeholder for exchange-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