UserAgent object
The UserAgent object carries structured browser and platform details derived from User-Agent Client Hints, at device.sua. It exists because Chromium browsers now freeze parts of the classic User-Agent string. When both are present, bidders should trust it over device.ua. Added in OpenRTB 2.6.
How it is used
Sellers fill it from the Sec-CH-UA request headers or the NavigatorUAData JavaScript interface, which only Chromium-based browsers provide. Low-entropy hints (brands with major versions, platform, mobile) arrive by default. High-entropy hints (full versions, platform version, model, architecture, bitness) arrive only when the site or ad server asks for them. Set source to say which kind the object was built from.
The User-agent client hints and sua page covers it in more depth.
Fields
| Field | Type | Requirement | Since | Status |
|---|---|---|---|---|
architecture | string | Optional | 2.6-202204 | Current |
bitness | string | Optional | 2.6-202204 | Current |
browsers | array of BrandVersion objects | Recommended | 2.6-202204 | Current |
ext | object | Optional | 2.6-202204 | Current |
mobile | integer | Optional | 2.6-202204 | Current |
model | string | Optional | 2.6-202204 | Current |
platform | BrandVersion object | Recommended | 2.6-202204 | Current |
source | integer, default 0 | Optional | 2.6-202204 | Current |
Where it sits
Contains: BrandVersion.
All objects
The field reference index lists every OpenRTB 2.x object.