Banner.btype
Banner ad types the seller blocks: 1 XHTML text ad, 2 XHTML banner ad, 3 JavaScript ad, 4 iframe. It is a block list, and an absent list blocks nothing.
Field facts
- Path
imp.banner.btype,imp.audio.companionad.btype,imp.video.companionad.btype- Object
- Banner
- Type
- integer array
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 3.2.6
How it is used
These four values belong to OpenRTB itself. When 2.6 moved its enumerations to AdCOM 1.0, AdCOM had no matching list, so the spec wrote the values into the Banner table instead. Blocking 3 rules out JavaScript ad tags, which most third-party display creative relies on.
Allowed values
1, 2, 3, 4.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"imp": [
{
"banner": {
"btype": [
1,
4
]
}
}
]
}Common mistakes
- Reading it as an allow list. [3] means JavaScript ads are blocked, not that only JavaScript is accepted.
- Sending values from AdCOM Creative Subtypes - Display, where 1 to 4 mean HTML, AMPHTML, and structured objects, not these banner ad types.
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, default All types are allowed | No | No |
| 2.2 | array of integers, default All types are allowed | 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 |