Device object

The Device object describes the hardware and software the user is on: device class, operating system, screen, network, IP address, and location. It sits at BidRequest.device and applies to every impression in the request. It also carries the advertising ID in device.ifa and the tracking flags device.lmt and device.dnt, so it matters for privacy as much as for targeting.

33 fieldsOpenRTB 2.0 to 2.6-202606At device

How it is used

No Device field is required, but buyers lean on this object heavily. IP and user agent feed geo lookup, device detection, and fraud screening, so a request without them draws few bids. There is no open registry for make, model, os, or carrier values, so exchanges should publish the strings they send. Identity and location fields (ifa, ip, ipv6, and the precision of geo) should reflect the consent and regulatory state carried in regs and user.consent.

Fields

FieldTypeRequirementSinceStatus
carrierstringOptional2.0Current
connectiontypeintegerOptional2.0Current
devicetypeintegerOptional2.0Current
didmd5stringOptional2.0Deprecated 2.6-202204
didsha1stringOptional2.0Deprecated 2.6-202204
dntintegerRecommended2.0Current
dpidmd5stringOptional2.0Deprecated 2.6-202204
dpidsha1stringOptional2.0Deprecated 2.6-202204
extobjectOptional2.1Current
flashverstringOptional2.0Current
geoobjectRecommended2.0Current
geofetchintegerOptional2.4Current
hintegerOptional2.3Current
hwvstringOptional2.3Current
ifastringOptional2.2Current
ipstringOptional2.0Current
ipv6stringOptional2.0Current
jsintegerOptional2.0Current
langbstringOptional2.6-202204Current
languagestringOptional2.0Current
lmtintegerRecommended2.3Current
macmd5stringOptional2.2Deprecated 2.6-202204
macsha1stringOptional2.2Deprecated 2.6-202204
makestringOptional2.0Current
mccmncstringOptional2.5Current
modelstringOptional2.0Current
osstringOptional2.0Current
osvstringOptional2.0Current
ppiintegerOptional2.3Current
pxratiofloatOptional2.3Current
suaobjectOptional2.6-202204Current
uastringOptional2.0Current
wintegerOptional2.3Current

Where it sits

Contained in: BidRequest.

Contains: Geo.

All objects

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