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

The ID for Advertisers (IFA) 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 can use UUIDv4 or UUIDv5 formats. If passing synthetic IFAs, you should use either the v4 or v5 implementation of RFC 4122 to generate them. There’s a number of online tools for checking the version if you need to troubleshoot UUID issues, e.g. UUID / GUID Validator

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
}