Device.osv

The operating system version, as a string such as "17.4.1".

CurrentstringOptionalSince 2.0

Field facts

Path: device.osv
Object: Device
Type: string
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 3.2.18

How it is used

Keep it a string, because versions with several components are not numbers. On Chromium web traffic the reduced user agent freezes some OS versions, so the real platform version may only be available in device.sua.platform.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "device": {
    "osv": "17.4.1"
  }
}

Common mistakes

Sending the version as a number such as 17.4, which drops components and fails the string type.

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	string	No	No
2.3 to 2.3.1	string	No	No
2.4	string	No	No
2.5 to 2.6-202606	string	No	No