该对象表示最通用的展示类型。虽然 “banner” 一词在其他语境中可能有非常特定的含义,但在这里它可以是多种形态:简单的静态图片、可展开的广告单元,甚至 banner 内嵌视频(更通用、功能更全的视频广告单元参见第 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. |
| btype | integer[] | 被拦截的 banner 广告类型。取值:1 = XHTML 文本广告,2 = XHTML 横幅广告,3 = JavaScript 广告,4 = iframe。译稿校对中ENBlocked banner ad types. Values: 1 = XHTML Text Ad, 2 = XHTML Banner Ad, 3 = JavaScript Ad, 4 = iframe. |
| battr | integer[] | 被拦截的创意属性。参见 AdCOM 1.0 列表:创意属性(List: Creative Attributes)。译稿校对中ENBlocked creative attributes. Refer to List: Creative Attributes in AdCOM 1.0.枚举 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 | 广告在屏幕上的位置。参见 AdCOM 1.0 列表:广告位位置(List: Placement Positions)。译稿校对中ENAd position on screen. Refer to List: Placement Positions in AdCOM 1.0.枚举 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 类型如 “image/jpeg”、“image/gif” 等。译稿校对中ENContent MIME types supported. Popular MIME types may include “image/jpeg” 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 可展开的方向。参见 AdCOM 1.0 列表:可展开方向(List: Expandable Directions)。译稿校对中ENDirections in which the banner may expand. Refer to List: Expandable Directions in AdCOM 1.0.枚举 Expandable Directions · 6 个值1Left 2Right 3Up 4Down 5Full Screen 6Resize/Minimize (make smaller) |
| api | integer[] | 该展示所支持的 API 框架列表。参见 AdCOM 1.0 列表:API 框架(List: API Frameworks)。未明确列出的 API 视为不支持。译稿校对中ENList of supported API frameworks for this impression. Refer to List: API Frameworks in AdCOM 1.0. 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 在 2.6 中的定位:仍是最通用的展示类型对象,但 2.6 已移除 2.5 中弃用的 wmax/hmax/wmin/hmin 字段,尺寸表达统一收敛到 format 数组与 w/h 精确值;接入 2.6 的存量系统应在序列化层清理这些旧字段。译稿校对中
btype 的取值含义:直接内联枚举了四种被拦截的加载方式(XHTML 文本/横幅、JavaScript、iframe);实践中主要拦截 JavaScript 与 iframe 类型以控制安全与性能风险,出价前应核对创意交付形态。译稿校对中
id / vcm 的伴生广告配套:伴生广告场景下,id 用于关联 VAST 中的伴生创意,vcm 声明渲染模式(伴随/尾帧);未传 id 会导致播放器无法将伴生 banner 与 VAST 标记对应。译稿校对中
topframe 与可见性:顶层框架内的创意能力与可见性测量均优于 iframe;买方在可见性导向的采买中应关注该标志,并在定价模型中区分。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范(CC-BY 3.0)· 枚举值来源 AdCOM 1.0 · 初稿校对中