Audio Object

Note

Fields marked with an asterisk (*) are optional.

Audio Object Properties

Value

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 in seconds 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. This field refers to the length of the entire ad break, whereas minduration/maxduration/rqddurs are constraints relating to the slots that make up the pod.

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 following values are supported:

  • -1: Last pod in the content stream

  • 0: Any pod in the content stream

  • 1: First pod in the content stream

rqddurs*

array of integers

Precise acceptable durations for audio creatives in seconds. This field specifically targets the Live TV use case where non-exact ad durations would result in undesirable ‘dead air’. This field is mutually exclusive with maxduration.

slotinpod*

integer

For audio ad pods, this value indicates that the seller can guarantee delivery against the indicated slot position in the pod. The following values are supported:

  • -1: Last ad in the pod

  • 0: Any ad in the pod

  • 1: First ad in the pod

  • 2: First or last ad in the pod

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.

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, or generic values below:

  • 0: Pre-roll

  • -1: Generic mid-roll

  • -2: Generic post-roll

battr*

array of integers

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

minbitrate*

integer

Minimum bit rate in Kbps, for example 32

maxbitrate*

integer

Maximum bit rate in Kbps, for example 320

api*

array of integers

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

maxextended*

integer

Maximum extended audio ad duration if extension is allowed.

  • Blank or 0, extension is not allowed.

  • -1, extension is allowed, and there is no time limit imposed.

  • Greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value.

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

Supported DAAST companion ad types, for example [1, 2] Possible values:

  • 1: Static Resource

  • 2: HTML Resource

  • 3: iframe Resource

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
    ],
    "battr": [
      13,
      14
    ],
    "companionad": [
      {
      "id": "1234567893-1",
      "w": 300,
      "h": 250,
      "pos": 1,
        "battr": [
          13,
          14
        ],
      "expdir": [
                2,
                4
        ]
      },
      {
      "id": "1234567893-2",
      "w": 728,
      "h": 90,
      "pos": 1,
      "battr": [
        13,
        14
      ]
    }
    ],
    "companiontype": [
      1,
      2
    ]
  }
}