Device Object Properties

Note

Fields marked with an asterisk (*) are optional.

(**) Required for in-app requests.

Device Object Properties
Value Type Description
geo object Geo Object as derived from the device’s location services, or supplied by the Supplier if the device IP is missing. For more information, see the Geo Object Properties section.
ip* string IPv4 address closest to the device. Bids containing invalid IP addresses will be discarded. The field is optional for in-app traffic, for example, 87.224.77.0
ua* string Browser or application user agent string, for example, "Mozilla/5.0 (Windows NT 6.3; WOW64; rv:35.0)Gecko/20100101Firefox/35.0"
language* string Alpha-2/ISO 639-1 code of browser language, for example, en
carrier* string Carrier or ISP derived from the IP address, for example, WIFI
connectiontype* integer Connection type as defined in OpenRTB, for example, 2
didsha1* string Hardware device ID (e.g., IMEI); hashed via SHA1, for example, CCF6DC12B98AEB2346AFE1BEE7860DF01FDE158B
didmd5* string Hardware device ID (e.g., IMEI); hashed via MD5. 93D05D4D69DEE2BC6645D9F0A0C1938C
dpidsha1* string Platform device ID (e.g., Android ID); hashed via SHA1, for example, CCF6DC12B98AEB2346AFE1BEE7860DF01FDE158B
dpidmd5* string Platform device ID (e.g., Android ID); hashed via MD5, for example, 93D05D4D69DEE2BC6645D9F0A0C1938C
ifa** string

ID sanctioned for advertiser use in clear text (i.e. not hashed), for example Apple’s IDFA or Android’s Advertising ID. Note: This field is required for in-app requests.

The Apple IDFA is usually uppercase, and the Android Advertiser ID is usually lowercase. For example:

  • Android "035911ea-467d-4056-903b-65cf44f5633b"
  • iOS "30255BCE-4CDA-4F62-91DC-4758FDFF8512"

Note: This fields uses UUIDv4 format. Version 4 UUIDs take the following format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx, where x is any hexadecimal digit and y is one of 8, 9, A, or B. You can read more about UUIDv4 here: https://tools.ietf.org/html/rfc4122

make* string Device make, for example, Apple
mccmnc* string Mobile 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
model* string Device mode, for example, iPhone
os* string Device operating system, for example, iOS
osv* string Device operating system version, for example, 3.1.2
w* integer Physical height of the screen in pixels, for example, 750
h* integer Physical width of the screen in pixels, for example, 1334
pxratio* float The ratio of physical pixels to device independent pixels, for example, 1.0
dnt* integer

Do not track.

  • 0: do not track is set to false
  • 1: do not track is set to true in the browser, for example, 0
lmt* integer

Limit Ad Tracking. Signal commercially endorsed (e.g., iOS, recommended Android):

  • 0: tracking is unrestricted,
  • 1: tracking must be limited per commercial guidelines, for example, 0
devicetype* integer Device type as defined by OpenRTB, for example, 4
ipv6* string IP address in IPv6, for example, fe80:0:0:0:200:f8ff:fe21:67cf
js* integer 1 if the device supports JavaScript; otherwise 0.
flashver* string Flash version detected, for example, 10.1