position

The playback position at which the ad break is scheduled to start. Default value is "pre".

Possible values are:

• "pre": pre-roll ad (for VoD and Live streaming)

• "post": post-roll ad (for VoD streaming only)

• "pause": pause ad (for VoD and Live streaming), presented while the main content is paused

• fractional seconds: "10", "12.5" (mid-roll ad, for VoD and Live streaming)

• percentage of the entire video duration: "25%", "50%" (mid-roll ad, for VoD streaming only)

• timecode hh:mm:ss.mmm: "00:10:30.000", "01:00:00.000" (mid-roll ad, for VoD streaming only)

Pause ads

Support for the "pause" position is experimental and may change in a future version.

Unlike every other value, "pause" is not a position on the media timeline. A pause ad is triggered by the player being paused, so it can present at any playback position, or not at all.