该对象描述正在拍卖的广告位（ad placement）或展示（impression）。一个竞价请求可包含多个 Imp 对象，其用例可以是支持售卖指定页面上所有广告位的交易平台。每个 Imp 对象都有一个必填的 ID，以便出价能逐一引用它们。Banner（第 3.2.6 节）、Video（第 3.2.7 节）和/或 Native（第 3.2.9 节）对象作为 Imp 的子对象出现，即表明所提供展示的类型。发布方可选择其中一种类型（典型情形），也可自行许可混售；但针对该展示的任一具体出价，只能符合所供类型中的一种。译稿校对中ENThis object describes an ad placement or impression being auctioned. A single bid request can include multiple Imp objects, a use case for which might be an exchange that supports selling all ad positions on a given page. Each Imp object has a required ID so that bids can reference them individually. The presence of Banner (Section 3.2.6), Video (Section 3.2.7), and/or Native (Section 3.2.9) objects subordinate to the Imp object indicates the type of impression being offered. The publisher can choose one such type which is the typical case or mix them at their discretion. However, any given bid for the impression must conform to one of the offered types.
| Attribute | Type | Description |
|---|---|---|
| id required | string | 本展示在竞价请求上下文内的唯一标识符（通常从 1 开始递增）。必填（required）。译稿校对中ENA unique identifier for this impression within the context of the bid request (typically, starts with 1 and increments). |
| metric | object[] | Metric 对象（参见第 3.2.5 节）数组。译稿校对中ENAn array of Metric object (Section 3.2.5). |
| banner | object | Banner 对象（参见第 3.2.6 节）；当该展示以 banner 广告机会提供时必填。译稿校对中ENA Banner object (Section 3.2.6); required if this impression is offered as a banner ad opportunity. |
| video | object | Video 对象（参见第 3.2.7 节）；当该展示以视频广告机会提供时必填。译稿校对中ENA Video object (Section 3.2.7); required if this impression is offered as a video ad opportunity. |
| audio | object | Audio 对象（参见第 3.2.8 节）；当该展示以音频广告机会提供时必填。译稿校对中ENAn Audio object (Section 3.2.8); required if this impression is offered as an audio ad opportunity. |
| native | object | Native 对象（参见第 3.2.9 节）；当该展示以原生广告机会提供时必填。译稿校对中ENA Native object (Section 3.2.9); required if this impression is offered as a native ad opportunity. |
| pmp | object | Pmp 对象（参见第 3.2.11 节），包含对该展示生效的私有交易市场交易。译稿校对中ENA Pmp object (Section 3.2.11) containing any private marketplace deals in effect for this impression. |
| displaymanager | string | 负责渲染广告的广告聚合合作方（ad mediation partner）、SDK 技术或播放器的名称（通常为视频或移动场景）。部分广告服务器用它按合作方定制广告代码。视频和/或应用场景建议传递。译稿校对中ENName of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. Recommended for video and/or apps. |
| displaymanagerver | string | 负责渲染广告的广告聚合合作方、SDK 技术或播放器的版本号（通常为视频或移动场景）。部分广告服务器用它按合作方定制广告代码。视频和/或应用场景建议传递。译稿校对中ENVersion of ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner. Recommended for video and/or apps. |
| instl default 0 | integer | 1 = 广告为插屏（interstitial）或全屏，0 = 非插屏。默认值为 0。译稿校对中EN1 = the ad is interstitial or full screen, 0 = not interstitial. |
| tagid | string | 用于发起本次拍卖的特定广告位或广告标签（ad tag）的标识符。可用于问题排查，或供买方做优化。译稿校对中ENIdentifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer. |
| 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. |
| clickbrowser | integer | 指示在应用内点击创意时打开的浏览器类型：0 = 嵌入式（embedded），1 = 原生（native）。注意：就本属性而言，iOS 9.x 设备上的 Safari View Controller 被视为原生浏览器。译稿校对中ENIndicates the type of browser opened upon clicking the creative in an app, where 0 = embedded, 1 = native. Note that the Safari View Controller in iOS 9.x devices is considered a native browser for purposes of this attribute. |
| secure | integer | 指示该展示是否要求安全的 HTTPS URL 创意素材与标记：0 = 非安全，1 = 安全。省略时安全状态未知，但可假定支持非安全 HTTP。译稿校对中ENFlag to indicate if the impression requires secure HTTPS URL creative assets and markup, where 0 = non-secure, 1 = secure. If omitted, the secure state is unknown, but non-secure HTTP support can be assumed. |
| iframebuster | string[] | 受支持的 iframe 破框器（iframe buster）的交易平台专属名称数组。译稿校对中ENArray of exchange-specific names of supported iframe busters. |
| exp | integer | 参考值，指示拍卖与实际展示之间可能经过的秒数。译稿校对中ENAdvisory as to the number of seconds that may elapse between the auction and the actual impression. |
| ext | object | 供交易平台（exchange）对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Imp：竞价请求的核心对象，描述正在拍卖的广告位/展示；业内文档一般保留英文对象名 Imp。一个请求可含多个 Imp（如整页多广告位售卖），各 Imp 由必填的 id 唯一标识，出价（bid）通过 impid 引用对应的 Imp。译稿校对中
类型声明机制：展示的提供类型由 banner/video/audio/native 子对象的存在性声明；发布方可只选一种（典型情形），也可自行许可混售，但任一具体出价只能符合所供类型中的一种。译稿校对中
displaymanager / displaymanagerver：渲染侧技术标识（聚合 SDK/播放器），供广告服务器按合作方定制广告代码；视频与 app 场景建议传递，是排查渲染兼容问题的重要线索。译稿校对中
instl：插屏（interstitial）/全屏广告标志。插屏广告的创意规格、展示时机与出价策略与普通页内广告均有差异，解析时应单独处理。译稿校对中
tagid：广告位/广告标签标识，业界惯称 ad tag ID；既是排查投放问题的定位键，也是买方做位置级优化的依据。注意与 Site/App 级 id 区分：tagid 细到具体广告位。译稿校对中
bidfloor / bidfloorcur：Imp 级最低出价与币种，语义与 Deal 同名字段一致；当 Pmp 中某 Deal 另行指定时，以 Deal 级取值为准（交易条款优先）。译稿校对中
clickbrowser：应用内点击后的浏览器行为——嵌入式（应用内 WebView）与原生（系统浏览器）在体验与归因上均有差异；iOS 9.x 的 Safari View Controller 按原生计。译稿校对中
secure：HTTPS 要求标志。省略表示状态未知但可假定支持 HTTP；随行业全面转向 HTTPS，secure = 1 已成主流，未适配 HTTPS 的创意在多数主流流量上无法渲染。译稿校对中
iframebuster：iframe 破框器，指使创意突破 iframe 边界在顶层页面渲染的技术；取值为交易平台专属名称，跨平台不通用。随 HTML5 普及已逐步退出主流。译稿校对中
exp：出价有效期参考值（拍卖到实际展示之间可能经过的秒数）；在 header bidding 等竞价与展示间隔较长的链路中，买方应据此控制创意/预算的时效性风险。译稿校对中
字段描述已与 2.6 官方 draft 对账；2.5 独有字段来自第三方 Go 实现源（Apache 2.0），官方 PDF 兜底校对 · 初稿校对中