Audio.api
API frameworks the audio player supports, from AdCOM List: API Frameworks. A framework not listed is assumed unsupported.
Field facts
- Path
imp.audio.api- Object
- Audio
- Type
- integer array
- Requirement
- Optional
- Added
- OpenRTB 2.4
- Values
- AdCOM list API Frameworks
- Spec section
- 3.2.8
How it is used
VPAID and MRAID assume a visual surface. For audio, OMID 1.0 (7) is the value most likely to apply, when the player integrates Open Measurement.
Allowed values
| Value | Meaning |
|---|---|
1 | VPAID 1.0: VPAID 1.0, the first interactive video ad interface; superseded by VPAID 2.0 and rare in current players. |
2 | VPAID 2.0: VPAID 2.0, still listed by some web players but not runnable on most CTV and app players. |
3 | MRAID 1.0: MRAID 1.0 for in-app rich media; labeled MRAID until OpenRTB 2.2 renamed it MRAID-1. |
4 | ORMMA: ORMMA, an early open in-app rich media interface that MRAID replaced. |
5 | MRAID 2.0: MRAID 2.0, added in OpenRTB 2.2, with resizing, video playback, and other container features. |
6 | MRAID 3.0: MRAID 3.0, added in OpenRTB 2.5, with exposure and audio events for in-app measurement. |
7 | OMID 1.0: OMID 1.0: the player or SDK integrates the Open Measurement SDK for verification. |
8 | SIMID 1.0: SIMID 1.0, the interactive layer for video ads that replaced VPAID interactivity. An AdCOM addition. |
9 | SIMID 1.1: SIMID 1.1, a later version of the interactive video interface. An AdCOM addition. |
500+ | Vendor-specific codes: Vendor-specific frameworks, meaningful only between partners that agreed on them in advance. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"imp": [
{
"audio": {
"api": [
7
]
}
}
]
}Common mistakes
- Copying a video
apilist with VPAID values into audio requests.
Version history
Added in OpenRTB 2.4, 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.4 | integer array | No | No |
| 2.5 | integer array | No | No |
| 2.6-202210 to 2.6-202606 | integer array | No | No |
Related fields
Other Audio fields
battrcompanionadcompaniontypedeliverydurfloorsextfeedmaxbitratemaxdurationmaxextendedmaxseqmimesminbitratemincpmpersecmindurationnvolpoddurpodidpodseqprotocolsrqddurssequenceslotinpodstartdelaystitched
For a walkthrough of the whole object, read Audio object guide.