Device Object

Note

Fields marked with an asterisk (*) are optional.

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 section.

ip

string

Specifies the IPv4 address closest to the device.

  • Semi-Required One of IP or IPv6 required

  • Required for almost all requests, any containing invalid IP addresses will be discarded based on IP Validation e.g. 87.224.77.0

  • Note: This field is only optional for Connected TV inventory

ipv6

string

Semi-Required One of IP or IPv6 required. IP address in IPv6, for example fe80:0:0:0:200:f8ff:fe21:67cf

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

Deprecated since version 5.3.

didmd5*

string

Hardware device ID (e.g., IMEI); hashed via MD5. 93D05D4D69DEE2BC6645D9F0A0C1938C

Deprecated since version 5.3.

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

Native identifier for advertisers. An ID assigned by the device or browser for use as an advertising identifier, for example Apple’s IDFA or Android’s Advertising ID. 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

js*

integer

1 if the device supports JavaScript; otherwise 0.

flashver*

string

Flash version detected, for example, 10.1