Banner.pos
Where the slot sits on screen, such as above the fold, header, footer, or full screen. In 2.6 the values come from the AdCOM 1.0 Placement Positions list; earlier versions used OpenRTB's Ad Position list.
Field facts
- Path
imp.banner.pos,imp.audio.companionad.pos,imp.video.companionad.pos- Object
- Banner
- Type
- integer
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Values
- AdCOM list Placement Positions
- Spec section
- 3.2.6
How it is used
Position is a strong pricing signal only when it is measured rather than assumed. Send 0 for unknown instead of guessing.
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": [
{
"banner": {
"pos": 1
}
}
]
}Common mistakes
- Sending 2 with its old meaning. OpenRTB 2.5 had already deprecated 2 (visibility depends on screen size), and AdCOM reuses 2 for a locked, fixed-position slot.
- Hard-coding 1 for every slot, which teaches buyers to ignore the field.
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 | 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 |