RTBlintAlpha
Menu

Bid object

A Bid is one offer to buy one impression. It names the impression in Bid.impid, states a CPM price, and supplies the creative, either inline in Bid.adm or through the win notice. Bids sit inside SeatBid.bid and also carry notice URLs and the metadata exchanges use for quality and block list checks.

33 fieldsOpenRTB 2.0 to 2.6-202606At seatbid.bid

How it is used

Only Bid.id, Bid.impid, and Bid.price are required, but an exchange enforcing publisher rules needs more: advertiser domains for BidRequest.badv, categories for BidRequest.bcat, creative attributes for the impression's blocked attributes, and the markup type in Bid.mtype. A bid that leaves these out cannot be checked against the publisher's rules.

The Bid response anatomy page covers it in more depth.

Fields

FieldTypeRequirementSinceStatus
adidstringOptional2.0Current
admstringOptional2.0Current
adomainstring arrayOptional2.0Current
apiintegerOptional2.4Deprecated 2.6-202204
apisinteger arrayOptional2.6-202204Current
attrinteger arrayOptional2.0Current
bundlestringOptional2.3Current
burlstringOptional2.5Current
catstring arrayOptional2.3Current
cattaxinteger, default 1Optional2.6-202204Current
cidstringOptional2.0Current
cridstringOptional2.0Current
dealidstringOptional2.2Current
durintegerOptional2.6-202204Current
expintegerOptional2.4Current
extobjectOptional2.0Current
hintegerOptional2.2Current
hratiointegerOptional2.5Current
idstringRequired2.0Current
impidstringRequired2.0Current
iurlstringOptional2.0Current
langbstringOptional2.6-202204Current
languagestringOptional2.5Current
lurlstringOptional2.5Current
mtypeintegerOptional2.6-202204Current
nurlstringOptional2.0Current
pricefloatRequired2.0Current
protocolintegerOptional2.4Current
qagmediaratingintegerOptional2.4Current
slotinpodinteger, default 0Optional2.6-202204Current
tacticstringOptional2.5Current
wintegerOptional2.2Current
wratiointegerOptional2.5Current

Where it sits

Contained in: SeatBid.

All objects

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