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

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

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,
    "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
    ],
    "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
    ]
  }
}