docs(mul): document video, multiformat, FPD, and user sync support

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-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-ad-unit',
+    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,56 @@ 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.
+- **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);
+    }
+  });
+});
+```