该对象构成买方与卖方事先(a priori)达成的具体交易(deal)。它出现在 Pmp 集合中,即表示该展示可按该交易的条款获取。更多细节参见第 7.3 节。译稿校对中ENThis object constitutes a specific deal that was struck a priori between a buyer and a seller. Its presence with the Pmp collection indicates that this impression is available under the terms of that deal. Refer to Section 7.3 for more details.
| Attribute | Type | Description |
|---|---|---|
| id required | string | 直接交易(direct deal)的唯一标识符。必填(required)。译稿校对中ENA unique identifier for the direct deal. |
| bidfloor default 0 | float | 该展示的最低出价,以 CPM(Cost Per Mille,每千次展示成本)计价。默认值为 0。译稿校对中ENMinimum bid for this impression expressed in CPM. |
| bidfloorcur default ”USD” | string | 指定币种,采用 ISO-4217 alpha 代码。若交易平台允许,它可以不同于竞价方返回的出价币种。默认值为 “USD”。译稿校对中ENCurrency specified using ISO-4217 alpha codes. This may be different from bid currency returned by bidder if this is allowed by the exchange. |
| at | integer | 可选,用于覆盖竞价请求整体的拍卖类型:1 = 第一价格拍卖(First Price),2 = 第二价格加价拍卖(Second Price Plus),3 = bidfloor 传递的取值即双方约定的成交价。交易平台可定义额外的拍卖类型。译稿校对中ENOptional override of the overall auction type of the bid request, where 1 = First Price, 2 = Second Price Plus, 3 = the value passed in bidfloor is the agreed upon deal price. Additional auction types can be defined by the exchange. |
| wseat | string[] | 允许参与该交易竞价的买方席位(buyer seats,如广告主、代理商)白名单。席位 ID 与其所指代的买方客户之间的映射,必须由竞价方与交易平台事先(a priori)协调一致。省略则表示无席位限制。译稿校对中ENWhitelist of buyer seats (e.g., advertisers, agencies) allowed to bid on this deal. IDs of seats and the buyer's customers to which they refer must be coordinated between bidders and the exchange a priori. Omission implies no seat restrictions. |
| wadomain | string[] | 允许参与该交易竞价的广告主域名(如 advertiser.com)数组。省略则表示无广告主限制。译稿校对中ENArray of advertiser domains (e.g., advertiser.com) allowed to bid on this deal. Omission implies no advertiser restrictions. |
| ext | object | 供交易平台(exchange)对 OpenRTB 进行专属扩展(exchange-specific extensions)的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Deal:Pmp 的子对象,表示买卖双方事先(a priori)达成的具体交易;业内文档一般保留英文对象名 Deal。Deal 出现在 Pmp 集合中,即表示该展示可按该交易条款参与竞价。程序化直购(programmatic direct)家族中的优先交易(preferred deal)、私有竞价(private auction)、程序化保量(programmatic guaranteed)均在此基础上表达。译稿校对中
交易类型判读:业界惯用判读方式——at = 3 且 bidfloor 即成交价 → 固定价格的优先交易;at = 1/2 且带白名单 → 私有竞价;程序化保量(PG)通常需借助 ext 扩展另行表达。解析时建议先读 at 再读 bidfloor,避免误把底价当成交价。译稿校对中
CPM:Cost Per Mille,每千次展示成本,程序化广告的通用计价单位。bidfloor 即按 CPM 表达的最低出价。译稿校对中
First Price / Second Price Plus:第一价格拍卖(中标者按出价结算)与第二价格加价拍卖(中标者按次高价加最小增量结算),业界惯称“一价拍卖”“二价拍卖”。当前行业主流已转向一价拍卖,与 BidRequest.at 的取值语义一致,此处为 Deal 级覆盖。译稿校对中
wseat / wadomain:两层白名单限制——seat 是买方侧的交易席位(竞价方账号下的广告主或代理商),wadomain 则按广告主域名限制;二者可同时生效,省略即无对应限制。席位映射未事先协调一致时,白名单将无法正确解析。译稿校对中
bidfloorcur 与出价币种:底价币种与竞价方返回的出价币种可以不同(需交易平台允许),买方侧需自行处理汇率换算与结算口径,避免因币种错配导致出价被拒。译稿校对中
字段描述已与 2.6 官方 draft 对账;2.5 独有字段来自第三方 Go 实现源(Apache 2.0),官方 PDF 兜底校对 · 初稿校对中