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.
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
| Field | Type | Requirement | Since | Status |
|---|---|---|---|---|
carrier | string | Optional | 2.0 | Current |
connectiontype | integer | Optional | 2.0 | Current |
devicetype | integer | Optional | 2.0 | Current |
didmd5 | string | Optional | 2.0 | Deprecated 2.6-202204 |
didsha1 | string | Optional | 2.0 | Deprecated 2.6-202204 |
dnt | integer | Recommended | 2.0 | Current |
dpidmd5 | string | Optional | 2.0 | Deprecated 2.6-202204 |
dpidsha1 | string | Optional | 2.0 | Deprecated 2.6-202204 |
ext | object | Optional | 2.1 | Current |
flashver | string | Optional | 2.0 | Current |
geo | object | Recommended | 2.0 | Current |
geofetch | integer | Optional | 2.4 | Current |
h | integer | Optional | 2.3 | Current |
hwv | string | Optional | 2.3 | Current |
ifa | string | Optional | 2.2 | Current |
ip | string | Optional | 2.0 | Current |
ipv6 | string | Optional | 2.0 | Current |
js | integer | Optional | 2.0 | Current |
langb | string | Optional | 2.6-202204 | Current |
language | string | Optional | 2.0 | Current |
lmt | integer | Recommended | 2.3 | Current |
macmd5 | string | Optional | 2.2 | Deprecated 2.6-202204 |
macsha1 | string | Optional | 2.2 | Deprecated 2.6-202204 |
make | string | Optional | 2.0 | Current |
mccmnc | string | Optional | 2.5 | Current |
model | string | Optional | 2.0 | Current |
os | string | Optional | 2.0 | Current |
osv | string | Optional | 2.0 | Current |
ppi | integer | Optional | 2.3 | Current |
pxratio | float | Optional | 2.3 | Current |
sua | object | Optional | 2.6-202204 | Current |
ua | string | Optional | 2.0 | Current |
w | integer | Optional | 2.3 | Current |
Where it sits
Contained in: BidRequest.
Contains: Geo.
All objects
The field reference index lists every OpenRTB 2.x object.