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