Device Object Properties¶
Note
Fields marked with an asterisk (*) are optional.
(**) Required for in-app requests.
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 |
Specifies the IPv4 address closest to the device.
|
ipv6* |
string |
Semi-Required One of IP or IPv6 required. IP address in IPv6, for example,
|
ua* |
string |
Browser or application user agent string, for example,
|
language* |
string |
Alpha-2/ISO 639-1 code of browser language, for example, |
carrier* |
string |
Carrier or ISP derived from the IP address, for example, |
connectiontype* |
integer |
Connection type as defined in OpenRTB, for example, |
didsha1* |
string |
Hardware device ID (e.g., IMEI); hashed via SHA1, for example,
|
didmd5* |
string |
Hardware device ID (e.g., IMEI); hashed via MD5.
|
dpidsha1* |
string |
Platform device ID (e.g., Android ID); hashed via SHA1, for example,
|
dpidmd5* |
string |
Platform device ID (e.g., Android ID); hashed via MD5, for example,
|
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:
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 |
make* |
string |
Device make, for example, |
mccmnc* |
string |
Mobile carrier as the concatenated MCC-MNC code (e.g., |
model* |
string |
Device mode, for example, |
os* |
string |
Device operating system, for example, |
osv* |
string |
Device operating system version, for example, |
h* |
integer |
Physical height of the screen in pixels, for example, |
w* |
integer |
Physical width of the screen in pixels, for example, |
pxratio* |
float |
The ratio of physical pixels to device independent pixels, for
example, |
dnt* |
integer |
Do not track.
|
lmt* |
integer |
Limit Ad Tracking. Signal commercially endorsed (e.g., iOS, recommended Android):
|
devicetype* |
integer |
Device type as defined by OpenRTB, for example, |
js* |
integer |
1 if the device supports JavaScript; otherwise 0. |
flashver* |
string |
Flash version detected, for example, |
ext* |
object |
Device extensiton object |
Device Ext¶
Value |
Type |
Description |
---|---|---|
atts* |
int |
(iOS Only) An integer passed to represent the app’s app tracking authorization status, can contain the following values.
|
dooh* |
object |
Passes the DOOH Object for Digital out of Home inventory, required to indicate DooH inventory |
truncated_ip* |
integer |
Indicates whether the IP address in the |
ifa_type* |
string |
Indicates the origin of the
|
idfv* |
str |
Passes the ID for Vendor (IDFV). A persistent unique identifier for each app on a device that identifies the
device to the app’s vendor. The value of this property is the same for apps that
come from the same vendor running on the same device. A different value is
returned for apps on the same device that come from different vendors, and for
apps on different devices regardless of vendor, e.g. |