ORTB
中 / EN

UserAgent§3.2.29 · Bid Request

结构化用户代理信息,在客户端支持 User-Agent Client Hints 时可用。若竞价请求中 device.ua 与 device.sua 同时存在,应视 device.sua 为设备属性的更准确表达——因为浏览器弃用用户代理字符串,device.ua 可能包含被冻结或精简的用户代理字符串。译稿校对中ENStructured user agent information, which can be used when a client supports User-Agent Client Hints. If both device.ua and device.sua are present in the bid request, device.sua should be considered the more accurate representation of the device attributes. This is because the device.ua may contain a frozen or reduced user agent string due to deprecation of user agent strings by browsers.

AttributeTypeDescription
browsers
brandversion[]每个 BrandVersion 对象(参见第 3.2.30 节)标识一个浏览器或类似软件组件。实现方应发送源自 Sec-CH-UA-Full-Version-List 请求头的品牌与版本。译稿校对中ENEach BrandVersion object (see Section 3.2.30) identifies a browser or similar software component. Implementers should send brands and versions derived from the Sec-CH-UA-Full-Version-List header\*.
platform
brandversion标识用户代理执行平台/操作系统的 BrandVersion 对象(参见第 3.2.30 节)。实现方应发送源自 Sec-CH-UA-Platform 请求头的品牌,以及源自 Sec-CH-UA-Platform-Version 请求头的版本。译稿校对中ENA BrandVersion object (see Section 3.2.30) that identifies the user agent’s execution platform / OS. Implementers should send a brand derived from the Sec-CH-UA-Platform header, and version derived from the Sec-CH-UA-Platform-Version header\*.
mobile
integer若代理偏好“移动”版内容(如有,即为小屏或触控输入优化的版本)则为 1;若偏好“桌面”或“完整”内容则为 0。实现方应从 Sec-CH-UA-Mobile 请求头导出本取值。译稿校对中EN1 if the agent prefers a “mobile” version of the content, if available, i.e. optimized for small screens or touch input. 0 if the agent prefers the “desktop” or “full” content. Implementers should derive this value from the Sec-CH-UA-Mobile header\*.
architecture
string设备的主二进制架构(如 “x86” 或 “arm”)。实现方应从 Sec-CH-UA-Arch 请求头获取本取值。译稿校对中ENDevice’s major binary architecture, e.g. “x86” or “arm”. Implementers should retrieve this value from the Sec-CH-UA-Arch header\*.
bitness
string设备的位数(bitness,如 64 位架构对应 “64”)。实现方应从 Sec-CH-UA-Bitness 请求头获取本取值。译稿校对中ENDevice’s bitness, e.g. “64” for 64-bit architecture. Implementers should retrieve this value from the Sec-CH-UA-Bitness header\*.
model
string设备型号。实现方应从 Sec-CH-UA-Model 请求头获取本取值。译稿校对中ENDevice model. Implementers should retrieve this value from the Sec-CH-UA-Model header\*.
source
default 0
integer用于构造本对象的数据来源。参见 AdCOM 1.0 列表:用户代理来源(List: User-Agent Source)。译稿校对中ENThe source of data used to create this object, List: User-Agent Source in AdCOM 1.0
枚举 User-Agent Source · 4 个值
0Unspecified/unknown
1User-Agent Client Hints (only low-entropy headers were available)
2User-Agent Client Hints (with high-entropy headers available)
3Parsed from User-Agent header (the same string carried by the ua field)
ext
object供供应商对本对象进行专属扩展(vendor specific extensions)的占位对象。译稿校对中ENPlaceholder for vendor specific extensions to this object.

译注

译者注

UserAgent(sua)的定位:基于 User-Agent Client Hints 的结构化用户代理,在客户端支持 Client Hints 时使用;请求中 ua 与 sua 并存时应以 sua 为更准确的设备属性表达(ua 可能因浏览器弃用 UA 字符串而冻结/精简)。译稿校对中

与 Client Hints 请求头的映射:browsers ← Sec-CH-UA-Full-Version-List;platform ← Sec-CH-UA-Platform + Platform-Version;mobile ← Sec-CH-UA-Mobile;architecture/bitness/model ← 对应 Sec-CH-UA-* 头。解析时应容忍部分字段缺失(并非所有客户端都暴露全部 hint)。译稿校对中

browsers 中的 GREASE 与品牌序列:Sec-CH-UA 品牌列表可能含 GREASE 伪品牌与刻意乱序,设备识别应提取已知浏览器品牌而非首元素;解析器应维护品牌白名单。译稿校对中

字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中