顶层竞价请求对象包含一个全局唯一的竞价请求或拍卖 ID。id 属性为必填，且至少需包含一个展示对象（参见第 3.2.4 节）。该顶层对象中的其他属性建立适用于所有所提供展示的规则与约束。另有若干子对象向潜在买方提供详细数据，其中的 Site 与 App 对象描述展示所出现的已发布媒体类型；这两个对象强烈建议传递，但视媒体是基于浏览器的网页内容还是非浏览器应用，同一竞价请求只适用其一。译稿校对中ENThe top-level bid request object contains a globally unique bid request or auction ID. This id attribute is required as is at least one impression object (Section 3.2.4). Other attributes in this top-level object establish rules and restrictions that apply to all impressions being offered. There are also several subordinate objects that provide detailed data to potential buyers. Among these are the Site and App objects, which describe the type of published media in which the impression(s) appear. These objects are highly recommended, but only one applies to a given bid request depending on whether the media is browser-based web content or a non-browser application, respectively.
| Attribute | Type | Description |
|---|---|---|
| id required | string | 竞价请求的唯一 ID，由交易平台（exchange）提供。必填（required）。译稿校对中ENUnique ID of the bid request, provided by the exchange. |
| imp required | object[] | Imp 对象（参见第 3.2.4 节）数组，表示所提供的展示。至少需要 1 个 Imp 对象。必填（required）。译稿校对中ENArray of Imp objects (Section 3.2.4) representing the impressions offered. At least 1 Imp object is required. |
| site | object | 通过 Site 对象（参见第 3.2.13 节）传达的发布方网站详情。仅适用于网站，并建议传递。译稿校对中ENDetails via a Site object (Section 3.2.13) about the publisher's website. Only applicable and recommended for websites. |
| app | object | 通过 App 对象（参见第 3.2.14 节）传达的发布方应用（即非浏览器应用）详情。仅适用于应用，并建议传递。译稿校对中ENDetails via an App object (Section 3.2.14) about the publisher's app (i.e., non-browser applications). Only applicable and recommended for apps. |
| device | object | 通过 Device 对象（参见第 3.2.18 节）传达的用户设备详情，展示将下发至该设备。译稿校对中ENDetails via a Device object (Section 3.2.18) about the user's device to which the impression will be delivered. |
| user | object | 通过 User 对象（参见第 3.2.20 节）传达的设备背后真实用户（即广告受众）的详情。译稿校对中ENDetails via a User object (Section 3.2.20) about the human user of the device; the advertising audience. |
| test default 0 | integer | 测试模式指示标志，测试模式下的拍卖不计费：0 = 正式模式（live mode），1 = 测试模式。默认值为 0。译稿校对中ENIndicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test mode. |
| at default 2 | integer | 拍卖类型：1 = 第一价格拍卖（First Price），2 = 第二价格加价拍卖（Second Price Plus）。大于 500 的取值可用于定义交易平台专属的拍卖类型。默认值为 2。译稿校对中ENAuction type, where 1 = First Price, 2 = Second Price Plus. Exchange-specific auction types can be defined using values greater than 500. |
| tmax | integer | 交易平台允许接收出价的最大时限（含互联网延迟），单位为毫秒，以避免超时。该取值取代交易平台事先给出的任何指引。译稿校对中ENMaximum time in milliseconds the exchange allows for bids to be received including Internet latency to avoid timeout. This value supersedes any a priori guidance from the exchange. |
| wseat | string[] | 允许参与本展示竞价的买方席位（buyer seats，如广告主、代理商）白名单。席位 ID 及其所指代的买方客户信息，必须由竞价方与交易平台事先（a priori）协调一致。同一请求中，wseat 与 bseat 至多使用其一；两者均省略则表示无席位限制。译稿校对中ENWhite list of buyer seats (e.g., advertisers, agencies) allowed to bid on this impression. IDs of seats and knowledge of the buyer's customers to which they refer must be coordinated between bidders and the exchange a priori. At most, only one of wseat and bseat should be used in the same request. Omission of both implies no seat restrictions. |
| bseat | string[] | 被限制参与本展示竞价的买方席位（如广告主、代理商）黑名单。席位 ID 及其所指代的买方客户信息，必须由竞价方与交易平台事先（a priori）协调一致。同一请求中，wseat 与 bseat 至多使用其一；两者均省略则表示无席位限制。译稿校对中ENBlock list of buyer seats (e.g., advertisers, agencies) restricted from bidding on this impression. IDs of seats and knowledge of the buyer's customers to which they refer must be coordinated between bidders and the exchange a priori. At most, only one of wseat and bseat should be used in the same request. Omission of both implies no seat restrictions. |
| allimps default 0 | integer | 指示交易平台能否核实所提供的展示即上下文中全部可用展示（如网页上的所有展示、前插/中插/后插等全部视频广告位），以支持独家包段（road-blocking）：0 = 否或未知，1 = 是，即所提供的展示即全部可用展示。默认值为 0。译稿校对中ENFlag to indicate if Exchange can verify that the impressions offered represent all of the impressions available in context (e.g., all on the web page, all video spots such as pre/mid/post roll) to support road-blocking. 0 = no or unknown, 1 = yes, the impressions offered represent all that are available. |
| cur | string[] | 本竞价请求允许的出价币种数组，采用 ISO-4217 alpha 代码。仅当交易平台接受多种币种时建议传递。译稿校对中ENArray of allowed currencies for bids on this bid request using ISO-4217 alpha codes. Recommended only if the exchange accepts multiple currencies. |
| wlang | string[] | 创意语言白名单，采用 ISO-639-1-alpha-2。省略表示无特定限制，但建议买方在可用时参考 Device 和/或 Content 对象中的 language 属性。译稿校对中ENWhite list of languages for creatives using ISO-639-1-alpha-2. Omission implies no specific restrictions, but buyers would be advised to consider language attribute in the Device and/or Content objects if available. |
| bcat | string[] | 被拦截的广告主行业分类，采用 IAB 内容分类。参见列表 5.1（List 5.1）。译稿校对中ENBlocked advertiser categories using the IAB content categories. Refer to List 5.1. |
| badv | string[] | 按域名拦截的广告主黑名单（如 “ford.com”）。译稿校对中ENBlock list of advertisers by their domains (e.g., "ford.com"). |
| bapp | string[] | 按平台专属、独立于交易平台的应用标识符拦截的应用黑名单。在 Android 上应为包名（bundle 或 package name，如 com.foo.mygame）；在 iOS 上为数字 ID。译稿校对中ENBlock list of applications by their platform-specific exchange independent application identifiers. On Android, these should be bundle or package names (e.g., com.foo.mygame). On iOS, these are numeric IDs. |
| source | object | Source 对象（参见第 3.2.2 节），提供关于库存来源以及由哪个实体做最终决策的数据。译稿校对中ENA Source object (Section 3.2.2) that provides data about the inventory source and which entity makes the final decision. |
| regs | object | Regs 对象（参见第 3.2.3 节），规定对本请求生效的行业、法律或政府监管要求。译稿校对中ENA Regs object (Section 3.2.3) that specifies any industry, legal, or governmental regulations in force for this request. |
| ext | object | 供交易平台对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注BidRequest：整个竞价请求的顶层对象，含全局唯一的竞价请求或拍卖 ID；业内文档一般保留英文对象名 BidRequest。id 与至少一个 Imp 对象为必填；其余属性建立适用于所有展示的规则与约束。译稿校对中
顶层规则层：test/at/tmax/wseat/bseat/allimps/cur/wlang/bcat/badv/bapp 等属性构成请求级规则与约束，对其下所有 Imp 统一生效；Imp 或 Deal 级的同名字段（如 bidfloor、at）为更细粒度的覆盖或补充。译稿校对中
Site ⊕ App 互斥：二者分别刻画浏览器网页内容与非浏览器应用，同一请求只适用其一，取决于媒体形态；两者均强烈建议传递，缺失会显著影响语境化定向与品牌安全判断。译稿校对中
test：测试模式下的拍卖不计费，常用于接入调试与联调验证；竞价方在 test = 1 时不应将出价计入真实策略统计。译稿校对中
at 与拍卖类型：默认值为 2（二价加价拍卖），大于 500 的取值保留给交易平台自定义类型；行业主流已转向一价拍卖，实际结算规则应以 at 取值及交易平台公告为准。Deal 级的 at 可对具体交易另行覆盖。译稿校对中
tmax：含网络延迟在内的出价接收时限，超时即视为放弃；该取值优先于交易平台事先给出的任何指引，竞价方应以请求中的 tmax 为准控制计算预算。译稿校对中
wseat vs bseat：席位白名单与黑名单，同一请求中至多使用其一，两者均省略即无席位限制；席位 ID 与其所指代的买方客户须事先协调一致，否则无法解析。与 Deal.wseat 的区别：此处为请求级，Deal.wseat 为交易级。译稿校对中
allimps 与 road-blocking：road-blocking（独家包段）指买方买断某上下文内全部展示位的采买模式（如整页包断）；allimps = 1 表示交易平台可核实所提供展示即全部可用展示，是包段交易成立的前提信号。译稿校对中
bcat / badv / bapp：三层拦截机制——广告主行业分类（IAB 词表）、广告主域名、应用标识；它们与 Deal.wadomain、创意属性拦截（battr）共同构成品牌安全与竞争性过滤体系，竞价方出价前应逐层自检。译稿校对中
cur：允许的出价币种白名单；仅当交易平台接受多币种时建议传递。省略时通常默认为 USD 结算，接入时应与交易平台确认结算口径。译稿校对中
字段描述已与 2.6 官方 draft 对账；2.5 独有字段来自第三方 Go 实现源（Apache 2.0），官方 PDF 兜底校对 · 初稿校对中