Video Object

mimes

 required

string array

Content MIME types supported (for example, “video/mp4”).

–

minduration

recommended

integer

Minimum video ad duration in seconds. This field is mutually exclusive with rqddurs; only one of minduration and rqddurs may be in a bid request.

0

maxduration

recommended

integer

Maximum 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

recommended

integer

Indicates 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.

–

maxseq¹

recommended

integer

Indicates 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¹

recommended

integer

Indicates 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/rqddurs are constraints relating to the slots that make up the pod.

protocols

recommended

integer array

Array of supported video protocols. Refer to List: Creative Substypes – Audio/Video in AdCOM 1.0.

–

w

recommended

integer

Width of the video player in device independent pixels (DIPS).

–

h

recommended

integer

Height of the video player in device independent pixels (DIPS).

–

podid¹

recommended

string

Unique 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¹

optional

integer

The sequence (position) of the video ad pod within a content stream. Refer to AdCOM 1.0 for guidance on the use of this field.

0

rqddurs¹

optional

integer array

Precise 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³

optional

integer

Video placement type for the impression. Refer to List: Placement Subtypes – Video in AdCOM 1.0.

–

plcmt¹

optional

integer

Video placement type for the impression. Refer to List: Plcmt Subtypes – Video in AdCOM 1.0.

–

linearity

optional

integer

Indicates 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 whether a placement is in-stream, out-stream, etc. For that, see placement.

–

skip

optional

integer

Indicates 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.

–

skipmin

optional

integer

Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable.

0

skipafter

optional

integer

Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable.

0

sequence³

optional

integer

If multiple ad impressions are offered in the same bid request, the sequence number will allow for the coordinated delivery of multiple creatives.

0

slotinpod ¹

optional

integer

For 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.

0

mincpmpersec¹

optional

float

Minimum 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

optional

integer array

Blocked creative attributes. Refer to List: Creative Attributes in AdCOM 1.0.

–

maxextended

optional

integer

Maximum 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

optional

integer

Minumim bit rate in Kbps (kilobits per second).

–

maxbitrate

optional

integer

Maximum bit rate in Kbps (kilobits per second).

–

boxingallowed

optional

integer

Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0=no, 1=yes.

1

playbackmethod

optional

integer array

Playback 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.

–

playbackend

optional

integer

The event that causes playback to end. Refer to List: Playback Cessation Modes in AdCOM 1.0.

–

delivery

optional

integer array

Supported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List: Delivery Methods in AdCOM 1.0.

–

pos

optional

integer

Ad position on screen. Refer to List: Placement Positions in AdCOM 1.0.

–

companionad

optional

object array

Array of Banner objects (Section 3.2.6) if companion ads are available.

–

api

optional

integer array

List 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.

–

companiontype

optional

integer array

Supported 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).

–

poddedupe

optional

enum array PROVISIONAL

Indicates pod deduplication settings that will be applied to bid responses. Refer to List: Pod Deduplication in AdCOM 1.0.

–

durfloors²

optional

object array

An array of DurFloors objects (Section 3.2.35) indicating the floor prices for video creatives of various durations that the buyer may bid with.

–

object

Placeholder for exchange-specific extensions to OpenRTB.

–