From ab67bbc6ae5c03b9624c1d656abbc0939161c18a Mon Sep 17 00:00:00 2001 From: Marcin Komorski Date: Wed, 30 Jul 2025 11:24:43 +0200 Subject: [PATCH 1/5] Add audio mediaType --- dev-docs/adunit-reference.md | 24 +++++++++++++++++++++++- dev-docs/bidder-adaptor.md | 4 ++-- 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md index 9f3c4af33b..d85cd29112 100644 --- a/dev-docs/adunit-reference.md +++ b/dev-docs/adunit-reference.md @@ -11,7 +11,7 @@ sidebarType: 1 The ad unit object is where you configure what kinds of ads you will show in a given ad slot on your page, including: -* Allowed media types (e.g., banner, native, and/or video) +* Allowed media types (e.g., banner, native, video and/or audio) * Allowed sizes * AdUnit-specific first party data @@ -74,6 +74,7 @@ See the table below for the list of properties in the `mediaTypes` object of the | [`banner`](#adUnit.mediaTypes.banner) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a banner ad. For examples, see [`adUnit.mediaTypes.banner`](#adUnit.mediaTypes.banner). | | [`native`](#adUnit.mediaTypes.native) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a native ad. For properties, see [`adUnit.mediaTypes.native`](#adUnit.mediaTypes.native). | | [`video`](#adUnit.mediaTypes.video) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a video ad. For examples, see [`adUnit.mediaTypes.video`](#adUnit.mediaTypes.video). | +| [`audio`](#adUnit.mediaTypes.audio) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a audio ad. For examples, see [`adUnit.mediaTypes.video`](#adUnit.mediaTypes.video). | @@ -160,6 +161,27 @@ When using the Video Module, the mediaTypes.video properties get filled out auto | `adServer.baseAdTagUrl` | required if `adServer.params` is not defined | string | Your AdServer Ad Tag. The targeting params of the winning bid will be appended. | | `adServer.params` | required if `adServer.baseAdTagUrl` is not defined | object | Querystring parameters that will be used to construct the video ad tag URL. | + + +#### adUnit.mediaTypes.audio + +{: .table .table-bordered .table-striped } +| Name | Scope | Type | Description | +|------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `context` | Recommended | String | The audio context. Defaults to 'instream'. | +| `useCacheKey` | Optional | Boolean | Defaults to `false`. Setting this `true` will use cache url defined in global options also for outstream responses. | +| `api` | Recommended | Array[Integer] | List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. For list, see [OpenRTB 2.5 spec][openRTB]. If your player supports [Open Measurement][OpenMeasurement], **recommended** to set `7` for OMID-1| +| `mimes` | Recommended | Array[String] | Content MIME types supported, e.g. `"audio/mp3"`. **Required by OpenRTB when using [Prebid Server][pbServer]**. | +| `minduration` | Recommended | Integer | Minimum audio ad duration in seconds, see [OpenRTB 2.5 spec][openRTB]. | +| `maxduration` | Recommended | Integer | Maximum audio ad duration in seconds, see [OpenRTB 2.5 spec][openRTB]. | +| `startdelay` | Recommended | Integer | Indicates the start delay in seconds, see [OpenRTB 2.5 spec][openRTB]. | +| `minbitrate` | Optional | Integer | Minimum bit rate in Kbps., see [OpenRTB 2.5 spec][openRTB]. | +| `maxbitrate` | Optional | Integer | Maximum bit rate in Kbps., see [OpenRTB 2.5 spec][openRTB]. | +| `delivery` | Optional | Array[Integer] | Supported delivery methods (e.g., streaming, progressive), see [OpenRTB 2.5 spec][openRTB]. | +| `companionad` | Optional | Array[Object] | Array of Banner objects (Section 3.2.6) if companion ads are available, see [OpenRTB 2.5 spec][openRTB]. | +| `feed` | Optional | Integer | Type of audio feed, see [OpenRTB 2.5 spec][openRTB]. | +| `nvol` | Optional | Integer | Volume normalization mode, see [OpenRTB 2.5 spec][openRTB]. | + ## Examples * [Banner](#adUnit-banner-example) diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md index e6f682b11f..9af41e2794 100644 --- a/dev-docs/bidder-adaptor.md +++ b/dev-docs/bidder-adaptor.md @@ -221,7 +221,7 @@ A high level example of the structure: import * as utils from 'src/utils'; import { registerBidder } from 'src/adapters/bidderFactory'; import { config } from 'src/config'; -import {BANNER, VIDEO, NATIVE} from 'src/mediaTypes.ts'; +import {BANNER, VIDEO, NATIVE, AUDIO} from 'src/mediaTypes.ts'; const BIDDER_CODE = 'example'; export const spec = { code: BIDDER_CODE, @@ -238,7 +238,7 @@ export const spec = { onSetTargeting: function(bid) {}, onBidderError: function({ error, bidderRequest }) {}, onAdRenderSucceeded: function(bid) {}, - supportedMediaTypes: [BANNER, VIDEO, NATIVE] + supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO] } registerBidder(spec); From 9c9d3e003cac5e323e9c8b03c98f7021991ea460 Mon Sep 17 00:00:00 2001 From: mkomorski Date: Wed, 1 Oct 2025 13:59:11 +0200 Subject: [PATCH 2/5] Update dev-docs/adunit-reference.md Co-authored-by: Muki Seiler --- dev-docs/adunit-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md index d85cd29112..be71461b7b 100644 --- a/dev-docs/adunit-reference.md +++ b/dev-docs/adunit-reference.md @@ -74,7 +74,7 @@ See the table below for the list of properties in the `mediaTypes` object of the | [`banner`](#adUnit.mediaTypes.banner) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a banner ad. For examples, see [`adUnit.mediaTypes.banner`](#adUnit.mediaTypes.banner). | | [`native`](#adUnit.mediaTypes.native) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a native ad. For properties, see [`adUnit.mediaTypes.native`](#adUnit.mediaTypes.native). | | [`video`](#adUnit.mediaTypes.video) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a video ad. For examples, see [`adUnit.mediaTypes.video`](#adUnit.mediaTypes.video). | -| [`audio`](#adUnit.mediaTypes.audio) | At least one of the `banner`, `native`, or `video` objects are required. | Object | Defines properties of a audio ad. For examples, see [`adUnit.mediaTypes.video`](#adUnit.mediaTypes.video). | +| [`audio`](#adUnit.mediaTypes.audio) | At least one of the `banner`, `native`, `video` or `audio` objects are required. | Object | Defines properties of a audio ad. For examples, see [`adUnit.mediaTypes.audio`](#adUnit.mediaTypes.audio). | From d0e0409e28bf846350ef551ea209c0b6dc7207e3 Mon Sep 17 00:00:00 2001 From: Muki Seiler Date: Thu, 2 Oct 2025 16:13:22 +0200 Subject: [PATCH 3/5] Update dev-docs/adunit-reference.md --- dev-docs/adunit-reference.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md index be71461b7b..0a1b3a0c44 100644 --- a/dev-docs/adunit-reference.md +++ b/dev-docs/adunit-reference.md @@ -161,7 +161,6 @@ When using the Video Module, the mediaTypes.video properties get filled out auto | `adServer.baseAdTagUrl` | required if `adServer.params` is not defined | string | Your AdServer Ad Tag. The targeting params of the winning bid will be appended. | | `adServer.params` | required if `adServer.baseAdTagUrl` is not defined | object | Querystring parameters that will be used to construct the video ad tag URL. | - #### adUnit.mediaTypes.audio From 072225e366e6a02f132560e02742ea51774bfbbb Mon Sep 17 00:00:00 2001 From: mkomorski Date: Mon, 13 Oct 2025 08:46:15 -0500 Subject: [PATCH 4/5] Update dev-docs/adunit-reference.md Co-authored-by: Muki Seiler --- dev-docs/adunit-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md index 0a1b3a0c44..12c9fc81fb 100644 --- a/dev-docs/adunit-reference.md +++ b/dev-docs/adunit-reference.md @@ -168,7 +168,7 @@ When using the Video Module, the mediaTypes.video properties get filled out auto | Name | Scope | Type | Description | |------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `context` | Recommended | String | The audio context. Defaults to 'instream'. | -| `useCacheKey` | Optional | Boolean | Defaults to `false`. Setting this `true` will use cache url defined in global options also for outstream responses. | +| `useCacheKey` | Optional | Boolean | Defaults to `false`. If set to `true`, the cache url defined in the global options will also be used for outstream responses. | | `api` | Recommended | Array[Integer] | List of supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. For list, see [OpenRTB 2.5 spec][openRTB]. If your player supports [Open Measurement][OpenMeasurement], **recommended** to set `7` for OMID-1| | `mimes` | Recommended | Array[String] | Content MIME types supported, e.g. `"audio/mp3"`. **Required by OpenRTB when using [Prebid Server][pbServer]**. | | `minduration` | Recommended | Integer | Minimum audio ad duration in seconds, see [OpenRTB 2.5 spec][openRTB]. | From 146c3ef4df706591fb3c6d4a93be544dd06c378e Mon Sep 17 00:00:00 2001 From: Marcin Komorski Date: Mon, 13 Oct 2025 09:00:51 -0500 Subject: [PATCH 5/5] missing link --- dev-docs/adunit-reference.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md index 12c9fc81fb..2ccd788cc5 100644 --- a/dev-docs/adunit-reference.md +++ b/dev-docs/adunit-reference.md @@ -161,6 +161,7 @@ When using the Video Module, the mediaTypes.video properties get filled out auto | `adServer.baseAdTagUrl` | required if `adServer.params` is not defined | string | Your AdServer Ad Tag. The targeting params of the winning bid will be appended. | | `adServer.params` | required if `adServer.baseAdTagUrl` is not defined | object | Querystring parameters that will be used to construct the video ad tag URL. | + #### adUnit.mediaTypes.audio