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 types.
| Attribute | Type | Description |
|---|---|---|
| id required | string | A unique identifier for this impression within the context 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. |
| 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. |
| exp | integer | Advisory as to the number of seconds that may elapse between the auction and the actual impression. |
| ext | object | Placeholder for exchange-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