Device.devicetype
The general class of device, as an integer from the AdCOM Device Types list, for example 2 for a personal computer, 3 for connected TV, 4 for a phone, and 5 for a tablet.
Field facts
- Path
device.devicetype- Object
- Device
- Type
- integer
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Values
- AdCOM list Device Types
- Spec section
- 3.2.18
How it is used
This is usually the first field a buyer filters on, especially for CTV. Value 1 (mobile or tablet, general) dates from 2.0; OpenRTB 2.2 added 4 phone, 5 tablet, 6 connected device, and 7 set top box, and advised bidders to treat 1 as covering both 4 and 5. AdCOM 1.0 added 8 for out-of-home screens. Streaming boxes and consoles can arrive as 3, 6, or 7 depending on the seller, so a TV buy that filters on 3 alone may miss real big-screen inventory.
Allowed values
| Value | Meaning |
|---|---|
1 | Mobile/Tablet - General: Generic mobile value from OpenRTB 2.0 for a phone or tablet when the seller cannot tell which. |
2 | Personal Computer: Desktop and laptop computers, usually browser traffic that arrives with a site object. |
3 | Connected TV: A television with built-in internet apps, and the value most CTV targeting starts from. |
4 | Phone: A phone, added in OpenRTB 2.2 as the precise alternative to 1. |
5 | Tablet: A tablet, added in OpenRTB 2.2 alongside 4. |
6 | Connected Device: Connected hardware that is not a phone, tablet, computer, or TV, such as game consoles and streaming players. |
7 | Set Top Box: A set top box, typically operator hardware from a cable, satellite, or IPTV provider. |
8 | OOH Device: A digital out-of-home screen. It is not in OpenRTB 2.5's table and comes from the AdCOM list. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"device": {
"devicetype": 3
}
}Common mistakes
- Sending the value as a string such as "3" instead of an integer.
- Labeling CTV app traffic as 1 or 4 because the SDK was written for mobile, which hides it from buyers that filter on connected TV.
Version history
Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.
| Versions | Type in the spec | Required | Deprecated |
|---|---|---|---|
| 2.0 to 2.2 | integer | No | No |
| 2.3 to 2.3.1 | integer | No | No |
| 2.4 | integer | No | No |
| 2.5 | integer | No | No |
| 2.6-202210 to 2.6-202606 | integer | No | No |