From 03f407abd150663e830fff7761ae25f58f1e2931 Mon Sep 17 00:00:00 2001 From: pranavdhawan Date: Thu, 29 Oct 2026 12:20:09 +0530 Subject: [PATCH 1/3] docs(mul): document video, multiformat, FPD, and user sync support --- dev-docs/bidders/mul.md | 128 ++++++++++++++++++++++++++++++++++++++-- 1 file changed, 122 insertions(+), 6 deletions(-) diff --git a/dev-docs/bidders/mul.md b/dev-docs/bidders/mul.md index c7456add11..8630a5c3ab 100644 --- a/dev-docs/bidders/mul.md +++ b/dev-docs/bidders/mul.md @@ -5,19 +5,21 @@ description: Prebid MonetiseUp (Mul) Bidder Adapter biddercode: mul pbjs: true pbs: false -media_types: banner +media_types: banner, video +gpp_sids: tcfeu, usstate_all, usp tcfeu_supported: false usp_supported: true coppa_supported: true +schain_supported: true floors_supported: true +fpd_supported: true safeframes_ok: true -multiformat_supported: will-bid-on-one +multiformat_supported: will-bid-on-any +userIds: all sidebarType: 1 --- -## Note - -The MonetiseUp (`mul`) adapter connects publishers directly to MonetiseUp programmatic demand and integrated RTB exchanges, aggregating demand from top partners including Adagio, PubMatic, OpenX, 152Media, Nobid, OnlineMediaSolutions, Scalibur, TripleLift, Eskimi, and Equativ. +The MonetiseUp (`mul`) adapter connects publishers directly to MonetiseUp's programmatic advertising marketplace, aggregating demand from top programmatic SSPs and DSPs including Adagio, PubMatic, OpenX, 152Media, Nobid, OnlineMediaSolutions, Scalibur, TripleLift, Eskimi, and Equativ. It supports both banner and video (instream and outstream) ad formats through OpenRTB protocol. To begin monetizing your inventory, contact [business@responsiq.com](mailto:business@responsiq.com). @@ -28,16 +30,82 @@ To begin monetizing your inventory, contact [business@responsiq.com](mailto:busi |---------------|----------|-----------------------------------------------|--------------------|----------| | `placementId` | required | Your MonetiseUp placement or inventory tag ID | `'placement-123'` | `string` | | `zoneId` | optional | Alternative zone identifier | `'zone-456'` | `string` | +| `bidfloor` | optional | Fallback minimum CPM for the impression | `0.50` | `float` | +| `bidfloorcur` | optional | Currency for the bid floor | `'USD'` | `string` | ## Test Parameters +### Banner Ad Unit + ```javascript var adUnits = [ { - code: 'test-ad-unit', + code: 'test-banner-div', + mediaTypes: { + banner: { + sizes: [[300, 250], [728, 90], [320, 50]] + } + }, + bids: [ + { + bidder: 'mul', + params: { + placementId: 'test-placement-123' + } + } + ] + } +]; +``` + +### Video Ad Unit + +```javascript +var adUnits = [ + { + code: 'test-video-div', + mediaTypes: { + video: { + playerSize: [[640, 480]], + context: 'instream', + mimes: ['video/mp4'], + protocols: [2, 3, 5, 6], + minduration: 5, + maxduration: 30, + startdelay: 0, + playbackmethod: [1, 2], + api: [1, 2] + } + }, + bids: [ + { + bidder: 'mul', + params: { + placementId: 'test-placement-123' + } + } + ] + } +]; +``` + +### Multi-Format Ad Unit + +```javascript +var adUnits = [ + { + code: 'test-multiformat-div', mediaTypes: { banner: { sizes: [[300, 250], [728, 90]] + }, + video: { + playerSize: [[640, 480]], + context: 'instream', + mimes: ['video/mp4'], + protocols: [2, 3, 5, 6], + minduration: 5, + maxduration: 30 } }, bids: [ @@ -51,3 +119,51 @@ var adUnits = [ } ]; ``` + +## Video Support + +The MonetiseUp adapter supports Video ads via both direct VAST XML (`vastXml`) and VAST URLs (`vastUrl`). Video ads support standard IAB video parameters including instream and outstream player configurations. + +## First Party Data (FPD) + +The adapter supports First Party Data (FPD) in multiple ways: +- **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` site and user segment data. +- **User IDs (EIDs)**: Automatically forwards external identifiers provided by Prebid User ID modules (`user.ext.eids`). +- **Supply Chain**: Forwards `source.ext.schain` for transparent supply chain validation. +- **Global Placement ID (GPID)**: Automatically extracts `ortb2Imp.ext.gpid` for ad server targeting. + +## User Sync + +The MonetiseUp adapter supports user synchronization to maximize bid yield: +- **Client-Side**: Supports `iframe` and `image` syncs. +- All privacy parameters (`gdpr`, `gdpr_consent`, `us_privacy`, `gpp`, `gpp_sid`) are automatically attached to sync requests. + +### Configuration Example + +```javascript +pbjs.que.push(function() { + pbjs.addAdUnits(adUnits); + + pbjs.setConfig({ + debug: true, + userSync: { + filterSettings: { + iframe: { + bidders: ['mul'], + filter: 'include' + }, + image: { + bidders: ['mul'], + filter: 'include' + } + } + } + }); + + pbjs.requestBids({ + bidsBackHandler: function(bidResponses) { + console.log('Auction completed', bidResponses); + } + }); +}); +``` From dae9235846ba0529b3dbbe96b8b8418a9db46bfc Mon Sep 17 00:00:00 2001 From: pranavdhawan Date: Thu, 29 Oct 2026 14:14:25 +0530 Subject: [PATCH 2/3] docs(mul): clarify outstream publisher-renderer requirement --- dev-docs/bidders/mul.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/dev-docs/bidders/mul.md b/dev-docs/bidders/mul.md index 8630a5c3ab..6a76443de2 100644 --- a/dev-docs/bidders/mul.md +++ b/dev-docs/bidders/mul.md @@ -122,7 +122,9 @@ var adUnits = [ ## Video Support -The MonetiseUp adapter supports Video ads via both direct VAST XML (`vastXml`) and VAST URLs (`vastUrl`). Video ads support standard IAB video parameters including instream and outstream player configurations. +The MonetiseUp adapter supports Video ads via both direct VAST XML (`vastXml`) and VAST URLs (`vastUrl`). +- **Instream**: Video ads support standard `instream` player contexts. +- **Outstream**: For `outstream` context, a publisher-defined renderer (e.g. `renderer: { url, render }`) or `useCacheKey` must be supplied on the ad unit. ## First Party Data (FPD) From 2351067f719eb7562a0059debe3d032fdf77a939 Mon Sep 17 00:00:00 2001 From: pranavdhawan Date: Thu, 29 Oct 2026 16:25:48 +0530 Subject: [PATCH 3/3] style(docs): fix markdownlint MD032 blanks around lists in mul.md --- dev-docs/bidders/mul.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/dev-docs/bidders/mul.md b/dev-docs/bidders/mul.md index 6a76443de2..0498121694 100644 --- a/dev-docs/bidders/mul.md +++ b/dev-docs/bidders/mul.md @@ -123,12 +123,14 @@ var adUnits = [ ## Video Support The MonetiseUp adapter supports Video ads via both direct VAST XML (`vastXml`) and VAST URLs (`vastUrl`). + - **Instream**: Video ads support standard `instream` player contexts. - **Outstream**: For `outstream` context, a publisher-defined renderer (e.g. `renderer: { url, render }`) or `useCacheKey` must be supplied on the ad unit. ## First Party Data (FPD) The adapter supports First Party Data (FPD) in multiple ways: + - **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` site and user segment data. - **User IDs (EIDs)**: Automatically forwards external identifiers provided by Prebid User ID modules (`user.ext.eids`). - **Supply Chain**: Forwards `source.ext.schain` for transparent supply chain validation. @@ -137,6 +139,7 @@ The adapter supports First Party Data (FPD) in multiple ways: ## User Sync The MonetiseUp adapter supports user synchronization to maximize bid yield: + - **Client-Side**: Supports `iframe` and `image` syncs. - All privacy parameters (`gdpr`, `gdpr_consent`, `us_privacy`, `gpp`, `gpp_sid`) are automatically attached to sync requests.