Device.connectiontype
The type of network the device is on, as an integer from the AdCOM Connection Types list: 1 wired Ethernet, 2 WIFI, 3 cellular of unknown generation, and 4 to 7 for 2G through 5G.
Field facts
- Path
device.connectiontype- Object
- Device
- Type
- integer
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Values
- AdCOM list Connection Types
- Spec section
- 3.2.18
How it is used
Video and rich media buyers use it to judge whether a heavy creative will load and play smoothly, and some price cellular and WIFI traffic differently. Before 2.6 the list lived in OpenRTB itself, ran from 0 (unknown) to 6 (4G), and had no 5G value. AdCOM 1.0 dropped 0 and added 7 for 5G, so on 2.6 omit the field when the type is unknown.
Allowed values
| Value | Meaning |
|---|---|
1 | Ethernet; Wired Connection: A wired network connection, typical of desktops, set top boxes, and smart TVs on a cable. |
2 | WIFI: A Wi-Fi connection, on any kind of device. |
3 | Cellular Network - Unknown Generation: A cellular data connection whose generation the seller cannot determine. |
4 | Cellular Network - 2G: A second-generation cellular connection, too slow for most video. |
5 | Cellular Network - 3G: A third-generation cellular connection, such as UMTS or HSPA. |
6 | Cellular Network - 4G: A fourth-generation (LTE) cellular connection; the highest value in OpenRTB 2.5's table. |
7 | Cellular Network - 5G: A fifth-generation cellular connection. It comes from the AdCOM list and is not in OpenRTB 2.5's table. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"device": {
"connectiontype": 2
}
}Common mistakes
- Sending 0 for unknown on a 2.6 request. It was valid in the 2.5 list but is not in AdCOM Connection Types.
- Sending the value as a string such as "2" instead of an integer.
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 |