Audio.api

API frameworks the audio player supports, from AdCOM List: API Frameworks. A framework not listed is assumed unsupported.

Currentinteger arrayOptionalSince 2.4

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

ValueMeaning
1VPAID 1.0: VPAID 1.0, the first interactive video ad interface; superseded by VPAID 2.0 and rare in current players.
2VPAID 2.0: VPAID 2.0, still listed by some web players but not runnable on most CTV and app players.
3MRAID 1.0: MRAID 1.0 for in-app rich media; labeled MRAID until OpenRTB 2.2 renamed it MRAID-1.
4ORMMA: ORMMA, an early open in-app rich media interface that MRAID replaced.
5MRAID 2.0: MRAID 2.0, added in OpenRTB 2.2, with resizing, video playback, and other container features.
6MRAID 3.0: MRAID 3.0, added in OpenRTB 2.5, with exposure and audio events for in-app measurement.
7OMID 1.0: OMID 1.0: the player or SDK integrates the Open Measurement SDK for verification.
8SIMID 1.0: SIMID 1.0, the interactive layer for video ads that replaced VPAID interactivity. An AdCOM addition.
9SIMID 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 api list 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.

VersionsType in the specRequiredDeprecated
2.4integer arrayNoNo
2.5integer arrayNoNo
2.6-202210 to 2.6-202606integer arrayNoNo

Related fields

Other Audio fields

For a walkthrough of the whole object, read Audio object guide.