该对象表示最通用的展示类型。虽然 “banner” 一词在其他语境中可能有非常特定的含义，但在这里它可以是多种形态：简单的静态图片、可展开的广告单元，甚至 banner 内嵌视频（in-banner video，更通用、功能更全的视频广告单元参见第 3.2.7 节的 Video 对象）。Banner 对象数组也可出现于 Video 内部，描述 VAST 规范定义的可选伴生广告（companion ads）。Banner 作为 Imp 的子对象出现，即表示该展示以 banner 类型提供；经发布方许可，同一展示还可通过在 Imp 下并列包含 video、audio 和/或 native 类型对象的方式同时以这些类型提供，但针对该展示的任一具体出价，只能符合所供类型中的一种。译稿校对中ENThis object represents the most general type of impression. Although the term "banner" may have very specific meaning in other contexts, here it can be many things including a simple static image, an expandable ad unit, or even in-banner video (refer to the Video object in Section 3.2.7 for the more generalized and full featured video ad units). An array of Banner objects can also appear within the Video to describe optional companion ads defined in the VAST specification. The presence of a Banner as a subordinate of the Imp object indicates that this impression is offered as a banner type impression. At the publisher's discretion, that same impression may also be offered as video, audio, and/or native by also including as Imp subordinates objects of those types. However, any given bid for the impression must conform to one of the offered types.
| Attribute | Type | Description |
|---|---|---|
| format | object[] | Format 对象（参见第 3.2.10 节）数组，表示允许的 banner 尺寸。未指定时，强烈建议使用 h 与 w 属性。译稿校对中ENArray of format objects (Section 3.2.10) representing the banner sizes permitted. If none are specified, then use of the h and w attributes is highly recommended. |
| w | integer | 精确宽度，以设备无关像素（Device Independent Pixels，DIPS）为单位；未指定 Format 对象时建议传递。译稿校对中ENExact width in device independent pixels (DIPS); recommended if no format objects are specified. |
| h | integer | 精确高度，以设备无关像素（DIPS）为单位；未指定 Format 对象时建议传递。译稿校对中ENExact height in device independent pixels (DIPS); recommended if no format objects are specified. |
| wmax deprecated | integer | 已弃用（DEPRECATED），由 format 数组取代。最大宽度，以设备无关像素（DIPS）为单位。译稿校对中ENNOTE: Deprecated in favor of the format array. Maximum width in device independent pixels (DIPS). |
| hmax deprecated | integer | 已弃用（DEPRECATED），由 format 数组取代。最大高度，以设备无关像素（DIPS）为单位。译稿校对中ENNOTE: Deprecated in favor of the format array. Maximum height in device independent pixels (DIPS). |
| wmin deprecated | integer | 已弃用（DEPRECATED），由 format 数组取代。最小宽度，以设备无关像素（DIPS）为单位。译稿校对中ENNOTE: Deprecated in favor of the format array. Minimum width in device independent pixels (DIPS). |
| hmin deprecated | integer | 已弃用（DEPRECATED），由 format 数组取代。最小高度，以设备无关像素（DIPS）为单位。译稿校对中ENNOTE: Deprecated in favor of the format array. Minimum height in device independent pixels (DIPS). |
| btype | integer[] | 被拦截的 banner 广告类型。参见列表 5.2（List 5.2）。译稿校对中ENBlocked banner ad types. Refer to List 5.2. |
| battr | integer[] | 被拦截的创意属性。参见列表 5.3（List 5.3）。译稿校对中ENBlocked creative attributes. Refer to List 5.3.枚举 Creative Attributes · 24 个值1Audio Ad (Autoplay) 2Audio Ad (User Initiated) 3Expandable (Automatic) 4Expandable (User Initiated - Click) 5Expandable (User Initiated - Rollover) 6In-Banner Video Ad (Autoplay) 7In-Banner Video Ad (User Initiated) 8Pop (e.g., Over, Under, or Upon Exit) 9Provocative or Suggestive Imagery 10Shaky, Flashing, Flickering, Extreme Animation, Smileys 11Surveys 12Text Only 其余 12 个值见枚举总览 → |
| pos | integer | 广告在屏幕上的位置。参见列表 5.4（List 5.4）。译稿校对中ENAd position on screen. Refer to List 5.4.枚举 Placement Positions · 18 个值0Unknown 1Above The Fold 2Locked (i.e., fixed position) 3Below The Fold 4Header 5Footer 6Sidebar 7Fullscreen 8Partial Screen 9Top Left 10Top Right 11Frame the content 其余 6 个值见枚举总览 → |
| mimes | string[] | 支持的内容 MIME 类型。常见的 MIME 类型如 “application/x-shockwave-flash”、“image/jpg”、“image/gif” 等。译稿校对中ENContent MIME types supported. Popular MIME types may include "application/x-shockwave-flash", "image/jpg", and "image/gif". |
| topframe | integer | 指示该 banner 是否位于顶层框架（top frame）而非 iframe 中：0 = 否，1 = 是。译稿校对中ENIndicates if the banner is in the top frame as opposed to an iframe, where 0 = no, 1 = yes. |
| expdir | integer[] | banner 可展开的方向。参见列表 5.5（List 5.5）。译稿校对中ENDirections in which the banner may expand. Refer to List 5.5.枚举 Expandable Directions · 6 个值1Left 2Right 3Up 4Down 5Full Screen 6Resize/Minimize (make smaller) |
| api | integer[] | 该展示所支持的 API 框架列表。参见列表 5.6（List 5.6）。未明确列出的 API 视为不支持。译稿校对中ENList of supported API frameworks for this impression. Refer to List 5.6. If an API is not explicitly listed, it is assumed not to be supported.枚举 API Frameworks · 10 个值1VPAID 1.0 2VPAID 2.0 3MRAID 1.0 4ORMMA 5MRAID 2.0 6MRAID 3.0 7OMID 1.0 8SIMID 1.0 9SIMID 1.1 500+Vendor-specific codes. |
| id | string | 本 Banner 对象的唯一标识符。当 Banner 对象与 Video 对象（参见第 3.2.7 节）配合表示伴生广告（companion ads）数组时建议传递。取值通常从 1 开始逐个递增，且应在同一展示内保持唯一。译稿校对中ENUnique identifier for this banner object. Recommended when Banner objects are used with a Video object (Section 3.2.7) to represent an array of companion ads. Values usually start at 1 and increase with each object; should be unique within an impression. |
| vcm | integer | 仅适用于在伴生广告数组中与 Video 对象（参见第 3.2.7 节）配合使用的 Banner 对象。指示伴生 banner 相对关联视频的渲染模式：0 = 伴随渲染（concurrent），1 = 尾帧渲染（end-card）。译稿校对中ENRelevant only for Banner objects used with a Video object (Section 3.2.7) in an array of companion ads. Indicates the companion banner rendering mode relative to the associated video, where 0 = concurrent, 1 = end-card. |
| ext | object | 供交易平台（exchange）对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Banner：最通用的展示类型对象，业内文档一般保留英文对象名 Banner。它有两种挂载场景：直接作为 Imp 的子对象（banner 类型展示），或出现于 Video.companionad 数组中描述 VAST 规范定义的伴生广告。译稿校对中
banner 一词的泛化：虽然 “banner” 在其他语境中可能有特定含义，但在 OpenRTB 中它可以是简单静态图片、可展开广告单元（expandable ad unit），甚至 banner 内嵌视频（in-banner video）；更通用、功能更全的视频广告单元应使用 Video 对象。译稿校对中
尺寸表达的三代演进：format 数组是现代表达方式（支持多尺寸与弹性尺寸）；w/h 是未提供 format 时的精确尺寸回退，强烈建议传递；wmax/hmax/wmin/hmin 四个字段均已弃用，由 format 取代，向后兼容时应将其归并到 format 处理。译稿校对中
btype / battr / expdir：分别拦截广告类型（列表 5.2，如 iframe/xhr 加载、视频内嵌等）、创意属性（列表 5.3，与 Video 同词表）与展开方向（列表 5.5）；未列出的类型/属性即允许，属黑名单机制。译稿校对中
topframe：顶层框架与 iframe 的区别直接影响创意能力与可见性：顶层框架内的创意可获取更多浏览器能力，可见性测量也更可靠；业界常见做法是将重要广告位置于 top frame。译稿校对中
id / vcm：二者均服务于伴生广告场景——id 在同一展示内唯一（通常从 1 递增）；vcm 声明伴生 banner 是与视频伴随渲染（0）还是作为尾帧（end-card，1）渲染，与 Video.companiontype 配套使用。译稿校对中
mimes 中的 Flash：示例中的 application/x-shockwave-flash 反映了规范成文时的技术背景；Flash 现已停用，实践中 banner 创意以 image/* 与 HTML5 为主。译稿校对中
字段描述已与 2.6 官方 draft 对账；2.5 独有字段来自第三方 Go 实现源（Apache 2.0），官方 PDF 兜底校对 · 初稿校对中