Audio Object¶
Note
Fields marked with asterisk (*) are optional.
Parameter
|
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 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. |
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. If the start delay value is greater than 0, then the position is mid-roll and the value indicates the start delay. |
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. |
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. |
slotinpod* |
integer |
For audio ad pods, this value indicates that the seller can guarantee delivery against the indicated sequence. |
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* |
array of integers |
Blocked creative attributes as defined in OpenRTB, for example, [6]. |
minbitrate* |
integer |
Minimum bit rate in Kbps, for example 680. |
maxbitrate* |
integer |
Maximum bit rate in Kbps, for example 990. |
api* |
array of integers |
List of supported API frameworks for this impression as defined in OpenRTB, for example, [1,2]. If an API is not explicitly listed, it is assumed not to be supported. |
maxextended* |
integer |
Maximum extended video ad duration if extension is allowed. |
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 |
List of allowed companion ad types, for example [1, 2]. |
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
],
}
}