Banner.expdir
Directions in which the banner may expand: left, right, up, down, or full screen, plus resize or minimize in AdCOM. In 2.6 the values come from the AdCOM 1.0 Expandable Directions list.
Field facts
- Path
imp.banner.expdir,imp.audio.companionad.expdir,imp.video.companionad.expdir- Object
- Banner
- Type
- integer array
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Values
- AdCOM list Expandable Directions
- Spec section
- 3.2.6
How it is used
Leave it out when the slot cannot expand; older versions said that absence means not expandable. Value 6, resize or minimize, exists only in AdCOM, since the OpenRTB 2.5 list stopped at 5.
Allowed values
| Value | Meaning |
|---|---|
1 | Left: The ad may expand to the left of its slot. |
2 | Right: The ad may expand to the right of its slot. |
3 | Up: The ad may expand upward. |
4 | Down: The ad may expand downward. |
5 | Full Screen: The ad may expand to fill the whole screen. |
6 | Resize or minimize: The ad may shrink below its initial size, for example collapsing to a smaller bar. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"imp": [
{
"banner": {
"expdir": [
2,
4
]
}
}
]
}Common mistakes
- Listing directions the page layout cannot accommodate, so an expanding creative covers content or gets clipped.
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 | array of nteger | No | No |
| 2.1 | array of integer | No | No |
| 2.2 | array of integers, default Not expandabl | No | No |
| 2.3 to 2.4 | integer array | No | No |
| 2.5 | integer array | No | No |
| 2.6-202210 to 2.6-202606 | integer array | No | No |