From 018218e4dc4b7da62fb5a5a1916a14c3614414d2 Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Mon, 30 Sep 2024 15:02:52 +0200
Subject: [PATCH 1/2] update showheroes docs

---
 dev-docs/bidders/showheroes-bs.md | 127 +++++++++++++++++++++++++++++-
 1 file changed, 123 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes-bs.md
index a4e3fba3a4..4a7fd40174 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes-bs.md
@@ -4,11 +4,15 @@ title: ShowHeroes
 description: Prebid ShowHeroes Bidder Adapter
 pbjs: true
 biddercode: showheroes-bs
-media_types: video, banner
+media_types: video
 gvl_id: 111
 tcfeu_supported: true
 usp_supported: true
 schain_supported: true
+userId: all
+floors_supported: true
+fpd_supported: true
+multiformat_supported: will-bid-on-one
 sidebarType: 1
 ---
 
@@ -19,6 +23,121 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name        | Scope                            | Description                         | Example                                  | Type      |
 |-------------|----------------------------------|-------------------------------------|------------------------------------------|-----------|
-| `playerId`  | required (if not send unitId)    | VideoLibrary player ID              | `'0151f985-fb1a-4f37-bb26-cfc62e43ec05'` | `string`  |
-| `unitId`    | required (if not send playerId)  | Monetize unit ID                    | `'AACBTwsZVANd9NlB'`                     | `string`  |
-| `vpaidMode` | optional                         | Vpaid wrapper; default: `false`.    | `true`                                   | `boolean` |
+| `unitId`    | required                         | ShowHeroes MAX unit ID              | `'1234abcd-5678efgh'`                     | `string`  |
+
+All other parameters should be sent inside openRTB request.
+
+### openRTB2 support
+
+{: .alert.alert-danger :}
+Starting with Prebid.js version 9.16 ShowHeores bidder adapter is requesting bids via openRTB protocol.  
+Publishers can use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). Bidder supports all first-party data fields: site, user, segments, and imp-level first-party data.
+
+### testing
+
+While developing or testing locally, you can request a test request by marking the openRTB as a test.
+To do that specifically for `showheroes-Bs` you can do:
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['showheroesBs'],
+  config: {
+    ortb2: {
+      test:1
+    }
+  }
+})
+```
+
+Or, more easily you can mark the whole request as a test request by doing:
+
+```javascript
+pbjs.setConfig({ortb2: {test: 1}})
+```
+
+#### Outstream
+
+Example of adunit configuration for the outstream unit:
+
+```javascript
+
+var pbjs = pbjs || {};
+pbjs.que = pbjs.que || [];
+var adUnits = [
+    {
+        // Video adUnit
+        code: 'video-div-1',
+        mediaTypes: {
+            video: {
+                context: 'outstream',
+                playerSize: [640, 480],
+                mimes: ['video/mp4'],
+                playbackmethod: [2, 4, 6],
+                api: [1, 2, 4, 6],
+                protocols: [3, 4, 7, 8, 10],
+                placement: 1,
+                minduration: 0,
+                maxduration: 60,
+                startdelay: 0,
+                skip: 1
+            },
+        },
+        bids: [{
+            bidder: "showheroes-bs",
+            params: {
+                unitId: "1234abcd-5678efgh",
+            }
+        }],
+    }
+];
+pbjs.que.push(function () {
+    pbjs.setConfig({...});
+    pbjs.addAdUnits(adUnits);
+    pbjs.requestBids({ bidsBackHandler: sendAdServerRequest });
+});
+```
+
+You could use this example and place it in .html example pages inside the Prebid.js repository.
+
+#### instream
+
+Example of adunit configuration for the instream unit:
+
+```javascript
+
+var pbjs = pbjs || {};
+pbjs.que = pbjs.que || [];
+var videoAdUnit = {
+        code: 'video1',
+        sizes: [640,480],
+        mediaTypes: {
+          video: {context: 'instream',  playerSize: [640, 480]}
+        },
+        bids: [
+          {
+            bidder: 'showheroesBs',
+            params: {
+              unitId: "1234abcd-5678efgh",
+          }
+          }
+        ]
+};
+pbjs.que.push(function(){
+    pbjs.addAdUnits(videoAdUnit);
+    pbjs.setConfig({
+                cache: {
+                    url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                },
+                ...,
+            });
+    pbjs.requestBids({
+        timeout: 10000,
+        bidsBackHandler : function(bids) {
+            var vastUrl = bids["video1"].bids[0].vastUrl
+            invokeVideoPlayer(vastUrl);
+        }
+    });
+});
+```
+
+You could use this example and place it in the `test/pages/instream.html` example page inside the Prebid.js repository.

From 71dd4cfd01546544c8f76f2b83c4aa6c668fb569 Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Fri, 25 Oct 2024 08:52:07 +0200
Subject: [PATCH 2/2] bump version to next release

---
 dev-docs/bidders/showheroes-bs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes-bs.md
index 4a7fd40174..198ea27242 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes-bs.md
@@ -30,7 +30,7 @@ All other parameters should be sent inside openRTB request.
 ### openRTB2 support
 
 {: .alert.alert-danger :}
-Starting with Prebid.js version 9.16 ShowHeores bidder adapter is requesting bids via openRTB protocol.  
+Starting with Prebid.js version 9.18 ShowHeores bidder adapter is requesting bids via openRTB protocol.  
 Publishers can use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). Bidder supports all first-party data fields: site, user, segments, and imp-level first-party data.
 
 ### testing