该对象是顶层竞价响应（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 reflects 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。译稿校对中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 代码。译稿校对中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 | 不出价的原因。参见 OpenRTB 3.0 列表：不出价原因码（List: No-Bid Reason Codes）。译稿校对中ENReason for not bidding. Refer to List: No-Bid Reason Codes in OpenRTB 3.0. |
| ext | object | 供竞价方（bidder）对 OpenRTB 进行专属扩展（bidder-specific extensions）的占位对象。译稿校对中ENPlaceholder for bidder-specific extensions to OpenRTB. |
译注
译者注BidResponse：顶层响应对象（未命名的外层 JSON 对象）；id 反映请求 ID 用于日志对账，bidid 是竞价方侧可选的响应跟踪 ID，胜出时可携带于赢标通知中。译稿校对中
no-bid 的两种表达：返回 HTTP 204 空响应；或仅返回带 nbr 原因码的 BidResponse，向交易平台传达不出价原因。后者利于交易平台统计不出价原因、优化请求分发，业界鼓励使用。译稿校对中
customdata 的流向：与请求侧 User.customdata（交易平台 → 竞价方）方向相反，此处是竞价方 → 交易平台 cookie 的写入通道；编码要求一致（base85 + JSON 转义）。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范（CC-BY 3.0）· 枚举值来源 AdCOM 1.0 · 初稿校对中