Link Search Menu Expand Document

PDF

Imp Object

Demand Partners

BidRequest Object


BidRequest.imp

Each BidRequest object contains an array with a single Imp object to describe the impression. Each Imp object can contain one of the following objects to describe the ad space:

In addition, the Imp object can contain a Pmp object along with a Banner or Native object.

Field nameData typeDescriptionSent?
idstringA unique ID for the impression. For example, 1.
Note that the IAB’s OpenRTB 2.5 specification requires that you use the value of BidRequest.imp.id to populate BidResponse.seatbid.bid.impid.
Always
metricobject arrayAn array of Metric that offers insight into different metrics about the impression itself to assist with your bidding decisions.

A Metric object is always sent when it is enabled.
Sometimes
bannerbanner objectAn object containing properties that describe the display banner ad unit for this impression opportunity. A Banner object is always sent for banner impression opportunities.Sometimes
videovideo objectAn object containing properties that describe the display video ad unit for this impression opportunity. A Video object is always sent for video impression opportunities.Sometimes
nativenative objectAn object containing properties that describe a native ad impression opportunity. A Native object is always sent for native ad impression opportunities.Sometimes
pmppmp objectAn object containing properties that describe deals eligible for impressions. A pmp object is always sent for private marketplace deals.Sometimes
displaymanagerstringName of SDK technology or player responsible for rendering an ad (typically video or mobile).Sometimes
displaymanagerverstringVersion of SDK technology or player responsible for rendering an ad (typically video or mobile).Sometimes
instlintegerIndicates whether the request is for an interstitial ad (1) or not (0).Sometimes
secureintegerIf this impression must be SSL secured, all creative assets that are returned must use the HTTPS protocol, not HTTP.
   • 0 = False
   • 1 = True (HTTPS URLs are required.)
Sometimes
expintegerAdvisory as to the number of seconds that may elapse between the auction and the actual impression.Sometimes

For additional publisher enrichment fields, see Supplemental Data.