UserAgent.platform

The operating system as a single BrandVersion object, with the brand from the Sec-CH-UA-Platform hint and the version from Sec-CH-UA-Platform-Version. Recommended.

CurrentBrandVersion objectRecommendedSince 2.6-202204

Field facts

Path
device.sua.platform
Object
UserAgent
Type
BrandVersion object
Requirement
Recommended
Added
OpenRTB 2.6-202204
Spec section
3.2.29

How it is used

The platform version is a high-entropy hint and may be missing; send the brand alone rather than guessing. Version numbers do not always match marketing names: Windows 11 reports a platform version of 13 or higher.

Example

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

{
  "id": "req-1",
  "device": {
    "sua": {
      "platform": {
        "brand": "Android",
        "version": [
          "14",
          "0",
          "0"
        ]
      }
    }
  }
}

Common mistakes

  • Sending platform as an array. Unlike browsers, it is one object.
  • Sending the version as a string such as "14.0.1" instead of ["14", "0", "1"].

Version history

Added in OpenRTB 2.6-202204, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.6-202204Added in the first 2.6 release, published without a structured text archive; the 2.6-202210 republication is the first tagged text.
2.6-202210 to 2.6-202606BrandVersion objectRecommendedNo

Related fields

Other UserAgent fields

For a walkthrough of the whole object, read User-agent client hints and sua.