Video.playbackend

What ends playback, from AdCOM List: Playback Cessation Modes: 1 when the video completes or the user stops it, 2 when it leaves the viewport or the user stops it, 3 when it leaves the viewport but continues in a floating player until completion. Added in OpenRTB 2.5.

CurrentintegerOptionalSince 2.5

Field facts

Path
imp.video.playbackend
Object
Video
Type
integer
Requirement
Optional
Added
OpenRTB 2.5
Values
AdCOM list Playback Cessation Modes
Spec section
3.2.7

How it is used

It matters mostly for web players outside the main content, where scrolling away can end the ad. Value 3 matches the floating or sticky behavior that the plcmt definition of Accompanying Content allows.

Allowed values

ValueMeaning
1On Video Completion or when Terminated by User: Playback runs until the ad completes or the viewer stops it, even if the player scrolls out of view.
2On Leaving Viewport or when Terminated by User: Playback stops when the player leaves the viewport or the viewer stops it.
3On Leaving Viewport Continues as a Floating/Slider Unit: When scrolled away, the player detaches into a floating or slider unit and plays on until completion or the viewer stops it.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "imp": [
    {
      "video": {
        "playbackend": 1
      }
    }
  ]
}

Common mistakes

  • Sending 1 for a player that stops when scrolled out of view, which overstates how often ads complete.

Version history

Added in OpenRTB 2.5, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.5integerNoNo
2.6-202210 to 2.6-202606integerNoNo

Versioned rules that name this field

Related fields

Other Video fields

For a walkthrough of the whole object, read Video object guide.