RTBlintAlpha
Menu

Imp object

An Imp is one ad opportunity offered in a bid request. Each entry in BidRequest.imp carries its own id, the media types on offer (banner, video, audio, native), a floor and its currency, and any private marketplace deals. Every bid points back to exactly one Imp through Bid.impid.

23 fieldsOpenRTB 2.0 to 2.6-202606At imp

How it is used

A request can carry several Imp objects, for example every slot on a page, and each one is priced and won independently. Putting more than one media object on the same Imp lets the buyer choose the format, but any single bid must fit one of the types offered. OpenRTB 2.6 and its later revisions moved several signals onto the Imp that used to travel in extensions or not at all: rewarded and SSAI flags, DOOH quantity and delivery time, and slot refresh details.

The Bid request anatomy page covers it in more depth.

Fields

FieldTypeRequirementSinceStatus
audioobjectOptional2.4Current
bannerobjectOptional2.0Current
bidfloorfloat, default 0Optional2.0Current
bidfloorcurstring, default USDOptional2.0Current
clickbrowserintegerOptional2.4Current
displaymanagerstringOptional2.0Current
displaymanagerverstringOptional2.0Current
dtfloatOptional2.6-202211Current
expintegerOptional2.4Current
extobjectOptional2.0Current
idstringRequired2.0Current
iframebusterstring arrayOptional2.0Current
instlinteger, default 0Optional2.0Current
metricobject arrayOptional2.5Current
nativeobjectOptional2.3Current
pmpobjectOptional2.2Current
qtyobjectOptional2.6-202211Current
refreshobjectOptional2.6-202303Current
rwddinteger, default 0Optional2.6-202204Current
secureintegerOptional2.2Current
ssaiinteger, default 0Optional2.6-202204Current
tagidstringOptional2.0Current
videoobjectOptional2.0Current

Where it sits

Contained in: BidRequest.

Contains: Audio, Banner, Metric, Native, Pmp, Qty, Refresh, Video.

All objects

The field reference index lists every OpenRTB 2.x object.