Device Context

Device Object Properties
Value Type Description
ip string

(Required) Specifies the IPv4 address closest to the device.

  • One of either ip or ipv6 is 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

(Required) IP address in IPv6 format. One of either ip or ipv6 is required for almost all requests, any containing invalid IP addresses will be discarded based on IP Validation, for example, "fe80:0:0:0:200:f8ff:fe21:67cf"

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

Device type as defined by OpenRTB, for example, 4

  • 1 Mobile/Tablet - General
  • 2 Personal Computer
  • 3 Connected TV
  • 4 Phone
  • 5 Tablet
  • 6 Connected Device
  • 7 Set Top Box
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"
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

dnt integer

Do not track, as set in browser header.

  • 0: do not track is set to false
  • 1: do not track is set to true
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
make string Device make, for example, "Apple"
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
lang string Alpha-2/ISO 639-1 code of browser language, for example, "en"
xff string The value of the "x-forwarded-for" header.
carrier string Carrier or ISP derived from the IP address, for example, "Airtel"
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
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 Context section.
contype integer

Connection type as defined in OpenRTB, for example, 2

  • 1 Ethernet; Wired Connection
  • 2 WIFI
  • 3 Cellular Network - Unknown Generation
  • 4 Cellular Network - 2G
  • 5 Cellular Network - 3G
  • 6 Cellular Network - 4G
  • 7 Cellular Network - 5G
{
    "contype":3,
    "mccmnc":"310-005",
    "lang":"en",
    "geo":{
        "country":"IN",
        "lon":85.1167,
        "city":"Patna",
        "lat":25.6,
        "zip":"800002",
        "region":"IN-BR",
        "type":2
    },
    "ifa":"793ff4b0-d077-4002-aeb6-b8ea64dd4b2b",
    "osv":"5.0.2",
    "os":"Android",
    "carrier":"Airtel",
    "type":1,
    "ip":"223.176.12.242",
    "ua":"Dalvik/2.1.0 (Linux; U; Android 5.0.2; Micromax A096 Build/LRX21M)",
    "dnt":2
}