UserAgent.browsers
The browser brands and versions the client reported, as an array of BrandVersion objects built from the Sec-CH-UA-Full-Version-List hint. Recommended.
Field facts
- Path
device.sua.browsers- Object
- UserAgent
- Type
- array of BrandVersion objects
- Requirement
- Recommended
- Added
- OpenRTB 2.6-202204
- Spec section
- 3.2.29
How it is used
Chromium browsers report several entries: the engine (Chromium), the product (such as Google Chrome or Microsoft Edge), and a deliberately fake GREASE brand such as "Not-A.Brand" that stops parsers from depending on exact lists or order. Passing entries through as received is the safe choice; buyers skip the GREASE entry. Without high-entropy hints, only major versions are available.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"device": {
"sua": {
"browsers": [
{
"brand": "Chromium",
"version": [
"124",
"0",
"6367",
"91"
]
},
{
"brand": "Google Chrome",
"version": [
"124",
"0",
"6367",
"91"
]
},
{
"brand": "Not-A.Brand",
"version": [
"99",
"0",
"0",
"0"
]
}
]
}
}
}Common mistakes
- Sending
suawithbrowsersmissing or empty. The structured user agent then says nothing about the browser, and RTBlint reports it. - Sending a single object instead of an array.
- Flattening each version into one string such as "124.0.6367.91" instead of an array of components.
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.
| Versions | Type in the spec | Required | Deprecated |
|---|---|---|---|
| 2.6-202204 | Added 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-202505 | array of BrandVersion objects | Recommended | No |
| 2.6-202606 | array of BrandVersion objects | Recommended | No |
Related fields
Other UserAgent fields
For a walkthrough of the whole object, read User-agent client hints and sua.