Video Placement

This object signals that the placement may be a video placement and provides additional detail about permitted video ads, e.g., VAST

Video Object Properties
Value Type Description
mime array of strings

(Required) Content MIME types supported.

Note: For Google bids all the specified MIME type media files are required in the VAST response, for example, ["video/mpeg", "video/mp4"]

ptype integer

Placement type for the impression, for example 2. This can take the following values:

  • 1: In-stream. Played before, during or after the streaming video content that the consumer has requested (e.g., Pre-roll, Mid-roll, Post-roll).
  • 2: In-banner. Exists within a web banner that leverages the banner space to deliver a video experience as opposed to another static or rich media format. The format relies on the existence of display ad inventory on the page for its delivery.
  • 3: In-article. Loads and plays dynamically between paragraphs of editorial content; existing as a standalone branded message.
  • 4: In-feed. Found in content, social, or product feeds.
  • 5: Interstitial/Slider/Floating. Covers the entire or a portion of screen area, but is always on screen while displayed (i.e. cannot be scrolled out of view).
pos integer

Ad Position as defined in OpenRTB, for example 1

  • 1 Above The Fold
  • 2 Locked (i.e., fixed position)
  • 3 Below The Fold
  • 4 Header
  • 5 Footer
  • 6 Sidebar
  • 7 Fullscreen
delay integer

Indicates the start delay in seconds. If the start delay value is greater than 0, then the position is mid-roll and the value indicates the start delay.

  • > 0: Mid-Roll (value indicates start delay in second)
  • 0: Pre-roll
  • -1: Generic mid-roll
  • -2: Generic post-roll
skip integer Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes.
skipmin integer Videos of a total duration greater than this value (seconds) can be skippable; only applicable if the ad is skippable.
skipafter integer Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable.
playmethod array of integers

Allowed playback methods as defined in the OpenRTB, for example [1, 2]. If none are specified, it is assumed all are allowed.

  • 1 Initiates on Page Load with Sound On
  • 2 Initiates on Page Load with Sound Off by Default
  • 3 Initiates on Click with Sound On
  • 4 Initiates on Mouse-Over with Sound On
  • 5 Initiates on Entering Viewport with Sound On
  • 6 Initiates on Entering Viewport with Sound Off by Default
playend integer

The event that causes playback to end, for example 2. This field can take the following values:

  • 1: On Video Completion or when Terminated by User.
  • 2: On Leaving Viewport or when Terminated by User.
  • 3: On Leaving Viewport Continues as a Floating/Slider Unit until Video Completion or when Terminated by User.
api* array of integers

List of supported API frameworks for this impression as defined in OpenRTB, for example, [1,2]. If an API is not explicitly listed, it is assumed not to be supported.

  • 1 VPAID 1.0
  • 2 VPAID 2.0
  • 3 MRAID 1.0
  • 4 ORMMA
  • 5 MRAID 2.0
  • 6 MRAID 3.0
  • 7 OMID 1.0
ctype integers

Creative subtypes permitted.

  • 1 VAST 1.0
  • 2 VAST 2.0
  • 3 VAST 3.0
  • 4 VAST 1.0 Wrapper
  • 5 VAST 2.0 Wrapper
  • 6 VAST 3.0 Wrapper
  • 7 VAST 4.0
  • 8 VAST 4.0 Wrapper
  • 9 DAAST 1.0
  • 10 DAAST 1.0 Wrapper
  • 11 VAST 4.1
  • 12 VAST 4.1 Wrapper
w integer Width of the player in pixels, for example, 600
h integer Height of the player in pixels, for example 400
mindur integer Minimum video ad duration in seconds, for example, 2
maxdur integer Maximum video ad duration in seconds, for example, 15
minbitr integer Minimum bit rate in Kbps, for example 680
maxbitr integer Maximum bit rate in Kbps, for example 990
delivery array of integers

Supported delivery methods (e.g., streaming, progressive) as defined in OpenRTB. If none specified, assume all are supported, for example, [1, 2]

  • 1 Streaming
  • 2 Progressive
  • 3 Download
linear integer

Indicates if the impression must be linear or nonlinear, for example, 1. If none is specified, it is assumed all are allowed

  • 1: Linear/In-stream
  • 2: Non-Linear/Overlay
boxing integer

Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed:

  • 0 = no
  • 1 = yes.
comp object array Array of Banner objects if companion ads are available. See the Companion Ad section for more information.
comptype array of integers

List of allowed companion ad types, for example [1, 2] Possible values:

  • 1: Static Resource
  • 2: HTML Resource
  • 3: iframe Resource

Example Video Object

{
    "video":{
        "ptype":3,
        "skip":1,
        "skipmin":10,
        "pos":1,
        "delay":-1,
        "mime":[
            "video/mp4"
        ],
        "playmethod":1,
        "api":[
            1,
            2
        ],
        "ctype":[
            3,
            4,
            5
        ],
        "w":600,
        "h":400
    }
}