Audio§3.2.8 · Bid Request
This object represents an audio type impression. Many of the fields are non-essential for minimally viable transactions, but are included to offer fine control when needed. Audio in OpenRTB generally assumes compliance with the VAST standard. As such, the notion of companion ads is supported by optionally including an array of Banner objects (refer to the Banner object in Section 3.2.6) that define these companion ads. The presence of a Audio as a subordinate of the Imp object indicates that this impression is offered as an audio type impression. At the publisher’s discretion, that same impression may also be offered as Banner, Video, and/or Native by also including as Imp subordinates objects of those types. However, any given bid for the impression must conform to one of the offered types.
| Attribute | Type | Description |
|---|---|---|
| mimes required | string[] | Content MIME types supported (e.g.,“audio/mp4”). |
| minduration default 0 | integer | 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. |
| maxduration | integer | 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. |
| 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. This field refers to the length of the entire ad break, whereas minduration/maxduration/rqddursare constraints relating to the slots that make up the pod. |
| protocols | integer[] | Array of supported audio protocols. Refer to List: Creative Subtypes - Audio/Video in AdCOM 1.0.Enum Creative Subtypes - Audio/Video · 16 values1VAST 1.0 2VAST 2.0 3VAST 3.0 4VAST 1.0 Wrapper 5VAST 2.0 Wrapper 6VAST 3.0 Wrapper 7VAST 4.0 8VAST 4.0 Wrapper 9DAAST 1.0 10DAAST 1.0 Wrapper 11VAST 4.1 12VAST 4.1 Wrapper 4 more values in the enumerations overview → |
| startdelay | integer | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements. Refer to List: Start Delay Modes in AdCOM 1.0.Enum Start Delay Modes · 4 values>0Mid-Roll (value indicates start delay in second) 0Pre-Roll -1Generic Mid-Roll -2Generic Post-Roll |
| rqddurs | integer[] | Precise acceptable durations for audio creatives in seconds. 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 minduraiton and maxduration; if rqddurs is specified, minduraiton and maxduration must not be specified and vice versa. |
| podid | string | 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 default 0 | integer | The sequence (position) of the audio ad pod within a content stream. Refer to List: Pod Sequence in AdCOM 1.0 for guidance on the use of this field.Enum Pod Sequence · 3 values-1Last pod in the content stream 0Any pod in the content stream 1First pod in the content stream |
| sequence default 0deprecated · 2.6 | integer | Deprecated as of OpenRTB 2.6. Use slotinpod |
| slotinpod default 0 | integer | For audio ad pods, this value indicates that the seller can guarantee delivery against the indicated slot position in the pod. Refer to List: Slot Position in Pod in AdCOM 1.0 guidance on the use of this field.Enum Slot Position in Pod · 4 values-1Last ad in the pod 0Any ad in the pod 1First ad in the pod 2First 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. |
| battr | integer[] | Blocked creative attributes. Refer to List: Creative Attributes in AdCOM 1.0Enum Creative Attributes · 24 values1Audio Ad (Autoplay) 2Audio Ad (User Initiated) 3Expandable (Automatic) 4Expandable (User Initiated - Click) 5Expandable (User Initiated - Rollover) 6In-Banner Video Ad (Autoplay) 7In-Banner Video Ad (User Initiated) 8Pop (e.g., Over, Under, or Upon Exit) 9Provocative or Suggestive Imagery 10Shaky, Flashing, Flickering, Extreme Animation, Smileys 11Surveys 12Text Only 12 more values in the enumerations overview → |
| maxextended | integer | Maximum extended ad duration if extension is allowed. If blank or 0, extension is not allowed. If -1, extension is allowed, and there is no time limit imposed. If greater than 0, then the value represents the number of seconds of extended play supported beyond the maxduration value. |
| minbitrate | integer | Minimum bit rate in Kbps (kilobits per second). |
| maxbitrate | integer | Maximum bit rate in Kbps (kilobits per second). |
| delivery | integer[] | Supported delivery methods (e.g., streaming, progressive). If none specified, assume all are supported. Refer to List: Delivery Methods in AdCOM 1.0.Enum Delivery Methods · 3 values1Streaming 2Progressive 3Download |
| companionad | object[] | Array of Banner objects (Section 3.2.6) if companion ads are available. |
| api | integer[] | List of supported API frameworks for this impression. Refer to List: API Frameworks in AdCOM 1.0. If an API is not explicitly listed, it is assumed not to be supported.Enum API Frameworks · 10 values1VPAID 1.0 2VPAID 2.0 3MRAID 1.0 4ORMMA 5MRAID 2.0 6MRAID 3.0 7OMID 1.0 8SIMID 1.0 9SIMID 1.1 500+Vendor-specific codes. |
| companiontype | integer[] | Supported companion ad types. Refer to List: Companion Types in AdCOM 1.0. Recommended if companion Banner objects are included via the companionad array.Enum Companion Types · 3 values1Static Resource 2HTML Resource 3iframe Resource |
| maxseq | integer | The maximum number of ads that can be played in an ad pod. |
| feed | integer | Type of audio feed. Refer to List: Feed Types in AdCOM 1.0.Enum Feed Types · 8 values1AOD Music streaming service 2LIVE FM/AM broadcast (live content broadcast over the air but also available via online streaming) 3AOD Podcast (original, pre-recorded content distributed as episodes in a series) 4AOD Catch-up radio (recorded segment of a radio show that was originally broadcast live) 5LIVE Web radio (live content only available via online streaming, not as AM/FM broadcast) 6MISC Video game (background audio in video games) 7MISC Text to speech (audio books, website plugin that can read article) 500+MISC Vendor-specific codes. |
| stitched | integer | Indicates if the ad is stitched with audio content or delivered independently, where 0=no, 1=yes. |
| nvol | integer | Volume normalization mode. Refer to List: Volume Normalization Modes in AdCOM 1.0. |
| durfloors | object[] | An array of DurFloors objects (Section 3.2.35) indicating the floor prices for audio creatives of various durations that the buyer may bid with. |
| ext | object | Placeholder for exchange-specific extensions to OpenRTB. |
Field descriptions are published in the official IAB Tech Lab OpenRTB 2.6 spec (CC-BY 3.0) · enumeration values sourced from AdCOM 1.0 · first-draft proofreading