该对象表示视频展示。其中许多字段对最小可行交易并非必需，但可在需要时提供精细控制。OpenRTB 中的视频通常假定符合 VAST 标准；因此，伴生广告（companion ads）的概念通过可选地包含一个定义这些伴生广告的 Banner 对象数组（参见第 3.2.6 节的 Banner 对象）得到支持。Video 作为 Imp 的子对象出现，即表示该展示以视频类型提供；经发布方许可，同一展示还可通过在 Imp 下并列包含 Banner、Audio 和/或 Native 类型对象的方式同时以这些类型提供，但针对该展示的任一具体出价，只能符合所供类型中的一种。译稿校对中ENThis object represents a 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/mp4”）。译稿校对中ENContent MIME types supported (e.g., "video/mp4"). |
| minduration default 0 | integer | 视频广告的最短时长，单位为秒。本字段与 rqddurs 互斥；竞价请求中 minduration 与 rqddurs 只能出现其一。译稿校对中ENMinimum video ad duration in seconds. This field is mutually exclusive with rqddurs; only one of minduration and rqddurs may be in a bid request. |
| maxduration | integer | 视频广告的最长时长，单位为秒。本字段与 rqddurs 互斥；竞价请求中 maxduration 与 rqddurs 只能出现其一。译稿校对中ENMaximum video ad duration in seconds. This field is mutually exclusive with rqddurs; only one of maxduration and rqddurs may be in a bid request. |
| startdelay | integer | 指示前插（pre-roll）、中插（mid-roll）或后插（post-roll）广告位的起始延迟，单位为秒。参见 AdCOM 1.0 列表：起始延迟模式（List: Start Delay Modes）。译稿校对中ENIndicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. Refer to List: Start Delay Modes in AdCOM 1.0.枚举 Start Delay Modes · 4 个值>0Mid-Roll (value indicates start delay in second) 0Pre-Roll -1Generic Mid-Roll -2Generic Post-Roll |
| maxseq | integer | 指示“动态”视频广告簇（dynamic video ad pod，广告精确数量不由卖方预先确定）中可投放的最大广告数。更多细节参见第 7.6 节。译稿校对中ENIndicates the maximum number of ads that may be served into a “dynamic” video ad pod (where the precise number of ads is not predetermined by the seller). See Section 7.6 for more details. |
| poddur | integer | 指示广告主可为“动态”视频广告簇（更多细节参见第 7.6 节）或“混合”广告簇的动态部分填充的总时长（秒）。仅对视频广告簇的动态部分必填。本字段指整个广告断（ad break）的时长，而 minduration/maxduration/rqddurs 是构成广告簇的各广告位的约束。译稿校对中ENIndicates the total amount of time in seconds that advertisers may fill for a “dynamic” video ad pod (See Section 7.6 for more details), or the dynamic portion of a “hybrid” ad pod. This field is required only for the dynamic portion(s) of video ad pods. This field refers to the length of the entire ad break, whereas minduration/maxduration/rqddursare constraints relating to the slots that make up the pod. |
| protocols | integer[] | 支持的视频协议数组。参见 AdCOM 1.0 列表：创意子类型 - 音频/视频（List: Creative Subtypes - Audio/Video）。译稿校对中ENArray of supported video protocols. Refer to List: Creative Subtypes - Audio/Video in AdCOM 1.0.枚举 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 个值见枚举总览 → |
| 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). |
| podid | string | 唯一标识符，指示某展示机会属于某个视频广告簇（video ad pod）。若竞价请求内多个展示机会共享同一 podid，即表示这些展示机会属于同一视频广告簇。译稿校对中ENUnique identifier indicating that an impression opportunity belongs to a video ad pod. If multiple impression opportunities within a bid request share the same podid, this indicates that those impression opportunities belong to the same video ad pod. |
| podseq default 0 | integer | 视频广告簇在内容流中的顺序（位置）。使用指引参见 AdCOM 1.0。译稿校对中ENThe sequence (position) of the video ad pod within a content stream. Refer to AdCOM 1.0 for guidance on the use of this field. |
| rqddurs | integer[] | 视频创意可接受的精确时长（秒）。本字段专门面向直播电视（Live TV）场景——非精确的广告时长会导致不理想的“死空气”（dead air）。本字段与 minduration、maxduration 互斥；指定 rqddurs 时不得指定 minduration 与 maxduration，反之亦然。译稿校对中ENPrecise acceptable durations for video creatives in seconds. This field specifically targets the Live TV use case where non-exact ad durations would result in undesirable ‘dead air’. This field is mutually exclusive with minduration and maxduration; if rqddurs is specified, minduration and maxduration must not be specified and vice versa. |
| placement deprecated · 2.6-202303 | integer | 已自 OpenRTB 2.6-202303 起弃用。请改用 plcmt。译稿校对中ENDeprecated as of OpenRTB 2.6-202303. Use plcmt instead. |
| plcmt | integer | 该展示的视频投放类型（video placement type）。参见 AdCOM 1.0 列表：Plcmt 子类型 - 视频（List: Plcmt Subtypes - Video）。译稿校对中ENVideo placement type for the impression. Refer to List: Plcmt Subtypes - Video in AdCOM 1.0.枚举 Plcmt Subtypes - Video · 9 个值1Instream: Pre-roll, mid-roll, and post-roll ads that are played before, during or after the streaming video content that the consumer has requested. Instream video must be set to “sound on” by default at player start, or have explicitly clear user intent to watch the video content. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view capable of audio when playing. If the player converts to floating/sticky subsequent ad calls should accurately convey the updated player size. 2Accompanying Content: Pre-roll, mid-roll, and post-roll ads that are played before, during, or after streaming video content. The video player loads and plays before, between, or after paragraphs of text or graphical content, and starts playing only when it enters the viewport. Accompanying content should only start playback upon entering the viewport. It may convert to a floating/sticky player as it scrolls off the page. 3Interstitial:Video ads that are played without video content. During playback, it must be the primary focus of the page and take up the majority of the viewport and cannot be scrolled out of view. This can be in placements like in-app video or slideshows. 4No Content/Standalone: Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating. 5Pause: An ad present in streaming video content that the consumer has requested. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view. 6Screensaver: An ad present, when OS/App Screen Saver are initiated. 7Overlay: Ads occurring during program content and outside of the traditional ad break. The ad format places ad creatives over top of the program content, often as a banner or picture in picture execution. While there may be other content surrounding the player with the overlay, the player with the overlay must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view. 8Squeezeback: Ads Alongside or Adjacent to Content, also known as L-Shape Ads & Double Box, are ads that occur during program content and outside of the traditional ad break. The program content is resized to allow for placement of an ad on the screen. In a squeezeback, none of the content is covered by the ad, instead it shares screen space with the ad. This is the major distinction between squeezeback and overlay. While there may be other content surrounding the player with the squeezeback, the player with the squeezeback must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view. 9In-scene: A form of advertising that integrates branded elements directly within the content itself, rather than appearing as separate pre-roll, mid-roll, overlay, or display formats. In Scene Advertising is composited into the video content and blends the brand naturally into the scene, environment, or storyline, ensuring contextual relevance and viewer immersion without interrupting the user experience. In-scene ads typically consist of product placements or virtual out of A insertions. At this time, the standardization focuses on the out of home insertions in non-live content. While there may be other content surrounding the player with the in-scene ad, the player with the in-scene ad must be the focus of the user’s visit. It should remain the primary content on the page and the primary video player in-view. |
| linearity | integer | 指示该展示是否必须为线性（linear）、非线性（nonlinear）等。未指定时视为全部允许。参见 AdCOM 1.0 列表：线性模式（List: Linearity Modes）。译稿校对中ENIndicates if the impression must be linear, nonlinear, etc. If none specified, assume all are allowed. Refer to List: Linearity Modes in AdCOM 1.0. Note that this field describes the expected VAST response and not the type of video player inventory. For that, see plcmt.枚举 Linearity Modes · 2 个值1Linear 2Non-Linear (i.e., Overlay) |
| skip | integer | 指示播放器是否允许跳过该视频：0 = 否，1 = 是。若竞价方提交的标记/创意本身可跳过，Bid 对象应在 attr 数组中包含元素 16，表示可跳过视频。参见 AdCOM 1.0 列表：创意属性（List: Creative Attributes）。译稿校对中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: 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 个值见枚举总览 → |
| skipmin default 0 | integer | 总时长大于该秒数的视频可被跳过；仅在广告可跳过时适用。译稿校对中ENVideos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable. |
| skipafter default 0 | integer | 视频需播放的秒数，达到后才启用跳过；仅在广告可跳过时适用。译稿校对中ENNumber of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. |
| sequence default 0deprecated · 2.6 | integer | 已自 OpenRTB 2.6 起弃用。请改用 slotinpod。译稿校对中ENDeprecated as of OpenRTB 2.6. Use slotinpod |
| slotinpod default 0 | integer | 对于视频广告簇，本取值表示卖方可保证按所指示的簇内广告位位置交付。使用指引参见 AdCOM 1.0 列表：簇内广告位位置（List: Slot Position in Pod）。译稿校对中ENFor video ad pods, this value indicates that the seller can guarantee delivery against the indicated slot position in the pod. Refer to List: Slot Position in Pod in AdCOM 1.0 guidance on the use of this field.枚举 Slot Position in Pod · 4 个值-1Last ad in the pod 0Any ad in the pod 1First ad in the pod 2First or Last ad in the pod |
| mincpmpersec | float | 每秒最低 CPM。这是视频广告簇“动态”部分的价格底线，相对于广告主可提交出价的时长而言。译稿校对中ENMinimum CPM per second. This is a price floor for the "dynamic" portion of a video ad pod, relative to the duration of bids an advertiser may submit. |
| 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 个值见枚举总览 → |
| 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 (kilobits per second). |
| maxbitrate | integer | 最高码率，单位为 Kbps（千比特每秒）。译稿校对中ENMaximum bit rate in Kbps (kilobits per second). |
| boxingallowed default 1 | integer | 指示是否允许将 4:3 内容以信箱式（letter-boxing）方式装入 16:9 窗口：0 = 否，1 = 是。译稿校对中ENIndicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0=no, 1=yes. |
| playbackmethod | integer[] | 可能使用的播放方式。未指定时视为任何方式均可使用。参见 AdCOM 1.0 列表：播放方式（List: Playback Methods）。实践中通常只使用一种方式，因此未来规范版本可能将该数组改为整数；为应对这一变化，强烈建议仅使用本数组的第一个元素。译稿校对中ENPlayback methods that may be in use. If none are specified, any method may be used. Refer to List: Playback Methods in AdCOM 1.0. 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 | 导致播放结束的事件。参见 AdCOM 1.0 列表：播放停止模式（List: Playback Cessation Modes）。译稿校对中ENThe event that causes playback to end. Refer to List: Playback Cessation Modes in AdCOM 1.0. |
| delivery | integer[] | 支持的分发方式（如流式 streaming、渐进式 progressive）。未指定时视为全部支持。参见 AdCOM 1.0 列表：分发方式（List: Delivery Methods）。译稿校对中ENSupported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List: Delivery Methods in AdCOM 1.0.枚举 Delivery Methods · 3 个值1Streaming 2Progressive 3Download |
| 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 个值见枚举总览 → |
| companionad | object[] | Banner 对象（参见第 3.2.6 节）数组，在伴生广告（companion ads）可用时使用。译稿校对中ENArray of Banner objects (Section 3.2.6) if companion ads are available. |
| 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. |
| companiontype | integer[] | 支持的 VAST 伴生广告类型。参见 AdCOM 1.0 列表：伴生类型（List: Companion Types）。当通过 companionad 数组包含伴生 Banner 对象时建议传递。若其中一个 banner 将作为尾帧（end-card）渲染，可通过该 banner 的 vcm 属性指定（参见第 3.2.6 节）。译稿校对中ENSupported VAST companion ad types. Refer to List: Companion Types in AdCOM 1.0. 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 |
| poddedupe | enum array provisional | 指示将应用于出价响应的广告簇去重（pod deduplication）设置。参见 AdCOM 1.0 列表：广告簇去重（List: Pod Deduplication）。译稿校对中ENIndicates pod deduplication settings that will be applied to bid responses. Refer to List: Pod Deduplication in AdCOM 1.0.枚举 Pod Deduplication Settings · 5 个值1Deduplicated on adomain 2Deduplicated on IAB Tech Lab Content Taxonomy 3Deduplicated on creative ID 4Deduplicated on mediafile URL 5No deduplication |
| durfloors | object[] | DurFloors 对象（参见第 3.2.35 节）数组，指示买方可出价的各时长视频创意的底价。译稿校对中ENAn array of DurFloors objects (Section 3.2.35) indicating the floor prices for video creatives of various durations that the buyer may bid with. |
| ext | object | 供交易平台（exchange）对 OpenRTB 进行专属扩展（exchange-specific extensions）的占位对象。译稿校对中ENPlaceholder for exchange-specific extensions to OpenRTB. |
译注
译者注Video 在 2.6 中的重大重构：placement 弃用、由 plcmt 取代（投放类型口径升级）；sequence 弃用、由 slotinpod 取代；新增完整广告簇（ad pod）体系（podid/podseq/poddur/maxseq/rqddurs/slotinpod/poddedupe/mincpmpersec/durfloors），CTV 广告断售卖首次获得规范级完整表达。译稿校对中
plcmt 与旧 placement 的替代关系：plcmt（Plcmt Subtypes）是 2023 年后 IAB 推行的视频投放类型新口径（instream、accompanying content、interstitial、standalone 等），语义比旧 placement 更精确；新接入方应直接使用 plcmt，存量 placement 仅作兼容解析。译稿校对中
广告簇的三种形态：静态簇（广告数预先确定）、动态簇（数量不定，由 maxseq/poddur 约束总时长与上限）、混合簇（固定部分 + 动态部分，poddur 仅约束动态部分）；同一簇内的 Imp 共享 podid，出价与交付按簇统筹。译稿校对中
rqddurs 与 minduration/maxduration 互斥：直播电视（Live TV）场景要求创意时长精确匹配广告断，避免死空气（dead air）；此时使用 rqddurs 列举可接受时长，不得再传区间字段。出价前应严格校验创意时长命中。译稿校对中
slotinpod 与 poddedupe：slotinpod 声明卖方可保证的簇内位置交付（首/尾等位置通常溢价）；poddedupe 声明对出价响应的去重策略（如同一广告主/创意不得同簇重复），买方提交多出价前应核对去重规则避免无效出价。译稿校对中
poddur 与单条时长约束的层级：poddur 是整个广告断的总时长预算，minduration/maxduration/rqddurs 是簇内单个广告位的时长约束；两层约束同时生效，出价时应先核对单条约束再评估总量填充可行性。译稿校对中
skip 的双层表达：skip 描述播放器是否允许跳过；创意自带跳过能力时，还须在 Bid.attr 中声明 16（可跳过视频）。skipmin（总时长门槛）与 skipafter（播放秒数门槛）仅在可跳过时生效。译稿校对中
durfloors 的按时长底价：不同创意时长对应不同底价（常见于 CTV 长素材溢价）；与 Deal.durfloors 机制一致，出价时应按时长匹配对应底价。译稿校对中
字段描述收录自 IAB Tech Lab OpenRTB 2.6 官方规范（CC-BY 3.0）· 枚举值来源 AdCOM 1.0 · 初稿校对中