ORTB
中 / EN

User§3.2.20 · Bid Request

该对象包含关于设备背后真实用户(即广告受众)的已知或推导信息。用户 ID 是交易平台(exchange)的产物,可能受轮换或其他隐私策略约束;但它必须足够稳定,方能合理地作为频控(frequency capping)与重定向(retargeting)的基础。译稿校对中ENThis object contains information known or derived about the human user of the device (i.e., the audience for advertising). The user id is an exchange artifact and may be subject to rotation or other privacy policies. However, this user ID must be stable long enough to serve reasonably as the basis for frequency capping and retargeting.

AttributeTypeDescription
id
string交易平台(exchange)专用的用户 ID。建议至少传递 id 或 buyeruid 之一。译稿校对中ENExchange-specific ID for the user. At least one of id or buyeruid is recommended.
buyeruid
string由交易平台为买家(buyer)映射的买家专用用户 ID。建议至少传递 buyeruid 或 id 之一。译稿校对中ENBuyer-specific ID for the user as mapped by the exchange for the buyer. At least one of buyeruid or id is recommended.
yob
integer(Year of Birth, yob)yob 出生年份,以四位整数表示。译稿校对中ENYear of birth as a 4-digit integer.
gender
string性别:"M" = 男性,"F" = 女性,"O" = 已知为其他(省略则表示未知)。译稿校对中ENGender, where "M" = male, "F" = female, "O" = known to be other (i.e., omitted is unknown).
keywords
string关键词、兴趣或意图列表,以逗号分隔。译稿校对中ENComma separated list of keywords, interests, or intent.
customdata
string可选特性,用于向竞价方传递事先写入交易平台 cookie 中的数据。字符串须采用 base85 cookie 安全字符,格式不限;如需包含转义的引号,必须使用规范的 JSON 编码。译稿校对中ENOptional feature to pass bidder data that was set in the exchange's cookie. The string must be in base85 cookie safe characters and be in any format. Proper JSON encoding must be used to include "escaped" quotation marks.
geo
object用户常驻地的位置,由 Geo 对象(参见第 3.2.19 节)定义。注意:这不一定是其当前位置。译稿校对中ENLocation of the user's home base defined by a Geo object (Section 3.2.19). This is not necessarily their current location.
data
object[]附加用户数据。每个 Data 对象(参见第 3.2.21 节)代表一个不同的数据源。译稿校对中ENAdditional user data. Each Data object (Section 3.2.21) represents a different data source.
ext
object供交易平台对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB.

译注

译者注

UserBidRequest 的子对象,描述设备背后的人(即广告受众);业内文档一般保留英文对象名 User。注意与 Device 的分工:Device 描述设备侧属性,User 描述人侧属性;同为 Geo 挂载,两处语义不同(见 geo 译注)。译稿校对中

id vs buyeruid:id 是交易平台级用户标识(交易平台产物),可能受轮换或其他隐私策略影响;buyeruid 是交易平台为特定买家映射的买家专用 ID,通常源自 ID 同步(ID sync)。二者至少传其一;id 必须足够稳定,方可作为频控与重定向的依据。译稿校对中

frequency capping / retargeting:频控与重定向(再营销)为业界惯用术语。用户 ID 的稳定性要求正是以这两个典型用途为基准提出的。译稿校对中

yob / gender:出生年份与性别属隐私敏感属性,在部分司法辖区受隐私法规约束,用于定向时应谨慎评估合规风险;OpenRTB 2.6 起二者均已被标记弃用。译稿校对中

customdata:承载交易平台事先写入其 cookie 的数据,由交易平台透传给竞价方;要求 base85 cookie 安全编码,含引号时须做 JSON 转义。竞价方解析时应做容错处理,不应假设其内部结构。译稿校对中

geo(User 挂载):User.geo 表示用户常驻地(home base),不一定是其当前位置,与 Device.geo(设备位置,可近似理解为用户当前位置)语义有别,两处不可混用。译稿校对中

字段描述已与 2.6 官方 draft 对账;2.5 独有字段来自第三方 Go 实现源(Apache 2.0),官方 PDF 兜底校对 · 初稿校对中