该对象是顶层竞价响应(bid response)对象(即未命名的外层 JSON 对象)。id 属性反映竞价请求 ID,用于日志记录;同样地,bidid 是供竞价方使用的可选响应跟踪 ID,若已指定,当竞价方胜出时可将其包含在后续的赢标通知(win notice)调用中。至少需要一个 seatbid 对象,其中至少包含一条针对某展示的出价;其他属性均为可选。要表达“不出价(no-bid)”,选项是返回 HTTP 204 的空响应;若竞价方希望向交易平台传达不出价的原因,也可仅返回一个 BidResponse 对象,并在 nbr 属性中携带原因码。译稿校对中ENThis object is the top-level bid response object (i.e., the unnamed outer JSON object). The id attribute is a reflection of the bid request ID for logging purposes. Similarly, bidid is an optional response tracking ID for bidders. If specified, it can be included in the subsequent win notice call if the bidder wins. At least one seatbid object is required, which contains at least one bid for an impression. Other attributes are optional. To express a "no-bid", the options are to return an empty response with HTTP 204. Alternately if the bidder wishes to convey to the exchange a reason for not bidding, just a BidResponse object is returned with a reason code in the nbr attribute.
| Attribute | Type | Description |
|---|---|---|
| id required | string | 本响应所对应的竞价请求的 ID。必填(required)。译稿校对中ENID of the bid request to which this is a response. |
| seatbid | object[] | SeatBid 对象数组;如要出价,至少需要 1 个。译稿校对中ENArray of seatbid objects; 1+ required if a bid is to be made. |
| bidid | string | 竞价方生成的响应 ID,用于辅助日志记录/跟踪。译稿校对中ENBidder generated response ID to assist with logging/tracking. |
| cur default “USD” | string | 出价币种,采用 ISO-4217 alpha 代码。默认值为 “USD”。译稿校对中ENBid currency using ISO-4217 alpha codes. |
| customdata | string | 可选特性,允许竞价方在交易平台的 cookie 中设置数据。字符串须采用 base85 cookie 安全字符,格式不限;如需包含转义的引号,必须使用规范的 JSON 编码。译稿校对中ENOptional feature to allow a bidder to set data 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. |
| nbr | integer | 不出价的原因。参见列表 5.24(List 5.24)。译稿校对中ENReason for not bidding. Refer to List 5.24. |
| ext | object | 供竞价方(bidder)对 OpenRTB 进行专属扩展(bidder-specific extensions)的占位对象。译稿校对中ENPlaceholder for bidder-specific extensions to OpenRTB. |
译注
译者注BidResponse:顶层竞价响应对象,即未命名的外层 JSON 对象;业内文档一般保留英文对象名 BidResponse。id 反映竞价请求 ID,用于日志对账;除至少一个 SeatBid(出价时)外,其余属性均为可选。译稿校对中
bidid 与赢标通知:bidid 是竞价方生成的响应跟踪 ID;若竞价方胜出,可将其包含在后续的赢标通知(win notice)调用中,供双方对账与归因。注意与请求侧 Source.tid 区分:tid 是请求级交易标识,bidid 是响应级跟踪标识。译稿校对中
seatbid 结构:出价时至少需要一个 SeatBid 对象,其中至少含一条针对某展示的出价(bid);SeatBid 按席位(seat)组织出价,多个席位可同时出价。译稿校对中
no-bid 的两种表达:返回 HTTP 204 空响应;或仅返回带 nbr 原因码(列表 5.24)的 BidResponse 对象,向交易平台传达不出价的原因。后者更利于交易平台统计不出价原因、优化请求分发,具体约定以交易平台接入要求为准。译稿校对中
customdata 的流向:与请求侧 User.customdata(交易平台 → 竞价方)方向相反,此处是竞价方 → 交易平台 cookie 的写入通道;编码要求一致(base85 cookie 安全字符 + JSON 转义)。译稿校对中
ext 的方向差异:响应侧的 ext 供竞价方(bidder)做专属扩展,与请求侧对象中供交易平台(exchange)扩展的 ext 方向相反,解析与约定时应区分两侧。译稿校对中
字段描述已与 2.6 官方 draft 对账;2.5 独有字段来自第三方 Go 实现源(Apache 2.0),官方 PDF 兜底校对 · 初稿校对中