该对象表示流内（in-stream）视频展示。其中许多字段对最小可行交易并非必需，但可在需要时提供精细控制。OpenRTB 中的视频通常假定符合 VAST（Video Ad Serving Template）标准；因此，伴生广告（companion ads）的概念通过可选地包含一个定义这些伴生广告的 Banner 对象数组（参见第 3.2.6 节的 Banner 对象）得到支持。Video 作为 Imp 的子对象出现，即表示该展示以视频类型提供；经发布方许可，同一展示还可通过在 Imp 下并列包含 banner、audio 和/或 native 类型对象的方式同时以这些类型提供，但针对该展示的任一具体出价，只能符合所供类型中的一种。译稿校对中ENThis object represents an in-stream video impression. Many of the fields are non-essential for minimally viable transactions, but are included to offer fine control when needed. Video in OpenRTB generally assumes compliance with the VAST standard. As such, the notion of companion ads is supported by optionally including an array of Banner objects (refer to the Banner object in Section 3.2.6) that define these companion ads. The presence of a Video as a subordinate of the Imp object indicates that this impression is offered as a video type impression. At the publisher's discretion, that same impression may also be offered as banner, 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 |
|---|---|---|
| mimes required | string[] | 支持的内容 MIME 类型（如 “video/x-ms-wmv”、“video/mp4”）。必填（required）。译稿校对中ENContent MIME types supported (e.g., "video/x-ms-wmv", "video/mp4"). |
| minduration | integer | 视频广告的最短时长，单位为秒。译稿校对中ENMinimum video ad duration in seconds. |
| maxduration | integer | 视频广告的最长时长，单位为秒。译稿校对中ENMaximum video ad duration in seconds. |
| protocols | integer[] | 支持的视频协议数组。参见列表 5.8（List 5.8）。protocol 与 protocols 两个属性中必须至少指定一个支持的协议。译稿校对中ENArray of supported video protocols. Refer to List 5.8. At least one supported protocol must be specified in either the protocol or protocols attribute.枚举 Creative Subtypes - Audio/Video · 16 个值1VAST 1.0 2VAST 2.0 3VAST 3.0 4VAST 1.0 Wrapper 5VAST 2.0 Wrapper 6VAST 3.0 Wrapper 7VAST 4.0 8VAST 4.0 Wrapper 9DAAST 1.0 10DAAST 1.0 Wrapper 11VAST 4.1 12VAST 4.1 Wrapper 其余 4 个值见枚举总览 → |
| protocol deprecated | integer | 已弃用（DEPRECATED），由 protocols 取代。支持的视频协议。参见列表 5.8（List 5.8）。protocol 与 protocols 两个属性中必须至少指定一个支持的协议。译稿校对中ENNOTE: Deprecated in favor of protocols. Supported video protocol. Refer to List 5.8. At least one supported protocol must be specified in either the protocol or protocols attribute. |
| w | integer | 视频播放器的宽度，以设备无关像素（Device Independent Pixels，DIPS）为单位。译稿校对中ENWidth of the video player in device independent pixels (DIPS). |
| h | integer | 视频播放器的高度，以设备无关像素（DIPS）为单位。译稿校对中ENHeight of the video player in device independent pixels (DIPS). |
| startdelay | integer | 指示前插（pre-roll）、中插（mid-roll）或后插（post-roll）广告位的起始延迟，单位为秒。更多通用取值参见列表 5.12（List 5.12）。译稿校对中ENIndicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. Refer to List 5.12 for additional generic values.枚举 Start Delay Modes · 4 个值>0Mid-Roll (value indicates start delay in second) 0Pre-Roll -1Generic Mid-Roll -2Generic Post-Roll |
| placement | integer | 该展示的投放类型（placement type）。参见列表 5.9（List 5.9）。译稿校对中ENPlacement type for the impression. Refer to List 5.9. |
| linearity | integer | 指示该展示是否必须为线性（linear）、非线性（nonlinear）等。未指定时视为全部允许。参见列表 5.7（List 5.7）。译稿校对中ENIndicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed. Refer to List 5.7.枚举 Linearity Modes · 2 个值1Linear 2Non-Linear (i.e., Overlay) |
| skip | integer | 指示播放器是否允许跳过该视频：0 = 否，1 = 是。若竞价方提交的标记/创意本身可跳过，Bid 对象应在 attr 数组中包含元素 16，表示可跳过视频。参见列表 5.3（List 5.3）。译稿校对中ENIndicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. If a bidder sends markup/creative that is itself skippable, the Bid object should include the attr array with an element of 16 indicating skippable video. 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 个值见枚举总览 → |
| skipmin default 0 | integer | 总时长大于该秒数的视频可被跳过；仅在广告可跳过时适用。默认值为 0。译稿校对中ENVideos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable. |
| skipafter default 0 | integer | 视频需播放的秒数，达到后才启用跳过；仅在广告可跳过时适用。默认值为 0。译稿校对中ENNumber of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. |
| sequence | integer | 当同一竞价请求中提供多个广告展示时，该序号用于支持多个创意的协同投放。译稿校对中ENIf multiple ad impressions are offered in the same bid request, the sequence number will allow for the coordinated delivery of multiple creatives. |
| 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 个值见枚举总览 → |
| maxextended | integer | 允许延时（extension）时的最长延时广告时长。为空或 0 表示不允许延时；-1 表示允许延时且不设时限；大于 0 时，取值表示在 maxduration 之外支持的延长播放秒数。译稿校对中ENMaximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value. |
| minbitrate | integer | 最低码率，单位为 Kbps。译稿校对中ENMinimum bit rate in Kbps. |
| maxbitrate | integer | 最高码率，单位为 Kbps。译稿校对中ENMaximum bit rate in Kbps. |
| boxingallowed default 1 | integer | 指示是否允许将 4:3 内容以信箱式（letter-boxing）方式装入 16:9 窗口：0 = 否，1 = 是。默认值为 1。译稿校对中ENIndicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yes. |
| playbackmethod | integer[] | 可能使用的播放方式。未指定时视为任何方式均可使用。参见列表 5.10（List 5.10）。实践中通常只使用一种方式，因此未来规范版本可能将该数组改为整数；为应对这一变化，强烈建议仅使用本数组的第一个元素。译稿校对中ENPlayback methods that may be in use. If none are specified, any method may be used. Refer to List 5.10. Only one method is typically used in practice. As a result, this array may be converted to an integer in a future version of the specification. It is strongly advised to use only the first element of this array in preparation for this change.枚举 Playback Methods · 11 个值1Initiates without any specific user interaction with Sound On 2Initiates without any specific user interaction Sound Off by Default 3Initiates on Click with Sound On 4Initiates on Mouse-Over or cursor over with Sound On 5Initiates on Entering Viewport or scrolling into view with Sound On 6Initiates on Entering Viewport or scrolling into view with Sound Off by Default 7Continuous Playback - Media playback is set to play additional media automatically without user interaction. The media player will keep playing additional media (playlist or generated) for the user until the user actively stops this from happening. 8Initiated by user pausing content, Sound on 9Initiated by user pausing content, Sound off 10Initiated by idling (e.g. screensaver), Sound on 11Initiated by idling (e.g. screensaver), Sound off |
| playbackend | integer | 导致播放结束的事件。参见列表 5.11（List 5.11）。译稿校对中ENThe event that causes playback to end. Refer to List 5.11. |
| delivery | integer[] | 支持的分发方式（如流式 streaming、渐进式 progressive）。未指定时视为全部支持。参见列表 5.15（List 5.15）。译稿校对中ENSupported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List 5.15.枚举 Delivery Methods · 3 个值1Streaming 2Progressive 3Download |
| 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 个值见枚举总览 → |
| companionad | object[] | Banner 对象（参见第 3.2.6 节）数组，在伴生广告（companion ads）可用时使用。译稿校对中ENArray of Banner objects (Section 3.2.6) if companion ads are available. |
| 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. |
| companiontype | integer[] | 支持的 VAST 伴生广告类型。参见列表 5.14（List 5.14）。当通过 companionad 数组包含伴生 Banner 对象时建议传递。若其中一个 banner 将作为尾帧（end-card）渲染，可通过该 banner 的 vcm 属性指定（参见第 3.2.6 节）。译稿校对中ENSupported VAST companion ad types. Refer to List 5.14. Recommended if companion Banner objects are included via the companionad array. If one of these banners will be rendered as an end-card, this can be specified using the vcm attribute with the particular banner (Section 3.2.6).枚举 Companion Types · 3 个值1Static Resource 2HTML Resource 3iframe Resource |
| ext | object | 供交易平台（exchange）对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Video：Imp 的子对象，表示流内（in-stream）视频展示；业内文档一般保留英文对象名 Video。大量字段对最小可行交易并非必需，仅在需要精细控制时使用。译稿校对中
VAST：Video Ad Serving Template，视频广告投放模板，IAB 制定的视频广告核心下发标准。伴生广告（companion ads）通过可选的 companionad 数组（Banner 对象）表达。译稿校对中
protocol vs protocols：protocol（单数）已弃用，由 protocols 数组取代；两者中必须至少指定一个支持的协议，新接入方应只使用 protocols。译稿校对中
linear vs nonlinear：线性视频在内容时间线内播放（前插/中插/后插）；非线性视频叠于播放器之上（如 overlay 贴片），具体取值见列表 5.7。未指定时两者均允许。译稿校对中
skip 的双层表达：skip 描述播放器是否允许跳过；若创意本身自带跳过能力，竞价方还须在 Bid.attr 中声明 16（可跳过视频）。skipmin（总时长门槛）与 skipafter（播放秒数门槛）进一步细化跳过条件，均仅在可跳过时生效。译稿校对中
boxingallowed：信箱式（letter-boxing）指将 4:3 内容加装黑边装入 16:9 窗口；默认值为 1（允许）。拒绝信箱式的流量方通常期望创意原生适配宽高比。译稿校对中
playbackmethod / playbackend：播放触发方式（自动播放有声/静音、点击播放等，列表 5.10）与播放结束事件（列表 5.11），是可见性（viewability）测量与计费的关键信号。规范预告 playbackmethod 数组未来可能改为整数，现应只读第一个元素。译稿校对中
vcm 与尾帧（end-card）：尾帧指视频播完后留存的静态 banner；companiontype 声明伴生广告类型，具体哪个 banner 充当尾帧则由该 Banner 对象的 vcm 属性指定。译稿校对中
字段描述已与 2.6 官方 draft 对账；2.5 独有字段来自第三方 Go 实现源（Apache 2.0），官方 PDF 兜底校对 · 初稿校对中