Audio Object

Note

Fields marked with asterisk (*) are optional.

Parameter

Type

Description

mimes

array of strings

Content MIME types supported, for example [“audio/mp4”, “audio/mpeg”].

minduration

integer

Minimum audio ad duration in seconds, for example, 2.

maxduration

integer

Maximum audio ad duration in seconds, for example, 15.

poddur*

integer

Indicates the total amount of time that advertisers may fill for a dynamic audio ad pod, or the dynamic portion of a hybrid ad pod. This field is required only for the dynamic portion(s) of audio ad pods.

protocols

array of integers

Accepted audio bid response protocols as defined in OpenRTB, for example [9,10].

startdelay*

integer

Indicates the start delay in seconds. If the start delay value is greater than 0, then the position is mid-roll and the value indicates the start delay.

rqddurs*

array of integer

Precise acceptable durations for audio creatives in seconds, e.g. [15,15,15]. This field specifically targets the live audio/radio use case where non-exact ad durations would result in undesirable dead air.

podid*

integer

Unique identifier indicating that an impression opportunity belongs to an audio ad pod. If multiple impression opportunities within a bid request share the same podid, this indicates that those impression opportunities belong to the same audio ad pod.

podseq*

integer

The sequence (position) of the audio ad pod within a content stream, the default value is 0.

slotinpod*

integer

For audio ad pods, this value indicates that the seller can guarantee delivery against the indicated sequence.

mincpmpersec*

float

Minimum CPM per second. This is a price floor for the dynamic portion of an audio ad pod, relative to the duration of bids an advertiser may submit.

battr*

array of integers

Blocked creative attributes as defined in OpenRTB, for example, [6].

minbitrate*

integer

Minimum bit rate in Kbps, for example 680.

maxbitrate*

integer

Maximum bit rate in Kbps, for example 990.

api*

array of integers

List of supported API frameworks for this impression as defined in OpenRTB, for example, [1,2]. If an API is not explicitly listed, it is assumed not to be supported.

maxextended*

integer

Maximum extended video ad duration if extension is allowed.

delivery*

array of integers

Supported delivery methods (e.g., streaming, progressive) as defined in OpenRTB. If none specified, assume all are supported, for example, [1, 2].

maxseq*

integer

The maximum number of ads that can be played in an ad pod, for example, 1.

feed*

integer

Type of audio feed, for example, 1.

sequence*

integer

If multiple ad impressions are offered in the same bid request, the sequence number will allow for the coordinated delivery of multiple creatives, for example, 2.

stitched*

integer

Indicates if the ad is stitched with audio content or delivered independently, for example, 1.

nvol*

integer

Volume normalization mode as defined in OpenRTB, for example, 1.

companionad*

array of objects

Array of Banner objects if companion ads are available. See the Banner Object section for more information.

companiontype*

array of integers

List of allowed companion ad types, for example [1, 2].

Audio Object Example

{
  "id":"1",
  "bidfloor":0.03,
  "audio":{
    "startdelay":0,
    "minduration":5,
    "maxduration":30,
    "maxextended":30,
    "minbitrate":300,
    "maxbitrate":1500,
    "api":[
      1,
      2
    ],
    "protocols":[
      9,
      10
    ],
    "mimes":[
      "audio/aac",
      "audio/mp4",
      "audio/mpeg"
    ],
    "delivery":[
      2
    ],
    "btype": [
      4,
      21
    ],
    "battr": [
      13,
      14
    ],
  }
}