Audio Object

Note

Fields marked with an asterisk (*) are optional.

Audio Object Properties

Value

Type

Description

mimes

array of strings

(Required) Content MIME types supported, for example ["audio/mp4", "audio/mpeg"]

minduration

integer

(Recommended) Minimum audio ad duration in seconds. This field is mutually exclusive with rqddurs; only one of minduration and rqddurs may be in a bid request. The default value is 0.

maxduration

integer

(Recommended) Maximum audio ad duration in seconds. This field is mutually exclusive with rqddurs; only one of maxduration and rqddurs may be in a bid request. The default value is 0.

poddur*

integer

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

protocols

array of integers

(Recommended) Accepted audio bid response protocols as defined in OpenRTB, for example [9,10]. For the most up to date list, see the IAB Adcom spec

  • 1 VAST 1.0

  • 2 VAST 2.0

  • 3 VAST 3.0

  • 4 VAST 1.0 Wrapper

  • 5 VAST 2.0 Wrapper

  • 6 VAST 3.0 Wrapper

  • 7 VAST 4.0

  • 8 VAST 4.0 Wrapper

  • 9 DAAST 1.0

  • 10 DAAST 1.0 Wrapper

  • 11 VAST 4.1

  • 12 VAST 4.1 Wrapper

  • 13 VAST 4.2

  • 14 VAST 4.2 Wrapper

startdelay*

integer

(Recommended) Indicates the start delay in seconds e.g. 3, or using generic values below:

  • 0: Pre-roll

  • -1: Generic mid-roll

  • -2: Generic post-roll

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. This field is mutually exclusive with minduration and maxduration; if rqddurs is specified, minduration and maxduration must not be specified and vice versa.

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. For the most up to date list, see the IAB Adcom spec

  • -1 Last pod in the content stream

  • 0 Any pod in the content stream

  • 1 First pod in the content stream

sequence*

integer

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

slotinpod*

integer

For audio ad pods, this value indicates that the seller can guarantee delivery against the indicated sequence. For the most up to date list, see the IAB Adcom spec

  • -1 Last ad in the pod

  • 0 Any ad in the pod

  • 1 First ad in the pod

  • 2 First or

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.

The mincpmpersec field allows sellers to set a floor rate for each second an ad runs. So, for example, a $2 value would signal that the floor price is $30 for a 15-second ad and $60 for a 30-second ad. The duration is specified using poddur field.

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, e.g. 1.

  • 1 Music Service

  • 2 FM/AM Broadcast

  • 3 Podcast

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

ext*

object

Audio extension object

Extension Object

Audio extension Object Properties

Value

Type

Description

format

int

Specifies in which field BidSwitch expects the creative URL to be placed in the bid response. This field exists due to how some Suppliers handle audio as audio and others handle it like video. Takes the following values.

  • 1 for seatbid.bid.ext.daast_url

  • 2 for seatbid.bid.ext.vast_url For Rubicon we’ll always have format set to 2.

  • 3 for any, either VAST URL or DAAST URL.

Audio Object Example

{
  "id":"1",
  "bidfloor":0.03,
  "audio":{
    "startdelay":0,
    "rqddurs":[
      20,
      20,
      20
    ],
    "poddur":60,
    "podid":1,
    "mincpmpersec":0.5,
    "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
    ],
    "companionad":[
      {
        "id":"1234567893-1",
        "w":300,
        "h":250,
        "pos":1,
        "battr":[
          13,
          14
        ]
      },
      {
        "id":"1234567893-2",
        "w":728,
        "h":90,
        "pos":1,
        "battr":[
          13,
          14
        ]
      }
    ],
    "companiontype":[
      1,
      2
    ]
  }
}