RTBlintAlpha
Menu

Video object

The Video object, at imp.video, offers an impression as a video ad slot and tells bidders what the player accepts: media types, VAST versions, durations, player size, placement type, skip behavior, and since OpenRTB 2.6 the structure of ad pods. Its presence marks the impression as video, and the same Imp may also offer banner, audio, or native alternatives.

37 fieldsOpenRTB 2.0 to 2.6-202606At imp.video

How it is used

Only Video.mimes is required, but a bidder also needs Video.protocols, a duration constraint, Video.startdelay, the player size, and Video.plcmt to pick a creative without guessing. CTV requests add the pod fields such as Video.podid, Video.slotinpod, Video.poddur, and Video.maxseq, often with exact durations in Video.rqddurs; the SSAI signal sits on Imp.ssai, outside this object. Three legacy fields need attention: Video.placement gave way to Video.plcmt, Video.sequence to Video.slotinpod, and the singular Video.protocol was removed in 2.6. Several fields exist only in later 2.6 snapshots, so validate against the version you and each partner agreed on.

The Video object guide page covers it in more depth.

Fields

FieldTypeRequirementSinceStatus
apiinteger arrayOptional2.0Current
battrinteger arrayOptional2.0Current
boxingallowedinteger, default 1Optional2.0Current
companionadobject arrayOptional2.0Current
companiontypeinteger arrayOptional2.1Current
deliveryinteger arrayOptional2.0Current
durfloorsobject arrayOptional2.6-202309Current
extobjectOptional2.1Current
hintegerRecommended2.0Current
linearityintegerOptional2.0Current
maxbitrateintegerOptional2.0Current
maxdurationintegerRecommended2.0Current
maxextendedintegerOptional2.0Current
maxseqintegerRecommended2.6-202204Current
mimesstring arrayRequired2.0Current
minbitrateintegerOptional2.0Current
mincpmpersecfloatOptional2.6-202204Current
mindurationinteger, default 0 recommendedOptional2.0Current
placementintegerOptional2.5Deprecated 2.6-202303
playbackendintegerOptional2.5Current
playbackmethodinteger arrayOptional2.0Current
plcmtintegerOptional2.6-202303Current
poddedupeenum array PROVISIONALOptional2.6-202402Current
poddurintegerRecommended2.6-202204Current
podidstringOptional2.6-202204Current
podseqinteger, default 0Optional2.6-202204Current
posintegerOptional2.0Current
protocolintegerOptional2.0Removed after 2.5
protocolsinteger arrayRecommended2.2Current
rqddursinteger arrayOptional2.6-202204Current
sequenceinteger, default 0 DEPRECATEDOptional2.0Deprecated 2.6-202204
skipintegerOptional2.4Current
skipafterinteger, default 0Optional2.4Current
skipmininteger, default 0Optional2.4Current
slotinpodinteger, default 0Optional2.6-202204Current
startdelayintegerRecommended2.0Current
wintegerRecommended2.0Current

Where it sits

Contained in: Imp.

Contains: Banner, DurFloors.

All objects

The field reference index lists every OpenRTB 2.x object.