Video.pos

Where the ad appears on screen, from AdCOM List: Placement Positions, such as 1 above the fold, 3 below the fold, or 7 fullscreen. 0 means unknown.

CurrentintegerOptionalSince 2.0

Field facts

Path: imp.video.pos
Object: Video
Type: integer
Requirement: Optional
Added: OpenRTB 2.0
Values: AdCOM list Placement Positions
Spec section: 3.2.7

How it is used

For web video it is the classic fold signal. The AdCOM list now runs to 17, and values from 8 up describe screen regions and shared-screen layouts such as double box and L shape, which pair with the newer CTV placement types. It says where on the screen, not whether content surrounds the ad; that is Video.plcmt.

Allowed values

Value	Meaning
`0`	Unknown: The seller does not know, or does not report, where the slot renders.
`1`	Above The Fold: Visible as soon as the page or screen loads, without scrolling.
`2`	Locked (fixed position): A fixed slot that stays in place on screen while the content scrolls, such as a sticky anchor or floating player.
`3`	Below The Fold: The slot renders outside the initial viewport, so the user has to scroll to reach it.
`4`	Header: A slot in the top region of the screen or page layout, such as an app's top banner or a masthead leaderboard.
`5`	Footer: A slot in the bottom region of the screen or page layout, such as an anchored banner along the bottom edge of an app.
`6`	Sidebar: A slot beside the main content, such as a desktop right rail or a side panel in a tablet app.
`7`	Fullscreen: The ad covers the whole screen, as with interstitial, rewarded and app open formats.
`8`	Partial Screen: The ad takes part of the screen while the program or page content stays visible next to or under it.
`9`	Top Left: The ad sits in the top-left corner of the screen while the content keeps playing.
`10`	Top Right: The ad sits in the top-right corner of the screen while the content keeps playing.
`11`	Frame the content: The program is scaled down and the ad surrounds it, framing the content on its edges.
`12`	Double box: The screen splits into two boxes, one showing the content and one showing the ad.
`13`	Double box with background: A double box layout in which the ad also fills the background behind the two boxes.
`14`	Bottom Left: The ad sits in the bottom-left corner of the screen while the content keeps playing.
`15`	Bottom Right: The ad sits in the bottom-right corner of the screen while the content keeps playing.
`16`	L shape: The content shrinks into a corner and the ad fills an L-shaped band along two edges of the screen.
`17`	Reversed L shape: The mirror image of the L shape: the ad band runs along the opposite side and the bottom.

Example

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

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

Common mistakes

Using pos to signal instream. A screen position says nothing about content context.

Version history

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

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	integer, default Unknown	No	No
2.3 to 2.4	integer	No	No
2.5	integer	No	No
2.6-202210 to 2.6-202606	integer	No	No