ORTB
中 / EN

Device§3.2.18 · Bid Request

2.32.42.52.63.0Version Diff

This object provides information pertaining to the device through which the user is interacting. Device information includes its hardware, platform, location, and carrier data. The device can refer to a mobile handset, a desktop computer, set top box, or other digital device.

AttributeTypeDescription
ua
stringBrowser user agent string.
geo
objectLocation of the device assumed to be the user’s current location defined by a Geo object (Section 3.2.19).
dnt
integerStandard “Do Not Track” flag as set in the header by the browser, where 0 = tracking is unrestricted, 1 = do not track.
lmt
integer“Limit Ad Tracking” signal commercially endorsed (e.g., iOS, Android), where 0 = tracking is unrestricted, 1 = tracking must be limited per commercial guidelines.
ip
stringIPv4 address closest to device.
ipv6
stringIP address closest to device as IPv6.
devicetype
integerThe general type of device. Refer to List: Device Types in AdCOM 1.0.
Enum Device Types · 8 values
1Mobile/Tablet - General
2Personal Computer
3Connected TV
4Phone
5Tablet
6Connected Device
7Set Top Box
8OOH Device
make
stringDevice make (e.g., “Apple”).
model
stringDevice model (e.g., “iPhone”).
os
stringDevice operating system (e.g., “iOS”).
osv
stringDevice operating system version (e.g., “3.1.2”).
hwv
stringHardware version of the device (e.g., “5S” for iPhone 5S).
h
integerPhysical height of the screen in pixels.
w
integerPhysical width of the screen in pixels.
ppi
integerScreen size as pixels per linear inch.
pxratio
floatThe ratio of physical pixels to device-independent pixels (DIPS).
js
integerSupport for JavaScript, where 0 = no, 1 = yes.
geofetch
integerIndicates if the geolocation API will be available to JavaScript code running in the banner, where 0 = no, 1 = yes.
flashver
stringVersion of Flash supported by the browser.
language
stringBrowser language using ISO-639-1-alpha-2. Only one of language or langb should be present.
carrier
stringCarrier or ISP (e.g., “VERIZON”) using exchange curated string names which should be published to bidders a priori.
mccmnc
stringMobile carrier as the concatenated MCC-MNC code (e.g., “310-005” identifies Verizon Wireless CDMA in the USA). Refer to https://en.wikipedia.org/wiki/Mobile_country_code for further examples. Note that the dash between the MCC and MNC parts is required to remove parsing ambiguity. The MCC-MNC values represent the SIM installed on the device and do not change when a device is roaming. Roaming may be inferred by a combination of the MCC-MNC, geo, IP and other data signals.
connectiontype
integerNetwork connection type. Refer to List: Connection Types in AdCOM 1.0.
Enum Connection Types · 7 values
1Ethernet; Wired Connection
2WIFI
3Cellular Network - Unknown Generation
4Cellular Network - 2G
5Cellular Network - 3G
6Cellular Network - 4G
7Cellular Network - 5G
ifa
stringID sanctioned for advertiser use in the clear (i.e., not hashed)
Unless prior arrangements have been made between the buyer and the seller directly, the value in this field is expected to be an ID derived from a call to an advertising API provided by the device’s Operating System.
didsha1
stringDeprecated as of OpenRTB 2.6.
didmd5
stringDeprecated as of OpenRTB 2.6.
dpidsha1
stringDeprecated as of OpenRTB 2.6.
dpidmd5
stringDeprecated as of OpenRTB 2.6.
macsha1
stringDeprecated as of OpenRTB 2.6.
macmd5
stringDeprecated as of OpenRTB 2.6.
ext
objectPlaceholder for exchange-specific extensions to OpenRTB.

Field descriptions reconciled against the official 2.6 draft; 2.5-specific fields come from a third-party Go implementation source (Apache 2.0), proofread against the official PDF · first-draft proofreading