From 9bf23c4cf99752b73a331e056614b687b9b5e031 Mon Sep 17 00:00:00 2001
From: Leandro Marty <leandro@smoot.ai>
Date: Mon, 17 Feb 2025 13:48:23 +0100
Subject: [PATCH 001/665] pbs set to true (#5811)

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

diff --git a/dev-docs/bidders/smoot.md b/dev-docs/bidders/smoot.md
index f155453e48..61cbde4c2f 100644
--- a/dev-docs/bidders/smoot.md
+++ b/dev-docs/bidders/smoot.md
@@ -16,7 +16,7 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: false
 safeframes_ok: true
 sidebarType: 1

From 3e65e5ac12116f6c589e7e5cce95bd84691044c6 Mon Sep 17 00:00:00 2001
From: jsnellbaker <31102355+jsnellbaker@users.noreply.github.com>
Date: Mon, 17 Feb 2025 07:55:35 -0500
Subject: [PATCH 002/665] update source URL for ast.js in examples (#5886)

---
 _includes/astjs.html            | 2 +-
 _includes/code/web-example.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/_includes/astjs.html b/_includes/astjs.html
index 7cdc9c9d9e..f850b09ec6 100644
--- a/_includes/astjs.html
+++ b/_includes/astjs.html
@@ -3,4 +3,4 @@
     type="text/plain"
     class="cmplazyload"
     data-cmp-purpose="c51"
-    data-cmp-src="https://acdn.adnxs.com/ast/ast.js"></script>
+    data-cmp-src="https://adsdk.microsoft.com/ast/ast.js"></script>
diff --git a/_includes/code/web-example.html b/_includes/code/web-example.html
index d2264b48e7..f552bf8fe7 100644
--- a/_includes/code/web-example.html
+++ b/_includes/code/web-example.html
@@ -64,7 +64,7 @@
     &lt;!-- required scripts --&gt;
     {% assign scripts = include.scripts | split: "," %}{% for script in scripts %}{% if script == "pbjs" %}&lt;script async src=&quot;https://cdn.jsdelivr.net/npm/prebid.js@latest/dist/not-for-prod/prebid.js&quot;&gt;&lt;/script&gt;
     {% elsif script == "gpt" %}&lt;script async src=&quot;https://securepubads.g.doubleclick.net/tag/js/gpt.js&quot;&gt;&lt;/script&gt;
-    {% elsif script == "astjs" %}&lt;script async src=&quot;https://acdn.adnxs.com/ast/ast.js&quot;&gt;&lt;/script&gt;{% else %}&lt;!-- unknown script tag '{{ script }}' required --&gt;{% endif %}{% else %}&lt;script async src=&quot;//cdn.jsdelivr.net/npm/prebid.js@latest/dist/not-for-prod/prebid.js&quot;&gt;&lt;/script&gt;
+    {% elsif script == "astjs" %}&lt;script async src=&quot;https://adsdk.microsoft.com/ast/ast.js&quot;&gt;&lt;/script&gt;{% else %}&lt;!-- unknown script tag '{{ script }}' required --&gt;{% endif %}{% else %}&lt;script async src=&quot;//cdn.jsdelivr.net/npm/prebid.js@latest/dist/not-for-prod/prebid.js&quot;&gt;&lt;/script&gt;
     &lt;script async src=&quot;https://securepubads.g.doubleclick.net/tag/js/gpt.js&quot;&gt;&lt;/script&gt;{% endfor %}
   &lt;/head&gt;
   &lt;body&gt;

From 9a92dcbf3359bb706f305e1f0d235d84ac6c596b Mon Sep 17 00:00:00 2001
From: ss-toshihide-tajima
 <89903823+ss-toshihide-tajima@users.noreply.github.com>
Date: Wed, 19 Feb 2025 00:14:54 +0900
Subject: [PATCH 003/665] update AdGeneration Doc: delete novatiq (#5882)

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

diff --git a/dev-docs/bidders/adgeneration.md b/dev-docs/bidders/adgeneration.md
index b998883a3f..23b49e1e67 100644
--- a/dev-docs/bidders/adgeneration.md
+++ b/dev-docs/bidders/adgeneration.md
@@ -5,7 +5,7 @@ description: Prebid Ad Generation Bidder Adaptor
 pbjs: true
 pbs: true
 biddercode: adgeneration
-userIds: novatiq, criteo, id5Id
+userIds: criteo, id5Id
 media_types: native
 sidebarType: 1
 ---

From 92c6cfff3f5f82a2f595dc257da75b49c0ebcc6c Mon Sep 17 00:00:00 2001
From: Piotr Jaworski <109736938+piotrj-rtbh@users.noreply.github.com>
Date: Tue, 18 Feb 2025 16:18:58 +0100
Subject: [PATCH 004/665] RTB House: updated feature list (#5884)

---
 dev-docs/bidders/rtbhouse.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/dev-docs/bidders/rtbhouse.md b/dev-docs/bidders/rtbhouse.md
index a1abc7d5d7..2d85327c7d 100644
--- a/dev-docs/bidders/rtbhouse.md
+++ b/dev-docs/bidders/rtbhouse.md
@@ -4,18 +4,24 @@ title: RTBHouse
 description: Prebid RTB House Bidder Adapter
 gvl_id: 16
 tcfeu_supported: true
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
 dsa_supported: true
 pbjs: true
 pbs: true
 biddercode: rtbhouse
 prebid_member: true
 floors_supported: true
+fpd_supported: true
 safeframes_ok: true
 media_types: banner, native
 schain_supported: true
 userIds: id5Id, identityLink, pubProvidedId
 pbs_app_supported: true
 ortb_blocking_supported: partial
+multiformat_supported: will-bid-on-any
+privacy_sandbox: paapi, topics
 sidebarType: 1
 ---
 

From 89f92a5d950e83a162f81c54ce94152a010bf51f Mon Sep 17 00:00:00 2001
From: Viktor Dreiling <34981284+3link@users.noreply.github.com>
Date: Tue, 18 Feb 2025 16:46:33 +0100
Subject: [PATCH 005/665] Add docs for zetassp and triplelift (#5885)

---
 dev-docs/modules/userid-submodules/liveintent.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/liveintent.md b/dev-docs/modules/userid-submodules/liveintent.md
index f9379cdb45..842cdb94fb 100644
--- a/dev-docs/modules/userid-submodules/liveintent.md
+++ b/dev-docs/modules/userid-submodules/liveintent.md
@@ -101,7 +101,7 @@ pbjs.setConfig({
 
 ### Multiple user IDs
 
-The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk`, `sharethrough`, `sonobi`, `vidazoo` and `fpid` are treated specially by LiveIntent's user ID sub-module. Each of these attributes will result in a separate ID returned by the sub-module. Note: `thetradedesk` will be exposed as `tdid` because of historical reasons.
+The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk`, `sharethrough`, `sonobi`, `vidazoo`, `zetassp`, `triplelift` and `fpid` are treated specially by LiveIntent's user ID sub-module. Each of these attributes will result in a separate ID returned by the sub-module. Note: `thetradedesk` will be exposed as `tdid` because of historical reasons.
 
 #### Note
 
@@ -124,9 +124,9 @@ For example, in case `uid2` is configured to be requested in addition to the `no
 }
 ```
 
-NOTE: `uid2` is exposed as part of `lipb` as well as separately as `uid2`. `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (as `tdid`), `sharethrough`, `vidazoo` and `fpid` behave the same way.
+NOTE: `uid2` is exposed as part of `lipb` as well as separately as `uid2`. `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (as `tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift` and `fpid` behave the same way.
 
-For the attributes `lipbid` (nonID), `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo` and `fpid` there is also support for their conversion into OpenRTB EIDS format. Please refer to [User ID Module](../userId.md) documentation for more information on conversion, and [Example of eids array generated by UserId Module](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md) for output format examples.
+For the attributes `lipbid` (nonID), `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift` and `fpid` there is also support for their conversion into OpenRTB EIDS format. Please refer to [User ID Module](../userId.md) documentation for more information on conversion, and [Example of eids array generated by UserId Module](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md) for output format examples.
 
 ### FPID
 
@@ -209,7 +209,7 @@ NOTE: For optimal performance, the LiveIntent ID sub-module should be called at
 | params.ajaxTimeout |Optional| Number |This configuration parameter defines the maximum duration of a call to the `IdentityResolution` endpoint. By default, 5000 milliseconds.|`5000`|
 | params.partner | Optional| String |The name of the partner whose data will be returned in the response.|`prebid`|
 | params.identifiersToResolve |Optional| Array[String] |Used to send additional identifiers in the request for LiveIntent to resolve against the LiveIntent ID and additional attributes.|`['my-id']`|
-| params.requestedAttributesOverrides | Optional | Object | Object containing booleans used to override the default resolution. Attributes set to `true` will be added to the resolved list, while attributes set to `false` will be removed. Valid attributes are `nonId`, `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `segments` and `fpid`. | `{'uid2': true}` |
+| params.requestedAttributesOverrides | Optional | Object | Object containing booleans used to override the default resolution. Attributes set to `true` will be added to the resolved list, while attributes set to `false` will be removed. Valid attributes are `nonId`, `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift`, `segments` and `fpid`. | `{'uid2': true}` |
 | params.emailHash |Optional| String |The hashed email address of a user. We can accept the hashes, which use the following hashing algorithms: md5, sha1, sha2.|`1a79a4d60de6718e8e5b326e338ae533`|
 | params.ipv4 |Optional| String |The IPv4 address of a user. |`1.2.3.4`|
 | params.ipv6 |Optional| String |The IPv6 address of a user. |`2001:db8:3333:4444:5555:6666:7777:8888`|

From 2eca481b3cbf7a9732ea5a1a2b55887fb479bff6 Mon Sep 17 00:00:00 2001
From: Olivier <osazos@adagio.io>
Date: Wed, 19 Feb 2025 09:26:44 +0100
Subject: [PATCH 006/665] Chore: fix bidder-data.csv generation (#5872)

Thanks a lot - I'll checkout the two adapters and fix it directly
---
 dev-docs/bidder-data.csv | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidder-data.csv b/dev-docs/bidder-data.csv
index c660fb9750..89d8941325 100644
--- a/dev-docs/bidder-data.csv
+++ b/dev-docs/bidder-data.csv
@@ -4,5 +4,5 @@ search: exclude
 ---
 bidder-code,bidder-name,banner,video,native,schain,dchain,tcfeu,coppa,gpp,usp,safeframes,deals,client-adapter,server-adapter,user-ids,mobile-apps,floors,fpd,prebid-member,ortb-blocking,multiformat,aliasOf,adapterFilename
 {% assign bidder_pages = site.pages | where: "layout",
-"bidder" %}{% for page in bidder_pages %}{{ page.biddercode }},{{ page.title }},{% unless page.media_types contains 'no-display' %}yes{% else %}no{% endunless %},{% if page.media_types contains 'video' %}yes{% else %}no{% endif %},{% if page.media_types contains 'native' %}yes{% else %}no{% endif %},{% if page.schain_supported == true %}yes{% elsif page.schain_supported == false %}no{% else %}check with bidder{% endif %},{% if page.dchain_supported == true %}yes{% elsif page.dchain_supported == false %}no{% else %}check with bidder{% endif %},{% if page.tcfeu_supported == true %}yes{% else %}no{% endif %},{% if page.coppa_supported == true %}yes{% elsif page.coppa_supported == false %}no{% else %}check with bidder{% endif %},{% if page.gpp_sids and page.gpp_sids != '' %}{{page.gpp_sids | split: ',' | join: ' '}}{% elsif page.gpp_supported == true and page.gpp_sids == nil %}some (check with bidder){% elsif page.gpp_supported == false and gpp_sids == nil %}None{% else %}check with bidder{% endif %},{% if page.usp_supported == true %}yes{% elsif page.usp_supported == false %}no{% else %}check with bidder{% endif %},{% if page.safeframes_ok and page.safeframes_ok == false %}no{% elsif page.safeframes_ok and page.safeframes_ok == true %}yes{% else %}check with bidder{% endif %},{% if page.deals_supported == false %}no{% elsif page.deals_supported == true %}yes{% else %}check with bidder{% endif %},{% if page.pbjs == true %}yes{% else %}no{% endif %},{% if page.pbs == true %}yes{% else %}no{% endif %},{% if page.userIds and page.userIds != '' %}{{page.userIds | split: ',' | join: ' '}}{% else %}none{% endif %},{% if page.pbs_app_supported == false %}no{% elsif page.pbs_app_supported == true %}yes{% else %}check with bidder{% endif %},{% if page.floors_supported == true %}yes{% elsif page.floors_supported == false %}no{% else %}check with bidder{% endif %},{% if page.fpd_supported == true %}yes{% elsif page.fpd_supported == false %}no{% else %}check with bidder{% endif %},{% if page.prebid_member == true %}yes{% else %}no{% endif %},{% if page.ortb_blocking_supported == true %}yes{% elsif page.ortb_blocking_supported == false %}no{% elsif page.ortb_blocking_supported == 'partial' %}partial{% else %}check with bidder{% endif %},{% if page.multiformat_supported %}{{page.multiformat_supported}}{% else %}check with bidder{% endif %},{{ page.aliasCode }},{% if page.filename %}{{ page.filename }}{% elsif page.aliasCode %}{{ page.aliasCode }}BidAdapter{% else %}{{ page.biddercode }}BidAdapter{% endif %}
+"bidder" %}{% for page in bidder_pages %}{{ page.biddercode }},{{ page.title }},{% unless page.media_types contains 'no-display' %}yes{% else %}no{% endunless %},{% if page.media_types contains 'video' %}yes{% else %}no{% endif %},{% if page.media_types contains 'native' %}yes{% else %}no{% endif %},{% if page.schain_supported == true %}yes{% elsif page.schain_supported == false %}no{% else %}check with bidder{% endif %},{% if page.dchain_supported == true %}yes{% elsif page.dchain_supported == false %}no{% else %}check with bidder{% endif %},{% if page.tcfeu_supported == true %}yes{% else %}no{% endif %},{% if page.coppa_supported == true %}yes{% elsif page.coppa_supported == false %}no{% else %}check with bidder{% endif %},{% if page.gpp_sids and page.gpp_sids != '' %}{{page.gpp_sids | split: ',' | join: ' '}}{% elsif page.gpp_supported == true and page.gpp_sids == nil %}some (check with bidder){% elsif page.gpp_supported == false and gpp_sids == nil %}None{% else %}check with bidder{% endif %},{% if page.usp_supported == true %}yes{% elsif page.usp_supported == false %}no{% else %}check with bidder{% endif %},{% if page.safeframes_ok and page.safeframes_ok == false %}no{% elsif page.safeframes_ok and page.safeframes_ok == true %}yes{% else %}check with bidder{% endif %},{% if page.deals_supported == false %}no{% elsif page.deals_supported == true %}yes{% else %}check with bidder{% endif %},{% if page.pbjs == true %}yes{% else %}no{% endif %},{% if page.pbs == true %}yes{% else %}no{% endif %},{% if page.userIds and page.userIds != '' %}{{page.userIds | split: ',' | join: ' '}}{% else %}none{% endif %},{% if page.pbs_app_supported == false %}no{% elsif page.pbs_app_supported == true %}yes{% else %}check with bidder{% endif %},{% if page.floors_supported == true %}yes{% elsif page.floors_supported == false %}no{% else %}check with bidder{% endif %},{% if page.fpd_supported == true %}yes{% elsif page.fpd_supported == false %}no{% else %}check with bidder{% endif %},{% if page.prebid_member == true %}yes{% else %}no{% endif %},{% if page.ortb_blocking_supported == true %}yes{% elsif page.ortb_blocking_supported == false %}no{% elsif page.ortb_blocking_supported == 'partial' %}partial{% else %}check with bidder{% endif %},{% if page.multiformat_supported %}"{{ page.multiformat_supported }}"{% else %}check with bidder{% endif %},{{ page.aliasCode }},{% if page.filename %}{{ page.filename }}{% elsif page.aliasCode %}{{ page.aliasCode }}BidAdapter{% else %}{{ page.biddercode }}BidAdapter{% endif %}
 {% endfor %}

From 883b9ed9caff92692cc652024e04f2f363c07e78 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Wed, 19 Feb 2025 09:34:32 +0100
Subject: [PATCH 007/665] Remove invalid multiformat support declaration
 (#5894)

Followup to #5872
---
 dev-docs/bidders/caroda.md           | 2 +-
 dev-docs/bidders/freedomadnetwork.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/caroda.md b/dev-docs/bidders/caroda.md
index 2b20b41273..9580de1bd6 100644
--- a/dev-docs/bidders/caroda.md
+++ b/dev-docs/bidders/caroda.md
@@ -14,7 +14,6 @@ schain_supported: true
 userIds: all
 gvl_id: 954
 floors_supported: true
-multiformat_supported: will-bid-on-any, will-bid-on-one
 fpd_supported: true
 safeframes_ok: true
 ortb_blocking_supported: false
@@ -27,6 +26,7 @@ sidebarType: 1
 The Caroda Bidding adapter requires setup before beginning. Please contact us on <https://caroda.io/>
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope                      | Description                                                     | Example           | Type      |
 |---------------|----------------------------|-----------------------------------------------------------------|-------------------|-----------|
 | `ctok`        | required                   | id unique to a customer                                         | `"abcdef"`        | `string` |
diff --git a/dev-docs/bidders/freedomadnetwork.md b/dev-docs/bidders/freedomadnetwork.md
index 7184bb0476..f1e82c370d 100644
--- a/dev-docs/bidders/freedomadnetwork.md
+++ b/dev-docs/bidders/freedomadnetwork.md
@@ -7,7 +7,6 @@ filename: fanAdapter
 gvl_id: none
 coppa_supported: true
 media_types: banner, native
-multiformat_supported: will-bid-on-any, will-bid-on-one, will-not-bid
 safeframes_ok: false
 deals_supported: false
 floors_supported: false
@@ -32,6 +31,7 @@ The Freedom Ad Network Adapter requires setup before beginning. Please contact u
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
 | `placementId`      | required | Placement ID         | `'e6203f1e-bd6d-4f42-9895-d1a19cdb83c8'`    | `string` |

From 81869aec88b33f855b893c472a8f846947df7f9a Mon Sep 17 00:00:00 2001
From: Kai Miyamoto <157671757+hogekai@users.noreply.github.com>
Date: Wed, 19 Feb 2025 21:57:25 +0900
Subject: [PATCH 008/665] Add in-renderer integration example (#5859)

* Add in-renderer integration example

* Fix markdown linting issue in in-renderer integration example

* Remove markdown linting directive from in-renderer integration example

* Update link format in in-renderer integration documentation

* Fix URL formatting in in-renderer integration example

* Update InRenderer.js documentation link to use HTML anchor tag

* Update multi-format example

* Fix example html title in multi format example

* Enhance outstream example

* Update dev-docs/examples/multi-format-example.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update examples/video/outstream/pb-ve-outstream-no-server.html

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Fix broken tab layout in outstream no ad server example

* Remove deprecated Prebid.js script from multi-format and in-renderer and out-stream examples

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/examples/in-renderer-integration.md  |  67 ++++++
 dev-docs/examples/multi-format-example.md     | 198 ++++++------------
 .../outstream/pb-ve-outstream-no-server.html  | 160 +++++---------
 3 files changed, 189 insertions(+), 236 deletions(-)
 create mode 100644 dev-docs/examples/in-renderer-integration.md

diff --git a/dev-docs/examples/in-renderer-integration.md b/dev-docs/examples/in-renderer-integration.md
new file mode 100644
index 0000000000..4810f8633a
--- /dev/null
+++ b/dev-docs/examples/in-renderer-integration.md
@@ -0,0 +1,67 @@
+---
+layout: example
+title: in-renderer Integration Example
+description: in-renderer Integration (formerly known as “outstream”) Example
+
+sidebarType: 1
+
+about:
+  - in-renderer Integration is one of the integration methods for Prebid Video
+  - In this example, to keep it simple, ad rendering is performed using `pbjs.renderAd`
+  - InRenderer.js, an open-source renderer optimized for in-renderer integration, is used as the renderer for in-renderer integration. For more information, see <a href="https://github.com/hogekai/in-renderer-js" target="_blank">InRenderer.js documentation</a>
+---
+
+## Example
+
+{% capture htmlCodePrebid %}
+<h1>in-renderer Integration Example</h1>
+
+<div id="ad-unit-1"></div>
+{% endcapture %}
+
+{% capture jsCode %}var pbjs = pbjs || {};
+pbjs.que = pbjs.que || [];
+
+var adUnit = {
+  code: "ad-unit-1",
+  mediaTypes: {
+    video: {
+      context: "outstream",
+      playerSize: [640, 360],
+      mimes: ["video/mp4", "video/webm", "video/ogg"],
+      protocols: [2, 3, 5, 6, 7, 8],
+      api: [2],
+    }
+  },
+  bids: [
+    {
+      bidder: "michao",
+      params: {
+        placement: "inbanner",
+        site: 1,
+        test: true
+      },
+    },
+  ],
+  renderer: {
+    url: `https://cdn.jsdelivr.net/npm/in-renderer-js@1/dist/in-renderer.umd.min.js`,
+    render: (bid) => {
+      var inRenderer = new window.InRenderer();
+      inRenderer.render("ad-unit-1", bid);
+    },
+  },
+};
+
+pbjs.que.push(function() {
+  pbjs.addAdUnits(adUnit);
+  pbjs.requestBids({
+    timeout: 5000,
+    bidsBackHandler: function () {
+      const highestCpmBids = pbjs.getHighestCpmBids("ad-unit-1");
+      pbjs.renderAd('ad-unit-1', highestCpmBids[0].adId);
+    },
+  });
+})
+{% endcapture %}
+
+{% include code/web-example.html id="basic-prebid-example" html=htmlCodePrebid js=jsCode %}
diff --git a/dev-docs/examples/multi-format-example.md b/dev-docs/examples/multi-format-example.md
index 099211aa33..7bc75ad2e8 100644
--- a/dev-docs/examples/multi-format-example.md
+++ b/dev-docs/examples/multi-format-example.md
@@ -7,152 +7,84 @@ sidebarType: 1
 
 about:
 - A multi-format ad unit allows you to receive any combination of banner, video, or native demand
+- A multi-format ad unit has two methods - a simple setup with in-renderer integration that does not require complex configuration on the ad server side, and format switching on the ad server side
 - Any bidder that supports at least one of the listed media types can participate in the auction for that ad unit
 - For engineering setup instructions, see <a href="/dev-docs/show-multi-format-ads.html">Show Multi-Format Ads</a>
-- For ad ops setup instructions, see <a href="/adops/step-by-step.html">Google Ad Manager with Prebid Step by Step</a>
+- In this example, to keep it simple, ad rendering is performed using `pbjs.renderAd`
+- InRenderer.js, an open-source renderer optimized for in-renderer integration, is used as the renderer for in-renderer integration. For more information, see [InRenderer.js documentation on Github](https://github.com/hogekai/in-renderer-js)
 
 ---
 
-## Basic Prebid.js Example
+## Example
 
-{% capture htmlCodePrebid %}<h3>div-banner-native-1</h3>
-<div id='div-banner-native-1'>
-<p>No response</p>
-<script type='text/javascript'>
-    googletag.cmd.push(function() {
-        googletag.display('div-banner-native');
-    });
+{% capture htmlCodePrebid %}
+<h1>Multi-format Example</h1>
 
-</script>
-</div>
-
-<h3>div-banner-native-2</h3>
-<div id='div-banner-native-2'>
-    <p>No response</p>
-    <script type='text/javascript'>
-        googletag.cmd.push(function() {
-            googletag.display('div-banner-outstream');
-        });
-
-    </script>
-</div>
+<div id="ad-unit-1"></div>
 {% endcapture %}
 
-{% capture jsCode %}var PREBID_TIMEOUT = 1000;
-var FAILSAFE_TIMEOUT = 3000;
-
-var googletag = googletag || {};
-googletag.cmd = googletag.cmd || [];
-
-var pbjs = pbjs || {};
+{% capture jsCode %}var pbjs = pbjs || {};
 pbjs.que = pbjs.que || [];
 
-function initAdserver() {
-    if (pbjs.initAdserverSet) return;
-
-    googletag.cmd.push(function() {
-        pbjs.que.push(function() {
-            pbjs.setTargetingForGPTAsync();
-            googletag.pubads().refresh();
-        });
-    });
-
-    pbjs.initAdserverSet = true;
-}
-
-pbjs.que.push(function() {
-    var adUnits = [{
-            code: 'div-banner-native-1',
-            mediaTypes: {
-                banner: {
-                    sizes: [
-                        [300, 250]
-                    ]
-                },
-                native: {
-                    type: 'image'
-                },
+var adUnit = {
+  code: "ad-unit-1",
+  mediaTypes: {
+    banner: {
+        sizes: [[300, 250]]
+    },
+    video: {
+      context: "outstream",
+      playerSize: [320, 180],
+      mimes: ["video/mp4", "video/webm", "video/ogg"],
+      protocols: [2, 3, 5, 6, 7, 8],
+      api: [2],
+    },
+    native: {
+      adTemplate: `<div style="width: 300px; height:250px; background-image: url(##hb_native_asset_id_1##);">`,
+      ortb: {
+        assets: [
+          {
+            id: 1,
+            required: 1,
+            img: {
+              type: 3,
+              w: 300,
+              h: 250,
             },
-            bids: [{
-                bidder: 'appnexus',
-                params: {
-                    placementId: 13232392,
-                }
-            }]
-        },
-        {
-            code: 'div-banner-native-2',
-            mediaTypes: {
-                banner: {
-                    sizes: [
-                        [300, 250]
-                    ]
-                },
-                native: {
-                    title: {
-                        required: true
-                    },
-                    image: {
-                        required: true
-                    },
-                    sponsoredBy: {
-                        required: true
-                    }
-                }
-            },
-            bids: [{
-                bidder: 'appnexus',
-                params: {
-                    placementId: 13232392,
-                }
-            }]
-        }
-    ];
-
-    pbjs.setConfig({
-        debug: true,
-        cache: {
-            url: false
-        },
-    });
-
-    pbjs.addAdUnits(adUnits);
-    pbjs.requestBids({
-            timeout: PREBID_TIMEOUT,
-        bidsBackHandler: function(bidResponses) {
-            initAdserver();
-        }
-    });
-});
-
-// in case PBJS doesn't load
-setTimeout(initAdserver, FAILSAFE_TIMEOUT);
+          },
+        ],
+      },
+    },
+  },
+  bids: [
+    {
+      bidder: "michao",
+      params: {
+        placement: "inbanner",
+        site: 1,
+        test: true
+      },
+    },
+  ],
+  renderer: {
+    url: `https://cdn.jsdelivr.net/npm/in-renderer-js@1/dist/in-renderer.umd.min.js`,
+    render: (bid) => {
+      var inRenderer = new window.InRenderer();
+      inRenderer.render("ad-unit-1", bid);
+    },
+  },
+};
 
-googletag.cmd.push(function() {
-    googletag
-        .defineSlot(
-            '/19968336/prebid_multiformat_test', [
-                [300, 250],
-                [360, 360]
-            ],
-            'div-banner-native-1'
-        )
-        .addService(googletag.pubads());
-
-    googletag
-        .defineSlot(
-            '/19968336/prebid_multiformat_test', [
-                [300, 250],
-                [360, 360]
-            ],
-            'div-banner-native-2'
-        )
-        .addService(googletag.pubads());
-
-    googletag.pubads().disableInitialLoad();
-    googletag.pubads().enableSingleRequest();
-    googletag.enableServices();
-});
+pbjs.que.push(function() {
+  pbjs.addAdUnits(adUnit);
+  pbjs.requestBids({
+    timeout: 5000,
+    bidsBackHandler: function () {
+      const highestCpmBids = pbjs.getHighestCpmBids("ad-unit-1");
+      pbjs.renderAd('ad-unit-1', highestCpmBids[0].adId);
+    },
+  });
+})
 {% endcapture %}
 
 {% include code/web-example.html id="basic-prebid-example" html=htmlCodePrebid js=jsCode %}
diff --git a/examples/video/outstream/pb-ve-outstream-no-server.html b/examples/video/outstream/pb-ve-outstream-no-server.html
index f33601f3d3..79dc2ed304 100644
--- a/examples/video/outstream/pb-ve-outstream-no-server.html
+++ b/examples/video/outstream/pb-ve-outstream-no-server.html
@@ -12,9 +12,8 @@
     <div class="vidHeader" style="width: 75vw">
       <h1>{{ page.title }}</h1>
       <p>{{page.description }}</p>
-    </div>
+    </div>  
 
-    <!--video warning-->
     <div class="pb-alert pb-alert-important">
       <p style="color: #85720f">
         <b>Important:</b> This example uses a test version of Prebid.js hosted
@@ -24,106 +23,61 @@ <h1>{{ page.title }}</h1>
         necessary bidder adapters are included.
       </p>
     </div>
+   
+<div>
+  {% capture htmlCodePrebid %}
+  <h3>Out-stream Example</h3>
+  
+  <div id="ad-unit-1"></div>
+  {% endcapture %}
+  
+  {% capture jsCode %}var pbjs = pbjs || {};
+  pbjs.que = pbjs.que || [];
+  
+  var adUnit = {
+    code: "ad-unit-1",
+    mediaTypes: {
+      video: {
+        context: "outstream",
+        playerSize: [640, 360],
+        mimes: ["video/mp4", "video/webm", "video/ogg"],
+        protocols: [2, 3, 5, 6, 7, 8],
+        api: [2],
+      }
+    },
+    bids: [
+      {
+        bidder: "michao",
+        params: {
+          placement: "inbanner",
+          site: 1,
+          test: true
+        },
+      },
+    ],
+    renderer: {
+      url: `https://cdn.jsdelivr.net/npm/in-renderer-js@1/dist/in-renderer.umd.min.js`,
+      render: (bid) => {
+        var inRenderer = new window.InRenderer();
+        inRenderer.render("ad-unit-1", bid);
+      },
+    },
+  };
+  
+  pbjs.que.push(function() {
+    pbjs.addAdUnits(adUnit);
+    pbjs.requestBids({
+      timeout: 5000,
+      bidsBackHandler: function () {
+        const highestCpmBids = pbjs.getHighestCpmBids("ad-unit-1");
+        pbjs.renderAd('ad-unit-1', highestCpmBids[0].adId);
+      },
+    });
+  })
+  {% endcapture %}
+  
+  {% include code/web-example.html id="basic-prebid-example" html=htmlCodePrebid js=jsCode %}
+</div>
 
-    <div>
-      <div>
-        <p>
-          Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
-          eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad
-          minim veniam, quis nostrud exercitation ullamco laboris nisi ut
-          aliquip ex ea commodo consequat. Duis aute irure dolor in
-          reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla
-          pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
-          culpa qui officia deserunt mollit anim id est laborum.
-        </p>
-      </div>
-
-      <div id="video1">
-        <p>Prebid Outstream Video Ad</p>
-      </div>
-
-      <div>
-        <p>
-          Sed ut perspiciatis unde omnis iste natus error sit voluptatem
-          accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae
-          ab illo inventore veritatis et quasi architecto beatae vitae dicta
-          sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit
-          aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos
-          qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui
-          dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed
-          quia non numquam eius modi tempora incidunt ut labore et dolore magnam
-          aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum
-          exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex
-          ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in
-          ea voluptate velit esse quam nihil molestiae consequatur, vel illum
-          qui dolorem eum fugiat quo voluptas nulla pariatur?
-        </p>
-      </div>
-    </div>
-
-    <!--video code fencing-->
-
-    <!--header code example-->
-    <div class="pb-alert pb-alert-warning">
-      <p style="color: #a94443">
-        <b>Warning:</b> Do not forget to exchange the placementId in the code
-        examples with your own placementId!
-      </p>
-    </div>
-
-    <h4>Place this code in the page header.</h4>
-    <div class="pb-code-hl-wrap">
-      <pre class="pb-code-hl">
-  <!--put javascript code here-->
-  &lt;script&gt;
-      var pbjs = pbjs || {};
-      pbjs.que = pbjs.que || [];
-
-      var adUnits = [{
-          code: 'video1',
-          mediaTypes: {
-              video: {
-                  context: 'outstream',
-                  playerSize: [640, 480],
-                  mimes: ['video/mp4'],
-                  protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-                  playbackmethod: [2],
-                  skip: 1
-              }
-          },
-          bids: [{
-              bidder: 'appnexus',
-              params: {
-                  placementId: 13232385
-              }
-          }]
-      }];
-
-      pbjs.que.push(function() {
-          pbjs.addAdUnits(adUnits);
-          pbjs.requestBids({
-              timeout: 1000,
-              bidsBackHandler: function(bids) {
-                  var highestCpmBids = pbjs.getHighestCpmBids('video1');
-                  pbjs.renderAd(document, highestCpmBids[0].adId);
-              }
-          });
-      });
-
-  &lt;/script&gt;
-
-        </pre>
-    </div>
-
-    <h4>Place this code in the page body.</h4>
-    <div class="pb-code-hl-wrap">
-      <!--body code example-->
-      <pre class="pb-code-hl">
-  <!--put body html and javascript here-->
-  &lt;div id='video1'&gt;
-    &lt;p&gt;Prebid Outstream Video Ad&lt;/p&gt;
-  &lt;/div&gt;
-          </pre>
-    </div>
   </div>
-</div>
+</div>
\ No newline at end of file

From b11cbd4bc817b699ea6c9fb5946ed82c5e84edb8 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Thu, 20 Feb 2025 09:36:20 -0500
Subject: [PATCH 009/665] added storageAllowed disclaimer (#5898)

* added storageAllowed disclaimer

* lint

* lint
---
 _includes/disclaimers/storageAllowed.md                | 2 ++
 dev-docs/bidders/adagio.md                             | 2 ++
 dev-docs/bidders/amx.md                                | 4 +++-
 dev-docs/bidders/bitmedia.md                           | 2 ++
 dev-docs/bidders/consumable.md                         | 2 ++
 dev-docs/bidders/contxtful.md                          | 2 ++
 dev-docs/bidders/equativ.md                            | 4 +++-
 dev-docs/bidders/impactify.md                          | 2 ++
 dev-docs/bidders/ix-server.md                          | 8 ++++----
 dev-docs/bidders/ix.md                                 | 2 ++
 dev-docs/bidders/kargo.md                              | 2 ++
 dev-docs/bidders/mediaConsortium.md                    | 2 ++
 dev-docs/bidders/nexx360.md                            | 3 ++-
 dev-docs/bidders/taboola.md                            | 2 ++
 dev-docs/bidders/triplelift.md                         | 6 ++++--
 dev-docs/bidders/visx.md                               | 6 ++++--
 dev-docs/modules/userid-submodules/merkle.md           | 2 +-
 prebid-mobile/pbm-api/android/pbm-targeting-android.md | 4 ++--
 18 files changed, 43 insertions(+), 14 deletions(-)
 create mode 100644 _includes/disclaimers/storageAllowed.md

diff --git a/_includes/disclaimers/storageAllowed.md b/_includes/disclaimers/storageAllowed.md
new file mode 100644
index 0000000000..ad0de11d01
--- /dev/null
+++ b/_includes/disclaimers/storageAllowed.md
@@ -0,0 +1,2 @@
+{: .alert.alert-info :}
+Prebid note: please review with your legal counsel before enabling storageAllowed. Bidders utilizing browser storage may trigger the need for additional disclosures in your privacy policy and may imply that the bid adapter is performing an activity redundant with user ID systems like SharedID. See the ePrivacy Directive article 5(3) reference to 'comprehensive information'.
diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index 1aa7b00cf4..87e44777e2 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -47,6 +47,8 @@ pbjs.setConfig({
 
 The Adagio bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.
 
+{% include disclaimers/storageAllowed.md %}
+
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/amx.md b/dev-docs/bidders/amx.md
index b19d3bdce9..f2d59092ab 100644
--- a/dev-docs/bidders/amx.md
+++ b/dev-docs/bidders/amx.md
@@ -33,7 +33,9 @@ sidebarType: 1
 
 ### Bidder Settings
 
-The AMX RTB bid adapter uses local storage. Please add `storageAllowed` in your bidder settings:
+The AMX RTB bid adapter uses local storage. Please add `storageAllowed` in your bidder settings.
+
+{% include disclaimers/storageAllowed.md %}
 
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
diff --git a/dev-docs/bidders/bitmedia.md b/dev-docs/bidders/bitmedia.md
index 24ed5e6cc3..dcc6c248da 100644
--- a/dev-docs/bidders/bitmedia.md
+++ b/dev-docs/bidders/bitmedia.md
@@ -93,6 +93,8 @@ The HTML file below can be used to test the integration of the Bitmedia Bid Adap
 
 ### Simple Test HTML
 
+{% include disclaimers/storageAllowed.md %}
+
 ```html
 <!--
   This page runs an auction for 2 adunits, simply displaying the results
diff --git a/dev-docs/bidders/consumable.md b/dev-docs/bidders/consumable.md
index 68e9326537..cdf03f1f47 100644
--- a/dev-docs/bidders/consumable.md
+++ b/dev-docs/bidders/consumable.md
@@ -68,6 +68,8 @@ Publishers can use Prebid.js to call Consumable Exchange (Consumable) in any of
 
 * **Recommended Global Bidder settings:** For our adapter, Consumable recommends enabling local storage. As of Prebid.js 7.x, local storage access must be explicitly specified. By leveraging local storage, Consumable is able to take advantage of the latest features our exchange has to offer. For instructions on enabling local storage, see Prebid’s [pbjs.bidderSettings](/dev-docs/publisher-api-reference/bidderSettings.html) documentation.
 
+{% include disclaimers/storageAllowed.md %}
+
 ### Example
 
 ```javascript
diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md
index c6ab50a3aa..e1a0f112be 100644
--- a/dev-docs/bidders/contxtful.md
+++ b/dev-docs/bidders/contxtful.md
@@ -27,6 +27,8 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf
 ### User Sync
 Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization.
 
+{% include disclaimers/storageAllowed.md %}
+
 ```javascript
 // Enable iframe usersync 
 pbjs.setConfig({
diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index 7d39a7a6f6..0c45f0df81 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -117,7 +117,9 @@ pbjs.setConfig({
 });
 ```
 
-And also making sure that storage is enabled for `equativ`:
+And also making sure that storage is enabled for `equativ`.
+
+{% include disclaimers/storageAllowed.md %}
 
 ```js
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/impactify.md b/dev-docs/bidders/impactify.md
index 2d93d26fc2..c6e1f10ff5 100644
--- a/dev-docs/bidders/impactify.md
+++ b/dev-docs/bidders/impactify.md
@@ -35,6 +35,8 @@ Impactify recommends the UserSync configuration below. Without it, the Impactify
 
 Note : Impactify adapter needs storage access to work properly (Do not forget to set storageAllowed to true).
 
+{% include disclaimers/storageAllowed.md %}
+
 For Prebid.js v1.15.0 and later:
 
 ```javascript
diff --git a/dev-docs/bidders/ix-server.md b/dev-docs/bidders/ix-server.md
index 0bc0291e4e..062867d155 100644
--- a/dev-docs/bidders/ix-server.md
+++ b/dev-docs/bidders/ix-server.md
@@ -88,7 +88,7 @@ If you are hosting your own Prebid Server instance, depending on whether you are
     ```javascript
      userSync:  
       redirect:  
-       url: "https://ssum.casalemedia.com/usermatchredir?s=<PUBLISHER ID>&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}"
+       url: "https://ssum.casalemedia.com/usermatchredir?s=<PUBLISHER ID>&gdpr={% raw %}{{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}{% endraw %}"
      ```
 
   * Edit the below existing entry and include your publisher ID in the `s` parameter:
@@ -96,7 +96,7 @@ If you are hosting your own Prebid Server instance, depending on whether you are
      ```javascript
      userSync:  
       redirect:  
-       iframe: "https://ssum.casalemedia.com/usermatch?s=<PUBLISHER ID>&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}"
+       iframe: "https://ssum.casalemedia.com/usermatch?s=<PUBLISHER ID>&gdpr={% raw %}{{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}{% endraw %}"
       ```         
 
 * If you are using [Prebid Server Java](https://github.com/prebid/prebid-server-java) version, edit the `prebid-server-java` entry in the `src/main/resources/bidder-config/ix.yaml` file as follows:
@@ -116,7 +116,7 @@ If you are hosting your own Prebid Server instance, depending on whether you are
        ix: 
         usersync: 
          redirect: 
-          url: "https://ssum.casalemedia.com/usermatchredir?s=<PUBLISHER ID>&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}" 
+          url: "https://ssum.casalemedia.com/usermatchredir?s=<PUBLISHER ID>&gdpr={% raw %}{{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}{% endraw %}" 
     ```
 
   * Add the below entry and include your publisher ID in the `s` parameter:
@@ -126,7 +126,7 @@ If you are hosting your own Prebid Server instance, depending on whether you are
       ix: 
        usersync: 
         iframe: 
-         url: "https://ssum.casalemedia.com/usermatch?s=<PUBLISHER ID>&gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}"
+         url: "https://ssum.casalemedia.com/usermatch?s=<PUBLISHER ID>&gdpr={% raw %}{{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&cb={{.RedirectURL}}{% endraw %}"
     ```
 
 <a id="call-index"></a>
diff --git a/dev-docs/bidders/ix.md b/dev-docs/bidders/ix.md
index ca0962ca47..0e940369e7 100644
--- a/dev-docs/bidders/ix.md
+++ b/dev-docs/bidders/ix.md
@@ -69,6 +69,8 @@ Publishers can use Prebid.js to call Index Exchange (Index) in any of the follow
   * In the **Network** tab, search for requests sent to `casalemedia.com/cygnus` (from version 6.28.0 and earlier) or `casalemedia.com/openrtb/pbjs` (from version 6.29.0 and later). These are the bid requests sent to Index.
 * **Recommended Global Bidder settings:** For our adapter, Index recommends enabling local storage. As of Prebid.js 7.x, local storage access must be explicitly specified. By leveraging local storage, Index is able to take advantage of the latest features our exchange has to offer. For instructions on enabling local storage, see Prebid’s [pbjs.bidderSettings](/dev-docs/publisher-api-reference/bidderSettings.html) documentation.
 
+{% include disclaimers/storageAllowed.md %}
+
 ### Example
 
 ```javascript
diff --git a/dev-docs/bidders/kargo.md b/dev-docs/bidders/kargo.md
index 0f83489e7a..f8b4269f6f 100644
--- a/dev-docs/bidders/kargo.md
+++ b/dev-docs/bidders/kargo.md
@@ -33,6 +33,8 @@ Kargo is an invitation-only marketplace.  Please reach out to your Kargo account
 
 The Kargo bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.
 
+{% include disclaimers/storageAllowed.md %}
+
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/mediaConsortium.md b/dev-docs/bidders/mediaConsortium.md
index 0d6110ca7e..660b07aa07 100644
--- a/dev-docs/bidders/mediaConsortium.md
+++ b/dev-docs/bidders/mediaConsortium.md
@@ -16,6 +16,8 @@ MediaConsortium doesn't require inventory parameters - we'll match your inventor
 
 To get access to the full feature set of the adapter you'll need to allow localstorage usage in the `bidderSettings`.
 
+{% include disclaimers/storageAllowed.md %}
+
 ```javascript
     pbjs.bidderSettings = {
         mediaConsortium: {
diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index 089eeedd47..2e8190709b 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -17,7 +17,6 @@ sidebarType: 1
 
 ---
 
-
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
@@ -35,6 +34,8 @@ sidebarType: 1
 
 You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `nexx360`
 
+{% include disclaimers/storageAllowed.md %}
+
 ```javascript
 pbjs.bidderSettings = {
     nexx360: {
diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md
index 45272680d8..4e80ef5517 100644
--- a/dev-docs/bidders/taboola.md
+++ b/dev-docs/bidders/taboola.md
@@ -34,6 +34,8 @@ sidebarType: 1
 We recommend allowing us access to localStorage.
 You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `taboola`
 
+{% include disclaimers/storageAllowed.md %}
+
 ```javascript
 pbjs.bidderSettings = {
     taboola: {
diff --git a/dev-docs/bidders/triplelift.md b/dev-docs/bidders/triplelift.md
index 5cc60ff435..618c378f02 100644
--- a/dev-docs/bidders/triplelift.md
+++ b/dev-docs/bidders/triplelift.md
@@ -164,13 +164,15 @@ Triplelift provides audience and contextual targeting via the integration of a P
 - Prebid v7.1.0 or later
 - In Prebid's `bidderSettings`, the `storageAllowed` parameter must be set to **true**. In Prebid v7.0 and later, `storageAllowed` defaults to false, so you will need to explicitly set this value to true.
 
-    ```javascript
+{% include disclaimers/storageAllowed.md %}
+
+```javascript
         pbjs.bidderSettings = {
             triplelift: {
                 storageAllowed: true
             }
         }
-    ```
+```
 
 - The Programmatic DMP **tag** must be included at the top of every webpage in order to collect audience and contextual information on the respective page.
 - The Programmatic DMP **tag** should be as high up in `<head>` as possible.
diff --git a/dev-docs/bidders/visx.md b/dev-docs/bidders/visx.md
index cacaf45861..42bd16c76a 100644
--- a/dev-docs/bidders/visx.md
+++ b/dev-docs/bidders/visx.md
@@ -96,13 +96,15 @@ pbjs.setConfig({
 
 - In Prebid's `bidderSettings`, the `storageAllowed` parameter must be set to **true**. In Prebid v7.0 and later, `storageAllowed` defaults to false, so you will need to explicitly set this value to true.
 
-    ```javascript
+{% include disclaimers/storageAllowed.md %}
+
+```javascript
         pbjs.bidderSettings = {
             visx: {
                 storageAllowed: true
             }
         }
-    ```
+```
 
 ### Bid params
 
diff --git a/dev-docs/modules/userid-submodules/merkle.md b/dev-docs/modules/userid-submodules/merkle.md
index 9dd890e0f7..534f88ce8b 100644
--- a/dev-docs/modules/userid-submodules/merkle.md
+++ b/dev-docs/modules/userid-submodules/merkle.md
@@ -3,7 +3,7 @@ layout: userid
 title: Merkle ID
 description: Merkle IDUser ID sub-module
 useridmodule: merkleIdSystem
-bidRequestUserId:merkleId
+bidRequestUserId: merkleId
 eidsource: merkleinc.com
 example: '"1111"'
 ---
diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 78457961fc..5d1a3e05bc 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -585,9 +585,9 @@ Example:
 ArrayList<ExternalUserId> userIds = new ArrayList<>();
 
 ExternalUserId.UniqueId uniqueId1 = new ExternalUserId.UniqueId("111111111111", 20);
-uniqueId1.setExt(new HashMap<String, Object>() {{
+uniqueId1.setExt(new HashMap<String, Object>() {% raw %}{{
     put("rtiPartner", "TDID");
-}});
+}});{% endraw %}
 ExternalUserId.UniqueId uniqueId2 = new ExternalUserId.UniqueId("_fl7bV96WjZsbiUyQnJlQ3g4ckh5a1N", 777);
 ExternalUserId fullUserId = new ExternalUserId("adserver.org", List.of(uniqueId1, uniqueId2));
 userIds.add(fullUserId);

From 2908dea0e36fe3d93d298da7cd7a67429f839a85 Mon Sep 17 00:00:00 2001
From: EvgeniiMunin <35193823+EvgeniiMunin@users.noreply.github.com>
Date: Thu, 20 Feb 2025 07:37:15 -0800
Subject: [PATCH 010/665] Greenbids RTD: Account config docs (#5834)

* fix review

* Greenbids RTD: Account config docs

* Greenbids: Account config docs Analytics/ RTD

* lint

* lint

* fix review

* keep appliedTo field blank
---
 .../greenbids-analytics-reporter.md           | 47 ++++++++++++-----
 .../pbs-modules/greenbids-real-time-data.md   | 52 +++++++++++++++++--
 2 files changed, 82 insertions(+), 17 deletions(-)

diff --git a/prebid-server/pbs-modules/greenbids-analytics-reporter.md b/prebid-server/pbs-modules/greenbids-analytics-reporter.md
index 2e20710330..236bd0d4ac 100644
--- a/prebid-server/pbs-modules/greenbids-analytics-reporter.md
+++ b/prebid-server/pbs-modules/greenbids-analytics-reporter.md
@@ -32,24 +32,47 @@ Here's a description of the global parameters:
 | exploratory-sampling-split | float | Exploration vs Exploitation ratio of analytics traffic |
 | timeout-ms | int | Timeout limit on sending POST request to Greenbids Analytics Server |
 
-The Greenbids Analytics module also includes account-specific parameters for each publisher setup. These parameters should be included in the extension of the bid request json: `ext.prebid.analytics.greenbids`
+The Greenbids Analytics module includes account-specific parameters for the publisher setup. The logic of the config is as follows:
 
-| Parameter | Scope | Description | Example | Type |
-| --------- | ---- | ------------- | ------------- | ----------- |
-| pbuid | required | The Greenbids Publisher ID | greenbids-publisher-1 | string |
-| greenbidsSampling | optional  | sampling factor [0-1] (a value of 0.1 will filter 90% of the traffic) | 1.0  | float |
+- `BidRequest` extension in `ext.prebid.analytics.greenbids` if defined takes precedence over account configs.
+- If the `BidRequest` extension is not defined, the account config is used and defined one per individual publisher.
+  The config is stored in `yaml` file under path `settings.filesystem.settings-filename` of the Prebid config.
+- If the account config is not defined, the default account config is used. It is defined in `settings.default-account-config` field of the Prebid config.
 
-An example of publisher config in the bid request extension is as follows:
+Here are examples of the config:
+
+BidRequest extension:
 
 ```json
 "ext": {
-  "prebid": {
-    "analytics": {
-      "greenbids": {
-        "pbuid": "PUBID_FROM_GREENBIDS",
-        "greenbidsSampling": 1.0
+    "prebid": {
+      "analytics": {
+        "greenbids": {
+          "pbuid": "PBUID_FROM_GREENBIDS",
+          "greenbids-sampling": 1
+        },
+        "greenbids-rtd": {
+          "pbuid": "PBUID_FROM_GREENBIDS",
+          "target-tpr": 0.55,
+          "exploration-rate": 0.0005
+        }
       }
     }
   }
-}
+```
+
+Account config:
+
+```yaml
+hooks:
+  modules:
+    greenbids-real-time-data:
+      pbuid: "PBUID_FROM_GREENBIDS"
+      target-tpr: 0.96
+      exploration-rate: 0.002
+analytics:
+  modules:
+    greenbids:
+      pbuid: "PBUID_FROM_GREENBIDS"
+      greenbids-sampling: 0.002
 ```
diff --git a/prebid-server/pbs-modules/greenbids-real-time-data.md b/prebid-server/pbs-modules/greenbids-real-time-data.md
index ae8811da4a..062366d70a 100644
--- a/prebid-server/pbs-modules/greenbids-real-time-data.md
+++ b/prebid-server/pbs-modules/greenbids-real-time-data.md
@@ -30,7 +30,52 @@ are done before customizing it to a particular bidder in the auction.
 
 ### Account-Level Config
 
-Here's an example of the account config used in PBS-Java:
+The module is invoked based on account config. The logic of the config is as follows:
+
+- `BidRequest` extension in `ext.prebid.analytics.greenbids-rtd` if defined takes precedence over account configs.
+- If the `BidRequest` extension is not defined, the account config is used and defined one per individual publisher.
+  The config is stored in `yaml` file under path `settings.filesystem.settings-filename` of the Prebid config.
+- If the account config is not defined, the default account config is used. It is defined in `settings.default-account-config` field of the Prebid config.
+
+Here are examples of the config used in PBS-Java:
+
+BidRequest extension:
+
+```json
+"ext": {
+    "prebid": {
+      "analytics": {
+        "greenbids": {
+          "pbuid": "PBUID_FROM_GREENBIDS",
+          "greenbids-sampling": 1
+        },
+        "greenbids-rtd": {
+          "pbuid": "PBUID_FROM_GREENBIDS",
+          "target-tpr": 0.55,
+          "exploration-rate": 0.0005
+        }
+      }
+    }
+  }
+```
+
+Account config:
+
+```yaml
+hooks:
+  modules:
+    greenbids-real-time-data:
+      pbuid: "PBUID_FROM_GREENBIDS"
+      target-tpr: 0.96
+      exploration-rate: 0.002
+analytics:
+  modules:
+    greenbids:
+      pbuid: "PBUID_FROM_GREENBIDS"
+      greenbids-sampling: 0.002
+```
+
+Execution plan setup:
 
 ```yaml
 hooks:
@@ -169,10 +214,7 @@ Here's an example analytics tag that might be produced for use in an analytics a
               "tid": "2c445309-06b2-47b2-a724-4aeef15faeb8"
             }
           },
-          "appliedTo": {
-            "bidders": "bidderA",
-            "impIds": "impId1"
-          }
+          "appliedTo": {}
         }
       ]
     }

From 222ce4d6b32ca45fb2e8a4c88ed4b8f03f25b06e Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Thu, 20 Feb 2025 12:06:13 -0500
Subject: [PATCH 011/665] moving storageAllowed disclosure (#5900)

---
 _includes/{disclaimers => dev-docs}/storageAllowed.md | 0
 dev-docs/bidders/adagio.md                            | 2 +-
 dev-docs/bidders/amx.md                               | 2 +-
 dev-docs/bidders/bitmedia.md                          | 2 +-
 dev-docs/bidders/consumable.md                        | 2 +-
 dev-docs/bidders/contxtful.md                         | 2 +-
 dev-docs/bidders/equativ.md                           | 2 +-
 dev-docs/bidders/impactify.md                         | 2 +-
 dev-docs/bidders/ix.md                                | 2 +-
 dev-docs/bidders/kargo.md                             | 2 +-
 dev-docs/bidders/mediaConsortium.md                   | 2 +-
 dev-docs/bidders/nexx360.md                           | 2 +-
 dev-docs/bidders/taboola.md                           | 2 +-
 dev-docs/bidders/triplelift.md                        | 2 +-
 dev-docs/bidders/visx.md                              | 2 +-
 15 files changed, 14 insertions(+), 14 deletions(-)
 rename _includes/{disclaimers => dev-docs}/storageAllowed.md (100%)

diff --git a/_includes/disclaimers/storageAllowed.md b/_includes/dev-docs/storageAllowed.md
similarity index 100%
rename from _includes/disclaimers/storageAllowed.md
rename to _includes/dev-docs/storageAllowed.md
diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index 87e44777e2..5d2d04404e 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -47,7 +47,7 @@ pbjs.setConfig({
 
 The Adagio bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
diff --git a/dev-docs/bidders/amx.md b/dev-docs/bidders/amx.md
index f2d59092ab..d912291823 100644
--- a/dev-docs/bidders/amx.md
+++ b/dev-docs/bidders/amx.md
@@ -35,7 +35,7 @@ sidebarType: 1
 
 The AMX RTB bid adapter uses local storage. Please add `storageAllowed` in your bidder settings.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
diff --git a/dev-docs/bidders/bitmedia.md b/dev-docs/bidders/bitmedia.md
index dcc6c248da..482a1724b9 100644
--- a/dev-docs/bidders/bitmedia.md
+++ b/dev-docs/bidders/bitmedia.md
@@ -93,7 +93,7 @@ The HTML file below can be used to test the integration of the Bitmedia Bid Adap
 
 ### Simple Test HTML
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```html
 <!--
diff --git a/dev-docs/bidders/consumable.md b/dev-docs/bidders/consumable.md
index cdf03f1f47..3737f7f9a0 100644
--- a/dev-docs/bidders/consumable.md
+++ b/dev-docs/bidders/consumable.md
@@ -68,7 +68,7 @@ Publishers can use Prebid.js to call Consumable Exchange (Consumable) in any of
 
 * **Recommended Global Bidder settings:** For our adapter, Consumable recommends enabling local storage. As of Prebid.js 7.x, local storage access must be explicitly specified. By leveraging local storage, Consumable is able to take advantage of the latest features our exchange has to offer. For instructions on enabling local storage, see Prebid’s [pbjs.bidderSettings](/dev-docs/publisher-api-reference/bidderSettings.html) documentation.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ### Example
 
diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md
index e1a0f112be..a20bd83d9c 100644
--- a/dev-docs/bidders/contxtful.md
+++ b/dev-docs/bidders/contxtful.md
@@ -27,7 +27,7 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf
 ### User Sync
 Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
 // Enable iframe usersync 
diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index 0c45f0df81..b7d550a2c1 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -119,7 +119,7 @@ pbjs.setConfig({
 
 And also making sure that storage is enabled for `equativ`.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```js
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/impactify.md b/dev-docs/bidders/impactify.md
index c6e1f10ff5..70dcb84f69 100644
--- a/dev-docs/bidders/impactify.md
+++ b/dev-docs/bidders/impactify.md
@@ -35,7 +35,7 @@ Impactify recommends the UserSync configuration below. Without it, the Impactify
 
 Note : Impactify adapter needs storage access to work properly (Do not forget to set storageAllowed to true).
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 For Prebid.js v1.15.0 and later:
 
diff --git a/dev-docs/bidders/ix.md b/dev-docs/bidders/ix.md
index 0e940369e7..7784e32722 100644
--- a/dev-docs/bidders/ix.md
+++ b/dev-docs/bidders/ix.md
@@ -69,7 +69,7 @@ Publishers can use Prebid.js to call Index Exchange (Index) in any of the follow
   * In the **Network** tab, search for requests sent to `casalemedia.com/cygnus` (from version 6.28.0 and earlier) or `casalemedia.com/openrtb/pbjs` (from version 6.29.0 and later). These are the bid requests sent to Index.
 * **Recommended Global Bidder settings:** For our adapter, Index recommends enabling local storage. As of Prebid.js 7.x, local storage access must be explicitly specified. By leveraging local storage, Index is able to take advantage of the latest features our exchange has to offer. For instructions on enabling local storage, see Prebid’s [pbjs.bidderSettings](/dev-docs/publisher-api-reference/bidderSettings.html) documentation.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ### Example
 
diff --git a/dev-docs/bidders/kargo.md b/dev-docs/bidders/kargo.md
index f8b4269f6f..981522250b 100644
--- a/dev-docs/bidders/kargo.md
+++ b/dev-docs/bidders/kargo.md
@@ -33,7 +33,7 @@ Kargo is an invitation-only marketplace.  Please reach out to your Kargo account
 
 The Kargo bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```js
 // https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
diff --git a/dev-docs/bidders/mediaConsortium.md b/dev-docs/bidders/mediaConsortium.md
index 660b07aa07..e1642e60c3 100644
--- a/dev-docs/bidders/mediaConsortium.md
+++ b/dev-docs/bidders/mediaConsortium.md
@@ -16,7 +16,7 @@ MediaConsortium doesn't require inventory parameters - we'll match your inventor
 
 To get access to the full feature set of the adapter you'll need to allow localstorage usage in the `bidderSettings`.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
     pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index 2e8190709b..8e4f5a5bc9 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -34,7 +34,7 @@ sidebarType: 1
 
 You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `nexx360`
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md
index 4e80ef5517..2b4572d3cb 100644
--- a/dev-docs/bidders/taboola.md
+++ b/dev-docs/bidders/taboola.md
@@ -34,7 +34,7 @@ sidebarType: 1
 We recommend allowing us access to localStorage.
 You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `taboola`
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
 pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/triplelift.md b/dev-docs/bidders/triplelift.md
index 618c378f02..5c65857a3e 100644
--- a/dev-docs/bidders/triplelift.md
+++ b/dev-docs/bidders/triplelift.md
@@ -164,7 +164,7 @@ Triplelift provides audience and contextual targeting via the integration of a P
 - Prebid v7.1.0 or later
 - In Prebid's `bidderSettings`, the `storageAllowed` parameter must be set to **true**. In Prebid v7.0 and later, `storageAllowed` defaults to false, so you will need to explicitly set this value to true.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
         pbjs.bidderSettings = {
diff --git a/dev-docs/bidders/visx.md b/dev-docs/bidders/visx.md
index 42bd16c76a..6f10388ad8 100644
--- a/dev-docs/bidders/visx.md
+++ b/dev-docs/bidders/visx.md
@@ -96,7 +96,7 @@ pbjs.setConfig({
 
 - In Prebid's `bidderSettings`, the `storageAllowed` parameter must be set to **true**. In Prebid v7.0 and later, `storageAllowed` defaults to false, so you will need to explicitly set this value to true.
 
-{% include disclaimers/storageAllowed.md %}
+{% include dev-docs/storageAllowed.md %}
 
 ```javascript
         pbjs.bidderSettings = {

From fdedacb6266f016a1cd924dc6e33d4417093f5ea Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Fri, 21 Feb 2025 11:27:50 +0100
Subject: [PATCH 012/665] Add-disclosures-to-guide (#5899)

* Add disclosure includes to guide.md

* Add legal disclosure as well
---
 guide.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/guide.md b/guide.md
index a9609b567d..ed618f1c79 100644
--- a/guide.md
+++ b/guide.md
@@ -274,6 +274,58 @@ In certain cases, it is helpful to the user to highlight a page in the left navi
 
 This has been done for both bidders pages (pages with `layout: bidder`) and the Publisher API Reference (`layout: api_prebidjs` and highlighting Prebid.js > Reference > Publish API Reference in the left nav), but can be extended to other pages as needed.
 
+### Disclosure Includes
+
+The docs offer a set of predefined disclosures that should be used where appropriate.
+
+#### Module does fingerprinting
+
+{% include dev-docs/fingerprinting.md %}
+
+```liquid
+{%raw%}{% include dev-docs/fingerprinting.md %}{%endraw%}
+```
+
+### Module loads external javascript
+
+{% include dev-docs/loads-external-javascript.md %}
+
+```liquid
+{%raw%}{% include dev-docs/loads-external-javascript.md %}{%endraw%}
+```
+
+#### Prebid Server works only with client-side adapter available
+
+{% include dev-docs/pbjs-adapter-required-for-pbs.md %}
+
+```liquid
+{%raw%}{% include dev-docs/pbjs-adapter-required-for-pbs.md %}{%endraw%}
+```
+
+#### Example uses build from source
+
+{% include dev-docs/build-from-source-warning.md %}
+
+```liquid
+{%raw%}{% include dev-docs/build-from-source-warning.md %}{%endraw%}
+```
+
+#### Example uses not for production assets
+
+{% include dev-docs/not-for-production-warning.md %}
+
+```liquid
+{%raw%}{% include dev-docs/not-for-production-warning.md %}{%endraw%}
+```
+
+#### Legal disclosure
+
+{% include legal-warning.html %}
+
+```liquid
+{%raw%}{% include legal-warning.html %}{%endraw%}
+```
+
 ## Partners
 
 TBD
@@ -287,6 +339,8 @@ There are 200+ bidder files in the /dev-docs/bidders directory describing the pa
 
 The attributes in the Jekyll 'front matter' drive various behaviors and dynamic tables elsewhere on the site.
 
+{: .table .table-bordered .table-striped }
+
 | Key | Required? | Values | Use |
 | ----- | ------ | ------ | ------ |
 | layout | yes | bidder | Links this file to the bidder.html layout |

From 8866a8de6993a375263b3dbf79327efaef083dd8 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 21 Feb 2025 02:32:38 -0800
Subject: [PATCH 013/665] JS: prerendering settings (#5901)

---
 dev-docs/publisher-api-reference/setConfig.md | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 43957cffb6..23cb8c179e 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -125,6 +125,26 @@ pbjs.setConfig({
 });
 ```
 
+### Change prerendering behavior
+
+When a page is [prerendered](https://developer.chrome.com/docs/web-platform/prerender-pages), by default Prebid will delay auctions until it is activated.
+
+You can disable this behavior and allow auctions to run during prerendering with `allowPrerendering`:
+
+```javascript
+pbjs.setConfig({
+  allowPrerendering: true
+})
+```
+
+Alternatively you may delay execution of the entire command queue (not just auctions) until the page is activated, using `delayPrerendering`:
+
+```javascript
+pbjs.delayPrerendering = true;
+```
+
+Note that `delayPrerendering` is a property of the `pbjs` global and not a normal setting; this is because it takes effect before (and delays) any call to `setConfig`.  
+
 ### Send All Bids
 
 <a name="setConfig-Send-All-Bids"></a>

From ed1b0a155c8aa9f33c8e1bdf666b0eb7afbc8700 Mon Sep 17 00:00:00 2001
From: Kai Miyamoto <157671757+hogekai@users.noreply.github.com>
Date: Fri, 21 Feb 2025 21:50:51 +0900
Subject: [PATCH 014/665] Add an in-renderer example to the sidebar (#5902)

* Add In-renderer Integration section to sidebar

* Fix link formatting in multi-format example documentation
---
 _data/sidebar.yml                         | 9 +++++++++
 dev-docs/examples/multi-format-example.md | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index 447b1ca163..5031ca0148 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -316,6 +316,15 @@
   sectionTitle:
   subgroup: 1
 
+- sbSecId: 1
+  title: In-renderer Integration
+  link: /dev-docs/examples/in-renderer-integration.html
+  Item: 1
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 1
+
 - sbSecId: 1
   title: Troubleshooting
   link:
diff --git a/dev-docs/examples/multi-format-example.md b/dev-docs/examples/multi-format-example.md
index 7bc75ad2e8..87b9381b87 100644
--- a/dev-docs/examples/multi-format-example.md
+++ b/dev-docs/examples/multi-format-example.md
@@ -11,7 +11,7 @@ about:
 - Any bidder that supports at least one of the listed media types can participate in the auction for that ad unit
 - For engineering setup instructions, see <a href="/dev-docs/show-multi-format-ads.html">Show Multi-Format Ads</a>
 - In this example, to keep it simple, ad rendering is performed using `pbjs.renderAd`
-- InRenderer.js, an open-source renderer optimized for in-renderer integration, is used as the renderer for in-renderer integration. For more information, see [InRenderer.js documentation on Github](https://github.com/hogekai/in-renderer-js)
+- InRenderer.js, an open-source renderer optimized for in-renderer integration, is used as the renderer for in-renderer integration. For more information, see <a href="https://github.com/hogekai/in-renderer-js" target="_blank">InRenderer.js documentation on Github</a>
 
 ---
 

From 9aaacf6887bb0c4a0ed1adb63ee96dd20addf8af Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Fri, 21 Feb 2025 14:02:08 -0500
Subject: [PATCH 015/665] PBC config updates (#5909)

* PBC config updates

* Update pbs-endpoints-pbc.md
---
 prebid-server/endpoints/pbs-endpoints-pbc.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/prebid-server/endpoints/pbs-endpoints-pbc.md b/prebid-server/endpoints/pbs-endpoints-pbc.md
index 5a8bec092a..d4b92d37e6 100644
--- a/prebid-server/endpoints/pbs-endpoints-pbc.md
+++ b/prebid-server/endpoints/pbs-endpoints-pbc.md
@@ -2,7 +2,6 @@
 layout: page_v2
 sidebarType: 5
 title: Prebid Cache Endpoints
-
 ---
 
 # Prebid Cache Endpoints
@@ -151,6 +150,11 @@ These entries in the PBC application.yaml file define storage-related params:
 
 - `api.storage-path` - path of the storage POST/GET endpoints. Defaults to '/storage'.
 - `api.api-key` - api key to secure storage POST endpoint. Host companies may not want everyone on the internet to be able to store stuff in their cache. The value of this key is set by the PBS host company in the PBC config and in the PBS config. (See [Storage PBC configuration](https://github.com/prebid/prebid-cache-java/blob/master/docs/config.md#storage) for details about where to set this.)
+- `cache.allow-external-UUID` - if 'false' then incoming writes cannot contain UUID key even if there's an API header. This is a master switch for accepting externally-defined keys. Default is 'false'.
+- `api.external-UUID-secured` - (PBC-Java 2.4+) if 'true', adds an additional security API check on top of the `cache.allow-external-UUID` property. It means that writes that contain a key can be only enabled for requests that carry a special header. Default is 'false'.
+- `api.cache-write-secured` - (PBC-Java 2.4+) when 'true' will only allow cache writes for requests that carry a special header. Default is 'false'.
+
+Prebid Server can be configured to pass the `x-pbc-api-key` special header containing the value of `api.api-key`. Both servers are configured with the same key. PBS sends the key on this header and PBC expects it to be there.
 
 The storage feature supports different `applications` and storage providers are configured per `application`. For now, only [Redis](https://redis.io/) is supported for storage. To configure Redis storage for particular application, configure the `storage.redis.{application-name}` property.
 If no `applications` are needed, set `storage.redis` to `{}` in application.yaml like so:
@@ -163,8 +167,13 @@ storage:
 Utilizing all the properties above, sample storage configuration:
 
 ```yaml
-api.storage-path: /storage
-api.api-key: API_KEY
+api:
+  storage-path: /storage
+  api-key: API_KEY
+  external-UUID-secured: true
+  cache-write-secured: false
+cache:
+  allow-external-UUID: true
 storage:
   redis:
     id-data:

From aae1d3e0f8bad2dae5c9dc0ba5e3190a8babbce6 Mon Sep 17 00:00:00 2001
From: CondorXIO <admin@condorx.io>
Date: Sun, 23 Feb 2025 14:16:21 +0200
Subject: [PATCH 016/665] Add CondorX Bidder docs (#5818)

* Add CondorX Bidder docs

* change layout

* PR fixes

* Update dev-docs/bidders/condorx.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* fix condorx adapter docs

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/condorx.md | 57 +++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 dev-docs/bidders/condorx.md

diff --git a/dev-docs/bidders/condorx.md b/dev-docs/bidders/condorx.md
new file mode 100644
index 0000000000..fe4c7c013e
--- /dev/null
+++ b/dev-docs/bidders/condorx.md
@@ -0,0 +1,57 @@
+---
+layout: bidder
+title: CondorX
+description: Prebid CondorX Bidder Adapter
+biddercode: condorx
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 1375
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+media_types: banner, native
+safeframes_ok: false
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+The CondorX Bidding adapter requires setup before beginning. Please contact us at [CondorX](https://condorx.io).
+
+### Bid params
+
+| Name     | Scope    | Description                                                 | Example              |
+|----------|----------|-------------------------------------------------------------|----------------------|
+| `widget` | required | The widget ID, by CondorX                                  | `12345`              |
+| `website`| required | The website ID, by Condorx                                  | `12345`              |
+| `url`    | optional | Current url                                                 | `https://condorx.io` |
+
+### Example Ad Unit
+
+```javascript
+var adUnits = [{
+    code: 'condorx-container-id',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250]],  
+        }
+    },
+    bids: [{
+        bidder: "condorx",
+        params: {
+            widget: 'widget id by CondorX',
+            website: 'website id by CondorX',
+            url:'current url'
+        }
+    }]
+}];

From 9cba61c0d20a55246db1f2457e9dd8e1725fe6ff Mon Sep 17 00:00:00 2001
From: Oleksandr Zhevedenko <720803+Net-burst@users.noreply.github.com>
Date: Mon, 24 Feb 2025 07:44:53 -0500
Subject: [PATCH 017/665] Update pbs-endpoints-pbc.md (#5910)

---
 prebid-server/endpoints/pbs-endpoints-pbc.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prebid-server/endpoints/pbs-endpoints-pbc.md b/prebid-server/endpoints/pbs-endpoints-pbc.md
index d4b92d37e6..2772e4d796 100644
--- a/prebid-server/endpoints/pbs-endpoints-pbc.md
+++ b/prebid-server/endpoints/pbs-endpoints-pbc.md
@@ -154,7 +154,7 @@ These entries in the PBC application.yaml file define storage-related params:
 - `api.external-UUID-secured` - (PBC-Java 2.4+) if 'true', adds an additional security API check on top of the `cache.allow-external-UUID` property. It means that writes that contain a key can be only enabled for requests that carry a special header. Default is 'false'.
 - `api.cache-write-secured` - (PBC-Java 2.4+) when 'true' will only allow cache writes for requests that carry a special header. Default is 'false'.
 
-Prebid Server can be configured to pass the `x-pbc-api-key` special header containing the value of `api.api-key`. Both servers are configured with the same key. PBS sends the key on this header and PBC expects it to be there.
+Prebid Server can be configured to pass the `x-pbc-api-key` special header containing the value of `pbc.api.key`. Both servers are configured with the same key. PBS sends the key on this header when the property `cache.api-key-secured` is set to `true` and PBC expects it to be there.
 
 The storage feature supports different `applications` and storage providers are configured per `application`. For now, only [Redis](https://redis.io/) is supported for storage. To configure Redis storage for particular application, configure the `storage.redis.{application-name}` property.
 If no `applications` are needed, set `storage.redis` to `{}` in application.yaml like so:

From 5264c3a62f572e47813ceeb6fdb1e97cbc7b275e Mon Sep 17 00:00:00 2001
From: hasanideepak <80700939+hasanideepak@users.noreply.github.com>
Date: Mon, 24 Feb 2025 21:40:55 +0530
Subject: [PATCH 018/665] New Adapter : lane4 (#5867)

* Audiencelogy Bid Adapter : Initial Release

* Removed space

* new adapter : lane4

* new adapter : lane4

* added usnat in gpp_sids
---
 dev-docs/bidders/lane4.md | 92 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 dev-docs/bidders/lane4.md

diff --git a/dev-docs/bidders/lane4.md b/dev-docs/bidders/lane4.md
new file mode 100644
index 0000000000..b2421b0f49
--- /dev/null
+++ b/dev-docs/bidders/lane4.md
@@ -0,0 +1,92 @@
+---
+layout: bidder
+title: Lane4
+description: Prebid lane4 Bidder Adaptor
+pbjs: true
+biddercode: lane4
+media_types: banner, native
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+gpp_sids: usstate_all, usnat
+schain_supported: false
+safeframes_ok: false
+ortb_blocking_supported: false
+dsa_supported: false
+deals_supported: true
+floors_supported: true
+sidebarType: 1
+---
+### Registration
+
+For assistance or setup instructions, please contact us at <adsupport@lane4.io>.
+
+### Banner Params
+
+{: .table .table-bordered .table-striped }
+| Name           | Scope     | Description           | Example        | Type     |
+|----------------|-----------|-----------------------|----------------|----------|
+| `placement_id` | mandatory | Placement Id          | `110044`       | `number` |
+| `height`       | optional  | Height of the creative| `250`          | `number` |
+| `width`        | optional  | Width of the creative | `300`          | `number` |
+| `bid_floor`    | optional  | Bid Floor Price       | `0.5`          | `decimal`|
+
+### AdUnit Format for Banner
+
+```javascript
+var adUnits = [
+            {
+                code: 'banner-ad',
+                mediaTypes: {
+                    banner: {
+                        sizes: [[300, 250]]
+                    }
+                },
+                bids: [{
+                    bidder: 'lane4',
+                    params: {
+                        placement_id: 110044,
+                        height: 250,
+                        width: 300,
+                        bid_floor: 0.5
+                    }
+                }]
+            }
+        ];
+```
+
+### Native Params
+
+{: .table .table-bordered .table-striped }
+| Name           | Scope     | Description           | Example        | Type     |
+|----------------|-----------|-----------------------|----------------|----------|
+| `placement_id` | mandatory | Placement Id          | `110045`       | `number` |
+| `bid_floor`    | optional  | Bid Floor Price       | `1`            | `decimal`|
+
+### AdUnit Format for Native
+
+```javascript
+var adUnits = [
+            {
+                code: 'native-ad-container',
+                mediaTypes: {
+                    native: {
+                        title: { required: true, len: 100 },
+                        image: { required: true, sizes: [300, 250] },
+                        sponsored: { required: false },
+                        clickUrl: { required: true },
+                        desc: { required: true },
+                        icon: { required: false, sizes: [50, 50] },
+                        cta: { required: false }
+                    }
+                },
+                bids: [{
+                    bidder: 'lane4',
+                    params: {
+                        placement_id: 110045, // Required parameter
+                        bid_floor: 1 // Optional parameter
+                    }   
+                }]
+            }
+        ];
+```

From 89641435a1728c511da0b7420c499e54a0acc4c4 Mon Sep 17 00:00:00 2001
From: Lyubomir Shishkov <61063794+lyubomirshishkov@users.noreply.github.com>
Date: Mon, 24 Feb 2025 21:57:02 +0200
Subject: [PATCH 019/665] Add documentation for Improve Digital Bid Adapter's
 newly added support for MultiBid and removed a previously deprecated feature
 from the documentation. (#5895)

---
 dev-docs/bidders/improvedigital.md | 32 ++++++++++++++----------------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/dev-docs/bidders/improvedigital.md b/dev-docs/bidders/improvedigital.md
index 893e98b235..b4bbd09431 100644
--- a/dev-docs/bidders/improvedigital.md
+++ b/dev-docs/bidders/improvedigital.md
@@ -31,7 +31,6 @@ sidebarType: 1
 | `bidFloor`  | optional | Bid floor price | `0.01` | `float` |
 | `bidFloorCur`  | optional | Bid floor price currency. Supported values: USD (default), EUR, GBP, AUD, DKK, SEK, CZK, CHF, NOK | `'USD'` | `string` |
 | `extend`  | optional | See the [Extend mode section](#improvedigital-extend)  | `true` | `boolean` |
-| `rendererConfig`  | optional | Configuration object for JS renderer of the RAZR creatives. Provided by Improve Digital.  | `{ key1: value1 }` | `object` |
 
 ### Configuration
 
@@ -47,22 +46,6 @@ pbjs.setConfig({
 });
 ```
 
-<a name="improvedigital-renderer"></a>
-
-#### Renderer Config
-
-Global configuration for the special creative format renderer. Please use [rendererConfig bid param](#improvedigital-params) for ad slot specific configuration.
-
-```javascript
-pbjs.setConfig({
-    improvedigital: {
-        rendererConfig: {
-            // Global config object provided by Improve Digital
-        }
-    }
-});
-```
-
 <a name="improvedigital-extend"></a>
 
 #### Extend Mode
@@ -81,6 +64,21 @@ pbjs.setConfig({
 });
 ```
 
+<a name="improvedigital-multibid"></a>
+
+#### MultiBid
+
+Improve Digital supports Prebid's MultiBid feature. More on enabling MultiBid can be found here: [MultiBid](https://docs.prebid.org/dev-docs/modules/multibid.html). An example of how to enable MultiBid for Improve Digital:
+
+```javascript
+pbjs.setConfig({
+    multibid: [{
+        bidder: "improvedigital",
+        maxBids: 3,
+    }]
+});
+```
+
 <a name="improvedigital-examples"></a>
 
 ### Examples

From a9e3f5b906c13c871f82b60c21e7891d59c9c241 Mon Sep 17 00:00:00 2001
From: dmytro-po <dmytro.po@intentiq.com>
Date: Mon, 24 Feb 2025 21:57:24 +0200
Subject: [PATCH 020/665] AGT-399: GAM documentation (#5892)

---
 dev-docs/modules/userid-submodules/intentiq.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 9c1880b98a..449b356983 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -46,6 +46,8 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.browserBlackList        | Optional |  String  | This is the name of a browser that can be added to a blacklist.                                                                                                                                                                                                                                                                           | `"chrome"`                                    |
 | params.manualWinReportEnabled  | Optional | Boolean  | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `true`|
 | params.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.                     | `"currentDomain.com"`                         |
+| params.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.                                                                                                                                                                  | `googletag`                           |
+| params.gamParameterName        | Optional | String   | The name of the targeting parameter that will be used to pass the group. If not specified, the default value is `intent_iq_group`.                                                                                                                                                                                                        | `"intent_iq_group"`                           |
 
 ### Configuration example
 
@@ -60,7 +62,9 @@ pbjs.setConfig({
                 browserBlackList: "chrome",
                 callback: (data, group) => window.pbjs.requestBids(),
                 manualWinReportEnabled: true,
-                domainName: "currentDomain.com"
+                domainName: "currentDomain.com",
+                gamObjectReference: googletag,
+                gamParameterName: "intent_iq_group"
             },
             storage: {
                 type: "html5",

From 7fdc856c61857f1d43ea64899d2a89bd78821b68 Mon Sep 17 00:00:00 2001
From: abazylewicz-id5 <106807984+abazylewicz-id5@users.noreply.github.com>
Date: Mon, 24 Feb 2025 20:57:59 +0100
Subject: [PATCH 021/665] ID5 UserId - added docs for canCookieSync param
 (#5890)

---
 dev-docs/modules/userid-submodules/id5.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/id5.md b/dev-docs/modules/userid-submodules/id5.md
index 00e61fc1bb..2a056307d8 100644
--- a/dev-docs/modules/userid-submodules/id5.md
+++ b/dev-docs/modules/userid-submodules/id5.md
@@ -40,6 +40,7 @@ The following configuration parameters are available:
 | params.abTesting.enabled | Optional | Boolean | Set this to `true` to turn on this feature | `true` or `false` |
 | params.abTesting.controlGroupPct | Optional | Number | Must be a number between `0.0` and `1.0` (inclusive) and is used to determine the percentage of requests that fall into the control group (and thus not exposing the ID5 ID). For example, a value of `0.20` will result in 20% of requests without an ID5 ID and 80% with an ID. | `0.1` |
 | params.disableExtensions | Optional | Boolean | Set this to `true` to force turn off extensions call. Default `false` | `true` or `false` |
+| params.canCookieSync | Optional | Boolean | Set this to `true` to enable cookie syncing with other ID5 partners. See [our documentation](https://wiki.id5.io/docs/initiate-cookie-sync-to-id5) for details. Default `false` | `true` or `false` |
 | params.provider | Optional | String | An identifier provided by ID5 to technology partners who manage API deployments on behalf of their clients. Reach out to ID5 if you have questions about this parameter. | `"providerName"` |
 
 {: .alert.alert-info :}
@@ -70,7 +71,8 @@ pbjs.setConfig({
         abTesting: {             // optional
           enabled: true,         // false by default
           controlGroupPct: 0.1   // valid values are 0.0 - 1.0 (inclusive)
-        }
+        },
+        canCookieSync: true      // optional, has effect only when externalModuleUrl is used 
       },
       storage: {
         type: 'html5',           // "html5" is the recommended storage type

From 0777625357e4ca9735ba246e3b97c7cd0693ec40 Mon Sep 17 00:00:00 2001
From: Alexandr Kim <47887567+alexandr-kim-vl@users.noreply.github.com>
Date: Tue, 25 Feb 2025 01:02:49 +0500
Subject: [PATCH 022/665] SemantIQ RTD Provider: initial release (#5904)

---
 dev-docs/modules/semantiqRtdProvider.md | 57 +++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 dev-docs/modules/semantiqRtdProvider.md

diff --git a/dev-docs/modules/semantiqRtdProvider.md b/dev-docs/modules/semantiqRtdProvider.md
new file mode 100644
index 0000000000..d15f254b0f
--- /dev/null
+++ b/dev-docs/modules/semantiqRtdProvider.md
@@ -0,0 +1,57 @@
+---
+layout: page_v2
+title: SemantIQ RTD module
+display_name : SemantIQ
+description: SemantIQ RTD module allows to retrieve real-time data from the SemantIQ service.
+page_type: module
+module_type: rtd
+module_code: semantiqRtdProvider
+enable_download: true
+sidebarType: 1
+vendor_specific: true
+
+---
+
+# Semantiq Rtd Provider
+
+## Description
+
+This module retrieves real-time data from the SemantIQ service and populates ORTB data.
+
+You need to obtain a company ID from [Audienzz](https://audienzz.com) for the module to function properly. Contact [service@audienzz.ch](mailto:service@audienzz.ch) for details.
+
+## Integration
+
+1. Include the module into your `Prebid.js` build.
+
+    ```sh
+    gulp build --modules='rtdModule,semantiqRtdProvider,...'
+    ```
+
+1. Configure the module via `pbjs.setConfig`.
+
+    ```js
+    pbjs.setConfig({
+      ...
+      realTimeData: {
+        dataProviders: [
+          {
+            name: 'semantiq',
+            waitForIt: true,
+            params: {
+              companyId: 12345,
+              timeout: 1000,
+            },
+          },
+        ],
+      },
+    });
+    ```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+|Name     |Required|Description                                                 |Type    |Default value|Example              |
+|---------+--------+------------------------------------------------------------+--------+-------------+---------------------|
+|companyId|No     |Company ID obtained from [Audienzz](https://audienzz.com).  |number \| number[]  |-            |12345                |
+|timeout  |No      |The maximum time to wait for a response in milliseconds.    |number  |1000         |3000                 |

From 2f5d54e47a619c3c26e32925b4ebaff0a2f408d4 Mon Sep 17 00:00:00 2001
From: zeeye <56828723+zeeye@users.noreply.github.com>
Date: Wed, 26 Feb 2025 06:40:20 +0000
Subject: [PATCH 023/665] Mobkoi Bidder Adapter and Mobkoi Analytics Adapter
 initial docs (#5809)

* Mobkoi Bidder Adapter and Mobkoi Analytics Adapter docs

* removed the line that suggested in official PR review

* multiformat_supported: will-bid-on-one

* added userId configs

* initialise user id module doc

* github action fix

* updated userId module and bidder adapter

corrected a mistake

corrected a mistake

tidy up
---
 dev-docs/analytics/mobkoi.md                 | 53 ++++++++++++++++
 dev-docs/bidders/mobkoi.md                   | 64 ++++++++++++++++++++
 dev-docs/modules/userid-submodules/mobkoi.md | 51 ++++++++++++++++
 3 files changed, 168 insertions(+)
 create mode 100644 dev-docs/analytics/mobkoi.md
 create mode 100644 dev-docs/bidders/mobkoi.md
 create mode 100644 dev-docs/modules/userid-submodules/mobkoi.md

diff --git a/dev-docs/analytics/mobkoi.md b/dev-docs/analytics/mobkoi.md
new file mode 100644
index 0000000000..4a82a15eb9
--- /dev/null
+++ b/dev-docs/analytics/mobkoi.md
@@ -0,0 +1,53 @@
+---
+layout: analytics
+title: Mobkoi
+description: Mobkoi Analytics Adapter
+modulecode: mobkoi
+prebid_member: false
+tcfeu_supported: true
+usp_supported: false
+coppa_supported: false
+gvl_id: 898
+enable_download: true
+---
+
+#### Registration
+
+The Mobkoi Analytics adapter requires setup and approval. Please send an email to <platformteam@mobkoi.com> for more information.
+
+### Setting First Party Data (FPD)
+
+Publishers should use the `pbjs.setBidderConfig` method of setting First Party Data. The following fields are supported:
+
+| Path                                        | Scope    | Description                  | Example                   | Type      |
+|---------------------------------------------|----------|------------------------------|---------------------------|-----------|
+| `ortb2.site.publisher.id`                   | required | Mobkoi Provided Publisher ID | `'mobkoi-publisher-id'`   | `string`  |
+| `ortb2.site.publisher.ext.adServerBaseUrl`  | required | Ad Server URL                | `'https://adserver.com'`  | `string`  |
+
+#### Example Configuration
+
+```js
+pbjs.que.push(function () {
+  pbjs.enableAnalytics([
+    {
+      provider: 'mobkoi',
+    },
+  ]);
+
+  pbjs.setBidderConfig({
+    bidders: ['mobkoi'],
+    config: {
+      ortb2: {
+        site: {
+          publisher: {
+            id: '<<-- Required. Provided Mobkoi Publisher ID -->>',
+            ext: {
+              adServerBaseUrl: '<<-- Required. Provided by Mobkoi -->>',
+            },
+          },
+        },
+      },
+    },
+  });
+});
+```
diff --git a/dev-docs/bidders/mobkoi.md b/dev-docs/bidders/mobkoi.md
new file mode 100644
index 0000000000..1929ad4b89
--- /dev/null
+++ b/dev-docs/bidders/mobkoi.md
@@ -0,0 +1,64 @@
+---
+layout: bidder
+title: Mobkoi
+description: Mobkoi Bidder Adapter
+biddercode: mobkoi
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 898
+usp_supported: false
+coppa_supported: false
+gpp_sids: tcfeu
+schain_supported: false
+dchain_supported: false
+userId: mobkoiId
+media_types: banner
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: partial
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+The Mobkoi Bidding adapter requires setup and approval before beginning. Please reach out to <platformteam@mobkoi.com> for
+more details.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Path                                        | Scope    | Description                  | Example                   | Type      |
+|---------------------------------------------|----------|------------------------------|---------------------------|-----------|
+| `placementId`                               | required | Mobkoi Provided Placement ID | `'DF2FFFFF'`              | `string`  |
+
+#### Example Configuration
+
+```js
+const adUnits = [
+  {
+    code: 'banner-ad',
+    mediaTypes: {
+      banner: { sizes: [300, 200] },
+    },
+    bids: [
+      {
+        bidder: 'mobkoi',
+        params: {
+          placementId: '<-- Placement ID provided by Mobkoi -->',
+        },
+      },
+    ],
+  },
+];
+
+pbjs.que.push(function () {
+  pbjs.addAdUnits(adUnits);
+});
+```
diff --git a/dev-docs/modules/userid-submodules/mobkoi.md b/dev-docs/modules/userid-submodules/mobkoi.md
new file mode 100644
index 0000000000..92df14bbb9
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/mobkoi.md
@@ -0,0 +1,51 @@
+---
+layout: userid
+title: Mobkoi ID
+description: Mobkoi ID User ID sub-module
+useridmodule: mobkoiIdSystem
+bidRequestUserId: mobkoiId
+eidsource: mobkoi.com
+example: '"1111111111111"'
+---
+
+The Mobkoi ID system provides user identification capabilities for improved addressability and targeted advertising. This module handles user ID synchronization and storage while supporting GDPR consent management.
+
+## Add Mobkoi ID to your Prebid.js Package
+
+Add the module to your Prebid.js package:
+
+```bash
+gulp build --modules=consentManagementTcf,tcfControl,mobkoiIdSystem,userId
+```
+
+## Mobkoi ID Configuration
+
+{: .table .table-bordered .table-striped }
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | The name of this module | `"mobkoiId"` |
+| storage | Required | Object | Storage settings for the ID | |
+| storage.type | Required | String | Where to store the ID - must be `"cookie"` | `"cookie"` |
+| storage.name | Required | String | Cookie name for storing the ID | `"_mobkoi_Id"` |
+| storage.expires | Required | Integer | Number of days before the cookie expires | `30` |
+
+## Example Configuration
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [
+            {
+                name: 'mobkoiId',
+                storage: {
+                    type: 'cookie',
+                    name: '_mobkoi_Id',
+                    expires: 30, // days
+                },
+            },
+        ],
+    },
+});
+```
+
+For integration support or questions, contact <platformteam@mobkoi.com>.

From 40c1b854ef3ef67c0b973d2e1aef0ac6fc2ba1ce Mon Sep 17 00:00:00 2001
From: "Adserver.Online" <61009237+adserver-online@users.noreply.github.com>
Date: Wed, 26 Feb 2025 17:35:51 +0200
Subject: [PATCH 024/665] add cordless alias doc (#5855)

Co-authored-by: dev <dev@adsrv.org>
---
 dev-docs/bidders/cordless.md | 44 ++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 dev-docs/bidders/cordless.md

diff --git a/dev-docs/bidders/cordless.md b/dev-docs/bidders/cordless.md
new file mode 100644
index 0000000000..d62f5623e2
--- /dev/null
+++ b/dev-docs/bidders/cordless.md
@@ -0,0 +1,44 @@
+---
+layout: bidder
+title: Cordless.co
+description: Cordless.co Bid Adapter
+biddercode: cordless
+tcfeu_supported: false
+usp_supported: true
+media_types: video, native
+safeframes_ok: true
+pbjs: true
+pbs: true
+pbs_app_supported: true
+floors_supported: true
+schain_supported: true
+fpd_supported: true
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+userIds: all
+sidebarType: 1
+aliasCode: aso
+---
+### Note
+
+The Cordless.co adapter requires approval and setup. Please reach out to <info@cordless.co> or visit us at [cordless.co](https://cordless.co) for more details.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description      | Example                         | Type      |
+|---------------|----------|------------------|---------------------------------|-----------|
+| `server`      | required | Server endpoint  | `https://srv.cordlessmedia.com` | `String`  |
+| `zone`        | required | Zone ID          | `73815`                         | `Integer` |
+
+#### Video Caching
+
+Note that the Cordless.co adapter expects a client-side Prebid Cache to be enabled for video bidding.
+
+```js
+pbjs.setConfig({
+    cache: {
+        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+    }
+});
+```

From 375d8ca4b2a2199e081036fb9f23f63d905d9c55 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Wed, 26 Feb 2025 23:57:30 +0200
Subject: [PATCH 025/665] Attekmi: add new adapter Adinify (#5822)

* Attekmi: add new adapter adinify

* pbs to false, multiformat param fix

* pbs to true

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/adinify.md | 39 +++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/adinify.md

diff --git a/dev-docs/bidders/adinify.md b/dev-docs/bidders/adinify.md
new file mode 100644
index 0000000000..996e97836d
--- /dev/null
+++ b/dev-docs/bidders/adinify.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Adinify
+description: Adinify Bidder Adapter
+biddercode: adinify
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 681ecb538409d3000dd271b4a949add55970a3ef Mon Sep 17 00:00:00 2001
From: rimaburder-index <55195208+rimaburder-index@users.noreply.github.com>
Date: Sun, 2 Mar 2025 14:40:48 -0500
Subject: [PATCH 026/665] Updated  the PAAPI section with the module names and
 correct links (#5917)

* Update ix.md

Updated the modules to add and the links in the PAAPI section

* Update ix.md

* Update ix.md

updated links in the PAAPI section

* Update ix.md

Updated PAAPI section links
---
 dev-docs/bidders/ix.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/dev-docs/bidders/ix.md b/dev-docs/bidders/ix.md
index 7784e32722..8485dd9d0b 100644
--- a/dev-docs/bidders/ix.md
+++ b/dev-docs/bidders/ix.md
@@ -376,15 +376,16 @@ pbjs.addAdUnits({
 
 **Before you begin:**
 
-* You must have Google Ad Manager and the [paapiForGpt](/dev-docs/modules/paapiForGpt.html) module.
+* You must be using Google Ad Manager as your ad server.
 * In your Google Ad Manager configuration, make sure that you have not opted out from using the Protected Audience API. For more information about the configuration, see Google's documentation on  [Protected Audience API and Ad Manager after Chrome GA](https://support.google.com/admanager/answer/13627134?hl=en&ref_topic=12264880&sjid=10591375417866092080-NA).
 
 Depending on the Prebid.js version that you are using, the steps to configure Prebid.js will differ. Follow the steps provided in the appropriate section for the version of Prebid.js that you are using:
 
 **Configure Protected Audience API for Prebid.js versions 8.18.0 to 8.36.0**
 
-1. Build the `paapiForGpt` module in your Prebid.js configuration by adding `fledgeForGpt` to the list of modules that you are already using. For more information about the module, see Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation.
-2. Configure your ad units to make them eligible for Protected Audience API demand. You can do this in the global-level configuration, bidder level, or ad-unit level. For more information about the configurations, see Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation. Index recommends that you do this in the global-level configuration by using the `defaultForSlots` parameter with a value of `1`. The following code is an example of the configuration done at the global level:
+1. Build the [PAAPI module](/dev-docs/modules/paapi.html) and the Fledge for GPT module in your Prebid.js configuration by adding `paapi` and `fledgeForGpt` to the list of modules that you are already using. <br />
+**Note:** The `fledgeForGpt` module documentation no longer exists on Prebid's site. You can however refer to Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation for information on adding module configurations.
+2. Configure your ad units to make them eligible for Protected Audience API demand. You can do this in the global-level configuration, bidder level, or ad-unit level. Index recommends that you do this in the global-level configuration by using the `defaultForSlots` parameter with a value of `1`. The following code is an example of the configuration done at the global level:
 
     ```javascript
      pbjs.que.push(function() {
@@ -413,7 +414,8 @@ Depending on the Prebid.js version that you are using, the steps to configure Pr
 
 **Configure Protected Audience API for Prebid.js versions 8.37.0 and up to 9.0.0**
 
-1. Build the `fledgeForGpt` module in your Prebid.js configuration by adding `fledgeForGpt` to the list of modules that you are already using. For more information about the module, see Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation.
+1. Build the PAAPI module in your Prebid.js configuration by adding `fledgeForGpt` to the list of modules that you are already using. When you add the `fledgeForGpt` module, the `paapi` module automatically gets included as a sub-module. For more information about the module, see Prebid's [PAAPI module](/dev-docs/modules/paapi.html) documentation. <br />
+**Note:** The `fledgeForGpt` module documentation no longer exists on Prebid's site. You can however refer to Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation for information on adding module configurations.
 2. Complete the following steps to make your ad units eligible for Protected Audience API demand: <br />
 **Note:** If you continue to use the `fledgeForGpt` property, you will receive a warning message in the console logs stating that the `fledgeForGpt` configuration options will soon be renamed to `paapi`. Therefore, Index recommends that you use the `paapi` property, which is available in Prebid.js version 8.37.0 or later.
     * In the `pbjs.setConfig().paapi` field, set the `defaultForSlots` parameter to `1`:
@@ -464,9 +466,9 @@ Depending on the Prebid.js version that you are using, the steps to configure Pr
 
 **Configure Protected Audience API for Prebid.js version 9.0.0 or later**
 
-1. Build the [PAAPI](/dev-docs/modules/paapi.html) module in your Prebid.js configuration by adding paapi to the list of modules that you are already using. For more information about the module, see Prebid's [Protected Audience API (PAAPI) for GPT Module(/dev-docs/modules/paapiForGpt.html) documentation.
+1. Build the PAAPI for GPT module in your Prebid.js configuration by adding `paapi` to the list of modules that you are already using. For more information about the module, see Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation.
 2. In the `pbjs.setConfig().paapi` field, set the `defaultForSlots` parameter to `1`. 
-3. In the `paapi.gpt.configWithTargeting` field, set `configWithTargeting` to `true`. For more control over configuring GPT slots to use PAAPI, set the `configWithTargeting` to `false` and use the `setPAAPIConfigForGPT` API. For more information about the configurations, see Prebid’s Prebid's [Protected Audience API (PAAPI) for GPT Module(/dev-docs/modules/paapiForGpt.html) documentation. <br />The following code is an example of the `defaultForSlots` and `configWithTargeting` configuration:
+3. In the `paapi.gpt.configWithTargeting` field, set `configWithTargeting` to `true`. For more control over configuring GPT slots to use PAAPI, set the `configWithTargeting` to `false` and use the `setPAAPIConfigForGPT` API. For more information about the configurations, see Prebid's [Protected Audience API (PAAPI) for GPT Module](/dev-docs/modules/paapiForGpt.html) documentation. <br />The following code is an example of the `defaultForSlots` and `configWithTargeting` configuration:
 
   ```javascript
   pbjs.que.push(function() {

From b48930bd921f54f3ae91266b98b8715cbd203112 Mon Sep 17 00:00:00 2001
From: Kai Miyamoto <157671757+hogekai@users.noreply.github.com>
Date: Mon, 3 Mar 2025 16:13:55 +0900
Subject: [PATCH 027/665] New Bidder: Michao (#5731)

* New Bidder: Michao

* Michao Bid Adapter: Fixed Lint error

* Michao Bid Adapter: Support for rewarded advertising

* Michao Bid Adapter: Support for native format

* Michao Bid Adapter: Fix lint

* Michao Bid Adapter: Supports placement string type

* Michao Bid Adapter: Support for bid floor

* Michao Bid Adapter: Add partner id param

* Michao Bid Adapter: Fix first party data and required params and ortb blocking params

* Michao Bid Adapter: Update documentation for bid parameters and first party data
---
 dev-docs/bidders/michao.md | 190 +++++++++++++++++++++++++++++++++++++
 1 file changed, 190 insertions(+)
 create mode 100644 dev-docs/bidders/michao.md

diff --git a/dev-docs/bidders/michao.md b/dev-docs/bidders/michao.md
new file mode 100644
index 0000000000..dd75f6313f
--- /dev/null
+++ b/dev-docs/bidders/michao.md
@@ -0,0 +1,190 @@
+---
+layout: bidder
+title: Michao
+description: Prebid Michao SSP Bidder Adapter
+biddercode: michao
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: true
+privacy_sandbox: topics
+sidebarType: 1
+---
+
+### Note
+
+The Michao Bidding adapter requires setup before beginning.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| ----------- | -------- | ------------ | --------- | --------- |
+| `placement` | required | Placement id | `"12345"` | `string` |
+| `site` | required | Site id | `6789` | `number` |
+| `partner` | optional | Partner id | `6789` | `number` |
+| `test` | optional | Test Mode | `true` | `boolean` |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
+
+- `ortb2.site.*`
+- `ortb2.user.*`
+- `ortb2.device.*`
+- `ortb2.regs.*`
+
+Example:
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ["michao"],
+  config: {
+    ortb2: {
+      site: {
+        keywords: "kw1,kw2",
+      },
+    },
+  },
+});
+```
+
+### ORTB Blocking
+
+supported:
+
+- `badv`
+- `bcat`
+- `bseat`
+- `bapp`
+
+Example:
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ["michao"],
+  config: {
+    ortb2: {
+      badv: ["adomain.com"],
+      bcat: ["IAB2"],
+      bapp: ["com.app"],
+      bseat: ["seat"],
+    },
+  },
+});
+```
+
+### Media Types
+
+#### Video
+
+The following video parameters are supported here so publishers may fully declare their video inventory. These apply to both instream and outstream.
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| -------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------- |
+| context | required | instream or outstream | "outstream" | string |
+| playerSize | required | width, height of the player in pixels | [640,360] - will be translated to w and h in bid request | array<integers> |
+| mimes | required | List of content MIME types supported by the player (see openRTB v2.5 for options) | ["video/mp4"] | array<string> |
+| protocols | required | Supported video bid response protocol values <br />1: VAST 1.0 <br />2: VAST 2.0 <br />3: VAST 3.0 <br />4: VAST 1.0 Wrapper <br />5: VAST 2.0 Wrapper <br />6: VAST 3.0 Wrapper <br />7: VAST 4.0 <br />8: VAST 4.0 Wrapper | [2,3,5,6] | array<integers> |
+| maxduration | recommended | Maximum video ad duration in seconds. | 30 | integer |
+| minduration | recommended | Minimum video ad duration in seconds | 6 | integer |
+| linearity | recommended | OpenRTB2 linearity. 1: linear (in-stream ad), 2: non-linear (overlay ad) | 1 | integer |
+| playbackmethod | recommended | Playback methods that may be in use. Only one method is typically used in practice. (see openRTB v2.5 section 5.10 for options) | [2] | array<integers> |
+| api | optional | Supported API framework values: <br />1: VPAID 1.0 <br />2: VPAID 2.0 <br />3: MRAID-1 <br />4: ORMMA <br />5: MRAID-2 | [2] | array<integers> |
+| skip | optional | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes. | 1 | integer |
+| skipafter | optional | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable. | 6 | integer |
+| minbitrate | optional | Minimum bit rate in Kbps. | 300 | integer |
+| maxbitrate | optional | Maximum bit rate in Kbps. | 9600 | integer |
+| placement | recommended | Placement type for the impression. (see OpenRTB v2.5 section 5.9 for options) | 1 | integer |
+| plcmt | recommended | Placement type for the impression. (See [OpenRTB v2.6](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md) Plcmt Subtypes - Video) | 1 | integer |
+
+Example:
+
+```javascript
+var videoAdUnit = {
+    code: 'video',
+    mediaTypes: {
+        video: {
+            context: 'instream',
+            playerSize: [640, 480],
+            mimes: ['video/mp4']
+            protocols: [2, 3, 5, 6],
+            api: [2],
+            maxduration: 30,
+            minduration: 0,
+        }
+    },
+    bids: [{
+        bidder: 'michao',
+        params: {
+            site: 123,
+            placement: "456",
+        }
+    }]
+};
+```
+
+##### Out-stream Video
+
+Michao adapter supports outstream video renderer in two ways: using your own renderer or using ours on Prebid.org.
+
+#### Native
+
+Example:
+
+```js
+var nativeAdUnit = {
+  code: "myNativeAdUnit",
+  mediaTypes: {
+    native: {
+      ortb: {
+        assets: [
+          {
+            id: 1,
+            required: 1,
+            img: {
+              type: 3,
+              w: 150,
+              h: 50,
+            },
+          },
+          {
+            id: 2,
+            required: 1,
+            video: {
+              minduration: 0,
+              maxduration: 120,
+              mimes: ["video/mp4"],
+              protocols: [8],
+            },
+          },
+        ],
+      },
+    },
+  },
+  bids: [
+    {
+      bidder: "michao",
+      params: {
+        site: 123,
+        placement: "456",
+      },
+    },
+  ],
+};
+```

From 2dcbc13e879d6d630eaf950f00f4075c23aea0af Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 3 Mar 2025 18:05:16 +0200
Subject: [PATCH 028/665] Attekmi: add Addigi adapter (#5836)

* Attekmi: add Addigi adapter

* multiformat_supported and pbs params change

* pbs to true

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/addigi.md | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/addigi.md

diff --git a/dev-docs/bidders/addigi.md b/dev-docs/bidders/addigi.md
new file mode 100644
index 0000000000..a0eab555bb
--- /dev/null
+++ b/dev-docs/bidders/addigi.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Addigi
+description: Addigi Bidder Adapter
+biddercode: addigi
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 2949e78569e97978a859c7afa98ee92cbaba8256 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:04:29 +0200
Subject: [PATCH 029/665] Smarthub: renaming Smarthub to Attekmi (#5699)

* Smarthub: renaming Smarthub to Attekmi

* add attekmi.md

* renamed title and description

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/attekmi.md  | 42 ++++++++++++++++++++++++++++++++++++
 dev-docs/bidders/smarthub.md |  8 +++++--
 2 files changed, 48 insertions(+), 2 deletions(-)
 create mode 100644 dev-docs/bidders/attekmi.md

diff --git a/dev-docs/bidders/attekmi.md b/dev-docs/bidders/attekmi.md
new file mode 100644
index 0000000000..f2c22d9b58
--- /dev/null
+++ b/dev-docs/bidders/attekmi.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: Attekmi
+description: Attekmi Bidder Adapter
+biddercode: smarthub
+usp_supported: true
+media_types: banner, video, native
+tcfeu_supported: false
+pbjs: true
+pbs: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbs_app_supported: true
+multiformat_supported: true
+sidebarType: 1
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `partnerName` | required | Unique partner name             | `'partnertest'`                     | `string`  |
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`    | `Array(String)`   |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.    | `4`                                 | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `partnerName` | required | Unique partner name | `'partnertest'`                      | `string` |
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |
diff --git a/dev-docs/bidders/smarthub.md b/dev-docs/bidders/smarthub.md
index c1853bd9c4..66ce57ba44 100644
--- a/dev-docs/bidders/smarthub.md
+++ b/dev-docs/bidders/smarthub.md
@@ -1,7 +1,7 @@
 ---
 layout: bidder
-title: SmartHub
-description: SmartHub Bidder Adapter
+title: Attekmi
+description: Attekmi Bidder Adapter
 biddercode: smarthub
 usp_supported: true
 schain_supported: true
@@ -13,6 +13,10 @@ pbs_app_supported: true
 sidebarType: 1
 ---
 
+### Note
+
+Please note that SmartHub has been renamed to Attekmi.
+
 ### Prebid.js Bid Params
 
 {: .table .table-bordered .table-striped }

From 9035b49a42f904f60bdf29cfede0a8178bc22017 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:05:20 +0200
Subject: [PATCH 030/665] Mobile: Update plugin renderer section (#5752)

* Update plugin renderer section

* Update pbm-plugin-renderer.md

* Spelling fix

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 .../pbm-api/ios/pbm-plugin-renderer.md        | 161 +++++++++++++-----
 1 file changed, 122 insertions(+), 39 deletions(-)

diff --git a/prebid-mobile/pbm-api/ios/pbm-plugin-renderer.md b/prebid-mobile/pbm-api/ios/pbm-plugin-renderer.md
index 845bb00fe7..38e5f7ad65 100755
--- a/prebid-mobile/pbm-api/ios/pbm-plugin-renderer.md
+++ b/prebid-mobile/pbm-api/ios/pbm-plugin-renderer.md
@@ -43,34 +43,117 @@ Please notice that all implementation on mobile related to the Plugin Renderer s
 
 ___
 
-#### Create your implementation from the interface PrebidMobilePluginRenderer
+#### Create your implementation of the `PrebidMobilePluginRenderer`
+
+The `PrebidMobilePluginRenderer` protocol is designed to provide a standardized way for developers to implement custom ad rendering solutions within the Prebid Mobile framework. It provides a unified interface for managing ad rendering, event handling, and metadata integration. 
+
+Below is the sample implementation of the renderer:
 
 ```swift
-public class SampleCustomRenderer: NSObject, PrebidMobilePluginRenderer {
-    
-    public let name = "SampleCustomRenderer"
+public class SampleRenderer: NSObject, PrebidMobilePluginRenderer {
     
+    public let name = "SampleRenderer"
     public let version = "1.0.0"
+    public var data: [String: Any]?
     
-    public var data: [AnyHashable: Any]? = nil
+    /// This method creates an instance of `SampleAdView`, which is a custom view used to display the ad. 
+    public func createBannerView(
+        with frame: CGRect,
+        bid: Bid,
+        adConfiguration: AdUnitConfig,
+        loadingDelegate: DisplayViewLoadingDelegate,
+        interactionDelegate: DisplayViewInteractionDelegate
+    ) -> (UIView & PrebidMobileDisplayViewProtocol)? {
+        let adView = SampleAdView(frame: frame)
+        
+        adView.interactionDelegate = interactionDelegate
+        adView.loadingDelegate = loadingDelegate
+        adView.bid = bid
+        
+        return adView
+    }
     
-    private var adViewManager: PBMAdViewManager?
+    /// This method creates an instance of `SampleInterstitialController`,
+    /// a custom controller used to display interstitial ads.
+    public func createInterstitialController(
+        bid: Bid,
+        adConfiguration: AdUnitConfig,
+        loadingDelegate: InterstitialControllerLoadingDelegate,
+        interactionDelegate: InterstitialControllerInteractionDelegate
+    ) -> PrebidMobileInterstitialControllerProtocol? {
+        let interstitialController = SampleInterstitialController()
+        
+        interstitialController.loadingDelegate = loadingDelegate
+        interstitialController.interactionDelegate = interactionDelegate
+        interstitialController.bid = bid
+        
+        return interstitialController
+    }
+}
+
+class SampleAdView: UIView, PrebidMobileDisplayViewProtocol {
     
-    public func isSupportRendering(for format: AdFormat?) -> Bool {}
-   
-    public func setupBid(_ bid: Bid, adConfiguration: AdUnitConfig, connection: PrebidServerConnectionProtocol) {}
+    weak var interactionDelegate: DisplayViewInteractionDelegate?
+    weak var loadingDelegate: DisplayViewLoadingDelegate?
     
-    public func createBannerAdView(with frame: CGRect, bid: Bid, adConfiguration: AdUnitConfig,
-                                   connection: PrebidServerConnectionProtocol, adViewDelegate: (any PBMAdViewDelegate)?) {
-        // TODO "Handle bid response as you want and display your banner ad"
-    }
+    var bid: Bid?
 
-    public func createInterstitialController(bid: Bid, adConfiguration: AdUnitConfig, connection: PrebidServerConnectionProtocol,
-                                             adViewManagerDelegate adViewDelegate: InterstitialController?, videoControlsConfig: VideoControlsConfiguration?) {
-        // TODO "Handle bid response as you want and display your interstitial ad"
+    // ...
+    // Setup view
+    // ...
+    
+    func loadAd() {
+        DispatchQueue.main.async {
+            if let adm = self.bid?.adm {
+                self.webView.loadHTMLString(adm, baseURL: nil)
+                self.loadingDelegate?.displayViewDidLoadAd(self)
+            } else {
+                self.loadingDelegate?.displayView(self, didFailWithError: SampleError.noAdm)
+            }
+        }
     }
 }
 
+class SampleInterstitialController: NSObject, PrebidMobileInterstitialControllerProtocol {
+    
+    weak var loadingDelegate: InterstitialControllerLoadingDelegate?
+    weak var interactionDelegate: InterstitialControllerInteractionDelegate?
+    
+    var bid: Bid?
+
+    // ...
+    // Setup view
+    // ...
+
+    func loadAd() {
+        DispatchQueue.main.async {
+            guard let adm = self.bid?.adm else {
+                self.loadingDelegate?.interstitialController(self, didFailWithError: SampleError.noAdm)
+                return
+            }
+            
+            self.webView.loadHTMLString(adm, baseURL: nil)
+            self.loadingDelegate?.interstitialControllerDidLoadAd(self)
+        }
+    }
+    
+    func show() {
+        DispatchQueue.main.async {
+            guard let presentingController = UIApplication.shared.topViewController else {
+                self.loadingDelegate?.interstitialController(
+                    self,
+                    didFailWithError: SampleError.noAvailableController
+                )
+                return
+            }
+            
+            presentingController.present(
+                self.interstitialViewController,
+                animated: true
+            )
+        }
+    }
+}
 ```
 
 #### Global Initialization of Plugin Renderer
@@ -86,7 +169,7 @@ import PrebidMobile
 class AppDelegate: UIResponder, UIApplicationDelegate {
 
     var window: UIWindow?
-    let sampleCustomRenderer = SampleCustomRenderer()
+    let sampleCustomRenderer = SampleRenderer()
 
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
         // Initialize the Prebid SDK
@@ -113,13 +196,11 @@ func applicationWillTerminate(_ application: UIApplication) {
 If you need to handle plugin registration in a specific view or controller for more granular control, you can still register the Plugin Renderer at that level:
 
 ```swift
-class CustomRendererBannerController: NSObject, AdaptedController, PrebidConfigurableBannerController, BannerViewDelegate {
+class CustomRendererBannerController: UIViewController {
     
-    required init(rootController: AdapterViewController) {
+    override init() {
         super.init()
-        self.rootController = rootController
         Prebid.registerPluginRenderer(sampleCustomRenderer)
-        setupAdapterController()
     }
     
     deinit {
@@ -131,15 +212,15 @@ class CustomRendererBannerController: NSObject, AdaptedController, PrebidConfigu
 ## Limitations
 
 ### Supported Ad Formats
-Currently the interface `PrebidMobilePluginRenderer` provide the ability to render `BANNER` and `INTERSTITIAL` only. The compability with more ad formats can be supported in future releases.
 
-It is important to notice that the compliant formats you set on `isSupportRenderingFor` implementation are taken into account to add your Plugin Renderer to the bid request or not, according to the ad unit configuration that is bid requesting.
+Currently the interface `PrebidMobilePluginRenderer` provides the ability to render `BANNER` and `INTERSTITIAL` only. The compability with more ad formats can be supported in future releases.
 
 ### Original API
 
-The Plugin Renderer feature does not work with [GAM Original API](/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.html) since the ad rendering does not happen in the Prebid SDK but externally. Despite that if you are using the regular GAM integration it will work fine.
+The Plugin Renderer feature does not work with [GAM Original API](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html) since the ad rendering does not happen in the Prebid SDK but externally. Despite that if you are using the regular GAM integration it will work fine.
 
 ## Ad Event Listeners
+
 An optional dedicated generic ad event listener is offered in case of the existing event listeners are insufficient to keep your ad consumer fully aware of your ad lifecycle.
 
 ![Plugin Event Listener big picture](/assets/images/prebid-mobile/prebid-plugin-renderer-event-listeners.png)
@@ -165,26 +246,19 @@ ___
         // TODO on impressions
     }
 }
-
 ```
 
 #### Handle your plugin event delegate on your Plugin Renderer
 
 ```swift
-public class SampleCustomRenderer: NSObject, PrebidMobilePluginRenderer {
+public class SampleRenderer: NSObject, PrebidMobilePluginRenderer {
     
     // Store your listeners
     private var pluginEventDelegateMap = [String: SampleCustomRendererEventDelegate]()
 
-    public let name = "SampleCustomRenderer"
-    
+    public let name = "SampleRenderer"
     public let version = "1.0.0"
-    
     public var data: [AnyHashable: Any]? = nil
-    
-    private var adViewManager: PBMAdViewManager?
-    
-    public func isSupportRendering(for format: AdFormat?) -> Bool {}
    
     public func registerEventDelegate(pluginEventDelegate: any PluginEventDelegate, adUnitConfigFingerprint: String) {
         pluginEventDelegateMap[adUnitConfigFingerprint] = pluginEventDelegate as? SampleCustomRendererEventDelegate
@@ -193,15 +267,24 @@ public class SampleCustomRenderer: NSObject, PrebidMobilePluginRenderer {
     public func unregisterEventDelegate(pluginEventDelegate: any PluginEventDelegate, adUnitConfigFingerprint: String) {
         pluginEventDelegateMap.removeValue(forKey: adUnitConfigFingerprint)
     }
-
-    public func setupBid(_ bid: Bid, adConfiguration: AdUnitConfig, connection: PrebidServerConnectionProtocol) {}
     
-    public func createBannerAdView(with frame: CGRect, bid: Bid, adConfiguration: AdUnitConfig,
-                                   connection: PrebidServerConnectionProtocol, adViewDelegate: (any PBMAdViewDelegate)?) {
+    public func createAdView(
+        with frame: CGRect,
+        bid: Bid,
+        adConfiguration: AdUnitConfig,
+        loadingDelegate: DisplayViewLoadingDelegate,
+        interactionDelegate: DisplayViewInteractionDelegate
+    ) -> (UIView & PrebidMobileDisplayViewProtocol)? {
+        // .......
     }
 
-    public func createInterstitialController(bid: Bid, adConfiguration: AdUnitConfig, connection: PrebidServerConnectionProtocol,
-                                             adViewManagerDelegate adViewDelegate: InterstitialController?, videoControlsConfig: VideoControlsConfiguration?) {
+    public func createInterstitialController(
+        bid: Bid,
+        adConfiguration: AdUnitConfig,
+        loadingDelegate: InterstitialControllerLoadingDelegate,
+        interactionDelegate: InterstitialControllerInteractionDelegate
+    ) -> PrebidMobileInterstitialControllerProtocol? {
+        // .......
     }
 }
 ```

From 4c7728626e8b91b377a61686a07ab25f80a6f709 Mon Sep 17 00:00:00 2001
From: jansima-r2b2 <jan.sima@r2b2.cz>
Date: Mon, 3 Mar 2025 19:06:15 +0100
Subject: [PATCH 031/665] r2b2 analytic adapter md (#5758)

---
 dev-docs/analytics/r2b2.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/analytics/r2b2.md

diff --git a/dev-docs/analytics/r2b2.md b/dev-docs/analytics/r2b2.md
new file mode 100644
index 0000000000..004e56b35a
--- /dev/null
+++ b/dev-docs/analytics/r2b2.md
@@ -0,0 +1,37 @@
+---
+layout: analytics
+title: R2B2
+description: R2B2 Analytics Adapter
+modulecode: r2b2
+prebid_member: false
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+gvl_id: 1235
+enable_download: true
+---
+
+#### About
+
+The R2B2 Analytics Adapter enables data collection for analysis and reporting purposes. Access to collected data and the ability to start data collection require prior approval from R2B2. For approval, please contact our account team on [partner@r2b2.io](mailto:partner@r2b2.io).
+
+#### Analytics Options
+
+| Name      | Scope    | Example     | Type     | Description                                                    |
+|-----------|----------|-------------|----------|----------------------------------------------------------------|
+| `domain`  | required | example.com | `string` | R2B2 approved domain where data collection occurs              |
+| `configId` | optional | 1           | `int`    | Identifier for different configurations under the same domain (e.g., 1 for mobile, 2 for desktop) |
+| `configVer` | optional | 1           | `int`    | Version number for configurations sharing the same `configId`  |
+
+#### Example Configuration
+
+```js
+pbjs.enableAnalytics({
+    provider: 'r2b2',
+    options: {
+        domain: 'example.com',
+        configId: 1,
+        configVer: 1
+    }
+});
+```

From fc1abf77180ba2b5f3213e8f64d58dec86a34c26 Mon Sep 17 00:00:00 2001
From: CompassSSP <95415988+CompassSSP@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:07:04 +0200
Subject: [PATCH 032/665] Compass: add support gpp (#5766)

* add Compass Adapter

* fix

* add endpointId

* add gpp info
---
 dev-docs/bidders/compass.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/compass.md b/dev-docs/bidders/compass.md
index 49b7428af3..f962d3f7ef 100644
--- a/dev-docs/bidders/compass.md
+++ b/dev-docs/bidders/compass.md
@@ -8,6 +8,7 @@ tcfeu_supported: true
 coppa_supported: true
 schain_supported: true
 floors_supported: true
+gpp_sids: tcfeu, usstate_all, usp
 media_types: banner, video, native
 pbjs: true
 pbs: true

From fef4890038dccfe09c12c0bf283320d388deb740 Mon Sep 17 00:00:00 2001
From: iagoBMS <iagobispo@bluems.com>
Date: Mon, 3 Mar 2025 15:09:32 -0300
Subject: [PATCH 033/665] feat: Add BMS documentation (#5810)

* feat: Add BMS documentation

* update title in BMS documentation

* chore: Update BMS documentation to reflect changes in PBS support and contact email
---
 dev-docs/bidders/bms.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 dev-docs/bidders/bms.md

diff --git a/dev-docs/bidders/bms.md b/dev-docs/bidders/bms.md
new file mode 100644
index 0000000000..d1cf2205b8
--- /dev/null
+++ b/dev-docs/bidders/bms.md
@@ -0,0 +1,30 @@
+---
+layout: bidder
+title: Blue Media Services LTDA
+description: Prebid BMS Bidder Adapter
+tcfeu_supported: true
+pbjs: true
+pbs: false
+biddercode: bms
+prebid_member: false
+floors_supported: true
+safeframes_ok: true
+media_types: banner
+schain_supported: true
+userIds: id5Id, identityLink, pubProvidedId
+pbs_app_supported: false
+gvl_id: 1105
+sidebarType: 1
+---
+
+### Note
+
+The bidder requires setup before usage. Please get in touch with our publisher team at <prebid@bluems.com> to get started.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|---------------|----------|---------------------|---------------|----------|
+| `publisherId` | required | Unique publisher ID | `'ABCDEF'` | `string` |
+| `placementId` | optional | Unique placement ID | `'ABCDEF'` | `string` |

From 3f5053256e3cde77d41a1b80d617a07e02a61a8f Mon Sep 17 00:00:00 2001
From: xiaochang <106997162@qq.com>
Date: Tue, 4 Mar 2025 02:11:03 +0800
Subject: [PATCH 034/665] update algorix.md (#5816)

* update algorix.md

* update algorix.md

* update algorix.md

* update algorix.md

* update algorix.md

* update algorix.md

* update algorix.md

* fix bug
---
 dev-docs/bidders/algorix.md | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/algorix.md b/dev-docs/bidders/algorix.md
index 83265c579e..0edf4aba1a 100644
--- a/dev-docs/bidders/algorix.md
+++ b/dev-docs/bidders/algorix.md
@@ -9,7 +9,7 @@ usp_supported: true
 coppa_supported: true
 schain_supported: true
 media_types: banner, video, native
-pbjs: false
+pbjs: true
 pbs: true
 pbs_app_supported: true
 prebid_member: true
@@ -21,7 +21,7 @@ userIds: all
 
 AlgoriX adapter requires setup and approval from the AlgoriX team, even for existing in-app developers and publishers. Please reach out to your account team or email to <prebid@algorix.co> for more information.
 
-### Bid Params
+### Prebid Server Adapter Params
 
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description   | Example                              | Type     |
@@ -37,3 +37,35 @@ Note:
 * Prebid Server adapter only checks for and uses first imp bid params. All other imp bid params are ignored.
 * placementId and appId will be generated on AlgoriX Platform.
 * region is optional param, which determine the AlgoriX server. APAC for SG endpoint, USE for US endpoint, EUC for EU endpoint, Other for Global endpoint.
+
+### Prebid.js Adapter Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description   | Example                              | Type     |
+| ------------- | -------- | ------------- | ------------------------------------ | -------- |
+| `sid`         | required | Sid           | `'260785'`                           | `string` |
+| `token`       | required | Token         | `'89b6d58567e3913e507f2be61fe8823e'` | `string` |
+| `region`      | optional | Server Region | `'APAC', 'USE', 'EUC'`               | `string` |
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+{
+    sizes: [
+        [300, 250] // a display size
+    ],     
+    bids: [{
+      bidder: 'algorix',
+      params: {
+        region: 'APAC', // optional
+        sid: '260785', // required
+        token: '89b6d58567e3913e507f2be61fe8823e', // required
+      }
+    }]
+}];
+```
+
+Note:
+
+* AlgoriX server-side Prebid Server adapter supports only `banner`, `video`,`native` media types. But AlgoriX client-side Prebid.js adapter supports only `banner`, doesn't support `video` and `native`.

From 409755ed3e17c0bfe2d0d1126aaa60825b33dde7 Mon Sep 17 00:00:00 2001
From: denis-s-oms <deniss@onlinemediasolutions.com>
Date: Mon, 3 Mar 2025 20:13:47 +0200
Subject: [PATCH 035/665] OMS: added video support (#5830)

---
 dev-docs/bidders/oms.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/oms.md b/dev-docs/bidders/oms.md
index 2dbb100676..4675724ab5 100644
--- a/dev-docs/bidders/oms.md
+++ b/dev-docs/bidders/oms.md
@@ -40,4 +40,5 @@ The bidder requires setup before usage. Please get in touch with our team at <pr
 
 | Name | Scope | Description | Example | Type |
 |---------------|----------|---------------------|---------------|----------|
-| `pid` | required | Unique publisher ID | `'12345'` | `string` |
+| `pid` | optional | Deprecated: Unique publisher ID | `'12345'` | `string` |
+| `publisherId` | required | Unique publisher ID | `12345` | `integer` |

From 60ffd58a0f359182605e19439e6822a0a83978ea Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 3 Mar 2025 10:14:30 -0800
Subject: [PATCH 036/665] JS: update docs on `eventtrackers` and
 `markWinningBidAsUsed` (#5840)

* JS: update docs for markWinningBidAsUsed

* Document eventtrackers

* Document bidResponse.eventtrackers
---
 dev-docs/bidder-adaptor.md                    | 36 ++++++++++---------
 .../markWinningBidAsUsed.md                   |  2 +-
 2 files changed, 21 insertions(+), 17 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index ce7eccb1ed..f3c6e5ebcd 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -502,22 +502,26 @@ The parameters of the `bidResponse` object are:
 | `vastXml`    | Either this or `vastUrl` required for video | XML for VAST document to be cached for later retrieval.                                                                                       | `<VAST version="3.0">...`            |
 | `bidderCode` | Optional                                    | Bidder code to use for the response - for adapters that wish to reply on behalf of other bidders. Defaults to the code registered with [`registerBidder`](#bidder-adaptor-Overview); note that any other code will need to be [explicitly allowed by the publisher](/dev-docs/publisher-api-reference/bidderSettings.html#allowAlternateBidderCodes). | 'exampleBidder' |  
 | `dealId`     | Optional                                    | Deal ID                                                                                                                                       | `"123abc"`                           |
-| `meta`     | Optional                                    | Object containing metadata about the bid                                                                                                                                       |                           |
-| `meta.networkId`     | Optional                                    | Bidder-specific Network/DSP Id               | `"1111"`             |
-| `meta.networkName`     | Optional                                    | Network/DSP Name               | `"NetworkN"`                |
-| `meta.agencyId`     | Optional                                    | Bidder-specific Agency ID               | `"2222"`                          |
-| `meta.agencyName`     | Optional                                    | Agency Name     | `"Agency, Inc."`           |
-| `meta.advertiserId`     | Optional                                    | Bidder-specific Advertiser ID     | `"3333"`                         |
-| `meta.advertiserName`     | Optional                                    | Advertiser Name               | `"AdvertiserA"`                          |
-| `meta.advertiserDomains`     | Required(*)                                    | Array of Advertiser Domains for the landing page(s). This is an array that aligns with the OpenRTB 'adomain' field. See note below this table. | `["advertisera.com"]`     |
-| `meta.brandId`     | Optional                                    | Bidder-specific Brand ID (some advertisers may have many brands)                                                                                                   | `"4444"`                    |
-| `meta.brandName`     | Optional                                    | Brand Name                                   | `"BrandB"`                          |
-| `meta.demandSource`     | Optional                                    | Demand Source (Some adapters may functionally serve multiple SSPs or exchanges, and this would specify which)                                  | `"SourceB"`
-| `meta.dchain`     | Optional                                    | Demand Chain Object                                   | `{ 'ver': '1.0', 'complete': 0, 'nodes': [ { 'asi': 'magnite.com', 'bsid': '123456789', } ] }`                          |
-| `meta.dsa` | Optional | The [IAB DSA response object](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/dsa_transparency.md) for the Digital Services Act (DSA) | `{ 'behalf': 'sample text', 'paid': 'sample value', 'transparency': [{ 'domain': 'sample domain', 'params': [1, 2] }], 'adrender': 1 }` | 
-| `meta.primaryCatId`     | Optional                                    | Primary [IAB category ID](https://www.iab.com/guidelines/iab-quality-assurance-guidelines-qag-taxonomy/)               |  `"IAB-111"`                         |
-| `meta.secondaryCatIds`     | Optional                                    | Array of secondary IAB category IDs      | `["IAB-222","IAB-333"]`       |
-| `meta.mediaType`     | Optional                                  | "banner", "native", or "video" - this should be set in scenarios where a bidder responds to a "banner" mediaType with a creative that's actually a video (e.g. outstream) or native. | `"native"`  |
+| `meta`                   | Optional     | Object containing metadata about the bid                                                                                                                         |                                      |
+| `meta.networkId`         | Optional     | Bidder-specific Network/DSP Id               | `"1111"`             |
+| `meta.networkName`       | Optional     | Network/DSP Name               | `"NetworkN"`                |
+| `meta.agencyId`          | Optional     | Bidder-specific Agency ID               | `"2222"`                          |
+| `meta.agencyName`        | Optional     | Agency Name     | `"Agency, Inc."`           |
+| `meta.advertiserId`      | Optional     | Bidder-specific Advertiser ID     | `"3333"`                         |
+| `meta.advertiserName`    | Optional     | Advertiser Name               | `"AdvertiserA"`                          |
+| `meta.advertiserDomains` | Required(*)  | Array of Advertiser Domains for the landing page(s). This is an array that aligns with the OpenRTB 'adomain' field. See note below this table. | `["advertisera.com"]`     |
+| `meta.brandId`           | Optional     | Bidder-specific Brand ID (some advertisers may have many brands)                                                                                                   | `"4444"`                    |
+| `meta.brandName`         | Optional     | Brand Name                                   | `"BrandB"`                          |
+| `meta.demandSource`      | Optional     | Demand Source (Some adapters may functionally serve multiple SSPs or exchanges, and this would specify which)                                  | `"SourceB"`
+| `meta.dchain`            | Optional     | Demand Chain Object                                   | `{ 'ver': '1.0', 'complete': 0, 'nodes': [ { 'asi': 'magnite.com', 'bsid': '123456789', } ] }`                          |
+| `meta.dsa`               | Optional     | The [IAB DSA response object](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/dsa_transparency.md) for the Digital Services Act (DSA) | `{ 'behalf': 'sample text', 'paid': 'sample value', 'transparency': [{ 'domain': 'sample domain', 'params': [1, 2] }], 'adrender': 1 }` | 
+| `meta.primaryCatId`      | Optional     | Primary [IAB category ID](https://www.iab.com/guidelines/iab-quality-assurance-guidelines-qag-taxonomy/)               |  `"IAB-111"`                         |
+| `meta.secondaryCatIds`   | Optional     | Array of secondary IAB category IDs      | `["IAB-222","IAB-333"]`       |
+| `meta.mediaType`         | Optional     | "banner", "native", or "video" - this should be set in scenarios where a bidder responds to a "banner" mediaType with a creative that's actually a video (e.g. outstream) or native. | `"native"`  |
+| `eventtrackers`          | Optional     | Array of objects in the same format as [ORTB native section 5.8, "Event Tracker Response Object"](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) |  `[{event: 500, method: 1, url: "https://www.example.com/track"]}]` |
+| `eventtrackers[].event`   | Required     | Event type. Prebid.js will fire tracking pixels for `500` (bid won) and `1` (bid was rendered). |    `500`      |
+| `eventtrackers[].method` | Required     | Tracking method. Prebid.js only fires image pixels (`1`)                                        |    `1`        |
+| `eventtrackers[].url`    | Required     | Tracker URL                                                                                      | `https//www.example.com/track` |
 
 {: .alert.alert-info :}
 **Note:** bid adapters must be coded to accept the 'advertiserDomains' parameter from their endpoint even if that endpoint doesn't currently respond with that value.
diff --git a/dev-docs/publisher-api-reference/markWinningBidAsUsed.md b/dev-docs/publisher-api-reference/markWinningBidAsUsed.md
index bf6338a1af..5a17d7f69d 100644
--- a/dev-docs/publisher-api-reference/markWinningBidAsUsed.md
+++ b/dev-docs/publisher-api-reference/markWinningBidAsUsed.md
@@ -19,4 +19,4 @@ If you know the adId, then be specific, otherwise Prebid will retrieve the winni
 | --- | --- | --- |
 | adUnitCode | `string` | (Optional) The ad unit code |
 | adId | `string` | (Optional) The id representing the ad we want to mark |
-| analytics | `boolean` | (Optional) if true, triggers the 'bidWon' event for the marked bid |
+| events | `boolean` | (Optional) if true, triggers the 'bidWon' event and tracking pixels for the marked bid |

From dcedd1f1f396c3e3d231ee0c31cd7b91a5722446 Mon Sep 17 00:00:00 2001
From: vdo-ai-tech <126867429+vdo-ai-tech@users.noreply.github.com>
Date: Mon, 3 Mar 2025 23:45:24 +0530
Subject: [PATCH 037/665] updated vdo.ai bidder adapter documentation according
 to the new server (#5842)

Co-authored-by: rishabhsehrawat1 <rishabh.s@z1tech.com>
---
 dev-docs/bidders/vdoai.md | 35 +++++++++++++++++++++++++----------
 1 file changed, 25 insertions(+), 10 deletions(-)

diff --git a/dev-docs/bidders/vdoai.md b/dev-docs/bidders/vdoai.md
index 1afc85545a..7a43e2c39e 100644
--- a/dev-docs/bidders/vdoai.md
+++ b/dev-docs/bidders/vdoai.md
@@ -2,22 +2,37 @@
 layout: bidder
 title: VDO.AI
 description: Prebid vdo.ai Bidder Adaptor
-pbjs: true
 biddercode: vdoai
-media_types: banner, video
-userIds: check with bidder
-floors_supported: true
-coppa_supported: true
-schain_supported: true
+pbjs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
 tcfeu_supported: false
 usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
 sidebarType: 1
 ---
 
-
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description      | Example | Type     |
-|---------------|----------|------------------|---------|----------|
-| `placementId` | required | The placement ID |         | `string` |
+
+| Name          | Scope    | Description                                                 | Example               | Type      |
+|:--------------|:---------|:------------------------------------------------------------|:----------------------|:----------|
+| `host`        | required | Ad network's RTB host                                       | `'exchange.ortb.net'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on VDO.AI Platform.            | `42`                  | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                     | `'banner'`            | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                    | `'custom1'`           | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                    | `'custom2'`           | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                    | `'custom3'`           | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                    | `'custom4'`           | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                    | `'custom5'`           | `string`  |
+
+VDO.AI client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+VDO.AI client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From eb2a4106ddbfbf6c6dd08c9b27d78d0adc9a5edf Mon Sep 17 00:00:00 2001
From: andreasgreen <andreas.green@gmail.com>
Date: Mon, 3 Mar 2025 19:18:34 +0100
Subject: [PATCH 038/665] Bidtheatre Bidder Adapter: pbs support (#5858)

---
 dev-docs/bidders/bidtheatre.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/bidtheatre.md b/dev-docs/bidders/bidtheatre.md
index 65266bc0f6..17e70f2eb5 100644
--- a/dev-docs/bidders/bidtheatre.md
+++ b/dev-docs/bidders/bidtheatre.md
@@ -11,12 +11,12 @@ deals_supported: true
 floors_supported: true
 fpd_supported: true
 ortb_blocking_supported: partial
-multiformat_supported: will-bid-on-any
+multiformat_supported: will-bid-on-one
 privacy_sandbox: topics
 pbjs: true
 sidebarType: 1
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 ---
 
 ### Registration

From df97534313ad4b85d7ef5fec3c1bf5c9e7e61480 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:23:48 +0200
Subject: [PATCH 039/665] Mobile: Support custom logger in iOS SDK (#5849)

* docs: add section about SDK console logging

* docs: remove empty line

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
Co-authored-by: bretg <bgorsline@gmail.com>
---
 .../pbm-api/ios/pbm-targeting-ios.md          | 71 +++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index ca2be9b1a1..d5c12d4f9b 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -133,6 +133,77 @@ Parameters: none
 
 ---
 
+## SDK Console Logging
+
+The `Log` class is designed to handle logging functionality for the SDK. It allows for categorized logging based on severity levels (e.g., error, warning, debug) and offers options for both console and file-based logging. It also provides the ability to set third-party logger.
+
+### `Log` Class Properties
+
+| Property     | Type      | Description                                                                                               |
+|--------------|-----------|-----------------------------------------------------------------------------------------------------------|
+| `logLevel`   | `LogLevel`| The current logging level. Only messages at this level or higher will be logged. Default: `.debug`         |
+| `logToFile`  | `Bool`    | Indicates whether logs should also be saved to a file. Default: `false`                                   |
+
+### `Log` Class Methods
+
+#### `setCustomLogger(_:)`
+Sets a custom logger to handle log messages.
+
+- **Parameters**: 
+  - `logger`: A custom object conforming to the `PrebidLogger` protocol.
+
+#### `serialWriteToLog(_:)`
+Writes a log message asynchronously to the log file.
+
+- **Parameters**: 
+  - `message`: The log message to be written to the file.
+
+#### `getLogFileAsString()`
+Reads the contents of the log file as a single string.
+
+- **Returns**: The contents of the log file, or `nil` if an error occurs.
+
+#### `clearLogFile()`
+Clears the contents of the log file.
+
+### `PrebidLogger` Protocol
+
+The `PrebidLogger` protocol defines the required methods for logging messages at various levels, such as error, info, debug, etc. This protocol allows for custom logging implementations.
+
+#### Methods
+
+- **`error(_:)`**
+  Logs an error message.
+  - **Parameters**: 
+    - `object`: The object or message to log.
+    - `filename`: The name of the file where the log was generated.
+    - `line`: The line number where the log was generated.
+    - `function`: The function name where the log was generated.
+
+- **`info(_:)`**
+  Logs an informational message.
+  - **Parameters**: Same as `error(_:)`.
+
+- **`debug(_:)`**
+  Logs a debug message.
+  - **Parameters**: Same as `error(_:)`.
+
+- **`verbose(_:)`**
+  Logs a verbose message for detailed or low-level information.
+  - **Parameters**: Same as `error(_:)`.
+
+- **`warn(_:)`**
+  Logs a warning message.
+  - **Parameters**: Same as `error(_:)`.
+
+- **`severe(_:)`**
+  Logs a severe error message, indicating a critical issue.
+  - **Parameters**: Same as `error(_:)`.
+
+- **`whereAmI(_:)`**
+  Logs the current location in the code, useful for debugging.
+  - **Parameters**: Same as `error(_:)`.
+
 ## Consent Management Parameters
 
 This section describes how app developers can provide info on user consent to the Prebid SDK and how SDK behaves under different kinds of restrictions.

From 2208a97ef9cad4978e6019cb6bb5649c88108d11 Mon Sep 17 00:00:00 2001
From: Jan Skowronski <jan@permutive.com>
Date: Mon, 3 Mar 2025 18:26:32 +0000
Subject: [PATCH 040/665] add permutiveIdentityManagerIdSystem docs (#5864)

---
 .../permutiveIdentityManagerIdSystem.md       | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/permutiveIdentityManagerIdSystem.md

diff --git a/dev-docs/modules/userid-submodules/permutiveIdentityManagerIdSystem.md b/dev-docs/modules/userid-submodules/permutiveIdentityManagerIdSystem.md
new file mode 100644
index 0000000000..bf5e44a87d
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/permutiveIdentityManagerIdSystem.md
@@ -0,0 +1,65 @@
+---
+layout: userid
+title: Permutive Identity Manager
+description: Permutive Identity Manager User ID sub-module
+useridmodule: permutiveIdentityManagerIdSystem
+---
+
+# Permutive Identity Manager
+
+This module supports [Permutive](https://permutive.com/) customers in using Permutive's Identity Manager functionality.
+
+To use this Prebid.js module it is assumed that the site includes Permutive's SDK, with Identity Manager configuration
+enabled. See Permutive's user documentation for more information on Identity Manager.
+
+## Building Prebid.js with Permutive Identity Manager Support
+
+Prebid.js must be built with the `permutiveIdentityManagerIdSystem` module in order for Permutive's Identity Manager to be able to
+activate relevant user identities to Prebid.
+
+To build Prebid.js with the `permutiveIdentityManagerIdSystem` module included:
+
+```sh
+gulp build --modules=userId,permutiveIdentityManagerIdSystem
+```
+
+## Prebid configuration
+
+There is minimal configuration required to be set on Prebid.js, since the bulk of the behaviour is managed through
+Permutive's dashboard and SDK.
+
+It is recommended to keep the Prebid.js caching for this module short, since the mechanism by which Permutive's SDK
+communicates with Prebid.js is effectively a local cache anyway.
+
+```js
+pbjs.setConfig({
+  ...
+  userSync: {
+    userIds: [
+      {
+        name: 'permutiveIdentityManagerId',
+        params: {
+          ajaxTimeout: 90
+        },
+        storage: {
+          type: 'html5',
+          name: 'permutiveIdentityManagerId',
+          refreshInSeconds: 5
+        }
+      }
+    ],
+    auctionDelay: 100
+  },
+  ...
+});
+```
+
+### ajaxTimeout
+
+By default this module will read IDs provided by the Permutive SDK from local storage when requested by prebid, and if
+nothing is found, will not provide any identities. If a timeout is provided via the `ajaxTimeout` parameter, it will
+instead wait for up to the specified number of milliseconds for Permutive's SDK to become available, and will retrieve
+identities from the SDK directly if/when this happens.
+
+This value should be set to a value smaller than the `auctionDelay` set on the `userSync` configuration object, since
+there is no point waiting longer than this as the auction will already have been triggered.

From 12bc650b4626b25b9e3f5a22bb2829511ca2b8cf Mon Sep 17 00:00:00 2001
From: sangarbe <sangarbe@gmail.com>
Date: Mon, 3 Mar 2025 19:27:21 +0100
Subject: [PATCH 041/665] adds pbs doc for seedtag pbs adapter (#5866)

---
 dev-docs/bidders/seedtag.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/seedtag.md b/dev-docs/bidders/seedtag.md
index 05305438db..33b8b0d37b 100644
--- a/dev-docs/bidders/seedtag.md
+++ b/dev-docs/bidders/seedtag.md
@@ -14,6 +14,9 @@ coppa_supported: true
 ortb_blocking_supported: partial
 sidebarType: 1
 gpp_supported: true
+pbs: true
+pbs_app_supported: false
+floors_supported: true
 ---
 
 ### Note
@@ -21,7 +24,7 @@ gpp_supported: true
 Please reach out to your seedtag account team before using this plugin.  
 The publisher id 0000-0000-01 returns demo responses.
 
-### Bid Params
+### Bid Params (pbjs)
 
 {: .table .table-bordered .table-striped }
 
@@ -31,6 +34,14 @@ The publisher id 0000-0000-01 returns demo responses.
 | `adUnitId`        | required            | The adunit id.                                                                 | 00000                 | `string` |
 | `placement`       | required            | Adunit placement, posibles values: inScreen, inArticle                         | inScreen              | `string` |
 
+### Bid Params (pbs)
+
+{: .table .table-bordered .table-striped }
+
+| Name              | Scope               | Description                                                                    | Example               | Type     |
+|-------------------|---------------------|--------------------------------------------------------------------------------|-----------------------|----------|
+| `adUnitId`        | required            | The adunit id.                                                                 | 00000                 | `string` |
+
 ### InScreen example
 
 The integration for Seedtag uses banner mediaTypes for all types of creatives (display/video)

From c19270034f3694edf4c94274c84d3241e0ae06bf Mon Sep 17 00:00:00 2001
From: BaronJHYu <254878848@qq.com>
Date: Tue, 4 Mar 2025 02:51:30 +0800
Subject: [PATCH 042/665] Upate mediago.md (#5869)

---
 dev-docs/bidders/mediago.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/mediago.md b/dev-docs/bidders/mediago.md
index 8bb28539e0..75f2d26c8e 100644
--- a/dev-docs/bidders/mediago.md
+++ b/dev-docs/bidders/mediago.md
@@ -33,4 +33,5 @@ The MediaGo Bidding adapter requires setup before beginning. Please contact us a
 | `region`      | recommend | Server region for PBS request: US for US Region, EU for EU Region, APAC for APAC Region, default is US. This parameter expects all imps to be the same. This parameter is available for PBS only.        | `'US'`    | `string` |
 | `test` | recommend | 0(default): production env mode. <br> 1: dev env mode and no charge.we will bid Higher frequency to make debug easier. This parameter is available for PBJS only.  | `1/0` | `Number` |
 | `bidfloor` | recommend | Sets a floor price for the bid. This parameter is available for PBJS only. | `0.05` | `float` |
+| `publisher`      | required | publisher id         | `'abcdefg'`    | `string` |
 | `placementId` | recommend | The AD placement ID | `12341234` | `string` |

From ef721ddd0c580568f0ffd0533ed916d66353e1d2 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:57:01 +0200
Subject: [PATCH 043/665] Attekmi: add Jambojar adapter (#5874)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/jamojar.md | 39 +++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/jamojar.md

diff --git a/dev-docs/bidders/jamojar.md b/dev-docs/bidders/jamojar.md
new file mode 100644
index 0000000000..572102a01c
--- /dev/null
+++ b/dev-docs/bidders/jamojar.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Jambojar
+description: Jambojar Bidder Adapter
+biddercode: jambojar
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 1a2747bcd282efe4ef4a72c0833c64b5cb870e1c Mon Sep 17 00:00:00 2001
From: Kevin Siow <k.siow@passerelle.co>
Date: Mon, 3 Mar 2025 20:03:05 +0100
Subject: [PATCH 044/665] Dailymotion bid adapter: add ortb converter and floor
 price support (#5891)

Co-authored-by: Kevin Siow <kevin.siow@dailymotion.com>
---
 dev-docs/bidders/dailymotion.md | 118 ++++++++++++++++++++++++++++++--
 1 file changed, 112 insertions(+), 6 deletions(-)

diff --git a/dev-docs/bidders/dailymotion.md b/dev-docs/bidders/dailymotion.md
index ec7f0ed607..ff6a709018 100644
--- a/dev-docs/bidders/dailymotion.md
+++ b/dev-docs/bidders/dailymotion.md
@@ -71,6 +71,116 @@ pbjs.setConfig({
 });
 ```
 
+#### Price floor
+
+The price floor can be set at the ad unit level, for example : 
+
+```javascript
+const adUnits = [{
+  floors: {
+    currency: 'USD',
+    schema: {
+      fields: [ 'mediaType', 'size' ]
+    },
+    values: {
+      'video|300x250': 2.22,
+      'video|*': 1
+    }
+  },
+  bids: [{
+    bidder: 'dailymotion',
+    params: {
+      apiKey: 'dailymotion-testing',
+    }
+  }],
+  code: 'test-ad-unit',
+  mediaTypes: {
+    video: {
+      playerSize: [300, 250],
+      context: 'instream',
+    },
+  }
+}];
+
+// Do not forget to set an empty object for "floors" to active the price floor module
+pbjs.setConfig({floors: {}});
+```
+
+The following request will be sent to Dailymotion Prebid Service : 
+
+```javascript
+{
+  "pbv": "9.23.0-pre",
+  "ortb": {
+    "imp": [
+      {
+        ...
+        "bidfloor": 2.22,
+        "bidfloorcur": "USD"
+      }
+    ],
+  }
+  ...
+}
+```
+
+Or the price floor can be set at the package level, for example : 
+
+```javascript
+const adUnits = [
+  {
+    bids: [{
+      bidder: 'dailymotion',
+      params: {
+        apiKey: 'dailymotion-testing',
+      }
+    }],
+    code: 'test-ad-unit',
+    mediaTypes: {
+      video: {
+        playerSize: [1280,720],
+        context: 'instream',
+      },
+    }
+  }
+];
+
+pbjs.setConfig({
+  floors: {
+      data: { 
+          currency: 'USD',
+          schema: {
+              fields: [ 'mediaType', 'size' ]
+          },
+          values: {
+              'video|300x250': 2.22,
+              'video|*': 1
+          }
+      }
+  }
+})
+```
+
+This will send the following bid floor in the request to Daiymotion Prebid Service : 
+
+```javascript
+{
+  "pbv": "9.23.0-pre",
+  "ortb": {
+    "imp": [
+      {
+        ...
+        "bidfloor": 1,
+        "bidfloorcur": "USD"
+      }
+    ],
+    ...
+  }
+}
+```
+
+You can also [set dynamic floors](https://docs.prebid.org/dev-docs/modules/floors.html#bid-adapter-interface).
+
 ### Test Parameters
 
 By setting the following bid parameters, you'll get a constant response to any request, to validate your adapter integration:
@@ -175,7 +285,7 @@ const adUnits = [
         maxduration: 30,
         playbackmethod: [3],
         plcmt: 1,
-        protocols: [7, 8, 11, 12, 13, 14]
+        protocols: [7, 8, 11, 12, 13, 14],
         startdelay: 0,
         w: 1280,
         h: 720,
@@ -220,8 +330,4 @@ If you already specify [First-Party data](https://docs.prebid.org/features/first
 | `ortb2.site.content.keywords`                                                   | `tags`          |
 | `ortb2.site.content.title`                                                      | `title`         |
 | `ortb2.site.content.url`                                                        | `url`           |
-| `ortb2.app.bundle`                                                              | N/A             |
-| `ortb2.app.storeurl`                                                            | N/A             |
-| `ortb2.device.lmt`                                                              | N/A             |
-| `ortb2.device.ifa`                                                              | N/A             |
-| `ortb2.device.ext.atts`                                                         | N/A             |
+| `ortb2.*`                                                                       | N/A             |

From cdb5dff560a730168b463cd834bda43cb170475c Mon Sep 17 00:00:00 2001
From: CKBrennan <69460288+CKBrennan@users.noreply.github.com>
Date: Mon, 3 Mar 2025 20:16:01 +0100
Subject: [PATCH 045/665] Create overtoneRtdProvider.md (#5827)

* Create overtoneRtdProvider.md

* Update overtoneRtdProvider.md

Changed structure

* Update overtoneRtdProvider.md

* Update overtoneRtdProvider.md

* Update dev-docs/modules/overtoneRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/modules/overtoneRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update overtoneRtdProvider.md

Updating to fix linting errors

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/overtoneRtdProvider.md | 81 +++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 dev-docs/modules/overtoneRtdProvider.md

diff --git a/dev-docs/modules/overtoneRtdProvider.md b/dev-docs/modules/overtoneRtdProvider.md
new file mode 100644
index 0000000000..a13f5cd232
--- /dev/null
+++ b/dev-docs/modules/overtoneRtdProvider.md
@@ -0,0 +1,81 @@
+# Overtone Real-time Data Submodule
+
+## Overview
+
+    Module Name: Overtone Rtd Provider
+    Module Type: Rtd Provider
+    Maintainer: tech@overtone.ai
+
+## Description
+
+The Overtone RTD module appends Contextual segments to the bidding object based on the Overtone taxonomy and custom metrics added by the publisher. Please contact <tech@overtone.ai> in order to be whitelisted for use of our API and to explore dozens of contextual signals.
+
+## Usage
+To install and enable the Overtone RTD module, follow these steps:
+
+### Step 1: Prepare the base Prebid file
+
+* **Option 1**: Use Prebid [Download](https://docs.prebid.org/download.html) page to build the Prebid package. Ensure that you check the **Overtone Real-Time Data Module** checkbox.
+* **Option 2**: From the command line, run `gulp build --modules=overtoneRtdProvider,...`.
+
+### Step 2: Configure the module
+
+### Configuration
+
+Use `setConfig` to instruct Prebid.js to initilize the Overtone RTD module, as specified below. 
+
+This module is configured as part of the `realTimeData.dataProviders`
+
+javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'overtone',
+      params: {
+        apiKey: 'YOUR_API_KEY',
+        domains: ['example.com'],
+        timeout: 500
+      }
+    }]
+  }
+});
+
+| Name                      | Type          | Description                                                      | Default           |
+| :------------------------ | :------------ | :--------------------------------------------------------------- |:----------------- |
+| name                      | String        | Real time data module name                                       | Always 'overtone'   |
+| params                    | Object        |                                                                  |                   |
+| params.apiKey         | String        | Your unique API key provided by Overtone                                          | YOUR_API_KEY                    |
+| params.domains            | Array<string> | Array of whitelisted domains for contextual analysis           |                   |
+| params.timeout            | Integer       | timeout (ms)                                                     | 500ms            |
+
+## Validation and Testing
+
+Validation of the Overtone RTD module is essential to ensure proper configuration. Use the provided test suite in the Prebid.js repository:
+
+File: `test/spec/modules/overtoneRtdProvider_spec.mjs`
+
+### Test Scenarios
+
+#### Successful Response
+
+**Input**: Valid domain with contextual data.
+
+**Expected Output**: Populated `categories` array with status `1`.
+
+#### Failed Request
+
+**Input**: Invalid domain or missing API key.
+
+**Expected Output**: Empty `categories` array with status `3`.
+
+#### Ignored URL
+
+**Input**: Domain not whitelisted by Overtone.
+
+**Expected Output**: Empty `categories` array with status `4`.
+
+---
+
+## Support and Contact
+
+For questions, issues, or support, contact the Overtone technical team at <tech@overtone.ai>.

From 2986fe4829e815ede05e568c57a10d54d785fc83 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 3 Mar 2025 21:20:16 +0200
Subject: [PATCH 046/665] Artechnology: add PBS support (#5913)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/artechnology.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/artechnology.md b/dev-docs/bidders/artechnology.md
index 7cfe1258b9..ecb0b3f28a 100644
--- a/dev-docs/bidders/artechnology.md
+++ b/dev-docs/bidders/artechnology.md
@@ -14,7 +14,7 @@ deals_supported: true
 floors_supported: true
 fpd_supported: false
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: true
 multiformat_supported: true
 ---

From 217ab35f3aa4137c727d8f9fbad0a6e347887516 Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Mon, 3 Mar 2025 13:17:52 -0800
Subject: [PATCH 047/665] Docs for the new PubMatic user id submodule (#5919)

---
 .../modules/userid-submodules/pubmatic.md     | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/pubmatic.md

diff --git a/dev-docs/modules/userid-submodules/pubmatic.md b/dev-docs/modules/userid-submodules/pubmatic.md
new file mode 100644
index 0000000000..0231a6ddad
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/pubmatic.md
@@ -0,0 +1,54 @@
+---
+layout: userid
+title: PubMatic ID
+description: PubMatic ID User ID sub-module
+useridmodule: pubmaticIdSystem
+bidRequestUserId: pubmaticId
+eidsource: esp.pubmatic.com
+example: '"1111"'
+---
+
+
+## PubMatic ID Configuration
+
+Please make sure to add the PubMatic user ID sub-module to your Prebid.js package with:
+
+```shell
+gulp build --modules=pubmaticIdSystem,userId
+```
+
+The following configuration parameters are available:
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | The name of this sub-module | `"pubmaticId"` |
+| params ||| Details for the sub-module initialization ||
+| params.publisherId | Required | Number | Publisher ID | `123456` |
+| storage |||||
+| storage.name | Required | String | The name of the cookie or html5 local storage key | `"pubmaticId"` |
+| storage.type | Required | String | This is where the PubMatic user ID will be stored | `"cookie&html5"` (recommended) or `"html5"` or `"cookie"` |
+| storage.expires | Required (Must be `30`) | Number | How long (in days) the user ID information will be stored | `30` |
+| storage.refreshInSeconds | Required (Must be `86400`) | Number | How many seconds until the ID is refreshed | `86400` |
+
+## PubMatic ID Example
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: "pubmaticId",
+      params: {
+        publisherId: "123456" // Example ID
+      },
+      storage: {
+        name: "pubmaticId",
+        type: "cookie&html5",
+        expires: 30,
+        refreshInSeconds: 86400
+      }
+    }]
+  }
+});
+```

From c3ab883f37dd3ddef291cf760891ca2b4531a307 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 4 Mar 2025 02:14:57 -0500
Subject: [PATCH 048/665] docpath change alert workflow (#5911)

* docpath change alert workflow

* added openx
---
 .github/workflows/code-path-changes.yml       |  37 +++++
 .../workflows/scripts/codepath-notification   |  16 ++
 .../scripts/send-notification-on-change.js    | 139 ++++++++++++++++++
 3 files changed, 192 insertions(+)
 create mode 100644 .github/workflows/code-path-changes.yml
 create mode 100644 .github/workflows/scripts/codepath-notification
 create mode 100644 .github/workflows/scripts/send-notification-on-change.js

diff --git a/.github/workflows/code-path-changes.yml b/.github/workflows/code-path-changes.yml
new file mode 100644
index 0000000000..23e0c19db6
--- /dev/null
+++ b/.github/workflows/code-path-changes.yml
@@ -0,0 +1,37 @@
+name: Notify Code Path Changes
+
+on:
+  pull_request_target:
+    types: [opened, synchronize]
+    paths:
+      - '**'
+
+env:
+  OAUTH2_CLIENT_ID: ${{ secrets.OAUTH2_CLIENT_ID }}
+  OAUTH2_CLIENT_SECRET: ${{ secrets.OAUTH2_CLIENT_SECRET }}
+  OAUTH2_REFRESH_TOKEN: ${{ secrets.OAUTH2_REFRESH_TOKEN }}
+  GITHUB_REPOSITORY: ${{ github.repository }}
+  GITHUB_PR_NUMBER: ${{ github.event.pull_request.number }}
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+permissions:
+  contents: read
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm install axios nodemailer
+
+      - name: Run Notification Script
+        run: |
+          node .github/workflows/scripts/send-notification-on-change.js
diff --git a/.github/workflows/scripts/codepath-notification b/.github/workflows/scripts/codepath-notification
new file mode 100644
index 0000000000..3b40b766c9
--- /dev/null
+++ b/.github/workflows/scripts/codepath-notification
@@ -0,0 +1,16 @@
+# when a changed file paths matches the regex, send an alert email
+# structure of the file is:
+#
+# javascriptRegex : email address
+#
+# For example, in the Prebid docs repo, the file pattern is generally
+#
+# /dev-docs/bidders/BIDDERCODE.md
+#
+# The aim is to find a minimal set of regex patterns that matches any file in these paths
+
+/dev-docs/bidders/rubicon : header-bidding@magnite.com
+/dev-docs/bidders/ix : pdu-supply-prebid@indexexchange.com
+/dev-docs/bidders/appnexus|/dev-docs/bidders/msft : prebid@microsoft.com
+/dev-docs/bidders/pubmatic : header-bidding@pubmatic.com
+/dev-docs/bidders/openx : prebid@openx.com
diff --git a/.github/workflows/scripts/send-notification-on-change.js b/.github/workflows/scripts/send-notification-on-change.js
new file mode 100644
index 0000000000..af79cefd29
--- /dev/null
+++ b/.github/workflows/scripts/send-notification-on-change.js
@@ -0,0 +1,139 @@
+// send-notification-on-change.js
+//
+// called by the code-path-changes.yml workflow, this script queries github for
+// the changes in the current PR, checks the config file for whether any of those
+// file paths are set to alert an email address, and sends email to multiple
+// parties if needed
+
+const fs = require('fs');
+const path = require('path');
+const axios = require('axios');
+const nodemailer = require('nodemailer');
+
+async function getAccessToken(clientId, clientSecret, refreshToken) {
+  try {
+    const response = await axios.post('https://oauth2.googleapis.com/token', {
+      client_id: clientId,
+      client_secret: clientSecret,
+      refresh_token: refreshToken,
+      grant_type: 'refresh_token',
+    });
+    return response.data.access_token;
+  } catch (error) {
+    console.error('Failed to fetch access token:', error.response?.data || error.message);
+    process.exit(1);
+  }
+}
+
+(async () => {
+  const configFilePath = path.join(__dirname, 'codepath-notification');
+  const repo = process.env.GITHUB_REPOSITORY;
+  const prNumber = process.env.GITHUB_PR_NUMBER;
+  const token = process.env.GITHUB_TOKEN;
+
+  // Generate OAuth2 access token
+  const clientId = process.env.OAUTH2_CLIENT_ID;
+  const clientSecret = process.env.OAUTH2_CLIENT_SECRET;
+  const refreshToken = process.env.OAUTH2_REFRESH_TOKEN;
+
+  // validate params
+  if (!repo || !prNumber || !token || !clientId || !clientSecret || !refreshToken) {
+    console.error('Missing required environment variables.');
+    process.exit(1);
+  }
+
+  // the whole process is in a big try/catch. e.g. if the config file doesn't exist, github is down, etc.
+  try {
+    // Read and process the configuration file
+    const configFileContent = fs.readFileSync(configFilePath, 'utf-8');
+    const configRules = configFileContent
+      .split('\n')
+      .filter(line => line.trim() !== '' && !line.trim().startsWith('#')) // Ignore empty lines and comments
+      .map(line => {
+        const [regex, email] = line.split(':').map(part => part.trim());
+        return { regex: new RegExp(regex), email };
+      });
+
+    // Fetch changed files from github
+    const [owner, repoName] = repo.split('/');
+    const apiUrl = `https://api.github.com/repos/${owner}/${repoName}/pulls/${prNumber}/files`;
+    const response = await axios.get(apiUrl, {
+      headers: {
+        Authorization: `Bearer ${token}`,
+        Accept: 'application/vnd.github.v3+json',
+      },
+    });
+
+    const changedFiles = response.data.map(file => file.filename);
+    console.log('Changed files:', changedFiles);
+
+    // match file pathnames that are in the config and group them by email address
+    const matchesByEmail = {};
+    changedFiles.forEach(file => {
+      configRules.forEach(rule => {
+        if (rule.regex.test(file)) {
+          if (!matchesByEmail[rule.email]) {
+            matchesByEmail[rule.email] = [];
+          }
+          matchesByEmail[rule.email].push(file);
+        }
+      });
+    });
+
+    // Exit successfully if no matches were found
+    if (Object.keys(matchesByEmail).length === 0) {
+      console.log('No matches found. Exiting successfully.');
+      process.exit(0);
+    }
+
+    console.log('Grouped matches by email:', matchesByEmail);
+
+    // get ready to email the changes
+    const accessToken = await getAccessToken(clientId, clientSecret, refreshToken);
+
+    // Configure Nodemailer with OAuth2
+    //  service: 'Gmail',
+    const transporter = nodemailer.createTransport({
+      host: "smtp.gmail.com",
+      port: 465,
+      secure: true,
+      auth: {
+        type: 'OAuth2',
+        user: 'info@prebid.org',
+        clientId: clientId,
+        clientSecret: clientSecret,
+        refreshToken: refreshToken,
+        accessToken: accessToken
+      },
+    });
+
+    // Send one email per recipient
+    for (const [email, files] of Object.entries(matchesByEmail)) {
+      const emailBody = `
+        ${email},
+        <p>
+        Files owned by you have been changed in open source ${repo}. The <a href="https://github.com/${repo}/pull/${prNumber}">pull request is #${prNumber}</a>. These are the files you own that have been modified:
+        <ul>
+          ${files.map(file => `<li>${file}</li>`).join('')}
+        </ul>
+      `;
+
+      try {
+        await transporter.sendMail({
+          from: `"Prebid Info" <info@prebid.org>`,
+          to: email,
+          subject: `Files have been changed in open source ${repo}`,
+          html: emailBody,
+        });
+
+        console.log(`Email sent successfully to ${email}`);
+        console.log(`${emailBody}`);
+      } catch (error) {
+        console.error(`Failed to send email to ${email}:`, error.message);
+      }
+    }
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+})();

From c7230a56ceffac22d6043f36d17c48a50459997e Mon Sep 17 00:00:00 2001
From: Oleksandr Solodovnikov <sanek.solodovnikov.94@gmail.com>
Date: Wed, 5 Mar 2025 14:47:16 +0200
Subject: [PATCH 049/665] Aniview: Add examples and update params list (#5916)

* Aniview: Add examples and update params list

* Aniview: Added new line to the end of the file

* Aniview: Updated features, params list, examples

* Aniview: Clarified gpp_sids, multiformat_supported and userIds; Removed few examples

---------

Co-authored-by: Oleksandr Solodovnikov <o.i.solodovnikov@globallogic.com>
---
 dev-docs/bidders/aniview.md | 106 +++++++++++++++++++++++++++++++-----
 1 file changed, 93 insertions(+), 13 deletions(-)

diff --git a/dev-docs/bidders/aniview.md b/dev-docs/bidders/aniview.md
index dfd04b313c..d9c6308417 100644
--- a/dev-docs/bidders/aniview.md
+++ b/dev-docs/bidders/aniview.md
@@ -5,6 +5,9 @@ description: Prebid Aniview Bidder Adapter
 pbjs: true
 biddercode: aniview
 media_types: banner, video
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-any
 tcfeu_supported: true
 floors_supported: true
 usp_supported: true
@@ -12,6 +15,7 @@ schain_supported: true
 safeframes_ok: true
 gvl_id: 780
 sidebarType: 1
+userIds: all
 ---
 
 ### Note
@@ -21,29 +25,105 @@ For more information about [Aniview Ad Server](https://www.aniview.com/), please
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name             | Scope    | Description      | Example                      | Type     |
-|------------------|----------|------------------|------------------------------|----------|
-| `AV_PUBLISHERID` | required | Publisher/Netid  | `'55b88d4a181f465b3e8b4567'` | `string` |
-| `AV_CHANNELID`   | required | Channel id       | `'5a5f17a728a06102d14c2718'` | `string` |
+| Name             | Scope    | Description           | Example              | Type     |
+|------------------|----------|-----------------------|----------------------|----------|
+| `AV_PUBLISHERID` | required | Publisher/Network ID  | `'Get from Aniview'` | `string` |
+| `AV_CHANNELID`   | required | Channel ID            | `'Get from Aniview'` | `string` |
 
-### Test Parameters
+### Setup for Video
 
 ```javascript
-const videoAdUnit = [
-{
-  code: 'video1',
+const adUnit = [{
+  code: 'videoAdUnit',
   mediaTypes: {
     video: {
+      // Required
       playerSize: [[640, 480]],
-      context: 'outstream'
+      context: 'outstream',
+      mimes: ['video/mp4', 'video/mpeg', 'application/javascript'],
+      
+      // Optional
+      playbackmethod: [1, 2],
+      protocols: [1, 2, 3, 5, 6, 7, 8],
+      api: [1, 2],
+      maxduration: 60,
+      plcmt: 4,
     },
   },
   bids: [{
     bidder: 'aniview',
     params: {
-      AV_PUBLISHERID: '55b78633181f4603178b4568',
-      AV_CHANNELID: '5d19dfca4b6236688c0a2fc4'
-    }
-  }]
+      // Required
+      AV_PUBLISHERID: 'Get from Aniview',
+      AV_CHANNELID: 'Get from Aniview',
+    },
+  }],
+}];
+```
+
+### Setup for Banner
+
+```javascript
+const adUnit = [{
+  code: 'bannerAdUnit',
+  mediaTypes: {
+    banner: {
+      // Required
+      sizes: [[300, 250], [300, 600]],
+    },
+  },
+  bids: [{
+    bidder: 'aniview',
+    params: {
+      // Required
+      AV_PUBLISHERID: 'Get from Aniview',
+      AV_CHANNELID: 'Get from Aniview',
+    },
+  }],
+}];
+```
+
+### Setup for Multi-format (Banner & Video)
+
+```javascript
+const adUnit = [{
+  code: 'multiformatAdUnit',
+  mediaTypes: {
+    banner: {
+      // Required
+      sizes: [[300, 250], [300, 600]],
+    },
+    video: {
+      // Required
+      playerSize: [[640, 480]],
+      context: 'outstream', 
+      mimes: ['video/mp4', 'video/mpeg', 'application/javascript'],
+    },
+  },
+  bids: [{
+    bidder: 'aniview',
+    params: {
+      // Required
+      AV_PUBLISHERID: 'Get from Aniview',
+      AV_CHANNELID: 'Get from Aniview',
+    },
+  }],
 }];
 ```
+
+### Bidder specific configs
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['aniview'],
+  config: {
+    ortb2: {
+      ext: {
+        aniview: {
+          // Additional data to send to the Ad Server
+        },
+      },
+    },
+  },
+}, true);
+```

From 226781fa932d317e1dcb3df343eadef41e9f731c Mon Sep 17 00:00:00 2001
From: dmytro-po <dmytro.po@intentiq.com>
Date: Thu, 6 Mar 2025 09:15:00 +0200
Subject: [PATCH 050/665] AGT-415: Callback optional (#5924)

---
 dev-docs/modules/userid-submodules/intentiq.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 449b356983..4e3044de0e 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -41,7 +41,7 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.partner                 | Required | Number   | This is the partner ID value obtained from registering with IntentIQ.                                                                                                                                                                                                                                                                     | `1177538`                                     |
 | params.pcid                    | Optional | String   | This is the partner cookie ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                                             | `"g3hC52b"`                                   |
 | params.pai                     | Optional | String   | This is the partner customer ID / advertiser ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                           | `"advertiser1"`                               |
-| params.callback                | Required | Function | This is a callback which is trigered with data and AB group                                                                                                                                                                                                                                                                               | `(data, group) => console.log({ data, group })` |
+| params.callback                | Optional | Function | This is a callback which is trigered with data and AB group                                                                                                                                                                                                                                                                               | `(data, group) => console.log({ data, group })` |
 | params.timeoutInMillis         | Optional | Number   | This is the timeout in milliseconds, which defines the maximum duration before the callback is triggered. The default value is 500.                                                                                                                                                                                                       | `450`                                         |
 | params.browserBlackList        | Optional |  String  | This is the name of a browser that can be added to a blacklist.                                                                                                                                                                                                                                                                           | `"chrome"`                                    |
 | params.manualWinReportEnabled  | Optional | Boolean  | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `true`|

From 57a18fe1aadc34bf52c40ad6cdf5c01c6a5b003b Mon Sep 17 00:00:00 2001
From: kiho-shige <133089869+kiho-shige@users.noreply.github.com>
Date: Thu, 6 Mar 2025 23:02:11 +0900
Subject: [PATCH 051/665] YieldOne Bid Adapter: add UID2.0 support and update
 email. (#5925)

---
 dev-docs/bidders/yieldone.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/yieldone.md b/dev-docs/bidders/yieldone.md
index c2cb8ef6b3..e409e60811 100644
--- a/dev-docs/bidders/yieldone.md
+++ b/dev-docs/bidders/yieldone.md
@@ -4,7 +4,7 @@ title: YieldOne
 description: Prebid YieldOne Bidder Adaptor
 biddercode: yieldone
 media_types: banner, video
-userIds: identityLink, imuid, AudienceOne ID, ID5
+userIds: identityLink, imuid, AudienceOne ID, ID5, UID2.0
 pbjs: true
 pbs: true
 multiformat_supported: will-bid-on-any
@@ -14,7 +14,7 @@ sidebarType: 1
 ### Note
 
 THE YieldOne adapter requires setup and approval from the YieldOne team.<br/>
-Please reach out to your account team or <y1s@platform-one.co.jp> for more information.
+Please reach out to your account team or <y1support@platform-one.co.jp> for more information.
 
 ### Bid Params
 

From 9a7d8b112403744891f97a2d9cdec0656f3dfc7b Mon Sep 17 00:00:00 2001
From: Pete <petropo@ex.co>
Date: Thu, 6 Mar 2025 18:08:26 +0200
Subject: [PATCH 052/665] feat(): EXCO Bid Adapter: Support of new publisherId,
 accountId and tagId parameters. (#5926)

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.
---
 dev-docs/bidders/exco.md | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/dev-docs/bidders/exco.md b/dev-docs/bidders/exco.md
index 72d2d3898b..36631c89e0 100644
--- a/dev-docs/bidders/exco.md
+++ b/dev-docs/bidders/exco.md
@@ -28,11 +28,14 @@ sidebarType: 1
 
 {: .table .table-bordered .table-striped }
 
-| Name       | Scope    | Description                                                                               | Example                      | Type     |
-|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
-| `cId`      | required | The connection ID from Exco.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
-| `pId`      | required | The publisher ID from Exco.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
-| `bidFloor` | optional | The minimum bid value desired. Exco will not respond with bids lower than this value. | `0.90`                       | `float`  |
+| Name          | Scope      | Description                                                                           | Example                      | Type     |
+|---------------|------------|---------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`         | deprecated | The connection ID from Exco.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`         | deprecated | The publisher ID from Exco.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor`    | deprecated | The minimum bid value desired. Exco will not respond with bids lower than this value. | `0.90`                       | `float`  |
+| `accountID`   | required   | A unique account identifier provided by EX.CO.                                        | `'1234567890'`               | `string` |
+| `publisherId` | required   | Publisher ID provided by EX.CO.                                                       | `'1234567890'`               | `string` |
+| `tagId`       | required   | A unique Tag ID (supply id) identifier provided by EX.CO.                             | `'1234567890'`               | `string` |
 
 ### Example
 
@@ -50,9 +53,9 @@ var adUnits = [{
         bids: [{
             bidder: 'exco',
             params: {
-                cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
-                pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
-                bidFloor: 1.23                   // Optional
+                accountID: '1234567890',   // Required - PROVIDED DURING SETUP...
+                publisherId: '1234567890', // Required - PROVIDED DURING SETUP...
+                tagId: '1234567890'        // Required - PROVIDED DURING SETUP...
             }
         }]
     }

From d45083cbf32612123f38af0444c34e2e26ba5731 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Thu, 6 Mar 2025 11:31:11 -0500
Subject: [PATCH 053/665] PBS USGen doc update (#5927)

* PBS USGen doc update

Adding allowPersonalDataConsent2 option

* Update pbs-usgen.md
---
 prebid-server/features/pbs-usgen.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/prebid-server/features/pbs-usgen.md b/prebid-server/features/pbs-usgen.md
index 273699d1d6..bfe61d2481 100644
--- a/prebid-server/features/pbs-usgen.md
+++ b/prebid-server/features/pbs-usgen.md
@@ -74,6 +74,7 @@ Here's an example:
 | Parameter | Type | Scope | Description |
 |------|------|-------------|
 | skipSids | array of integer | Optional | Do not process the named section IDs. |
+| allowPersonalDataConsent2 | boolean | Optional | Defaults to 'false'. [Prebid's logic](/features/mspa-usnat.html) for personal data consents considers a value of 2 as non-sensical. But it turns out that several CMPs didn't get that message and are reporting this value. We will deprecate this option once the CMPs are all on the same page. |
 
 By default the module will process GPP SIDs 7-12. The `skipSids`
 parameter allows the publisher to define a different processing flow for different GPP SIDs.

From 37fb07454bc8326f6b7bcf6ed0dd6eb2df1bf704 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Mon, 10 Mar 2025 15:50:10 -0400
Subject: [PATCH 054/665] PBS Activitycontrol typo (#5933)

---
 prebid-server/features/pbs-activitycontrols.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prebid-server/features/pbs-activitycontrols.md b/prebid-server/features/pbs-activitycontrols.md
index dc2012ecdf..cce4e2b572 100644
--- a/prebid-server/features/pbs-activitycontrols.md
+++ b/prebid-server/features/pbs-activitycontrols.md
@@ -186,7 +186,7 @@ Here's the list of the 'potentially restricted activities' that Prebid Server co
 | `fetchBids`  | A bid adapter wants to participate in an auction | Bidder is removed from the auction |
 | `enrichUfpd` | A module wants to add user first party data to outgoing requests (`user.data` and `user.ext.data` in ORTB) | Module is not allowed to run. |
 | `reportAnalytics` | The [/auction](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html), [/amp](/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.html), or [/event](/prebid-server/endpoints/pbs-endpoint-event.html) endpoint is about to call an analytics adapter. | Adapter is not called. |
-| `transmitUfpd` | A bid adapter, analytics adapter, or module wants to access and/or transmit user FPD to their endpoint. (Note: this is combined with transmitEids in PBS-Go and PBJ-Java 2.11 and under) | User FPD and EIDs are hidden from the adapter or module: `user.{id, buyeruid, yob, gender, geo, eids, data}`, `user.ext.data`, `device.{device.ifa, macsha1, macmd5, dpidsha1, dpidmd5, didsha1, didmd5}` |
+| `transmitUfpd` | A bid adapter, analytics adapter, or module wants to access and/or transmit user FPD to their endpoint. (Note: this is combined with transmitEids in PBS-Go and PBJ-Java 2.11 and under) | User FPD and EIDs are hidden from the adapter or module: `user.{id, buyeruid, yob, gender, geo, eids, data}`, `user.ext.data`, `device.{ifa, macsha1, macmd5, dpidsha1, dpidmd5, didsha1, didmd5}` |
 | `transmitEids` | (PBS-Java 2.12 and later) A bid adapter, analytics adapter, or module wants to access and/or transmit extended IDs to their endpoint. | User EIDs are hidden from the adapter or module: `user.eids`, `user.ext.eids` |
 | `transmitPreciseGeo` | A bid adapter, analytics adapter, or module wants to access and/or transmit precise geolocation data to their endpoint | device.geo latitude, longitude, and IP address are rounded off. Specifically, lat and long are truncated to two decimal places, IPv4 masks rightmost 8 bits, IPv6 masks the rightmost bits based on a configured value. In PBS-Java 3.0 and later, device.geo.{country,region,utcoffset} are preserved, but device.geo.{metro,city,zip,accuracy,ipservice,ext} are removed.|
 | `transmitTid` | (PBS-Java only) The source.tid and imp.ext.tid fields can be generated or suppressed by PBS before going to bidders. The ext.prebid.createtid request parameter overrides the allow state of this activity. If `ext.prebid.createtid:false`, transmitTid is "denied". | If "allowed", then source.tid and imp.ext.tid will be generated by PBS. Otherwise, they won't be generated. |

From 73d101de541b17cac801e5a1288d2750b939b2da Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 11 Mar 2025 14:27:19 -0400
Subject: [PATCH 055/665] Update pbs-endpoint-auction.md (#5938)

---
 prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index b933e81d74..fba8218898 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -1891,8 +1891,9 @@ ext.prebid.biddercontrols: {
 
 Here's how this works:
 
-1. If the bid adapter YAML declares support of multiformat, then `prefmtype` is ignored in the request. The default value of multiformat supported is `true`.
+1. If the bid adapter YAML declares support of multiformat as `true`, then `prefmtype` is ignored in the request. The default value of multiformat supported is `false`.
 1. If the bidder declares that they don't support multiformat and the incoming request contains multiple formats, then one of the formats is chosen by either `$.ext.prebid.biddercontrols.BIDDER.prefmtype` or config `auction.preferredmediatype.BIDDER`
+1. If multiformat-supported is false, and if the specified prefmtype is not part of the request, then the imp doesn't go out to the bidder.
 
 #### OpenRTB Response Extensions
 

From bc79e8c8d81e1bea7fac010ef6a5bb1ed1b6e7f4 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Thu, 13 Mar 2025 13:24:46 -0400
Subject: [PATCH 056/665] documenting static floors (#5946)

* documenting static floors

* Update floors.md
---
 dev-docs/adunit-reference.md         |  6 ++++--
 dev-docs/modules/floors.md           | 30 ++++++++++++++++++++++++++--
 prebid-server/features/pbs-floors.md |  3 +++
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md
index 1369862c23..5a6967b77a 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -599,9 +599,9 @@ time to set targeting.
 
 <a name="adUnit-fpd-example"></a>
 
-### First Party Data
+### First Party Data and Floors
 
-Example of an adunit-specific block of first party data:
+Example of an adunit-specific block of first party data and a static floor:
 
 ```javascript
 pbjs.addAdUnits({
@@ -612,6 +612,8 @@ pbjs.addAdUnits({
         }
     },
     ortb2Imp: {
+        bidfloor: 1.00,
+        bidfloorcur: "EUR",
         ext: {
             data: {
                     pbadslot: "homepage-top-rect",
diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index b639d54909..839bfdcd88 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -58,6 +58,26 @@ Notes:
 * [Prebid Floor Service Providers](/dev-docs/modules/floors.html#floors-providers)
 * [Transcript of this video](/dev-docs/floors-video-overview.html)
 
+### Simple Static Floors
+
+Some publishers just want to set a simple static floor. Please don't use this module for that. This module should only be used when you need to vary the floor by mediatype, size, etc. Here's how you can set static floors on each Prebid adunit:
+
+```javascript
+pbjs.addAdUnits({
+    code: "test-div",
+    mediaTypes: {
+        banner: {
+            sizes: [[300,250]]
+        }
+    },
+    ortb2Imp: {
+        bidfloor: 1.00,
+        bidfloorcur: "EUR"
+    },
+    // ...
+});
+```
+
 ## How it Works
 
 There are several places where the Floor module changes the behavior of the Prebid.js auction process. Below is a diagram describing the general flow of the client-side Price Floors Module:
@@ -298,10 +318,13 @@ Schema 1 restricts floors providers or publishers to applying only one data grou
 Note: if you're a dynamic floor provider service, your response must be
 a subset that will be merged under the 'data' object.
 
+{: .alert.alert-warning :}
+You **cannot** set the `floorMin` parameter without specifying a `data` object. See the [simple static floor](/dev-docs/modules/floors.html#simple-static-floors) section above for more info.
+
 {: .table .table-bordered .table-striped }
 | Param | Type | Description | Default |
 |---+---+---+---+---|
-| floorMin | float | The mimimum CPM floor used by the Price Floors Module (as of 4.13). The Price Floors Module will take the greater of floorMin and the matched rule CPM when evaluating getFloor() and enforcing floors. | - |
+| floorMin | float | The mimimum CPM floor used by the Price Floors Module (as of 4.13). The Price Floors Module will take the greater of floorMin and the matched rule CPM when evaluating getFloor() and enforcing floors. **Note**: this is not a method of setting a [static floor](/dev-docs/modules/floors.html#simple-static-floors). | - |
 | floorProvider | string | Optional atribute (as of prebid version 4.1) used to signal to the Floor Provider's Analytics adapter their floors are being applied. They can opt to log only floors that are applied when they are the provider. If floorProvider is supplied in both the top level of the floors object and within the data object, the data object's configuration shall prevail.| - |
 | enforcement | object | Controls the enforcement behavior within the Price Floors Module.| - |
 | skipRate | integer | skipRate is a random function whose input value is any integer 0 through 100 to determine when to skip all floor logic, where 0 is always use floor data and 100 is always skip floor data. The use case is for publishers or floor providers to learn bid behavior when floors are applied or skipped. Analytics adapters will  have access to model version (if defined) when skipped is true to signal the Price Floors Module is in floors mode. If skipRate is supplied in both the root level of the floors object and within the data object, the skipRate configuration within the data object shall prevail. | 0 |
@@ -354,10 +377,13 @@ While some attributes are common in both schema versions, for completeness, all
 Note: if you're a dynamic floor provider service, your response must be
 a subset that will be merged under the 'data' object.
 
+{: .alert.alert-warning :}
+You **cannot** set the `floorMin` parameter without specifying a `data` object. See the [simple static floor](/dev-docs/modules/floors.html#simple-static-floors) section above for more info.
+
 {: .table .table-bordered .table-striped }
 | Param | Type | Description | Default |
 |---+---+---+---+---|
-| floorMin | float | The mimimum CPM floor used by the module (as of 4.13). The module will take the greater of floorMin and the matched rule CPM when evaluating getFloor() and enforcing floors. | - |
+| floorMin | float | The mimimum CPM floor used by the module (as of 4.13). The module will take the greater of floorMin and the matched rule CPM when evaluating getFloor() and enforcing floors. **Note**: this is not a method of setting a [static floor](/dev-docs/modules/floors.html#simple-static-floors). | - |
 | floorMinCur | float | Prebid Server only: the currency used for the floorMin value. | - |
 | floorProvider | string | Optional atribute (as of prebid version 4.1) used to signal to the Floor Provider's Analytics adapter their floors are being applied. They can opt to log only floors that are applied when they are the provider. If floorProvider is supplied in both the top level of the floors object and within the data object, the data object's configuration shall prevail.| - |
 | skipRate | integer | skipRate is a random function whose input value is any integer 0 through 100 to determine when to skip all floor logic, where 0 is always use floor data and 100 is always skip floor data. The use case is for publishers or floor providers to learn bid behavior when floors are applied or skipped. Analytics adapters will  have access to model version (if defined) when skipped is true to signal the module is in floors mode. If skipRate is supplied in both the root level of the floors object and within the data object, the skipRate configuration within the data object shall prevail. | 0 |
diff --git a/prebid-server/features/pbs-floors.md b/prebid-server/features/pbs-floors.md
index 64a953f373..8cdbc9fc6b 100644
--- a/prebid-server/features/pbs-floors.md
+++ b/prebid-server/features/pbs-floors.md
@@ -153,6 +153,9 @@ completely backwards-compatible -- PBS will accept and process any Prebid.js flo
 
 ### Defining Floor data
 
+{: .alert.alert-warning :}
+You **cannot** set the `floorMin` parameter without specifying a `data` object. See the [simple static floor](/dev-docs/modules/floors.html#simple-static-floors) section for more info.
+
 As described in the [Signaling](#floor-signaling) section above, floor data may be defined in several ways. Here's the order of priority:
 
 1. Dynamic data - if PBS finds recent (non-expired) floors data from a dynamic floors vendor, that takes precedence.

From 424eaae4d48efbabc07abdbc5c1977c11e8920e2 Mon Sep 17 00:00:00 2001
From: Rich Audience <integrations@richaudience.com>
Date: Mon, 17 Mar 2025 09:23:13 +0100
Subject: [PATCH 057/665] Update richaudience.md (#5937)

* Update richaudience.md

* Update richaudience.md

* Update richaudience.md
---
 dev-docs/bidders/richaudience.md | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/dev-docs/bidders/richaudience.md b/dev-docs/bidders/richaudience.md
index acb20c0fc5..0429d123c0 100644
--- a/dev-docs/bidders/richaudience.md
+++ b/dev-docs/bidders/richaudience.md
@@ -14,7 +14,6 @@ pbjs: true
 pbs: true
 schain_supported: true
 floors_supported: true
-pbjs_version_notes: Please use version 9.1; version 9.0 does not support our adapter.
 sidebarType: 1
 ---
 
@@ -26,17 +25,4 @@ sidebarType: 1
 | `pid`       | required        | The placement ID from Rich Audience.                                                                     | `'ADb1f40rmi'`                                                                                          | `string`   |
 | `supplyType`| required        | Define if site or app.                                                                                   | `'site / app'`                                                                                          | `string`   |
 | `ifa`       | optional        | Identifier For Advertisers                                                                               | `'AAAAAAAAA-BBBB-CCCC-1111-222222220000234234234234234'`                                                | `string`   |
-| `bidfloor`  | optional        | Bid Floor                                                                                                | `0.80`                                                                                                  | `float`    |
 | `keywords`  | optional        | A key-value applied only to the configured bid. This value is optional. Strings separated by semicolon.  | `car=mercedes;car=audi;`                                                                                | `string`   |
-| `player`    | optional        | Object containing video targeting parameters. See [Video Object](#ra-video-object) for details.          | `player: {init: 'open', end: 'close', skin: 'dark'}`                                                    | `object`   |
-
-<a name="ra-video-object"></a>
-
-### Video Object
-
-{: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                            | Example                       | Type      |
-|-------------|----------|----------------------------------------|-------------------------------|-----------|
-| `init`      | optional | Start mode of the player open or close | `'open / close'`              | `string`  |
-| `end`       | optional | End mode of the player open or close   | `'open / close'`              | `string`  |
-| `skin`      | optional | Choose the background color            | `'dark / light'`              | `string`  |

From 52d15befbf38ecece9bc4adc79324bc344d38284 Mon Sep 17 00:00:00 2001
From: Pavlo Kyrylenko <kirilenko.pavlo@gmail.com>
Date: Mon, 17 Mar 2025 22:29:06 +0200
Subject: [PATCH 058/665] anonymisedRtdProvider: can load Anonymised Marketing
 Tag external script (#5945)

* added ref on how to load Anonymised Marketing Tag by the RTD module

* corrected URLs to anonymised support portal

---------

Co-authored-by: Pavlo <pavlo@id-ward.com>
---
 dev-docs/modules/anonymisedRtdProvider.md | 25 +++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/dev-docs/modules/anonymisedRtdProvider.md b/dev-docs/modules/anonymisedRtdProvider.md
index b0a3c1a553..755b5393cb 100644
--- a/dev-docs/modules/anonymisedRtdProvider.md
+++ b/dev-docs/modules/anonymisedRtdProvider.md
@@ -38,7 +38,11 @@ gulp build --modules=rtdModule,anonymisedRtdProvider,...
          params: {
            cohortStorageKey: "cohort_ids",
            bidders: ["appnexus", "onetag", "pubmatic", "smartadserver", ...],
-           segtax: 1000
+           segtax: 1000,
+           tagConfig: {
+            clientId: 'testId'
+            //The rest of the Anonymised Marketing Tag parameters goes here
+           }
          }
        }
      ]
@@ -46,16 +50,21 @@ gulp build --modules=rtdModule,anonymisedRtdProvider,...
  });
 ```
 
-Please note that anonymisedRtdProvider should be integrated into the publisher website along with the [Anonymised Marketing Tag](https://support.anonymised.io/integrate/marketing-tag).
-Please reach out to Anonymised [representative](mailto:support@anonymised.io) if you have any questions or need further help to integrate Prebid, anonymisedRtdProvider, and Anonymised Marketing Tag
+The `anonymisedRtdProvider` must be integrated into the publisher's website along with the [Anonymised Marketing Tag](https://support.anonymised.io/integrate/marketing-tag?t=LPukVCXzSIcRoal5jggyeg). One way to install the Marketing Tag is through `anonymisedRtdProvider` by specifying the required [parameters](https://support.anonymised.io/integrate/optional-anonymised-tag-parameters?t=LPukVCXzSIcRoal5jggyeg) in the `tagConfig` object.  
+
+The `tagConfig.clientId` parameter is mandatory for the Marketing Tag to initialize. If `tagConfig` is empty or `tagConfig.clientId` is undefined, the `anonymisedRtdProvider` will not initialize the Marketing Tag. The publisher's `clientId` is [provided by Anonymised](https://support.anonymised.io/integrate/install-the-anonymised-tag-natively#InstalltheAnonymisedtagnatively-Instructions?t=LPukVCXzSIcRoal5jggyeg).  
+
+For any questions or assistance with integrating Prebid, `anonymisedRtdProvider`, or the Anonymised Marketing Tag, please contact an [Anonymised representative](mailto:support@anonymised.io).
 
 **Config Syntax details:**
 
 {: .table .table-bordered .table-striped }
 | Name  |Type | Description   | Notes  |
 | :------------ | :------------ | :------------ |:------------ |
-| name | String | Anonymised Rtd module name | 'anonymised' always|
-| waitForIt | Boolean | Required to ensure that the auction is delayed until prefetch is complete | Optional. Defaults to false |
-| params.cohortStorageKey | String | the `localStorage` key, under which Anonymised Marketing Tag stores the segment IDs | 'cohort_ids' always |
-| params.bidders | Array | Bidders with which to share segment information | Required |
-| params.segtax | Integer | The taxonomy for Anonymised | '1000' always |
+| name | `String` | Anonymised Rtd module name | 'anonymised' always|
+| waitForIt | `Boolean` | Required to ensure that the auction is delayed until prefetch is complete | Optional. Defaults to false |
+| params.cohortStorageKey | `String` | the `localStorage` key, under which Anonymised Marketing Tag stores the segment IDs | 'cohort_ids' always |
+| params.bidders | `Array` | Bidders with which to share segment information | Optional |
+| params.segtax | `Integer` | The taxonomy for Anonymised | '1000' always |
+| params.tagConfig | `Object` | Configuration for the Anonymised Marketing Tag | Optional. Defaults to `{}`. |
+| params.tagUrl | `String` | The URL of the Anonymised Marketing Tag script | Optional. Defaults to `https://static.anonymised.io/light/loader.js`. |

From 8ed034e54d39ff191091b633f7f22123490f1025 Mon Sep 17 00:00:00 2001
From: abermanov-zeta <95416296+abermanov-zeta@users.noreply.github.com>
Date: Mon, 17 Mar 2025 21:30:59 +0100
Subject: [PATCH 059/665] Zeta SSP Adapter: sid is an optional PBS param,
 update supported modules and media types. (#5941)

---
 dev-docs/bidders/zeta_global_ssp.md | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/zeta_global_ssp.md b/dev-docs/bidders/zeta_global_ssp.md
index b6d580dcae..11f32dceda 100644
--- a/dev-docs/bidders/zeta_global_ssp.md
+++ b/dev-docs/bidders/zeta_global_ssp.md
@@ -6,8 +6,11 @@ pbjs: true
 pbs: true
 biddercode: zeta_global_ssp
 deals_supported: false
-media_types: banner, video
+media_types: banner, video, audio
 tcfeu_supported: true
+floors_supported: true
+schain_supported: true
+fpd_supported: true
 usp_supported: true
 coppa_supported: true
 userIds: all
@@ -39,5 +42,7 @@ The Zeta Global SSP adapter requires setup and approval from the Zeta Global SSP
 
 #### Prebid Server Bid Params
 
-Prebid Server Adapter does not support any parameters.
-You must get `sid` value from Zeta Global and use it instead of the placeholder in the URL.
+{: .table .table-bordered .table-striped }
+| Name                 | Scope    | Description                                                                                                         | Example      | Type      |
+|----------------------|----------|---------------------------------------------------------------------------------------------------------------------|--------------|-----------|
+| `sid`                | optional | Seller ID. The identifier associated with the seller or reseller account within the advertising system              | `123`        | `integer` |

From d767b07ea9e5af85940216c70448bc2d91c68106 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Mon, 17 Mar 2025 21:32:48 +0100
Subject: [PATCH 060/665] Add vendor-exceptions include (#5939)

---
 _includes/dev-docs/vendor-exception.md     |  3 +++
 dev-docs/modules/permutiveRtdProvider.md   |  4 ++--
 dev-docs/modules/tcfControl.md             |  5 +++--
 dev-docs/modules/userid-submodules/utiq.md |  3 +--
 guide.md                                   | 16 ++++++++++++++++
 5 files changed, 25 insertions(+), 6 deletions(-)
 create mode 100644 _includes/dev-docs/vendor-exception.md

diff --git a/_includes/dev-docs/vendor-exception.md b/_includes/dev-docs/vendor-exception.md
new file mode 100644
index 0000000000..65979daf1f
--- /dev/null
+++ b/_includes/dev-docs/vendor-exception.md
@@ -0,0 +1,3 @@
+{: .alert.alert-warning :}
+Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor.
+{% if include.gvlId %}We recommend publishers let Prebid.js make use of their registered GVL ID {{ include.gvlId }} instead of a vendor exception.{% endif %}
diff --git a/dev-docs/modules/permutiveRtdProvider.md b/dev-docs/modules/permutiveRtdProvider.md
index 67f7c6ed42..10c3836212 100644
--- a/dev-docs/modules/permutiveRtdProvider.md
+++ b/dev-docs/modules/permutiveRtdProvider.md
@@ -60,6 +60,7 @@ as well as enabling settings for specific use cases mentioned above (e.g. acbidd
 ## Parameters
 
 {: .table .table-bordered .table-striped }
+
 | Name                   | Type                 | Description                                                                                   | Default            |
 | ---------------------- | -------------------- | --------------------------------------------------------------------------------------------- | ------------------ |
 | name                   | String               | This should always be `permutive`                                                             | -                  |
@@ -78,8 +79,7 @@ If you are also using the [TCF Control Module](/dev-docs/modules/tcfControl.html
 
 ### Instructions
 
-{: .alert.alert-warning :}
-Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor. Specifically for Permutive, we recommend publishers let Prebid.js make use of their registered GVL ID 361 instead of a vendor exception.
+{% include dev-docs/vendor-exception.md gvlId="361" %}
 
 1. Publisher enables rules within Prebid.js configuration. 
 2. Label Permutive as an exception, as shown below.
diff --git a/dev-docs/modules/tcfControl.md b/dev-docs/modules/tcfControl.md
index 0f493c3bff..ce10412285 100644
--- a/dev-docs/modules/tcfControl.md
+++ b/dev-docs/modules/tcfControl.md
@@ -40,6 +40,7 @@ The TCF Control Module adds the following:
 The following table details the Prebid.js activities that fall under the [Transparency and Consent Framework (TCF)](https://iabeurope.eu/iab-europe-transparency-consent-framework-policies/) scope:
 
 {: .table .table-bordered .table-striped }
+
 | In-Scope Activity | TCF Legal Basis Required | Activity | Prebid.js Version |
 | --- | --- | --- | --- |
 | Invoke usersync pixels | Purpose 1 - Store and/or access information on a device | May prevent one or more vendor usersyncs. | 3.14+ |
@@ -67,6 +68,7 @@ and (2) setConfig `consentManagement.gdpr.cmpApi` to either 'iab' or 'static'
 The following fields related to anonymizing aspects of the auction are supported in the [`consentManagement`](/dev-docs/modules/consentManagementTcf.html) object:
 
 {: .table .table-bordered .table-striped }
+
 | Param | Type | Description | Example |
 | --- | --- | --- | --- |
 | gdpr.rules | `Array of Objects` | Lets the publisher override the default behavior. | |
@@ -98,8 +100,7 @@ pbjs.setConfig({
 The following examples cover a range of use cases and show how Prebid.js supports
 configuration of different business rules.
 
-{: .alert.alert-warning :}
-Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor.
+{% include dev-docs/vendor-exception.md %}
 
 1. Restrict device access activity and basic ads. These are the default values (in Prebid.js 4.0) if the module is included in the build.
 
diff --git a/dev-docs/modules/userid-submodules/utiq.md b/dev-docs/modules/userid-submodules/utiq.md
index 625b530e07..7a95f72af5 100644
--- a/dev-docs/modules/userid-submodules/utiq.md
+++ b/dev-docs/modules/userid-submodules/utiq.md
@@ -42,8 +42,7 @@ If you use the Prebid.js [TCF Control Module](/dev-docs/modules/tcfControl.html)
 
 To do that, you can use below configuration:
 
-{: .alert.alert-warning :}
-Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor.
+{% include dev-docs/vendor-exception.md %}
 
 ```javascript
 pbjs.setConfig({
diff --git a/guide.md b/guide.md
index ed618f1c79..e19f691cbb 100644
--- a/guide.md
+++ b/guide.md
@@ -326,6 +326,22 @@ The docs offer a set of predefined disclosures that should be used where appropr
 {%raw%}{% include legal-warning.html %}{%endraw%}
 ```
 
+#### Vendor exception disclosure
+
+{% include dev-docs/vendor-exception.md %}
+
+```liquid
+{%raw%}{% include dev-docs/vendor-exception.md %}{%endraw%}
+```
+
+You can also add a `gvlId` parameter if the vendor has in fact an ID.
+
+{% include dev-docs/vendor-exception.md gvlId="123" %}
+
+```liquid
+{%raw%}{% include dev-docs/vendor-exception.md gvlId="123" %}{%endraw%}
+```
+
 ## Partners
 
 TBD

From 6225f938bec931d90e2a66b71037d00d05723fb6 Mon Sep 17 00:00:00 2001
From: duancg <duancg@yahoo.com>
Date: Mon, 17 Mar 2025 13:33:34 -0700
Subject: [PATCH 061/665] Update distroscale.md to include support contact
 email (#5928)

* Update distroscale.md to include support contact email

Added a section in the bidder doc to include support contact email

* Update distroscale.md to fix bare URL error

added angle brackets around email address
---
 dev-docs/bidders/distroscale.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/dev-docs/bidders/distroscale.md b/dev-docs/bidders/distroscale.md
index 380916a4d6..dba00b8fb3 100644
--- a/dev-docs/bidders/distroscale.md
+++ b/dev-docs/bidders/distroscale.md
@@ -19,6 +19,12 @@ gvl_id: 754
 sidebarType: 1
 ---
 
+### Registration
+
+To use the DistroScale bidder you will need a pubid (Publisher ID) from an account on DistroScale.
+
+For further information, please contact <support@distroscale.com>.
+
 ### Bid Params
 
 {: .table .table-bordered .table-striped }

From ffdcfd2c0289605ca326738cd9c7aa721cb20c76 Mon Sep 17 00:00:00 2001
From: Fatih Kaya <fatih.kaya.84@gmail.com>
Date: Tue, 18 Mar 2025 08:21:38 +0300
Subject: [PATCH 062/665] AdMatic: documentation update for admatic and aliases
 (#5940)

* added simple params

* update

* Update admatic.md

* update

* update

* Pixad Bid Adapter: added simple params

* AdMatic Adapter: Feature update

Pixad alias is included in the update.

* Update admatic.md

* Update pixad.md

* gvl_id add

* Update pixad.md

* admatic && pixad pbs support true

* Create monetixads.md

* new alias

* new alias

* Update adt.md

* Revert "Update adt.md"

This reverts commit c274c967792bb77e7c897501b70732df5acc6290.

* Revert "new alias"

This reverts commit cb15f2c27b28d937986d53ebaf3efeabfd5df9d3.

* Create adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* yobee

* Update yobee.md

* dev-doc update

* Update admaticde.md
---
 dev-docs/bidders/admatic.md   | 3 +++
 dev-docs/bidders/admaticde.md | 5 ++++-
 dev-docs/bidders/pixad.md     | 3 +++
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/admatic.md b/dev-docs/bidders/admatic.md
index 841c14b16e..27d544f6b3 100644
--- a/dev-docs/bidders/admatic.md
+++ b/dev-docs/bidders/admatic.md
@@ -14,9 +14,12 @@ gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true
 dchain_supported: false
 userIds: all
+prebid_member: true
+pbs_app_supported: true
 safeframes_ok: true
 floors_supported: true
 multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
 sidebarType: 1
 ---
 
diff --git a/dev-docs/bidders/admaticde.md b/dev-docs/bidders/admaticde.md
index ea409f24c9..e43064a136 100644
--- a/dev-docs/bidders/admaticde.md
+++ b/dev-docs/bidders/admaticde.md
@@ -14,16 +14,19 @@ gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true
 dchain_supported: false
 userIds: all
+prebid_member: true
+pbs_app_supported: true
 safeframes_ok: true
 floors_supported: true
 aliasCode: admatic
 multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
 sidebarType: 1
 ---
 
 ### Description
 
-AdMatic GMBH header bidding adapter connects with AdMatic GMBH demand sources to fetch bids for network ID. Please reach out to your account manager or <fatih.kaya@admatic.de> for more information.
+AdMatic GMBH header bidding adapter connects with AdMatic GMBH demand sources to fetch bids for network ID. Please reach out to your account manager or <info@admatic.de> for more information.
 
 ### Bid params
 
diff --git a/dev-docs/bidders/pixad.md b/dev-docs/bidders/pixad.md
index 3ece67bd27..a0e0a32722 100644
--- a/dev-docs/bidders/pixad.md
+++ b/dev-docs/bidders/pixad.md
@@ -14,10 +14,13 @@ gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true
 dchain_supported: false
 userIds: all
+prebid_member: true
+pbs_app_supported: true
 safeframes_ok: true
 floors_supported: true
 aliasCode: admatic
 multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
 sidebarType: 1
 ---
 

From 8d58f27b59c7a68207cc71fcf5287d8606c2bf4e Mon Sep 17 00:00:00 2001
From: ss-toshihide-tajima
 <89903823+ss-toshihide-tajima@users.noreply.github.com>
Date: Tue, 18 Mar 2025 18:09:47 +0900
Subject: [PATCH 063/665] Update adgeneration doc add first party data (#5949)

* Supports im-uid

* update features

* Add FirstPartyData sample

* Prebid Server Adapter not support

* fix segment path

* Update FPD sample

* Add a single newline character
---
 dev-docs/bidders/adgeneration.md | 40 ++++++++++++++++++++++++++++++--
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/adgeneration.md b/dev-docs/bidders/adgeneration.md
index 23b49e1e67..12e9914304 100644
--- a/dev-docs/bidders/adgeneration.md
+++ b/dev-docs/bidders/adgeneration.md
@@ -2,10 +2,13 @@
 layout: bidder
 title: Ad Generation
 description: Prebid Ad Generation Bidder Adaptor
+schain_supported: true
 pbjs: true
-pbs: true
+pbs: no
+pbs_app_supported: no
+fpd_supported: true
 biddercode: adgeneration
-userIds: criteo, id5Id
+userIds: all
 media_types: native
 sidebarType: 1
 ---
@@ -17,3 +20,36 @@ sidebarType: 1
 | Name | Scope    | Description | Example  | Type     |
 |------|----------|-------------|----------|----------|
 | `id` | required | adId        | `'1234'` | `string` |
+
+#### First Party Data
+
+In release 1.6.4 and later, publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
+
+* ortb2.site.content.data[]
+
+If `ad-generation.jp` is specified for ortb2.site.content.data[].name and `546` is specified for ortb2.site.content.data[].ext.segtax,
+`ortb2.site.content.data[].segment[].name` and `ortb2.site.content.data[].segment[].value` can be any string value.
+
+Example first party data that's available to all bidders and all adunits:
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        site: {
+            content: {
+                data: [{
+                    name: "ad-generation.jp",
+                    ext: {
+                        segtax: 546
+                    },
+                    segment: [
+                        { name: "news_category", value: "Sports_Sumo" },// name and value must be string types
+                        { name: "local_gourmet", value: "sushi" },
+                        { name: "location", value: "tokyo" }
+                    ]
+                }]
+            }
+        },
+    }
+});
+```

From eea66eaebaae5ad9f5c41b92a610a17e51db78d2 Mon Sep 17 00:00:00 2001
From: decemberWP <155962474+decemberWP@users.noreply.github.com>
Date: Tue, 18 Mar 2025 15:33:06 +0100
Subject: [PATCH 064/665] ceeIdSystem documentation update (#5896)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: wojciech-bialy-wpm <67895844+wojciech-bialy-wpm@users.noreply.github.com>
Co-authored-by: Wojciech Biały <wojciech.bialy@grupawp.pl>
---
 .../modules/userid-submodules/ceeIdSystem.md     | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/ceeIdSystem.md b/dev-docs/modules/userid-submodules/ceeIdSystem.md
index 3ab6277289..2e2194a1c7 100644
--- a/dev-docs/modules/userid-submodules/ceeIdSystem.md
+++ b/dev-docs/modules/userid-submodules/ceeIdSystem.md
@@ -29,12 +29,14 @@ gulp build --modules=ceeIdSystem
 | storage.expires | Optional | Int | Time when storage should expire it is recommended to use this options otherwise storage last only during session  | `7` |
 | storage.refreshInSeconds | Optional | Int | Time when storage value and expiration date will get refreshed in seconds  | `360` |
 | params | Required | Object | Container of all module params. |  |
-| params.tokenName | Required | String |  Your custom name of token to read | `'myExampleTokenName'` |
-| params.value | Optional | String | Optional param if you want to pass token value directly through setConfig  | `'someTokenValue'` |
+| params.publisherId | Required | String | Required param which defines your publisher ID to send in query  | `'123'` |
+| params.type | Required | String | Required param which defines type of encoding used on user email.  Use 'email' if HEM was encoded by base64 or use 'hex' if it was encoded by hex  | `'hex'` |
+| params.value | Required | String | Required param where you pass HEM value  | `'exampleHEMValue'` |
+| params.cookieName | Optional | String |  Your custom name of token to read it is only used if second way of integration is chosen. | `'myExampleCookieName'` |
 
 ## CEEID Examples
 
-You can configure this submodule in your `userSync.userIds[]` configuration. Publishers manage ceeIds themselves can store ceeIds in local storage or 1st party cookies. You can use your custom name of token to read
+You can configure this submodule in your `userSync.userIds[]` configuration. We have two implementation methods depending on the publisher's needs. The first method we suggest for publishers is to provide appropriate data that will allow you to query the endpoint to retrieve the ceeId token. To query the endpoint correctly, you will need the publisher's ID in the params.publisheId field. In addition, the HEM type, i.e. how the user's email was encoded, we consider two methods: base64 encoding and hex encoding. The value of HEM should be passed in the params.value field.
 
 ```javascript
 pbjs.setConfig({
@@ -48,14 +50,16 @@ pbjs.setConfig({
                 refreshInSeconds: 360
             },
             params: {
-                tokenName: 'name' // Your custom name of token to read
+                publisherId: '123', // Publisher ID
+                type: 'email', // use 'email' if HEM was encoded by base64 or use 'hex' if it was encoded by hex
+                value: 'exampleHEMValue', // HEM value
             }
         }]
     }
 });
 ```
 
-Or pass value directly thorugh params.value. Note that tokenName is not required then. This param shouldn't be set if token value will be taken by tokenName
+The second way is to use a token from a cookie or local storage previously prepared by the publisher. The only thing needed in this approach is to enter the name of the cookie/local storage that the module should use in the params.cookieName field.
 
 ```javascript
 pbjs.setConfig({
@@ -69,7 +73,7 @@ pbjs.setConfig({
                 refreshInSeconds: 360
             },
             params: {
-                value: 'tokenValue'
+                cookieName: 'name' // Your custom name of token to read from cookies or local storage
             }
         }]
     }

From 4e4b95e31b773d66dc27a077bd599ec0f50c1ad4 Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Wed, 19 Mar 2025 10:09:14 +0100
Subject: [PATCH 065/665] Add Prismassp Bidder docs (#5935)

* prismassp added

* multiformat added

---------

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/1accord.md   |   1 +
 dev-docs/bidders/easybid.md   |   1 +
 dev-docs/bidders/nexx360.md   |  27 ++++----
 dev-docs/bidders/prismassp.md | 121 ++++++++++++++++++++++++++++++++++
 4 files changed, 139 insertions(+), 11 deletions(-)
 create mode 100644 dev-docs/bidders/prismassp.md

diff --git a/dev-docs/bidders/1accord.md b/dev-docs/bidders/1accord.md
index 9c99e0720a..680f299fc0 100644
--- a/dev-docs/bidders/1accord.md
+++ b/dev-docs/bidders/1accord.md
@@ -19,6 +19,7 @@ safeframes_ok: true
 deals_supported: true
 sidebarType: 1
 fpd_supported: true
+multiformat_supported: will-bid-on-any
 
 ---
 
diff --git a/dev-docs/bidders/easybid.md b/dev-docs/bidders/easybid.md
index 7f1ca702bd..478aea2043 100644
--- a/dev-docs/bidders/easybid.md
+++ b/dev-docs/bidders/easybid.md
@@ -18,6 +18,7 @@ safeframes_ok: true
 deals_supported: true
 sidebarType: 1
 fpd_supported: true
+multiformat_supported: will-bid-on-any
 
 ---
 
diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index 8e4f5a5bc9..9eeca65cee 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -4,16 +4,21 @@ title: Nexx360
 description: Prebid Nexx360 Bidder Adapter
 pbjs: true
 biddercode: nexx360
+gvl_id: 965
 tcfeu_supported: true
 usp_supported: true
+gpp_supported: true
 schain_supported: true
+dchain_supported: false
 floors_supported: true
 userIds: all
-tcf2_supported: true
+tcfeu_supported: true
 media_types: banner, video, native
-gvl_id: 965
-pbs: false
+safeframes_ok: true
+deals_supported: true
 sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
 
 ---
 
@@ -22,9 +27,9 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description                | Example                                   | Type      |
 |---------------|----------|----------------------------|--------------------------------------     |-----------|
-| `tagId`       | required | Nexx360 tag ID             | `"luvxjvgn"`                              | `string`  |
-| `videoTagId`  | optional | Nexx360 Video tag ID       | `"luvxjvgn"`                              | `string`  |
-| `nativeTagId` | optional | Nexx360 Native tag ID      | `"luvxjvgn"`                              | `string`  |
+| `tagId`       | required | Nexx360 tag ID             | `"testnexx"`                              | `string`  |
+| `videoTagId`  | optional | Nexx360 Video tag ID       | `"testnexx"`                              | `string`  |
+| `nativeTagId` | optional | Nexx360 Native tag ID      | `"testnexx"`                              | `string`  |
 | `allBids`     | optional | Return all bids            | `true`                                    | `boolean` |
 | `divId`       | optional | divId linked to adUnit     | `"div-1"`                                 | `string`  |
 | `adUnitName`  | optional | A code to identify adUnit  | `"header-ad"`                             | `string`  |
@@ -63,7 +68,7 @@ var adUnits = [
       bids: [{
          bidder: 'nexx360',
          params: {
-            tagId: 'luvxjvgn'
+            tagId: 'testnexx'
          }
        }]
    },
@@ -79,7 +84,7 @@ var adUnits = [
         bids: [{
             bidder: 'nexx360',
             params: {
-               tagId: 'luvxjvgn'
+               tagId: 'testnexx'
             }
         }]
     },
@@ -102,7 +107,7 @@ var adUnits = [
         bids: [{
             bidder: 'nexx360',
             params: {
-               tagId: 'luvxjvgn'
+               tagId: 'testnexx'
             }
         }]
     },
@@ -124,8 +129,8 @@ var adUnits = [
         bids: [{
             bidder: 'nexx360',
             params: {
-               tagId: 'luvxjvgn',
-               videoTagId: 'luvxjvgn'
+               tagId: 'testnexx',
+               videoTagId: 'testnexx'
             }
         }]
     };
diff --git a/dev-docs/bidders/prismassp.md b/dev-docs/bidders/prismassp.md
new file mode 100644
index 0000000000..d257868412
--- /dev/null
+++ b/dev-docs/bidders/prismassp.md
@@ -0,0 +1,121 @@
+---
+layout: bidder
+title: Prismassp
+description: Prebid Prismassp Bidder Adapter
+pbjs: true
+biddercode: prismassp
+gvl_id: 965
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | tag ID                     | `"testpris"`                              | `string`  |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'prismassp',
+         params: {
+            tagId: 'testpris'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'prismassp',
+            params: {
+               tagId: 'testpris'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'prismassp',
+            params: {
+               tagId: 'testpris'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'prismassp',
+            params: {
+               tagId: 'testpris',
+               videoTagId: 'testpris'
+            }
+        }]
+    };
+];
+```

From 07603a6792f6cbfce871535dbf64cde0ad612dbc Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Wed, 19 Mar 2025 13:16:26 -0700
Subject: [PATCH 066/665] Added docs for the prev auction info module (#5881)

Merging as feedback is resolved with new commits.
---
 dev-docs/modules/previousAuctionInfo.md | 95 +++++++++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 dev-docs/modules/previousAuctionInfo.md

diff --git a/dev-docs/modules/previousAuctionInfo.md b/dev-docs/modules/previousAuctionInfo.md
new file mode 100644
index 0000000000..37214e89e5
--- /dev/null
+++ b/dev-docs/modules/previousAuctionInfo.md
@@ -0,0 +1,95 @@
+---
+layout: page_v2
+page_type: module
+title: Module - Previous Auction Info
+description: Allows publishers and bidders to collect and inject past auction data into future bid requests
+module_code : previousAuctionInfo
+display_name : Previous Auction Info
+enable_download : true
+sidebarType : 1
+
+---
+
+# Previous Auction Info
+
+## Overview
+
+The Previous Auction Info module enables functionality to collect prior auction data for participating bidders and publishers (This feature is `opt-in`, by default it is disabled).
+
+## How to Enable the Module
+
+A Publisher must do the following in order for the module to work:
+
+* Include the Previous Auction Info module within your Prebid.js build: [https://docs.prebid.org/download.html](https://docs.prebid.org/download.html)
+
+* Configure Prebid.js to enable the Previous Auction Info module:
+
+```javascript
+pbjs.setConfig({previousAuctionInfo: { enabled: true, bidders: ['bidderCode1', 'bidderCode2'], maxQueueLength: 10 }})
+```
+
+* Only valid bid requests submitted by bidders who have enabled the Previous Auction Info module will be permitted.
+
+If the requirements above are met, the flow for how the module works is as follows:
+
+1. A Prebid.js auction runs and completes.
+1. At the end of an auction, details about the auction are collected from each bidder using the module.
+1. If a Prebid bid wins, then the `rendered` field is updated to `1` to indicate this in the collected auction data for all bidders who bid on the same adunit within the same Prebid auction.
+1. During the next Prebid.js auction, if a bidder is included in previousAuctionInfo.bidders AND is included in the auction, then previous auction info data will be injected into the bidder's bid request of the new auction within the following path: `ortb2.ext.prebid.previousauctioninfo`.
+
+## Configuration Options
+
+{: .table .table-bordered .table-striped }
+| Field | Required? | Type | Description |
+|---|---|---|---|
+| previousAuctionInfo.enabled | yes | boolean | Enables/disables the module. |
+| previousAuctionInfo.bidders | no | array of strings  | Array of bidder codes to determine which bidders are allowed to receive collected previous auction info. Omitting this field will enable all bidders. |
+| previousAuctionInfo.maxQueueLength | no | integer  | The number of previous auction info payloads to store/collect per bidder before injecting these payloads into the bidstream. Any payloads collected for a bidder during one auction will be injected into the bidstream during the next auction that the same bidder participates in with valid bids. If this field is omitted, the value of this field is 10. |
+
+## Example of Previous Auction Info Payload
+
+`previousAuctionInfo` is an array of prior auction data catered to a specific bidder (if present, it will be added to a bidder's bid request). See below for an example of how the structure of the data looks (Note: Once collected previous auction data has been injected into the bid stream, then it is removed and no longer stored within the module):
+
+```javascript
+ortb2: {
+  ext: {
+    prebid: {
+      previousauctioninfo: [
+        {
+          bidderRequestId: "123abc",
+          bidId: "456def",
+          rendered: 1, // default is 0
+          source: "pbjs",
+          adUnitCode: "div-gpt-ad-123-0",
+          highestBidCpm: 0.052275935, // default is null
+          bidderCpm: 0.04, // default is null
+          bidderOriginalCpm: 0.04, // default is null
+          bidderCurrency: "USD", // default is null
+          bidderOriginalCurrency: "USD", // default is null
+          bidderErrorCode: -1, // default is null
+          timestamp: 1739400860310
+        }
+      ]
+    }
+  }
+}
+```
+
+## Description of Previous Auction Info Payload
+
+{: .table .table-bordered .table-striped }
+| Field | Type | Description | Default |
+|---|---|---|---|
+| ortb2.ext.prebid.previousauctioninfo | array |  |  |
+| ortb2.ext.prebid.previousauctioninfo[].bidderRequestId | string | ID of a previous bidder request |  |
+| ortb2.ext.prebid.previousauctioninfo[].bidId | string | ID of a previous bid request |  |
+| ortb2.ext.prebid.previousauctioninfo[].rendered | integer | Signifies if the relevant adunit bid on was rendered or not | 0 |
+| ortb2.ext.prebid.previousauctioninfo[].source | string | Where the previous auction info was collected |  |
+| ortb2.ext.prebid.previousauctioninfo[].adUnitCode | string | Ad unit code of the ad slot that was bid on |  |
+| ortb2.ext.prebid.previousauctioninfo[].highestBidCpm | float | The highest Prebid bid cpm observed for the relative ad slot of a previous auction | null |
+| ortb2.ext.prebid.previousauctioninfo[].bidderCpm | float | The bid cpm submitted by the bidder receiving the previous auction info payload | null |
+| ortb2.ext.prebid.previousauctioninfo[].bidderOriginalCpm | float | The original bid cpm submitted by the bidder receiving the previous auction info payload | null |
+| ortb2.ext.prebid.previousauctioninfo[].bidderCurrency | string | The bidder currency submitted by the bidder receiving the previous auction info payload | null |
+| ortb2.ext.prebid.previousauctioninfo[].bidderOriginalCurrency | string | The original bidder currency submitted by the bidder receiving the previous auction info payload | null |
+| ortb2.ext.prebid.previousauctioninfo[].bidderErrorCode | integer | Whether an error was present or not | null |
+| ortb2.ext.prebid.previousauctioninfo[].timestamp | integer | Time that the previous auction info payload was collected |  |

From 65e08081604d0d1faa879fcfb93e3f90ab453265 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Thu, 20 Mar 2025 02:57:41 -0700
Subject: [PATCH 067/665] JS: userID developer documentation (#5897)

* First draft of userId dev docs

* tweaked TOC and heading levels

* adding user ID page to nav bar

* table formatting

---------

Co-authored-by: bretg <bgorsline@gmail.com>
---
 _data/sidebar.yml         |   8 ++
 dev-docs/userId-module.md | 221 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 229 insertions(+)
 create mode 100644 dev-docs/userId-module.md

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index 5031ca0148..a193c37130 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -450,6 +450,14 @@
   sectionTitle:
   subgroup: 4
 
+- sbSecId: 1
+  title: How to Add A User ID submodule
+  link: /dev-docs/userId-module.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 4
+
 - sbSecId: 1
   title: How to Add a Prebid.js Video submodule
   link: /dev-docs/add-video-submodule.html
diff --git a/dev-docs/userId-module.md b/dev-docs/userId-module.md
new file mode 100644
index 0000000000..2e766d6137
--- /dev/null
+++ b/dev-docs/userId-module.md
@@ -0,0 +1,221 @@
+---
+layout: page_v2
+title: How to Add a New Prebid.js User ID Module
+description: Documentation on how to add a Prebid.js new user ID module
+top_nav_section: dev_docs
+nav_section: adapters
+sidebarType: 1
+---
+
+# How to Add a New Prebid.js User ID Module
+{: .no_toc }
+
+* TOC
+{:toc}
+
+## Overview
+
+A user ID module is responsible for providing user ID data to Prebid.js. The flow is as follows:
+
+1. The publisher includes and configures your module as described in [Module - User ID](/dev-docs/modules/userId.html);
+2. Prebid.js determines whether your ID should be included, depending on [consent management](/support/privacy-resources.html) or other [activity controls](/dev-docs/activity-controls.html);
+3. If it is, it invokes your module's `getId` and `decode` methods to obtain an ID, and uses your `eids` configuration to transform it into an ORTB [EID](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#objecteid) object;
+4. Prebid.js then stores your ID (optionally and depending on the publisher's [storage configuration](/dev-docs/modules/userId.html#basic-configuration)) and injects it into the bid stream;
+5. On subsequent sessions, Prebid.js retrieves your ID from storage (if applicable) and repeats this flow using `extendId` instead of `getId`.
+
+## Module interface
+
+A user ID module is a javascript file in the [modules](https://github.com/prebid/Prebid.js/tree/master/modules) folder that:
+
+* has a file name that ends with 'IdSystem.js';
+* is listed as a userID submodule in [.submodules.json](https://github.com/prebid/Prebid.js/blob/master/modules/.submodules.json);
+* registers a module object using `submodule('userId', userIdSpec)`.
+
+`userIdSpec` has the following properties:
+
+{: .table .table-bordered .table-striped }
+| Property   | Scope                              | Type   | Description                                                                                                   | 
+|------------|------------------------------------|--------|---------------------------------------------------------------------------------------------------------------|
+| `name`     | Required                           | String | Name of your ID provider, used to match your module with the publisher's [userIds configuration](/dev-docs/modules/userId.html#basic-configuration)            |
+| `gvlid`    | Optional                           | Number | GVL ID to use for TCF. If omitted your module may be be excluded when TCF is in scope.                        |
+| `getId`    | Required                           | Function | Retrieve serializable ID data, see [`getId`](#getId)                                                          |
+| `extendId` | Optional                           | Function | Update previously stored ID data, see [`extendId`](#extendId)                                                 |
+| `decode`  | Required                           | Function | Decode result from `getId` or `extendId`, see [`decode`](#decode)                                             |
+| `eids`    | Optional, but strongly recommended | Object   | One or more [EID configurations](#eidConfig) used to translate the result from `decode` into ORTB EID Objects |
+
+See [SharedIdSystem](https://github.com/prebid/Prebid.js/blob/master/modules/sharedIdSystem.js) for an example.
+
+<a id="getId"></a>
+
+### `getId(config, consentData, storedId)`
+
+Invoked when:
+
+* Prebid.js did not previously store your ID, or
+* your previously stored ID has expired (depending on the publisher's `expires` and/or `refreshInSeconds`[storage configuration](/dev-docs/modules/userId.html#basic-configuration)), or
+* consent data has changed since the last time it was stored, or
+* the publisher explicitly asked for a refresh using [`refreshUserIds`](/dev-docs/publisher-api-reference/refreshUserIds.html).
+ 
+#### Arguments
+
+{: .table .table-bordered .table-striped }
+ | Name                | Type   | Description                                                                                                                   | 
+ |---------------------|--------|-------------------------------------------------------------------------------------------------------------------------------|
+ | `config`            | Object | Configuration for your module as provided by the publisher                                                                    |
+ | `consentData`       | Object |                                                                                                                               |
+ | `consentData.gdpr`  | Object | TCF consent data when [consentManagementTcf](/dev-docs/modules/consentManagementTcf.html) is included, or null otherwise      |
+ | `consentData.gpp`   | Object | GPP consent data when [consentManagementGpp](/dev-docs/modules/consentManagementGpp.html) is included, or null otherwise      |
+ | `consentData.usp`   | String  | US Privacy string when [consentManagementUsp](/dev-docs/modules/consentManagementUsp.html) is included, or null otherwise     |
+ | `consentData.coppa` | Boolean | COPPA flag as set by [publisher configuration](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#coppa) |
+ | `storedId`          | String or Object | Your previously stored ID data, if any, as was returned by `getId` or `extendId`                                    |
+
+#### Return value
+
+`getId` should return an object containing one or both of:
+
+{: .table .table-bordered .table-striped }
+| Property    | Type | Description                                                                       |
+|-------------|------|-----------------------------------------------------------------------------------|
+| `id`        | String or Object | Serializable ID data. Objects will be passed through `JSON.stringify`             | 
+| `callback`  | Function | Invoked at a later point with another callback function `setId` as first argument |
+
+If your module can provide ID data synchronously it should set `id` directly;
+otherwise it should provide a `callback` that calls its first argument `setId` passing it ID data. 
+
+In both cases ID data should be a string or a plain, serializable JS object; this data is what may then get stored, passed to [`decode`](#decode) and, on later sessions, to `getId` or `extendId` as the `storedId` argument.    
+
+#### Example: synchronous ID generation
+
+```javascript
+function getId(config, consentData, storedId) {
+   return {id: storedId || generateUUID()}
+}
+```
+
+#### Example: aynschronous ID retrieval
+
+```javascript
+function getId(config, consentData, storedId) {
+    return {
+        callback: function(setId) {
+            fetch(ENDPOINT_URL, {
+                body: JSON.stringify({
+                    params: config.params,
+                    consentData
+                })
+            }).then(async function(response) {
+                if (reponse.ok) {
+                    setId((await response.json()).id);
+                }
+            });
+        }
+    }
+}
+```
+
+<a id="extendId"></a>
+
+### `extendId(config, consentData, storedId)`
+
+If provided, it's invoked when `getId` is not; namely:
+
+* Prebid.js previously stored your ID, and
+* the stored ID has not expired, and
+* consent data has not changed since it was stored, and
+* the publisher is not asking for a refresh.
+ 
+Takes the same arguments and should return an object in the same format as [getId](#getId).
+
+<a id="decode"></a>
+
+### `decode(data, config)`
+
+Decode ID data. Invoked every time data from your module is available, either from storage or `getId` / `extendId`. 
+
+Arguments are:
+
+{: .table .table-bordered .table-striped }
+| Name     | Type               | Description                                    |
+|----------|--------------------|------------------------------------------------|
+| `data`   | String or Object  | ID data as provided by `getId` / `extendId`     |
+| `config` | Object | Configuration for your module as provided by the publisher |
+
+Should return an object with at least one entry where the key is an identifier for your ID provider and the value is the ID (which can have any type or structure).
+
+The return value is what's made available to publishers through [`getUserIds()`](/dev-docs/publisher-api-reference/getUserIds.html) and to bid adapters in `bidRequest.userId`; it's also used to generate EIDs using your [EID configuration](#eidConfig).
+
+For example:
+
+```javascript
+function decode(data, config) {
+    return {exampleId: data};
+}
+```
+
+would populate `bidRequest.userId.exampleId` and `pbjs.getUserIds().exampleId` with the ID as provided by `getId`; and would be used to generate EIDs your module's `eids.exampleId` configuration.
+
+<a id="eidConfig"></a>
+
+### EID configuration
+
+For each `key` and `idValue` entry in the object returned by `decode`, Prebid.js will:
+ 
+* Normalize `idValue` into an array `idValues`, which is either the same as `idValue` if that's already an array, or an array containing a single member `idValue`;
+* look for a matching `key` in `eids` and, if present, use the corresponding value `eidConfig` to translate `idValues` into EID Objects;
+
+`eidConfig` can be either a function or an object. 
+
+#### EID translation functions
+
+If a function, `eidConfig` is invoked with:
+
+{: .table .table-bordered .table-striped }
+| Name       | Type | Description                                                        |
+|------------|------|--------------------------------------------------------------------|
+| `idValues` | Array | ID values from `decode`, normalized to an array as described above |
+| `config` | Object | Configuration for your module as provided by the publisher |
+
+It should return an object or array of objects in the [ORTB EID](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#objecteid) format.
+
+Example:
+
+```javascript
+exampleIdSpec.eids = {
+    exampleId: function(idValues, config) {
+        return {
+            source: 'exampleId.com',
+            uid: idValues.map(value => ({
+                id: value,
+                atype: 1
+            }))
+        };
+    }
+}
+```
+
+#### EID configuration objects
+
+If an object, `eidConfig` should contain:
+
+{: .table .table-bordered .table-striped }
+| Property    | Scope                                   | Type     | Description                                                                                                              | 
+|-------------|-----------------------------------------|----------|--------------------------------------------------------------------------------------------------------------------------|
+| `source`    | Required if `getSource` is not provided | String   | Value for `eid.source`                                                                                                   |
+| `getSource` | Required if `source` is not provided    | Function | Returns a string to use for `eid.source`                                                                                 |
+| `getEidExt` | Optional                                | Function | Returns an object to use for `eid.ext`                                                                                   |                                                                                      
+| `getValue`  | Optional                                | Function | Returns a string to use for `eid.uid.id`. If not provided, members of `idValues` must be strings, and will be used as-is |
+| `atype`     | Optional, but recommended               | Number   | Value for `eid.uid.atype`                                                                                                |
+| `getUidExt` | Optional                                | Function | Returns an object to use for `eids.uid.ext`                                                                              |
+
+All functions are invoked once for - and passed as an argument - each element in `idValues`.
+
+Example:
+
+```javascript
+exampleIdSpec.eids = {
+    exampleId: {
+        source: 'exampleId.com',
+        atype: 1
+    }
+}
+```

From 266e2b29430ede9a2802f49659b36a750631d9ba Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Thu, 20 Mar 2025 12:09:33 +0200
Subject: [PATCH 068/665] Mobile: Support GMA SDK v12 in iOS (#5903)

* docs: add gma-versions-tabs template

* fix: linting issues

* docs: update template

* docs: add code highlight

* docs: update gam-bidding-only-html-banner

* docs: update gam-bidding-only-html-banner

* docs: update gam-bidding-only-html-banner

* docs: update template

* docs: update template

* docs: update gam-bidding-only-html-banner

* docs: update gam-bidding-only-html-banner

* docs: update template

* docs: update gam-bidding-only-html-banner.md

* docs: update gam-bidding-only-html-banner

* docs: update template

* docs: update template

* docs: update gam-bidding-only-interstitial-banner

* docs: fix linting issue

* docs: update the rest of original api examples

* docs: fix linting errors

* docs: small improvements

* docs: updates in files where GAM is present

* docs: fix linting issues

* docs: minor corrections
---
 _includes/code/gma-versions-tabs.html         |  61 +++++
 .../rendering/ios-sdk-integration-admob.md    | 231 ++++++++++++++----
 .../rendering/ios-sdk-integration-gam.md      |  34 +--
 .../pbm-api/ios/code-integration-ios.md       |  26 +-
 .../pbm-api/ios/pbm-targeting-ios.md          |   2 +-
 prebid-mobile/pbm-api/ios/pbm-util-ios.md     |  20 +-
 .../ios/gam-bidding-only-html-banner.md       |  82 +++++--
 .../gam-bidding-only-interstitial-banner.md   |  45 +++-
 .../gam-bidding-only-interstitial-video.md    |  79 ++++--
 ...m-bidding-only-multiformat-interstitial.md |  57 ++++-
 .../ios/gam-bidding-only-multiformat.md       |  91 ++++++-
 .../ios/gam-bidding-only-native-in-app.md     | 110 +++++++--
 .../ios/gam-bidding-only-native-in-webview.md |  46 +++-
 .../ios/gam-bidding-only-rewarded-video.md    |  47 +++-
 .../ios/gam-bidding-only-video-outstream.md   |  55 ++++-
 15 files changed, 804 insertions(+), 182 deletions(-)
 create mode 100644 _includes/code/gma-versions-tabs.html

diff --git a/_includes/code/gma-versions-tabs.html b/_includes/code/gma-versions-tabs.html
new file mode 100644
index 0000000000..aa7aa312c0
--- /dev/null
+++ b/_includes/code/gma-versions-tabs.html
@@ -0,0 +1,61 @@
+<ul class="nav nav-tabs" role="tablist">
+  <!-- GMA SDK v12 Tab -->
+  <li class="nav-item ui-tab" role="presentation">
+    <button
+      class="nav-link active"
+      id="{{ include.id }}-gma12-tab"
+      data-toggle="tab"
+      data-target="#{{ include.id }}-gma12"
+      type="button"
+      role="tab"
+      aria-controls="gma12"
+      aria-selected="true"
+    >
+      GMA SDK v12
+    </button>
+  </li>
+  <!-- GMA SDK v11 Tab -->
+  <li class="nav-item ui-tab" role="presentation">
+    <button
+      class="nav-link"
+      id="{{ include.id }}-gma11-tab"
+      data-toggle="tab"
+      data-target="#{{ include.id }}-gma11"
+      type="button"
+      role="tab"
+      aria-controls="gma11"
+      aria-selected="false"
+    >
+      GMA SDK v11
+    </button>
+  </li>
+</ul>
+
+<div class="tab-content" id="gma-sdk-tab-content">
+  <!-- GMA SDK v12 Content -->
+  <div
+    class="tab-pane fade show active"
+    id="{{ include.id }}-gma12"
+    role="tabpanel"
+    aria-labelledby="{{ include.id }}-gma12-tab"
+  >
+    <div class="highlight">
+      <pre
+        class="highlight language-swift"
+      ><code class="language-swift">{{ include.gma12 | xml_escape }}</code></pre>
+    </div>
+  </div>
+  <!-- GMA SDK v11 Content -->
+  <div
+    class="tab-pane fade"
+    id="{{ include.id }}-gma11"
+    role="tabpanel"
+    aria-labelledby="{{ include.id }}-gma11-tab"
+  >
+    <div class="highlight">
+      <pre
+        class="highlight language-swift"
+      ><code class="language-swift">{{ include.gma11 | xml_escape }}</code></pre>
+    </div>
+  </div>
+</div>
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
index 60beae54c1..cc899357b9 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
@@ -5,6 +5,8 @@ description: Integrating Prebid SDK iOS with AdMob
 sidebarType: 2
 ---
 
+<!-- markdownlint-disable-file MD046 -->
+
 # Prebid SDK iOS with AdMob Integration Method
 {:.no_toc}
 
@@ -36,25 +38,53 @@ AdMobUtils.initializeGAD()
 
 ### Banners
 
-Integration example:
+**Integration example(Swift)**:
 
-```swift
-// 1. Create GADRequest and GADBannerView
+{% capture gma12 %}// 1. Create a GADRequest
+let gadRequest = Request()
+
+// 2. Create a BannerView
+gadBanner = GoogleMobileAds.BannerView(adSize: adSizeFor(cgSize: AD_SIZE))
+gadBanner.adUnitID = AD_UNIT_ID
+gadBanner.delegate = self
+gadBanner.rootViewController = self
+
+// Add GMA SDK banner view to the app UI
+bannerView.addSubview(gadBanner)
+
+// 3. Create an AdMobMediationBannerUtils
+mediationDelegate = AdMobMediationBannerUtils(gadRequest: gadRequest, bannerView: gadBanner)
+
+// 4. Create a MediationBannerAdUnit
+prebidAdMobMediaitonAdUnit = MediationBannerAdUnit(
+    configID: CONFIG_ID,
+    size: AD_SIZE,
+    mediationDelegate: mediationDelegate
+)
+
+// 5. Make a bid request to Prebid Server
+prebidAdMobMediaitonAdUnit.fetchDemand { [weak self] result in
+    PrebidDemoLogger.shared.info("Prebid demand fetch for AdMob \(result.name())")
+    
+    // 6. Load ad
+    self?.gadBanner.load(gadRequest)
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Create GADRequest and GADBannerView
 gadRequest = GADRequest()
 
-gadBanner = GADBannerView(adSize: size)
+gadBanner = GADBannerView(adSize: AD_SIZE)
 gadBanner.delegate = self
 gadBanner.rootViewController = self
     
-gadBanner.adUnitID = adUnitId
+gadBanner.adUnitID = AD_UNIT_ID
     
 // 2. Create an AdMobMediationBannerUtils
-mediationDelegate = AdMobMediationBannerUtils(gadRequest: gadRequest,
-                                              bannerView: gadBanner)
+mediationDelegate = AdMobMediationBannerUtils(gadRequest: gadRequest, bannerView: gadBanner)
     
 // 3. Create the MediationBannerAdUnit
-prebidAdMobMediaitonAdUnit = MediationBannerAdUnit(configID: configID,
-                                                   size: CGSize(width: 320, height: 50),
+prebidAdMobMediaitonAdUnit = MediationBannerAdUnit(configID: CONFIG_ID,
+                                                   size: AD_SIZE,
                                                    mediationDelegate: mediationDelegate)
     
 // 4. Make a bid request
@@ -63,9 +93,11 @@ prebidAdMobMediaitonAdUnit.fetchDemand { [weak self] result in
 // 5. Make an ad request to AdMob
     self?.gadBanner.load(self?.gadRequest)
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="admob-banner" gma11=gma11 gma12=gma12 %}
 
-#### Step 1: Create GADRequest and GADBannerView
+#### Step 1: Create Request and BannerView
 {:.no_toc}
 
 This step is the same as for the original [AdMob integration](https://developers.google.com/admob/ios/banner). You don't have to make any modifications here.
@@ -92,24 +124,58 @@ Make a regular AdMob's ad request. Everything else will be handled by Prebid ada
 
 ### Interstitials
 
-Integration example:
+**Integration example(Swift)**:
 
-```swift
+{% capture gma12 %}// 1. Create a Request
+let gadRequest = Request()
+
+// 2. Create an AdMobMediationInterstitialUtils
+let mediationDelegate = AdMobMediationInterstitialUtils(gadRequest: gadRequest)
+
+// 3. Create a MediationInterstitialAdUnit
+admobAdUnit = MediationInterstitialAdUnit(
+    configId: CONFIG_ID,
+    mediationDelegate: mediationDelegate
+)
+
+// 4. Make a bid request to Prebid Server
+admobAdUnit?.fetchDemand(completion: { [weak self] result in
+    PrebidDemoLogger.shared.info("Prebid demand fetch for AdMob \(result.name())")
+    
+    // 5. Load the interstitial ad
+    InterstitialAd.load(
+        with: AD_UNIT_ID,
+        request: gadRequest
+    ) { [weak self] ad, error in
+        guard let self = self else { return }
+        
+        if let error = error {
+            PrebidDemoLogger.shared.error("\(error.localizedDescription)")
+            return
+        }
+        
+        // 6. Present the interstitial ad
+        self.interstitial = ad
+        self.interstitial?.fullScreenContentDelegate = self
+        self.interstitial?.present(from: self)
+    }
+})
+{% endcapture %}
+{% capture gma11 %}
 // 1. Create GADRequest
 gadRequest = GADRequest()
 
 // 2. Create AdMobMediationInterstitialUtils
-mediationDelegate = AdMobMediationInterstitialUtils(gadRequest: self.gadRequest)
+let mediationDelegate = AdMobMediationInterstitialUtils(gadRequest: self.gadRequest)
 
 // 3. Create MediationInterstitialAdUnit
-admobAdUnit = MediationInterstitialAdUnit(configId: configID,
-                                          mediationDelegate: mediationDelegate!)
+admobAdUnit = MediationInterstitialAdUnit(configId: CONFIG_ID, mediationDelegate: mediationDelegate)
 
 // 4. Make a bid request
 admobAdUnit?.fetchDemand(completion: { [weak self]result in
     
 // 5. Make an ad request to AdMob
-GADInterstitialAd.load(withAdUnitID: adUnitID, request: self?.gadRequest) { [weak self] ad, error in
+GADInterstitialAd.load(withAdUnitID: AD_UNIT_ID, request: self?.gadRequest) { [weak self] ad, error in
     guard let self = self else { return }
     if let error = error {
         PBMLog.error(error.localizedDescription)
@@ -122,7 +188,9 @@ GADInterstitialAd.load(withAdUnitID: adUnitID, request: self?.gadRequest) { [wea
         self.interstitial?.present(fromRootViewController: self)
     }
 })
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="admob-banner" gma11=gma11 gma12=gma12 %}
 
 The **default** ad format for interstitial is **.banner**. In order to make a `multiformat bid request`, set the respective values into the `adFormats` property.
 
@@ -135,10 +203,9 @@ adUnit?.adFormats = [.video, .banner]
 
 // Make bid request for banner ad (default behaviour)                                     
 adUnit?.adFormats = [.banner]
-
 ```
 
-#### Step 1: Create GADRequest
+#### Step 1: Create Request
 {:.no_toc}
 
 This step is the same as for the original [AdMob integration](https://developers.google.com/admob/ios/interstitial#swift). You don't have to make any modifications here.
@@ -170,24 +237,63 @@ Once you receive the ad it will be ready for display. Follow the [AdMob instruct
 
 ### Rewarded Video
 
-Integration example:
+**Integration example(Swift)**:
 
-```swift
-// 1. Create GADRequest
+{% capture gma12 %}// 1. Create a Request
+let request = Request()
+
+// 2. Create an AdMobMediationRewardedUtils
+mediationDelegate = AdMobMediationRewardedUtils(gadRequest: request)
+
+// 3. Create a MediationRewardedAdUnit
+admobRewardedAdUnit = MediationRewardedAdUnit(
+    configId: CONFIG_ID,
+    mediationDelegate: mediationDelegate
+)
+
+// 4. Make a bid request to Prebid Server
+admobRewardedAdUnit.fetchDemand { [weak self] result in
+    guard let self = self else { return }
+    PrebidDemoLogger.shared.info("Prebid demand fetch for AdMob \(result.name())")
+    
+    // 5. Load the rewarded ad
+    RewardedAd.load(with: AD_UNIT_ID, request: request) { [weak self] ad, error in
+        guard let self = self else { return }
+        
+        if let error = error {
+            Log.error(error.localizedDescription)
+            return
+        }
+        
+        // 6. Present the rewarded ad
+        self.gadRewardedAd = ad
+        self.gadRewardedAd?.fullScreenContentDelegate = self
+        DispatchQueue.main.asyncAfter(deadline: .now() + .seconds(3)) {
+            self.gadRewardedAd?.present(
+                from: self,
+                userDidEarnRewardHandler: {
+                    print("User did earn reward.")
+                }
+            )
+        }
+    }
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Create GADRequest
 let request = GADRequest()
 
 // 2. Create AdMobMediationInterstitialUtils
 let mediationDelegate = AdMobMediationRewardedUtils(gadRequest: request)
 
 // 3. Create MediationInterstitialAdUnit
-admobRewardedAdUnit = MediationRewardedAdUnit(configId: "12f58bc2-b664-4672-8d19-638bcc96fd5c", mediationDelegate: mediationDelegate)
+admobRewardedAdUnit = MediationRewardedAdUnit(configId: CONFIG_ID, mediationDelegate: mediationDelegate)
 
 // 4. Make a bid request
 admobRewardedAdUnit.fetchDemand { [weak self] result in
     guard let self = self else { return }
 
 // 5. Make an ad request to AdMob
-GADRewardedAd.load(withAdUnitID: self.admobPrebidAdUnitId, request: request) { [weak self] ad, error in
+GADRewardedAd.load(withAdUnitID: AD_UNIT_ID, request: request) { [weak self] ad, error in
     guard let self = self else { return }
     if let error = error {
         PBMLog.error(error.localizedDescription)
@@ -204,13 +310,15 @@ GADRewardedAd.load(withAdUnitID: self.admobPrebidAdUnitId, request: request) { [
     }
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="admob-rewarded" gma11=gma11 gma12=gma12 %}
 
 The process of displaying the rewarded ad is the same as for displaying an Interstitial Ad.
 
 To be notified when a user earns a reward follow the [AdMob intructions](https://developers.google.com/admob/ios/rewarded#show_the_ad).
 
-#### Step 1: Create GADRequest
+#### Step 1: Create Request
 {:.no_toc}
 
 This step is the same as for the original [AdMob integration](https://developers.google.com/admob/ios/rewarded). You don't have to make any modifications here.
@@ -247,10 +355,46 @@ Once the rewarded ad is received you can display it. Follow the [AdMob instructi
 
 In order to integrate AdMob adapters just add the adapters' source files to your app project.
 
-Integration example:
+**Integration example(Swift)**:
 
-```swift
-// 1. Create GAD Request
+{% capture gma12 %}// 1. Create a Request
+let gadRequest = Request()
+
+// 2. Create an AdMobMediationNativeUtils
+mediationDelegate = AdMobMediationNativeUtils(gadRequest: gadRequest)
+
+// 3. Create a MediationNativeAdUnit
+admobMediationNativeAdUnit = MediationNativeAdUnit(
+    configId: CONFIG_ID,
+    mediationDelegate: mediationDelegate
+)
+
+// 4. Configure MediationNativeAdUnit
+admobMediationNativeAdUnit.addNativeAssets(nativeRequestAssets)
+admobMediationNativeAdUnit.setContextType(.Social)
+admobMediationNativeAdUnit.setPlacementType(.FeedContent)
+admobMediationNativeAdUnit.setContextSubType(.Social)
+admobMediationNativeAdUnit.addEventTracker(eventTrackers)
+
+// 5. Make a bid request to Prebid Server
+admobMediationNativeAdUnit.fetchDemand { [weak self] result in
+    guard let self = self else { return }
+    PrebidDemoLogger.shared.info("Prebid demand fetch for AdMob \(result.name())")
+    
+    // 6. Load the native ad
+    self.adLoader = AdLoader(
+        adUnitID: AD_UNIT_ID,
+        rootViewController: self,
+        adTypes: [ .native ],
+        options: nil
+    )
+    
+    self.adLoader?.delegate = self
+    
+    self.adLoader?.load(gadRequest)
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Create GAD Request
 gadRequest = GADRequest()
 
 // 2. Create AdMobMediationNativeUtils
@@ -272,24 +416,26 @@ nativeAdUnit.addEventTracker(eventTrackers)
 
 // 6. Make a bid request
 nativeAdUnit.fetchDemand { [weak self] result in
-guard let self = self else { return }
+    guard let self = self else { return }
 
-// 7. Load AdMob Native ad
-self.adLoader = GADAdLoader(adUnitID: self.adMobAdUnitId!,
-                            rootViewController: self.rootController,
-                            adTypes: [ .native ],
-                            options: nil)
+    // 7. Load AdMob Native ad
+    self.adLoader = GADAdLoader(adUnitID: AD_UNIT_ID,
+                                rootViewController: self.rootController,
+                                adTypes: [ .native ],
+                                options: nil)
 
-self.adLoader?.delegate = self
+    self.adLoader?.delegate = self
 
-self.adLoader?.load(self.gadRequest)
+    self.adLoader?.load(self.gadRequest)
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="admob-native" gma11=gma11 gma12=gma12 %}
 
-#### Step 1: Create GAD Request
+#### Step 1: Create a Request
 {:.no_toc}
 
-Prepare the `GADRequest` object before you make a bid request. It will be needed for the Prebid mediation utils.
+Prepare the `Request` object before you make a bid request. It will be needed for the Prebid mediation utils.
 
 #### Step 2: Create AdMobMediationNativeUtils
 {:.no_toc}
@@ -335,8 +481,7 @@ The example of creating the event trackers array:
 
 ```swift
 let eventTrackers = [
-    NativeEventTracker(event: EventType.Impression,
-                       methods: [EventTracking.Image,EventTracking.js])
+    NativeEventTracker(event: EventType.Impression, methods: [EventTracking.Image,EventTracking.js])
 ]
 ```
 
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md b/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
index 6610406e66..d6198673c1 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
@@ -5,6 +5,8 @@ description: Integration of Prebid Rendering module whith Google Ad Manager
 sidebarType: 2
 ---
 
+<!-- markdownlint-disable-file MD046 -->
+
 # Prebid SDK iOS with the GAM Prebid-Rendered Integration Method
 {:.no_toc}
 
@@ -109,9 +111,9 @@ GAM setup:
 
 Integration:
 
-1. Replace the `GAMBannerView` with `BannerView` in the UI. 
+1. Replace the `AdManagerBannerView` with `BannerView` in the UI. 
 2. Implement the protocol `BannerViewDelegate` in the ViewController.
-3. Remove usage of `GAMBannerView`, `GAMRequest`, and implementation of the `GADBannerViewDelegate`.
+3. Remove usage of `AdManagerBannerView`, `AdManagerRequest`, and implementation of the `GoogleMobileAds.BannerViewDelegate`.
 4. Remove original `BannerAdUnit`.
 5. Follow the instructions to integrate [Banner API](#banners).
 
@@ -124,9 +126,9 @@ Integration example:
 let eventHandler = GAMInterstitialEventHandler(adUnitID: GAM_AD_UNIT_ID)
     
 // 2. Create Interstitial Ad Unit
-interstitial = InterstitialRenderingAdUnit  (configID: CONFIG_ID,
-                                  minSizePercentage: CGSize(width: 30, height: 30),
-                                  eventHandler: eventHandler)
+interstitial = InterstitialRenderingAdUnit(configID: CONFIG_ID,
+                                           minSizePercentage: MIN_SIZE_PERC,
+                                           eventHandler: eventHandler)
     
 interstitial.delegate = self
     
@@ -200,9 +202,9 @@ GAM setup:
 
 Integration:
 
-1. Replace the `GAMInterstitialAd` with `InterstitialRenderingAdUnit` in the View Controller. 
+1. Replace the `AdManagerInterstitialAd` with `InterstitialRenderingAdUnit` in the View Controller. 
 2. Implement the protocol `InterstitialAdUnitDelegate` in the View Controller.
-3. Remove usage of `GAMInterstitialAd`, `GAMRequest`.
+3. Remove usage of `AdManagerInterstitialAd`, `AdManagerRequest`.
 4. Remove original `InterstitialAdUnit`.
 5. Follow the instructions to integrate [Interstitial API](#interstitials).
 
@@ -215,8 +217,7 @@ Integration example:
 let eventHandler = GAMRewardedEventHandler(adUnitID: GAM_AD_UNIT_ID)
     
 // 2. Create an Ad Unit
-rewardedAd = RewardedAdUnit(configID: CONFIG_ID,
-                               eventHandler: eventHandler)
+rewardedAd = RewardedAdUnit(configID: CONFIG_ID, eventHandler: eventHandler)
     
 rewardedAd.delegate = self
     
@@ -242,11 +243,16 @@ To be notified when a user earns a reward - implement the method of `RewardedAdU
 
 The reward object is stored in the `RewardedAdUnit`:
 
-```swift
-if let reward = rewardedAd.reward as? GADAdReward {
+{% capture gma12 %}if let reward = rewardedAd.reward as? GoogleMobileAds.AdReward {
     // ...
 }
-```
+{% endcapture %}
+{% capture gma11 %}if let reward = rewardedAd.reward as? GADAdReward {
+    // ...
+}
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="gam-reward" gma11=gma11 gma12=gma12 %}
 
 #### Step 1: Create Event Handler
 {:.no_toc}
@@ -289,9 +295,9 @@ GAM setup:
 
 Integration:
 
-1. Replace the `GADRewardedAd` with `RewardedAdUnit` in the View Controller. 
+1. Replace the `RewardedAd` with `RewardedAdUnit` in the View Controller. 
 2. Implement the protocol `RewardedAdUnitDelegate` in the View Controller.
-3. Remove usage of `GAMRequest`.
+3. Remove usage of `AdManagerRequest`.
 4. Remove original `RewardedVideoAdUnit`.
 5. Follow the instructions to integrate [Rewarded API](#rewarded-video).
 
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index c8d2f08932..84b9f03fe7 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -8,6 +8,8 @@ nav_section: prebid-mobile-ios
 sidebarType: 2
 ---
 
+<!-- markdownlint-disable-file MD046 -->
+
 # Prebid SDK Integration for iOS
 {:.no_toc}
 
@@ -123,8 +125,24 @@ Once you set the account ID and the Prebid Server host, you should initialize th
 
 If you integrate Prebid Mobile with GMA SDK with version equal or higher than 10.7.0, use the following initializer, which checks the compatibility of Prebid SDK with GMA SDK used in the app:
 
-```swift
-Prebid.initializeSDK(gadMobileAdsVersion: GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber) { status, error in
+{% capture gma12 %}Prebid.initializeSDK(gadMobileAdsVersion: string(for: MobileAds.shared.versionNumber)) { status, error in
+    switch status {
+    case .succeeded:
+        print("Prebid SDK successfully initialized")
+    case .failed:
+        if let error = error {
+            print("An error occurred during Prebid SDK initialization: \(error.localizedDescription)")
+        }
+    case .serverStatusWarning:
+        if let error = error {
+            print("Prebid Server status checking failed: \(error.localizedDescription)")
+        }
+    default:
+        break
+    }            
+}   
+{% endcapture %}
+{% capture gma11 %}Prebid.initializeSDK(gadMobileAdsVersion: GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber) { status, error in
     switch status {
     case .succeeded:
         print("Prebid SDK successfully initialized")
@@ -140,7 +158,9 @@ Prebid.initializeSDK(gadMobileAdsVersion: GADGetStringFromVersionNumber(GADMobil
         break
     }            
 }            
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="pbm-init" gma11=gma11 gma12=gma12 %}
 
 If you integrate Prebid Mobile with GMA SDK with version lower than 10.7.0, use the following initializer:
 
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index d5c12d4f9b..b3da208e65 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -572,7 +572,7 @@ let globalORTB = """
         }
     },
     "displaymanager": "Google",
-    "displaymanagerver": "\(GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber))"
+    "displaymanagerver": "\(string(for: MobileAds.shared.versionNumber))"
 }
 """
 
diff --git a/prebid-mobile/pbm-api/ios/pbm-util-ios.md b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
index 5b4a64776b..f823559914 100755
--- a/prebid-mobile/pbm-api/ios/pbm-util-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
@@ -23,8 +23,19 @@ It is recommended all Google Ad Manager integrations resize all ads served based
 
 Usage example:
 
-```swift
-func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
+{% capture gma12 %}
+func bannerViewDidReceiveAd(_ bannerView: GoogleMobileAds.BannerView) {
+    AdViewUtils.findPrebidCreativeSize(bannerView, success: { size in
+        guard let bannerView = bannerView as? AdManagerBannerView else { return }
+
+        // In the case of Prebid's line item - resize te ad view
+        bannerView.resize(adSizeFor(cgSize: size))
+    }, failure: { (error) in
+        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+    })
+}
+{% endcapture %}
+{% capture gma11 %}func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
 
     // Determine the kind of winning line item
     AdViewUtils.findPrebidCreativeSize(bannerView, success: { size in
@@ -36,7 +47,6 @@ func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
         PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
     })
 }
-```
-
-
+{% endcapture %}
 
+{% include code/gma-versions-tabs.html id="pbm-utils" gma11=gma11 gma12=gma12 %}
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
index 140a8c6b19..b205ea09a7 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
@@ -4,21 +4,50 @@ title: iOS GAM Bidding-Only Integration - HTML Banner
 description: iOS GAM Bidding-Only Integration - HTML Banner
 sidebarType: 2
 ---
-
+<!-- markdownlint-disable-file MD037 -->
 # iOS GAM Bidding-Only Integration - HTML Banner
 
 Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#adunit-specific-instructions)
 
 To integrate HTML banner ads into the app you should use the `BannerAdUnit` class. It makes bid requests to Prebid Server and provides targeting keywords for the winning bid(s) to the GMA SDK.
 
-Integration example:
+**Integration example(Swift):**
 
-```swift
-func createAd() {
+{% capture gma12 %}func createAd() {
     // 1. Create a BannerAdUnit using Prebid Mobile SDK
-    adUnit = BannerAdUnit(configId: CONFIG_ID, size: adSize)
+    adUnit = BannerAdUnit(configId: CONFIG_ID, size: AD_SIZE)
     adUnit.setAutoRefreshMillis(time: 30000)
-    adUnit.addAdditionalSize(adSize2)
+    adUnit.addAdditionalSize(AD_SIZE_2)
+    
+    // 2. Configure banner parameters using Prebid Mobile SDK
+    let parameters = BannerParameters()
+    parameters.api = [Signals.Api.MRAID_2, Signals.Api.OMID_1]
+    adUnit.parameters = parameters
+    
+    // 3. Create an AdManagerBannerView using Google Mobile Ads SDK
+    gamBanner = AdManagerBannerView(adSize: adSizeFor(cgSize: AD_SIZE))
+    gamBanner.adUnitID = AD_UNIT_ID
+    gamBanner.rootViewController = self
+    gamBanner.delegate = self
+    
+    // Add GMA SDK banner view to the app UI
+    bannerView?.addSubview(gamBanner)
+    
+    // 4. Make a bid request to Prebid Server using Prebid Mobile SDK
+    let gamRequest = AdManagerRequest()
+    adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+        DemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+        
+        // 5. Load GAM Ad using Google Mobile Ads SDK
+        self?.gamBanner.load(gamRequest)
+    }
+}
+{% endcapture %}
+{% capture gma11 %}func createAd() {
+    // 1. Create a BannerAdUnit using Prebid Mobile SDK
+    adUnit = BannerAdUnit(configId: CONFIG_ID, size: AD_SIZE)
+    adUnit.setAutoRefreshMillis(time: 30000)
+    adUnit.addAdditionalSize(AD_SIZE_2)
     
     // 2. Configure banner parameters using Prebid Mobile SDK
     let parameters = BannerParameters()
@@ -26,7 +55,7 @@ func createAd() {
     adUnit.parameters = parameters
     
     // 3. Create a GAMBannerView using Google Mobile Ads SDK
-    gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(adSize))
+    gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
     gamBanner.adUnitID = AD_UNIT_ID
     gamBanner.rootViewController = self
     gamBanner.delegate = self
@@ -43,14 +72,24 @@ func createAd() {
         self?.gamBanner.load(gamRequest)
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="html-banner" gma11=gma11 gma12=gma12 %}
 
-If you want to support several ad sizes, you also need to implement `GADBannerViewDelegate` to adjust banner view size according to the creative size.
+If you want to support several ad sizes, you also need to implement `GoogleMobileAds.BannerViewDelegate` to adjust banner view size according to the creative size.
 
 In case you use a single-size banner (e.g., 300x250), you don't need to make a call to the `AdViewUtils.findPrebidCreativeSize` routine because you already know the size of the creative. However, you still need to call `bannerView.resize` because the creative in GMA has a default size of 1x1, and without this call, it will be rendered as a pixel.
 
-```swift
-func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
+{% capture gma12 %}func bannerViewDidReceiveAd(_ bannerView: GoogleMobileAds.BannerView) {
+    AdViewUtils.findPrebidCreativeSize(bannerView, success: { size in
+        guard let bannerView = bannerView as? AdManagerBannerView else { return }
+        bannerView.resize(adSizeFor(cgSize: size))
+    }, failure: { (error) in
+        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+    })
+}
+{% endcapture %}
+{% capture gma11 %}func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
     // 6. Resize ad view if needed (Prebid Mobile SDK)
     AdViewUtils.findPrebidCreativeSize(bannerView, success: { size in
         guard let bannerView = bannerView as? GAMBannerView else { return }
@@ -59,7 +98,9 @@ func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
         // The received ad is not Prebid’s one 
     })
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="html-banner-did-receive-ad-callback" gma11=gma11 gma12=gma12 %}
 
 {: .alert.alert-info :}
 Make sure you process all possible cases in the  `AdViewUtils.findPrebidCreativeSize` callbacks (both success and failure).  Sometimes you might not get the size of the creative (or a failure callback) - it simply means that this is not a Prebid creative.  It means that you still need to render the creative, but you most likely don’t need to resize it.
@@ -77,35 +118,26 @@ If you need to bid on other ad sizes as well use `addAdditionalSize()` method to
 
 {% include mobile/banner-params.md %}
 
-## Step 3: Create a GAMBannerView
+## Step 3: Create a AdManagerBannerView
 
 Follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner) to integrate a banner ad unit. 
 
 ## Step 4: Make the bid request
 
-The _fetchDemand_ method makes a bid request to the Prebid Server. The `GAMRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
+The _fetchDemand_ method makes a bid request to the Prebid Server. The `AdManagerRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
 
 When Prebid Server responds, Prebid SDK will set the targeting keywords of the winning bid into provided object.
 
 ## Step 5: Call the ad server
 
-Next, request the ad from GAM. If the `GAMRequest` object contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
+Next, request the ad from GAM. If the `AdManagerRequest` object contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
 
-Ensure that you call the _load_ method with the same `GAMRequest` object that you passed to the _fetchDemand_ method on the previous step. Otherwise, the ad request won't contain targeting keywords, and Prebid bids won't be displayed.
+Ensure that you call the _load_ method with the same `AdManagerRequest` object that you passed to the _fetchDemand_ method on the previous step. Otherwise, the ad request won't contain targeting keywords, and Prebid bids won't be displayed.
 
 ## Step 6: Adjust the ad view size
 
 Once an app receives a signal that an ad is loaded, you should use the method `AdViewUtils.findPrebidCreativeSize` to verify whether it's Prebid Server’s ad and resize the ad slot respectively to the creative's properties. 
 
-```swift
-// GMA SDK functions
-func validBannerSizes(for adLoader: GADAdLoader) -> [NSValue] {
-    return [NSValueFromGADAdSize(GADAdSizeFromCGSize(adSize))]
-}
-```
-
-The function above provides valid banner sizes for the ad loader. Adjust it according to the size of your ad.
-
 ## Further Reading
 
 - [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-banner.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-banner.md
index b09aa637f1..1f49df96f7 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-banner.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-banner.md
@@ -13,11 +13,40 @@ To integrate an interstitial banner ad into the app you use the Prebid SDK `Inte
 
 **Integration example(Swift):**
 
-```swift
-func createAd() {
+{% capture gma12 %}func createAd() {
+    // 1. Create an InterstitialAdUnit
+    adUnit = InterstitialAdUnit(
+        configId: CONFIG_ID,
+        minWidthPerc: MIN_WIDTH_PERC,
+        minHeightPerc: MIN_HEIGHT_PERC
+    )
+    
+    // 2. Make a bid request to Prebid Server
+    let gamRequest = AdManagerRequest()
+    adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+        PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+        
+        // 3. Load a GAM interstitial ad
+        AdManagerInterstitialAd.load(
+            with: AD_UNIT_ID,
+            request: gamRequest
+        ) { ad, error in
+            guard let self = self else { return }
+            
+            if let error = error {
+                PrebidDemoLogger.shared.error("Failed to load interstitial ad with error: \(error.localizedDescription)")
+            } else if let ad = ad {
+                // 4. Present the interstitial ad
+                ad.fullScreenContentDelegate = self
+                ad.present(from: self)
+            }
+        }
+    }
+}
+{% endcapture %}
+{% capture gma11 %}func createAd() {
     // 1. Create an InterstitialAdUnit using Prebid Mobile SDK
-    adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: 75, minHeightPerc: 75)
-    adUnit.adUnitConfig.adSize = CGSize(width: 1, height: 1)
+    adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: MIN_WIDTH_PERC, minHeightPerc: MIN_WIDTH_PERC)
     
     // 2. Make a bid request to Prebid Server using Prebid Mobile SDK
     let gamRequest = GAMRequest()
@@ -38,7 +67,9 @@ func createAd() {
         }
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="interstitial-banner" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create an Ad Unit
 
@@ -53,13 +84,13 @@ Here's how min size percentages work. If the adunit size is 1x1, Prebid Server u
 
 ## Step 2: Make the bid request
 
-The _fetchDemand_ method makes a bid request to the Prebid Server. The `GAMRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
+The _fetchDemand_ method makes a bid request to the Prebid Server. The `AdManagerRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
 
 When Prebid Server responds, Prebid SDK will set the targeting keywords of the winning bid into provided object.
 
 ## Step 3: Load a GAM interstitial ad
 
-After receiving a bid it's time to load the ad from GAM. If the `GAMRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
+After receiving a bid it's time to load the ad from GAM. If the `AdManagerRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
 
 ## Step 4: Render the interstitial ad
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
index 1b63cac078..f01db9baf7 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
@@ -9,63 +9,106 @@ sidebarType: 2
 
 Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#adunit-specific-instructions)
 
-To integrate Video Interstitial ads into the app you should use the Prebid SDK `VideoInterstitialAdUnit` class. It makes bid requests to Prebid Server and provides targeting keywords of the winning bid to the GMA SDK.
+To integrate Video Interstitial ads into the app you should use the Prebid SDK `InterstitialAdUnit` class. It makes bid requests to Prebid Server and provides targeting keywords of the winning bid to the GMA SDK.
 
-**Integration Example:**
+**Integration example(Swift):**
 
-```swift
-func createAd() {
-    // 1. Create a VideoInterstitialAdUnit using Prebid Mobile SDK
-    adUnit = VideoInterstitialAdUnit(configId: CONFIG_ID)
+{% capture gma12 %}func createAd() {
+    // 1. Create an InterstitialAdUnit
+    adUnit = InterstitialAdUnit(configId: CONFIG_ID)
     
-    // 2. Configure video parameters using Prebid Mobile SDK
+    // 2. Set ad format
+    adUnit.adFormats = [.video]
+    
+    // 3. Configure video parameters
+    let parameters = VideoParameters(mimes: ["video/mp4"])        
+    parameters.protocols = [Signals.Protocols.VAST_2_0]
+    parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOff]
+    adUnit.videoParameters = parameters
+    
+    // 4. Make a bid request to Prebid Server
+    let gamRequest = AdManagerRequest()
+    adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+        PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+        
+        // 5. Load a GAM interstitial ad
+        AdManagerInterstitialAd.load(
+            with: AD_UNIT_ID,
+            request: gamRequest
+        ) { ad, error in
+            guard let self = self else { return }
+            if let error = error {
+                PrebidDemoLogger.shared.error("Failed to load interstitial ad with error: \(error.localizedDescription)")
+            } else if let ad = ad {
+                // 6. Present the interstitial ad
+                ad.present(from: self)
+                ad.fullScreenContentDelegate = self
+            }
+        }
+    }
+}
+{% endcapture %}
+{% capture gma11 %}func createAd() {
+    // 1. Create a InterstitialAdUnit using Prebid Mobile SDK
+    adUnit = InterstitialAdUnit(configId: CONFIG_ID)
+
+    // 2. Set ad format
+    adUnit.adFormats = [.video]
+    
+    // 3. Configure video parameters using Prebid Mobile SDK
     let parameters = VideoParameters()
     parameters.mimes = ["video/mp4"]
     parameters.protocols = [Signals.Protocols.VAST_2_0]
     parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOn]
     adUnit.parameters = parameters
     
-    // 3. Make a bid request to Prebid Server using Prebid Mobile SDK
+    // 4. Make a bid request to Prebid Server using Prebid Mobile SDK
     let gamRequest = GAMRequest()
     adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
         DemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
         
-        // 4. Load a GAM interstitial ad using Google Mobile Ads SDK
+        // 5. Load a GAM interstitial ad using Google Mobile Ads SDK
         GAMInterstitialAd.load(withAdManagerAdUnitID: AD_UNIT_ID, request: gamRequest) { ad, error in
             guard let self = self else { return }
             if let error = error {
                 DemoLogger.shared.error("Failed to load interstitial ad with error: \(error.localizedDescription)")
             } else if let ad = ad {
-                // 5. Immediately render the interstitial ad
+                // 6. Immediately render the interstitial ad
                 ad.present(fromRootViewController: self)
                 ad.fullScreenContentDelegate = self
             }
         }
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="interstitial-video" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create an Ad Unit
 
-Initialize the `VideoInterstitialAdUnit` with properties:
+Initialize the `InterstitialAdUnit` with properties:
 
 - `configId` - an ID of the Ad Unit Level Stored Request on Prebid Server
 
-## Step 2: Configure video parameters
+## Step 2: Set the ad format
+
+Set the desired ad formats using `adFormats` property.
+
+## Step 3: Configure video parameters
 
 {% include mobile/video-params.md %}
 
-## Step 3: Make the bid request
+## Step 4: Make the bid request
 
-The _fetchDemand_ method makes a bid request to the Prebid Server. The `GAMRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
+The _fetchDemand_ method makes a bid request to the Prebid Server. The `AdManagerRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
 
 When Prebid Server responds, Prebid SDK will set the targeting keywords of the winning bid into provided object.
 
-## Step 4: Load a GAM interstitial ad
+## Step 5: Load a GAM interstitial ad
 
-After receiving a bid it's time to load the ad from GAM. If the `GAMRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
+After receiving a bid it's time to load the ad from GAM. If the `AdManagerRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
 
-## Step 5: Render the interstitial ad
+## Step 6: Render the interstitial ad
 
 Follow the [GMA SDK guide](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/interstitial#display_the_ad) to display the interstitial ad. Note that you'll need to decide whether it's going to be rendered immediately after receiving it or rendered later in the flow of an app. Note that the example above implements an immediate render approach.
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat-interstitial.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat-interstitial.md
index debd6a4b7e..8dd9c3ca44 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat-interstitial.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat-interstitial.md
@@ -9,12 +9,45 @@ sidebarType: 2
 
 Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#adunit-specific-instructions)
 
-Integration example:
+**Integration example(Swift):**
 
-``` swift
-// 1. Create an InterstitialAdUnit
-adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: 60, minHeightPerc: 70)
-adUnit.adUnitConfig.adSize = CGSize(width: 1, height: 1)
+{% capture gma12 %}// 1. Create an InterstitialAdUnit
+adUnit = InterstitialAdUnit(
+    configId: CONFIG_ID,
+    minWidthPerc: MIN_WIDTH_PERC,
+    minHeightPerc: MIN_HEIGHT_PERC
+)
+
+// 2. Set adFormats
+adUnit.adFormats = [.banner, .video]
+
+// 3. Configure video parameters
+let parameters = VideoParameters(mimes: ["video/mp4"])
+parameters.protocols = [Signals.Protocols.VAST_2_0]
+parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOff]
+adUnit.videoParameters = parameters
+
+// 4. Make a bid request to Prebid Server
+let gamRequest = AdManagerRequest()
+adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+    PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+    
+    // 5. Load a GAM interstitial ad
+    InterstitialAd.load(with: AD_UNIT_ID, request: gamRequest) { ad, error in
+        guard let self = self else { return }
+        
+        if let error = error {
+            PrebidDemoLogger.shared.error("Failed to load interstitial ad with error: \(error.localizedDescription)")
+        } else if let ad = ad {
+            // 5. Present the interstitial ad
+            ad.fullScreenContentDelegate = self
+            ad.present(from: self)
+        }
+    }
+}
+{% endcapture %}
+{% capture gma11 %} // 1. Create an InterstitialAdUnit
+adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: MIN_WIDTH_PERC, minHeightPerc: MIN_HEIGHT_PERC)
 
 // 2. Set adFormats
 adUnit.adFormats = [.banner, .video]
@@ -31,7 +64,7 @@ adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
     PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
 
     // 5. Load a GAM interstitial ad
-    GAMInterstitialAd.load(withAdManagerAdUnitID: gamAdUnitMultiformatInterstitialOriginal, request: gamRequest) { ad, error in
+    GAMInterstitialAd.load(withAdManagerAdUnitID: AD_UNIT_ID, request: gamRequest) { ad, error in
         guard let self = self else { return }
 
         if let error = error {
@@ -43,12 +76,14 @@ adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
         }
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="multiformat-interstitial" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create an InterstitialAdUnit
 {:.no_toc}
 
-Initialize the InterstitialAdUnit with the following properties:
+Initialize the `InterstitialAdUnit` with the following properties:
 
 - `configId` - an ID of Stored Impression on the Prebid Server
 - `minWidthPerc`: Optional parameter to specify the minimum width percent an ad may occupy of a device's real estate. Support in SDK version 1.2+
@@ -77,14 +112,14 @@ For multiformat ad unit, you must set both banner and video ad formats.
 ## Step 4: Make a bid request
 {:.no_toc}
 
-The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `GAMRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `AdManagerRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
 
 ## Step 5: Load a GAM interstitial ad
 {:.no_toc}
 
-You should now request the ad from GAM. If the `GAMRequest` contains targeting keywords. The respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
+You should now request the ad from GAM. If the `AdManagerRequest` contains targeting keywords. The respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
 
-Be sure that you make the ad request with the same `GAMRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
+Be sure that you make the ad request with the same `AdManagerRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
 
 ## Step 6: Present the interstitial ad
 {:.no_toc}
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
index 0371065fa4..9340f40d92 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
@@ -4,6 +4,7 @@ title: iOS GAM Bidding-Only Integration - Multiformat Banner+Video+InAppNative
 description: iOS GAM Bidding-Only Integration - Multiformat Banner+Video+InAppNative
 sidebarType: 2
 ---
+<!-- markdownlint-disable-file MD046 -->
 
 # iOS GAM Bidding-Only Integration - Multiformat Banner+Video+InAppNative
 
@@ -13,10 +14,57 @@ Starting with version `2.1.5` Prebid SDK supports the fully multiformat ad unit.
 
 The following code demonstrates the integration of multiformat ad unit.
 
-``` swift
-func createAd() {
+{% capture gma12 %}func createAd() {
     // 1. Setup a PrebidAdUnit
-    adUnit = PrebidAdUnit(configId: configId)
+    adUnit = PrebidAdUnit(configId: CONFIG_ID)
+    adUnit.setAutoRefreshMillis(time: 30_000)
+    
+    // 2. Setup the parameters
+    let bannerParameters = BannerParameters()
+    bannerParameters.api = [Signals.Api.MRAID_2]
+    bannerParameters.adSizes = [adSize]
+    
+    let videoParameters = VideoParameters(mimes: ["video/mp4"])
+    videoParameters.protocols = [Signals.Protocols.VAST_2_0]
+    videoParameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOff]
+    videoParameters.placement = Signals.Placement.InBanner
+    videoParameters.adSize = adSize
+    
+    let nativeParameters = NativeParameters()
+    nativeParameters.assets = nativeAssets
+    nativeParameters.context = ContextType.Social
+    nativeParameters.placementType = PlacementType.FeedContent
+    nativeParameters.contextSubType = ContextSubType.Social
+    nativeParameters.eventtrackers = eventTrackers
+    
+    // 3. Configure the PrebidRequest
+    let prebidRequest = PrebidRequest(
+        bannerParameters: bannerParameters,
+        videoParameters: videoParameters,
+        nativeParameters: nativeParameters
+    )
+    
+    // 4. Make a bid request
+    let gamRequest = AdManagerRequest()
+    adUnit.fetchDemand(adObject: gamRequest, request: prebidRequest) { [weak self] _ in
+        guard let self = self else { return }
+        
+        // 5. Configure and make a GAM ad request
+        self.adLoader = AdLoader(
+            adUnitID: AD_UNIT_ID,
+            rootViewController: self,
+            adTypes: [AdLoaderAdType.customNative, AdLoaderAdType.adManagerBanner],
+            options: []
+        )
+        
+        self.adLoader.delegate = self
+        self.adLoader.load(gamRequest)
+    }
+}
+{% endcapture %}
+{% capture gma11 %}func createAd() {
+    // 1. Setup a PrebidAdUnit
+    adUnit = PrebidAdUnit(configId: CONFIG_ID)
     adUnit.setAutoRefreshMillis(time: 30_000)
 
     // 2. Setup the parameters
@@ -46,18 +94,35 @@ func createAd() {
         guard let self = self else { return }
 
         // 5. Configure and make a GAM ad request
-        self.adLoader = GADAdLoader(adUnitID: gamRenderingMultiformatAdUnitId, rootViewController: self,
+        self.adLoader = GADAdLoader(adUnitID: AD_UNIT_ID, rootViewController: self,
                                     adTypes: [GADAdLoaderAdType.customNative, GADAdLoaderAdType.gamBanner], options: [])
         self.adLoader.delegate = self
         self.adLoader.load(gamRequest)
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="multiformat-2" gma11=gma11 gma12=gma12 %}
 
 To handle the banner, video and in-banner native (Native Styles) ads:
 
-``` swift
-func adLoader(_ adLoader: GADAdLoader, didReceive bannerView: GAMBannerView) {
+{% capture gma12 %}func adLoader(_ adLoader: AdLoader, didReceive bannerView: AdManagerBannerView) {
+    self.bannerView.isHidden = false
+    self.nativeView.isHidden = true
+    self.bannerView.backgroundColor = .clear
+    self.bannerView.addSubview(bannerView)
+    
+    AdViewUtils.findPrebidCreativeSize(bannerView, success: { [weak self] size in
+        bannerView.resize(adSizeFor(cgSize: size))
+        
+        self?.bannerView.constraints.first { $0.firstAttribute == .width }?.constant = size.width
+        self?.bannerView.constraints.first { $0.firstAttribute == .height }?.constant = size.height
+    }, failure: { (error) in
+        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+    })
+}
+{% endcapture %}
+{% capture gma11 %}func adLoader(_ adLoader: GADAdLoader, didReceive bannerView: GAMBannerView) {
     self.bannerView.isHidden = false
     self.nativeView.isHidden = true
     self.bannerView.backgroundColor = .clear
@@ -72,7 +137,9 @@ func adLoader(_ adLoader: GADAdLoader, didReceive bannerView: GAMBannerView) {
         PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
     })
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="multiformat" gma11=gma11 gma12=gma12 %}
 
 If you use Custom Native Ads follow the [guide](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/native-banner) on how to implement processing of the ad response of the respective type. To handle the wining native ad:
 
@@ -151,9 +218,9 @@ In addition you can set the following properties of the `PrebidRequest`.
 ## Step 4: Make a bid request
 {:.no_toc}
 
-The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `GAMRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `AdManagerRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
 
-## Step 5: Create a GAMBannerView
+## Step 5: Create a BannerView
 {:.no_toc}
 
 Follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner) to integrate a banner ad unit.
@@ -161,9 +228,9 @@ Follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobi
 ## Step 6: Load an Ad
 {:.no_toc}
 
-Now you should request the ad from GAM. If the `GAMRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
+Now you should request the ad from GAM. If the `AdManagerRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
 
-Be sure that you make the ad request with the same `GAMRequest` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+Be sure that you make the ad request with the same `AdManagerRequest` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
 
 ## Step 7: Process the Ad Response
 {:.no_toc}
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-app.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-app.md
index 650a3baeea..98d48712b2 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-app.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-app.md
@@ -4,6 +4,7 @@ title: iOS GAM Bidding-Only Integration - Native In-App
 description: iOS GAM Bidding-Only Integration - Native In-App
 sidebarType: 2
 ---
+<!-- markdownlint-disable-file MD046 -->
 
 # iOS GAM Bidding-Only Integration - Native In-App
 
@@ -23,7 +24,7 @@ At a high level, the in-app workflow follows this sequence:
 The cached assets might expire. If this occurs the publisher will receive a notification and they will have to fetch the assets again.
 {% endcapture %}
 
-Integration Example:
+**Integration example(Swift):**
 
 ``` swift
 private var nativeRequestAssets: [NativeAsset] {
@@ -42,11 +43,90 @@ private var nativeRequestAssets: [NativeAsset] {
 }
 ```
 
-Then integrate the native style ad using GADAdLoader
+Then integrate the native style ad using `GoogleMobileAds.AdLoader`:
 
-``` swift
-// 1. Setup NativeRequest
-nativeUnit = NativeRequest(configId: storedPrebidImpression, assets: nativeRequestAssets)
+{% capture gma12 %}// 1. Setup a NativeRequest
+nativeUnit = NativeRequest(configId: CONFIG_ID, assets: nativeRequestAssets)
+
+// 2. Configure the NativeRequest
+nativeUnit.context = ContextType.Social
+nativeUnit.placementType = PlacementType.FeedContent
+nativeUnit.contextSubType = ContextSubType.Social
+nativeUnit.eventtrackers = eventTrackers
+
+// 3. Make a bid request
+nativeUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+    guard let self = self else { return }
+    
+    //4. Configure and make a GAM ad request
+    self.adLoader = AdLoader(
+        adUnitID: AD_UNIT_ID,
+        rootViewController: self,
+        adTypes: [AdLoaderAdType.customNative],
+        options: []
+    )
+    self.adLoader.delegate = self
+    self.adLoader.load(self.gamRequest)
+}
+
+.....
+
+// Step 4
+// MARK: GoogleMobileAds.CustomNativeAdLoaderDelegate
+    
+func customNativeAdFormatIDs(for adLoader: AdLoader) -> [String] {
+    [AD_FORMAT_ID]
+}
+
+func adLoader(_ adLoader: AdLoader, didReceive customNativeAd: CustomNativeAd) {
+    Utils.shared.delegate = self
+    Utils.shared.findNative(adObject: customNativeAd)
+}
+
+// Step 5
+// MARK: - NativeAdDelegate
+
+func nativeAdLoaded(ad: NativeAd) {
+    nativeAd = ad
+    titleLabel.text = ad.title
+    bodyLabel.text = ad.text
+
+    if let iconString = ad.iconUrl {
+        ImageHelper.downloadImageAsync(iconString) { result in
+            if case let .success(icon) = result {
+                DispatchQueue.main.async {
+                    self.iconView.image = icon
+                }
+            }
+        }
+    }
+
+    if let imageString = ad.imageUrl {
+        ImageHelper.downloadImageAsync(imageString) { result in
+            if case let .success(image) = result {
+                DispatchQueue.main.async {
+                    self.mainImageView.image = image
+                }
+            }
+        }
+    }
+
+    callToActionButton.setTitle(ad.callToAction, for: .normal)
+    sponsoredLabel.text = ad.sponsoredBy
+
+    nativeAd.registerView(view: view, clickableViews: [callToActionButton])
+}
+
+func nativeAdNotFound() {
+    PrebidDemoLogger.shared.error("Native ad not found")
+}
+
+func nativeAdNotValid() {
+    PrebidDemoLogger.shared.error("Native ad not valid")
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Setup NativeRequest
+nativeUnit = NativeRequest(configId: CONFIG_ID, assets: nativeRequestAssets)
 nativeUnit.context = ContextType.Social
 nativeUnit.placementType = PlacementType.FeedContent
 nativeUnit.contextSubType = ContextSubType.Social
@@ -57,7 +137,7 @@ nativeUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
     guard let self = self else { return }
 
     //3. Configure and make a GAM ad request
-    self.adLoader = GADAdLoader(adUnitID: gamRenderingNativeAdUnitId,rootViewController: self,
+    self.adLoader = GADAdLoader(adUnitID: AD_UNIT_ID, rootViewController: self,
                                 adTypes: [GADAdLoaderAdType.customNative], options: [])
     self.adLoader.delegate = self
     self.adLoader.load(self.gamRequest)
@@ -69,7 +149,7 @@ nativeUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
 // MARK: GADCustomNativeAdLoaderDelegate
 
 func customNativeAdFormatIDs(for adLoader: GADAdLoader) -> [String] {
-    ["11934135"]
+    [AD_FORMAT_ID]
 }
 
 func adLoader(_ adLoader: GADAdLoader, didReceive customNativeAd: GADCustomNativeAd) {
@@ -118,7 +198,9 @@ func nativeAdNotFound() {
 func nativeAdNotValid() {
     PrebidDemoLogger.shared.error("Native ad not valid")
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="native-in-app" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create a NativeRequest
 {:.no_toc}
@@ -165,21 +247,21 @@ Initialize the `NativeRequest` with properties:
 ## Step 2: Make a bid request
 {:.no_toc}
 
-The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `GAMRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `AdManagerRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
 
 ## Step 3: Configure and make a GAM ad request
 {:.no_toc}
 
-Prepare the `GADAdLoader` and run ad request as described in the GMA SDK docs for the [native ads](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/native/start).
+Prepare the `AdLoader` and run ad request as described in the GMA SDK docs for the [native ads](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/native/start).
 
-If the `GAMRequest` contains targeting keywords the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
+If the `AdManagerRequest` contains targeting keywords the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
 
-Be sure that you make the ad request with the same `GAMRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
+Be sure that you make the ad request with the same `AdManagerRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
 
-## Step 4: Implement GADCustomNativeAdLoaderDelegate protocol
+## Step 4: Implement CustomNativeAdLoaderDelegate protocol
 {:.no_toc}
 
-In order to capture the native ad response you need to implement the GADCustomNativeAdLoaderDelegate protocol.
+In order to capture the native ad response you need to implement the `CustomNativeAdLoaderDelegate` protocol.
 
 In the method `-adLoader:didReceiveCustomNativeAd:` you should pass the following Prebid functions:
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-webview.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-webview.md
index 308d953674..17587c1381 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-webview.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-native-in-webview.md
@@ -4,12 +4,13 @@ title: iOS GAM Bidding-Only Integration - Native In-Webview
 description: iOS GAM Bidding-Only Integration - Native In-Webview
 sidebarType: 2
 ---
+<!-- markdownlint-disable-file MD046 -->
 
 # iOS GAM Bidding-Only Integration - Native In-Webview
 
 Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#adunit-specific-instructions)
 
-Integration example:
+**Integration example(Swift):**
 
 First, prepare the set of requested assets.
 
@@ -32,8 +33,33 @@ private var nativeRequestAssets: [NativeAsset] {
 
 Then integrate the native style ad using GAM Banner ad unit
 
-``` swift
-// 1. Create NativeRequest
+{% capture gma12 %}// 1. Create a NativeRequest
+nativeUnit = NativeRequest(configId: CONFIG_ID, assets: nativeRequestAssets)
+
+// 2. Configure the NativeRequest
+nativeUnit.context = ContextType.Social
+nativeUnit.placementType = PlacementType.FeedContent
+nativeUnit.contextSubType = ContextSubType.Social
+nativeUnit.eventtrackers = eventTrackers
+
+// 3. Create a GAMBannerView
+gamBannerView = AdManagerBannerView(adSize: AdSizeFluid)
+gamBannerView.adUnitID = AD_UNIT_ID
+gamBannerView.rootViewController = self
+gamBannerView.delegate = self
+
+// Add GMA SDK banner view to the app UI
+bannerView.addSubview(gamBannerView)
+
+// 4. Make a bid request to Prebid Server
+nativeUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+    PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+    
+    // 5. Load the native ad
+    self?.gamBannerView.load(self?.gamRequest)
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Create NativeRequest
 nativeUnit = NativeRequest(configId: CONFIG_ID, assets: nativeRequestAssets)
 nativeUnit.context = ContextType.Social
 nativeUnit.placementType = PlacementType.FeedContent
@@ -42,7 +68,7 @@ nativeUnit.eventtrackers = eventTrackers
 
 // 2. Create GAMBannerView
 gamBannerView = GAMBannerView(adSize: GADAdSizeFluid)
-gamBannerView.adUnitID = storedImpNativeStyleBanner
+gamBannerView.adUnitID = AD_UNIT_ID
 gamBannerView.rootViewController = self
 gamBannerView.delegate = self
 bannerView.addSubview(gamBannerView)
@@ -54,7 +80,9 @@ nativeUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
     // 4. Load and GAM ad
     self?.gamBannerView.load(self?.gamRequest)
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="native-in-webview" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create a NativeRequest
 {:.no_toc}
@@ -98,7 +126,7 @@ Initialize the `NativeRequest` with properties:
 
 {% include mobile/native-params.md %}
 
-## Step 2: Create a GAMBannerView
+## Step 2: Create a BannerView
 {:.no_toc}
 
 Just follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner) to integrate a banner ad unit.
@@ -106,14 +134,14 @@ Just follow the [GMA SDK documentation](https://developers.google.com/ad-manager
 ## Step 3: Make a bid request
 {:.no_toc}
 
-The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `GAMRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `AdManagerRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
 
 ## Step 4: Load an Ad
 {:.no_toc}
 
-You should now request the ad from GAM. If the `GAMRequest` contains targeting keywords the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
+You should now request the ad from GAM. If the `AdManagerRequest` contains targeting keywords the respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
 
-Be sure that you make the ad request with the same `GAMRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
+Be sure that you make the ad request with the same `AdManagerRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
 
 ## Further Reading
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
index a8f9bf6512..8174d0503b 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
@@ -11,10 +11,39 @@ Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integratio
 
 To integrate Rewarded Video ads into the app you should use the Prebid SDK `RewardedVideoAdUnit` class. It makes bid requests to Prebid Server and provides targeting keywords of the winning bid to the GMA SDK.
 
-**Integration Example**
+**Integration example(Swift):**
 
-```swift
-func createAd() {
+{% capture gma12 %}func createAd() {
+    // 1. Create an RewardedVideoAdUnit
+    adUnit = RewardedVideoAdUnit(configId: CONFIG_ID)
+    
+    // 2. Configure video parameters
+    let parameters = VideoParameters(mimes: ["video/mp4"])
+    parameters.protocols = [Signals.Protocols.VAST_2_0]
+    parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOff]
+    adUnit.videoParameters = parameters
+    
+    // 3. Make a bid request to Prebid Server
+    adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+        PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+        
+        // 4. Load the GAM rewarded ad
+        RewardedAd.load(with: AD_UNIT_ID, request: self?.gamRequest) { [weak self] ad, error in
+            guard let self = self else { return }
+            if let error = error {
+                PrebidDemoLogger.shared.error("Failed to load rewarded ad with error: \(error.localizedDescription)")
+            } else if let ad = ad {
+                // 5. Present the interstitial ad
+                ad.fullScreenContentDelegate = self
+                ad.present(from: self, userDidEarnRewardHandler: {
+                    _ = ad.adReward
+                })
+            }
+        }
+    }
+}
+{% endcapture %}
+{% capture gma11 %}func createAd() {
     // 1. Create a RewardedVideoAdUnit using Prebid Mobile SDK
     adUnit = RewardedVideoAdUnit(configId: CONFIG_ID)
     
@@ -28,13 +57,13 @@ func createAd() {
     // 3. Make a bid request to Prebid Server using Prebid Mobile SDK
     let gamRequest = GAMRequest()
     adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
-        DemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+        PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
         
         // 4. Load the GAM rewarded ad using Google Mobile Ads SDK
         GADRewardedAd.load(withAdUnitID: AD_UNIT_ID, request: gamRequest) { [weak self] ad, error in
             guard let self = self else { return }
             if let error = error {
-                DemoLogger.shared.error("Failed to load rewarded ad with error: \(error.localizedDescription)")
+                PrebidDemoLogger.shared.error("Failed to load rewarded ad with error: \(error.localizedDescription)")
             } else if let ad = ad {
                 // 5. Present the rewarded ad
                 ad.fullScreenContentDelegate = self
@@ -45,7 +74,9 @@ func createAd() {
         }
     }
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="rewarded-video" gma11=gma11 gma12=gma12 %}
 
 ## Step 1: Create an Ad Unit
 
@@ -59,13 +90,13 @@ Initialize the `RewardedVideoAdUnit` with properties:
 
 ## Step 3: Make the bid request
 
-The _fetchDemand_ method makes a bid request to the Prebid Server. The `GAMRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
+The _fetchDemand_ method makes a bid request to the Prebid Server. The `AdManagerRequest` object provided to this method must be the one used in the next step to make the GAM ad request.
 
 When Prebid Server responds, Prebid SDK will set the targeting keywords of the winning bid into provided object.
 
 ## **Step 4: Load a GAM Rewarded Ad**
 
-After receiving a bid it's time to load the ad from GAM. If the `GAMRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
+After receiving a bid it's time to load the ad from GAM. If the `AdManagerRequest` contains targeting keywords, the respective Prebid line item may be returned from GAM, and GMA SDK will render its creative. 
 
 ## Step 5: Display the Rewarded Ad
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
index 5a6659b535..7694451547 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
@@ -12,11 +12,10 @@ Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/ios/ios-sdk-integratio
 {: .alert.alert-info :}
 "Non-Instream" refers to the IAB video categories "Accompanying Content" and "Standalone". See [the IAB document](https://iabtechlab.com/industry-adoption-of-amended-iab-tech-lab-guidelines-is-vital-to-drive-change/) for more information.
 
-Integration example:
+**Integration example(Swift):**
 
-``` swift
-// 1. Create a BannerAdUnit
-adUnit = BannerAdUnit(configId: CONFIG_ID, size: adSize)
+{% capture gma12 %}// 1. Create a BannerAdUnit
+adUnit = BannerAdUnit(configId: CONFIG_ID, size: AD_SIZE)
 
 // 2. Set ad format
 adUnit.adFormats = [.video]
@@ -29,14 +28,44 @@ parameters.placement = Signals.Placement.InBanner
 adUnit.videoParameters = parameters
 
 // 4. Create a GAMBannerView
-gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(adSize))
-gamBanner.adUnitID = gamAdUnitVideoBannerOriginal
+gamBanner = AdManagerBannerView(adSize: adSizeFor(cgSize: AD_SIZE))
+gamBanner.adUnitID = AD_UNIT_ID
+gamBanner.rootViewController = self
+gamBanner.delegate = self
+
+// Add GMA SDK banner view to the app UI
+bannerView.addSubview(gamBanner)
+
+// 5. Make a bid request to Prebid Server
+let gamRequest = AdManagerRequest()
+adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+    PrebidDemoLogger.shared.info("Prebid demand fetch for GAM \(resultCode.name())")
+    
+    // 6. Load GAM Ad
+    self?.gamBanner.load(gamRequest)
+}
+{% endcapture %}
+{% capture gma11 %}// 1. Create a BannerAdUnit
+adUnit = BannerAdUnit(configId: CONFIG_ID, size: AD_SIZE)
+
+// 2. Set ad format
+adUnit.adFormats = [.video]
+
+// 3. Configure video parameters
+let parameters = VideoParameters(mimes: ["video/mp4"])
+parameters.protocols = [Signals.Protocols.VAST_2_0]
+parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOff]
+parameters.placement = Signals.Placement.InBanner
+adUnit.videoParameters = parameters
+
+// 4. Create a GAMBannerView
+gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
+gamBanner.adUnitID = AD_UNIT_ID
 gamBanner.rootViewController = self
 gamBanner.delegate = self
 
 // Add GMA SDK banner view to the app UI
 bannerView.addSubview(gamBanner)
-bannerView.backgroundColor = .clear
 
 // 5. Make a bid request to Prebid Server
 let gamRequest = GAMRequest()
@@ -46,7 +75,9 @@ adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
     // 6. Load GAM Ad
     self?.gamBanner.load(gamRequest)
 }
-```
+{% endcapture %}
+
+{% include code/gma-versions-tabs.html id="non-instream-video" gma11=gma11 gma12=gma12 %}
 
 {: .alert.alert-warning :}
 Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated. Use `BannerAdUnit` class with video ad format instead.
@@ -69,7 +100,7 @@ For video ad unit, you must set video ad format. Default value for `adFormats` p
 
 {% include mobile/video-params.md %}
 
-## Step 4: Create a GAMBannerView
+## Step 4: Create a BannerView
 {:.no_toc}
 
 Follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/banner) to integrate a banner ad unit.
@@ -77,14 +108,14 @@ Follow the [GMA SDK documentation](https://developers.google.com/ad-manager/mobi
 ## Step 5: Make a bid request
 {:.no_toc}
 
-The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `GAMRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `AdManagerRequest` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
 
 ## Step 6: Load an Ad
 {:.no_toc}
 
-You should now request the ad from GAM. If the `GAMRequest` contains targeting keywords. The respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
+You should now request the ad from GAM. If the `AdManagerRequest` contains targeting keywords. The respective Prebid line item will be returned from GAM and GMA SDK will render its creative.
 
-Be sure that you make the ad request with the same `GAMRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
+Be sure that you make the ad request with the same `AdManagerRequest` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
 
 ## Further Reading
 

From e3990a5a11483ca597237823f6e041a79af9b8ae Mon Sep 17 00:00:00 2001
From: Sebastien Boisvert <sebastien.boisvert@contxtful.com>
Date: Thu, 20 Mar 2025 15:28:21 -0400
Subject: [PATCH 069/665] Fix schain documentation tentatively (#5955)

* fix schain documentation tentatively

* fix schain documentation for amp

* update schain doc for auction request
---
 dev-docs/show-prebid-ads-on-amp-pages.md             |  6 ++----
 prebid-server/developers/add-new-bidder-go.md        |  2 +-
 prebid-server/developers/add-new-bidder-java.md      |  2 +-
 .../endpoints/openrtb2/auction-request-example.md    |  2 +-
 .../endpoints/openrtb2/pbs-endpoint-auction.md       | 12 +++++++++---
 prebid-server/features/pbs-feature-idx.md            |  5 +++--
 6 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/dev-docs/show-prebid-ads-on-amp-pages.md b/dev-docs/show-prebid-ads-on-amp-pages.md
index b9244d2611..09a80d6d63 100644
--- a/dev-docs/show-prebid-ads-on-amp-pages.md
+++ b/dev-docs/show-prebid-ads-on-amp-pages.md
@@ -65,10 +65,8 @@ that doesn't come from /amp parameters:
     "id": "some-request-id",
     "cur": ["USD"],
     "source": {
-        "ext": {
-            "schain": {
-                ...
-            }
+        "schain": {
+            ...
         }
     },
     "site": {
diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md
index b18d63acdb..b1c8b618b7 100644
--- a/prebid-server/developers/add-new-bidder-go.md
+++ b/prebid-server/developers/add-new-bidder-go.md
@@ -877,7 +877,7 @@ There are a several values of a bid that publishers expect to be populated. Some
 | [First Party Data (FPD)](https://docs.prebid.org/prebid-server/features/pbs-fpd.html)| Prebid | `request.imp[].ext.context.data.*`, `request.app.ext.data.*`, `request.site.ext.data.*`, `request.user.ext.data.*` <br/> The publisher may provide first party data (e.g. keywords).
 | GDPR | OpenRTB |  `request.regs.ext.gdpr`, `request.user.ext.consent` <br/> The publisher is specifying the European General Data Protection Regulation flag and TCF consent string.
 | Site or App | OpenRTB | `request.site`, `request.app` <br/> The publisher will provide either the site or app, but not both, representing the client's device.
-| Supply Chain | OpenRTB | `request.source.ext.schain` <br/> The publisher's declaration of all parties who are selling or reselling the bid request.
+| Supply Chain | OpenRTB | `request.source.schain` <br/> The publisher's declaration of all parties who are selling or reselling the bid request.
 | Test | OpenRTB | `request.test` <br/> The publisher is sending non-production traffic which also enables verbose debugging information from Prebid Server.
 | Video | OpenRTB | `request.imp[].video` <br/> The publisher is specifying video ad requirements or preferences.
 
diff --git a/prebid-server/developers/add-new-bidder-java.md b/prebid-server/developers/add-new-bidder-java.md
index f0aa1b5f3c..5971683b0b 100644
--- a/prebid-server/developers/add-new-bidder-java.md
+++ b/prebid-server/developers/add-new-bidder-java.md
@@ -608,7 +608,7 @@ There are a several values of a bid request that publishers may supply that your
 | [First Party Data (FPD)](https://docs.prebid.org/prebid-server/features/pbs-fpd.html)| Prebid | `request.imp[].ext.context.data.*`, `request.app.ext.data.*`, `request.site.ext.data.*`, `request.user.ext.data.*` <br/> The publisher may provide first party data (e.g. keywords).
 | GDPR | OpenRTB |  `request.regs.ext.gdpr`, `request.user.ext.consent` <br/> The publisher is specifying the European General Data Protection Regulation flag and TCF consent string.
 | Site or App | OpenRTB | `request.site`, `request.app` <br/> The publisher will provide either the site or app, but not both, representing the client's device.
-| Supply Chain | OpenRTB | `request.source.ext.schain` <br/> The publisher's declaration of all parties who are selling or reselling the bid request.
+| Supply Chain | OpenRTB | `request.source.schain` <br/> The publisher's declaration of all parties who are selling or reselling the bid request.
 | Test | OpenRTB | `request.test` <br/> The publisher is sending non-production traffic which also enables verbose debugging information from Prebid Server.
 | Video | OpenRTB | `request.imp[].video` <br/> The publisher is specifying video ad requirements or preferences.
 | Rewarded inventory | OpenRTB | `request.imp[].ext.prebid.is_rewarded_inventory` <br/> Signal to indicate the inventory is rewarded.
diff --git a/prebid-server/endpoints/openrtb2/auction-request-example.md b/prebid-server/endpoints/openrtb2/auction-request-example.md
index 261cd9b25f..4e46ecce9c 100644
--- a/prebid-server/endpoints/openrtb2/auction-request-example.md
+++ b/prebid-server/endpoints/openrtb2/auction-request-example.md
@@ -110,7 +110,7 @@ It serves 2 purposes:
             },
             "schains": [{
                 "bidders": ["bidderA"],
-                "schain": { SCHAIN OBJECT 1} // bid adapters will see their schain on source.[ext.]schain.
+                "schain": { SCHAIN OBJECT 1} // bid adapters will see their schain on source.schain.
             }],
             "server": {
                 "externalurl": "https://prebid-server.example.com",
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index fba8218898..fdf2554860 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -142,7 +142,7 @@ Prebid Server accepts all OpenRTB 2.x fields and passes them in the request to a
 | user.consent | 2.6 | Bidders supporting 2.5 only: downgraded to user.ext.consent |
 | imp.rwdd | 2.6 | Bidders supporting 2.5 only: downgraded to imp[].ext.prebid.is_rewarded_inventory |
 | user.eids | 2.6 | Bidders supporting 2.5 only: downgraded to user.ext.eids |
-| source.schain | 2.6 | Bidders supporting 2.5 only: downgraded to source.ext.schain |
+| source.schain | 2.6 | Bidders supporting 2.5 only: downgraded to source.ext.schain, Bidders supporting 2.4 only: downgraded to ext.schain |
 | wlangb, {content, device}.langb, cattax, {site, app, publisher, content, producer}.cattax, ssai, {app, site}.content.{network, channel}, {app, content, site, user}.kwarray, device.sua | 2.6 | Bidders supporting 2.5 only: these fields are removed |
 | {video, audio}.{rqddurs, maxseq, poddur, podid, podseq, mincpmpersec, slotinpod} | 2.6 | Bidders supporting 2.5 only: these fields are removed |
 | regs.gpp | 2.6-202211 | Bidders supporting 2.5 only: this field is removed |
@@ -998,7 +998,13 @@ An additional option is `usepbsrates`. When `true`, this flag indicates that dyn
 
 ##### Supply Chain Support
 
-Basic supply chains are passed to Prebid Server on `source.ext.schain` and passed through to bid adapters. Prebid Server does not currently offer the ability to add a node to the supply chain.
+Basic supply chains are passed to Prebid Server on `source.schain` and passed through to bid adapters. Prebid Server does not currently offer the ability to add a node to the supply chain.
+
+See
+[OpenRTB 2.6, Section 3.2.2 - Object: Source](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/2.6-202501/2.6.md#322---object-source-)
+and
+[OpenRTB 2.6, Section 3.2.25 - Object: SupplyChain](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/2.6-202501/2.6.md#3225---object-supplychain-)
+.
 
 Bidder-specific schains:
 
@@ -1011,7 +1017,7 @@ Bidder-specific schains:
 
 In this scenario, Prebid Server sends the first schain object to `bidderA` and the second schain object to everyone else.
 
-If there's already an source.ext.schain and a bidder is named in ext.prebid.schains (or covered by the wildcard condition), ext.prebid.schains takes precedent.
+If there's already an source.schain and a bidder is named in ext.prebid.schains (or covered by the wildcard condition), ext.prebid.schains takes precedent.
 
 ##### User IDs
 
diff --git a/prebid-server/features/pbs-feature-idx.md b/prebid-server/features/pbs-feature-idx.md
index ee94695a33..0a9aec4e22 100644
--- a/prebid-server/features/pbs-feature-idx.md
+++ b/prebid-server/features/pbs-feature-idx.md
@@ -63,8 +63,9 @@ title: Prebid Server | Features
 | First Party Data | Bidder-specific impression data | Accepts [bidder-specific first party data attributes at the imp-level](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#bidder-specific-impression-level-fpd). | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | First Party Data | AMP first party data | Accepts [first party data attributes on an AMP request](/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.html#first-party-data). | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [Supply Chain](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#supply-chain-support) | Bidder-specific schains | Accepts bidder-specific schain | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
-| Supply Chain | Host SChain | The host company can supply a global schain that's appended to the list of incoming nodes in source.ext.schain. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
-| Supply Chain | ORTB 2.4 compatibility | If source.ext.schain doesn't exist but ext.schain does, PBS copies the latter to the former. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Supply Chain | Host SChain | The host company can supply a global schain that's appended to the list of incoming nodes in source.schain. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| Supply Chain | ORTB 2.5 compatibility | If source.schain doesn't exist but source.ext.schain does, PBS copies the latter to the former. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Supply Chain | ORTB 2.4 compatibility | If source.schain doesn't exist but ext.schain does, PBS copies the latter to the former. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
 | Publisher Accounts | Core | Ability to enforce that requests coming in have a valid account ID. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | Publisher Accounts | AMP account parameter | Accept the account parameter on the AMP request. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | Publisher Accounts | Account-specific TTLs | Allow each account ID to have a custom PBC time-to-live for banner and video. | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |

From efb47110400329903c3defc558eba0785f59ad0c Mon Sep 17 00:00:00 2001
From: fliccione <165936219+fliccione@users.noreply.github.com>
Date: Fri, 21 Mar 2025 06:37:54 +0100
Subject: [PATCH 070/665] Update onetag.md (#5936)

* Update onetag.md

Add native support in media_types field

* Update onetag.md adding multiformat_supported field

* Update onetag.md

fixed multiformat_supported field value

---------

Co-authored-by: f-cali <f.cali@onetag.com>
---
 dev-docs/bidders/onetag.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/onetag.md b/dev-docs/bidders/onetag.md
index e3f144a02e..c230166438 100644
--- a/dev-docs/bidders/onetag.md
+++ b/dev-docs/bidders/onetag.md
@@ -5,7 +5,7 @@ description: Prebid OneTag Bidder Adaptor
 pbjs: true
 pbs: true
 biddercode: onetag
-media_types: banner, video
+media_types: banner, video, native
 tcfeu_supported: true
 dsa_supported: true
 gpp_supported: true
@@ -17,6 +17,7 @@ floors_supported: true
 sidebarType: 1
 coppa_supported: true
 privacy_sandbox: topics
+multiformat_supported: will-bid-on-one
 ---
 
 

From 6f0ae0c2fba2b58e41fcca588ce9778b56b04b5c Mon Sep 17 00:00:00 2001
From: Viktor Dreiling <34981284+3link@users.noreply.github.com>
Date: Fri, 21 Mar 2025 17:37:14 +0100
Subject: [PATCH 071/665] fix: Upgrade tj-actions Github action.
 [CVE-2025-30066] (#5957)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Christoph Bünte <info@christophbuente.de>
---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 53536e800d..4b63e8ff72 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -18,7 +18,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - uses: tj-actions/changed-files@v44
+      - uses: tj-actions/changed-files@v46
         id: changed-files
         with:
           files: '**/*.md'

From 7dde2dd2ba4f6f5749f208f1ddea84e4aa7509a3 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Tue, 25 Mar 2025 13:38:29 +0200
Subject: [PATCH 072/665] Mobile: Support Native Impression Tracking (#5873)

* docs: add secion about native tracking to ios docs

* Android code.

* docs: small correction

---------

Co-authored-by: Valentin Petrovych <valentin.petrovich@postindustria.com>
---
 _includes/mobile/adunit-config-android.md | 36 ++++++++++++++++++++++-
 _includes/mobile/adunit-config-ios.md     | 36 ++++++++++++++++++++++-
 2 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/_includes/mobile/adunit-config-android.md b/_includes/mobile/adunit-config-android.md
index aa522f9582..aedd88e520 100644
--- a/_includes/mobile/adunit-config-android.md
+++ b/_includes/mobile/adunit-config-android.md
@@ -67,4 +67,38 @@ You can set `adPosition` by using the following method:
 
 ```kotlin
 adUnit.setAdPosition(AdPosition.FOOTER);
-```
\ No newline at end of file
+```
+
+
+### Native Impression Tracking
+
+The SDK offers an API that enables impression tracking for the following ad unit types: `BannerAdUnit`, `InterstitialAdUnit`, and `PrebidAdUnit`. An example implementation is provided below:
+
+`BannerAdUnit`:
+
+```kotlin
+val adView = AdManagerAdView(this)
+val adUnit = BannerAdUnit(CONFIG_ID, WIDTH, HEIGHT)
+adUnit.activatePrebidImpressionTracker(adView)
+```
+
+`InterstitialAdUnit`:
+
+```kotlin
+val adUnit = InterstitialAdUnit(CONFIG_ID, 80, 60)
+adUnit.activateInterstitialPrebidImpressionTracker()
+```
+
+`PrebidAdUnit`:
+
+```kotlin
+val prebidAdUnit = PrebidAdUnit(configId)
+
+// Use this method for banners
+prebidAdUnit.activatePrebidImpressionTracker(adView)
+
+// Use this method for interstitials
+prebidAdUnit.activateInterstitialPrebidImpressionTracker()
+```
+
+**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
\ No newline at end of file
diff --git a/_includes/mobile/adunit-config-ios.md b/_includes/mobile/adunit-config-ios.md
index 7fa4ad9490..3ba61a69b2 100644
--- a/_includes/mobile/adunit-config-ios.md
+++ b/_includes/mobile/adunit-config-ios.md
@@ -56,4 +56,38 @@ You can set `adPosition` by using the following property:
 
 ```swift
 adUnit.adPosition = .footer
-```
\ No newline at end of file
+```
+
+### Native Impression Tracking
+
+The SDK offers an API that enables impression tracking for the following ad unit types: `BannerAdUnit`, `InterstitialAdUnit`, and `PrebidAdUnit`. An example implementation is provided below:
+
+`BannerAdUnit`:
+
+```swift
+let adUnit = BannerAdUnit(configId: CONFIG_ID, size: AD_SIZE)
+let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
+adUnit.activatePrebidImpressionTracker(adView: gamBanner)
+```
+
+`InterstitialAdUnit`:
+
+```swift
+let adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: 50, minHeightPerc: 70)
+adUnit.activatePrebidImpressionTracker()
+```
+
+`PrebidAdUnit`:
+
+```swift
+let adUnit = PrebidAdUnit(configId: CONFIG_ID)
+
+// Use this method for intersitials
+adUnit.activatePrebidInterstitialImpressionTracker()
+
+// Use this method for banners
+let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
+adUnit.activatePrebidAdViewImpressionTracker(adView: gamBanner)
+```
+
+**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
\ No newline at end of file

From 6e064f9492720fa2b7dd1ed3b0413d30a6bbd506 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 25 Mar 2025 15:02:27 -0400
Subject: [PATCH 073/665] PBS module page update (#5961)

* PBS module page update

fixed braces in example

* added endpoints note
---
 prebid-server/pbs-modules/index.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/prebid-server/pbs-modules/index.md b/prebid-server/pbs-modules/index.md
index bae04a3aa3..95b2eae9b5 100644
--- a/prebid-server/pbs-modules/index.md
+++ b/prebid-server/pbs-modules/index.md
@@ -221,15 +221,18 @@ PBS-Java 3.16 introduced a new A/B testing framework that applies to any module.
                ... abtest config for other modules ...
             }],
             "endpoints": {
-                "/openrtb2/auction": {
-                    ...
-                 }
+              ...
             }
-        ]
-     ]
-]
+        }
+     }
+}
 ```
 
+{: .alert.alert-info :}
+If the execution plans defined at the default account level are acceptable, but a specific account wants to test a module,
+just add the `hooks.execution-plan.abtests` object and then `hooks.execution-plan.endpoints: {}`. The empty `endpoints` object will be merged
+at runtime with the account default. Leaving the account-specific endpoints completely empty will result in an error.
+
 These are the parameters accepted within the `abtests` object:
 
 {: .table .table-bordered .table-striped }

From 66a31c15ad2ded1adbfd989cb16f66e72e95368d Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Thu, 27 Mar 2025 19:49:23 +0100
Subject: [PATCH 074/665] Add local way of caching VAST XML (#5947)

* Add local way of caching VAST XML

* update

* fix

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/publisher-api-reference/setConfig.md | 28 +++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 23cb8c179e..c85ac06772 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1047,20 +1047,23 @@ pbjs.setConfig({
 
 ### Client-side Caching of VAST XML
 
-When serving video ads, VAST XML creatives must be cached on the network so the
+When serving video ads, VAST XML creatives must be cached so the
 video player can retrieve them when it's ready. Players don't obtain the VAST XML from
 the JavaScript DOM in Prebid.js, but rather expect to be given a URL where it can
-be retrieved. There are two different flows possible with Prebid.js around VAST XML caching:
+be retrieved. There are three different flows possible with Prebid.js around VAST XML caching:
 
 * Server-side caching:  
   Some video bidders (e.g. Rubicon Project) always cache the VAST XML on their servers as part of the bid. They provide a 'videoCacheKey', which is used in conjunction with the VAST URL in the ad server to retrieve the correct VAST XML when needed. In this case, Prebid.js has nothing else to do. As of Prebid.js 4.28, a publisher may specify the `ignoreBidderCacheKey` flag to re-cache these bids somewhere else using a VAST wrapper.
 * Client-side caching:  
   Video bidders that don't cache on their servers return the entire VAST XML body. In this scenario, Prebid.js needs to copy the VAST XML to a publisher-defined cache location on the network. Prebid.js POSTs the VAST XML to the named Prebid Cache URL. It then sets the 'videoCacheKey' to the key that's returned in the response.
+* Local client-side caching (Blob URL):
+  To reduce network traffic to the publisher-defined remote cache location, Prebid allows publishers to locally store the VAST XML of a bid as a blob in the browser's memory. When the `cache.useLocal` option is enabled, Prebid sets the bid’s `videoCacheKey` to the key assigned to the locally stored blob. In this scenario, `bid.vastUrl` becomes a blob URL.
 
 {: .table .table-bordered .table-striped }
 | Cache Attribute | Required? | Type | Description |
 |----+--------+-----+-------|
 | cache.url | yes | string | The URL of the Prebid Cache server endpoint where VAST creatives will be sent. |
+| cache.useLocal | no | boolean | Flag determining whether to locally save VAST XML as a blob |
 | cache.timeout | no | number | Timeout (in milliseconds) for network requests to the cache |
 | cache.vasttrack | no | boolean | Passes additional data to the url, used for additional event tracking data. Defaults to `false`. |
 | cache.ignoreBidderCacheKey | no | boolean | If the bidder supplied their own cache key, setting this value to true adds a VAST wrapper around that URL, stores it in the cache defined by the `url` parameter, and replaces the original video cache key with the new one. This can dramatically simplify ad server setup because it means all VAST creatives reside behind a single URL. The tradeoff: this approach requires the video player to unwrap one extra level of VAST. Defaults to `false`. |
@@ -1134,6 +1137,27 @@ If a batchSize is set to 2 and 5 video responses arrive (within the timeframe sp
 
 <a name="setConfig-instream-tracking"></a>
 
+As of Prebid.js 10, you can save VAST XML as blob in browser's memory. Here's how to leverage local caching to reduce network traffic while working with an ad server. Using Google Ad Manager (GAM) as an example, no additional configuration of VAST creatives is required within GAM. The existing process of building the GAM VAST ad tag URL and retrieving the VAST wrapper from GAM remains unchanged - except for one key difference.
+
+Consider the following Prebid configuration:
+
+```javascript
+pbjs.setConfig({
+        cache: {
+            url: 'https://prebid.adnxs.com/pbc/v1/cache',
+            useLocal: true
+        }
+});
+```
+
+When `useLocal` is set to true, the remote cache URL endpoint is never called. However, existing GAM creatives configured with a VAST ad tag URL, such as:
+
+``
+https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid%%
+``
+
+will continue to function correctly. `hb_uuid` is set to locally assigned blob UUID. If the bid wins the GAM auction and it's `videoCacheKey` (`hb_uuid`) is included in a GAM wrapper VAST XML, Prebid will update the VAST ad tag URL with the locally cached blob URL after receiving a response from Google Ad Manager.
+
 ### Instream tracking
 
 {: .alert.alert-info :}

From f1b7791f5c36f77eada02a2bbfeec9a65f9f9af3 Mon Sep 17 00:00:00 2001
From: kazutoshi-uekawa-muneee
 <114455471+kazutoshi-uekawa-muneee@users.noreply.github.com>
Date: Mon, 31 Mar 2025 02:48:30 +0900
Subject: [PATCH 075/665] UNIQUEST Bid Adapter: initial release (#5929)

* add uniquest bid adapter, analytics adapter

* add infomation to uniquest.md
---
 dev-docs/analytics/uniquest.md | 14 +++++++++++++
 dev-docs/bidders/uniquest.md   | 36 ++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+)
 create mode 100644 dev-docs/analytics/uniquest.md
 create mode 100644 dev-docs/bidders/uniquest.md

diff --git a/dev-docs/analytics/uniquest.md b/dev-docs/analytics/uniquest.md
new file mode 100644
index 0000000000..c25bdb1c0f
--- /dev/null
+++ b/dev-docs/analytics/uniquest.md
@@ -0,0 +1,14 @@
+---
+layout: analytics
+title: UNIQUEST
+description: UNIQUEST Prebid Analytics Adapter
+modulecode: uniquest
+enable_download: false
+---
+
+#### Analytics Options
+
+{: .table .table-bordered .table-striped }
+| Name | Scope    | Description | Example  | Type     |
+|-------|----------|---------------------------|----------|----------|
+| `sid` | required | The AdUnit ID from UNIQUEST | `'SID00001'` | `string` |
diff --git a/dev-docs/bidders/uniquest.md b/dev-docs/bidders/uniquest.md
new file mode 100644
index 0000000000..c82f8a45b2
--- /dev/null
+++ b/dev-docs/bidders/uniquest.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: UNIQUEST
+description: Prebid UNIQUEST Bidder Adapter
+biddercode: uniquest
+pbjs: true
+media_types: banner
+sidebarType: 1
+safeframes_ok: false
+pbs: false
+deals_supported: false
+tcfeu_supported: false
+usp_supported: false
+prebid_member: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+floors_supported: false
+ortb_blocking_supported: false
+gpp_sids: none
+gvl_id: none
+dsa_supported: false
+fpd_supported: false
+multiformat_supported: none
+privacy_sandbox: none
+---
+
+### Registration
+To use this bidder you will need with UNIQUEST. For further information, Please contact us at <prebid_info@muneee.co.jp>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope    | Description | Example  | Type     |
+|-------|----------|---------------------------|----------|----------|
+| `sid` | required | The AdUnit ID from UNIQUEST | `'SID00001'` | `string` |

From b063099b7c12a35ebd606ccee702b89016f81567 Mon Sep 17 00:00:00 2001
From: suzuki <70867995+logly-suzuki@users.noreply.github.com>
Date: Mon, 31 Mar 2025 23:57:27 +0900
Subject: [PATCH 076/665] remove loglylift adapter (#5953)

---
 dev-docs/bidders/loglylift.md | 28 ----------------------------
 1 file changed, 28 deletions(-)
 delete mode 100644 dev-docs/bidders/loglylift.md

diff --git a/dev-docs/bidders/loglylift.md b/dev-docs/bidders/loglylift.md
deleted file mode 100644
index f15ce42f93..0000000000
--- a/dev-docs/bidders/loglylift.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-layout: bidder
-title: LOGLY lift
-description: Prebid LOGLY lift Bidder Adaptor
-biddercode: loglylift
-tcfeu_supported: false
-usp_supported: false
-coppa_supported: false
-schain_supported: false
-dchain_supported: false
-media_types: banner, native
-safeframes_ok: false
-deals_supported: false
-floors_supported: false
-fpd_supported: false
-pbjs: true
-pbs: false
-prebid_member: false
-sidebarType: 1
----
-
-
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name   | Scope    | Description                                              | Example  | Type      |
-|--------|----------|----------------------------------------------------------|----------|-----------|
-| `adspotId`  | required | adspot id managed by LOGLY lift                   | `4302078` | `integer`  |

From 175fb6b8e79d79f04cb8df9de4c7aef11add2c44 Mon Sep 17 00:00:00 2001
From: kazutoshi-uekawa-muneee
 <114455471+kazutoshi-uekawa-muneee@users.noreply.github.com>
Date: Tue, 1 Apr 2025 00:25:21 +0900
Subject: [PATCH 077/665] fix uniquest analytics adapter docs (#5970)

---
 dev-docs/analytics/uniquest.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/dev-docs/analytics/uniquest.md b/dev-docs/analytics/uniquest.md
index c25bdb1c0f..e3cc26ed90 100644
--- a/dev-docs/analytics/uniquest.md
+++ b/dev-docs/analytics/uniquest.md
@@ -3,7 +3,6 @@ layout: analytics
 title: UNIQUEST
 description: UNIQUEST Prebid Analytics Adapter
 modulecode: uniquest
-enable_download: false
 ---
 
 #### Analytics Options

From c6dc9ad6e9682566b6e7925a4c084fa5a74081e2 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Mon, 31 Mar 2025 11:25:46 -0400
Subject: [PATCH 078/665] codepath notification docs (#5922)

---
 dev-docs/bidder-adaptor.md                      | 6 ++++++
 prebid-server/developers/add-a-module-go.md     | 4 ++++
 prebid-server/developers/add-a-module-java.md   | 4 ++++
 prebid-server/developers/add-new-bidder-go.md   | 6 ++++++
 prebid-server/developers/add-new-bidder-java.md | 6 ++++++
 5 files changed, 26 insertions(+)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index f3c6e5ebcd..bfa42399c3 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -1362,6 +1362,12 @@ Once the inspection passes, the code will be merged and included with the next r
 
 The Prebid.org [download page](/download.html) will automatically be updated with your adapter once everything's been merged.
 
+## Optional Code Update Notification
+
+The core Prebid engineering team sometimes makes changes to bid adapter files for various reasons: general refactoring, internal API changes, bug fixes, etc. If you want to receive an email alert about any changes made to your codebase, you can update the [codepath notification file](https://github.com/prebid/Prebid.js/blob/master/.github/workflows/scripts/codepath-notification). Please read the instructions in the file. In many cases, the regex will just be your biddercode, but if you have a short biddercode, you might need to be more precise or you'll get false notifications.
+
+Likewise, your bidder documentation can receive alerts by updating the [docs codepath notification file](https://github.com/prebid/prebid.github.io/blob/master/.github/workflows/scripts/codepath-notification).
+
 ## Further Reading
 
 * [Prebid.js Repo - Bidder Adapter Sources](https://github.com/prebid/Prebid.js/tree/master/modules)
diff --git a/prebid-server/developers/add-a-module-go.md b/prebid-server/developers/add-a-module-go.md
index e76374d6a5..1b31e12647 100644
--- a/prebid-server/developers/add-a-module-go.md
+++ b/prebid-server/developers/add-a-module-go.md
@@ -268,6 +268,10 @@ In the `BidderRequest` or `RawBidderResponse` stage:
 {:start="5"}
 5. More test implementations for each hook can be found in unit-tests at [github.com/prebid/prebid-server/tree/master/modules/prebid/ortb2blocking](https://github.com/prebid/prebid-server/tree/master/modules/prebid/ortb2blocking) folder.
 
+### Optional Code Update Notification
+
+The core Prebid engineering team sometimes makes changes to module files for various reasons: general refactoring, internal API changes, bug fixes, etc. If you want to receive an email alert about any changes made to your codebase, you can update the [codepath notification file](https://github.com/prebid/prebid-server/blob/master/.github/workflows/scripts/codepath-notification). Please read the instructions in the file. In many cases, the regex will just be your modulecode, but if you have a short modulecode, you might need to be more precise or you'll get false notifications.
+
 ### Configuration
 
 It's possible to define default module configuration which can be read by the module at PBS startup. An example configuration for hooks might look like this:
diff --git a/prebid-server/developers/add-a-module-java.md b/prebid-server/developers/add-a-module-java.md
index cdb00f8815..b457c5241b 100644
--- a/prebid-server/developers/add-a-module-java.md
+++ b/prebid-server/developers/add-a-module-java.md
@@ -93,6 +93,10 @@ The structure of your module source code inside the modules directory must have
 +- README.md <- documentation
 ```
 
+### Optional Code Update Notification
+
+The core Prebid engineering team sometimes makes changes to module files for various reasons: general refactoring, internal API changes, bug fixes, etc. If you want to receive an email alert about any changes made to your codebase, you can update the [codepath notification file](https://github.com/prebid/prebid-server-java/blob/master/.github/workflows/scripts/codepath-notification). Please read the instructions in the file. In many cases, the regex will just be your modulecode, but if you have a short modulecode, you might need to be more precise or you'll get false notifications.
+
 ## Module Configuration
 There are several places to configure a module:
 
diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md
index b1c8b618b7..b92351327d 100644
--- a/prebid-server/developers/add-new-bidder-go.md
+++ b/prebid-server/developers/add-new-bidder-go.md
@@ -1418,6 +1418,12 @@ Notes on the metadata fields:
   - `openrtb_ext/bidders.go`
   - `exchange/adapter_builders.go`
 
+### Optional Code Update Notification
+
+The core Prebid engineering team sometimes makes changes to bid adapter files for various reasons: general refactoring, internal API changes, bug fixes, etc. If you want to receive an email alert about any changes made to your codebase, you can update the [codepath notification file](https://github.com/prebid/prebid-server/blob/master/.github/workflows/scripts/codepath-notification). Please read the instructions in the file. In many cases, the regex will just be your biddercode, but if you have a short biddercode, you might need to be more precise or you'll get false notifications.
+
+Likewise, your bidder documentation can receive alerts by updating the [docs codepath notification file](https://github.com/prebid/prebid.github.io/blob/master/.github/workflows/scripts/codepath-notification).
+
 ## Contribute
 
 Thank you for taking the time to develop a Prebid Server bid adapter. When you're ready, [contribute](https://github.com/prebid/prebid-server/blob/master/docs/developers/contributing.md) your new bid adapter by opening a PR to the [PBS-Go GitHub repository](https://github.com/prebid/prebid-server) with the name "New Adapter: {Bidder}".
diff --git a/prebid-server/developers/add-new-bidder-java.md b/prebid-server/developers/add-new-bidder-java.md
index 5971683b0b..2b233fc32f 100644
--- a/prebid-server/developers/add-new-bidder-java.md
+++ b/prebid-server/developers/add-new-bidder-java.md
@@ -1431,6 +1431,12 @@ Notes on the metadata fields:
 - Register With The Core
   - `org/prebid/server/spring/config/bidder/{bidder}Configuration.java`
 
+### Optional Code Update Notification
+
+The core Prebid engineering team sometimes makes changes to bid adapter files for various reasons: general refactoring, internal API changes, bug fixes, etc. If you want to receive an email alert about any changes made to your codebase, you can update the [codepath notification file](https://github.com/prebid/prebid-server-java/blob/master/.github/workflows/scripts/codepath-notification). Please read the instructions in the file. In many cases, the regex will just be your biddercode, but if you have a short biddercode, you might need to be more precise or you'll get false notifications.
+
+Likewise, your bidder documentation can receive alerts by updating the [docs codepath notification file](https://github.com/prebid/prebid.github.io/blob/master/.github/workflows/scripts/codepath-notification).
+
 ## Contribute
 
 Whew! You're almost done. Thank you for taking the time to develop a Prebid Server bid adapter. When you're ready, [contribute](https://github.com/prebid/prebid-server-java/blob/master/docs/developers/contributing.md) your new bid adapter by opening a PR to the [PBS-Java GitHub repository](https://github.com/prebid/prebid-server-java) with the name "New Adapter: {Bidder}".

From a705f23ee4577866de654c05eea28ac9c897c417 Mon Sep 17 00:00:00 2001
From: johnwier <49074029+johnwier@users.noreply.github.com>
Date: Mon, 31 Mar 2025 08:28:57 -0700
Subject: [PATCH 079/665] add native support (#5932)

Co-authored-by: johwier <john.wier@epsilon.com>
---
 dev-docs/bidders/epsilon.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/epsilon.md b/dev-docs/bidders/epsilon.md
index 1970221e85..aca745d176 100644
--- a/dev-docs/bidders/epsilon.md
+++ b/dev-docs/bidders/epsilon.md
@@ -5,7 +5,7 @@ description: Epsilon Prebid Bidder Adaptor (formerly Conversant)
 pbjs: true
 pbs: true
 biddercode: conversant
-media_types: banner, video, audio
+media_types: banner, video, audio, native
 tcfeu_supported: true
 userIds: criteo, id5Id, identityLink, liveIntentId, parrableId, pubCommonId, unifiedId, publinkId
 prebid_member: true

From 72eb5fdbadb0508050ace87466238690dfbd7489 Mon Sep 17 00:00:00 2001
From: Saar Amrani <saar120@gmail.com>
Date: Mon, 31 Mar 2025 22:18:37 +0300
Subject: [PATCH 080/665] disable download on illumin adapter (#5948)

---
 dev-docs/bidders/illumin.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/illumin.md b/dev-docs/bidders/illumin.md
index d8d7bfe70b..fc00073828 100644
--- a/dev-docs/bidders/illumin.md
+++ b/dev-docs/bidders/illumin.md
@@ -19,6 +19,7 @@ pbs_app_supported: false
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
+enable_download: false
 pbjs: true
 sidebarType: 1
 ---

From 4665848768abc834f2c9a8df126add177eca4f24 Mon Sep 17 00:00:00 2001
From: Miguel <therevoltingx@gmail.com>
Date: Mon, 31 Mar 2025 12:24:01 -0700
Subject: [PATCH 081/665] PAIR: adds TechLab version documentation (#5785)

* adds techlab pair documentation

* adds matcher/inserter config for pair module

---------

Co-authored-by: Miguel Morales <miguel@iabtechlab.com>
---
 .../modules/userid-submodules/open-pair.md    | 91 +++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/open-pair.md

diff --git a/dev-docs/modules/userid-submodules/open-pair.md b/dev-docs/modules/userid-submodules/open-pair.md
new file mode 100644
index 0000000000..29b5f7e96d
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/open-pair.md
@@ -0,0 +1,91 @@
+---
+layout: userid
+title: Open PAIR ID
+description: Open PairId User ID sub-module
+useridmodule: openPairIdSystem
+bidRequestUserId: openPairId
+eidsource: pair-protocol.com
+example: '"nnjbddb46374634mndjhd78jh"'
+---
+
+Originally developed by Google and subsequently donated to the industry.
+This version supports single and two Data Clean Room setups, in which the advertiser and publisher use different clean rooms.
+
+(Publisher Advertiser Identity Reconciliation) is a secure and privacy-forward way for enabling advertisers and publishers to reconcile their
+first-party data for marketing use cases via advanced data encryption methods without the
+reliance on third-party cookies.
+
+PAIR can help advertisers and publishers maintain control of first-party data while ensuring there is no pooling of data, no leakage of data, no leakage of insights, durablility for the future using secure encryption methods, and no user tracking across publishers.
+
+See this [page](https://iabtechlab.com/pair/) for more information about the PAIR protocol.
+
+Add it to your Prebid.js package with:
+
+```bash
+gulp build --modules=openPairIdSystem
+```
+
+## PAIR ID Configuration
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | The name of PAIR ID user ID module. | `"openPairId"` |
+| params | Optional | Object | Container of all module params. Each entry can be used to configured a specific clean room. |  |
+
+## PAIR ID Examples
+
+Publishers manage PAIR Ids themselves can store pairIds as a byte64 encoded array of ids in local storage and/or 1st party cookies entry `pairId`.
+
+```javascript
+
+// should have byte64 value ready in 'pairId' local storage/cookie entry
+
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: 'openPairId'
+    }]
+  }
+});
+```
+
+Clean rooms may use specific storage keys, this version supports specifying the storage key for any clean room such as the following example.
+
+```javascript
+
+// value in 'pairId' local storage/cookie entry will be combined with ids provided by cleanroom liveramp
+pbjs.setConfig({
+  userSync: {
+    userIds: [
+      {
+        name: 'openPairId',
+        params: {
+          cleanRoomVendor: {
+            storageKey: '_storage_key'
+          }
+        }
+      }
+    ]
+  }
+});
+```
+
+As per the PAIR specification, you can define the inserter and matcher.
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [
+      {
+        name: 'openPairId',
+        params: {
+          inserter: 'some-domain.com',
+          matcher: 'another-domain.com'
+        }
+      }
+    ]
+  }
+});
+```

From 7b3776d2fd394a811707ce6954ebc6050807acc4 Mon Sep 17 00:00:00 2001
From: Komal Kumari <169047654+pm-komal-kumari@users.noreply.github.com>
Date: Tue, 1 Apr 2025 01:00:05 +0530
Subject: [PATCH 082/665] PubMatic RTD Documentation and link added (#5860)

* Initial commit : add pubmatic rtd documentation

* Remove lint errors

* Remove lint error

* Update the pubmaticRTD documentation

---------

Co-authored-by: Komal Kumari <komalkumari@Komals-MacBook-Pro-L1834.local>
---
 dev-docs/modules/pubmaticRtdProvider.md | 81 +++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 dev-docs/modules/pubmaticRtdProvider.md

diff --git a/dev-docs/modules/pubmaticRtdProvider.md b/dev-docs/modules/pubmaticRtdProvider.md
new file mode 100644
index 0000000000..f02ef2e190
--- /dev/null
+++ b/dev-docs/modules/pubmaticRtdProvider.md
@@ -0,0 +1,81 @@
+---
+layout: page_v2
+page_type: module
+title: PubMatic RTD Provider
+display_name: PubMatic RTD Module
+description: RTD module for Prebid provided by PubMatic to set dynamic floors
+module_type: rtd
+module_code: pubmaticRtdProvider
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# PubMatic RTD Module
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The PubMatic RTD module fetches pricing floor data and updates the Price Floors Module based on user's context in real-time as per Price Floors Modules Floor Data Provider Interface guidelines [Dynamic Floor Data Provider](https://docs.prebid.org/dev-docs/modules/floors.html#floor-data-provider-interface).
+
+## Integration
+
+Step 1: Contact PubMatic to get a publisher ID and create your first profile.
+
+Step 2: Integrate the PubMatic Analytics Adapter (see Prebid Analytics modules) as well as the Price Floors module.
+
+Step 3: Prepare the base Prebid file.
+
+For example:
+
+To compile the Price Floors, PubMatic RTD module and PubMatic Analytics Adapter into your Prebid build:
+
+```shell
+gulp build --modules=priceFloors,rtdModule,pubmaticRtdProvider,pubmaticAnalyticsAdapter
+```
+
+{: .alert.alert-info :}
+Note: The PubMatic RTD module is dependent on the global real-time data module : `rtdModule`, price floor module : `priceFloors` and PubMatic Analytics Adapter : `pubmaticAnalyticsAdapter`.
+
+Step 4: Set configuration and enable PubMatic RTD Module using pbjs.setConfig.
+
+## Configuration
+
+This module is configured as part of the `realTimeData.dataProviders`.  We recommend setting `auctionDelay` to at least 250 ms and make sure `waitForIt` is set to `true` for the `pubmatic` RTD provider.
+
+```js
+const AUCTION_DELAY = 250;
+pbjs.setConfig({
+    // rest of the config
+    ...,
+    realTimeData: {
+        auctionDelay: AUCTION_DELAY,
+        dataProviders: [
+            {
+                name: "pubmatic",
+                waitForIt: true,
+                params: {
+                    publisherId: `<publisher_id>`, // please contact PubMatic to get a publisherId for yourself
+                    profileId: `<profile_id>`, // please contact PubMatic to get a profileId for yourself
+                },
+            },
+        ],
+    },
+    // rest of the config
+    ...,
+});
+```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+| Name               | Type    | Description                                                    | Default                    |
+| :----------------- | :------ | :------------------------------------------------------------- | :------------------------- |
+| name               | String  | Name of the real-time data module                              | Always `pubmatic`          |
+| waitForIt          | Boolean | Should be `true` if an `auctionDelay` is defined (mandatory)    | `false`                     |
+| params             | Object  |                                                                |                            |
+| params.publisherId | String  | Publisher ID                                                   |                            |
+| params.profileId   | String  | Profile ID                                                     |                            |

From 52aff9eb088d75ad5dbb0822453559272640437d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Krzysztof=20Sok=C3=B3=C5=82?=
 <88041828+krzysztofequativ@users.noreply.github.com>
Date: Thu, 3 Apr 2025 10:25:00 +0200
Subject: [PATCH 083/665] Equativ Bid Adapter: fixing compatibilities (#5963)

* SADR-6590: initial documentation for Equativ JS bid adapter

* SADR-6590: doc refinements

* Update equativ.md

SADR-6590: adjustments to doc from review feedback.

* SADR-6590: fix linting issues

* SADR-6590: another linting issue

* update app.publisher.id

* SADR-6590: providing link to Equativ OpenRTB API documentation

* SADR-6590: providing additional required fields for documentation

* SADR-6590: adding peer answers to questions

* SADR-6590: remove FPD section for now

* Equativ: updating documentation on bid adapter parameter requirements

* SADR-6882: expanding documentation with additional examples

* update features

* added info about first party data

---------

Co-authored-by: Jeff Mahoney <jeff.t.mahoney@gmail.com>
---
 dev-docs/bidders/equativ.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index b7d550a2c1..c126fe867a 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -8,19 +8,19 @@ dsa_supported: true
 gvl_id: 45
 usp_supported: true
 coppa_supported: true
-gpp_sids: tcfeu, usp
+gpp_sids: tcfca, tcfeu, usnat, usstate_all, usp
 schain_supported: true
 dchain_support: false
 userIds: all
-media_types: banner
+media_types: banner, video, native
 safeframes_ok: true
 deals_supported: false
 floors_supported: true
-fpd_supported: false
+fpd_supported: true
 pbjs: true
-pbs: true
+pbs: false
 prebid_member: false
-multiformat_supported: will-bid-on-one
+multiformat_supported: will-bid-on-any
 ortb_blocking_supported: true
 privacy_sandbox: no
 sidebarType: 1
@@ -348,6 +348,10 @@ pbjs.que.push(function () {
 {: .alert.alert-warning :}
 **Note**: If a demand partner of Equativ is not capable of reading an audio object, the audio object will be converted into a video object with audio mime types. There is, as of this writing, no built-in/default support for serving audio assets in Prebid, so publishers that wish to do so will need to ensure their ad server setups can process whatever hand-offs are necessary.
 
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+
 ### Additional Resources
 
 Information about how Equativ supports the oRTB specification, along with additional examples, can be found [on our OpenRTB API support site](https://help.smartadserver.com/s/article/OpenRTB-API-for-suppliers-Bid-request-specification-Part-1).

From 3691f132028d182df08a38c000f156ef862b18b0 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Thu, 3 Apr 2025 12:04:59 +0200
Subject: [PATCH 084/665] version fix (#5980)

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/publisher-api-reference/setConfig.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index c85ac06772..6b39588bb2 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1137,7 +1137,7 @@ If a batchSize is set to 2 and 5 video responses arrive (within the timeframe sp
 
 <a name="setConfig-instream-tracking"></a>
 
-As of Prebid.js 10, you can save VAST XML as blob in browser's memory. Here's how to leverage local caching to reduce network traffic while working with an ad server. Using Google Ad Manager (GAM) as an example, no additional configuration of VAST creatives is required within GAM. The existing process of building the GAM VAST ad tag URL and retrieving the VAST wrapper from GAM remains unchanged - except for one key difference.
+As of Prebid.js 9.37.0, you can save VAST XML as blob in browser's memory. Here's how to leverage local caching to reduce network traffic while working with an ad server. Using Google Ad Manager (GAM) as an example, no additional configuration of VAST creatives is required within GAM. The existing process of building the GAM VAST ad tag URL and retrieving the VAST wrapper from GAM remains unchanged - except for one key difference.
 
 Consider the following Prebid configuration:
 

From 96774c7c0394fc2726427485e89a46ea3cd5b301 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <o.ste@teqblaze.com>
Date: Thu, 3 Apr 2025 13:41:44 +0300
Subject: [PATCH 085/665] Mobile: Rewarded Ad Unit Enhancements (#5659)

* feat: reward earning section

* feat: correct old info

* feat: in app integration corrections

* doc: ios rewarded doc updates

* doc: add rewarded server-side configuration doc

* feat: add rewarded config url

* doc: fix table

* doc: table updates

* doc: rephrase the intro text

* doc: format table. POC code formatting inside the table

* doc: corrections

* doc: try code tag

* doc: use mode code blocks in table

* doc: format text

* doc: corrections in rewarded-server-side-configuration.md

* doc: fix linting errors

* doc: fix linting error

* doc: update rewarded-server-side-configuration.md

* doc: corrections in rewarded-server-side-configuration.md

* docs: update ios-sdk-integration-admob.md

---------

Co-authored-by: ValentinTeqBlaze <v.pet@teqblaze.com>
Co-authored-by: Yuriy Velichko <yuriy.velichko@ postindustria.com>
Co-authored-by: Yurii <y.vel@teqblaze.com>
---
 .../rewarded-server-side-configuration.md     | 72 +++++++++++++++++++
 .../android-sdk-integration-admob.md          | 18 ++---
 .../rendering/android-sdk-integration-gam.md  | 50 +++++++------
 .../rendering/android-sdk-integration-max.md  | 19 ++---
 .../rendering/android-sdk-integration-pb.md   | 28 ++++++--
 .../rendering/ios-sdk-integration-admob.md    |  4 +-
 .../rendering/ios-sdk-integration-gam.md      | 41 ++++++++---
 .../rendering/ios-sdk-integration-max.md      | 18 ++---
 .../rendering/ios-sdk-integration-pb.md       | 50 ++++++++++---
 .../modules/rendering/modules-rendering.md    |  7 +-
 .../android/code-integration-android.md       |  3 +-
 .../pbm-api/ios/code-integration-ios.md       |  3 +-
 12 files changed, 232 insertions(+), 81 deletions(-)
 create mode 100644 _includes/mobile/rewarded-server-side-configuration.md

diff --git a/_includes/mobile/rewarded-server-side-configuration.md b/_includes/mobile/rewarded-server-side-configuration.md
new file mode 100644
index 0000000000..12ce47d281
--- /dev/null
+++ b/_includes/mobile/rewarded-server-side-configuration.md
@@ -0,0 +1,72 @@
+##### Server-side Rewarded Ad Unit Configuration
+
+The Rewarded Ad Unit assumes special behavior that should be configurable by the platform or publisher according to the application or ad experience guides.  
+
+Configuration of rewarded ad unit can be done by defining the Prebid Server [passthrough extension](https://docs.prebid.org/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#request-passthrough) or by using a stored impression-level request on the server.
+
+Prebid SDK will search for a particular `rwdd` object in `$.seatbid.bid.ext.prebid.passthrough` of bid response to configure the behavior and rendering of the Rewarded Ad Unit. The following table describes the structure and usage purpose of `rwdd` configuration parameters.  
+
+{: .table .table-bordered .table-striped }
+| Attribute | Type | Description | Example |  
+|-----------|------|-------------|---------|
+| `reward`             | object <br> (optional)   | Metadata provided by the publisher to describe the reward.                                                             |<code>{<br>&nbsp;"type": "SuperDollars",<br>&nbsp;"count": 10<br>}</code> | 
+| `reward.type`        | string   | Type of the reward in the app's coins. | `"SuperDollars"` | 
+| `reward.count`       | integer  | Amount of coins. | `10` | 
+| `reward.ext`         | object   | For future extensions. | <code>{<br>&nbsp;"ext": {}<br>}</code> | 
+| `completion`         | object <br> (optional)   | Describes the condition when the SDK should send a signal to the app that the user has earned the reward. |<code>{<br>&nbsp;"video": {<br>&nbsp;&nbsp;"endcard": {<br>&nbsp;&nbsp;&nbsp;"time": 5 <br>&nbsp;&nbsp;&nbsp;} <br>&nbsp;&nbsp;} <br>}</code> | 
+| `completion.banner`  | object   | Details for banner ad completion. |<code>{<br>&nbsp;"time": 5,<br>&nbsp;"event": "custom_event_url" <br>}</code> | 
+| `completion.banner.time`   | integer  | Period of time the banner ad is on screen. | `5` | 
+| `completion.banner.event`  | string   | URL with custom schema sent by the creative to indicate that the user did earn a reward. | `"rwdd://userDidEarnReward"` | 
+| `completion.video`   | object   | Details for video ad completion. |<code>{<br>&nbsp;"endcard": {<br>&nbsp;&nbsp;"time": 5 <br>&nbsp;} <br>}</code> | 
+| `completion.video.time`    | integer  | Period of time the video ad is on screen. | `10` | 
+| `completion.video.playbackevent` | string   | The playback event stage in the video. | `"start"`, `"firstquartile"`, `"midpoint"`, `"thirdquartile"`, `"complete"` | 
+| `completion.video.endcard` | object   | Properties for the end card. |<code>{<br>&nbsp;"time": 5 <br>}</code> | 
+| `completion.video.endcard.time` | integer  | Period of time the end card is on screen. | `5` | 
+| `completion.video.endcard.event` | string   | URL with custom schema sent by the creative for end card. | `"rwdd://userDidEarnReward"` | 
+| `close`              | object <br> (optional)   | Describes the ad close behavior after the reward is earned. |<code>{<br>&nbsp;"postrewardtime": 3,<br>&nbsp;"action": "autoclose"<br>}</code> | 
+| `close.postrewardtime` | integer  | Time interval (seconds) after reward event when SDK should close interstitial. | `3` | 
+| `close.action`       | string   | Action SDK should make: `"autoclose"` (close interstitial) or `"closebutton"` (show close button) | `"autoclose"` | 
+
+
+An example of an impression-level stored request:
+
+```json
+{
+  "video": {
+    "h": 480,
+    "w": 320,
+    "mimes": ["video/mp4"],
+    "linearity": 1,
+    "placement": 2,
+    "playbackmethod": [2]
+  },
+  "ext": {
+    "prebid": {
+      "passthrough": [
+        {
+          "type": "prebidmobilesdk",
+          "rwdd": {
+            "reward": {
+              "type": "SuperDollars",
+              "count": 10
+            },
+            "completion": {
+              "video": {
+                "endcard": {
+                  "time": 5
+                }
+              }
+            },
+            "close": {
+              "postrewardtime": 3,
+              "action": "autoclose"
+            }
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+More details about the SDK behavior according to the `rwdd` configuration you can find in the [GitHub Proposal](https://github.com/prebid/prebid-mobile-ios/pull/1058).
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
index cca7f118a0..b5f360f20e 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
@@ -186,9 +186,11 @@ Now you should just make a regular AdMob's ad request. Evetything else will be h
 
 Once you receive the ad it will be ready for display. You can show interstitial right in the listener or later according to the app logic.
 
-### Rewarded Video
+### Rewarded 
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration example
 
 ```kotlin
 // 1. Create AsRequest
@@ -230,32 +232,32 @@ adUnit?.fetchDemand { result ->
 }
 ```
 
-#### Step 1: Create AdRequest
+##### Step 1: Create AdRequest
 {:.no_toc}
 
 This step is the same as for the original [AdMob integration](https://developers.google.com/admob/android/rewarded). You don't have to make any modifications here.
 
-#### Step 2: Create AdMobRewardedMediationUtils
+##### Step 2: Create AdMobRewardedMediationUtils
 {:.no_toc}
 
 The `AdMobRewardedMediationUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to adapters.
 
-#### Step 3: Create MediationRewardedVideoAdUnit
+##### Step 3: Create MediationRewardedVideoAdUnit
 {:.no_toc}
 
 The `MediationRewardedVideoAdUnit` is part of the prebid mediation API. This class is responsible for making bid request and managing the winning bid.
 
-#### Step 4: Make a bid request
+##### Step 4: Make a bid request
 {:.no_toc}
 
 The `fetchDemand` method makes a bid request to the prebid server and provides a result in a completion handler.
 
-#### Step 5: Make an ad request
+##### Step 5: Make an ad request
 {:.no_toc}
 
 Now you should just make a regular AdMob's ad request. Evetything else will be handled by GMA SDK and prebid adapters.
 
-#### Step 6: Display an ad
+##### Step 6: Display an ad
 {:.no_toc}
 
 Once you receive the ad it will be ready for display. You can show interstitial right in the listener or later according to the app logic.
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-gam.md b/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
index 502a9d6629..72600a491d 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
@@ -215,9 +215,13 @@ Integration:
 4. Remove the original `InterstitialAdUnit`.
 5. Follow the instructions to integrate [Interstitial API](#interstitials).  
 
-### Rewarded Video
+### Rewarded
 
-To display a Rewarded Ad follow these steps:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration example
+
+Displaying the **Rewarded Ad** is the same as displaying an Interstitial Ad, but it adds ability to handle reward. To display a Rewarded Ad follow these steps:
 
 ```kotlin
 // 1. Create a rewarded custom event handler for GAM ad server.
@@ -243,21 +247,7 @@ Pay attention that the `loadAd()` should be called on the main thread.
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-Displaying the **Rewarded Ad** is the same as displaying an Interstitial Ad. The type of ad can be customized to:
-
-Be notified when user earns a reward - implement `RewardedAdUnitListener` interface:
-
-```kotlin
- fun onUserEarnedReward(rewardedAdUnit: RewardedAdUnit)
-```
-
-When the actual reward object is stored in the `RewardedAdUnit`:
-
-```kotlin
-val reward = rewardedAdUnit.getUserReward()
-```
-
-#### Step 1: Create Event Handler
+##### Step 1: Create Event Handler
 {:.no_toc}
 
 GAM's event handlers are special containers that wrap the GAM Ad Views and help to manage collaboration between GAM and Prebid views.
@@ -266,7 +256,7 @@ GAM's event handlers are special containers that wrap the GAM Ad Views and help
 
 To create an event handler you should provide a GAM Ad Unit.
 
-#### Step 2: Create Rewarded Ad Unit
+##### Step 2: Create Rewarded Ad Unit
 {:.no_toc}
 
 **RewardedAdUnit** - is an object that will load and display the particular ad. To create it you should provide
@@ -276,12 +266,12 @@ To create an event handler you should provide a GAM Ad Unit.
 
 You can also assign the listener for processing ad events.
 
-#### Step 3: Load the Ad
+##### Step 3: Load the Ad
 {:.no_toc}
 
 Call the `loadAd()` method to make a bid request. The ad unit will load an ad and will wait for explicit instructions to display the Rewarded Ad.
 
-#### Step 4: Display the Ad when it is ready
+##### Step 4: Display the Ad when it is ready
 {:.no_toc}
 
 The most convenient way to determine if the ad is ready for displaying is to listen for the listener method:
@@ -292,7 +282,23 @@ override fun onAdLoaded(rewardedAdUnit: RewardedAdUnit) {
 }
 ```
 
-### Migrating rewarded video from a Bidding-Only integration
+##### Step 5: Handle a reward
+{:.no_toc}
+
+Handle earning the reward in the appropriate method. Important: a reward can be null.
+
+```kotlin
+override fun onUserEarnedReward(rewardedAdUnit: RewardedAdUnit?, reward: Reward?) {
+    if (reward != null) {
+        val rewardType = reward.type
+        val rewardCount = reward.count
+        val rewardExt = reward.ext
+        // Process the reward
+    }
+}
+```
+
+#### Migrating rewarded video from a Bidding-Only integration
 {:.no_toc}
 
 GAM setup:
@@ -306,7 +312,7 @@ Integration:
 1. Replace the `RewardedAd` with `RewardedAdUnit`.
 2. Implement the interface for `RewardedAdUnitListener`.
 3. Remove the original `RewardedVideoAdUnit`.
-4. Follow the instructions to integrate [Rewarded API](#rewarded-video).
+4. Follow the instructions to integrate [Rewarded API](#rewarded).
 
 ## Additional Ad Unit Configuration
 
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-max.md b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
index 715d7830a2..a8fa703109 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-max.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
@@ -161,9 +161,11 @@ Now you should make a regular MAX's ad request. Everything else will be handled
 
 Once you receive the ad it will be ready for display. Folow the [MAX instructions](https://dash.applovin.com/documentation/mediation/android/getting-started/interstitials#showing-an-interstitial-ad) about how to do it. 
 
-### Rewarded Video
+### Rewarded 
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration example
 
 ```kotlin
 // 1. Get an instance of MaxRewardedAd
@@ -192,35 +194,36 @@ The way of displaying the rewarded ad is the same as for the Interstitial Ad.
 
 To be notified when user earns a reward follow the [MAX intructions](https://dash.applovin.com/documentation/mediation/android/getting-started/rewarded-ads#accessing-the-amount-and-currency-for-a-rewarded-ad).
 
-#### Step 1: Get an instance of MaxRewardedAd
+##### Step 1: Get an instance of MaxRewardedAd
 {:.no_toc}
 
 This step is totally the same as for original [MAX integration](https://dash.applovin.com/documentation/mediation/android/getting-started/rewarded-ads). You don't have to make any modifications here.
 
-#### Step 2: Create MaxMediationRewardedUtils
+##### Step 2: Create MaxMediationRewardedUtils
 {:.no_toc}
 
 The `MaxMediationRewardedUtils` is a helper class, which performs certain utilty work for the `MediationRewardedVideoAdUnit`, like passing the targeting keywords to the adapters.
 
-#### Step 3: Create MediationRewardedVideoAdUnit
+##### Step 3: Create MediationRewardedVideoAdUnit
 {:.no_toc}
 
 The `MediationRewardeVideoAdUnit` is part of the prebid mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters.  
 
-#### Step 4: Make bid request
+##### Step 4: Make bid request
 {:.no_toc}
 
 The `fetchDemand` method makes a bid request to the prebid server and provides a result in a completion handler.
 
-#### Step 5: Make an Ad Reuest
+##### Step 5: Make an Ad Reuest
 {:.no_toc}
 
 Now you should make a regular MAX's ad request. Everything else will be handled by GMA SDK and prebid adapters.
 
-#### Steps 6: Display an ad
+##### Steps 6: Display an ad
 {:.no_toc}
 
 Once the rewarded ad is received you can display it. Folow the [MAX instructions](https://dash.applovin.com/documentation/mediation/android/getting-started/rewarded-ads#showing-a-rewarded-ad) for the details. 
+
 ### Native Ads
 
 Integration example:
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-pb.md b/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
index 6d6334cc88..9d4ac0ca65 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
@@ -192,9 +192,11 @@ override fun onAdLoaded(interstitialAdUnit: InterstitialAdUnit) {
 }
 ```
 
-#### Rewarded Video
+#### Rewarded
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+##### Integration example
 
 ``` kotlin
 // 1. Create an Ad Unit
@@ -215,19 +217,19 @@ Pay attention that the `loadAd()` should be called on the main thread.
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-##### Step 1: Create a Rewarded Ad Unit
+###### Step 1: Create a Rewarded Ad Unit
 {:.no_toc}
 
 Create the `RewardedAdUnit` object with parameters:
 
 - `adUnitId` - an ID of Stored Impression on the Prebid server.
 
-##### Step 2: Load the Ad
+###### Step 2: Load the Ad
 {:.no_toc}
 
 Call the `loadAd()` to make a bid request.
 
-##### Step 3: Show the Ad when it is ready
+###### Step 3: Show the Ad when it is ready
 {:.no_toc}
 
 Wait until the ad is loaded and present it to the user in any suitable time.
@@ -238,6 +240,22 @@ override fun onAdLoaded(rewardedAdUnit: RewardedAdUnit) {
 }
 ```
 
+##### Step 4: Handle a reward
+{:.no_toc}
+
+Handle earning a reward in the appropriate method. Important: a reward can be null.
+
+```kotlin
+override fun onUserEarnedReward(rewardedAdUnit: RewardedAdUnit?, reward: Reward?) {
+    if (reward != null) {
+        val rewardType = reward.type
+        val rewardCount = reward.count
+        val rewardExt = reward.ext
+        // Process the reward
+    }
+}
+```
+
 ## Additional Ad Unit Configuration
 
 {% include mobile/rendering-adunit-config-android.md %}
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
index cc899357b9..4d0cab980d 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
@@ -235,7 +235,9 @@ Make a regular AdMob's ad request. Everything else will be handled by GMA SDK an
 
 Once you receive the ad it will be ready for display. Follow the [AdMob instructions](https://developers.google.com/admob/ios/interstitial#swift) for displaying an ad.
 
-### Rewarded Video
+### Rewarded
+
+{% include mobile/rewarded-server-side-configuration.md %}
 
 **Integration example(Swift)**:
 
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md b/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
index d6198673c1..1075aa4747 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-gam.md
@@ -185,7 +185,7 @@ Call the method `loadAd()` which will make a bid request to Prebid Server.
 Wait for the Prebid Server to return an ad and show it to the user in any suitable time.
 
 ```swift
-// MARK: InterstitialRenderingAdUnitDelegate
+// MARK: InterstitialAdUnitDelegate
     
 func interstitialDidReceiveAd(_ interstitial: InterstitialAdUnit) {
     // Now the ad is ready for display
@@ -208,9 +208,11 @@ Integration:
 4. Remove original `InterstitialAdUnit`.
 5. Follow the instructions to integrate [Interstitial API](#interstitials).
 
-### Rewarded Video
+### Rewarded
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration example
 
 ```swift
  // 1. Create an Event Handler
@@ -238,9 +240,12 @@ The proccess for displaying the Rewarded Ad is the same as for the Interstitial
 To be notified when a user earns a reward - implement the method of `RewardedAdUnitDelegate`:
 
 ```swift
-- (void)rewardedAdUserDidEarnReward:(RewardedAdUnit *)rewardedAd;
+func rewardedAdUserDidEarnReward(_ rewardedAd: RewardedAdUnit, reward: PrebidReward) {}
 ```
 
+##### Step 1: Create Event Handler
+{:.no_toc}
+
 The reward object is stored in the `RewardedAdUnit`:
 
 {% capture gma12 %}if let reward = rewardedAd.reward as? GoogleMobileAds.AdReward {
@@ -254,12 +259,9 @@ The reward object is stored in the `RewardedAdUnit`:
 
 {% include code/gma-versions-tabs.html id="gam-reward" gma11=gma11 gma12=gma12 %}
 
-#### Step 1: Create Event Handler
-{:.no_toc}
-
 To create an event handler you should provide a **GAM Ad Unit ID**.
 
-#### Step 2: Create Rewarded Ad Unit
+##### Step 2: Create Rewarded Ad Unit
 {:.no_toc}
 
 Create the `RewardedAdUnit` object with parameters:
@@ -267,12 +269,12 @@ Create the `RewardedAdUnit` object with parameters:
 - `configID` - an ID of Stored Impression on the Prebid server
 - `eventHandler` - the instance of rewarded event handler
 
-#### Step 3: Load the Ad
+##### Step 3: Load the Ad
 {:.no_toc}
 
 Call the `loadAd()` method which will make a bid request to Prebid server.
 
-#### Step 4: Show the Ad when it is ready
+##### Step 4: Show the Ad when it is ready
 {:.no_toc}
 
 Wait for the ad to load and display it to the user in any suitable time.
@@ -285,6 +287,23 @@ func rewardedAdDidReceiveAd(_ rewardedAd: RewardedAdUnit) {
 }
 ```
 
+###### Step 4: Handle the reward
+{:.no_toc}
+
+Handle the reward in the appropriate method. 
+
+``` swift
+// MARK: RewardedAdUnitDelegate
+
+func rewardedAdUserDidEarnReward(_ rewardedAd: RewardedAdUnit, reward: PrebidReward) {
+    let type = reward.type
+    let count = reward.count
+    let ext = reward.ext
+        
+    // Process the reward
+}
+```
+
 #### Migrating Rewarded Video from a Bidding-Only integration
 
 GAM setup:
@@ -299,7 +318,7 @@ Integration:
 2. Implement the protocol `RewardedAdUnitDelegate` in the View Controller.
 3. Remove usage of `AdManagerRequest`.
 4. Remove original `RewardedVideoAdUnit`.
-5. Follow the instructions to integrate [Rewarded API](#rewarded-video).
+5. Follow the instructions to integrate [Rewarded API](#rewarded).
 
 ## Additional Ad Unit Configuration
 
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-max.md b/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
index 746d660e17..cd3a541f55 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
@@ -148,9 +148,11 @@ Now you should make a regular MAX's ad request. Everything else will be handled
 
 Once you receive the ad it will be ready for display. Follow the [MAX instructions](https://dash.applovin.com/documentation/mediation/ios/getting-started/interstitials#showing-an-interstitial-ad) for displaying an ad. 
 
-### Rewarded Video
+### Rewarded
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration example
 
 ```swift
 // 1. Get an instance of MARewardedAd
@@ -176,32 +178,32 @@ The process for displaying the rewarded ad is the same as for displaying the Int
 
 To be notified when a user earns a reward follow the [MAX intructions](https://dash.applovin.com/documentation/mediation/ios/getting-started/rewarded-ads#loading-a-rewarded-ad).
 
-#### Step 1: Get an instance of MARewardedAd
+##### Step 1: Get an instance of MARewardedAd
 {:.no_toc}
 
 This step is the same as for the original [MAX integration](https://dash.applovin.com/documentation/mediation/ios/getting-started/rewarded-ads). You don't have to make any modifications here.
 
-#### Step 2: Create MAXMediationRewardedUtils
+##### Step 2: Create MAXMediationRewardedUtils
 {:.no_toc}
 
 The `MAXMediationRewardedUtils` is a helper class, which performs certain utilty work for the `MediationRewardedAdUnit`, like passing the targeting keywords to the adapters.
 
-#### Step 3: Create MediationRewardedAdUnit
+##### Step 3: Create MediationRewardedAdUnit
 {:.no_toc}
 
 The `MediationRewardedAdUnit` is a part of the Prebid Mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters.  
 
-#### Step 4: Make bid request
+##### Step 4: Make bid request
 {:.no_toc}
 
 The `fetchDemand` method makes a bid request to the Prebid Server and provides a result in a completion handler.
 
-#### Step 5: Make an Ad Reuest
+##### Step 5: Make an Ad Reuest
 {:.no_toc}
 
 Make a regular MAX's ad request. Everything else will be handled by GMA SDK and prebid adapters.
 
-#### Steps 6: Display an ad
+##### Steps 6: Display an ad
 {:.no_toc}
 
 Once the rewarded ad is received you can display it. Follow the [MAX instructions](https://dash.applovin.com/documentation/mediation/ios/getting-started/rewarded-ads#showing-a-rewarded-ad) for the details. 
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md b/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
index d41ceb0386..fb6b7e5e55 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
@@ -150,16 +150,16 @@ if interstitial.isReady {
 
 ```
 
-The **default** ad format for interstitial is **.banner**. In order to make a `multiformat bid request`, set the respective values into the `adFormats` property.
+The **default** ad formats for interstitial are **.banner** and **video**. In order to make a banner-only or video-only request, set the respective values into the `adFormats` property.
 
 ``` swift
 // Make bid request for video ad
 adUnit?.adFormats = [.video]
 
-// Make bid request for both video and banner ads
+// Make bid request for both video and banner ads (default behaviour)
 adUnit?.adFormats = [.video, .banner]
 
-// Make bid request for banner ad (default behaviour)
+// Make bid request for banner ad 
 adUnit?.adFormats = [.banner]
 
 ```
@@ -192,9 +192,11 @@ func interstitialDidReceiveAd(_ interstitial: InterstitialRenderingAdUnit) {
 }
 ```
 
-#### Rewarded Video
+#### Rewarded
 
-Integration example:
+{% include mobile/rewarded-server-side-configuration.md %}
+
+##### Integration example
 
 ``` swift
 // 1. Create an Ad Unit
@@ -212,28 +214,54 @@ if rewardedAd.isReady {
 }
 ```
 
-##### Step 1: Create Rewarded Ad Unit
+###### Step 1: Create Rewarded Ad Unit
 {:.no_toc}
 
-Create the `RewardedAdUnit` object with parameter:
+Create the `RewardedAdUnit` object with the parameter:
 
 - `configID` - an ID of Stored Impression on the Prebid Server
 
-##### Step 2: Load the Ad
+You can also customize ad unit by setting additional properties: 
+
+- `adFormats` - the set of ad formats supported by the ad unit(the default value is `[.banner, .video]` formats);
+- `bannerParameters` - the banner parameters used for configuring ad unit;
+- `videoParameters` - the video parameters used for configuring ad unit.
+
+###### Step 2: Load the Ad
 {:.no_toc}
 
 Call the `loadAd()` method which will make a bid request to Prebid server.
 
-##### Step 3: Show the Ad when it is ready
+###### Step 3: Show the Ad when it is ready
 {:.no_toc}
 
-Wait until the ad will be loaded and present it to the user in any suitable time.
+Wait until the ad is loaded and present it to the user at any suitable time.
 
 ``` swift
 // MARK: RewardedAdUnitDelegate
 
 func rewardedAdDidReceiveAd(_ rewardedAd: RewardedAdUnit) {
-    // Now the ad is ready for display
+    // Now the ad is ready for display - call `show` method.
+    if rewardedAd.isReady {
+        rewardedAd.show(from: self)
+    }
+}
+```
+
+###### Step 4: Handle the reward
+{:.no_toc}
+
+Handle the reward in the appropriate method. 
+
+``` swift
+// MARK: RewardedAdUnitDelegate
+
+func rewardedAdUserDidEarnReward(_ rewardedAd: RewardedAdUnit, reward: PrebidReward) {
+    let type = reward.type
+    let count = reward.count
+    let ext = reward.ext
+        
+    // Process the reward
 }
 ```
 
diff --git a/prebid-mobile/modules/rendering/modules-rendering.md b/prebid-mobile/modules/rendering/modules-rendering.md
index 9d82a5efd6..6b1f2cab98 100644
--- a/prebid-mobile/modules/rendering/modules-rendering.md
+++ b/prebid-mobile/modules/rendering/modules-rendering.md
@@ -17,7 +17,6 @@ Starting with `1.14.0-beta1` Prebid mobile supports integration with **AdMob**.
 
 Starting with `2.0.0` Prebid mobile supports integration with **AppLovin MAX**. 
 
-
 ## Supported Ad Formats
 
 Prebid Mobile rendering supports the following ad formats:
@@ -26,7 +25,5 @@ Prebid Mobile rendering supports the following ad formats:
 * Video Banner 
 * Display Interstitial
 * Video Interstitial
-* Rewarded Video
-
-
-
+* Display Rewarded
+* Video Rewarded
diff --git a/prebid-mobile/pbm-api/android/code-integration-android.md b/prebid-mobile/pbm-api/android/code-integration-android.md
index 01adcdc33b..4791cf1ac5 100644
--- a/prebid-mobile/pbm-api/android/code-integration-android.md
+++ b/prebid-mobile/pbm-api/android/code-integration-android.md
@@ -383,7 +383,8 @@ In the table below, you can find Prebid's test IDs that are used in the Demo App
 |`prebid-demo-video-interstitial-320-480-original-api`|**Video Interstitial** (Original API)|Returns a stored response that contains a Video Interstitial 320x480 winning bid.|
 |`prebid-demo-video-interstitial-320-480`|**Video Interstitial** (Rendering API)|Returns a stored response that contains a Video Interstitial 320x480 winning bid.|
 |`prebid-demo-video-rewarded-320-480-original-api`|**Rewarded Video** (Original API)|Returns a stored response that contains a Rewarded Video 320x480 winning bid.|
-|`prebid-demo-video-rewarded-320-480`|**Rewarded Video** (Original API)|Returns a stored response that contains a Rewarded Video 320x480 winning bid.|
+|`prebid-demo-banner-rewarded-time`|**Rewarded HTML** Returns a stored response that contains a Rewarded HTML 320x480 winning bid with rewarded configuration.||
+|`prebid-demo-video-rewarded-endcard-time`|**Rewarded Video** Returns a stored response that contains a Rewarded Video 320x480 winning bid with rewarded configuration.||
 |`sample_video_response`|**Instream Video**|Returns a stored response that contains a Video 320x480 winning bid. Note: on Android we have an [issue](https://github.com/prebid/prebid-mobile-android/issues/517) with Instream Video demo example. When it is fixed the config id will be updated to the new one.|
 |`prebid-demo-banner-native-styles`|**Native Styles**|Returns a stored response that contains a Native winning bid.|
 |`prebid-demo-banner-native-styles`|**In-App Native**|Returns a stored response that contains a Native winning bid.|
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index 84b9f03fe7..c0a7f1c192 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -384,7 +384,8 @@ In the table below, you can find Prebid's test IDs that are used in the Demo App
 |`prebid-demo-video-interstitial-320-480-original-api`|**Video Interstitial** (Original API)|Returns a stored response that contains a Video Interstitial 320x480 winning bid.|
 |`prebid-demo-video-interstitial-320-480`|**Video Interstitial** (Rendering API)|Returns a stored response that contains a Video Interstitial 320x480 winning bid.|
 |`prebid-demo-video-rewarded-320-480-original-api`|**Rewarded Video** (Original API)|Returns a stored response that contains a Rewarded Video 320x480 winning bid.|
-|`prebid-demo-video-rewarded-320-480`|**Rewarded Video** (Original API)|Returns a stored response that contains a Rewarded Video 320x480 winning bid.|
+|`prebid-demo-banner-rewarded-time`|**Rewarded HTML** Returns a stored response that contains a Rewarded HTML 320x480 winning bid with rewarded configuration.||
+|`prebid-demo-video-rewarded-endcard-time`|**Rewarded Video** Returns a stored response that contains a Rewarded Video 320x480 winning bid with rewarded configuration.||
 |`prebid-demo-video-interstitial-320-480`|**Instream Video**|Returns a stored response that contains a Video 320x480 winning bid.|
 |`prebid-demo-banner-native-styles`|**Native Styles**|Returns a stored response that contains a Native winning bid.|
 |`prebid-demo-banner-native-styles`|**In-App Native**|Returns a stored response that contains a Native winning bid.|

From 7b95786fa8b2edda3f1570c2a7643599eb8484c6 Mon Sep 17 00:00:00 2001
From: Kai Miyamoto <157671757+hogekai@users.noreply.github.com>
Date: Fri, 4 Apr 2025 02:38:40 +0900
Subject: [PATCH 086/665] Add renderer reference in ad unit reference (#5969)

* Add renderer reference in ad unit reference

* Fix markdown lint in ad unit reference

* Fix: markdown lint in ad unit reference

* Move renderer reference

* Fix md lint in renderer reference
---
 _data/sidebar.yml            |   8 +
 dev-docs/adunit-reference.md | 655 ++++++++++++++++++-----------------
 dev-docs/renderer.md         | 203 +++++++++++
 3 files changed, 545 insertions(+), 321 deletions(-)
 create mode 100644 dev-docs/renderer.md

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index a193c37130..98a4e60a74 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -399,6 +399,14 @@
   sectionTitle:
   subgroup: 3
 
+- sbSecId: 1
+  title: Renderer
+  link: /dev-docs/renderer.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 3
+
 - sbSecId: 1
   title: Bidder Params
   link: /dev-docs/bidders.html
diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md
index 5a6967b77a..9f3c4af33b 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -27,64 +27,64 @@ This page describes the properties of the `adUnit` object.
 
 ## AdUnit
 
-See the table below for the list of properties on the ad unit.  For example ad units, see the [Examples](#adUnit-examples) below.
+See the table below for the list of properties on the ad unit. For example ad units, see the [Examples](#adUnit-examples) below.
 
 {: .table .table-bordered .table-striped }
-| Name         | Scope    | Type                                  | Description                                                                                                                                                                                |
+| Name | Scope | Type | Description |
 |--------------+----------+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `code`       | Required | String                                | An identifier you create and assign to this ad unit. Generally this is set to the ad slot name or the div element ID. Used by [setTargetingForGPTAsync()](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html) to match which auction is for which ad slot. |
-| `bids`       | Optional | Array[Object]                         | Array of bid objects representing demand partners and associated parameters for a given ad unit.  See [Bids](#adUnit.bids) below.                                                          |
-| `mediaTypes` | Optional | Object                                | Defines one or more media types that can serve into the ad unit.  For a list of properties, see [`adUnit.mediaTypes`](#adUnit.mediaTypes) below.                                           |
-| `labelAny`   | Optional | Array[String]                         | Used for [conditional ads][conditionalAds].  Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive].                                                                    |
-| `labelAll`   | Optional | Array[String]                         | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive].                                                                     |
-| `ortb2Imp`   | Optional | Object                         | ortb2Imp is used to signal OpenRTB Imp objects at the adUnit grain. Similar to the global ortb2 field used for [global first party data configuration](/dev-docs/publisher-api-reference/setConfig.html#setConfig-fpd), but specific to this adunit.|
-| `ttlBuffer`  | Optional | Number                                | TTL buffer override for this adUnit. See [setConfig({ttlBuffer})](/dev-docs/publisher-api-reference/setConfig.html#setConfig-ttlBuffer) |
-| `renderer`   | Optional | Object                         | Custom renderer, typically used for [outstream video](/dev-docs/show-outstream-video-ads.html) |
-| `video`      | Optional | Object                                | Used to link an Ad Unit to the [Video Module][videoModule]. For allowed params see the [adUnit.video reference](#adunitvideo). |
+| `code` | Required | String | An identifier you create and assign to this ad unit. Generally this is set to the ad slot name or the div element ID. Used by [setTargetingForGPTAsync()](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html) to match which auction is for which ad slot. |
+| `bids` | Optional | Array[Object] | Array of bid objects representing demand partners and associated parameters for a given ad unit. See [Bids](#adUnit.bids) below. |
+| `mediaTypes` | Optional | Object | Defines one or more media types that can serve into the ad unit. For a list of properties, see [`adUnit.mediaTypes`](#adUnit.mediaTypes) below. |
+| `labelAny` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
+| `labelAll` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
+| `ortb2Imp` | Optional | Object | ortb2Imp is used to signal OpenRTB Imp objects at the adUnit grain. Similar to the global ortb2 field used for [global first party data configuration](/dev-docs/publisher-api-reference/setConfig.html#setConfig-fpd), but specific to this adunit.|
+| `ttlBuffer` | Optional | Number | TTL buffer override for this adUnit. See [setConfig({ttlBuffer})](/dev-docs/publisher-api-reference/setConfig.html#setConfig-ttlBuffer) |
+| `renderer` | Optional | Object | Custom renderer, typically used for [outstream video](/dev-docs/show-outstream-video-ads.html) |
+| `video` | Optional | Object | Used to link an Ad Unit to the [Video Module][videoModule]. For allowed params see the [adUnit.video reference](#adunitvideo). |
 | `deferBilling` | Optional | Boolean | Used by a publisher to flag adUnits as being separately billable. This allows for a publisher to trigger billing manually for winning bids. See [pbjs.triggerBilling](/dev-docs/publisher-api-reference/triggerBilling.html) and [onBidBillable](/dev-docs/bidder-adaptor.html#registering-on-bid-billable) for more info. |
 
 <a name="adUnit.bids"></a>
 
 ### adUnit.bids
 
-See the table below for the list of properties in the `bids` array of the ad unit.  For example ad units, see the [Examples](#adUnit-examples) below.
+See the table below for the list of properties in the `bids` array of the ad unit. For example ad units, see the [Examples](#adUnit-examples) below.
 
 Note that `bids` is optional only for [Prebid Server stored impressions](#stored-imp), and required in all other cases.
 
 {: .table .table-bordered .table-striped }
-| Name       | Scope    | Type          | Description                                                                                                                              |
+| Name | Scope | Type | Description |
 |------------+----------+---------------+------------------------------------------------------------------------------------------------------------------------------------------|
-| `bidder`   | Optional | String        | Unique code identifying the bidder. For bidder codes, see the [bidder param reference]({{site.baseurl}}/dev-docs/bidders.html).          |
-| `module`   | Optional | String        | Module code - for requesting bids from modules that are not bid adapters. See [Prebid Server stored impressions](#stored-imp). |
-| `params`   | Required | Object        | Bid request parameters for a given bidder. For allowed params, see the [bidder param reference]({{site.baseurl}}/dev-docs/bidders.html). |
-| `labelAny` | Optional | Array[String] | Used for [conditional ads][conditionalAds].  Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive].                  |
-| `labelAll` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive].                   |
-| `ortb2Imp` | Optional | Object        | OpenRTB first-party data specific to this bidder. This is merged with, and takes precedence over, `adUnit.ortb2Imp`.|
-| `renderer` | Optional | Object        | Custom renderer. Takes precedence over `adUnit.renderer`, but applies only to this bidder. |
+| `bidder` | Optional | String | Unique code identifying the bidder. For bidder codes, see the [bidder param reference]({{site.baseurl}}/dev-docs/bidders.html). |
+| `module` | Optional | String | Module code - for requesting bids from modules that are not bid adapters. See [Prebid Server stored impressions](#stored-imp). |
+| `params` | Required | Object | Bid request parameters for a given bidder. For allowed params, see the [bidder param reference]({{site.baseurl}}/dev-docs/bidders.html). |
+| `labelAny` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
+| `labelAll` | Optional | Array[String] | Used for [conditional ads][conditionalAds]. Works with `sizeConfig` argument to [pbjs.setConfig][configureResponsive]. |
+| `ortb2Imp` | Optional | Object | OpenRTB first-party data specific to this bidder. This is merged with, and takes precedence over, `adUnit.ortb2Imp`.|
+| `renderer` | Optional | Object | Custom renderer. Takes precedence over `adUnit.renderer`, but applies only to this bidder. |
 
 <a name="adUnit.mediaTypes"></a>
 
 ### adUnit.mediaTypes
 
-See the table below for the list of properties in the `mediaTypes` object of the ad unit.  For example ad units showing the different media types, see the [Examples](#adUnit-examples) below.
+See the table below for the list of properties in the `mediaTypes` object of the ad unit. For example ad units showing the different media types, see the [Examples](#adUnit-examples) below.
 
 {: .table .table-bordered .table-striped }
-| Name                                  | Scope                                                                    | Type   | Description                                                                                                      |
+| Name | Scope | Type | Description |
 |---------------------------------------+--------------------------------------------------------------------------+--------+------------------------------------------------------------------------------------------------------------------|
-| [`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).      |
+| [`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). |
 
 <a name="adUnit.mediaTypes.banner"></a>
 
 #### adUnit.mediaTypes.banner
 
 {: .table .table-bordered .table-striped }
-| Name    | Scope    | Type                                  | Description                                                                             |
+| Name | Scope | Type | Description |
 |---------+----------+---------------------------------------+-----------------------------------------------------------------------------------------|
-| `sizes` | Required | Array[Number] or Array[Array[Number]] | All sizes this ad unit can accept.  Examples: `[400, 600]`, `[[300, 250], [300, 600]]`. Prebid recommends that the sizes auctioned by Prebid should be the same auctioned by AdX and GAM OpenBidding, which means AdUnit sizes should match the GPT sizes. |
-| `pos`  | Optional | Integer                                | OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen   |
-| `name`  | Optional | String                                | Name for this banner ad unit.  Can be used for testing and debugging.                   |
+| `sizes` | Required | Array[Number] or Array[Array[Number]] | All sizes this ad unit can accept. Examples: `[400, 600]`, `[[300, 250], [300, 600]]`. Prebid recommends that the sizes auctioned by Prebid should be the same auctioned by AdX and GAM OpenBidding, which means AdUnit sizes should match the GPT sizes. |
+| `pos` | Optional | Integer | OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
+| `name` | Optional | String | Name for this banner ad unit. Can be used for testing and debugging. |
 
 <a name="adUnit.mediaTypes.native"></a>
 
@@ -99,46 +99,46 @@ See [Prebid Native Implementation](/prebid/native-implementation.html) for detai
 #### adUnit.mediaTypes.video
 
 {: .table .table-bordered .table-striped }
-| Name             | Scope       | Type                   | Description                                                                                                                                                         |
+| Name | Scope | Type | Description |
 |------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `pos`  | Optional | Integer                                | Ad position on screen, see [OpenRTB 2.5 spec][openRTB]. OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen   |
-| `context`        | Recommended    | String                 | The video context, either `'instream'`, `'outstream'`, or `'adpod'` (for long-form videos).  Example: `context: 'outstream'`. Defaults to 'instream'. |
-| `useCacheKey`        | Optional    | Boolean                 | Defaults to `false`. While context `'instream'` always will return an vastUrl in bidResponse, `'outstream'` will not. Setting this `true` will use cache url defined in global options also for outstream responses. |
-| `placement`        | Recommended    | Integer                 | 1=in-stream, 2=in-banner, 3=in-article, 4=in-feed, 5=interstitial/floating. **Highly recommended** because some bidders require more than context=outstream. |
-| `plcmt`        | Recommended    | Integer                 | 1=in-stream, 2=accompanying content, 3=interstitial, 4=no content/standalone. **Highly recommended** to comply with new IAB video specifications. See [AdCOM v1 spec](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo) |
-| `playerSize`     | Optional    | Array[Integer,Integer] | The size (width, height) of the video player on the page, in pixels.  Example: `playerSize: [640, 480]`                                                                                                  |
-| `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 video player or video ads SDK supports [Open Measurement][OpenMeasurement], **recommended** to set `7` for OMID-1|
-| `mimes`          | Recommended | Array[String]          | Content MIME types supported, e.g., `"video/x-ms-wmv"`, `"video/mp4"`. **Required by OpenRTB when using [Prebid Server][pbServer]**.                                                                                   |
-| `protocols`      | Optional    | Array[Integer]         | Array of supported video protocols.  For list, see [OpenRTB 2.5 spec][openRTB]. **Required by OpenRTB when using [Prebid Server][pbServer]**.                                                                            |
-| `playbackmethod` | Optional    | Array[Integer]         | Allowed playback methods. If none specified, all are allowed.  For list, see [OpenRTB 2.5 spec][openRTB]. **Required by OpenRTB when using [Prebid Server][pbServer]**.                                                     |
-| `minduration`      | Recommended    | Integer         | Minimum video ad duration in seconds, see [OpenRTB 2.5 spec][openRTB].           |
-| `maxduration`      | Recommended    | Integer         | Maximum video ad duration in seconds, see [OpenRTB 2.5 spec][openRTB].           |
-| `w`      | Recommended    | Integer         | Width of the video player in device independent pixels (DIPS)., see [OpenRTB 2.5 spec][openRTB].           |
-| `h`      | Recommended    | Integer         | Height of the video player in device independent pixels (DIPS)., see [OpenRTB 2.5 spec][openRTB].           |
-| `startdelay`      | Recommended    | Integer         | Indicates the start delay in seconds, see [OpenRTB 2.5 spec][openRTB].           |
-| `linearity`      | Optional    | Integer         | Indicates if the impression must be linear, nonlinear, etc, see [OpenRTB 2.5 spec][openRTB].           |
-| `skip`      | Optional    | Integer         | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes., see [OpenRTB 2.5 spec][openRTB].           |
-| `skipmin`      | Optional    | Integer         | Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable., see [OpenRTB 2.5 spec][openRTB].           |
-| `skipafter`      | Optional    | Integer         | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable., 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].           |
-| `playbackend`      | Optional    | Integer         | The event that causes playback to end, see [OpenRTB 2.5 spec][openRTB].           |
-
-If `'video.context'` is set to `'adpod'` then the following parameters are also available.  
+| `pos` | Optional | Integer | Ad position on screen, see [OpenRTB 2.5 spec][openRTB]. OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
+| `context` | Recommended | String | The video context, either `'instream'`, `'outstream'`, or `'adpod'` (for long-form videos). Example: `context: 'outstream'`. Defaults to 'instream'. |
+| `useCacheKey` | Optional | Boolean | Defaults to `false`. While context `'instream'` always will return an vastUrl in bidResponse, `'outstream'` will not. Setting this `true` will use cache url defined in global options also for outstream responses. |
+| `placement` | Recommended | Integer | 1=in-stream, 2=in-banner, 3=in-article, 4=in-feed, 5=interstitial/floating. **Highly recommended** because some bidders require more than context=outstream. |
+| `plcmt` | Recommended | Integer | 1=in-stream, 2=accompanying content, 3=interstitial, 4=no content/standalone. **Highly recommended** to comply with new IAB video specifications. See [AdCOM v1 spec](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo) |
+| `playerSize` | Optional | Array[Integer,Integer] | The size (width, height) of the video player on the page, in pixels. Example: `playerSize: [640, 480]` |
+| `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 video player or video ads SDK supports [Open Measurement][OpenMeasurement], **recommended** to set `7` for OMID-1|
+| `mimes` | Recommended | Array[String] | Content MIME types supported, e.g., `"video/x-ms-wmv"`, `"video/mp4"`. **Required by OpenRTB when using [Prebid Server][pbServer]**. |
+| `protocols` | Optional | Array[Integer] | Array of supported video protocols. For list, see [OpenRTB 2.5 spec][openRTB]. **Required by OpenRTB when using [Prebid Server][pbServer]**. |
+| `playbackmethod` | Optional | Array[Integer] | Allowed playback methods. If none specified, all are allowed. For list, see [OpenRTB 2.5 spec][openRTB]. **Required by OpenRTB when using [Prebid Server][pbServer]**. |
+| `minduration` | Recommended | Integer | Minimum video ad duration in seconds, see [OpenRTB 2.5 spec][openRTB]. |
+| `maxduration` | Recommended | Integer | Maximum video ad duration in seconds, see [OpenRTB 2.5 spec][openRTB]. |
+| `w` | Recommended | Integer | Width of the video player in device independent pixels (DIPS)., see [OpenRTB 2.5 spec][openRTB]. |
+| `h` | Recommended | Integer | Height of the video player in device independent pixels (DIPS)., see [OpenRTB 2.5 spec][openRTB]. |
+| `startdelay` | Recommended | Integer | Indicates the start delay in seconds, see [OpenRTB 2.5 spec][openRTB]. |
+| `linearity` | Optional | Integer | Indicates if the impression must be linear, nonlinear, etc, see [OpenRTB 2.5 spec][openRTB]. |
+| `skip` | Optional | Integer | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes., see [OpenRTB 2.5 spec][openRTB]. |
+| `skipmin` | Optional | Integer | Videos of total duration greater than this number of seconds can be skippable; only applicable if the ad is skippable., see [OpenRTB 2.5 spec][openRTB]. |
+| `skipafter` | Optional | Integer | Number of seconds a video must play before skipping is enabled; only applicable if the ad is skippable., 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]. |
+| `playbackend` | Optional | Integer | The event that causes playback to end, see [OpenRTB 2.5 spec][openRTB]. |
+
+If `'video.context'` is set to `'adpod'` then the following parameters are also available.
 
 {: .table .table-bordered .table-striped }
-| Name             | Scope       | Type                   | Description                                                                                                                                                         |
+| Name | Scope | Type | Description |
 |------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `adPodDurationSec`        | Required    | Number                 | The length of the adpod in seconds. Example: `adPodDurationSec = 120` |
-| `durationRangeSec`        | Required    | Array[Number]                 | An array of  numbers represents a list of the potential/accepted duration values that the creatives can be in the adpod block. Example: `durationRangeSec = [30, 60, 90]` |
-| `requireExactDuration`        | Optional    | Boolean                 | Whether the returned creatives running time must match the value of `adPodDurationSec`. Example: `requireExactDuration = true` |
-| `tvSeriesName`        | Optional    | String                 | The name of the television series video the adpod will appear in. Example: `tvSeriesName = 'Once Upon A Time'` |
-| `tvEpisodeName`        | Optional    | String                 | The name of the episode of the television series video the adpod will appear in. Example: `tvEpisodeName = 'Pilot'` |
-| `tvSeasonNumber`        | Optional    | Number                 | A number representing the season number of the television series video  the adpod will appear in. Example: `tvSeasonNumber = 1` |
-| `tvEpisodeNumber`        | Optional    | Number                 | A number representing the episode number of the television series video the adpod will appear in. Example: `tvEpisodeNumber = 1` |
-| `contentLengthSec`        | Optional    | Number                 | A number representing the length of the video in seconds. Example: `contentLengthSec = 1` |
-| `contentMode`        | Optional    | String                 | A string indicating the type of content being displayed in the video player. There are two options, `live` and `on-demand`. Example: `contentMode = 'on-demand'` |
+| `adPodDurationSec` | Required | Number | The length of the adpod in seconds. Example: `adPodDurationSec = 120` |
+| `durationRangeSec` | Required | Array[Number] | An array of numbers represents a list of the potential/accepted duration values that the creatives can be in the adpod block. Example: `durationRangeSec = [30, 60, 90]` |
+| `requireExactDuration` | Optional | Boolean | Whether the returned creatives running time must match the value of `adPodDurationSec`. Example: `requireExactDuration = true` |
+| `tvSeriesName` | Optional | String | The name of the television series video the adpod will appear in. Example: `tvSeriesName = 'Once Upon A Time'` |
+| `tvEpisodeName` | Optional | String | The name of the episode of the television series video the adpod will appear in. Example: `tvEpisodeName = 'Pilot'` |
+| `tvSeasonNumber` | Optional | Number | A number representing the season number of the television series video the adpod will appear in. Example: `tvSeasonNumber = 1` |
+| `tvEpisodeNumber` | Optional | Number | A number representing the episode number of the television series video the adpod will appear in. Example: `tvEpisodeNumber = 1` |
+| `contentLengthSec` | Optional | Number | A number representing the length of the video in seconds. Example: `contentLengthSec = 1` |
+| `contentMode` | Optional | String | A string indicating the type of content being displayed in the video player. There are two options, `live` and `on-demand`. Example: `contentMode = 'on-demand'` |
 
 <a name="adUnit-examples"></a>
 
@@ -152,9 +152,9 @@ See the table below for the list of properties in the `video` object of the ad u
 When using the Video Module, the mediaTypes.video properties get filled out automatically. Any values already set by the Publisher will not be replaced by the Video Module.
 
 {: .table .table-bordered .table-striped }
-| Field     | Scope                                                        | Type   | Description                                                                                                        |
+| Field | Scope | Type | Description |
 |----------+--------------------------------------------------------------+--------+--------------------------------------------------------------------------------------------------------------------|
-| `divId` | required | string | Unique identifier of the player provider, used to specify which player should be used to render the ad. Equivalent to the HTML Div Id of the player.                  |
+| `divId` | required | string | Unique identifier of the player provider, used to specify which player should be used to render the ad. Equivalent to the HTML Div Id of the player. |
 | `adServer` | optional | object | Configuration for ad server integration. Supersedes `video.adServer` configurations defined in the Prebid Config. |
 | `adServer.vendorCode` | required if `adServer` is defined | string | The identifier of the AdServer vendor (i.e. gam, etc). |
 | `adServer.baseAdTagUrl` | required if `adServer.params` is not defined | string | Your AdServer Ad Tag. The targeting params of the winning bid will be appended. |
@@ -163,7 +163,7 @@ When using the Video Module, the mediaTypes.video properties get filled out auto
 ## Examples
 
 * [Banner](#adUnit-banner-example)
-* [Video](#adUnit-video-example)  
+* [Video](#adUnit-video-example)
   * [With the Video Module](#adUnit-video-module-example)
   * [Instream Sound-On](#adUnit-video-example-instream)
   * [Accompanying Content](#adUnit-video-example-accompanying)
@@ -178,24 +178,24 @@ When using the Video Module, the mediaTypes.video properties get filled out auto
 
 ### Banner
 
-For an example of a banner ad unit, see below.  For more detailed instructions, see [Getting Started]({{site.baseurl}}/dev-docs/getting-started.html).
+For an example of a banner ad unit, see below. For more detailed instructions, see [Getting Started]({{site.baseurl}}/dev-docs/getting-started.html).
 
 ```javascript
 pbjs.addAdUnits({
-    code: slot.code,
-    mediaTypes: {
-        banner: {
-            sizes: [[300, 250]]
-        }
+  code: slot.code,
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]],
     },
-    bids: [
-        {
-            bidder: 'appnexus',
-            params: {
-                placementId: 13144370
-            }
-        }
-    ]
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13144370,
+      },
+    },
+  ],
 });
 ```
 
@@ -211,23 +211,25 @@ For an example of a video ad unit linked to the Video Module, see below. For mor
 
 ```javascript
 pbjs.addAdUnits({
-    code: slot.code,
-    mediaTypes: {
-        video: {},
+  code: slot.code,
+  mediaTypes: {
+    video: {},
+  },
+  video: {
+    divId: "playerDiv",
+    adServer: {
+      vendorCode: "gam", // constant variable is GAM_VENDOR - see vendorCodes.js in the video library
+      baseAdTagUrl: "https://pubads.g.doubleclick.net/gampad/ads?iu=/12345/",
     },
-    video: {
-        divId: 'playerDiv',
-        adServer: {
-            vendorCode: 'gam', // constant variable is GAM_VENDOR - see vendorCodes.js in the video library
-            baseAdTagUrl: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/12345/'
-        }
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13232361,
+      },
     },
-    bids: [{
-        bidder: 'appnexus',
-        params: {
-            placementId: 13232361
-        }
-    }]
+  ],
 });
 ```
 
@@ -239,24 +241,26 @@ For an example of an instream video ad unit that you handle on your own, see bel
 
 ```javascript
 pbjs.addAdUnits({
-    code: slot.code,
-    mediaTypes: {
-        video: {
-            context: 'instream',
-            plcmt: 1,
-            playerSize: [640, 480],
-            mimes: ['video/mp4'],
-            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [5],
-            skip: 1
-        },
+  code: slot.code,
+  mediaTypes: {
+    video: {
+      context: "instream",
+      plcmt: 1,
+      playerSize: [640, 480],
+      mimes: ["video/mp4"],
+      protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+      playbackmethod: [5],
+      skip: 1,
     },
-    bids: [{
-        bidder: 'appnexus',
-        params: {
-            placementId: 13232361
-        }
-    }]
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13232361,
+      },
+    },
+  ],
 });
 ```
 
@@ -268,24 +272,26 @@ The IAB calls this scenario "Accompanying Content". Previously, this might have
 
 ```javascript
 pbjs.addAdUnits({
-    code: slot.code,
-    mediaTypes: {
-        video: {
-            context: 'instream',
-            plcmt: 2,
-            playerSize: [640, 480],
-            mimes: ['video/mp4'],
-            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [6],
-            skip: 1
-        },
+  code: slot.code,
+  mediaTypes: {
+    video: {
+      context: "instream",
+      plcmt: 2,
+      playerSize: [640, 480],
+      mimes: ["video/mp4"],
+      protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+      playbackmethod: [6],
+      skip: 1,
     },
-    bids: [{
-        bidder: 'appnexus',
-        params: {
-            placementId: 13232361
-        }
-    }]
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13232361,
+      },
+    },
+  ],
 });
 ```
 
@@ -295,7 +301,7 @@ pbjs.addAdUnits({
 
 This is the scenario formerly known as Outstream. As of April 2023, the IAB now calls this scenario "No Content/Standalone".
 
-For an example of an outstream video ad unit that you handle on your own, see below.  For more detailed instructions, see [Show Outstream Video Ads]({{site.baseurl}}/dev-docs/show-outstream-video-ads.html).
+For an example of an outstream video ad unit that you handle on your own, see below. For more detailed instructions, see [Show Outstream Video Ads]({{site.baseurl}}/dev-docs/show-outstream-video-ads.html).
 
 ```javascript
 pbjs.addAdUnits({
@@ -357,7 +363,7 @@ pbjs.addAdUnits({
 
 #### Adpod (Long-Form)
 
-For an example of an adpod video ad unit that you handle on your own, see below.  For more detailed instructions, see [Show Long-Form Video Ads]({{site.baseurl}}/prebid-video/video-long-form.html).
+For an example of an adpod video ad unit that you handle on your own, see below. For more detailed instructions, see [Show Long-Form Video Ads]({{site.baseurl}}/prebid-video/video-long-form.html).
 
 ```javascript
 var longFormatAdUnit = {
@@ -391,57 +397,63 @@ var longFormatAdUnit = {
 
 ### Native
 
-For an example of a native ad unit, see below.  For more detailed instructions, see [Show Native Ads]({{site.baseurl}}/dev-docs/show-native-ads.html).
+For an example of a native ad unit, see below. For more detailed instructions, see [Show Native Ads]({{site.baseurl}}/dev-docs/show-native-ads.html).
 
 ```javascript
 pbjs.addAdUnits({
-    code: slot.code,
-    mediaTypes: {
-        native: {
-            ortb: {
-                ver: "1.2",
-                assets: [{
-                    required: 1,
-                    img: {
-                type: 1,
-                        hmin: 50
-                    },
-        },{
-                    required: 1,
-                    title: {
-                        len: 80
-                    },
-        },{
-                    required: 1,
-                    data: {
-                        type: 1,
-                        len: 30
-                    },
-        },{
-                    required: 1,
-                    data: {
-                        type: 2,
-                        len: 100
-                    },
-        },{
-                    required: 1,
-                    img: {
-                        type: 3,
-                        hmin: 200,
-                        wmin: 267
-                    }
-                }]
-        }
-    }
+  code: slot.code,
+  mediaTypes: {
+    native: {
+      ortb: {
+        ver: "1.2",
+        assets: [
+          {
+            required: 1,
+            img: {
+              type: 1,
+              hmin: 50,
+            },
+          },
+          {
+            required: 1,
+            title: {
+              len: 80,
+            },
+          },
+          {
+            required: 1,
+            data: {
+              type: 1,
+              len: 30,
+            },
+          },
+          {
+            required: 1,
+            data: {
+              type: 2,
+              len: 100,
+            },
+          },
+          {
+            required: 1,
+            img: {
+              type: 3,
+              hmin: 200,
+              wmin: 267,
+            },
+          },
+        ],
+      },
     },
-    bids: [
-        {
-            bidder: 'appnexus',
-            params: {
-                placementId: 13232354
-            }
-        }
-    ]
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13232354,
+      },
+    },
+  ],
 });
 ```
 
@@ -449,94 +461,97 @@ pbjs.addAdUnits({
 
 ### Multi-Format
 
-For an example of a multi-format ad unit, see below.  For more detailed instructions, see [Show Multi-Format Ads]({{site.baseurl}}/dev-docs/show-multi-format-ads.html).
+For an example of a multi-format ad unit, see below. For more detailed instructions, see [Show Multi-Format Ads]({{site.baseurl}}/dev-docs/show-multi-format-ads.html).
 
 ```javascript
-
-pbjs.addAdUnits([{
-        code: 'div-banner-native',
-        mediaTypes: {
-            banner: {
-                sizes: [
-                    [300, 250]
-                ]
-            },
-            native: {
+pbjs.addAdUnits([
+  {
+    code: "div-banner-native",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]],
+      },
+      native: {
         ortb: {
-            ver: "1.2",
-            assets: [{
-            required: 1,
-                    img: {
+          ver: "1.2",
+          assets: [
+            {
+              required: 1,
+              img: {
                 type: 1,
-                hmin: 50
-            }
-            }]
-        }
+                hmin: 50,
+              },
             },
+          ],
         },
-        bids: [{
-            bidder: 'appnexus',
-            params: {
-                placementId: 13232392,
-            }
-        }]
+      },
     },
-
-    {
-        code: 'div-banner-outstream',
-        mediaTypes: {
-            banner: {
-                sizes: [
-                    [300, 250]
-                ]
-            },
-            video: {
-                context: 'outstream',
-                playerSize: [300, 250]
-            },
+    bids: [
+      {
+        bidder: "appnexus",
+        params: {
+          placementId: 13232392,
         },
-        bids: [{
-            bidder: 'appnexus',
-            params: {
-                placementId: 13232392,
-            }
-        }, ]
+      },
+    ],
+  },
+
+  {
+    code: "div-banner-outstream",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]],
+      },
+      video: {
+        context: "outstream",
+        playerSize: [300, 250],
+      },
     },
+    bids: [
+      {
+        bidder: "appnexus",
+        params: {
+          placementId: 13232392,
+        },
+      },
+    ],
+  },
 
-    {
-        code: 'div-banner-outstream-native',
-        mediaTypes: {
-            banner: {
-                sizes: [
-                    [300, 250]
-                ]
-            },
-            native: {
+  {
+    code: "div-banner-outstream-native",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]],
+      },
+      native: {
         ortb: {
-            ver: "1.2",
-            assets: [{
-            required: 1,
-                    img: {
+          ver: "1.2",
+          assets: [
+            {
+              required: 1,
+              img: {
                 type: 1,
-                hmin: 50
-            }
-            }]
-        }
-            },
-            video: {
-                context: 'outstream',
-                playerSize: [300, 250]
+                hmin: 50,
+              },
             },
+          ],
         },
-        bids: [{
-            bidder: 'appnexus',
-            params: {
-                placementId: 13232392,
-            }
-        }, ]
-    }
+      },
+      video: {
+        context: "outstream",
+        playerSize: [300, 250],
+      },
+    },
+    bids: [
+      {
+        bidder: "appnexus",
+        params: {
+          placementId: 13232392,
+        },
+      },
+    ],
+  },
 ]);
-
 ```
 
 <a name="adUnit-twin-codes-example"></a>
@@ -605,23 +620,21 @@ Example of an adunit-specific block of first party data and a static floor:
 
 ```javascript
 pbjs.addAdUnits({
-    code: "test-div",
-    mediaTypes: {
-        banner: {
-            sizes: [[300,250]]
-        }
+  code: "test-div",
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]],
     },
-    ortb2Imp: {
-        bidfloor: 1.00,
-        bidfloorcur: "EUR",
-        ext: {
-            data: {
-                    pbadslot: "homepage-top-rect",
-                    adUnitSpecificContextAttribute: "123"
-            }
-        }
+  },
+  ortb2Imp: {
+    ext: {
+      data: {
+        pbadslot: "homepage-top-rect",
+        adUnitSpecificContextAttribute: "123",
+      },
     },
-    // ...
+  },
+  // ...
 });
 ```
 
@@ -638,16 +651,16 @@ Example of an adunit-specific interstitial signal:
 
 ```javascript
 pbjs.addAdUnits({
-    code: "test-div",
-    mediaTypes: {
-        banner: {
-            sizes: [[300,250]]
-        }
-    },
-    ortb2Imp: {
-        instl:1
+  code: "test-div",
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]],
     },
-    // ...
+  },
+  ortb2Imp: {
+    instl: 1,
+  },
+  // ...
 });
 ```
 
@@ -661,60 +674,60 @@ When using [PBS stored impressions](/dev-docs/modules/prebidServer.html#stored-i
 
 ```javascript
 pbjs.addAdUnits({
-    code: "test-div",
-    ortb2Imp: {
-        ext: {
-            prebid: {
-                storedrequest: {
-                    id: 'stored-request-id'
-                }
-            }
-        }
-    }
-})
+  code: "test-div",
+  ortb2Imp: {
+    ext: {
+      prebid: {
+        storedrequest: {
+          id: "stored-request-id",
+        },
+      },
+    },
+  },
+});
 ```
 
 To use stored impressions together with client-side bidders - or stored impressions from other instances of Prebid Server - use `bids[].module`:
 
 ```javascript
 pbjs.addAdUnits({
-    code: "test-div",
-    bids: [
-        {
-            module: "pbsBidAdapter",
-            params: {
-                configName: "server-1"
+  code: "test-div",
+  bids: [
+    {
+      module: "pbsBidAdapter",
+      params: {
+        configName: "server-1",
+      },
+      ortb2Imp: {
+        ext: {
+          prebid: {
+            storedrequest: {
+              id: "stored-request-server-1",
             },
-            ortb2Imp: {
-                ext: {
-                    prebid: {
-                        storedrequest: {
-                            id: 'stored-request-server-1'
-                        }
-                    }
-                }
-            }
+          },
         },
-        {
-            module: "pbsBidAdapter",
-            params: {
-                configName: "server-2"
+      },
+    },
+    {
+      module: "pbsBidAdapter",
+      params: {
+        configName: "server-2",
+      },
+      ortb2Imp: {
+        ext: {
+          prebid: {
+            storedrequest: {
+              id: "stored-request-server-2",
             },
-            ortb2Imp: {
-                ext: {
-                    prebid: {
-                        storedrequest: {
-                            id: 'stored-request-server-2'
-                        }
-                    }
-                }
-            }
+          },
         },
-        {
-            bidder: 'client-bidder',
-            // ...
-        }
-    ]
+      },
+    },
+    {
+      bidder: "client-bidder",
+      // ...
+    },
+  ],
 });
 ```
 
diff --git a/dev-docs/renderer.md b/dev-docs/renderer.md
new file mode 100644
index 0000000000..879e624eea
--- /dev/null
+++ b/dev-docs/renderer.md
@@ -0,0 +1,203 @@
+---
+layout: page_v2
+title: Renderer
+description: Renderer Reference
+sidebarType: 1
+---
+
+# Renderer
+
+## What is a Renderer?
+
+A renderer provides publishers with precise control over how ads are displayed on their pages. It's especially valuable for video ads in non-video placements (such as outstream/in-renderer), but can be used with any media type.
+
+In simple terms, a renderer offers publishers:
+
+- The ability to customize how ads appear and behave
+- A way to introduce new ad formats without disrupting user experience
+- Control over maintaining design consistency between ads and site content
+
+## Renderer Object
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Type | Description |
+|--------------+----------+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `url` | Required | String | URL to the renderer script that will be loaded. This script should create a renderer object in the global scope. |
+| `render` | Required | Function | Function that tells Prebid.js how to invoke the renderer script to render a bid. The function receives the bid object as a parameter. |
+| `backupOnly` | Optional | Boolean | if set to true, buyer or adapter renderer will be preferred |
+
+## Renderer Implementation Levels
+
+Renderers can be specified at multiple levels:
+
+1. MediaType Level (adUnit.mediaTypes.video|banner|native.renderer): If a renderer is associated with a specific mediaType (video, banner, or native), it will be used to display any demand associated with that mediaType. This is the preferred method for all ad types.
+2. AdUnit Level (adUnit.renderer): Applied to all bids for this ad unit that don't override it. This is a legacy approach; using the mediaType-level renderer is preferred.
+3. Bidder Level (adUnit.bids[].renderer): Applied only to this bidder, overriding adUnit renderer if both exist.
+4. Default: If no renderer is specified at any level, Prebid will use the default renderer for the media type, if one exists. For banner and native ads, Prebid.js has built-in default rendering capabilities.
+
+### Priority Order
+
+When multiple renderers are defined, the following priority is used:
+
+1. MediaType Level renderer
+2. AdUnit Level renderer
+3. Bidder Level renderer
+4. Default renderer
+
+## Special Cases
+
+### Banner with Custom Renderer
+
+Although renderers are commonly associated with video ads, they can also be used with banner ads to create custom rendering experiences:
+
+```javascript
+pbjs.addAdUnits({
+  code: "custom-banner-container",
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]],
+      renderer: {
+        url: "https://cdn.example.com/banner-renderer.js",
+        render: function (bid) {
+          // Create an enhanced banner experience
+          const bannerRenderer = new window.BannerRenderer({
+            adUnitCode: bid.adUnitCode,
+            adHtml: bid.ad,
+            width: bid.width,
+            height: bid.height,
+            // Add animation effects
+            effects: {
+              fadeIn: true,
+              duration: 300,
+              onViewable: true,
+            },
+          });
+          bannerRenderer.render();
+        },
+      },
+    },
+  },
+  bids: [
+    {
+      bidder: "appnexus",
+      params: {
+        placementId: 13144370,
+      },
+    },
+  ],
+});
+```
+
+A banner renderer might be used to:
+
+1. Add entrance/exit animations to standard banner ads
+2. Implement viewability-triggered rendering
+3. Create interactive enhancements to standard banner creatives
+4. Apply custom styling or containers to maintain site design aesthetics
+5. Implement fallback scenarios for different devices or browsers
+
+## Renderer Implementation Example
+
+```javascript
+// Example of a secure custom banner renderer implementation
+window.BannerRenderer = function (config) {
+  return {
+    render: function (bid) {
+      // Get the container element
+      const container = document.getElementById(config.adUnitCode);
+      if (!container) return;
+
+      // Create iframe to provide a secure environment
+      const iframe = document.createElement("iframe");
+      iframe.width = `${config.width}px`;
+      iframe.height = `${config.height}px`;
+      iframe.style.border = "none";
+      iframe.style.transition = `opacity ${config.effects.duration}ms ease-in-out`;
+      iframe.style.opacity = "0";
+      iframe.title = "Advertisement";
+      iframe.setAttribute("scrolling", "no");
+
+      // Add iframe to container
+      container.appendChild(iframe);
+
+      // Set iframe content
+      const iframeDoc = iframe.contentWindow.document;
+      iframeDoc.open();
+      iframeDoc.write(`
+        <!DOCTYPE html>
+        <html>
+        <head>
+          <meta charset="utf-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1">
+          <style>
+            body { margin: 0; padding: 0; overflow: hidden; }
+            .ad-container { 
+              width: 100%; 
+              height: 100%; 
+              position: relative;
+              background-color: #ffffff;
+            }
+          </style>
+        </head>
+        <body>
+          <div class="ad-container">${bid.ad || ""}</div>
+        </body>
+        </html>
+      `);
+      iframeDoc.close();
+
+      if (config.effects.onViewable) {
+        // Set up IntersectionObserver for viewability-triggered effects
+        const observer = new IntersectionObserver(
+          (entries) => {
+            entries.forEach((entry) => {
+              if (entry.isIntersecting) {
+                // Apply fade-in when ad comes into view
+                iframe.style.opacity = "1";
+                observer.disconnect(); // Only need to trigger once
+              }
+            });
+          },
+          { threshold: 0.5 }
+        );
+
+        observer.observe(container);
+      } else {
+        // Immediate fade-in
+        setTimeout(() => {
+          iframe.style.opacity = "1";
+        }, 10);
+      }
+
+      // Cleanup function
+      return {
+        destroy: function () {
+          if (container && iframe) {
+            container.removeChild(iframe);
+          }
+        },
+      };
+    },
+  };
+};
+```
+
+## Common Renderer Properties
+
+Here are commonly used properties from the bid object that can be accessed in the renderer:
+
+{: .table .table-bordered .table-striped }
+| Property | Description |
+|--------------+------------------------------------------------------- |
+| `adId` | Unique identifier for the bid |
+| `adUnitCode` | The code for the ad unit |
+| `vastUrl` | URL to the VAST XML for video ads |
+| `vastXml` | The VAST XML content (if available instead of vastUrl) |
+| `width` | Width of the creative |
+| `height` | Height of the creative |
+| `playerWidth` | Width of the video player |
+| `playerHeight` | Height of the video player |
+| `mediaType` | Type of media ('video', 'banner', etc.) |
+| `cpm` | The bid's CPM |
+| `ad` | Ad markup |
+| `adUrl` | Ad markup url |

From d8705b4e35d7859cde394c0fdecb06a27b849fda Mon Sep 17 00:00:00 2001
From: Jeff Palladino <1226357+jpalladino84@users.noreply.github.com>
Date: Thu, 3 Apr 2025 13:35:29 -0600
Subject: [PATCH 087/665] symitriDapRTDProvider - Update docs to handle cases
 where no identity is avaialble to be shared (#5973)

Co-authored-by: Jeff Palladino <jeff@symitri.com>
---
 dev-docs/modules/symitriDapRtdProvider.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/symitriDapRtdProvider.md b/dev-docs/modules/symitriDapRtdProvider.md
index de52b94551..66211f6908 100644
--- a/dev-docs/modules/symitriDapRtdProvider.md
+++ b/dev-docs/modules/symitriDapRtdProvider.md
@@ -68,7 +68,7 @@ Please reach out to your Symitri account representative(<Prebid@symitri.com>) to
 | apiVersion | String | This holds the API version | Please reach out to your Symitri account representative(<Prebid@symitri.com>) for this value |
 | domain | String | The domain name of your webpage | |
 | identityType | String | 'simpleid' or 'compositeid' or 'hashedid' | See the section below labelled "identityType" for more details. |
-| identityValue | String | This is optional field to pass user hid. Will be used only if identityType is hid | |
+| identityValue | String | This is a required field to pass HEM and/or EIDs | See the "identity" section below for more details. |
 | segtax | Integer | The taxonomy for Symitri | The value should be 708 |
 | pixelUrl | String | Pixel URL provided by Symitri which will be triggered when bid matching with Symitri dealid wins and creative gets rendered | |
 
@@ -89,6 +89,19 @@ Use 'compositeid' to pass in multiple identifiers as key-value pairs as shown be
   "identityValue": "<hem>",
 ```
 
+### Identity
+
+In the event there is no identity, the ""identityType" and "identityValue" can be set to:
+
+```javascript
+pbjs.setConfig({
+  ...
+    identityType: 'compositeid',
+    identityValue: 'HEM:',
+  ...
+});
+```
+
 ### Testing
 
 To view an example of available segments returned by dap:

From ba68d3ad758af1e6610a9b0f59066b3aa546364b Mon Sep 17 00:00:00 2001
From: Erik <omlid@users.noreply.github.com>
Date: Thu, 3 Apr 2025 14:46:13 -0500
Subject: [PATCH 088/665] NewsPassID Bidder Adapter: refactor update docs
 (#5962)

* NewsPassID Bidder Adapter: refactor update docs

* Fix markdown lint error with ordered lists

* Update for placementId and publisherId

* fix flags
---
 dev-docs/bidders/newspassid.md | 90 ++++++++++++++++++----------------
 1 file changed, 47 insertions(+), 43 deletions(-)

diff --git a/dev-docs/bidders/newspassid.md b/dev-docs/bidders/newspassid.md
index 1cddd2f8a3..e09b22a326 100644
--- a/dev-docs/bidders/newspassid.md
+++ b/dev-docs/bidders/newspassid.md
@@ -1,22 +1,18 @@
 ---
-Module Name: NewspassId Bidder Adapter
-Module Type: Bidder Adapter
-Maintainer: techsupport@newspassid.com
 layout: bidder
-title: Newspass ID
-description: LMC Newspass ID Prebid JS Bidder Adapter
+title: NewsPassID
+description: Local Media Consortium's NewsPassID Prebid JS Bidder Adapter
 biddercode: newspassid
-tcfeu_supported: false
-gvl_id: none
+media_types: banner, video, native
+gvl_id: 1317
+tcfeu_supported: true
 usp_supported: true
-coppa_supported: false
+coppa_supported: true
 schain_supported: true
-dchain_supported: false
-userIds: criteo, id5Id, tdid, identityLink, liveIntentId, parrableId, pubCommonId, lotamePanoramaId, sharedId, fabrickId
-media_types: banner
+userIds: all
 safeframes_ok: true
-deals_supported: true
-floors_supported: false
+deals_supported: false
+floors_supported: true
 fpd_supported: false
 pbjs: true
 pbs: false
@@ -27,10 +23,9 @@ sidebarType: 1
 
 ### Description
 
-LMC Newspass ID Prebid JS Bidder Adapter that connects to the NewspassId demand source(s).
+LMC NewsPassID Prebid JS Bidder Adapter that connects to the NewsPassID demand source(s). Learn more about the NewsPassID initiative [here](https://www.newspassid.com).
 
-The Newspass bid adapter supports Banner mediaTypes ONLY.
-This is intended for USA audiences only, and does not support GDPR
+This requires setup on the NewsPassID provider's end before beginning. Don't hesitate to reach out at <techsupport@newspassid.com>.
 
 ### Bid Params
 
@@ -38,37 +33,46 @@ This is intended for USA audiences only, and does not support GDPR
 
 | Name      | Scope    | Description               | Example    | Type     |
 |-----------|----------|---------------------------|------------|----------|
-| `siteId`    | required | The site ID.             | `"NPID0000001"` | `string` |
-| `publisherId`    | required | The publisher ID.  | `"4204204201"` | `string` |
-| `placementId`    | required | The placement ID.  | `"0420420421"` | `string` |
-| `customData`     | optional | publisher key-values used for targeting | `[{"settings":{},"targeting":{"key1": "value1", "key2": "value2"}}],` | `array` |
+| `publisherId`    | required | The publisher ID in the NewsPassID backend.  | `"test-publisher"` | `string` |
+| `placementId`    | required | The placement ID in the NewsPassID backend.             | `"test-group1"` | `string` |
 
-### Test Parameters
+### Integration
 
-A test ad unit that will consistently return test creatives:
+#### Step 1: Add your NewsPassID accountId to the Prebid.js bidder config before users syncs and initial ads are requested (Recommended)
 
 ```javascript
-//Banner adUnit
-
-const adUnits = [{
-                    code: 'id-of-your-banner-div',
-                    mediaTypes: {
-                      banner: {
-                        sizes: [[300, 250], [300,600]]
-                      }
-                    },
-                    bids: [{
-                        bidder: 'newspassid',
-                        params: {
-                            publisherId: 'NEWSPASS0001', /* an ID to identify the publisher account  - required */
-                            siteId: '4204204201', /* An ID used to identify a site within a publisher account - required */
-                            placementId: '8000000015', /* an ID used to identify the piece of inventory - required - for appnexus test use 13144370. */
-                            customData: [{"settings": {}, "targeting": {"key": "value", "key2": ["value1", "value2"]}}],/* optional array with 'targeting' placeholder for passing publisher specific key-values for targeting. */                            
-                        }
-                    }]
-                }];
+window.pbjs = window.pbjs || { que: [] };
+window.pbjs.que.push(function() {
+  window.pbjs.setConfig({
+    newspassid: {
+      publisherId: 'test-publisher'
+    }
+  });
+});
 ```
 
-### Note
+#### Step 2: Add the `newspassid` bidder and params to your ad unit(s)
+
+```javascript
+const adUnits = [
+  {
+    code: 'id-of-your-banner-div',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]]
+      }
+    },
+    bids: [
+      {
+        bidder: 'newspassid',
+        params: {
+            publisherId: 'test-publisher', /* an ID to identify the publisher account  - required if you skip step 1 */
+            placementId: 'test-group1' /* An ID used to identify the ad placement configuration within a publisher account - required */                          
+        }
+      }
+    ]
+  }
+];
+```
 
-Please contact us at <techsupport@newspassid.com> for any assistance testing your implementation before going live into production.
+The `publisherId` and `placementId` are the only params needed for all media types we support. These values are setup by the LMC partnership before you begin.

From f865e12fcdb9c8b5b0396245e3640e075ae2f6bc Mon Sep 17 00:00:00 2001
From: Ben Boonsiri <ben.boonsiri@stackadapt.com>
Date: Fri, 4 Apr 2025 03:14:02 -0400
Subject: [PATCH 089/665] StackAdapt Bid Adapter: initial release (#5952)

merged :)
---
 dev-docs/bidders/stackadapt.md | 157 +++++++++++++++++++++++++++++++++
 1 file changed, 157 insertions(+)
 create mode 100644 dev-docs/bidders/stackadapt.md

diff --git a/dev-docs/bidders/stackadapt.md b/dev-docs/bidders/stackadapt.md
new file mode 100644
index 0000000000..08c57e01fa
--- /dev/null
+++ b/dev-docs/bidders/stackadapt.md
@@ -0,0 +1,157 @@
+---
+layout: bidder
+title: StackAdapt
+description: StackAdapt Prebid Bidder Adapter
+biddercode: stackadapt
+pbjs: true
+pbs: false
+gvl_id: 238
+tcfeu_supported: true
+usp_supported: true
+userId: all
+media_types: banner, video
+coppa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-any
+privacy_sandbox: no
+prebid_member: false
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                 | Example            | Type     |
+|---------------|----------|-----------------------------|--------------------|----------|
+| `publisherId` | required | StackAdapt provided id      | `'4cd53a92ra91'`   | `string` |
+| `placementId` | optional | StackAdapt provided id      | `'e95365f397a7'`   | `string` |
+| `banner`      | optional | banner supporting expdir    | `{expdir: [1, 3]}` | `object` |
+| `bidfloor`    | optional | bid floor price             | `1.01`             | `float`  |
+
+The following banner parameters are supported:
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description                       | Example  | Type             |
+|----------|----------|-----------------------------------|----------|------------------|
+| `expdir` | optional | Directions the banner may expand. | `[1, 3]` | `Array[integer]` |
+
+### Banner
+
+#### `mediaTypes.banner` Parameters
+
+The StackAdapt bid adapter requires `sizes` to be defined in valid format. 
+See [mediaTypes.banner](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.banner) for defining mediaTypes parameters.
+
+Below are banner ad unit examples with required and optional parameters:
+
+```js
+    var adUnits = [
+            // Banner adUnit - required parameters
+            {
+                code: 'div-test-ad-1',
+                mediaTypes: {
+                    banner: {
+                        sizes: [[300, 250]]
+                    }
+                },
+                bids: [{
+                    bidder: 'stackadapt',
+                    params: {
+                        publisherId: '4cd53a92ra91',
+                    }
+                }]
+            },
+            // Banner adUnit - including optional parameters
+            {
+                code: 'div-test-ad-2',
+                mediaTypes: {
+                    banner: {
+                        sizes: [[300, 250]],
+                        pos: 1
+                    }
+                },
+                bids: [{
+                    bidder: 'stackadapt',
+                    params: {
+                        publisherId: '4cd53a92ra91',
+                        placementId: 'e95365f397a7',
+                        bidfloor: 1.01,
+                        banner: {
+                            expdir: [1, 3]
+                        }
+                    }
+                }]
+            }
+        ];
+```
+
+### Video
+
+#### `mediaTypes.video` Parameters
+
+The StackAdapt bid adapter requires `mimes`, `protocols`, `maxduration`, `api`, and `plcmt` to be defined in valid format.
+See [mediaTypes.video](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.video) for defining mediaTypes parameters.
+
+Below are video ad unit examples with required and optional parameters:
+
+```js
+    var adUnits = [
+            // Video adUnit - required parameters
+            {
+                code: 'div-test-ad-3',
+                mediaTypes: {
+                    video: {
+                        mimes: ['video/mp4'],
+                        protocols: [2, 3, 5, 6],
+                        maxduration: 60,
+                        api: [1, 2],
+                        plcmt: 1
+                    }
+                },
+                bids: [{
+                    bidder: 'stackadapt',
+                    params: {
+                        publisherId: '4cd53a92ra91',
+                    }
+                }]
+            },
+            // Video adUnit - including optional parameters
+            {
+                code: 'div-test-ad-4',
+                mediaTypes: {
+                    video: {
+                        playerSize: [640, 360],
+                        mimes: ['video/mp4'],
+                        protocols: [2, 3, 5, 6],
+                        minduration: 1,
+                        maxduration: 60,
+                        api: [1, 2],
+                        playback_method: [1],
+                        plcmt: 1,
+                        startdelay: 1,
+                        pos: 1,
+                        minbitrate: 300,
+                        maxbitrate: 1500,
+                        skip: 1,
+                        skipmin: 5,
+                        skipafter: 15
+                    }
+                },
+                bids: [{
+                    bidder: 'stackadapt',
+                    params: {
+                        publisherId: '4cd53a92ra91',
+                        placementId: 'e95365f397a7',
+                        bidfloor: 1.01,
+                    }
+                }]
+            }
+        ];
+```

From 6439acd8604bbbc6d52f69b318d5c830a6a2222e Mon Sep 17 00:00:00 2001
From: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
Date: Fri, 4 Apr 2025 11:00:22 +0200
Subject: [PATCH 090/665] Fixing deadlinks (#5978)

Fixing deadlinks. Related to issue : https://github.com/prebid/prebid.github.io/issues/5451

Fixed :
> Removed : https://kb.Consumableexchange.com
> Modified : https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md into https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md
> Removed https://onekey.community/
> Removed : https://documentation.help.yahooinc.com/platform/SSP/Sellers/Integrate/Create-an-Easy-OptIn-Optout-Toggle.htm
> Modified : https://zeustechnology.com/docs/installation into https://zeustechnology.com
> Changed /prebid-server/endpoints/pbs-endpoint-cookieSync.html into ../endpoints/pbs-endpoint-cookieSync.html
---
 dev-docs/bidders/consumable-server.md        | 4 ++--
 dev-docs/modules/gppControl_usnat.md         | 4 ++--
 dev-docs/modules/gppControl_usstates.md      | 2 +-
 dev-docs/modules/userid-submodules/onekey.md | 2 +-
 dev-docs/modules/userid-submodules/yahoo.md  | 2 +-
 dev-docs/modules/zeusPrimeRtdProvider.md     | 2 +-
 features/mspa-usnat.md                       | 2 +-
 prebid-server/developers/pbs-cookie-sync.md  | 6 +++---
 prebid-server/features/pbs-usgen.md          | 2 +-
 9 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/dev-docs/bidders/consumable-server.md b/dev-docs/bidders/consumable-server.md
index c9663b2432..cca8613e45 100644
--- a/dev-docs/bidders/consumable-server.md
+++ b/dev-docs/bidders/consumable-server.md
@@ -66,7 +66,7 @@ Publishers can use Prebid Server in any of the following ways with Consumable. C
 
 ### Supported media types
 
-The following table lists the media types that Consumable supports. For information about the the Time-To-Live (TTL) for each media type, see [How Consumable counts impressions](https://kb.Consumableexchange.com/publishers/billing/how_Consumable_counts_impressions.htm) in our Knowledge Base.
+The following table lists the media types that Consumable supports.
 
 {: .table .table-bordered .table-striped }
 
@@ -156,7 +156,7 @@ To add Consumable as a bidder:
 
 ### Bid request parameters
 
-For a list of the OpenRTB fields that Consumable supports in bid requests, see [List of supported OpenRTB bid request fields for sellers](https://kb.Consumableexchange.com/publishers/openrtb_integration/list_of_supported_openrtb_bid_request_fields_for_sellers.htm#List_of_supported_OpenRTB_bid_request_fields_for_sellers). The following are the required fields for the various supported media types.
+For a list of the OpenRTB fields that Consumable supports in bid requests, see [List of supported OpenRTB bid request fields for sellers](https://iabtechlab.com/wp-content/uploads/2022/04/OpenRTB-2-6_FINAL.pdf). The following are the required fields for the various supported media types.
 ### Site (Banner, Video, Audio)
 
 You must include these parameters at the bidder level.
diff --git a/dev-docs/modules/gppControl_usnat.md b/dev-docs/modules/gppControl_usnat.md
index 95bfbb68f4..df2853e3c4 100644
--- a/dev-docs/modules/gppControl_usnat.md
+++ b/dev-docs/modules/gppControl_usnat.md
@@ -21,7 +21,7 @@ sidebarType : 1
 
 ## Overview
 
-This consent management control module is designed to support the [Global Privacy Platform](https://iabtechlab.com/gpp/) Section 7 string, USNat. For more Prebid-related background, see [Prebid US Compliance Support](/features/mspa-usnat.html). In sum, the USNat string is intended to unify various state laws into a single privacy string, with participants' behavior governed by the IAB's ([MSPA](https://www.iabprivacy.com/#)). It is intended to complement, not replace, the GPP consent management module, which gathers GPP consent strings and makes them available to vendor integrations. The goal is to gather sensible and conservative [activity controls](/dev-docs/activity-controls.html) for elements of Prebid.js given various expressions of the [USNat consent string](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md).
+This consent management control module is designed to support the [Global Privacy Platform](https://iabtechlab.com/gpp/) Section 7 string, USNat. For more Prebid-related background, see [Prebid US Compliance Support](/features/mspa-usnat.html). In sum, the USNat string is intended to unify various state laws into a single privacy string, with participants' behavior governed by the IAB's ([MSPA](https://www.iabprivacy.com/#)). It is intended to complement, not replace, the GPP consent management module, which gathers GPP consent strings and makes them available to vendor integrations. The goal is to gather sensible and conservative [activity controls](/dev-docs/activity-controls.html) for elements of Prebid.js given various expressions of the [USNat consent string](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md).
 
 This module does not support any other GPP section id or local GPP api. For US state section see the [GPP Control - US State module](/dev-docs/modules/gppControl_usstates.html), Prebid.js encourages publishers to consider with their legal counsel use of the national string over state strings. New state strings are being released, yet national string support is mature and less error prone. In order to control activities in a section without a control module, publishers can express their controls directly in the syntax of the [activity control infrastructure](/dev-docs/activity-controls.html). If a publisher wants finer control over section 7 implications on Prebid.js behavior than this module provides (eg not invalidating certain strings), they are able to achieve that using the activity control syntax as an alternative to this module.
 
@@ -46,7 +46,7 @@ You can also use the [Prebid.js Download](/download.html) page.
 
 - [IAB Global Privacy Platform Full Specification Repository](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform)
 - [IAB Global Privacy Platform CMP API Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Core/CMP%20API%20Specification.md)
-- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md)
+- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md)
 - [Prebid US Compliance Support](/features/mspa-usnat.html)
 - [Prebid Activity Controls](/dev-docs/activity-controls.html)
 - [Prebid Consent Management - US Privacy Module](/dev-docs/modules/consentManagementUsp.html)
diff --git a/dev-docs/modules/gppControl_usstates.md b/dev-docs/modules/gppControl_usstates.md
index 7a434886d8..d15c603fd7 100644
--- a/dev-docs/modules/gppControl_usstates.md
+++ b/dev-docs/modules/gppControl_usstates.md
@@ -117,7 +117,7 @@ You can also use the [Prebid.js Download](/download.html) page.
 
 - [IAB Global Privacy Platform Full Specification Repository](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform)
 - [IAB Global Privacy Platform CMP API Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Core/CMP%20API%20Specification.md)
-- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md)
+- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md
 - [Prebid US Compliance Support](/features/mspa-usnat.html)
 - [Prebid Activity Controls](/dev-docs/activity-controls.html)
 - [Prebid Consent Management - US Privacy Module](/dev-docs/modules/consentManagementUsp.html)
diff --git a/dev-docs/modules/userid-submodules/onekey.md b/dev-docs/modules/userid-submodules/onekey.md
index f371228764..5577abfe23 100644
--- a/dev-docs/modules/userid-submodules/onekey.md
+++ b/dev-docs/modules/userid-submodules/onekey.md
@@ -28,7 +28,7 @@ gulp build –modules=userId,oneKeyIdSystem
 ## OneKey Registration
 
 OneKey is a community based Framework with a decentralized approach.
-Go to [onekey.community](https://onekey.community/) for more details.
+Go to onekey.community for more details.
 
 ## OneKey Configuration
 
diff --git a/dev-docs/modules/userid-submodules/yahoo.md b/dev-docs/modules/userid-submodules/yahoo.md
index acf31747a9..34a983de36 100644
--- a/dev-docs/modules/userid-submodules/yahoo.md
+++ b/dev-docs/modules/userid-submodules/yahoo.md
@@ -101,7 +101,7 @@ Follow the steps below to check that ConnectIDs are being successfully retrieved
 
 Yahoo ConnectID provides multiple mechanisms for users to manage their privacy choices. Users can manage their choices via [ConnectID Control Portal](http://connectid.yahoo.com), on the [Yahoo Privacy Dashboard](https://legal.yahoo.com/us/en/yahoo/privacy/dashboard/index.html) and [NAI’s Audience Matched Opt Out page](https://optout.networkadvertising.org/optout/email).  No further actions are required by Publishers as Yahoo will ensure that privacy choices selected by users via one of these methods are honored. We will automatically stop generating ConnectIDs for users who have opted-out.
 
-When desired, additional privacy control can be provided to your users. Within your privacy policy or website privacy settings, [Create an Easy Opt-in Opt-out Toggle](https://documentation.help.yahooinc.com/platform/SSP/Sellers/Integrate/Create-an-Easy-OptIn-Optout-Toggle.htm) for ConnectID.
+When desired, additional privacy control can be provided to your users. Within your privacy policy or website privacy settings, Create an Easy Opt-in Opt-out Toggle for ConnectID.
 
 Finally, ConnectID follows all global privacy laws (such as the CCPA) and industry frameworks (such as NAI, DAA and IAB). Yahoo will auto-detect most privacy signals present on the page (including those set by Prebid libraries) and not generate a ConnectID for users that have opted-out.
 
diff --git a/dev-docs/modules/zeusPrimeRtdProvider.md b/dev-docs/modules/zeusPrimeRtdProvider.md
index 338bcee32a..ada1fb6bd8 100644
--- a/dev-docs/modules/zeusPrimeRtdProvider.md
+++ b/dev-docs/modules/zeusPrimeRtdProvider.md
@@ -69,4 +69,4 @@ Zeus Prime requires the gamId parameter, or the Google Ad Manager Network Code,
 
 ## Troubleshooting
 
-For troubleshooting steps and guides to assist with verifying your Zeus Prime installation, see our [installation documentation](https://zeustechnology.com/docs/installation).
+For troubleshooting steps and guides to assist with verifying your Zeus Prime installation, see our [installation documentation](https://zeustechnology.com/).
diff --git a/features/mspa-usnat.md b/features/mspa-usnat.md
index 635783088d..aec0269dac 100644
--- a/features/mspa-usnat.md
+++ b/features/mspa-usnat.md
@@ -193,7 +193,7 @@ This table documents the default blocks of boolean logic that indicate whether a
 | transmitPreciseGeo | MspaServiceProviderMode=1 OR<br/>GPC=1 OR<br/>SensitiveDataProcessingOptOutNotice=2 OR<br/>SensitiveDataLimitUseNotice=2 OR<br/>((SensitiveDataProcessingOptOutNotice=0 OR SensitiveDataLimitUseNotice=0) AND SensitiveDataProcessing[8]=2)<br/>SensitiveDataProcessing[8]=1 OR<br/>KnownChildSensitiveDataConsents[2]==1 OR<br/>KnownChildSensitiveDataConsents[2]==2 OR<br/>KnownChildSensitiveDataConsents[1]=1 OR<br/>PersonalDataConsents=2 | Round IP address and lat/long in both device.geo and user.geo when the activity is not allowed.<br/><br/>The difference in this logic is that it includes "sensitive data 8" (geo) and does not include the UFPD- and ID-related fields. |
 | transmitTid | n/a | Sending transaction IDs is not an aspect of USNat. |
 
-NOTE -- Here's what the numbers in the logic above indicate in the [IAB GPP USNat specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md):
+NOTE -- Here's what the numbers in the logic above indicate in the [IAB GPP USNat specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md:
 
 MspaServiceProviderMode:
 
diff --git a/prebid-server/developers/pbs-cookie-sync.md b/prebid-server/developers/pbs-cookie-sync.md
index 04bf2856dd..b97d7e3b02 100644
--- a/prebid-server/developers/pbs-cookie-sync.md
+++ b/prebid-server/developers/pbs-cookie-sync.md
@@ -33,7 +33,7 @@ Here's how these IDs get placed in the cookie from Prebid.js:
 
 ![Prebid Server Cookie Sync](/assets/images/prebid-server/pbs-cookie-sync.png){:class="pb-lg-img"}
 
-1. When the [s2sConfig](/dev-docs/modules/prebidServer.html) is set, Prebid.js initiates a call to the Prebid Server [`/cookie_sync`](/prebid-server/endpoints/pbs-endpoint-cookieSync.html), letting it know which server-side bidders will be participating in the header bidding auction.
+1. When the [s2sConfig](/dev-docs/modules/prebidServer.html) is set, Prebid.js initiates a call to the Prebid Server [`/cookie_sync`](../endpoints/pbs-endpoint-cookieSync.html), letting it know which server-side bidders will be participating in the header bidding auction.
 
 ```text
     POST https://prebid-server.example.com/cookie_sync
@@ -78,10 +78,10 @@ This is how to control the coop syncing behavior from Prebid.js:
 
 ### Manually initiating a sync
 
-Where Prebid.js isn't present, like on [AMP](/prebid-server/use-cases/pbs-amp.html) pages, the call to [/cookie_sync](prebid-server/endpoints/pbs-endpoint-cookieSync.html) doesn't happen automatically.
+Where Prebid.js isn't present, like on [AMP](/prebid-server/use-cases/pbs-amp.html) pages, the call to [/cookie_sync](../endpoints/pbs-endpoint-cookieSync.html) doesn't happen automatically.
 If there are scenarios where Prebid.js isn't around to initiate the /cookie_sync call, publishers can choose to put an iframe on their page.
 
-This approach works in a way quite similar to Prebid.js except that the [/cookie_sync endpoint](/prebid-server/endpoints/pbs-endpoint-cookieSync.html) is initiated by a separate script that's part of `load-cookie.html'. This file must be placed on a CDN by the publisher's Prebid Server host company. Up until July 2024, the script existed in the [Prebid Universal Creative](https://github.com/prebid/prebid-universal-creative) repository, but has since been moved to the [user-sync](https://github.com/prebid/user-sync) repo.
+This approach works in a way quite similar to Prebid.js except that the [/cookie_sync endpoint](../endpoints/pbs-endpoint-cookieSync.html) is initiated by a separate script that's part of `load-cookie.html'. This file must be placed on a CDN by the publisher's Prebid Server host company. Up until July 2024, the script existed in the [Prebid Universal Creative](https://github.com/prebid/prebid-universal-creative) repository, but has since been moved to the [user-sync](https://github.com/prebid/user-sync) repo.
 
 1. The Prebid Server hosting company places the [load-cookie.html](#manually-initiating-a-sync) file onto a CDN.
 
diff --git a/prebid-server/features/pbs-usgen.md b/prebid-server/features/pbs-usgen.md
index bfe61d2481..5273f9ddce 100644
--- a/prebid-server/features/pbs-usgen.md
+++ b/prebid-server/features/pbs-usgen.md
@@ -178,4 +178,4 @@ Additional information about the outcoming of privacy module processing can be o
 * [Prebid US Compliance Support](/features/mspa-usnat.html)
 * [US Custom Logic Privacy Module](/prebid-server/features/pbs-uscustomlogic.html)
 * [Activity Control system](/prebid-server/features/pbs-activitycontrols.html)
-* [IAB US National Privacy Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20National%20Privacy%20Technical%20Specification.md)
+* [IAB US National Privacy Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md)

From 08cdd6200891b0fa89bcf8712c8ce61c77ed2529 Mon Sep 17 00:00:00 2001
From: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
Date: Fri, 4 Apr 2025 11:02:47 +0200
Subject: [PATCH 091/665] Update Analytic Page based on bidder page (#5971)

Redesign the analytics homepage using the bidder homepage as a reference :
- Introduce a search bar for analytics modules.
- Organize analytics modules in alphabetical order.
- Dedicated page for each module with redirection functionality.

Related to issue : https://github.com/prebid/prebid.github.io/issues/5359
---
 overview/analytics.md | 116 +++++++++++++++++++++++++++++++++++-------
 1 file changed, 99 insertions(+), 17 deletions(-)

diff --git a/overview/analytics.md b/overview/analytics.md
index 27240f2bb3..39b940802e 100644
--- a/overview/analytics.md
+++ b/overview/analytics.md
@@ -50,30 +50,112 @@ pbjs.que.push(function() {
 
 {% assign analytics_pages = site.pages | where: "layout", "analytics" %}
 
-<ul>
+## Search for analytics adapters
+
+<input type="text" id="autocomplete-filter" class="autocomplete-filter">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/awesomplete/1.1.5/awesomplete.min.js" integrity="sha512-HcBl0GSJvt4Qecm4srHapirUx0HJDi2zYXm6KUKNNUGdTIN9cBwakVZHWmRVj4MKgy1AChqhWGYcMDbRKgO0zg==" crossorigin="anonymous"></script>
+<script>
+var AutocompleteList = [{% for page in analytics_pages %}{ label: '{{ page.title }}', value: '{{ page.url }}' },{% endfor %}];
+</script>
+<script src="{{site.baseurl}}/assets/js/autocomplete.js"></script>
+<div class="c-analytic-list-group" markdown="1">
+
+## Full List
+
+### #-A
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "0" or firstletter == "1" or firstletter == "2" or firstletter == "3" or firstletter == "4" or firstletter == "5" or firstletter == "6" or firstletter == "7" or firstletter == "8" or firstletter == "9" or firstletter == "a" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
+
+### B-C
+
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "b" or firstletter == "c" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
+
+### D-G
+
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "d" or firstletter == "e" or firstletter == "f" or firstletter == "g" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
+
+### H-L
+
+<ul class="c-analytic-list">
 {% for page in analytics_pages %}
-<li>
-<a href="#{{ page.modulecode }}">{{ page.title }}</a>
-</li>
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "h" or firstletter == "i" or firstletter == "j" or firstletter == "k" or firstletter == "l" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
 {% endfor %}
 </ul>
 
-## Analytics Adapter Documentation
+### M-O
 
+<ul class="c-analytic-list">
 {% for page in analytics_pages %}
-<div class="bs-docs-section" markdown="1">
-<a name="{{ page.modulecode }}" ></a>
-<h3>{{ page.title }}</h3>
-<h4>Features</h4>
-
-{: .table .table-bordered .table-striped }
-| **Module Code** | {{ page.modulecode }} | **Prebid.org Member** | {% if page.prebid_member == true %}yes{% else %}no{% endif %} |
-| **GDPR Support** | {% if page.tcfeu_supported == true %}yes{% elsif page.tcfeu_supported == false %}no{% else %}Check with vendor{% endif %} | **USP/CCPA Support** | {% if page.usp_supported == true %}yes{% elsif page.usp_supported == false %}no{% else %}Check with vendor{% endif %} |
-| **IAB GVL ID** | {% if page.gvl_id %}{{page.gvl_id}}{% else %}Check with vendor{% endif %} | **COPPA Support** | {% if page.coppa_supported == true %}yes{% elsif page.coppa_supported == false %}no{% else %}Check with vendor{% endif %} |
-
-{{ page.content }}
-</div>
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "m" or firstletter == "n" or firstletter == "o" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
 {% endfor %}
+</ul>
+
+### P-R
+
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "p" or firstletter == "q" or firstletter == "r" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
+
+### S-T
+
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "s" or firstletter == "t" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
+
+### U-Z
+
+<ul class="c-analytic-list">
+{% for page in analytics_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "u" or firstletter == "v" or firstletter == "w" or firstletter == "x" or firstletter == "y" or firstletter == "z" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
 ## Related Topics
 

From 0edfd2878e52d2b2254c7df68df4383600ef66d0 Mon Sep 17 00:00:00 2001
From: Antoine Niek <antoineniek@gmail.com>
Date: Fri, 4 Apr 2025 08:36:08 -0400
Subject: [PATCH 092/665] New RTD submodule: optableRtdProvider (#5930)

* optableRtdProvider draft doc

* optableRtdProvider: renaming config keys

* optableRtdProvider: param name change

* optableRtdProvider: update

maintainer contacts,
module params,
command to run demo

* optableRtdProvider: update doc

* optableRtdProvider: update doc with a new parameter

* add a paragraph on publisher customized RTD handler

* optableRtdProvider: improve wording

* optable: phone format normalization clarified

* optableRTDSubmodule: enhance summary

* optableRtdProvider: fix lint issues

* optableRtdProvider: fix typo: user.ext.data -> user.data

* optableRtdProvider: add a note on erasing custom fields in user.ext.optable

* optableRtdProvider: change the method of passing extra data

---------

Co-authored-by: Eugene Dorfman <eugene.dorfman@gmail.com>
Co-authored-by: Bohdan V <25197509+BohdanVV@users.noreply.github.com>
---
 dev-docs/modules/optableRtdProvider.md | 156 +++++++++++++++++++++++++
 1 file changed, 156 insertions(+)
 create mode 100644 dev-docs/modules/optableRtdProvider.md

diff --git a/dev-docs/modules/optableRtdProvider.md b/dev-docs/modules/optableRtdProvider.md
new file mode 100644
index 0000000000..f65daa1809
--- /dev/null
+++ b/dev-docs/modules/optableRtdProvider.md
@@ -0,0 +1,156 @@
+---
+layout: page_v2
+title: Optable RTD Provider Module
+display_name: Optable RTD Module
+description: Optable Real Time Data Module
+page_type: module
+module_type: rtd
+module_code : optable
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+{: .alert.alert-warning :}
+This module may load a publisher-specific JavaScript bundle. The external resource provides flexibility in ID handling without the need to modify the RTD submodule source code.
+
+# Optable RTD Submodule
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Description
+
+Optable RTD submodule enriches the OpenRTB request by populating `user.ext.eids` and `user.data` using an identity graph and audience segmentation service hosted by Optable on behalf of the publisher. This RTD submodule primarily relies on the Optable bundle loaded on the page, which leverages the Optable-specific Visitor ID and other PPIDs to interact with the identity graph, enriching the bid request with additional user IDs and audience data.
+
+## Usage
+
+### Integration
+
+Compile the Optable RTD Module with other modules and adapters into your Prebid.js build:
+
+```bash
+gulp build --modules="rtdModule,optableRtdProvider,appnexusBidAdapter,..."
+```
+
+> Note that Optable RTD module is dependent on the global real-time data module, `rtdModule`.
+
+### Preloading Optable SDK bundle
+
+In order to use the module you first need to register with Optable and obtain a bundle URL. The bundle URL may be specified as a `bundleUrl` parameter to the script, or otherwise it can be added directly to the page source as:
+
+```html
+<script async src="<bundleURL>"></script>
+```
+
+In this case bundleUrl parameter is not needed and the script will await bundle loading before delegating to it.
+
+### Configuration
+
+This module is configured as part of the `realTimeData.dataProviders`. We recommend setting `auctionDelay` to 1000 ms and make sure `waitForIt` is set to `true` for the `Optable` RTD provider.
+
+```javascript
+pbjs.setConfig({
+  debug: true, // we recommend turning this on for testing as it adds more logging
+  realTimeData: {
+    auctionDelay: 1000,
+    dataProviders: [
+      {
+        name: 'optable',
+        waitForIt: true, // should be true, otherwise the auctionDelay will be ignored
+        params: {
+          bundleUrl: '<optional, your bundle url>',
+          adserverTargeting: '<optional, true by default, set to true to also set GAM targeting keywords to ad slots>',
+        },
+      },
+    ],
+  },
+});
+```
+
+### Additional input to the module
+
+Optable bundle may use PPIDs (publisher provided IDs) from the `user.ext.eids` as input.
+In addition, other arbitrary keys can be used as input, f.e. the following:
+
+* `optableRtdConfig.email` - a SHA256-hashed user email
+* `optableRtdConfig.phone` - a SHA256-hashed [E.164 normalized phone](https://unifiedid.com/docs/getting-started/gs-normalization-encoding#phone-number-normalization) (meaning a phone number consisting of digits and leading plus sign without spaces or any additional characters, f.e. a US number would be: `+12345678999`)
+* `optableRtdConfig.postal_code` - a ZIP postal code string
+
+Each of these identifiers is completely optional and can be provided through `pbjs.mergeConfig(...)` like so:
+
+```javascript
+pbjs.mergeConfig({
+  optableRtdConfig: {
+    email: await sha256("test@example.com"),
+    phone: await sha256("12345678999"),
+    postal_code: "61054"
+  }
+})
+```
+
+Where `sha256` function can be defined as:
+
+```javascript
+async function sha256(input) {
+  return [...new Uint8Array(
+    await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input))
+  )].map(b => b.toString(16).padStart(2, "0")).join("");
+}
+```
+
+To handle PPIDs and the above input - a custom `handleRtd` function may need to be provided.
+
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name                     | Type     | Description                                                                                                                                                                                                                                                     | Default          | Notes    |
+|--------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|----------|
+| name                     | String   | Real time data module name                                                                                                                                                                                                                                      | Always `optable` |          |
+| waitForIt                | Boolean  | Should be set `true` together with `auctionDelay: 1000`                                                                                                                                                                                                         | `false`          |          |
+| params                   | Object   |                                                                                                                                                                                                                                                                 |                  |          |
+| params.bundleUrl         | String   | Optable bundle URL                                                                                                                                                                                                                                              | `null`           | Optional |
+| params.adserverTargeting | Boolean  | If set to `true`, targeting keywords will be passed to the ad server upon auction completion                                                                                                                                                                    | `true`           | Optional |
+| params.handleRtd         | Function | An optional function that uses Optable data to enrich `reqBidsConfigObj` with the real-time data. If not provided, the module will do a default call to Optable bundle. The function signature is `[async] (reqBidsConfigObj, optableExtraData, mergeFn) => {}` | `null`           | Optional |
+
+## Publisher Customized RTD Handler Function
+
+When there is more pre-processing or post-processing needed prior/post calling Optable bundle - a custom `handleRtd`
+function can be supplied to do that.
+This function will also be responsible for the `reqBidsConfigObj` enrichment.
+It will also receive the `optableExtraData` object, which can contain the extra data required for the enrichment and
+shouldn't be shared with other RTD providers/bidders.
+`mergeFn` parameter taken by `handleRtd` is a standard Prebid.js utility function that take an object to be enriched and
+an object to enrich with: the second object's fields will be merged into the first one (also see the code of an example
+mentioned below):
+
+```javascript
+mergeFn(
+  reqBidsConfigObj.ortb2Fragments.global, // or other nested object as needed
+  rtdData,
+);
+```
+
+A `handleRtd` function implementation has access to its surrounding context including capturing a `pbjs` object, calling `pbjs.getConfig()` and f.e. reading off the `consentManagement` config to make the appropriate decision based on it.
+
+## Example
+
+If you want to see an example of how the optable RTD module works, run the following command:
+
+```bash
+gulp serve --modules=optableRtdProvider,consentManagementGpp,consentManagementTcf,appnexusBidAdapter
+```
+
+and then open the following URL in your browser:
+
+[`http://localhost:9999/integrationExamples/gpt/optableRtdProvider_example.html`](http://localhost:9999/integrationExamples/gpt/optableRtdProvider_example.html)
+
+Open the browser console to see the logs.
+
+## Maintainer contacts
+
+Any suggestions or questions can be directed to [prebid@optable.co](mailto:prebid@optable.co).
+
+Alternatively please open a new [issue](https://github.com/prebid/prebid-server-java/issues/new) or [pull request](https://github.com/prebid/prebid-server-java/pulls) in this repository.

From 78c7d7b459be42530350d7ee030194d72d5a9319 Mon Sep 17 00:00:00 2001
From: dkornet-ad <169174147+dkornet-ad@users.noreply.github.com>
Date: Fri, 4 Apr 2025 23:32:57 +0300
Subject: [PATCH 093/665] Bidmatic adapter: text changes (#5981)

---
 dev-docs/bidmatic.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidmatic.md b/dev-docs/bidmatic.md
index d16387e291..a999757c99 100644
--- a/dev-docs/bidmatic.md
+++ b/dev-docs/bidmatic.md
@@ -13,12 +13,14 @@ schain_supported: true
 dchain_supported: false
 userId: all (with commercial activation)
 media_types: banner, video
+userIds: all
 safeframes_ok: true
 deals_supported: false
 floors_supported: true
 fpd_supported: true
 pbjs: true
 pbs: true
+pbs_app_supported: true
 prebid_member: false
 multiformat_supported: will-bid-on-one
 ortb_blocking_supported: true

From 85d029d2fdb656ed603ffdf45107f432a2a1becd Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Mon, 7 Apr 2025 16:00:12 -0400
Subject: [PATCH 094/665] Typo in gam-native (#5983)

---
 adops/gam-native.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/adops/gam-native.md b/adops/gam-native.md
index ca76f3a1e0..e9e8b17610 100644
--- a/adops/gam-native.md
+++ b/adops/gam-native.md
@@ -71,9 +71,8 @@ If this creative is served, it will fire impression trackers on load. Clicking t
 The creative template HTML will depend on which of the three scenarios you're implementing. You can choose to manage the native template in one of these ways:
 
 - in GAM ([Managing the Native Template in GAM](#managing-the-native-template-in-gam) below)
-- in the Prebid.js AdUnit - this is handled as a 3rd party HTML creative using the Prebud Universal Creative.
-- in a separate JavaScript file - this is handled as a 3rd party HTML creative using the Prebud Univer
-sal Creative.
+- in the Prebid.js AdUnit - this is handled as a 3rd party HTML creative using the Prebid Universal Creative.
+- in a separate JavaScript file - this is handled as a 3rd party HTML creative using the Prebid Universal Creative.
 
 {: .alert.alert-info :}
 For engineering instructions, see [Native Implementation Guide](/prebid/native-implementation.html).

From a7ab7f3560f2f8c3118d0629f43185e0c9af4b5e Mon Sep 17 00:00:00 2001
From: "Md. Soman Mia Sarker" <gao.gram@gmail.com>
Date: Tue, 8 Apr 2025 10:38:12 +0600
Subject: [PATCH 095/665] Adgrid new param placement (#5950)

* Added new optional param placement

* Added new optional param placement

* Made required field
---
 dev-docs/bidders/adgrid.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/adgrid.md b/dev-docs/bidders/adgrid.md
index 014b75d921..ac72fc9cfb 100644
--- a/dev-docs/bidders/adgrid.md
+++ b/dev-docs/bidders/adgrid.md
@@ -34,6 +34,7 @@ The AdGrid Bidding Adapter requires setup and approval before beginning. Please
 | Name       | Scope    | Description  | Example | Type      |
 |------------|----------|--------------|---------|-----------|
 | `domainId` | required | Publisher Id | `30164` | `integer` |
+| `placement`| required | Placement    | `test`  | `string`  |
 
 ### Test Parameters
 
@@ -50,7 +51,8 @@ var adUnits = [
     bids: [{
       bidder: 'adgrid',
       params: {
-        domainId: 12345
+        domainId: 12345,
+        placement: 'leaderboard'
       }
     }]
   },
@@ -64,7 +66,8 @@ var adUnits = [
     bids: [{
       bidder: 'adgrid',
       params: {
-        domainId: 67890
+        domainId: 67890,
+        placement: 'adhesion'
       }
     }]
   },

From 864f1111bee39f59f6a52f7f9d3b95cc70afdc4a Mon Sep 17 00:00:00 2001
From: MadSense Ops <prebid@madsense.io>
Date: Tue, 8 Apr 2025 22:15:59 +0200
Subject: [PATCH 096/665] pbs set to true (#5824)

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

diff --git a/dev-docs/bidders/madsense.md b/dev-docs/bidders/madsense.md
index cacbcbbd09..c042e96032 100644
--- a/dev-docs/bidders/madsense.md
+++ b/dev-docs/bidders/madsense.md
@@ -3,7 +3,7 @@ layout: bidder
 title: MadSense
 description: Prebid MadSense Bidder Adapter
 pbjs: true
-pbs: false
+pbs: true
 biddercode: madsense
 tcfeu_supported: false
 gdpr_supported: true

From 8582522182e580bdcd6be9530c71e03179d1db56 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Wed, 9 Apr 2025 19:02:15 +0200
Subject: [PATCH 097/665] WURFL Rtd Provider: adds Expected Behavior section
 (#5985)

---
 dev-docs/modules/wurflRtdProvider.md | 65 ++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index a146b3efdb..603127aa90 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -95,3 +95,68 @@ To test how the WURFL RTD module works, run the following command:
 Then, point your browser to:
 
 `http://localhost:9999/integrationExamples/gpt/wurflRtdProvider_example.html`
+
+## Expected Behavior
+
+WURFL RTD adds device information to the bidderRequest's `ortb2.device.ext.wurfl` object (enabled SSPs have access to an extended capability set).
+
+```json
+{
+  "id": "1edd88d3-12c6-40b2-a80b-138e276b4553",
+  "at": 1,
+  "site": {...},
+  "device": {
+    "w": 375,
+    "h": 667,
+    "dnt": 0,
+    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_3_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3 Mobile/15E148 Safari/604.1",
+    "language": "it",
+    "make": "Apple",
+    "model": "iPhone",
+    "devicetype": 1,
+    "os": "iOS",
+    "osv": "18.3.1",
+    "hwv": "iPhone",
+    "ppi": 324,
+    "pxratio": 2,
+    "js": 1,
+    "ext": {
+      "vpw": 980,
+      "vph": 1429,
+      "wurfl": {
+        "wurfl_id": "apple_iphone_ver18_3",
+        "advertised_browser": "Mobile Safari",
+        "advertised_browser_version": "18.3",
+        "advertised_device_os": "iOS",
+        "advertised_device_os_version": "18.3.1",
+        "ajax_support_javascript": true,
+        "brand_name": "Apple",
+        "complete_device_name": "Apple iPhone",
+        "density_class": "2.0",
+        "form_factor": "Smartphone",
+        "is_app_webview": false,
+        "is_connected_tv": false,
+        "is_full_desktop": false,
+        "is_mobile": true,
+        "is_ott": false,
+        "is_phone": true,
+        "is_robot": false,
+        "is_smartphone": true,
+        "is_smarttv": false,
+        "is_tablet": false,
+        "manufacturer_name": "",
+        "marketing_name": "",
+        "max_image_height": 568,
+        "max_image_width": 320,
+        "model_name": "iPhone",
+        "physical_screen_height": 89,
+        "physical_screen_width": 50,
+        "pixel_density": 324,
+        "pointing_method": "touchscreen",
+        "resolution_height": 1136,
+        "resolution_width": 640
+      }
+    }
+  }
+}
+```

From 45394436d3fdafb249a27f3123a3d30b62380df5 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Wed, 9 Apr 2025 14:00:13 -0400
Subject: [PATCH 098/665] added note asking for test bids (#5987)

---
 prebid-server/developers/add-new-bidder-go.md   | 5 +++++
 prebid-server/developers/add-new-bidder-java.md | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md
index b92351327d..b4c708d370 100644
--- a/prebid-server/developers/add-new-bidder-go.md
+++ b/prebid-server/developers/add-new-bidder-go.md
@@ -357,6 +357,11 @@ We request you do not duplicate information already present in the [OpenRTB 2.x
 {: .alert.alert-warning :}
 You may not try to set the full endpoint domain from a publisher-specified bidder parameter. Prebid Server is not an open proxy. If absolutely necessary, you may specify a *portion* of the domain as a parameter to support geo regions or account specific servers. However, this is discouraged and may degrade the performance of your adapter since the server needs to maintain more outgoing connections. Host companies may choose to disable your adapter if it uses a dynamically configured domain.
 
+{: .alert.alert-info :}
+Prebid publishers and managed services often require test responses from bid adapters. Please plan to provide a method for obtaining test bids for each mediatype you support. This can be done in response to the OpenRTB `test:1` flag, or with a documented set of bidder parameters.
+
+#### Defining the Parameters
+
 Create a file with the path `static/bidder-params/{bidder}.json` and use [JSON Schema](https://json-schema.org/understanding-json-schema/) to define your bidder parameters. Prebid Server requires this file for every adapter, even if yours doesn't require bidder parameters (see the 'no parameters' example at the end of this section).
 
 Let's start with this example which defines one required `placementId` string parameter:
diff --git a/prebid-server/developers/add-new-bidder-java.md b/prebid-server/developers/add-new-bidder-java.md
index 2b233fc32f..833d37d071 100644
--- a/prebid-server/developers/add-new-bidder-java.md
+++ b/prebid-server/developers/add-new-bidder-java.md
@@ -269,6 +269,11 @@ We request that you do not duplicate information that is already present in the
 {: .alert.alert-warning :}
 You may not try to set the full endpoint domain from a publisher-specified bidder parameter. Prebid Server is not an open proxy. If absolutely necessary, you may specify a *portion* of the domain as a parameter to support geo regions or account specific servers. However, this is discouraged and may degrade the performance of your adapter since the server needs to maintain more outgoing connections. Host companies may choose to disable your adapter if it uses a dynamically configured domain.
 
+{: .alert.alert-info :}
+Prebid publishers and managed services often require test responses from bid adapters. Please plan to provide a method for obtaining test bids for each mediatype you support. This can be done in response to the OpenRTB `test:1` flag, or with a documented set of bidder parameters.
+
+#### Defining the Parameters
+
 Create a file with the path `static/bidder-params/{bidder}.json` using [JSON Schema](https://json-schema.org/understanding-json-schema/) to define your bidder parameters. Prebid Server requires this file for every adapter, even if yours doesn't require bidder parameters (see the 'no parameters' example at the end of this section).
 
 Let's start with this example which defines one required `placementId` string parameter:

From f82438fe971cb6627f89a7832ced58c5657bcbf2 Mon Sep 17 00:00:00 2001
From: Yuriy Velichko <yuriy.velichko@postindustria.com>
Date: Fri, 11 Apr 2025 16:11:12 +0300
Subject: [PATCH 099/665] Prebid Mobile: 3.0 updates (#5982)

* docs: add page for updates in v3.0 in iOS

* docs: small enhancement

* docs: add formatting to table

* docs: minor changes

* docs: android doc

* docs: lint fix

* docs: remove TOC

* docs: add ext data

* docs: fix subgroup

* docs: try to add style for table in ios doc

* docs: fix linting issue

* docs: add style to table in android doc

* docs: change sidebar titles for 3.0 page

* docs: add 3.0 key features page

* docs: fix linting error

* docs: small change in key features article

* docs: ios - add links to api doc

* docs: small improvement

* docs: add links to Javadoc

* docs: android changes.

* docs: ios changes.

* doc: mobile 3.0 - change the order of features

* doc: 3.0 doc update

* doc: improvements

* doc: corrections for the Rewarded Ad Unit

* doc: format docs for the 3.0 page

* doc: add some info for the 3.0 changelog

* docs: ios initialization with non-tracking endpoints.

* doc: add some more items to the list of introduced features

* doc: various corrections

* doc: greeting message on the main SDK page

* doc: format text on the intro page

* docs: fix lint errors

* docs: fix lint errors

* docs: fix lint errors

* docs: fix lint errors

* docs: resolves PR comments

* docs: fix lint

* docs: fix lint errors

* docs: resolves PR issues with global ORTB config

* docs: returns info and code snippets for 2.5.0

* docs: fix lint errors

* docs: modifies info about Host.Appnexus and Host.Rubicon constants.

* wordsmithing

* wordsmithing

* wordsmithing

* wordsmithing

* wordsmithing

* removed reference to rubicon

* docs: resolves some alternatives in the api changes list

* fixed tyop

* docs: resolves PR issues with platforms inconsistency

---------

Co-authored-by: Olena Stepaniuk <olena.stepaniuk@postindustria.com>
Co-authored-by: Valentin Petrovich <valentin.petrovich@postindustria.com>
Co-authored-by: Maksym Danylov <maksym.danylov@sigma.software>
Co-authored-by: bretg <bgorsline@gmail.com>
---
 _data/sidebar.yml                             |  24 ++
 _includes/mobile/adunit-config-android.md     |  12 +
 _includes/mobile/video-params.md              |   6 +
 faq/prebid-mobile-faq.md                      |   3 +-
 .../android-sdk-integration-admob.md          |  10 +-
 .../rendering/android-sdk-integration-gam.md  |   2 +-
 .../rendering/android-sdk-integration-max.md  |   2 +-
 .../rendering/android-sdk-integration-pb.md   |   8 +-
 .../rendering/ios-sdk-integration-pb.md       |   4 +-
 .../android/code-integration-android.md       |  31 ++-
 .../pbm-api/android/pbm-targeting-android.md  |  61 ++---
 .../pbm-api/ios/code-integration-ios.md       |  71 +++--
 .../pbm-api/ios/pbm-targeting-ios.md          |  41 +--
 prebid-mobile/prebid-mobile.md                |  18 +-
 .../android/gam-bidding-only-html-banner.md   |  12 +-
 .../gam-bidding-only-interstitial-video.md    |   2 +-
 .../gam-bidding-only-video-instream.md        |   4 +-
 .../gam-bidding-only-video-outstream.md       |   4 +-
 .../ios/gam-bidding-only-html-banner.md       |   4 +-
 .../gam-bidding-only-interstitial-video.md    |   2 +-
 .../ios/gam-bidding-only-rewarded-video.md    |   2 +-
 .../ios/gam-bidding-only-video-instream.md    |   2 +-
 .../ios/gam-bidding-only-video-outstream.md   |   2 +-
 .../updates-3.0/android/api-changes.md        | 206 +++++++++++++++
 prebid-mobile/updates-3.0/ios/api-changes.md  | 243 ++++++++++++++++++
 prebid-mobile/updates-3.0/sdk-key-features.md | 101 ++++++++
 26 files changed, 745 insertions(+), 132 deletions(-)
 create mode 100644 prebid-mobile/updates-3.0/android/api-changes.md
 create mode 100644 prebid-mobile/updates-3.0/ios/api-changes.md
 create mode 100644 prebid-mobile/updates-3.0/sdk-key-features.md

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index 98a4e60a74..e84c688722 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -675,6 +675,14 @@
   sectionTitle:
   subgroup: 0
 
+- sbSecId: 2
+  title: Prebid Mobile 3.0
+  link: /prebid-mobile/updates-3.0/sdk-key-features.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 0
+
 - sbSecId: 2
   title: Prebid AMP
   link: /dev-docs/show-prebid-ads-on-amp-pages.html
@@ -831,6 +839,14 @@
   sectionTitle:
   subgroup: 2
 
+- sbSecId: 2
+  title: Prebid Mobile 3.0 API Changes
+  link: /prebid-mobile/updates-3.0/ios/api-changes.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 2
+
 - sbSecId: 2
   title: API Reference
   link: /prebid-mobile-ios/index.html
@@ -928,6 +944,14 @@
   sectionTitle:
   subgroup: 3
 
+- sbSecId: 2
+  title: Prebid Mobile 3.0 API Changes
+  link: /prebid-mobile/updates-3.0/android/api-changes.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 3
+
 - sbSecId: 2
   title: API Reference
   link: /prebid-mobile-android/index.html
diff --git a/_includes/mobile/adunit-config-android.md b/_includes/mobile/adunit-config-android.md
index aedd88e520..f469856135 100644
--- a/_includes/mobile/adunit-config-android.md
+++ b/_includes/mobile/adunit-config-android.md
@@ -30,12 +30,24 @@ adUnit.setImpOrtbConfig("")
 #### setAutoRefreshPeriodMillis
 {:.no_toc}
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the `setAutoRefreshPeriodMillis` method is removed. Use the `setAutoRefreshInterval` method instead.
+
 If set on a given Prebid Mobile ad unit, the `fetchDemand` function will be called every `periodMillis` until `stopAutoRefresh` is called. Each call to `fetchDemand` will invoke the `onComplete` function. This refresh only pertains to Prebid Mobile and not to any ad server refresh processes. It is suggested that the adServers refresh be turned off.
 
 **Parameters**
 
 - `periodMillis`: Integer defining the refresh time in milliseconds.
 
+#### setAutoRefreshInterval
+{:.no_toc}
+
+If set on a given Prebid Mobile ad unit, the `fetchDemand` function will be called every `periodMillis` until `stopAutoRefresh` is called. Each call to `fetchDemand` will invoke the `onComplete` function. This refresh only pertains to Prebid Mobile and not to any ad server refresh processes. It is suggested that the adServers refresh be turned off.
+
+**Parameters**
+
+- `seconds`: Integer defining the refresh time in seconds.
+
 #### startAutoRefresh
 {:.no_toc}
 
diff --git a/_includes/mobile/video-params.md b/_includes/mobile/video-params.md
index 6f5b646d3b..d5f20a67aa 100644
--- a/_includes/mobile/video-params.md
+++ b/_includes/mobile/video-params.md
@@ -17,6 +17,9 @@ The [OpenRTB 2.6](https://iabtechlab.com/wp-content/uploads/2022/04/OpenRTB-2-6_
 Notes:
 - `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to placement=5 if no placement value is supplied.
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
+
 #### plcmnt
 {:.no_toc}
 
@@ -30,6 +33,9 @@ The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/
 Notes:
 - `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmnt=3 if no placement value is supplied.
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
+
 #### api
 {:.no_toc}
 
diff --git a/faq/prebid-mobile-faq.md b/faq/prebid-mobile-faq.md
index 011d3e288e..208ebbce10 100644
--- a/faq/prebid-mobile-faq.md
+++ b/faq/prebid-mobile-faq.md
@@ -165,7 +165,8 @@ However, here is the list of items that the app developer can add to the applica
 - `NSPrivacyTracking` - true. Because Prebid SDK collects IDFA. 
 - `NSPrivacyTrackingDomains` - the tracking domain for the PBS. 
 
-Pay attention - if `NSPrivacyTracking` is true, the tracking domain is provided, and the user doesn't allow the app to track him or her, iOS will block the bid requests. Prebid SDK doesn't support tracking and non-tracking endpoints yet. Follow the [issue](https://github.com/prebid/prebid-mobile-ios/issues/954) for the details. 
+Pay attention - if `NSPrivacyTracking` is true, the tracking domain is provided, and the user doesn't allow the app to track him or her, iOS will block the bid requests. 
+Prebid SDK supports tracking and non-tracking endpoints. See [SDK initialization](/prebid-mobile/pbm-api/ios/code-integration-ios.html#handling-tracking-domains) for more details details.
 
 - `NSPrivacyCollectedDataTypes` array should contain the following `NSPrivacyCollectedDataType` items: `NSPrivacyCollectedDataTypePreciseLocation`, `NSPrivacyCollectedDataTypeCoarseLocation`,`NSPrivacyCollectedDataTypeDeviceID`, `NSPrivacyCollectedDataTypeProductInteraction`, `NSPrivacyCollectedDataTypeAdvertisingData`. 
 
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
index b5f360f20e..a4e5c75ba4 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
@@ -160,7 +160,7 @@ The `AdMobInterstitialMediationUtils` is a helper class, which performs certain
 
 The `MediationInterstitialAdUnit` is part of the prebid mediation API. This class is responsible for making a bid request and providing the winning bid and targeting keywords to mediating SDKs.  
 
-The **default** ad format for interstitial is **DISPLAY**. In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
+In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
 
 ```kotlin
 adUnit = MediationInterstitialAdUnit(
@@ -338,17 +338,13 @@ private fun configureNativeAdUnit(nativeAdUnit: NativeAdUnit) {
     title.isRequired = true
     nativeAdUnit.addAsset(title)
 
-    val icon = NativeImageAsset()
+    val icon = NativeImageAsset(20, 20, 20, 20)
     icon.imageType = NativeImageAsset.IMAGE_TYPE.ICON
-    icon.wMin = 20
-    icon.hMin = 20
     icon.isRequired = true
     nativeAdUnit.addAsset(icon)
 
-    val image = NativeImageAsset()
+    val image = NativeImageAsset(200, 200, 200, 200)
     image.imageType = NativeImageAsset.IMAGE_TYPE.MAIN
-    image.hMin = 200
-    image.wMin = 200
     image.isRequired = true
     nativeAdUnit.addAsset(image)
 
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-gam.md b/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
index 72600a491d..b676bc9725 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-gam.md
@@ -151,7 +151,7 @@ Pay attention that the `loadAd()` should be called on the main thread.
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-The **default** ad format for an interstitial ad is **DISPLAY**. In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
+In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
 
 ```kotlin
 interstitialAdUnit = InterstitialAdUnit(
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-max.md b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
index a8fa703109..c9336a85b6 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-max.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
@@ -120,7 +120,7 @@ adUnit?.fetchDemand {
 
 ```
 
-The **default** ad format for interstitial is **DISPLAY**. In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
+In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
 
 ```kotlin
 adUnit = MediationInterstitialAdUnit(
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-pb.md b/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
index 9d4ac0ca65..e5764f6952 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-pb.md
@@ -28,7 +28,7 @@ While the default ad server for Prebid's Mobile SDK is GAM, it can be expanded t
 
 In this mode, the developer is responsible for the following actions:
 
-- Call `fetchDemand()` with extended targetingDict callback
+- Call `fetchDemand()` with extended targetingDict callback (The method has been removed in the PrebidMobile `3.0.0`. Use the `fetchDemand()` with extended BidInfo callback instead)
 - Retrieve targeting keys from the extended fetchDemand function
 - Convert targeting keys into the format for your ad server
 - Pass converted keys to your ad server
@@ -37,9 +37,9 @@ In this mode, the developer is responsible for the following actions:
 This approach is available for the following ad formats:
 
 - Display Banner via `BannerAdUnit`
-- Video Banner and Instream Video via `VideoAdUnit`
+- Video Banner and Instream Video via `VideoAdUnit` (The class has been removed in the PrebidMobile `3.0.0`. Use the `InStreamVideoAdUnit` instead)
 - Display Interstitial via `InterstitialAdUnit`
-- Video Interstitial via `VideoInterstitialAdUnit`
+- Video Interstitial via `VideoInterstitialAdUnit` (The class has been removed in the PrebidMobile `3.0.0`. Use the `InterstitialAdUnit` with video ad format instead)
 - Rewarded Video via `RewardedVideoAdUnit`
 - Native Styles via `NativeRequest`
 
@@ -155,7 +155,7 @@ Pay attention that the `loadAd()` should be called on the main thread.
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-The **default** ad format for interstitial is **DISPLAY**. In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
+In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter.
 
 ``` kotlin
 interstitialAdUnit = InterstitialAdUnit(
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md b/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
index fb6b7e5e55..84551144a7 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-pb.md
@@ -37,9 +37,9 @@ In this mode, the developer is responsible for the following actions:
 This approach is available for the following ad formats:
 
 - Display Banner via `BannerAdUnit`
-- Video Banner and Instream Video via `VideoAdUnit`
+- Video Banner and Instream Video via `VideoAdUnit` (The class has been removed in the PrebidMobile `3.0.0`. Use the `InStreamVideoAdUnit` instead)
 - Display Interstitial via `InterstitialAdUnit`
-- Video Interstitial via `VideoInterstitialAdUnit`
+- Video Interstitial via `VideoInterstitialAdUnit` (The class has been removed in the PrebidMobile `3.0.0`. Use the `InterstitialAdUnit` with video ad format instead)
 - Rewarded Video via `RewardedVideoAdUnit`
 - Native Styles via `NativeRequest`
 - Multiformat ad unit via `PrebidAdUnit`
diff --git a/prebid-mobile/pbm-api/android/code-integration-android.md b/prebid-mobile/pbm-api/android/code-integration-android.md
index 4791cf1ac5..d186b90dab 100644
--- a/prebid-mobile/pbm-api/android/code-integration-android.md
+++ b/prebid-mobile/pbm-api/android/code-integration-android.md
@@ -64,7 +64,7 @@ If you see errors while building the Prebid Mobile SDK or Demo Applications, mak
 
 ## Add the Prebid SDK
 
-### Point to a Prebid Server
+### Prebid Server Account ID
 
 {% capture warning_note %}
 All integration examples for Android are written in `Kotlin`.
@@ -74,14 +74,24 @@ The corresponding Java code can be found in the [Demo Java](https://github.com/p
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-Once you have a [Prebid Server](/prebid-mobile/prebid-mobile-getting-started.html), you will add the 'account' info to Prebid Mobile. For example, if you're using the AppNexus Prebid Server:
+Once you have a [Prebid Server](/prebid-mobile/prebid-mobile-getting-started.html), you will add the 'account' info to Prebid Mobile.
 
 ```kotlin
 PrebidMobile.setPrebidServerAccountId(YOUR_ACCOUNT_ID)
+```
+
+### Point to a Prebid Server
+
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the setPrebidServerHost() method and the `Host.APPNEXUS` and `Host.RUBICON` enums have been removed. Please check the server URL in [API changes](/prebid-mobile/updates-3.0/android/api-changes#host) and use `PrebidMobile.initializeSdk` (below) to set the Prebid Server URL.
+
+In SDK 2.5 and before, if you're using the AppNexus Prebid Server you would do this:
+
+```kotlin
 PrebidMobile.setPrebidServerHost(Host.APPNEXUS)
 ```
 
-If you have opted to host your own Prebid Server solution you will need to store the url to the server in your app. Make sure that your URL points to the [/openrtb2/auction](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html) endpoint.
+In SDK 2.5 and before, if you have opted to host your own Prebid Server solution you will need to store the url to the server in your app. Make sure that your URL points to the [/openrtb2/auction](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html) endpoint.
 
 ```kotlin
 PrebidMobile.setPrebidServerHost(Host.createCustomHost("https://prebidserver.example.com/openrtb2/auction"))
@@ -96,15 +106,19 @@ If you want to define a different Account Settings ID as determined in conjuncti
 your Prebid Server team, use the [arbitrary OpenRTB](/prebid-mobile/pbm-api/android/pbm-targeting-android.html#arbitrary-openrtb) method like this:
 
 ```kotlin
-adUnitConfiguration?.ortbConfig = "{\"ext\":{\"prebid\":{\"storedrequest\": {\"id\":\"account-settings-id\"}}}}"
+TargetingParams.setGlobalOrtbConfig("{\"ext\":{\"prebid\":{\"storedrequest\": {\"id\":\"account-settings-id\"}}}})"
 ```
 
 ### Initialize SDK
 
-Once you set the account ID and the Prebid Server host, you should initialize the Prebid SDK. Use the following initialization for Prebid SDK:
+Once you set the account ID, you should initialize the Prebid SDK. 
+
+In SDK 3.0 and later, you need to enter a URL to your Prebid Server's auction endpoint in your app. Get this URL from your Prebid Server provider. e.g. `https://prebid-server.example.com/openrtb2/auction`.
+
+Use the following initialization for Prebid SDK:
 
 ```kotlin
-PrebidMobile.initializeSdk(applicationContext) { status ->
+PrebidMobile.initializeSdk(applicationContext, PREBID_SERVER_URL) { status ->
     if (status == InitializationStatus.SUCCEEDED) {
         Log.d(TAG, "SDK initialized successfully!")
     } else if (status == InitializationStatus.SERVER_STATUS_WARNING) {
@@ -121,7 +135,7 @@ Pay attention that SDK should be initialized on the main thread.
 {% endcapture %}
 {% include /alerts/alert_warning.html content=warning_note %}
 
-During the initialization, SDK creates internal classes and performs the health check request to the [/status](https://docs.prebid.org/prebid-server/endpoints/pbs-endpoint-status.html)  endpoint. If you use a custom PBS host you should provide a custom status endpoint as well:
+During the initialization, SDK creates internal classes and performs the health check request to the [/status](/prebid-server/endpoints/pbs-endpoint-status.html)  endpoint. If your Prebid Server provider has a non-standard path (anything other than `/status`), you should provide a the alternate status endpoint:
 
 ```kotlin
 PrebidMobile.setCustomStatusEndpoint(PREBID_SERVER_STATUS_ENDPOINT)
@@ -223,6 +237,9 @@ var pbsAccountId = PrebidMobile.getPrebidServerAccountId()
 ### Host
 {:.no_toc}
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the `Host` class is removed. Use the `PrebidMobile.initializeSdk` method to provide the your Prebid Server host instead.
+
 Object containing configuration for your Prebid Server host with which the Prebid SDK will communicate. Choose from the system-defined Prebid Server hosts or define your own custom Prebid Server host.
 
 ```kotlin
diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 5d1a3e05bc..0a07eb9c02 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -35,6 +35,9 @@ The `Prebid` class is a singleton that enables you to apply certain global setti
 
 ### Prebid Class Global Properties
 
+{: .alert.alert-warning :}
+The global properties exist only for PrebidMobile `2.5.0`. Starting from PrebidMobile `3.0.0` the global properties below are removed.
+
 All of these properties of the Prebid class can be set on the `shared` object like this:
 
 ```kotlin
@@ -44,9 +47,9 @@ Prebid.shared.sendMraidSupportParams=true
 {: .table .table-bordered .table-striped }
 | Parameter | Scope | Type | Purpose | Description | Example |
 | --- | --- | --- | --- | --- |
-| isCoppaEnabled | optional | boolean | ORTB | Set this to true if this app is aimed at children. It sets the ORTB `regs.coppa` flag. Default is false. | `true` |
-| useExternalBrowser | optional | boolean | behavior | If true, clicking on the ad will open your default browser instead of showing within the app's webview. Defaults to `false`. | `true` |
-| sendMraidSupportParams | optional | boolean | ORTB | If `true`, the SDK sends imp[].banner.api=[3,5], indicating support for MRAID. Defaults to `true`. | `false` |
+| isCoppaEnabled | optional | boolean | ORTB | Starting from PrebidMobile `3.0.0` the property is removed. Can be replaces with `TargetingParams.setSubjectToCOPPA()`<wbr>Set this to true if this app is aimed at children. It sets the ORTB `regs.coppa` flag. Default is false. | `true` |
+| useExternalBrowser | optional | boolean | behavior | Starting from PrebidMobile `3.0.0` the property is removed<wbr>If true, clicking on the ad will open your default browser instead of showing within the app's webview. Defaults to `false`. | `true` |
+| sendMraidSupportParams | optional | boolean | ORTB | Starting from PrebidMobile `3.0.0` the property is removed<wbr>If `true`, the SDK sends imp[].banner.api=[3,5], indicating support for MRAID. Defaults to `true`. | `false` |
 
 ### Prebid Class Global Methods
 
@@ -58,6 +61,9 @@ Your Prebid Server team will tell you whether this is required or not and if so,
 
 This is where the Prebid SDK will send the auction information.
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the `setPrebidServerHost` method is removed. Use the `initializeSdk` method instead.
+
 Signature:
 
 ```kotlin
@@ -74,8 +80,6 @@ Parameters:
 Examples:
 
 ```kotlin
-PrebidMobile.setPrebidServerHost(Host.APPNEXUS)
-PrebidMobile.setPrebidServerHost(Host.RUBICON)
 PrebidMobile.setPrebidServerHost(Host.createCustomHost("https://prebidserver.example.com/openrtb2/auction"))
 ```
 
@@ -470,36 +474,27 @@ Prebid SDK provides a number of properties in the [Targeting class](/prebid-mobi
 methods) for setting user-oriented First Party Data.
 
 ```kotlin
-void addUserData(String key, String value)
-
-void updateUserData( String key, Set<String> value)
+void addUserKeyword(String keyword)
 
-void removeUserData(String key)
+void addUserKeywords(Set<String> keywords)
 
-void clearUserData()
+void removeUserKeyword(String keyword)
 
-Map<String, Set<String>> getUserDataDictionary() {
+void clearUserKeywords()
 
-void addUserKeywords(Set<String> keywords) {
+String getUserKeywords()
 
-void removeUserKeyword(String keyword) {
-
-void clearUserKeywords() {
-
-String getUserKeywords() {
-
-Set<String> getUserKeywordsSet() {
+Set<String> getUserKeywordsSet()
 ```
 
 Example:
 
 ```kotlin
-TargetingParams.addUserData("globalUserDataKey1", "globalUserDataValue1")
+TargetingParams.addUserKeyword("globalUserKeyword")
 ```
 
 {: .alert.alert-info :}
-Note: The 'UserData' functions end up putting data into the OpenRTB user.ext.data object while the 'UserKeywords' functions
-put data into user.keywords.
+Note: The 'UserKeywords' functions put data into user.keywords.
 
 ### Inventory FPD
 
@@ -513,16 +508,6 @@ void updateExtData(String key, Set<String> value)
 void removeExtData(String key)
 
 Map<String, Set<String>> getExtDataDictionary()
-
-void addExtKeyword(String keyword)
-
-void addExtKeywords(Set<String> keywords)
-
-void removeExtKeyword(String keyword)
-
-void clearExtKeywords()
-
-Set<String> getExtKeywordsSet()
 ```
 
 Example:
@@ -807,18 +792,6 @@ Pay attention that there are certain protected fields such as `regs`, `device`,
 - App and User first party data should use the [functions defined for those purposes](/prebid-mobile/pbm-api/ios/pbm-targeting-ios.html#first-party-data)
 - See the [Prebid Server auction endpoint](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#prebid-server-ortb2-extension-summary) reference for more information about how it will process incoming fields.
 
-### Deprecated 
-{:.no_toc}
-
-The Prebid Mobile SDK v2.2.1 contains the deprecated method to set the impression level RTB config: 
-
-``` swift
-//ad unit / impression-level
-adUnit.setOrtbConfig("{\"ext\":{\"gpid\":\"abc123"}}\")
-```
-
-This method has implementation issues and was deprecated in v2.4.0. If you use this method, we strongly recommend migrating to the new `setImpORTBConfig()` method since this one will be removed entirely in SDK version 3.0.
-
 ## Further Reading
 
 - [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index c0a7f1c192..f73597f3e4 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -90,16 +90,26 @@ This will output the PrebidMobile.framework.
 
 ## Add the Prebid SDK
 
-### Point to a Prebid Server
+### Prebid Server Account ID
 
-Once you have a [Prebid Server](/prebid-mobile/prebid-mobile-getting-started.html), you will add 'account' info to the Prebid Mobile. For example, if you're using the AppNexus Prebid Server:
+Once you have a [Prebid Server](/prebid-mobile/prebid-mobile-getting-started.html), you will add 'account' info to the Prebid Mobile.
 
 ```swift
 Prebid.shared.prebidServerAccountId = YOUR_ACCOUNT_ID
+```
+
+### Point to a Prebid Server
+
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the setCustomPrebidServer() method and the `Host.Appnexus` and `Host.Rubicon` enums have been removed. Please check the server URL in [API changes](/prebid-mobile/updates-3.0/ios/api-changes#host) and use `PrebidMobile.initializeSdk` (below) to set the Prebid Server URL.
+
+In SDK 2.5 and before, if you're using the AppNexus Prebid Server, you would do this:
+
+```swift
 Prebid.shared.prebidServerHost = .Appnexus
 ```
 
-If you have opted to host your own Prebid Server solution, you will need to store the URL to the server in your app. Make sure that your URL points to the [/openrtb2/auction](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html) endpoint.
+In SDK 2.5 and before, if you have opted to host your own Prebid Server solution, you will need to store the URL to the server in your app. Make sure that your URL points to the [/openrtb2/auction](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html) endpoint.
 
 ```swift
 try! Prebid.shared.setCustomPrebidServer(url: "https://prebidserver.example.com/openrtb2/auction")
@@ -113,19 +123,21 @@ Each mobile app may have its own "account settings ID". This is used to look up
 
 By default the Account Settings ID is set to be the same as the Account ID. i.e. the Prebid.shared.prebidServerAccountId property will set both values.
 If you want to define a different Account Settings ID as determined in conjunction with
-your Prebid Server team, use the [arbitrary OpenRTB](/prebid-mobile/pbm-api/android/pbm-targeting-android.html#arbitrary-openrtb) method like this:
+your Prebid Server team, use the [arbitrary OpenRTB](/prebid-mobile/pbm-api/ios/pbm-targeting-ios.html#arbitrary-openrtb) method like this:
 
 ```swift
-adUnitConfig.setOrtbConfig = "{\"ext\":{\"prebid\":{\"storedrequest\": {\"id\":\"account-settings-id\"}}}}"
+Targeting.shared.setGlobalORTBConfig("{\"ext\":{\"prebid\":{\"storedrequest\": {\"id\":\"account-settings-id\"}}}}")
 ```
 
 ### Initialize SDK
 
-Once you set the account ID and the Prebid Server host, you should initialize the Prebid SDK. There are several options for how to do it.
+Once you set the account ID, you should initialize the Prebid SDK. 
+
+In SDK 3.0 and later, you need to enter a URL to your Prebid Server's auction endpoint in your app. Get this URL from your Prebid Server provider. e.g. `https://prebid-server.example.com/openrtb2/auction`.
 
 If you integrate Prebid Mobile with GMA SDK with version equal or higher than 10.7.0, use the following initializer, which checks the compatibility of Prebid SDK with GMA SDK used in the app:
 
-{% capture gma12 %}Prebid.initializeSDK(gadMobileAdsVersion: string(for: MobileAds.shared.versionNumber)) { status, error in
+{% capture gma12 %}Prebid.initializeSDK(PREBID_SERVER_URL, gadMobileAdsVersion: string(for: MobileAds.shared.versionNumber)) { status, error in
     switch status {
     case .succeeded:
         print("Prebid SDK successfully initialized")
@@ -140,9 +152,9 @@ If you integrate Prebid Mobile with GMA SDK with version equal or higher than 10
     default:
         break
     }            
-}   
+}
 {% endcapture %}
-{% capture gma11 %}Prebid.initializeSDK(gadMobileAdsVersion: GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber) { status, error in
+{% capture gma11 %}Prebid.initializeSDK(PREBID_SERVER_URL, gadMobileAdsVersion: GADGetStringFromVersionNumber(GADMobileAds.sharedInstance().versionNumber) { status, error in
     switch status {
     case .succeeded:
         print("Prebid SDK successfully initialized")
@@ -157,7 +169,7 @@ If you integrate Prebid Mobile with GMA SDK with version equal or higher than 10
     default:
         break
     }            
-}            
+}
 {% endcapture %}
 
 {% include code/gma-versions-tabs.html id="pbm-init" gma11=gma11 gma12=gma12 %}
@@ -165,7 +177,7 @@ If you integrate Prebid Mobile with GMA SDK with version equal or higher than 10
 If you integrate Prebid Mobile with GMA SDK with version lower than 10.7.0, use the following initializer:
 
 ```swift
-Prebid.initializeSDK(GADMobileAds.sharedInstance()) { status, error in
+Prebid.initializeSDK(PREBID_SERVER_URL, GADMobileAds.sharedInstance()) { status, error in
     switch status {
     case .succeeded:
         print("Prebid SDK successfully initialized")
@@ -188,12 +200,14 @@ Check the log messages of the app. If the provided GMA SDK version is not verifi
 For the No Ad Server scenario, use the following initialization:
 
 ```swift
-Prebid.initializeSDK { status, error in
+Prebid.initializeSDK(PREBID_SERVER_URL) { status, error in
     // ....
 }
 ```
 
-During the initialization, SDK creates internal classes and performs the health check request to the [/status](https://docs.prebid.org/prebid-server/endpoints/pbs-endpoint-status.html)  endpoint. If you use a custom PBS host you should provide a custom status endpoint as well:
+All initialization methods may throw an exception if the provided server URL is invalid.
+
+During the initialization, SDK creates internal classes and performs the health check request to the [/status](/prebid-server/endpoints/pbs-endpoint-status.html)  endpoint. If your Prebid Server provider has a non-standard path (anything other than `/status`), you should provide a the alternate status endpoint:
 
 ```swift
 Prebid.shared.customStatusEndpoint = PREBID_SERVER_STATUS_ENDPOINT
@@ -201,6 +215,28 @@ Prebid.shared.customStatusEndpoint = PREBID_SERVER_STATUS_ENDPOINT
 
 If something goes wrong with the request, the status of the initialization callback will be `.serverStatusWarning`. It doesn't affect an SDK flow and just informs you about the health check result.
 
+#### Handling Tracking Domains
+
+As part of Apple's evolving privacy policies, SDKs that access user data in a way that could be used for tracking may be required to register tracking domains in the `PrivacyInfo.xcprivacy` file. 
+
+Currently, the Prebid Mobile SDK is not classified as one of these SDKs. But future changes from Apple or internal app review policies may prompt publishers to proactively register the Prebid Server (PBS) endpoint in the privacy manifest. To support this, the Prebid SDK is designed to accommodate both tracking and non-tracking PBS domains. Here are the Prebid recommendations:
+
+- Include the relevant `NSPrivacyCollectedDataTypes` and define your primary Prebid Server domain in the `NSPrivacyTrackingDomains` array in your the `PrivacyInfo.xcprivacy` file to cover a potential "worst case" scenario. Read more about the `PrivacyInfo.xcprivacy` data [here](https://docs.prebid.org/faq/prebid-mobile-faq.html#privacysecurity).
+- You may choose to provide a secondary, privacy-mode PBS URL to the SDK. This secondary domain can be used when tracking is disallowed. Get this additional hostname from your Prebid Server host provider. Every initialization method contains optional parameter to define this privacy-safe PBS domain. Since these requests will have the `limit ad tracking` flag defined, Prebid Server will anonymize the requests.
+
+You’re not required to use a secondary PBS domain -- you can simply allow iOS to block PBS requests when the user opts out of tracking.
+
+```swift
+let trackingURL = "https://prebidserver.example.com/openrtb2/auction"
+let nonTrackingURL = "https://prebidserver.example.nontracking.com/openrtb2/auction"
+Prebid.initializeSDK(trackingURL, nonTrackingURL) { status, error in
+    // ....
+}
+```
+
+{: .alert.alert-warning :}
+Depending on Apple’s domain monitoring mechanisms, even the privacy-mode domain could potentially be blocked. In such cases, the PBS provider may need to engage with Apple for resolution.
+
 ## Set Global Parameters
 
 There are several types of parameters app developers should consider providing to Prebid SDK:
@@ -323,12 +359,17 @@ All values received in the `passthrough` of the bid response will be applied to
 ### Examples
 {:.no_toc}
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the `prebidServerHost` property and the `setCustomPrebidServer` method are removed. Use `Prebid.initializeSDK` instead. If you used `Host.Appnexus` or `Host.Rubicon` to set your host, you should check the server URL in [API changes](/prebid-mobile/updates-3.0/ios/api-changes#host).
+
 ```swift
-// Host
+
+// Host (Removed in 3.0.0. Use `Prebid.initializeSDK` instead.)
 Prebid.shared.prebidServerHost = .Rubicon
-// or set a custom host
+// or set a custom host (Removed in 3.0.0. Use `Prebid.initializeSDK` instead.)
 Prebid.shared.prebidServerHost = PrebidHost.Custom
 do {
+    // Removed in 3.0.0. Use `Prebid.initializeSDK` instead.
     try Prebid.shared.setCustomPrebidServer(url: "https://prebid-server.customhost.com")
 } catch {
     print(error)
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index b3da208e65..147ec5fabb 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -46,7 +46,7 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 | Parameter | Scope | Type | Purpose | Description | Example |
 | --- | --- | --- | --- | --- | --- |
 | prebidServerAccountId | either | string | init | Your Prebid Server team will tell you whether this is required or not and if so, the value. | "abc123" |
-| prebidServerHost | optional | enum | init | This can take the values "Appnexus", "Rubicon", or "Custom". If "Custom", you need to use the setCustomPrebidServerUrl() method to set a URL. This is where the Prebid SDK will send the auction information. Your Prebid Server team will tell you which value to use. The default is "Custom". | "Custom" |
+| prebidServerHost | optional | enum | init | Starting from PrebidMobile `3.0.0` the property is removed<wbr>This can take the values "Appnexus", "Rubicon", or "Custom". If "Custom", you need to use the setCustomPrebidServerUrl() method to set a URL. This is where the Prebid SDK will send the auction information. Your Prebid Server team will tell you which value to use. The default is "Custom". | "Custom" |
 | customStatusEndpoint | optional | string | init | Use this URL to check the status of Prebid Server. The default status endpoint is the PBS URL appended with '/status'. | `https://prebidserver`<wbr>`.example`<wbr>`.com/custom`<wbr>`/status` |
 | shareGeoLocation | optional | boolean | ORTB | If this flag is true AND the app collects the user’s geographical location data, Prebid Mobile will send the user’s lat/long geographical location data to the Prebid Server. The default is false. | `true` |
 | locationUpdatesEnabled | optional | boolean | ORTB | If true, the SDK will periodically try to listen for location updates. Default is `false`. | `true` |
@@ -59,8 +59,8 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 | pbsDebug | optional | boolean | ORTB | Adds the debug flag (`test`:1) on the outbound http call to the Prebid Server. The `test` flag signals to the Prebid Server to emit the full resolved request and the full Bid Request and Bid Response to and from each bidder. | true |
 | shouldAssign<wbr>NativeAssetID | optional | boolean | ORTB | Whether to automatically assign an assetID for a Native ad. Default is `false`. | true |
 | useCacheForReporting<wbr>WithRenderingAPI | optional | boolean | ORTB | Indicates whether PBS should cache the bid on the server side. If the value is `true` the Prebid SDK will make the cache request to retrieve the cached asset. Default is `false`. | true |
-| useExternal<wbr>ClickthroughBrowser | optional | boolean | SDK control | Controls whether to use PrebidMobile's in-app browser or the Safari App for displaying ad clickthrough content. Default is false. | true |
-| impClickbrowserType | optional | enum | ORTB | Indicates the type of browser opened upon clicking the creative in an app. This corresponds to the OpenRTB imp.clickbrowser field. Values are "embedded" and "native". Default is "native". | "native". |
+| useExternal<wbr>ClickthroughBrowser | optional | boolean | SDK control | Starting from PrebidMobile `3.0.0` the property is removed<wbr>Controls whether to use PrebidMobile's in-app browser or the Safari App for displaying ad clickthrough content. Default is false. | true |
+| impClickbrowserType | optional | enum | ORTB | Starting from PrebidMobile `3.0.0` the property is removed<wbr>Indicates the type of browser opened upon clicking the creative in an app. This corresponds to the OpenRTB imp.clickbrowser field. Values are "embedded" and "native". Default is "native". | "native". |
 | includeWinners | optional | boolean | ORTB | If `true`, Prebid sdk will add `includewinners` flag inside the targeting object described in [PBS Documentation](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#targeting) . Default is `false`. | `true` |
 | includeBidderKeys | optional | boolean | ORTB | If `true`, Prebid sdk will add `includebidderkeys` flag inside the targeting object described in [PBS Documentation](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#targeting) . Default is `false`. | `true` |
 | eventDelegate | optional | PrebidEventDelegate | init | Sets an event delegate to handle all auction requests and responses. It allows to collect some statistical data. Note that the SDK stores this callback as a weak reference so you need to store a reference to it. | `class PrebidEventDelegateTestsMockDelegate: PrebidEventDelegate { func prebidBidRequestDidFinish(requestData: Data?, responseData: Data?) { ... } }` |
@@ -69,6 +69,9 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 
 #### setCustomPrebidServerUrl()
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the method is removed. Use `Prebid.initializeSDK` instead.
+
 Defines which Prebid Server to connect to. See the initialization page for [iOS](/prebid-mobile/pbm-api/ios/code-integration-ios.html).
 
 #### addStoredBidResponse()
@@ -369,14 +372,6 @@ Prebid SDK provides a number of properties in the [Targeting class](/prebid-mobi
 ```swift
 func setLatitude(latitude: Double, longitude: Double)
 
-func addUserData(key: String, value: String)
-
-func updateUserData(key: String, value: Set<String>)
-
-func removeUserData(forKey: String)
-
-func clearUserData()
-
 func addUserKeyword(_ newElement: String)
 
 func addUserKeywords(_ newElements: Set<String>)
@@ -391,14 +386,11 @@ func getUserKeywords()
 Example:
 
 ```swift
-Targeting.shared.addUserData(key: "globalUserDataKey1", value: "globalUserDataValue1")
+Targeting.shared.addUserKeyword(key: "globalUserKeyword")
 ```
 
 {: .alert.alert-info :}
-Note: The 'UserData' functions end up putting data into the OpenRTB user.ext.data object while the 'UserKeywords' functions
-put data into user.keywords.
-
-Related functions: setYearOfBirth(), getYearOfBirth() and clearYearOfBirth().
+Note: The 'UserKeywords' functions put data into user.keywords.
 
 ### Inventory FPD
 
@@ -447,7 +439,7 @@ func clearAccessControlList()
 Example:
 
 ```swift
-Targeting.shared.addBidderToAccessControlList(Prebid.bidderNameRubiconProject)
+Targeting.shared.addBidderToAccessControlList("bidderA")
 ```
 
 ---
@@ -515,9 +507,6 @@ Certain identity vendors require an external dependency to generate user identit
 UID2 provides a [native library](https://unifiedid.com/docs/guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) for automatically updating latest UID2
 token stored inside [UID2 SDK for iOS](https://unifiedid.com/docs/sdks/sdk-ref-ios) into Prebid's external user's ID list.
 
-App developers are not required to manually call ```Prebid.shared.externalUserIdArray = latestExternalUserIdArray``` 
-as the native library will do so automatically
-
 Note:
 
 - [Github repo](https://github.com/IABTechLab/uid2-ios-sdk)
@@ -594,18 +583,6 @@ Pay attention that there are certain protected fields such as `regs`, `device`,
 - App and User first party data should use the [functions defined for those purposes](/prebid-mobile/pbm-api/ios/pbm-targeting-ios.html#first-party-data)
 - See the [Prebid Server auction endpoint](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#prebid-server-ortb2-extension-summary) reference for more information about how it will process incoming fields.
 
-### Deprecated 
-{:.no_toc}
-
-The Prebid Mobile SDK v2.2.1 contains the deprecated method to set the impression level RTB config: 
-
-``` swift
-//ad unit / impression-level
-adUnit.setOrtbConfig("{\"ext\":{\"gpid\":\"abc123"}}\")
-```
-
-This method has implementation issues and was deprecated in v2.4.0. If you use this method, we strongly recommend migrating to the new `setImpORTBConfig()` method since this one will be removed entirely in SDK version 3.0.
-
 ## Further Reading
 
 - [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
diff --git a/prebid-mobile/prebid-mobile.md b/prebid-mobile/prebid-mobile.md
index 646ae9c939..c35bf8152e 100644
--- a/prebid-mobile/prebid-mobile.md
+++ b/prebid-mobile/prebid-mobile.md
@@ -8,13 +8,21 @@ sidebarType: 2
 # Prebid Mobile Overview
 {:.no_toc}
 
-Prebid Mobile is an open-source library fir iOS and Android that provides an end-to-end header bidding solution for mobile app publishers.
+Prebid Mobile is an open-source library for iOS and Android that provides an end-to-end header bidding solution for mobile app publishers.
+
+---- 
 
 {: .alert.alert-info :}
-The Prebid Mobile team is pleased to announce that we're getting ready
-to start building the next major version. Please see the
-[plan for Prebid Mobile 3.0](/prebid-mobile/docs/Prebid_Mobile_3_0_0.pdf)
-and provide feedback to <support@prebid.org>.
+The Prebid Mobile team is pleased to inform you that `Prebid Mobile 3.0` is live.
+
+Here is what you need to know first about the new version:
+
+- [3.0 Updates Overview](updates-3.0/sdk-key-features.html).
+- API Changes: [iOS](updates-3.0/ios/api-changes.html), [Android](updates-3.0/android/api-changes.html).
+
+Provide feedback to <support@prebid.org>.
+
+---- 
 
 - TOC
 {:toc}
diff --git a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-html-banner.md b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-html-banner.md
index 900eadb2a5..95c5a55721 100644
--- a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-html-banner.md
+++ b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-html-banner.md
@@ -20,9 +20,14 @@ private fun createAd() {
     adUnit?.setAutoRefreshInterval(refreshTimeSeconds)
 
     // 2. Configure banner parameters
-    val parameters = BannerBaseAdUnit.Parameters()
+    val parameters = BannerParameters()
     parameters.api = listOf(Signals.Api.MRAID_3, Signals.Api.OMID_1)
-    adUnit?.parameters = parameters
+    adUnit?.bannerParameters = parameters
+
+    // 2. Configure banner parameters for PrebidMobile 2.5 
+    // val parameters = BannerBaseAdUnit.Parameters()
+    // parameters.api = listOf(Signals.Api.MRAID_3, Signals.Api.OMID_1)
+    // adUnit?.parameters = parameters
 
    // For multi-size request
    adUnit?.addAdditionalSize(728, 90)
@@ -46,6 +51,9 @@ private fun createAd() {
 }
 ```
 
+{: .alert.alert-warning :}
+Starting from PrebidMobile `3.0.0` the `BannerBaseAdUnit.Parameters` class is removed. Use `BannerParameters` class instead.
+
 It may be necessary to implement AdListener to adjust banner view size according to the creative size, for the case where there are several ad sizes supported. This logic is not needed for a single size banner: 
 
 Prebid SDK can be thought of an OpenRTB request synthesizer.  OpenRTB does not have a notion of adaptive banners, but it has a notion of several banner sizes / formats in one request.  So an adaptive banner may be represented as a request containing several banner sizes, e.g. a fixed width that equals the size of the screen and several different heights.  The examples here deal with a single ad size, but more can be added via BannerParameters.adSizes array.
diff --git a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-interstitial-video.md b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-interstitial-video.md
index e268bc0583..15c6d464cd 100644
--- a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-interstitial-video.md
+++ b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-interstitial-video.md
@@ -38,7 +38,7 @@ private fun createAd() {
 ```
 
 {: .alert.alert-warning :}
-Starting from PrebidMobile `2.1.0` the `VideoInterstitialAdUnit` class is deprecated. Use `InterstitialAdUnit` class with video ad format instead.
+Starting from PrebidMobile `2.1.0` the `VideoInterstitialAdUnit` class is deprecated and from PrebidMobile `3.0.0` - removed. Use `InterstitialAdUnit` class with video ad format instead.
 
 Configuration function:
 
diff --git a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-instream.md b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-instream.md
index d049cc315d..45c6d4282e 100644
--- a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-instream.md
+++ b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-instream.md
@@ -15,7 +15,7 @@ Integration example:
 
 ```kotlin
 private fun createAd() {
-    // 1. Create VideoAdUnit
+    // 1. Create InStreamVideoAdUnit
     adUnit = InStreamVideoAdUnit(CONFIG_ID, WIDTH, HEIGHT)
 
     // 2. Configure video parameters
@@ -47,7 +47,7 @@ private fun createAd() {
 ```
 
 {: .alert.alert-warning :}
-Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated. Use `InStreamVideoAdUnit` instead.
+Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated and from PrebidMobile `3.0.0` - removed. Use `InStreamVideoAdUnit` class with video ad format instead.
 
 Configure the video ad:
 
diff --git a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-outstream.md b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-outstream.md
index 279253d0a9..e9a038f044 100644
--- a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-outstream.md
+++ b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-video-outstream.md
@@ -16,7 +16,7 @@ Integration example:
 
 ```kotlin
 private fun createAd() {
-    // 1. Create VideoAdUnit
+    // 1. Create BannerAdUnit
     adUnit = BannerAdUnit(CONFIG_ID, WIDTH, HEIGHT, EnumSet.of(AdUnitFormat.VIDEO))
 
     // 2. Configure video ad unit
@@ -39,7 +39,7 @@ private fun createAd() {
 ```
 
 {: .alert.alert-warning :}
-Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated. Use `BannerAdUnit` class with video ad format instead.
+Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated and from PrebidMobile `3.0.0` - removed. Use `BannerAdUnit` class with video ad format instead.
 
 Configure Video parameters:
 
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
index b205ea09a7..7131ef68cc 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
@@ -22,7 +22,7 @@ To integrate HTML banner ads into the app you should use the `BannerAdUnit` clas
     // 2. Configure banner parameters using Prebid Mobile SDK
     let parameters = BannerParameters()
     parameters.api = [Signals.Api.MRAID_2, Signals.Api.OMID_1]
-    adUnit.parameters = parameters
+    adUnit.bannerParameters = parameters
     
     // 3. Create an AdManagerBannerView using Google Mobile Ads SDK
     gamBanner = AdManagerBannerView(adSize: adSizeFor(cgSize: AD_SIZE))
@@ -52,7 +52,7 @@ To integrate HTML banner ads into the app you should use the `BannerAdUnit` clas
     // 2. Configure banner parameters using Prebid Mobile SDK
     let parameters = BannerParameters()
     parameters.api = [Signals.Api.MRAID_2, Signals.Api.OMID_1]
-    adUnit.parameters = parameters
+    adUnit.bannerParameters = parameters
     
     // 3. Create a GAMBannerView using Google Mobile Ads SDK
     gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
index f01db9baf7..a89bdc70b2 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-interstitial-video.md
@@ -60,7 +60,7 @@ To integrate Video Interstitial ads into the app you should use the Prebid SDK `
     parameters.mimes = ["video/mp4"]
     parameters.protocols = [Signals.Protocols.VAST_2_0]
     parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOn]
-    adUnit.parameters = parameters
+    adUnit.bannerParameters = parameters
     
     // 4. Make a bid request to Prebid Server using Prebid Mobile SDK
     let gamRequest = GAMRequest()
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
index 8174d0503b..7e72127857 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-rewarded-video.md
@@ -52,7 +52,7 @@ To integrate Rewarded Video ads into the app you should use the Prebid SDK `Rewa
     parameters.mimes = ["video/mp4"]
     parameters.protocols = [Signals.Protocols.VAST_2_0]
     parameters.playbackMethod = [Signals.PlaybackMethod.AutoPlaySoundOn]
-    adUnit.parameters = parameters
+    adUnit.videoParameters = parameters
     
     // 3. Make a bid request to Prebid Server using Prebid Mobile SDK
     let gamRequest = GAMRequest()
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-instream.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-instream.md
index 635408ee0b..0f177b5b01 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-instream.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-instream.md
@@ -94,7 +94,7 @@ func adsManagerDidRequestContentResume(_ adsManager: IMAAdsManager) {
 ```
 
 {: .alert.alert-warning :}
-Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated. Use `InstreamVideoAdUnit` class instead.
+Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated and from PrebidMobile `3.0.0` - removed. Use `InstreamVideoAdUnit` class with video ad format instead.
 
 ## Step 1: Create an InstreamVideoAdUnit
 {:.no_toc}
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
index 7694451547..3aff90dea8 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-video-outstream.md
@@ -80,7 +80,7 @@ adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
 {% include code/gma-versions-tabs.html id="non-instream-video" gma11=gma11 gma12=gma12 %}
 
 {: .alert.alert-warning :}
-Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated. Use `BannerAdUnit` class with video ad format instead.
+Starting from PrebidMobile `2.1.0` the `VideoAdUnit` class is deprecated and from PrebidMobile `3.0.0` - removed. Use `BannerAdUnit` class with video ad format instead.
 
 ## Step 1: Create a BannerAdUnit
 {:.no_toc}
diff --git a/prebid-mobile/updates-3.0/android/api-changes.md b/prebid-mobile/updates-3.0/android/api-changes.md
new file mode 100644
index 0000000000..c9bdaf089b
--- /dev/null
+++ b/prebid-mobile/updates-3.0/android/api-changes.md
@@ -0,0 +1,206 @@
+---
+layout: page_v2
+title: Prebid Mobile 3.0 API Changes
+description: Prebid Mobile 3.0 API Changes
+pid: 1
+top_nav_section: prebid-mobile
+nav_section: prebid-mobile-android
+sidebarType: 2
+---
+
+<style>
+table th:first-of-type {
+    width: 50%;
+}
+table th:nth-of-type(2) {
+    width: 50%;
+}
+</style>
+
+# Prebid Mobile 3.0 API Changes
+
+{:.no_toc}
+
+This page provides a detailed list of removed APIs in PrebidMobile SDK 3.0, along with their corresponding recommended
+replacements.
+
+## Elimination of Deprecated Functionality
+
+PrebidMobile 3.0 introduces significant changes and removes several deprecated features. Below is a detailed breakdown
+of these removals, and how publishers should migrate to the new alternatives.
+
+### PrebidMobile
+
+{: .table .table-bordered .table-striped }
+
+| Removed                          | Alternative                                                                                                                                                                                                |
+|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| isCoppaEnabled                   | [setSubjectToCOPPA()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setSubjectToCOPPA(java.lang.Boolean))                                         |
+| useExternalBrowser               | None, removed.                                                                                                                                                                                             |
+| sendMraidSupportParams           | None, by default true.                                                                                                                                                                                     |
+| logLevel                         | [setLogLevel()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/LogUtil.html#setLogLevel(int))                                                                                             |
+| setPrebidServerHost()            | [initializeSdk()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/PrebidMobile.html#initializeSdk(android.content.Context,java.lang.String,SdkInitializationListener)) with host parameter |
+| setExternalUserIds()             | [TargetingParams.setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List))                                            |
+| initializeSdk(context, listener) | [initializeSdk()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/PrebidMobile.html#initializeSdk(android.content.Context,java.lang.String,SdkInitializationListener)) with host parameter |
+| getApplicationContext()          | PrebidContextHolder.getContext() |
+
+---
+
+### Ad units
+
+All classes with ad unit data: AdUnit, BannerView, InterstitialAdUnit, RewardedAdUnit, MediationBannerAdUnit,
+MediationBaseInterstitialAdUnit, MediationNativeAdUnit, PrebidRequest, TargetingParams.
+
+{: .table .table-bordered .table-striped }
+
+| Removed                    | Alternative                                                                                                                                                                                                                                                                                                 |
+|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| addContextData()           | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| updateContextData()        | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| removeContextData()        | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| clearContextData()         | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getContextDataDictionary() | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addContextKeyword()        | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addContextKeywords()       | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| removeContextKeyword()     | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| clearContextKeywords()     | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getContextKeywordsSet()    | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addExtKeyword()            | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addExtKeywords()           | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| removeExtKeyword()         | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| clearExtKeywords()         | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getExtKeywordsSet()        | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addExtData()               | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| updateExtData()            | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| removeExtData(String key)  | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| clearExtData()             | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getExtDataDictionary()     | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| setAppContent()            | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getAppContent()            | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| addUserData()              | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| getUserData()              | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| clearUserData()            | None, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)).                                                                                                                                       |
+| setOrtbConfig()            | [setImpOrtbConfig()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String)) or [TargetingParams.setGlobalOrtbConfig()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setGlobalOrtbConfig(java.lang.String)) |
+
+### AdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed                          | Alternative                                                                                                                                                                     |
+|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| setAutoRefreshPeriodMillis()     | [setAutoRefreshInterval()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setAutoRefreshInterval(int))                                             |
+| fetchDemand(OnCompleteListener2) | [fetchDemand(OnFetchDemandResult)](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#fetchDemand(org.prebid.mobile.api.original.OnFetchDemandResult)) |
+
+### BannerAdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed                   | Alternative                                                                                                                                                            |
+|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| setParameters()           | [setBannerParameters()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerBaseAdUnit.html#setBannerParameters(org.prebid.mobile.BannerParameters)) |
+| getParameters()           | [getBannerParameters()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerBaseAdUnit.html#getBannerParameters())                                   |
+| Internal Parameters class | [BannerParameters](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerParameters.html)                                                              |
+
+---
+
+### InterstitialAdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed                   | Alternative                                                                                                                                                            |
+|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| setParameters()           | [setBannerParameters()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerBaseAdUnit.html#setBannerParameters(org.prebid.mobile.BannerParameters)) |
+| getParameters()           | [getBannerParameters()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerBaseAdUnit.html#getBannerParameters())                                   |
+| Internal Parameters class | [VideoParameters](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/VideoParameters.html)                                                                |
+
+---
+
+### VideoAdUnit
+
+The class was removed.
+Alternative - [BannerAdUnit](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/BannerAdUnit.html) with
+video ad format.
+
+### VideoInterstitialAdUnit
+
+The class was removed.
+Alternative - [InterstitialAdUnit](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/InterstitialAdUnit.html)
+with video ad format.
+
+### Support Classes - TargetingParams
+
+{: .table .table-bordered .table-striped }
+
+| Removed                      | Alternative                                                                                                                                                                                                                                                                           |
+|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| setUserAge()                 | Deprecated in OpenRTB, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String))                                                                                                                                                                                                                                                                      |
+| getUserAge()                 | None, removed.                                                                                                                                                                                                                                                                        |
+| getYearOfBirth()             | Deprecated in OpenRTB. Removed.                                                                                                                                                                                                                                                       |
+| setYearOfBirth()             | Deprecated in OpenRTB, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String))                                                                                                                                                                                                                                                      |
+| GENDER                       | Deprecated in OpenRTB. Removed.                                                                                                                                                                                                                                                       |
+| getGender()                  | Deprecated in OpenRTB. Removed.                                                                                                                                                                                                                                                       |
+| setGender()                  | Deprecated in OpenRTB, removed. Can be replaced with [OpenRTB config](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/AdUnit.html#setImpOrtbConfig(java.lang.String))                                                                                                                                                                                                                                                    |
+| setUserId()                  | None, removed. Can be replaced with [TargetingParams.setGlobalOrtbConfig()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setGlobalOrtbConfig(java.lang.String))                                                                                                                                                                                                                                                           |
+| getUserId()                  | None, removed.                                                                                                                                                                                                                                                                        |
+| setBuyerId()                 | None, removed. Can be replaced with [TargetingParams.setGlobalOrtbConfig()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setGlobalOrtbConfig(java.lang.String))                                                                                                                                                                                                                                                                       |
+| getBuyerId()                 | None, removed.                                                                                                                                                                                                                                                                        |
+| getUserCustomData()          | None, removed.                                                                                                                             |
+| setUserCustomData()          | None, removed. Can be replaced with [TargetingParams.setGlobalOrtbConfig()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setGlobalOrtbConfig(java.lang.String))                                  |
+| storeExternalUserId()        | [setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List)) and [getExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#getExternalUserIds()) |
+| fetchStoredExternalUserId()  | [setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List)) and [getExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#getExternalUserIds()) |
+| fetchStoredExternalUserIds() | [setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List)) and [getExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#getExternalUserIds()) |
+| removeStoredExternalUserId() | [setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List)) and [getExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#getExternalUserIds()) |
+| clearStoredExternalUserIds() | [setExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#setExternalUserIds(java.util.List)) and [getExternalUserIds()](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/TargetingParams.html#getExternalUserIds()) |
+
+### ExternalUserId
+
+{: .table .table-bordered .table-striped }
+
+| Removed                                        | Alternative                  |
+|------------------------------------------------|------------------------------|
+| ExternalUserId(source, identifier, atype, ext) | [ExternalUserId(source, uids)](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/ExternalUserId.html#%3Cinit%3E(java.lang.String,java.util.List)) |
+| getAtype()                                     | Use [UniqueId](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/ExternalUserId.UniqueId.html) class.          |
+| setAtype()                                     | Use [UniqueId](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/ExternalUserId.UniqueId.html) class.          |
+| getIdentifier()                                | Use [UniqueId](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/ExternalUserId.UniqueId.html) class.          |
+| setIdentifier()                                | Use [UniqueId](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/ExternalUserId.UniqueId.html) class.          |
+
+### PrebidNativeAd
+
+{: .table .table-bordered .table-striped }
+
+| Removed                                         | Alternative                        |
+|-------------------------------------------------|------------------------------------|
+| registerView(view, listener)                    | [registerView(view, list, listener)](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/PrebidNativeAd.html#registerView(android.view.View,java.util.List,org.prebid.mobile.PrebidNativeAdEventListener)) |
+| registerViewList(container, viewList, listener) | [registerView(view, list, listener)](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/PrebidNativeAd.html#registerView(android.view.View,java.util.List,org.prebid.mobile.PrebidNativeAdEventListener)) |
+
+### AdFormat
+
+{: .table .table-bordered .table-striped }
+
+| Removed | Alternative |
+|---------|-------------|
+| DISPLAY | [BANNER](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/api/data/AdUnitFormat.html#BANNER)      |
+
+### Host
+
+{: .table .table-bordered .table-striped }
+
+| Removed  | Alternative                                                   |
+|----------|---------------------------------------------------------------|
+| APPNEXUS | "<https://ib.adnxs.com/openrtb2/prebid>"                      |
+| RUBICON  | "<https://prebid-server.rubiconproject.com/openrtb2/auction>" |
+
+### NativeImageAsset
+
+{: .table .table-bordered .table-striped }
+
+| Removed            | Alternative                        |
+|--------------------|------------------------------------|
+| NativeImageAsset() | [NativeImageAsset(w, h, minw, minh)](https://docs.prebid.org/prebid-mobile-android/org/prebid/mobile/NativeImageAsset.html#%3Cinit%3E(int,int,int,int)) |
+
+### Other Changes
+
+- Removed deprecated `InitError` class.
+- Removed deprecated `SdkInitListener` interface.
+- Removed deprecated `OnCompleteListener` interface.
+- Introduced `SdkInitialization` listener without deprecated callbacks.
diff --git a/prebid-mobile/updates-3.0/ios/api-changes.md b/prebid-mobile/updates-3.0/ios/api-changes.md
new file mode 100644
index 0000000000..a71c43f751
--- /dev/null
+++ b/prebid-mobile/updates-3.0/ios/api-changes.md
@@ -0,0 +1,243 @@
+---
+layout: page_v2
+title: Prebid Mobile 3.0 API Changes
+description: Prebid Mobile 3.0 API Changes
+pid: 1
+top_nav_section: prebid-mobile
+nav_section: prebid-mobile-ios
+sidebarType: 2
+---
+
+<style>
+table th:first-of-type {
+    width: 50%;
+}
+table th:nth-of-type(2) {
+    width: 50%;
+}
+</style>
+
+# Prebid Mobile 3.0 API Changes
+{:.no_toc}
+
+This page provides a detailed list of removed APIs in PrebidMobile SDK 3.0, along with their corresponding recommended replacements.
+
+- TOC
+{:toc}
+
+## Elimination of Deprecated Functionality
+
+PrebidMobile 3.0 introduces significant changes and removes several deprecated features. Below is a detailed breakdown of these removals, and how publishers should migrate to the new alternatives.
+
+### Targeting
+
+{: .table .table-bordered .table-striped }
+
+| Removed                                | Alternative                       |
+| -------------------------------------- | --------------------------------- |
+| buyerUID                               | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)                |
+| userCustomData                         | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)                |
+| locationPrecision                      | None, removed                     |
+| setLocationPrecision(\_:)              | None, removed                     |
+| getLocationPrecision()                 | None, removed                     |
+| setCustomParams(\_:)                   | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)                   |
+| addCustomParam(\_:withName:)           | None, removed                     |
+| addUserData(key:value:)                | [userExt](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(py)userExt), [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)      |
+| updateUserData(key:value:)             | None, removed                     |
+| removeUserData(for:)                   | None, removed                     |
+| clearUserData()                        | None, removed                     |
+| getUserData()                          | None, removed                     |
+| userDataDictionary                     | None, removed                     |
+| userKeywords                           | [getUserKeywords()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)getUserKeywords)                 |
+| addContextData(key:value:)             | [addAppExtData(key:value:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)addAppExtDataWithKey:value:)         |
+| updateContextData(key:value:)          | [updateAppExtData(key:value:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)updateAppExtDataWithKey:value:)      |
+| removeContextData(for:)                | [removeAppExtData(for:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)removeAppExtDataFor:)            |
+| clearContextData()                     | [clearAppExtData()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)clearAppExtData)                |
+| getContextData()                       | [getAppExtData()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)getAppExtData)                   |
+| contextDataDictionary                  | [getAppExtData()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)getAppExtData)                     |
+| addContextKeyword(\_:)                 | [addAppKeyword(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)addAppKeyword:)                |
+| addContextKeywords(\_:)                | [addAppKeywords(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)addAppKeywords:)               |
+| removeContextKeyword(\_:)              | [removeAppKeyword(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)removeAppKeyword:)             |
+| clearContextKeywords()                 | [clearAppKeywords()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)clearAppKeywords)                |
+| getContextKeywords()                   | [getAppKeywords()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)getAppKeywords)                  |
+| contextKeywords                        | [getAppKeywords()](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)getAppKeywords)                  |
+| yearOfBirth                            | None, deprecated by ORTB.         |
+| setYearOfBirth(yob:)                   | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)       |
+| getYearOfBirth()                       | None, deprecated by ORTB.         |
+| clearYearOfBirth()                     | None, deprecated by ORTB.         |
+| userGender                             | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)        |
+| userGenderDescription()                | None, deprecated by ORTB.         |
+| userID                                 | [setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)                |
+| eids                                   | [Targeting.shared.setExternalUserIds(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setExternalUserIds:) |
+| storeExternalUserId(\_:)               | None, removed                     |
+| fetchStoredExternalUserIds()           | None, removed                     |
+| fetchStoredExternalUserId(\_ source:)  | None, removed                     |
+| removeStoredExternalUserId(\_ source:) | None, removed                     |
+| removeStoredExternalUserIds()          | None, removed                     |
+
+### Prebid
+
+{: .table .table-bordered .table-striped }
+
+| Removed                                | Alternative                                      |
+| -------------------------------------- | ------------------------------------------------ |
+| bidderNameAppNexus                     | None, removed                                    |
+| bidderNameRubiconProject               | None, removed                                    |
+| externalUserIdArray                    | [Targeting.shared.setExternalUserIds(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setExternalUserIds:)               |
+| prebidServerHost                       | [initializeSDK(serverURL:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Prebid.html#/c:@M@PrebidMobile@objc(cs)Prebid(cm)initializeSDKWithServerURL:error::)                        |
+| useExternalClickthroughBrowser         | None, removed                                    |
+| impClickbrowserType                    | None, removed                                    |
+| setCustomPrebidServer(url:)            | [initializeSDK(serverURL:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Prebid.html#/c:@M@PrebidMobile@objc(cs)Prebid(cm)initializeSDKWithServerURL:error::)                        |
+| initializeSDK(_:_:)                    | [initializeSDK(serverURL:_:_)](https://docs.prebid.org/prebid-mobile-ios/Classes/Prebid.html#/c:@M@PrebidMobile@objc(cs)Prebid(cm)initializeSDKWithServerURL::error::)                     |
+| initializeSDK(gadMobileAdsVersion:\_:) | [initializeSDK(serverURL:gadMobileAdsVersion:\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Prebid.html#/c:@M@PrebidMobile@objc(cs)Prebid(cm)initializeSDKWithServerURL:gadMobileAdsVersion:error::) |
+| initializeSDK(\_:)                     | [initializeSDK(serverURL:\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Prebid.html#/c:@M@PrebidMobile@objc(cs)Prebid(cm)initializeSDK::)                     |
+
+### AdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed                       | Alternative                     |
+| ----------------------------- | ------------------------------- |
+| addContextData(key:value:)    | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)              |
+| updateContextData(key:value:) | None, removed                   |
+| removeContextData(forKey:)    | None, removed                   |
+| clearContextData()            | None, removed                   |
+| addContextKeyword(\_:)        | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)              |
+| addContextKeywords(\_:)       | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)              |
+| removeContextKeyword(\_:)     | None, removed                   |
+| clearContextKeywords()        | None, removed                   |
+| addExtKeyword(\_:)            | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)              |
+| addExtKeywords(\_:)           | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)              |
+| removeExtKeyword(\_:)         | None, removed                   |
+| clearExtKeywords()            | None, removed                   |
+| addExtData(key:value:)        | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)             |
+| updateExtData(key:value:)     | None, removed                   |
+| removeExtData(forKey:)        | None, removed                   |
+| clearExtData()                | None, removed                   |
+| setAppContent(\_:)            | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)              |
+| getAppContent()               | None, removed                   |
+| clearAppContent()             | None, removed                   |
+| addAppContentData(\_:)        | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)              |
+| removeAppContentData(\_:)     | None, removed                   |
+| clearAppContentData()         | None, removed                   |
+| getUserData()                 | None, removed                   |
+| addUserData(\_:)              | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)              |
+| removeUserData(\_:)           | None, removed                   |
+| clearUserData()               | None, removed                   |
+| setOrtbConfig(\_:)            | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)setImpORTBConfig:)           |
+| getOrtbConfig()               | [getImpORTBConfig()](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)getImpORTBConfig)              |
+| fetchDemand(completion:, \_:) | [fetchDemand(completionBidInfo:)](https://docs.prebid.org/prebid-mobile-ios/Classes/AdUnit.html#/c:@M@PrebidMobile@objc(cs)AdUnit(im)fetchDemandWithCompletionBidInfo:) |
+
+### PrebidRequest
+
+{: .table .table-bordered .table-striped }
+
+| Removed                         | Alternative        |
+| ------------------------------- | ------------------ |
+| addExtData(key:value:)          | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| updateExtData(key:value:)       | None, removed      |
+| removeExtData(forKey:)          | None, removed      |
+| clearExtData()                  | None, removed      |
+| addExtKeyword(\_:)              | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| addExtKeywords(\_:)             | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| removeExtKeyword(\_:)           | None, removed      |
+| clearExtKeywords()              | None, removed      |
+| setAppContent(\_:)              | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| clearAppContent()               | None, removed      |
+| addAppContentData(\_:)          | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| removeAppContentDataObject(\_:) | None, removed      |
+| clearAppContentDataObjects()    | None, removed      |
+| addUserData(\_:)                | [setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/PrebidRequest.html#/c:@M@PrebidMobile@objc(cs)PrebidRequest(im)setImpORTBConfig:) |
+| removeUserData(\_:)             | None, removed      |
+| clearUserData()                 | None, removed      |
+
+### ExternalUserId
+
+{: .table .table-bordered .table-striped }
+
+| Removed                            | Alternative            |
+| ---------------------------------- | ---------------------- |
+| identifier                         | [uids[].id](https://docs.prebid.org/prebid-mobile-ios/Classes/ExternalUserId.html#/c:@M@PrebidMobile@objc(cs)ExternalUserId(py)uids)              |
+| atype                              | [uids[].atype](https://docs.prebid.org/prebid-mobile-ios/Classes/ExternalUserId.html#/c:@M@PrebidMobile@objc(cs)ExternalUserId(py)uids)           |
+| init(source:identifier:atype:ext:) | [init(source:uids:ext:)](https://docs.prebid.org/prebid-mobile-ios/Classes/ExternalUserId.html#/c:@M@PrebidMobile@objc(cs)ExternalUserId(im)initWithSource:uids:ext:) |
+
+### BannerAdUnit, InterstitialAdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed    | Alternative      |
+| ---------- | ---------------- |
+| parameters | [BannerAdUnit.bannerParamters](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)BannerAdUnit(py)bannerParameters), [InterstitialAdUnit.bannerParamters](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialAdUnit(py)bannerParameters) |
+
+### RewardedVideoAdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed    | Alternative     |
+| ---------- | --------------- |
+| parameters | [videoParameters](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedVideoAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedVideoAdUnit(py)videoParameters) |
+
+### BannerView, InterstitialRenderingAdUnit, RewardedAdUnit, MediationBannerAdUnit, MediationBaseInterstitialAdUnit, MediationNativeAdUnit
+
+{: .table .table-bordered .table-striped }
+
+| Removed                         | Alternative               |
+| ------------------------------- | ------------------------- |
+| ortbConfig                      | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)     |
+| addExtKeyword(\_:)              | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)         |
+| addExtKeywords(\_:)             | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)         |
+| removeExtKeyword(\_:)           | None, removed             |
+| clearExtKeywords()              | None, removed             |
+| addContextData(\_:forKey:)      | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)    |
+| updateContextData(\_:forKey:)   | None, removed |
+| removeContextDate(forKey:)      | None, removed    |
+| clearContextData()              | None, removed            |
+| addContextKeyword(\_:)          | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)        |
+| addContextKeywords(\_:)         | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:)       |
+| removeContextKeyword(\_:)       | None, removed     |
+| clearContextKeywords()          | None, removed        |
+| addExtData(key:value:)          | [BannerView.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(im)setImpORTBConfig:), [InterstitialRenderingAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialRenderingAdUnit.html#/c:@M@PrebidMobile@objc(cs)InterstitialRenderingAdUnit(im)setImpORTBConfig:), [RewardedAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/RewardedAdUnit.html#/c:@M@PrebidMobile@objc(cs)RewardedAdUnit(im)setImpORTBConfig:), [MediationBannerAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBannerAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBannerAdUnit(im)setImpORTBConfig:), [MediationBaseInterstitialAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationBaseInterstitialAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationBaseInterstitialAdUnit(im)setImpORTBConfig:), [MediationNativeAdUnit.setImpORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/MediationNativeAdUnit.html#/c:@M@PrebidMobile@objc(cs)MediationNativeAdUnit(im)setImpORTBConfig:),        |
+| updateExtData(key:value:)       | None, removed             |
+| removeExtData(forKey:)          | None, removed             |
+| clearExtData()                  | None, removed             |
+| setAppContent(\_:)              | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)       |
+| clearAppContent()               | None, removed             |
+| addAppContentData(\_:)          | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)        |
+| removeAppContentDataObject(\_:) | None, removed             |
+| clearAppContentDataObjects()    | None, removed             |
+| addUserData(\_:)                | [Targeting.shared.setGlobalORTBConfig(\_:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Targeting.html#/c:@M@PrebidMobile@objc(cs)Targeting(im)setGlobalORTBConfig:)        |
+| removeUserData(\_:)             | None, removed             |
+| clearUserData()                 | None, removed             |
+
+### AdFormat
+
+{: .table .table-bordered .table-striped }
+
+| Removed | Alternative |
+| ------- | ----------- |
+| display | [banner](https://docs.prebid.org/prebid-mobile-ios/Classes/AdFormat.html#/c:@M@PrebidMobile@objc(cs)AdFormat(cpy)banner)      |
+
+### Utils
+
+{: .table .table-bordered .table-striped }
+
+| Removed                           | Alternative    |
+| --------------------------------- | -------------- |
+| convertDictToMoPubKeywords(dict:) | None, removed |
+
+### Host
+
+{: .table .table-bordered .table-striped }
+
+| Removed               | Alternative                          |
+| --------------------- | ------------------------------------ |
+| setCustomHostURL(\_:) | [setHostURL(\_:nonTrackingURLString:)](https://docs.prebid.org/prebid-mobile-ios/Classes/Host.html#/c:@M@PrebidMobile@objc(cs)Host(im)setHostURL:nonTrackingURLString:error:) |
+| getHostURL(host:)     | [getHostURL()](https://docs.prebid.org/prebid-mobile-ios/Classes/Host.html#/c:@M@PrebidMobile@objc(cs)Host(im)getHostURLAndReturnError:)                         |
+
+### Other SDK Changes
+
+- `imp[].ext.data.adslot` is no longer sent in the request;
+- Removed `VideoAdUnit`, alternative - [BannerAdUnit](https://docs.prebid.org/prebid-mobile-ios/Classes/BannerAdUnit.html) with video ad format;
+- Removed `VideoInterstitialAdUnit`, alternative - [InterstitialAdUnit](https://docs.prebid.org/prebid-mobile-ios/Classes/InterstitialAdUnit.html) with video ad format;
+- Removed `PrebidHost` without replacement;
+- Removed `PrebidAdMobRewardedVideoAdapter`, alternative - `PrebidAdMobRewardedAdapter`.
diff --git a/prebid-mobile/updates-3.0/sdk-key-features.md b/prebid-mobile/updates-3.0/sdk-key-features.md
new file mode 100644
index 0000000000..032f33f2c6
--- /dev/null
+++ b/prebid-mobile/updates-3.0/sdk-key-features.md
@@ -0,0 +1,101 @@
+---
+layout: page_v2
+title: Prebid Mobile 3.0 Key Features
+description: Prebid Mobile 3.0 Key Features
+pid: 1
+top_nav_section: prebid-mobile
+nav_section: prebid-mobile-ios
+sidebarType: 2
+---
+
+# Prebid Mobile 3.0 
+{:.no_toc}
+
+Prebid Mobile 3.0 accumulates the results of about 500 closed PRs for both platforms, aiming to extend supported inventory and enhance bidding transparency for In-App publishers and advertisers.
+
+The current doc summarizes the key product features for the 3.0 milestone.
+
+- TOC
+{:toc}
+
+## Rendering Delegation
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/pbm-plugin-renderer.html), [Android](/prebid-mobile/pbm-api/android/pbm-plugin-renderer.html).
+
+Prebid Mobile introduces a standardized protocol for SDK developers to implement custom ad rendering solutions within In-App Prebid integration. This flexibility allows demand partners to move beyond default options like Prebid Universal Creative, Google Ad Manager (GAM), or other built-in rendering solutions, giving them full control over the ad rendering process with their preferred technology.
+
+For publishers, rendering delegation enhances ad quality and ensures a premium ad experience from trusted partners.
+
+## Rewarded Ad Unit
+
+Documentation: [iOS](/prebid-mobile/modules/rendering/ios-sdk-integration-pb.html#rewarded), [Android](/prebid-mobile/modules/rendering/android-sdk-integration-pb.html#rewarded).
+
+Prebid Mobile introduces an enhanced and more publisher-oriented `RewardedAdUnit`, allowing for greater customization, flexibility, and control over the rewarded ad experience, tailored to the specific needs of the publisher. The `RewardedAdUnit` implements special In-App behavior that should be configurable by the platform or publisher according to the application or ad experience guides.
+
+## Shared ID
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/pbm-targeting-ios.html#shared-id), [Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html#shared-id).
+
+Prebid Mobile introduces a way for publishers to add a convenient [Prebid-owned first-party identifier](https://docs.prebid.org/identity/sharedid.html) to the bid requests. SharedID is a randomly generated first-party identifier that remains the same throughout the app sessions until reset. However, Shared ID values do not remain consistent across different apps on the same device.
+
+## Arbitrary OpenRTB
+
+Documentation:
+
+- [iOS Global Arbitrary OpenRTB](/prebid-mobile/pbm-api/ios/pbm-targeting-ios.html#arbitrary-openrtb)  
+- [iOS Impression-level Arbitrary OpenRTB](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.md#arbitrary-openrtb)  
+- [Android Global Arbitrary OpenRTB](/prebid-mobile/pbm-api/android/pbm-targeting-android.html#arbitrary-openrtb)  
+- [Android Impression-level Arbitrary OpenRTB](/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.html#arbitrary-openrtb)
+
+Prebid Mobile introduces an API that enables publishers to customize the bid request according to their specific requirements. This customization can be done at two levels: global and impression level.
+
+## Multiformat Ad Unit in Bidding-only Scenario
+
+Documentation: [iOS](/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.html), [Android](/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-multiformat.html)
+
+Prebid Mobile introduces a way to make multiformat bid requests for a single ad unit, specifically within a bidding-only setup. By leveraging this functionality, publishers can request bids that support any combination of ad formats, including banner, video, and native ads, within a single unified request. The SDK's API was extended with the `PrebidAdUnit` and `PrebidRequest` classes responsible for managing multiformat bid requests.
+
+## Impression Tracking Enhancements
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#native-impression-tracking), [Android](/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.html#native-impression-tracking)
+
+Prebid Mobile introduces a native impression-tracking method that analyzes the application's view hierarchy at runtime and tracks billing URL(s) only when the ad view is present on the screen. Using this approach, publishers can report more accurate figures for the impression count.
+
+## Documentation Updates
+
+SDK API: [iOS](https://docs.prebid.org/prebid-mobile-ios/index.html), [Android](https://docs.prebid.org/prebid-mobile-android/index.html)
+
+Prebid completely reworked the documentation for Mobile in two ways:
+
+- Focusing on recipes that help publishers integrate header bidding demand in their app. What is available, and how does it work under the hood? This allows publishers to make informed decisions about which integration to use, considering all the pros and cons.
+- Introducing auto-generated SDK API documentation, so publishers can always see the current and full description of the SDKs' classes, methods, and properties.
+
+## Support for Apple's ATT Framework
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/code-integration-ios.html#handling-tracking-domains)
+
+Prebid Mobile introduces support for tracking domains in the initialization method of the SDK. Now, publishers can follow Apple's ATT requirements and specify both tracking and non-tracking URLs for the Prebid Server.
+
+## Support for SKAdNetwork
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#skadnetwork)
+
+Prebid Mobile introduces support for SKAdNetwork across all integration APIs, including Bidding-only and Rendering APIs. SKAdNetwork is a privacy-focused solution that allows ad networks to track app installs while protecting user data. These methods include view-through and StoreKit-rendered ads.
+
+## SKOverlay
+
+Documentation: [iOS](/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.html#skoverlay)
+
+Prebid Mobile introduces support for SKOverlay for interstitials. SKOverlay enables developers to present additional content or calls to action as an overlay on top of interstitial ads without interrupting the overall flow of the ad experience.
+
+## Video UX
+
+Documentation: [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html#ad-experience-controls)
+
+Prebid Mobile introduces enhanced support and configuration of video ads, including interstitial, outstream, and rewarded ads. The configuration values can either be initialized based on the bid response or explicitly defined by the publisher, providing flexibility in managing the user experience.
+
+## API Cleanup
+
+Documentation: [iOS](/prebid-mobile/updates-3.0/ios/updates-3.0.html), [Android](/prebid-mobile/updates-3.0/android/updates-3.0.html)
+
+In the 3.0 release, the Prebid Mobile SDK gets rid of all previously deprecated methods in order to keep the API clean and minimalistic. Instead of using Ad Unit and configuration properties, the Prebid SDK encourages publishers to use methods to set [Arbitrary OpenRTB](#arbitrary-openrtb) parameters.

From d6216fc6d92aee8448e3705567fc7d5644471bcb Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Fri, 11 Apr 2025 16:14:40 +0300
Subject: [PATCH 100/665] Mobile: Support SKAdNetwork and SKOverlay in
 Bidding-only scenario (#5960)

* docs: add SKAdN section to bidding-only config

* docs: minor correction

* wordsmithing

---------

Co-authored-by: bretg <bgorsline@gmail.com>
---
 _includes/mobile/adunit-config-ios.md | 60 ++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/_includes/mobile/adunit-config-ios.md b/_includes/mobile/adunit-config-ios.md
index 3ba61a69b2..f3e4871d7b 100644
--- a/_includes/mobile/adunit-config-ios.md
+++ b/_includes/mobile/adunit-config-ios.md
@@ -90,4 +90,62 @@ let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
 adUnit.activatePrebidAdViewImpressionTracker(adView: gamBanner)
 ```
 
-**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
\ No newline at end of file
+**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
+
+### SKAdNetwork 
+
+The SDK supports two SKAdNetwork methods for ad networks to deliver ads in a bidding-only scenario, specifically for **banner** and **native** ad formats:
+
+- View-through ads
+- StoreKit-rendered ads
+
+Both methods are automatically enabled for the **native** ad format, with no additional configuration required. The support of view-through ads is also automatically enabled for the **banner** ad format. However, in order to activate StoreKit-rendered ads flow, you must call a method appropriate to the case: 
+
+`BannerAdUnit`:
+
+```swift
+let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
+adUnit.activatePrebidSKAdNetworkStoreKitAdsFlow(adView: gamBanner)
+```
+
+`InterstitialAdUnit`:
+
+```swift
+adUnit.activatePrebidSKAdNetworkStoreKitAdsFlow()
+```
+
+`PrebidAdUnit`:
+
+```swift
+let adUnit = PrebidAdUnit(configId: CONFIG_ID)
+
+// Use this method for intersitials
+adUnit.activatePrebidInterstitialSKAdNetworkStoreKitAdsFlow()
+
+// Use this method for banners
+let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
+adUnit.activatePrebidBannerSKAdNetworkStoreKitAdsFlow(adView: gamBanner)
+```
+
+#### SKOverlay
+
+The SDK also provides support of SKOverlay for interstitials. In order to activate it, set `supportSKOverlay` to `true`:
+
+```swift
+adUnit.supportSKOverlay = true
+```
+
+You should also call the method below when you are about to show the ad: 
+
+```swift
+// Present SKOverlay if available
+adUnit.activateSKOverlayIfAvailable()
+// Present the interstitial
+gamInterstitial.present(from: controller)
+```
+
+In order to dismiss SKOverlay, use the method below:
+
+```swift
+adUnit.dismissSKOverlayIfAvailable()
+```

From d45b84e8c45748c8aa1b0dd1ee35579de3508cb0 Mon Sep 17 00:00:00 2001
From: Maksym Danylov <146753616+mdanylov-sigma@users.noreply.github.com>
Date: Fri, 11 Apr 2025 16:18:00 +0300
Subject: [PATCH 101/665] Additional mobile SDK video parameters, add
 auctionSettingsId (#5979)

* docs: new video params

* docs: add info about global property 'auctionSettingsId'.

* docs: wordsmithing

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: improvements

Co-authored-by: bretg <bgorsline@gmail.com>

* docs: fix typo

---------

Co-authored-by: bretg <bgorsline@gmail.com>
---
 _includes/mobile/video-params.md              | 33 +++++++++++++++++--
 .../android/code-integration-android.md       | 10 ++++++
 .../pbm-api/android/pbm-targeting-android.md  | 23 +++++++++++++
 .../pbm-api/ios/code-integration-ios.md       |  5 +++
 .../pbm-api/ios/pbm-targeting-ios.md          |  1 +
 5 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/_includes/mobile/video-params.md b/_includes/mobile/video-params.md
index d5f20a67aa..80bd0e7cbb 100644
--- a/_includes/mobile/video-params.md
+++ b/_includes/mobile/video-params.md
@@ -20,7 +20,8 @@ Notes:
 {: .alert.alert-warning :}
 Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
 
-#### plcmnt
+#### plcmt
+
 {:.no_toc}
 
 The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--plcmt-subtypes---video-) Placement Type for the auction can be expressed as an integer or you can use an enum for easier readability.
@@ -31,7 +32,7 @@ The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/
 - `4` or `NoContent` or `Standalone` : Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.
 
 Notes:
-- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmnt=3 if no placement value is supplied.
+- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmt=3 if no placement value is supplied.
 
 {: .alert.alert-warning :}
 Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
@@ -99,3 +100,31 @@ Array of OpenRTB 2.6 playback methods. If none are specified, any method may be
 - `6` or `Signals.Protocols.VAST_3_0_Wrapper` : VAST 3.0 Wrapper
 - `7` or `Signals.Protocols.VAST_4_0` : VAST 4.0
 - `8` or `Signals.Protocols.VAST_4_0_Wrapper` : VAST 4.0 Wrapper
+
+#### battr
+{:.no_toc}
+
+  Array or enum of OpenRTB 2.6 blocked creative attributes. Values can be one of:
+
+- `1` or `Signals.CreativeAttribute.AudioAd_Autoplay` : Audio Ad (Autoplay)
+- `2` or `Signals.CreativeAttribute.AudioAd_UserInitiated` : Audio Ad (User Initiated)
+- `3` or `Signals.CreativeAttribute.Expandable_Automatic` : Expandable (Automatic)
+- `4` or `Signals.CreativeAttribute.Expandable_Click` : Expandable (User Initiated - Click)
+- `5` or `Signals.CreativeAttribute.Expandable_Rollover` : Expandable (User Initiated - Rollover)
+- `6` or `Signals.CreativeAttribute.InBanner_Autoplay` : In-Banner Video Ad (Autoplay)
+- `7` or `Signals.CreativeAttribute.InBanner_UserInitiated` : In-Banner Video Ad (User Initiated)
+- `8` or `Signals.CreativeAttribute.Pop` : Pop (e.g., Over, Under, or Upon Exit)
+- `9` or `Signals.CreativeAttribute.Provocative` or `Signals.CreativeAttribute.SuggestiveImagery` : Provocative or Suggestive Imagery
+- `10` or `Signals.CreativeAttribute.Shaky`, `Signals.CreativeAttribute.Flashing`, `Signals.CreativeAttribute.Flickering`, `Signals.CreativeAttribute.ExtremeAnimation` or `Signals.CreativeAttribute.Smileys` : Shaky, Flashing, Flickering, Extreme Animation, Smileys
+- `11` or `Signals.CreativeAttribute.Surveys` : Surveys
+- `12` or `Signals.CreativeAttribute.TextOnly` : Text Only
+- `13` or `Signals.CreativeAttribute.UserInteractive` : User Interactive (e.g., Embedded Games)
+- `14` or `Signals.CreativeAttribute.WindowsDialog` or `Signals.CreativeAttribute.AlertStyle` : Windows Dialog or Alert Style
+- `15` or `Signals.CreativeAttribute.AudioButton` : Has Audio On/Off Button
+- `16` or `Signals.CreativeAttribute.SkipButton` : Ad Provides Skip Button (e.g. VPAID-rendered skip button on pre-roll video)
+- `17` or `Signals.CreativeAttribute.AdobeFlash` : Adobe Flash
+
+#### isSkippable
+{:.no_toc}
+
+Boolean representing the OpenRTB 2.6 video ad skippability.
\ No newline at end of file
diff --git a/prebid-mobile/pbm-api/android/code-integration-android.md b/prebid-mobile/pbm-api/android/code-integration-android.md
index d186b90dab..911fc9e71b 100644
--- a/prebid-mobile/pbm-api/android/code-integration-android.md
+++ b/prebid-mobile/pbm-api/android/code-integration-android.md
@@ -323,6 +323,16 @@ To stop sending stored bid response signals use the following method:
 void clearStoredBidResponses()
 ```
 
+### AuctionSettingsId
+{:.no_toc}
+
+Allows you to separate account from "auction settings". This is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. This allows each app to have different global parameters like timeout, price granularity, etc. Please work with your Prebid Server provider to determine what to enter here. 
+
+```kotlin
+PrebidMobile.setAuctionSettingsId(YOUR_AUCTION_SETTINGS_ID)
+var auctionSettingsId = PrebidMobile.getAuctionSettingsId()
+```
+
 ### Debug
 {:.no_toc}
 
diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 0a07eb9c02..9ecf41c3d4 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -188,6 +188,29 @@ void clearStoredBidResponses()
 
 Parameters: none.
 
+#### setAuctionSettingsId()
+
+For the SDK to separate out account from "auction settings".
+
+Signature:
+
+```kotlin
+func setAuctionSettingsId(settingsId: String)
+```
+
+Parameters: 
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| settingsId | optional | string | Use the settingsId to separate account from "auction settings", allowing each app to have different global parameters defined on the server side. If specified, the settingsId is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. | "abc321" |
+
+Examples:
+
+```kotlin
+PrebidMobile.setAuctionSettingsId("abc321")
+```
+
 #### setLogLevel
 
 Controls the level of logging output to the console.
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index f73597f3e4..77bfb60169 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -257,6 +257,8 @@ The `Prebid` class is a singleton that enables the user to apply global settings
 
 `prebidServerHost`: String containing configuration your Prebid Server host with which Prebid SDK will communicate. Choose from the system-defined Prebid Server hosts or define your own custom Prebid Server host.
 
+`auctionSettingsId`: Allows you to separate account from "auction settings". This is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is taken by default. This allows each app to have different global parameters like timeout, price granularity, etc. Please work with your Prebid Server provider to determine what to enter here. 
+
 `shareGeoLocation`: Optional Bool, if this flag is True AND the app collects the user’s geographical location data, Prebid Mobile will send the user’s geographical location data to Prebid Server. If this flag is False OR the app does not collect the user’s geographical location data, Prebid Mobile will not populate any user geographical location information in the call to Prebid Server. The default setting is false.
 
 `logLevel`: Optional level of logging to output in the console. Options are one of the following sorted by a verbosity of the log:
@@ -378,6 +380,9 @@ do {
 // Account Id
 Prebid.shared.prebidServerAccountId = "1234"
 
+// Auction Settings Id (Optional)
+Prebid.shared.auctionSettingsId = "7890"
+
 // Geolocation
 Prebid.shared.shareGeoLocation = true
 
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index 147ec5fabb..09133e285b 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -48,6 +48,7 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 | prebidServerAccountId | either | string | init | Your Prebid Server team will tell you whether this is required or not and if so, the value. | "abc123" |
 | prebidServerHost | optional | enum | init | Starting from PrebidMobile `3.0.0` the property is removed<wbr>This can take the values "Appnexus", "Rubicon", or "Custom". If "Custom", you need to use the setCustomPrebidServerUrl() method to set a URL. This is where the Prebid SDK will send the auction information. Your Prebid Server team will tell you which value to use. The default is "Custom". | "Custom" |
 | customStatusEndpoint | optional | string | init | Use this URL to check the status of Prebid Server. The default status endpoint is the PBS URL appended with '/status'. | `https://prebidserver`<wbr>`.example`<wbr>`.com/custom`<wbr>`/status` |
+| auctionSettingsId | optional | string | init | For the SDK to separate account from "auction settings", allowing each app to have different global parameters defined on the server side. If specified, the auctionSettingsId is used to set `ext.prebid.storedrequest.id`, otherwise prebidServerAccountId is populated by default. | "abc321" |
 | shareGeoLocation | optional | boolean | ORTB | If this flag is true AND the app collects the user’s geographical location data, Prebid Mobile will send the user’s lat/long geographical location data to the Prebid Server. The default is false. | `true` |
 | locationUpdatesEnabled | optional | boolean | ORTB | If true, the SDK will periodically try to listen for location updates. Default is `false`. | `true` |
 | logLevel | optional | enum | SDK control | This property controls the level of logging output to the console. The value can be .error, .info, .debug, .verbose, .warn, .severe, and .info. The default is `.debug`. | `.error` |

From e7dc2eeee4009c6cd91cc01619bf5e114bf835b0 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Fri, 11 Apr 2025 21:30:28 +0300
Subject: [PATCH 102/665] Mobile: Track `burl` and `nurl` in Rendering API
 (#5889)

* docs: update burl and nurl supporting info

* docs: upate GAM Prebid-Rendered Integration Details

* docs: change typo

* docs: update diagram
---
 _includes/mobile/intro-admob.md               |   8 ++++----
 _includes/mobile/intro-applovin.md            |   8 ++++----
 _includes/mobile/intro-prebid-rendered.md     |  14 +++++++-------
 .../mobile-details-gam-prebid-rendered.png    | Bin 65145 -> 61376 bytes
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/_includes/mobile/intro-admob.md b/_includes/mobile/intro-admob.md
index f6784019df..3d635cc530 100644
--- a/_includes/mobile/intro-admob.md
+++ b/_includes/mobile/intro-admob.md
@@ -50,11 +50,11 @@ This information may be useful when comparing data across various reporting syst
 | Scenario | Tracked? |
 | --- | --- |
 | Fires Prebid win event | yes |
-| Fires Prebid imp event | no |
-| Fires OpenRTB burl | no (1) |
-| Fires OpenRTB nurl | no (1) |
+| Fires Prebid imp event | yes |
+| Fires OpenRTB burl | yes (1) |
+| Fires OpenRTB nurl | yes (1) |
 | Fires OpenMeasurement events | yes |
 
 Notes:
 
-1. OpenRTB burl and nurl will be utilized in a future release.
+1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.
diff --git a/_includes/mobile/intro-applovin.md b/_includes/mobile/intro-applovin.md
index d539a615dc..281248f1bb 100644
--- a/_includes/mobile/intro-applovin.md
+++ b/_includes/mobile/intro-applovin.md
@@ -50,11 +50,11 @@ This information may be useful when comparing data across various reporting syst
 | Scenario | Tracked? |
 | --- | --- |
 | Fires Prebid win event | yes |
-| Fires Prebid imp event | no |
-| Fires OpenRTB burl | no (1) |
-| Fires OpenRTB nurl | no (1) |
+| Fires Prebid imp event | yes |
+| Fires OpenRTB burl | yes (1) |
+| Fires OpenRTB nurl | yes (1) |
 | Fires OpenMeasurement events | yes |
 
 Notes:
 
-1. OpenRTB burl and nurl will be utilized in a future release.
+1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.
diff --git a/_includes/mobile/intro-prebid-rendered.md b/_includes/mobile/intro-prebid-rendered.md
index 2dfc4d0298..5e682d76c6 100644
--- a/_includes/mobile/intro-prebid-rendered.md
+++ b/_includes/mobile/intro-prebid-rendered.md
@@ -61,11 +61,11 @@ Here's how the ad bidding-auction-rendering process works in this integration sc
         1. Otherwise, it writes the creative into an iframe into an internal WebView, replaceing the GAMSDK's WebView.
             1. Injects mraid.js into the webview to listen for events from MRAID: change size, etc.
             1. Sends data to the creative (e.g. 'viewable') which may trigger impression tracking within the creative.
-            1. It does not currently hit the billing or notice urls (burl or nurl).
+            1. Starting from v3.0.0, the SDK hits the billing and notice urls (burl and nurl).
 1. If a video VastUrl creative is chosen (rewarded video only):
     1. The GMA SDK uses the platform video player which loads the special VAST file from the Prebid CDN.
     1. Prebid SDK watches VAST events for "<AdTitle>PrebidAppEvent</AdTitle>". When it sees this, it takes over the rendering:
-        1. PBSDK fires the PBS win event.
+        1. PBSDK fires the PBS win event. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
         1. If the response indicates a 3rd party rendering SDK, PBSDK will call it.
         1. Otherwise:
             1. PDBSK renders with the platform-standard VAST player.
@@ -77,7 +77,7 @@ Here's how the ad bidding-auction-rendering process works in this integration sc
     1. The GMA SDK delegates the rendering of native to the App and PBSDK when a special signal is specified.
     1. The app code gets the native assets from PBSDK. The app is coded to render the ad.
         1. PBSDK fires the eventtrackers when appropriate.
-        1. The PBS win event is fired.
+        1. The PBS win event is fired. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
 1. Open Measurement events are handled directly by the Prebid SDK.
     1. If a 3rd party rendering SDK is used to render, then it will handle Open Measurement.
 
@@ -118,11 +118,11 @@ This information may be useful when comparing data across various reporting syst
 | --- | --- | --- | --- |
 | Rendering Method | js in iframe fires an event | GMA SDK player | App code with data from PBSDK |
 | Fires Prebid win event | always | never | always |
-| Fires Prebid imp event | never | VAST impression tag | never |
-| Fires OpenRTB burl | never | n/a | never |
-| Fires OpenRTB nurl | never |  n/a | never |
+| Fires Prebid imp event | always | VAST impression tag | never |
+| Fires OpenRTB burl | always (1) | n/a | never |
+| Fires OpenRTB nurl | always (1) |  n/a | never |
 | Fires OpenMeasurement events | PBSDK |  n/a | PBSDK |
 
 Notes:
 
-- OpenRTB burl and nurl will be utilized in a future release.
+1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.
diff --git a/assets/images/prebid-mobile/mobile-details-gam-prebid-rendered.png b/assets/images/prebid-mobile/mobile-details-gam-prebid-rendered.png
index d1809449dd8f8208c7a12975e509cf09a793fe43..e3a90f00b5649a441a77c0e0956a73adb142bc15 100644
GIT binary patch
literal 61376
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

literal 65145
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


From a7c1acbb5cfbf97cbe3ee4ae9f2a19195c7f9bea Mon Sep 17 00:00:00 2001
From: Denis <7009699+someden@users.noreply.github.com>
Date: Fri, 11 Apr 2025 23:35:49 +0300
Subject: [PATCH 103/665] Fix renderer.md (#5986)

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

diff --git a/dev-docs/renderer.md b/dev-docs/renderer.md
index 879e624eea..30cd9155bf 100644
--- a/dev-docs/renderer.md
+++ b/dev-docs/renderer.md
@@ -30,7 +30,7 @@ In simple terms, a renderer offers publishers:
 
 Renderers can be specified at multiple levels:
 
-1. MediaType Level (adUnit.mediaTypes.video|banner|native.renderer): If a renderer is associated with a specific mediaType (video, banner, or native), it will be used to display any demand associated with that mediaType. This is the preferred method for all ad types.
+1. MediaType Level (adUnit.mediaTypes.video\|banner\|native.renderer): If a renderer is associated with a specific mediaType (video, banner, or native), it will be used to display any demand associated with that mediaType. This is the preferred method for all ad types.
 2. AdUnit Level (adUnit.renderer): Applied to all bids for this ad unit that don't override it. This is a legacy approach; using the mediaType-level renderer is preferred.
 3. Bidder Level (adUnit.bids[].renderer): Applied only to this bidder, overriding adUnit renderer if both exist.
 4. Default: If no renderer is specified at any level, Prebid will use the default renderer for the media type, if one exists. For banner and native ads, Prebid.js has built-in default rendering capabilities.

From 74854a66ea1a91f6e34de86a5df38ac399b87ae9 Mon Sep 17 00:00:00 2001
From: giathinhly <96400885+giathinhly@users.noreply.github.com>
Date: Mon, 14 Apr 2025 13:35:14 +0700
Subject: [PATCH 104/665] MediaEyes Bid Adapter: initial release (#5956)

---
 dev-docs/bidders/mediaeyes.md | 55 +++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 dev-docs/bidders/mediaeyes.md

diff --git a/dev-docs/bidders/mediaeyes.md b/dev-docs/bidders/mediaeyes.md
new file mode 100644
index 0000000000..db910e83a6
--- /dev/null
+++ b/dev-docs/bidders/mediaeyes.md
@@ -0,0 +1,55 @@
+---
+layout: bidder
+title: MediaEyes
+description: MediaEyes Bidder Adapter
+pbjs: true
+pbs: false
+gvl_id: none
+biddercode: mediaeyes
+media_types: banner
+gdpr_supported: false
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+safeframes_ok: false
+dchain_supported: false
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+prebid_member: false
+---
+
+### Description
+
+MediaEyes adapter prebid connect to MediaEyes Bidding System.
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+| Name         | Scope    | Description                        | Example                     | Type     |
+|--------------|----------|------------------------------------|-----------------------------|----------|
+| `itemId`     | required | The item ID from MediaEyes         | `'4d27f3cc8bbd5bd153045e'`  | `string` |
+| `bidFloor`   | optional | Lowest value of expected bid price | `0.1`                       | `float`  |
+
+### Test Parameters
+
+300x250 banner test
+
+```javascript
+var adUnits = [{
+  code: 'zone-ads',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]]
+    }
+  },
+  bids: [{
+    bidder: 'mediaeyes',
+    params : {
+      itemId : "4d27f3cc8bbd5bd153045e"
+    }
+  }]
+}];
+```

From cba7efdc3ab84524c1ce457aef0069bd4cf5b016 Mon Sep 17 00:00:00 2001
From: hasanideepak <80700939+hasanideepak@users.noreply.github.com>
Date: Mon, 14 Apr 2025 17:43:53 +0530
Subject: [PATCH 105/665] Dochase Bid Adapter : Initial Release (#5912)

* Audiencelogy Bid Adapter : Initial Release

* Removed space

* new adapter : lane4

* new adapter : lane4

* added usnat in gpp_sids

* Dochase Bidder Adapter : initial release
---
 dev-docs/bidders/dochase.md | 92 +++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 dev-docs/bidders/dochase.md

diff --git a/dev-docs/bidders/dochase.md b/dev-docs/bidders/dochase.md
new file mode 100644
index 0000000000..50137be3e7
--- /dev/null
+++ b/dev-docs/bidders/dochase.md
@@ -0,0 +1,92 @@
+---
+layout: bidder
+title: Dochase
+description: Prebid dochase Bidder Adaptor
+pbjs: true
+biddercode: dochase
+media_types: banner, native
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+gpp_sids: usstate_all, usnat
+schain_supported: false
+safeframes_ok: false
+ortb_blocking_supported: false
+dsa_supported: false
+deals_supported: true
+floors_supported: true
+sidebarType: 1
+---
+### Registration
+
+For assistance or setup instructions, please contact us at <dochaseops@dochase.com>.
+
+### Banner Params
+
+{: .table .table-bordered .table-striped }
+| Name           | Scope     | Description           | Example        | Type     |
+|----------------|-----------|-----------------------|----------------|----------|
+| `placement_id` | mandatory | Placement Id          | `5550`         | `number` |
+| `height`       | optional  | Height of the creative| `250`          | `number` |
+| `width`        | optional  | Width of the creative | `300`          | `number` |
+| `bid_floor`    | optional  | Bid Floor Price       | `0.5`          | `decimal`|
+
+### AdUnit Format for Banner
+
+```javascript
+var adUnits = [
+            {
+                code: 'banner-ad',
+                mediaTypes: {
+                    banner: {
+                        sizes: [[300, 250]]
+                    }
+                },
+                bids: [{
+                    bidder: 'dochase',
+                    params: {
+                        placement_id: 5550,
+                        height: 250,
+                        width: 300,
+                        bid_floor: 0.5
+                    }
+                }]
+            }
+        ];
+```
+
+### Native Params
+
+{: .table .table-bordered .table-striped }
+| Name           | Scope     | Description           | Example        | Type     |
+|----------------|-----------|-----------------------|----------------|----------|
+| `placement_id` | mandatory | Placement Id          | `5551`         | `number` |
+| `bid_floor`    | optional  | Bid Floor Price       | `1`            | `decimal`|
+
+### AdUnit Format for Native
+
+```javascript
+var adUnits = [
+            {
+                code: 'native-ad-container',
+                mediaTypes: {
+                    native: {
+                        title: { required: true, len: 100 },
+                        image: { required: true, sizes: [300, 250] },
+                        sponsored: { required: false },
+                        clickUrl: { required: true },
+                        desc: { required: true },
+                        icon: { required: false, sizes: [50, 50] },
+                        cta: { required: false }
+                    }
+                },
+                bids: [{
+                    bidder: 'dochase',
+                    params: {
+                        placement_id: 5551, // Required parameter
+                        bid_floor: 1 // Optional parameter
+                    }   
+                }]
+            }
+        ];
+```

From 9c28abe337d3c67e900a717931b7dd0bf079f7e0 Mon Sep 17 00:00:00 2001
From: yuva-inmobi-1 <sandeep.inmobi1@gmail.com>
Date: Tue, 15 Apr 2025 12:03:15 +0530
Subject: [PATCH 106/665] Update inmobi.md (#5992)

---
 dev-docs/bidders/inmobi.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/inmobi.md b/dev-docs/bidders/inmobi.md
index b8fd3e9323..76394c5cb3 100644
--- a/dev-docs/bidders/inmobi.md
+++ b/dev-docs/bidders/inmobi.md
@@ -35,6 +35,7 @@ To opt out of InMobi ads on web inventory the user needs to visit the Opt-out pa
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
 | `plc`         | required | Placement ID          | `'1234'`  | `string`  |
+| `bidfloor`    | optional | Bid Floor             | `1.09`    | `float`   |
 
 ### First Party Data
 

From a61703188b05df94cda68a307f083e7dc7021ac9 Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Mon, 14 Apr 2025 23:47:12 -0700
Subject: [PATCH 107/665] updated prev auct info docs to include the new
 highestBidCurrency field (#5990)

* updated prev auct info docs to include the new highestBidCurrency field

* changed bidderErrorCode to rejectionReason
---
 dev-docs/modules/previousAuctionInfo.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/dev-docs/modules/previousAuctionInfo.md b/dev-docs/modules/previousAuctionInfo.md
index 37214e89e5..948bc87923 100644
--- a/dev-docs/modules/previousAuctionInfo.md
+++ b/dev-docs/modules/previousAuctionInfo.md
@@ -62,11 +62,12 @@ ortb2: {
           source: "pbjs",
           adUnitCode: "div-gpt-ad-123-0",
           highestBidCpm: 0.052275935, // default is null
+          highestBidCurrency: "USD", // default is null
           bidderCpm: 0.04, // default is null
           bidderOriginalCpm: 0.04, // default is null
           bidderCurrency: "USD", // default is null
           bidderOriginalCurrency: "USD", // default is null
-          bidderErrorCode: -1, // default is null
+          rejectionReason: "Invalid request ID", // default is null
           timestamp: 1739400860310
         }
       ]
@@ -87,9 +88,10 @@ ortb2: {
 | ortb2.ext.prebid.previousauctioninfo[].source | string | Where the previous auction info was collected |  |
 | ortb2.ext.prebid.previousauctioninfo[].adUnitCode | string | Ad unit code of the ad slot that was bid on |  |
 | ortb2.ext.prebid.previousauctioninfo[].highestBidCpm | float | The highest Prebid bid cpm observed for the relative ad slot of a previous auction | null |
+| ortb2.ext.prebid.previousauctioninfo[].highestBidCurrency | string | The currency of the highest Prebid bid observed for an ad slot of a previous auction | null |
 | ortb2.ext.prebid.previousauctioninfo[].bidderCpm | float | The bid cpm submitted by the bidder receiving the previous auction info payload | null |
 | ortb2.ext.prebid.previousauctioninfo[].bidderOriginalCpm | float | The original bid cpm submitted by the bidder receiving the previous auction info payload | null |
 | ortb2.ext.prebid.previousauctioninfo[].bidderCurrency | string | The bidder currency submitted by the bidder receiving the previous auction info payload | null |
 | ortb2.ext.prebid.previousauctioninfo[].bidderOriginalCurrency | string | The original bidder currency submitted by the bidder receiving the previous auction info payload | null |
-| ortb2.ext.prebid.previousauctioninfo[].bidderErrorCode | integer | Whether an error was present or not | null |
+| ortb2.ext.prebid.previousauctioninfo[].rejectionReason | string | The error reason, if one was present | null |
 | ortb2.ext.prebid.previousauctioninfo[].timestamp | integer | Time that the previous auction info payload was collected |  |

From 1d679f93848c7c4b488f83c25232a5b08acd2a90 Mon Sep 17 00:00:00 2001
From: Alexander Pykhteyev <alex.pykhteyev@gmail.com>
Date: Wed, 16 Apr 2025 01:30:04 +0700
Subject: [PATCH 108/665] IIon adapter, update TCF flag (#5870)

* Doc for embi media

* Update Iion adapter doc

* Update Iion adapter doc

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
---
 dev-docs/bidders/iionads.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/iionads.md b/dev-docs/bidders/iionads.md
index 7f9b957c60..c2c84a0aa3 100644
--- a/dev-docs/bidders/iionads.md
+++ b/dev-docs/bidders/iionads.md
@@ -8,7 +8,8 @@ pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
-tcfeu_supported: false
+tcfeu_supported: true
+gvl_id: 1358
 usp_supported: true
 coppa_supported: true
 schain_supported: true

From 20f9e0b8b4c275dcbafd555672f34fe126415f4a Mon Sep 17 00:00:00 2001
From: SebRobert <sebastien.robert.run@gmail.com>
Date: Wed, 16 Apr 2025 17:08:05 +0200
Subject: [PATCH 109/665] Update BeOp doc to add User Syncs reference (#5972)

* Update BeOp doc to add User Syncs reference

* Add missing fields in header
---
 dev-docs/bidders/beop.md | 82 ++++++++++++++++++++++++++++++++--------
 1 file changed, 67 insertions(+), 15 deletions(-)

diff --git a/dev-docs/bidders/beop.md b/dev-docs/bidders/beop.md
index 4e82107d3d..00365c998e 100644
--- a/dev-docs/bidders/beop.md
+++ b/dev-docs/bidders/beop.md
@@ -12,39 +12,91 @@ usp_supported: false
 floors_supported: true
 schain_supported: true
 sidebarType: 1
+dsa_supported: false
+coppa_supported: false
+gpp_sids: tcfeu
+dchain_supported: false
+userIds: none
+safeframes_ok: false
+deals_supported: false
+fpd_supported: true
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
 ---
 
 ### Disclosure
 
-The BeOp bidder adaptor needs an account id that you can find as a publisher, a reseller or a media group directly in your BeOp platform access. We also need to approve your account to be available for BeOp demand, so don't hesitate to reach your account manager or <publishers@beop.io> for more information.
+The BeOp bidder adapter requires an `accountId` or `networkId`, which you can retrieve from your BeOp platform dashboard (as a publisher, reseller, or media group). To activate BeOp demand on your account, please contact your account manager or reach out to <publishers@beop.io>.
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name | Scope | Description | Example | Type |
 |---------------|----------|-------------|---------|----------|
-| `accountId` or `networkId` | required | Your BeOp account ID | `'5a8af500c9e77c00017e4cad'` | `string` |
-| `networkPartnerId` | optional | Your own partner ID if you are a network | `'MY-WEBSITE-123'` | `string` |
-| `currency` | optional | Your currency | `'EUR'` (default) or `'USD'` | `string` |
+| `accountId` or `networkId` | required | Your BeOp account ID (24-character hex string) | `'5a8af500c9e77c00017e4cad'` | `string` |
+| `networkPartnerId` | optional | Your internal network partner ID (used for advanced partner tracking) | `'MY-WEBSITE-123'` | `string` |
+| `currency` | optional | Preferred bidding currency (defaults to `'EUR'`) | `'EUR'` or `'USD'` | `string` |
+| `keywords` | optional | Contextual keywords string or array to help target your campaign | `'cars, racing'` or `['cars', 'racing']` | `string/array` |
 
-## Why BeOp Requires Storage Access in Prebid.js
+### User Syncs
 
-At BeOp, we prioritize transparency and respect for user privacy. Here’s why we request storage access:
+BeOp supports iframe and pixel-based user syncs using the `getUserSyncs` method.
 
-### 1. Usage of First-Party Cookies
+{: .table .table-bordered .table-striped }
+| Type | Supported | Description |
+|------|-----------|-------------|
+| iframe | yes | A sync iframe may be returned by the bidder response via `syncFrame`. |
+| pixel | yes | Additional sync pixels can be returned via `syncPixels` array in the bid response body. |
+
+> Syncs are GDPR-aware and only triggered when appropriate consent is provided.
+
+### GDPR Compliance
+
+- Vendor ID: `666`
+- BeOp supports TCFv2 and relies on the `gdprApplies` and `consentString` fields in the bid request.
+- If no valid consent is found, external user syncs will be disabled.
 
-We use the first-party cookie beopid exclusively. This allows us to manage session and user preferences without relying on third-party cookies, ensuring compliance with privacy standards like GDPR.
+### Cookie Usage
 
-### 2. Capping Features for Publishers
+BeOp sets a first-party cookie `beopid` for frequency capping and user session purposes. This ID is anonymized and used to improve campaign performance, capping logic, and personalization within publisher domains.
 
-Storage access helps us enforce capping mechanisms directly on the publisher’s domain, ensuring a better user experience by limiting the frequency of ad displays.
+### First-Party Data Support
 
-### 3. Enhanced User Interaction
+BeOp fully supports First-Party Data (FPD) and leverages it to enhance both targeting and audience intelligence for publishers.
 
-We provide engaging voting experiences on BeOp formats. By using storage, we enable features such as resuming a voting session where the user last left off, making the interaction seamless and user-friendly.
+- Audience Enrichment: BeOp campaigns often include interactive formats (polls, quizzes, votes) that collect high-quality declarative data. This data can be matched against publisher segments to enrich their DMPs (Data Management Platforms).
+- Publisher-Centric Segments: Collected FPD (such as quiz responses, poll preferences, etc.) can be made available to the publisher under consent, allowing creation of custom audience segments usable across future campaigns.
+- Ortb2 Integration: BeOp reads ortb2.user.ext.data, ortb2.user.ext.bpsegs, and similar fields in the bid request to enhance match rates and ensure contextually relevant responses.
+- Respect for Privacy: All data is handled in accordance with GDPR, with processing based on user consent and transparent storage mechanisms.
 
-### 4. Revenue Optimization in Compliance with GDPR
+Thanks to BeOp’s unique interactive formats, publishers benefit not only from monetization, but also from deeper understanding and activation of their audiences through real-time feedback.
 
-Storage access helps us improve bidding performance by aligning with GDPR consents. This ensures that external bidders can leverage compliant data to drive better revenue outcomes for publishers.
+### Test Parameters
 
-By granting storage access, publishers empower us to provide these features while respecting user privacy and enhancing the overall experience.
+```js
+var adUnits = [
+  {
+    code: "div-id",
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250],
+          [1, 1],
+        ],
+      },
+    },
+    bids: [
+      {
+        bidder: "beop",
+        params: {
+          accountId: "5a8af500c9e77c00017e4cad",
+          currency: "EUR",
+          keywords: ["sports", "elections"],
+        },
+      },
+    ],
+  },
+];
+```

From 2c3707cef85ca0cc5f3068a699265dd387b114f1 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Thu, 17 Apr 2025 09:57:47 -0400
Subject: [PATCH 110/665] adding static floor enforcement scenario (#5977)

---
 dev-docs/modules/floors.md | 35 +++++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index 839bfdcd88..c9733c289d 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -58,9 +58,9 @@ Notes:
 * [Prebid Floor Service Providers](/dev-docs/modules/floors.html#floors-providers)
 * [Transcript of this video](/dev-docs/floors-video-overview.html)
 
-### Simple Static Floors
+### Simple Static Floor Signaling
 
-Some publishers just want to set a simple static floor. Please don't use this module for that. This module should only be used when you need to vary the floor by mediatype, size, etc. Here's how you can set static floors on each Prebid adunit:
+Some publishers just want to set a simple static floor and don't need enforcement. Please don't use this module for that. This module should only be used when you need to vary the floor by mediatype, size, etc. Here's how you can signal static floors on each Prebid adunit:
 
 ```javascript
 pbjs.addAdUnits({
@@ -78,6 +78,37 @@ pbjs.addAdUnits({
 });
 ```
 
+### Simple Static Floor Enforcement
+
+If you need a static floor signal and also want to enforce that static floor, here's the quick start:
+
+```javascript
+ var adUnits = [
+         {
+             code: 'test-div',
+             mediaTypes: {
+                 banner: { sizes: [[300,250],[300,600]] }
+             },
+             floors: {
+                 currency: 'USD',
+                 schema: {
+                     delimiter: '|',
+                     fields: [ 'mediaType' ]
+                 },
+                 values: {
+                     '*': 1.00      // enter your static floor here
+                 }
+             },
+             bids: [
+                 ...
+             ]
+         }
+     ];
+```
+
+{: .alert.alert-warning :}
+Prebid does not recommend setting static floors. They are blunt tools and you'll forget to update them.
+
 ## How it Works
 
 There are several places where the Floor module changes the behavior of the Prebid.js auction process. Below is a diagram describing the general flow of the client-side Price Floors Module:

From 301a21f72420e070e4117cd3d589b0cb88623718 Mon Sep 17 00:00:00 2001
From: Pavlo Kavulych <72217414+Chucky-choo@users.noreply.github.com>
Date: Thu, 17 Apr 2025 18:43:40 +0300
Subject: [PATCH 111/665] add adipolo Adapter (#5944)

* add adipolo Adapter

* correction

---------

Co-authored-by: Chucky-choo <dedafu47@gmail.com>
---
 dev-docs/bidders/adipolo.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/adipolo.md

diff --git a/dev-docs/bidders/adipolo.md b/dev-docs/bidders/adipolo.md
new file mode 100644
index 0000000000..6c1773c062
--- /dev/null
+++ b/dev-docs/bidders/adipolo.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: adipolo
+description: adipolo Bidder Adapter
+biddercode: adipolo
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: false
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example       | Type      |
+|-------------|----------|-----------------------------|---------------|-----------|
+| `pid`       | required | Placement ID                | `test-banner` | `string`  |
+| `env`       | optional | Environment name            | `adipolo`     | `string`  |
+| `ext`       | optional | Specific integration config | `{}`          | `object`  |

From 335c21621b6aee789fb055f28c4fd4b0a6046f11 Mon Sep 17 00:00:00 2001
From: Dmytro Shyrokov <shirokoffdima@gmail.com>
Date: Fri, 18 Apr 2025 17:45:20 +0300
Subject: [PATCH 112/665] adipolo: uppercase bidder title (#5997)

---
 dev-docs/bidders/adipolo.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/adipolo.md b/dev-docs/bidders/adipolo.md
index 6c1773c062..c5534ad67f 100644
--- a/dev-docs/bidders/adipolo.md
+++ b/dev-docs/bidders/adipolo.md
@@ -1,7 +1,7 @@
 ---
 layout: bidder
-title: adipolo
-description: adipolo Bidder Adapter
+title: Adipolo
+description: Adipolo Bidder Adapter
 biddercode: adipolo
 media_types: banner, video
 coppa_supported: true

From cef9263772bc78891541cecd7d865e6b03ced0e2 Mon Sep 17 00:00:00 2001
From: Sam Evans <98488535+evans-sam@users.noreply.github.com>
Date: Fri, 18 Apr 2025 09:23:43 -0600
Subject: [PATCH 113/665] Add documentation for allBidsCustomTargeting setting
 in setConfig.md (#5959)

---
 dev-docs/publisher-api-reference/setConfig.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 6b39588bb2..f51cedf27a 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -708,6 +708,7 @@ The `targetingControls` object passed to `pbjs.setConfig` provides some options
 | allowTargetingKeys | Array of Strings | Selects supported default targeting keys. |
 | addTargetingKeys   | Array of Strings | Selects targeting keys to be supported in addition to the default ones |
 | allowSendAllBidsTargetingKeys | Array of Strings | Selects supported default targeting keys. |
+| allBidsCustomTargeting | boolean | Set to true to prevent custom targeting values from being set for non-winning bids |
 
 {: .alert.alert-info :}
 Note that this feature overlaps and can be used in conjunction with [sendBidsControl.bidLimit](#setConfig-Send-Bids-Control).
@@ -904,6 +905,11 @@ config.setConfig({
 });
 ```
 
+#### Details on the allBidsCustomTargeting setting
+{: .no_toc}
+
+By default, non winning bids will have custom tageting values concatenated to the winning bid's custom targeting for the same key.  The `allBidsCustomTargeting` setting is a boolean that, when set to `false`, prevents custom targeting values from being set for non-winning bids. This can be useful if you want to ensure that only the winning bid has custom targeting values set.  
+
 <a name="setConfig-Configure-Responsive-Ads"></a>
 
 ### Configure Responsive Ads

From 38444fd2f938f3776a3e2f72a1e5b9d6cd634e12 Mon Sep 17 00:00:00 2001
From: Pete <petropo@playbuzz.com>
Date: Tue, 22 Apr 2025 14:59:45 +0300
Subject: [PATCH 114/665] Update exco bidder documentation (#6002)

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* Update exco bidder documentation
---
 dev-docs/bidders/exco.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/exco.md b/dev-docs/bidders/exco.md
index 36631c89e0..927f18a8d7 100644
--- a/dev-docs/bidders/exco.md
+++ b/dev-docs/bidders/exco.md
@@ -1,7 +1,7 @@
 ---
 layout: bidder
-title: Exco
-description: Prebid Exco Bidder Adaptor
+title: EX.CO
+description: Prebid EX.CO Bidder Adaptor
 biddercode: exco
 filename: excoBidAdapter
 userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId

From d5d0c6124c41385cd656c6ae6cf7de3cabc9075d Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Tue, 22 Apr 2025 15:50:54 +0200
Subject: [PATCH 115/665] WURFL Rtd Provider: update configuration section
 (#5996)

* WURFL Rtd Provider: update configuration section

The configuration section has been updated to recommend setting the
auctionDelay parameter to at least 500ms, and the waitForIt parameter is
now required.

* WURFL Rtd Provider: update configuration section

The configuration section has been updated to recommend setting the
auctionDelay parameter to at least 500ms, and the waitForIt parameter is
now required.
---
 dev-docs/modules/wurflRtdProvider.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 603127aa90..35fe4e4a86 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -39,6 +39,7 @@ While the WURFL RTD module enriches the OpenRTB 2.0 payload, it is the responsib
 The following scenarios are possible:
 
 {: .table .table-bordered .table-striped }
+
 |                           | SSP Adapter   | SSP Server Side End-Point                                        |
 | :------------------------ | :------------ | :--------------------------------------------------------------- |
 | SSP adapter is already passing the ORTB2 device to the server (auction endpoint). | No changes required. | Update backend logic to utilize the device data. |
@@ -57,13 +58,15 @@ gulp build --modules="wurflRtdProvider,appnexusBidAdapter,..."
 
 ### Configuration
 
-To initialize the WURFL RTD module in Prebid.js, use the `setConfig` function as shown below. The module is configured as part of `realTimeData.dataProviders`
+To initialize the WURFL RTD module in Prebid.js, use the `setConfig` function as shown below. 
+The module is configured within `realTimeData.dataProviders`. 
+Ensure `waitForIt` is set to `true`. We recommend setting `auctionDelay` to `500 ms` initially, 
+though lower values may be suitable with fine-tuning.
 
 ```javascript
-var TIMEOUT = 1000;
 pbjs.setConfig({
     realTimeData: {
-        auctionDelay: TIMEOUT,
+        auctionDelay: 500,
         dataProviders: [{
             name: 'wurfl',
             waitForIt: true,
@@ -78,10 +81,11 @@ pbjs.setConfig({
 ### Parameters
 
 {: .table .table-bordered .table-striped }
+
 | Name                      | Type          | Description                                                      | Default               |
 | :------------------------ | :------------ | :--------------------------------------------------------------- |:----------------------|
 | name                      | String        | Real time data module name                                       | Always set to 'wurfl' |
-| waitForIt                 | Boolean       | Set to `true` if an `auctionDelay` is defined (optional)         | `false`               |
+| waitForIt                 | Boolean       | Set to `true` if an `auctionDelay` is defined (required)         | `false`               |
 | params                    | Object        | Configuration parameters for the WURFL RTD module.               |                       |
 | params.altHost            | String        | Alternate host for connecting to WURFL.js                        |                       |
 | params.debug              | Boolean       | Enable debug mode.                                               | `false`               |

From 51e66d57fd365384c550db405a2a1dbbb371d4b3 Mon Sep 17 00:00:00 2001
From: Rafael Taveira <103446145+rafataveira@users.noreply.github.com>
Date: Wed, 23 Apr 2025 14:39:01 -0500
Subject: [PATCH 116/665] Nativo: Documentation Update (#5998)

* Added nativo markup documentation to dev-docs/bidders

* Added IAB Global Vendor List ID number.

* Adjusted placementId Type to be integer

* Changed pbjs value to true

* Added optional url parameter

* Updated placementId parameter to be optional

* Added userIds to nativo.md

* Reflecting Prebid Server Adapter metadata

* Update nativo bidder docs

* Add multiformat_supported field to nativo readme

* Nativo: updated documentation

* Nativo: Documentation Update

* Nativo: Documentation Update - after code review.

---------

Co-authored-by: Josh <jfledd@gmail.com>
Co-authored-by: jsfledd <jsfledd@users.noreply.github.com>
Co-authored-by: Joshua Fledderjohn <jfledderjohn@nativo.com>
Co-authored-by: Bill Coloe <clowd150@gmail.com>
Co-authored-by: doctafaustus <bcoloe@nativo.com>
---
 dev-docs/bidders/nativo.md | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/nativo.md b/dev-docs/bidders/nativo.md
index f3bf31ecfa..1429a724b1 100644
--- a/dev-docs/bidders/nativo.md
+++ b/dev-docs/bidders/nativo.md
@@ -22,8 +22,20 @@ The Nativo Bidder adapter requires setup before beginning. Please contact us at
 
 ### Bid Params
 
+### Prebid Server
+
+Prebid Server primarily relies on the OpenRTB specification for its field definitions, along with widely recognized extensions that have become semi-standard within the industry.
+
+{: .table .table-bordered .table-striped }
+| Name                         | Scope                               | Description                                                                                                                | Example                                             | Type      |
+|------------------------------|-------------------------------------|----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|-----------|
+| `imp.tagid`                  | required - preferred                | Represents the Ad Slot Tag ID, which is the primary identifier linked to a specific placement ID within the Nativo platform.  Read more about [tagid in the oRTB 2.6 docs](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#324---object-imp-) |  `placement_tagid_example`                          | `string`  |
+| `imp.ext.nativo.placementid` | required if no tagID                | Refers to the unique Placement ID assigned by the Nativo platform.                                                         |  `12345678`                                         | `integer` |
+| `imp.ext.gpid`               | required if no other ID is provided | Represents the Ad Slot GP ID. It is another layer of identification tied to a placement ID within the Nativo platform. Read more about [gpid in the prebid docs](/features/pbAdSlot.html#the-gpid)       |  `/22888152279/publication/placement/gpid_example`  | `string`  |
+
+### Prebid JS
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                                                                     | Example      | Type      |
-|---------------|----------|---------------------------------------------------------------------------------|--------------|-----------|
-| `placementId` | optional | Publication placement ID value from the Nativo Platform                         |  `13144370`  | `integer` |
-| `url`         | optional | Publication url value associated with placement ID value in the Nativo Platform |  `https://test-sites.internal.nativo.net/testing/prebid_adpater.html`  | `string` |
+| Name       | Scope    | Description                                                                            | Example                                         | Type      |
+|------------|----------|----------------------------------------------------------------------------------------|-------------------------------------------------|-----------|
+| `ntv_url`  | required | Publication url associated with placement IDs within the Nativo platform. |  `https://publication.com/prebid_adpater.html`  | `string`  |
+| `ntv_ptd`  | optional | Refers to a list of Placement IDs assigned by the Nativo platform for the publication. |  `12345678,12345699`                            | `array of integer` |

From 6b254e3a74c9a47304fcd783b2932f59390b09d2 Mon Sep 17 00:00:00 2001
From: "Md. Soman Mia Sarker" <gao.gram@gmail.com>
Date: Thu, 24 Apr 2025 16:07:45 +0600
Subject: [PATCH 117/665] Placement updated (#5988)

* Added new optional param placement

* Added new optional param placement

* Made required field

* Update adgrid.md

Placement updated

---------

Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/adgrid.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/adgrid.md b/dev-docs/bidders/adgrid.md
index ac72fc9cfb..9cb640c86d 100644
--- a/dev-docs/bidders/adgrid.md
+++ b/dev-docs/bidders/adgrid.md
@@ -34,7 +34,7 @@ The AdGrid Bidding Adapter requires setup and approval before beginning. Please
 | Name       | Scope    | Description  | Example | Type      |
 |------------|----------|--------------|---------|-----------|
 | `domainId` | required | Publisher Id | `30164` | `integer` |
-| `placement`| required | Placement    | `test`  | `string`  |
+| `placement`| required | Placement    | `global`| `string`  |
 
 ### Test Parameters
 
@@ -52,7 +52,7 @@ var adUnits = [
       bidder: 'adgrid',
       params: {
         domainId: 12345,
-        placement: 'leaderboard'
+        placement: 'global'
       }
     }]
   },
@@ -66,8 +66,8 @@ var adUnits = [
     bids: [{
       bidder: 'adgrid',
       params: {
-        domainId: 67890,
-        placement: 'adhesion'
+        domainId: 12345,
+        placement: 'global'
       }
     }]
   },
@@ -85,7 +85,8 @@ var adUnits = [
     bids: [{
       bidder: 'adgrid',
       params: {
-        domainId: 12345
+        domainId: 12345,
+        placement: 'global'
       }
     }]
   }

From ca933a28373a77ec5566e9315bddec34def8d4b2 Mon Sep 17 00:00:00 2001
From: Rafael Taveira <103446145+rafataveira@users.noreply.github.com>
Date: Mon, 28 Apr 2025 06:43:20 -0500
Subject: [PATCH 118/665] Nativo: Fix Documentation  (#6006)

* Added nativo markup documentation to dev-docs/bidders

* Added IAB Global Vendor List ID number.

* Adjusted placementId Type to be integer

* Changed pbjs value to true

* Added optional url parameter

* Updated placementId parameter to be optional

* Added userIds to nativo.md

* Reflecting Prebid Server Adapter metadata

* Update nativo bidder docs

* Add multiformat_supported field to nativo readme

* Nativo: updated documentation

* Nativo: Documentation Update

* Nativo: Documentation Update - after code review.

* Nativo: Fix on Prebid.js param table not rendering correctly

---------

Co-authored-by: Josh <jfledd@gmail.com>
Co-authored-by: jsfledd <jsfledd@users.noreply.github.com>
Co-authored-by: Joshua Fledderjohn <jfledderjohn@nativo.com>
Co-authored-by: Bill Coloe <clowd150@gmail.com>
Co-authored-by: doctafaustus <bcoloe@nativo.com>
---
 dev-docs/bidders/nativo.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/nativo.md b/dev-docs/bidders/nativo.md
index 1429a724b1..23d363512a 100644
--- a/dev-docs/bidders/nativo.md
+++ b/dev-docs/bidders/nativo.md
@@ -22,7 +22,7 @@ The Nativo Bidder adapter requires setup before beginning. Please contact us at
 
 ### Bid Params
 
-### Prebid Server
+#### Prebid Server
 
 Prebid Server primarily relies on the OpenRTB specification for its field definitions, along with widely recognized extensions that have become semi-standard within the industry.
 
@@ -33,9 +33,10 @@ Prebid Server primarily relies on the OpenRTB specification for its field defini
 | `imp.ext.nativo.placementid` | required if no tagID                | Refers to the unique Placement ID assigned by the Nativo platform.                                                         |  `12345678`                                         | `integer` |
 | `imp.ext.gpid`               | required if no other ID is provided | Represents the Ad Slot GP ID. It is another layer of identification tied to a placement ID within the Nativo platform. Read more about [gpid in the prebid docs](/features/pbAdSlot.html#the-gpid)       |  `/22888152279/publication/placement/gpid_example`  | `string`  |
 
-### Prebid JS
+#### Prebid JS
+
 {: .table .table-bordered .table-striped }
 | Name       | Scope    | Description                                                                            | Example                                         | Type      |
 |------------|----------|----------------------------------------------------------------------------------------|-------------------------------------------------|-----------|
 | `ntv_url`  | required | Publication url associated with placement IDs within the Nativo platform. |  `https://publication.com/prebid_adpater.html`  | `string`  |
-| `ntv_ptd`  | optional | Refers to a list of Placement IDs assigned by the Nativo platform for the publication. |  `12345678,12345699`                            | `array of integer` |
+| `ntv_ptd`  | optional | Refers to a list of Placement IDs assigned by the Nativo platform for the publication. |  `12345678,12345699`   | `array of integer` |

From ed85b715202f52e8424cb01a9d8021b08a4880bb Mon Sep 17 00:00:00 2001
From: Vu Hoang PHAN <vuhoangphan1307@gmail.com>
Date: Tue, 29 Apr 2025 18:33:08 +0200
Subject: [PATCH 119/665] add pbs doc (#5934)

---
 dev-docs/bidders/mobkoi.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/mobkoi.md b/dev-docs/bidders/mobkoi.md
index 1929ad4b89..9406f061d5 100644
--- a/dev-docs/bidders/mobkoi.md
+++ b/dev-docs/bidders/mobkoi.md
@@ -18,7 +18,7 @@ deals_supported: false
 floors_supported: false
 fpd_supported: true
 pbjs: true
-pbs: false
+pbs: true
 prebid_member: false
 multiformat_supported: will-bid-on-one
 ortb_blocking_supported: partial
@@ -34,9 +34,10 @@ more details.
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Path                                        | Scope    | Description                  | Example                   | Type      |
-|---------------------------------------------|----------|------------------------------|---------------------------|-----------|
-| `placementId`                               | required | Mobkoi Provided Placement ID | `'DF2FFFFF'`              | `string`  |
+| Path                                        | Scope    | Description                    | Example                               | Type     |
+|---------------------------------------------|----------|--------------------------------|---------------------------------------|----------|
+| `placementId`                               | required | Mobkoi Provided Placement ID   | `'DF2FFFFF'`                          | `string` |
+| `adServerBaseUrl`                           | optional | Mobkoi adserver url (PBS only) | `https://adserver.maximus.mobkoi.com` | `string` |
 
 #### Example Configuration
 

From 1dfc27316b057b85340c22883864a52d9b71cb13 Mon Sep 17 00:00:00 2001
From: mnguyen-raveltech <michel.nguyen@raveltech.io>
Date: Tue, 29 Apr 2025 18:38:12 +0200
Subject: [PATCH 120/665] raveltechRtdProvider: Initial documentation release
 (#5923)

* 1st version of the doc for raveltech bid adapter

* add angle brackets around email address

* add single newline character to comply with https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md047.md

* 1st version of the doc for raveltech bid adapter

* add angle brackets around email address

* add single newline character to comply with https://github.com/DavidAnson/markdownlint/blob/v0.34.0/doc/md047.md

* update to solve:
- header level 3: https://github.com/prebid/prebid.github.io/pull/5501/files/004b8d8e6ea3866f53aecc23a7f0041fd241874e#r1681657660
- table of params: https://github.com/prebid/prebid.github.io/pull/5501/files/004b8d8e6ea3866f53aecc23a7f0041fd241874e#r1681663103

* fix anchors to the appnexus doc

* fix anchors to the appnexus doc

* initial release of raveltechRtdProvider.md, replacing the raveltech.md as we're changing the approach from bid adapter to rtd module.

* Update of documentation

* fix the markdown lint errors

* fix markdown lint errors

* update markdown with instructions on how to load zkad.js

* fix lint errors
---
 dev-docs/modules/raveltechRtdProvider.md | 84 ++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 dev-docs/modules/raveltechRtdProvider.md

diff --git a/dev-docs/modules/raveltechRtdProvider.md b/dev-docs/modules/raveltechRtdProvider.md
new file mode 100644
index 0000000000..596720699f
--- /dev/null
+++ b/dev-docs/modules/raveltechRtdProvider.md
@@ -0,0 +1,84 @@
+---
+layout: page_v2
+title: Raveltech RTD Module
+display_name: Raveltech RTD Module
+description: Raveltech Real Time Data Module
+page_type: module
+module_type: rtd
+module_code : raveltechRtdProvider
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+# Raveltech RTD Module for Prebid.js
+
+## Overview
+
+```text
+Module Name:  Raveltech RTD Provider
+Module Type:  RTD Provider
+Maintainer: maintainers@raveltech.io
+```
+
+The RavelTech RTD (Real-Time Data) module for Prebid.js enables publishers to integrate seamlessly with Ravel Technologies' privacy-focused solution, ensuring bidder requests are anonymized before reaching SSPs and DSPs. By leveraging the Ravel Privacy Bus, this module prevents the transmission of personally identifiable information (PII) in bid requests, strengthening privacy compliance and security.
+
+## How It Works
+
+The module operates in two modes:
+
+1. Bid URL Replacement:
+** The module modifies the bid request URL of the configured bidders to pass through the Ravel proxy, ensuring that all IDs are anonymized.
+2. Bid Duplication (if `preserveOriginalBid` is enabled):
+** The module duplicates the original bid request, sending one request as-is and another through the Ravel proxy with anonymized IDs.
+
+## Configuration
+
+To enable the Raveltech RTD module, you need to configure it with a list of bidders and specify whether to preserve the original bid request.
+For the anonymization feature to work, you also need to load a javascript in the header of your HTML page:
+
+```html
+<script src="https://cdn.rvlproxy.net/latest/zkad.js" async></script>
+```
+
+**NB: the URL to load zkad.js may change depending your setup. Please reach out to your contact at Ravel Technologies to ensure you have the correct URL.**
+
+Please contact <support@raveltech.io> to activate your adapter after installation or for more information.
+
+### Build
+
+```bash
+gulp build --modules="rtdModule,raveltechRtdProvider,appnexusBidAdapter,..."  
+```
+
+> Note that the global RTD module, `rtdModule`, is a prerequisite of the raveltech RTD module.
+
+### Parameters
+
+| Parameter           | Type    | Description |
+|--------------------|--------|-------------|
+| `bidders`         | Array  | A list of bidder codes (or their alias if an alias is used) that should have their bid requests anonymized via Ravel. |
+| `preserveOriginalBid` | Boolean | If `true`, the original bid request is preserved, and an additional bid request is sent through the Ravel proxy. If `false`, the original bid request is replaced with the Ravel-protected request. |
+
+### Example Configuration
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        dataProviders: [{
+            name: 'raveltech',
+            params: {
+                bidders: ['appnexus', 'rubicon'],
+                preserveOriginalBid: true
+            }
+        }]
+    }
+});
+```
+
+## Privacy Features
+
+The RavelTech RTD module allows publishers to implement the following privacy protections:
+
+- Personally Identifiable Information (PII) is either removed or converted into Anonymized IDs (RIDs).
+- Bid requests are routed through an anonymized proxy before reaching the SSP, ensuring IP address anonymization.

From 0772edb9da30e71d066fdc34a834473c2283b1d7 Mon Sep 17 00:00:00 2001
From: hamper <hamper.nhs@gmail.com>
Date: Tue, 29 Apr 2025 20:16:34 +0300
Subject: [PATCH 121/665] Vistars bid adapter (#5918)

---
 dev-docs/bidders/vistars.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 dev-docs/bidders/vistars.md

diff --git a/dev-docs/bidders/vistars.md b/dev-docs/bidders/vistars.md
new file mode 100644
index 0000000000..e40789c8e8
--- /dev/null
+++ b/dev-docs/bidders/vistars.md
@@ -0,0 +1,26 @@
+---
+layout: bidder
+title: Vistars
+description: vistars bid adapter
+pbjs: true
+biddercode: vistars
+media_types: banner, video
+safeframes_ok: true
+tcfeu_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description   | Example     | Type     |
+|---------------|----------|---------------|-------------|----------|
+| `source`      | required | Source id     | `'ssp1'`    | `string` |

From d4c0a505f73893f0eb1906f4b15c27750d37d8c4 Mon Sep 17 00:00:00 2001
From: robustadev <dev@robustadigital.com>
Date: Tue, 29 Apr 2025 20:30:55 +0300
Subject: [PATCH 122/665] RobustaBidAdapter: docs (#5905)

---
 dev-docs/bidders/robusta.md | 42 +++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/robusta.md

diff --git a/dev-docs/bidders/robusta.md b/dev-docs/bidders/robusta.md
new file mode 100644
index 0000000000..775cf68757
--- /dev/null
+++ b/dev-docs/bidders/robusta.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: Robusta
+description: Robusta Bidder Adaptor
+biddercode: robusta
+media_types: banner, video
+tcfeu_supported: false
+gpp_supported: false
+usp_supported: false
+pbjs: true
+pbs: true
+sidebarType: 1
+---
+
+# Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name       | Scope    | Description      | Example | Type     |
+|------------|----------|------------------|---------|----------|
+| lineItemId | Required | The Line Item ID | `'123'` | `string` |
+
+
+# Example Ad Unit Config
+
+```javascript
+var adUnits = [
+  {
+    code: 'banner-div',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250], [728, 90]]
+      }
+    },
+    bids: [{
+      bidder: 'robusta',
+      params: {
+        lineItemId: '323bfac4-a3cb-40e8-a3ae-e9832b35f969'
+      }
+    }]
+  }
+];
+```
\ No newline at end of file

From 92d0f7aed50275e3097a9e47406101c59908d291 Mon Sep 17 00:00:00 2001
From: Alexander Pykhteyev <alex.pykhteyev@gmail.com>
Date: Wed, 30 Apr 2025 00:42:30 +0700
Subject: [PATCH 123/665] Add documentation for new limelight aliases (#5880)

* Add documentation for new limelight aliases

* Update adtarget_org.md

* Update orangeclickmedia.md

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
---
 dev-docs/bidders/adtarget_org.md     | 41 +++++++++++++++++++++++++++
 dev-docs/bidders/orangeclickmedia.md | 42 ++++++++++++++++++++++++++++
 dev-docs/bidders/streamvision.md     | 41 +++++++++++++++++++++++++++
 dev-docs/bidders/velonium.md         | 41 +++++++++++++++++++++++++++
 4 files changed, 165 insertions(+)
 create mode 100644 dev-docs/bidders/adtarget_org.md
 create mode 100644 dev-docs/bidders/orangeclickmedia.md
 create mode 100644 dev-docs/bidders/streamvision.md
 create mode 100644 dev-docs/bidders/velonium.md

diff --git a/dev-docs/bidders/adtarget_org.md b/dev-docs/bidders/adtarget_org.md
new file mode 100644
index 0000000000..99daf2c9cf
--- /dev/null
+++ b/dev-docs/bidders/adtarget_org.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: AdTarget.org
+description: AdTarget.org bidder adapter
+biddercode: adtg_org
+pbjs: true
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                              | Example                | Type      |
+|:--------------|:---------|:---------------------------------------------------------|:-----------------------|:----------|
+| `host`        | required | Ad network's RTB host                                    | `'rtb.adtarget.org'`   | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on AdTarget.org Platform.   | `42`                   | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                  | `'banner'`             | `string`  |
+| `publisherId` | required | Publisher ID                                             | `'12345'`              | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                 | `'custom1'`            | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                 | `'custom2'`            | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                 | `'custom3'`            | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                 | `'custom4'`            | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                 | `'custom5'`            | `string`  |
+
+AdTarget.org server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But AdTarget.org client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+AdTarget.org server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But AdTarget.org client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.
diff --git a/dev-docs/bidders/orangeclickmedia.md b/dev-docs/bidders/orangeclickmedia.md
new file mode 100644
index 0000000000..a85a4cb96e
--- /dev/null
+++ b/dev-docs/bidders/orangeclickmedia.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: OCM Media
+description: OCM Media bidder adapter
+biddercode: orangeclickmedia
+pbjs: true
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: true
+gvl_id: 1148
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                           | Example                         | Type      |
+|:--------------|:---------|:------------------------------------------------------|:--------------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                 | `'scotty.orangeclickmedia.com'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on OCM Media Platform.   | `42`                            | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)               | `'banner'`                      | `string`  |
+| `publisherId` | required | Publisher ID                                          | `'12345'`                       | `string`  |
+| `custom1`     | optional | Custom targeting field 1                              | `'custom1'`                     | `string`  |
+| `custom2`     | optional | Custom targeting field 2                              | `'custom2'`                     | `string`  |
+| `custom3`     | optional | Custom targeting field 3                              | `'custom3'`                     | `string`  |
+| `custom4`     | optional | Custom targeting field 4                              | `'custom4'`                     | `string`  |
+| `custom5`     | optional | Custom targeting field 5                              | `'custom5'`                     | `string`  |
+
+OCM Media server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But OCM Media client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+OCM Media server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But OCM Media client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.
diff --git a/dev-docs/bidders/streamvision.md b/dev-docs/bidders/streamvision.md
new file mode 100644
index 0000000000..e937244adf
--- /dev/null
+++ b/dev-docs/bidders/streamvision.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Streamvision
+description: Streamvision bidder adapter
+biddercode: streamvision
+pbjs: true
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                              | Example                         | Type      |
+|:--------------|:---------|:---------------------------------------------------------|:--------------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                    | `'adops.streamvisionmedia.com'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Streamvision Platform.   | `42`                            | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                  | `'banner'`                      | `string`  |
+| `publisherId` | required | Publisher ID                                             | `'12345'`                       | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                 | `'custom1'`                     | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                 | `'custom2'`                     | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                 | `'custom3'`                     | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                 | `'custom4'`                     | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                 | `'custom5'`                     | `string`  |
+
+Streamvision server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Streamvision client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Streamvision server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Streamvision client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.
diff --git a/dev-docs/bidders/velonium.md b/dev-docs/bidders/velonium.md
new file mode 100644
index 0000000000..924efbbb77
--- /dev/null
+++ b/dev-docs/bidders/velonium.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Velonium
+description: Velonium Bidder adapter
+biddercode: velonium
+pbjs: true
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                          | Example         | Type      |
+|:--------------|:---------|:-----------------------------------------------------|:----------------|:----------|
+| `host`        | required | Ad network's RTB host                                | `'adxvel.com'`  | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Velonium Platform.   | `42`            | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)              | `'banner'`      | `string`  |
+| `publisherId` | required | Publisher ID                                         | `'12345'`       | `string`  |
+| `custom1`     | optional | Custom targeting field 1                             | `'custom1'`     | `string`  |
+| `custom2`     | optional | Custom targeting field 2                             | `'custom2'`     | `string`  |
+| `custom3`     | optional | Custom targeting field 3                             | `'custom3'`     | `string`  |
+| `custom4`     | optional | Custom targeting field 4                             | `'custom4'`     | `string`  |
+| `custom5`     | optional | Custom targeting field 5                             | `'custom5'`     | `string`  |
+
+Velonium server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Velonium client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Velonium server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Velonium client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From 1ddefb62bc910f4536cd7c78f8795fbaeded251f Mon Sep 17 00:00:00 2001
From: epomrnd <epomrnd@users.noreply.github.com>
Date: Wed, 30 Apr 2025 07:33:47 +0300
Subject: [PATCH 124/665] Added documentation for epomDspBidAdapter (#5883)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add doc md

* add real data for EPOM DSP

---------

Co-authored-by: Vladyslav <v.vit@epom.com”>
---
 dev-docs/bidders/epomDspBidAdapter.md | 145 ++++++++++++++++++++++++++
 1 file changed, 145 insertions(+)
 create mode 100644 dev-docs/bidders/epomDspBidAdapter.md

diff --git a/dev-docs/bidders/epomDspBidAdapter.md b/dev-docs/bidders/epomDspBidAdapter.md
new file mode 100644
index 0000000000..81dc74682c
--- /dev/null
+++ b/dev-docs/bidders/epomDspBidAdapter.md
@@ -0,0 +1,145 @@
+---
+layout: bidder
+title: Epom DSP
+description: Prebid Epom DSP Bid Adapter
+biddercode: epom_dsp
+tcfeu_supported: true
+gvl_id: none
+usp_supported: true
+coppa_supported: false
+gpp_sids: tcfeu, usnat
+schain_supported: true
+dchain_supported: false
+userId: none
+media_types: banner
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+## Overview
+
+The **Epom DSP Bid Adapter** allows publishers to connect with the Epom DSP Exchange for programmatic advertising. It supports banner formats and adheres to the OpenRTB protocol.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                              | Example  | Type    |
+|------------|---------|----------------------------------|---------|--------|
+| `endpoint` | required | The URL of the Epom DSP bidding endpoint | `'https://bidder.epommarket.com/bidder/v2_5/bid?key=your_api_key'` | `string` |
+| `placementId` | optional | Unique identifier for the placement      | `'12345'` | `string` |
+| `bidfloor` | optional | Minimum CPM value for the bid in USD    | `0.5`     | `number` |
+
+## Example Configuration
+
+```javascript
+     var adUnits = [
+    {
+        code: 'epom-banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [
+                    [300, 250]
+                ]
+            }
+        },
+        bids: [
+            {
+                bidder: 'epom_dsp',
+                params: {
+                    endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+                },
+                "imp": [
+                    {
+                        "banner": {
+                            "w": 300,
+                            "h": 250,
+                            "btype": [
+                                4
+                            ],
+                            "pos": 0,
+                            "api": [
+                                3
+                            ]
+                        },
+                        "instl": 0,
+                        "tagid": "test4",
+                        "bidfloor": 0.01,
+                        "bidfloorcur": "USD",
+                        "id": "2"
+                    }
+                ],
+                "site": {
+                    "id": "fc59bd54-36df-4d33-830c-fdsfds",
+                    "domain": "epom.com",
+                    "privacypolicy": 0,
+                    "publisher": {
+                        "id": "testid"
+                    },
+                    "content": {
+                        "id": "1234567",
+                        "episode": 23,
+                        "title": "Car Show",
+                        "series": "All About Cars",
+                        "season": "2",
+                        "cat": [
+                            "IAB2-2"
+                        ]
+                    }
+                },
+                "device": {
+                    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
+                    "geo": {
+                        "country": "UKR",
+                        "region": "",
+                        "city": ""
+                    },
+                    "ip": "176.112.120.50",
+                    "devicetype": 2,
+                    "os": "windows",
+                    "osv": "",
+                    "js": 1,
+                    "language": "US",
+                    "carrier": "VERIZON",
+                    "connectiontype": 5,
+                    "ifa": "AA000DFE74168477C70D291f574D344790E0BB11"
+                },
+                "user": {
+                    "id": "testiduser"
+                },
+                "test": 0,
+                "at": 2,
+                "allimps": 0,
+                "cur": [
+                    "USD"
+                ],
+                "bcat": [
+                    "IAB25-2",
+                    "IAB25-1"
+                ],
+                "badv": [],
+                "id": "NewIdTest"
+            }
+        ]
+    }
+];
+```
+
+## GDPR and Privacy Compliance
+
+The **Epom DSP Bid Adapter** supports GDPR and CCPA compliance. Consent information can be passed via:
+
+- `bidderRequest.gdprConsent`
+- `bidderRequest.uspConsent`
+
+## Support
+
+For integration assistance, contact [Epom Support](mailto:support@epom.com).

From 3e7a97f723e8d798873a24f2df874e224ac32883 Mon Sep 17 00:00:00 2001
From: Vitali Ioussoupov <84333122+pixfuture-media@users.noreply.github.com>
Date: Wed, 30 Apr 2025 00:36:16 -0400
Subject: [PATCH 125/665] Update for pixfuture.md (#5915)

* Update for pixfuture.md

* Made changes regarding GitHub reviews

* Made changes regarding GitHub reviews

* Made changes regarding GitHub reviews

* Update of pixfuture.md
---
 dev-docs/bidders/pixfuture.md | 69 +++++++++++++++++++++++++++++++++--
 1 file changed, 65 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/pixfuture.md b/dev-docs/bidders/pixfuture.md
index 40ccdb338b..fd5a5fd2ea 100644
--- a/dev-docs/bidders/pixfuture.md
+++ b/dev-docs/bidders/pixfuture.md
@@ -14,8 +14,69 @@ pbs: false
 pbjs: true
 sidebarType: 1
 ---
-#### Bid Params
 
-| Name                | Scope    | Description                                                                                                                                                                   | Example                                               | Type             |
-|---------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|------------------|
-| `pix_id`       | required | The pix_id is an ID from PixFuture.  The `pix_id` parameter should be a `string`                                                  | `"Abc123"`                                            | `string`         |
+### Overview
+
+The PixFuture Bidder Adapter connects publishers to PixFuture’s demand via Prebid.js, supporting banner media types. To use this adapter, your PixFuture account must be approved for Prebid integration. Contact <support@pixfuture.com> to request activation or for setup assistance.
+
+#### Solution
+
+To download the PixFuture adapter for Prebid.js, visit [https://docs.prebid.org/download.html](https://docs.prebid.org/download.html) and select the `pixfuture` bidder from the list, along with other bidders you wish to include in your build.
+
+**Important:** The `pixfuture` adapter requires account approval from PixFuture. To enable this integration, email <support@pixfuture.com>.
+
+---
+
+### Bid Parameters
+
+| Name       | Scope    | Description                                                        | Example       | Type     |
+|------------|----------|--------------------------------------------------------------------|---------------|----------|
+| `pix_id`   | required | A unique ID for your site’s ad placement. Corresponds to each ad size. | `"12312345"`    | `string` |
+
+These bid parameters are supported the Prebid.js pixfuture adapter.
+
+The `pix_id` is a unique identifier provided by PixFuture and must be specified for each ad placement/size combination.
+
+---
+
+### Prebid.js Integration
+
+#### Basic Prebid.js Example
+
+Below is an example of configuring ad units for PixFuture in Prebid.js:
+
+```javascript
+var adUnits = [
+    {
+        code: 'test-div-300x250',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'pixfuture',
+                params: {
+                    pix_id: "11234567890"
+                }
+            }
+        ]
+    },
+    {
+        code: 'test-div2-728x90',
+        mediaTypes: {
+            banner: {
+                sizes: [[728, 90]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'pixfuture',
+                params: {
+                    pix_id: "0987654321"
+                }
+            }
+        ]
+    }
+];

From dca434bd8b12a8557565d94d5f8ba66778f5a488 Mon Sep 17 00:00:00 2001
From: Andrea Castello <castello.a@gmail.com>
Date: Thu, 1 May 2025 13:14:13 +0200
Subject: [PATCH 126/665] Feature/wurfl rtd provider update docs (#6019)

* updated Expected behavior paragraph on wurflRtdProvider doc

* fixed os version value in doc
---
 dev-docs/modules/wurflRtdProvider.md | 36 ++++++++++++++--------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 35fe4e4a86..8668ac5438 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -110,33 +110,33 @@ WURFL RTD adds device information to the bidderRequest's `ortb2.device.ext.wurfl
   "at": 1,
   "site": {...},
   "device": {
-    "w": 375,
-    "h": 667,
+    "w": 1170,
+    "h": 2532,
     "dnt": 0,
-    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_3_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3 Mobile/15E148 Safari/604.1",
+    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3 Mobile/15E148 Safari/604.1",
     "language": "it",
     "make": "Apple",
-    "model": "iPhone",
+    "model": "iPhone 16e",
     "devicetype": 1,
     "os": "iOS",
-    "osv": "18.3.1",
-    "hwv": "iPhone",
-    "ppi": 324,
-    "pxratio": 2,
+    "osv": "18.3",
+    "hwv": "iPhone 16e",
+    "ppi": 456,
+    "pxratio": 3.0,
     "js": 1,
     "ext": {
       "vpw": 980,
       "vph": 1429,
       "wurfl": {
-        "wurfl_id": "apple_iphone_ver18_3",
+        "wurfl_id": "apple_iphone_ver18_3_subhw16e",
         "advertised_browser": "Mobile Safari",
         "advertised_browser_version": "18.3",
         "advertised_device_os": "iOS",
-        "advertised_device_os_version": "18.3.1",
+        "advertised_device_os_version": "18.3",
         "ajax_support_javascript": true,
         "brand_name": "Apple",
-        "complete_device_name": "Apple iPhone",
-        "density_class": "2.0",
+        "complete_device_name": "Apple iPhone 16e",
+        "density_class": "3.0",
         "form_factor": "Smartphone",
         "is_app_webview": false,
         "is_connected_tv": false,
@@ -152,13 +152,13 @@ WURFL RTD adds device information to the bidderRequest's `ortb2.device.ext.wurfl
         "marketing_name": "",
         "max_image_height": 568,
         "max_image_width": 320,
-        "model_name": "iPhone",
-        "physical_screen_height": 89,
-        "physical_screen_width": 50,
-        "pixel_density": 324,
+        "model_name": "iPhone 16e",
+        "physical_screen_height": 141,
+        "physical_screen_width": 65,
+        "pixel_density": 456,
         "pointing_method": "touchscreen",
-        "resolution_height": 1136,
-        "resolution_width": 640
+        "resolution_height": 2532,
+        "resolution_width": 1170
       }
     }
   }

From 9f5409c2ec96a9ec8929d15ee0912c337b6f567b Mon Sep 17 00:00:00 2001
From: rediads <123890182+rediads@users.noreply.github.com>
Date: Thu, 1 May 2025 16:49:12 +0530
Subject: [PATCH 127/665] New RediAds Go Bid Adapter and Updated the RediAds Js
 Adapter.  (#5907)

* Update rediads.md

* Endpoint param example updated

---------

Co-authored-by: charlie <112340977+charlie-symplor@users.noreply.github.com>
Co-authored-by: symplor-alpha <112776856+symplor-alpha@users.noreply.github.com>
---
 dev-docs/bidders/rediads.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/rediads.md b/dev-docs/bidders/rediads.md
index bc1d61e2d7..180b8a9938 100644
--- a/dev-docs/bidders/rediads.md
+++ b/dev-docs/bidders/rediads.md
@@ -6,7 +6,7 @@ biddercode: rediads
 prebid_member: false
 media_types: banner, video, native
 pbjs: true
-pbs: false
+pbs: true
 tcfeu_supported: false
 usp_supported: true
 coppa_supported: false
@@ -27,9 +27,9 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name         | Scope    | Description                                                                 | Example              | Type           |
 |--------------|----------|-----------------------------------------------------------------------------|----------------------|----------------|
-| account_id | required | Account ID generated on the Rediads Platform.                              | '12345'            | string       |
-| site       | optional | Site domain name.                                                          | 'rediads.com'      | string       |
-| slot       | optional | Unique identifier for the ad slot generated on the platform.               | '54321'            | string       |
+| account_id   | required | Account ID generated on the Rediads Platform.                               | '123xyz'             | string       |
+| endpoint     | optional | Only to be used if RediAds team provides you with one.                      | 'bidding2'        | string       |
+| slot         | optional | Unique identifier for the ad slot generated on the platform.                | '54321'              | string       |
 
 ---
 
@@ -64,7 +64,6 @@ var adUnits = [
         bidder: 'rediads',
         params: {
           account_id: '12345',
-          site: 'rediads.com',
           slot: '54321'
         }
       }

From 992be7d1e7f9c415814b83c02ac2e9623930bb64 Mon Sep 17 00:00:00 2001
From: Oleksandr Solodovnikov <sanek.solodovnikov.94@gmail.com>
Date: Fri, 2 May 2025 11:19:42 +0300
Subject: [PATCH 128/665] Aniview Bid Adapter: Added example of User Sync
 configuration (#6022)

* Added example of User Sync configuration

* Added new line to the end of the file

---------

Co-authored-by: Oleksandr Solodovnikov <o.i.solodovnikov@globallogic.com>
---
 dev-docs/bidders/aniview.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/dev-docs/bidders/aniview.md b/dev-docs/bidders/aniview.md
index d9c6308417..0001dce443 100644
--- a/dev-docs/bidders/aniview.md
+++ b/dev-docs/bidders/aniview.md
@@ -127,3 +127,29 @@ pbjs.setBidderConfig({
   },
 }, true);
 ```
+
+### User Sync example
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      // Iframe and Image
+      all: {
+        bidders: ['aniview'],
+        filter: 'include',
+      },
+        
+      // Or you can specify which type should be enabled/disabled:
+      iframe: {
+        bidders: ['aniview'],
+        filter: 'include',
+      },
+      image: {
+        bidders: '*', // '*' represents all bidders
+        filter: 'include', // or 'exclude'
+      },
+    },
+  },
+});
+```

From f42a4bac04c1586a56a9af62bb58059e360bf9f9 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 2 May 2025 10:20:08 +0200
Subject: [PATCH 129/665] Update invibes.md (#6021)

The customEndpoint is a string, not an integer
---
 dev-docs/bidders/invibes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/invibes.md b/dev-docs/bidders/invibes.md
index 2847bf7778..032987367d 100644
--- a/dev-docs/bidders/invibes.md
+++ b/dev-docs/bidders/invibes.md
@@ -41,5 +41,5 @@ The bidder will NOT set any cookies. The bidder will also try to read from Cooki
 |-----------------|----------|--------------------------------------|-------------------------------------------------|----------|
 | `placementId`   | required | The Invibes placement ID             | `'1234567'`                                     | `string` |
 | `domainId`      | optional | Id of domain                         | `1001`                                          | `integer`|
-| `customEndpoint`| optional | Custom test domain                   | `https://bid.videostep.com/Bid/VideoAdContent`  | `integer`|
+| `customEndpoint`| optional | Custom test domain                   | `https://bid.videostep.com/Bid/VideoAdContent`  | `string` |
 | `debug`         | optional | Debug paramentes (only prebid server)| `{ "testBvid": "1234", "testLog": true }`       | `object` |

From 658de2e53c15c11dcfa930d0d8ab31901d1c3090 Mon Sep 17 00:00:00 2001
From: Muhammad Ubaid <hiubaidashraf@gmail.com>
Date: Fri, 2 May 2025 13:41:00 +0500
Subject: [PATCH 130/665] type fixed in debugging module (#6014)

Co-authored-by: ubaid <ubaid@advergic.com>
---
 dev-docs/modules/debugging.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/modules/debugging.md b/dev-docs/modules/debugging.md
index 0f2d00cce5..d48c921634 100644
--- a/dev-docs/modules/debugging.md
+++ b/dev-docs/modules/debugging.md
@@ -173,10 +173,9 @@ pbjs.setConfig({
       {
         when: {
           adUnitCode: "video-adunit",
-          bidder: "bidderA'
+          bidder: "bidderA"
         },
         then: {
-          cpm: 10,
           mediaType: "video",
           source: "client",
           currency: "SEK",
@@ -184,6 +183,7 @@ pbjs.setConfig({
           creativeId: "11111",
           width: 640,
           height: 360,
+          ttl: 300,
           vastXml: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"2.0\"><Ad id=\"TestAd\"><InLine><AdSystem>Prebid Test</AdSystem><AdTitle>VAST 2.0 Linear Ad</AdTitle><Error><![CDATA[http://myErrorURL/error]]></Error><Impression><![CDATA[]]></Impression><Creatives><Creative id=\"2014\" AdID=\"20150911\" sequence=\"1\"><Linear><Duration>00:00:15</Duration><TrackingEvents><Tracking event=\"creativeView\"><![CDATA[]]></Tracking><Tracking event=\"start\"><![CDATA[]]></Tracking><Tracking event=\"firstQuartile\"><![CDATA[]]></Tracking><Tracking event=\"midpoint\"><![CDATA[]]></Tracking><Tracking event=\"thirdQuartile\"><![CDATA[]]></Tracking><Tracking event=\"complete\"><![CDATA[]]></Tracking></TrackingEvents><VideoClicks><ClickThrough><![CDATA[http://prebid.org/]]></ClickThrough><ClickTracking><![CDATA[]]></ClickTracking></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" width=\"960\" height=\"540\" type=\"video/mp4\"><![CDATA[https://s3.amazonaws.com/files.prebid.org/creatives/PrebidLogo.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>"
         }
       },

From 4da5b4566b68a419e94a8f96a00101f1f9e41616 Mon Sep 17 00:00:00 2001
From: dtbarne <7635750+dtbarne@users.noreply.github.com>
Date: Fri, 2 May 2025 03:43:16 -0500
Subject: [PATCH 131/665] Indicate MobileFuse support for pbjs (#6012)

* Indicate MobileFuse support for pbjs

* add bidfloor param
---
 dev-docs/bidders/mobilefuse.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/mobilefuse.md b/dev-docs/bidders/mobilefuse.md
index 38a40c7542..41e651a6a0 100644
--- a/dev-docs/bidders/mobilefuse.md
+++ b/dev-docs/bidders/mobilefuse.md
@@ -12,11 +12,11 @@ gpp_sids: tcfca, usnat, usstate_all, usp
 schain_supported: true
 dchain_supported: false
 userIds: all
-media_types: banner, video, native
+media_types: banner, video
 deals_supported: true
 floors_supported: true
 fpd_supported: false
-pbjs: false
+pbjs: true
 pbs: true
 pbs_app_supported: true
 prebid_member: true
@@ -32,4 +32,4 @@ sidebarType: 1
 | Name         | Scope    | Description                                                | Example | Type    |
 | ------------ | -------- | ---------------------------------------------------------- | ------- | ------- |
 | placement_id | required | An ID which identifies this specific inventory placement   | 1111    | integer |
-| pub_id       | required | An ID which identifies the publisher selling the inventory | 2222    | integer |
+| bidfloor     | optional | Static floor price (in USD) for the impression, pbjs only  | 1.5     | float   |

From af81287b5835f69640132e324a3c44d0c6ee565c Mon Sep 17 00:00:00 2001
From: Stav Ben Shlomo <137684171+StavBenShlomoBrowsi@users.noreply.github.com>
Date: Fri, 2 May 2025 18:05:04 +0300
Subject: [PATCH 132/665] browsi rtd provider updates (#6004)

* browsi rtd provider updates

* browsi rtd provider updates

* browsi rtd provider updates

---------

Co-authored-by: Stav Ben Shlomo <stavbe@gobrowsi.com>
---
 dev-docs/analytics/browsi.md          | 23 +++++++++
 dev-docs/modules/browsiRtdProvider.md | 68 ++++++++++++---------------
 2 files changed, 53 insertions(+), 38 deletions(-)
 create mode 100644 dev-docs/analytics/browsi.md

diff --git a/dev-docs/analytics/browsi.md b/dev-docs/analytics/browsi.md
new file mode 100644
index 0000000000..88f14cb5d1
--- /dev/null
+++ b/dev-docs/analytics/browsi.md
@@ -0,0 +1,23 @@
+---
+layout: analytics
+title: Browsi
+description: Browsi Analytics Adapter
+modulecode: browsiAnalyticsAdapter
+gvl_id: 329
+prebid_member: true
+---
+
+#### Registration
+
+For more information about [Browsi](https://www.browsi.com), please contact [support@browsi.com](support@browsi.com).
+
+#### Example Configuration
+
+```js
+  pbjs.que.push(function () {
+    pbjs.enableAnalytics({
+      provider: 'browsi',
+      options: {}
+    });
+  });
+```
diff --git a/dev-docs/modules/browsiRtdProvider.md b/dev-docs/modules/browsiRtdProvider.md
index 58548ed797..f18ec77705 100644
--- a/dev-docs/modules/browsiRtdProvider.md
+++ b/dev-docs/modules/browsiRtdProvider.md
@@ -1,17 +1,17 @@
 ---
 layout: page_v2
-title: Browsi Viewability Module
-display_name: Browsi Viewability
-description: Browsi Real Time Viewability
+title: Browsi RTD Module
+display_name: Browsi RTD Module
+description: Browsi Real Time Module
 page_type: module
 module_type: rtd
-module_code : browsiRtdProvider
-enable_download : true
+module_code: browsiRtdProvider
+enable_download: true
 vendor_specific: true
 sidebarType : 1
 ---
 
-# Browsi Viewability Module
+# Browsi RTD Module
 {:.no_toc}
 
 * TOC
@@ -19,19 +19,23 @@ sidebarType : 1
 
 ## Overview
 
-The Browsi Viewability module provides viewability predictions for ad slots on the page.
-To use this module, you'll need to work with [Browsi](https://gobrowsi.com) to get
-an account and receive instructions on how to set up your pages and ad server.
+Browsi’s RTD module for Prebid.js provides real-time insights and predictive signals to optimize bid requests and ad delivery.
+This module leverages Browsi's AI models to give publishers access to:
+-**Real-time predictions for GAM:** Enhance ad placements and maximize revenue by leveraging viewability and revenue predictions as key values in GAM ad requests.
+-**Enhanced bid request signals**: Augment bid requests with additional contextual, behavioral, and engagement signals to improve demand partner performance.
+-**Dynamic ad serving optimization**: Enable smarter ad delivery strategies based on predicted user behavior and page context.
+
+## Integration
 
 Implementation works like this:
 
-1. Build the Browsi module into the Prebid.js package with:
+1. Build the Browsi modules into the Prebid.js package with:
 
     ```bash
-    gulp build --modules=browsiRtdProvider&...
+    gulp build --modules=browsiRtdProvider,browsiAnalyticsAdapter
     ```
 
-2. Use `setConfig` to instruct the browser to obtain the viewability data in parallel with the header bidding auction
+2. Use `setConfig` to instruct the browser to obtain Browsi’s predictive signals in parallel with the header bidding auction
 
 ## Configuration
 
@@ -39,16 +43,17 @@ This module is configured as part of the `realTimeData.dataProviders` object:
 
 ```javascript
 pbjs.setConfig({
-    "realTimeData": {
-        dataProviders:[{          
-            "name": "browsi",
-            "params": {
-                "url": "testUrl.com",   // get params values
-                "siteKey": "testKey",   // from Browsi
-                "pubKey": "testPub",    //
-                "keyName":"bv"          //
-            }
-        }]
+   realTimeData: {
+       auctionDelay : 3000,
+       dataProviders: [{
+           name: "browsi",
+           params: {
+               url: "domain.com",
+               siteKey: "SITE",
+               pubKey: "PUB",
+               waitForIt: true
+           }
+       }]
     }
 });
 ```
@@ -63,22 +68,9 @@ Syntax details:
 | params.siteKey  |String   |Site key|   |
 | params.pubKey  |String   |Publisher key|   |
 | params.url  |String   |Server URL|   |
-| params.keyName  |String   |Key value name| Optional. Defaults to 'bv'. |
+| params.keyName  |String   |GAM key value name for the viewability prediction| Optional. Defaults to ‘browsiViewability’. |
+| params.waitForIt  |boolean   |Allow waiting for data| true |
 
 ## Output
 
-For each ad slot, the module returns expected viewability prediction in a JSON format.
-When the data is received, it calls `pbjs.setTargetingForGPT` to set the defined `keyName` for each adunit.
-
-Example:
-
-```json
-{
-  "slotA":{
-      "p":0.56,   // ad server targeting variable (e.g. bv) for slotA is 0.56
-  },
-  "slotB":{
-      "p":0.824,  // ad server targeting variable (e.g. bv) for slotB is 0.824
-  }
-}
-```
+For each ad slot, the module generates predictive signals in JSON format, assigns key-value pairs for viewability and revenue predictions via `pbjs.setTargetingForGPT`, and embeds the full JSON in the bid request under `<bidder>.ortb2Imp.ext.data.browsi`.

From 62b16eae7f13bbf7137bd1c359a8ef9fe9c7340c Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Mon, 5 May 2025 15:03:22 +0100
Subject: [PATCH 133/665] Enrichment lift measurement module (#6007)

* Enrichment lift measurement module

* extension

* Update enrichmentLiftMeasurement.md

aligned the references made to "user id systems" to "user id submodules"

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
Co-authored-by: jdwieland8282 <wieland.jeff@gmail.com>
---
 dev-docs/modules/enrichmentLiftMeasurement.md | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 dev-docs/modules/enrichmentLiftMeasurement.md

diff --git a/dev-docs/modules/enrichmentLiftMeasurement.md b/dev-docs/modules/enrichmentLiftMeasurement.md
new file mode 100644
index 0000000000..f43df57495
--- /dev/null
+++ b/dev-docs/modules/enrichmentLiftMeasurement.md
@@ -0,0 +1,67 @@
+---
+layout: page_v2
+title: Enrichment Lift Measurement Module
+display_name: Enrichment Lift Measurement Module
+description: Enrichment Lift Measurement Module
+page_type: module
+module_code: enrichmentLiftMeasurement
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# Enrichment Lift Measurement
+
+The **Enrichment Lift Measurement Module** allows publishers to evaluate the performance of User ID submodules by configuring and executing A/B tests. It offers several configuration options that enable publishers to:
+
+- Route traffic to selected User ID submodules.
+- Control where the A/B test configuration is stored.
+- Specify how User ID submodules should be disabled.
+
+Additionally, the module attaches the A/B group configuration to analytics labels for tracking and reporting.
+
+## How It Works
+
+1. The publisher initializes the module using `config.setConfig`.
+2. When a user loads the page, the module determines which User ID submodules should participate in the test based on the configured percentages.
+3. Submodules not selected for the test are disabled via activity controls, either during submodule initialization or at the enrichment level.
+4. The A/B group configuration (enabled/disabled submodules) is saved in either `localStorage` or `sessionStorage`. (In `memory` mode, this step is skipped, and the configuration is recalculated on each page load.)
+5. The A/B configuration is attached to analytics labels to enable performance tracking and analysis.
+
+## Configuration
+
+{: .table .table-bordered .table-striped }
+
+| Parameter               | Description                                                      | Allowed Values                            | Default |
+|-------------------------|------------------------------------------------------------------|--------------------------------------------|---------|
+| `storeSplits`           | Defines where to store the A/B group configuration               | `memory`, `sessionStorage`, `localStorage` | -       |
+| `suppression`           | Determines how to disable User ID submodules                     | `submodules`, `eids`                       | `eids`  |
+| `modules[].name`        | Name of the User ID submodule                                    | *(string)*                                 | -       |
+| `modules[].percentage`  | Percentage of users for whom the module is enabled               | *(number between 0 and 1)*                 | -       |
+| `testRun`               | A label used for storing and reporting test configuration status | *(string)*                                 | -       |
+
+## Configuration Example
+
+```javascript
+pbjs.setConfig({
+  enrichmentLiftMeasurement: {
+    modules: [
+      { name: 'idSharedSystem', percentage: 1.0 },     // Enabled for 100% of users
+      { name: '33acrossIdSystem', percentage: 0.5 }    // Enabled for ~50% of users
+    ],
+    storeSplits: 'memory', // Configuration is not stored; recalculated on each page load
+    suppression: 'submodules',
+    testRun: 'JulyTest'
+  }
+});
+```
+
+The following object will be attached to analytics labels based on the configuration above:
+
+```javascript
+{
+  JulyTest: [
+    { name: 'idSharedSystem', percentage: 1.0, enabled: true },
+    { name: '33acrossIdSystem', percentage: 0.5, enabled: false } // May be true or false depending on random selection
+  ]
+}

From f3eb766c39838ae3c8b766823ddb370aec022421 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Wed, 7 May 2025 12:48:54 -0400
Subject: [PATCH 134/665] Update no-adserver.md (#6027)

* Update no-adserver.md

* Update no-adserver.md

* Update sidebar.yml
---
 _data/sidebar.yml                | 2 +-
 dev-docs/examples/no-adserver.md | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index e84c688722..cd87d273dc 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -258,7 +258,7 @@
   subgroup: 1
 
 - sbSecId: 1
-  title: Running without an ad server
+  title: Running Prebid.js as an ad server
   link: /dev-docs/examples/no-adserver.html
   isHeader: 0
   isSectionHeader: 0
diff --git a/dev-docs/examples/no-adserver.md b/dev-docs/examples/no-adserver.md
index 59ea2cedd2..c1b2dee071 100644
--- a/dev-docs/examples/no-adserver.md
+++ b/dev-docs/examples/no-adserver.md
@@ -1,12 +1,12 @@
 ---
 layout: example
-title: No Adserver Example
+title: Prebid as Adserver Example
 left_nav_override: Examples
-description: Running Prebid.js without an ad server
+description: Running Prebid.js as an ad server
 sidebarType: 1
 
 about:
-- This example demonstrates running an auction and rendering without an ad server.
+- This example demonstrates running an auction and rendering; using Prebid.js as an ad server.
 
 jsfiddle_link: jsfiddle.net/Prebid_Examples/svumodbe/embedded/html,result
 

From eb6c9134294dcb062bdb10ce239294d2c324e145 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 13 May 2025 02:01:07 -0400
Subject: [PATCH 135/665] One PBS bidder to a page (#6032)

* One PBS bidder to a page

* copy-paste errs
---
 dev-docs/pbs-bidders.md | 115 +++++++++++++++++++++++++++++++---------
 1 file changed, 90 insertions(+), 25 deletions(-)

diff --git a/dev-docs/pbs-bidders.md b/dev-docs/pbs-bidders.md
index cbc289e03b..690618f725 100644
--- a/dev-docs/pbs-bidders.md
+++ b/dev-docs/pbs-bidders.md
@@ -8,7 +8,7 @@ sidebarType: 5
 # Prebid Server Bidder Params
 
 This page contains documentation on the specific parameters required by each supported bidder.
-These docs only apply to Prebid Server bidders. For Prebid.js bidders see the
+These docs only apply to Prebid Server-based bidders. For Prebid.js, see the
 [Prebid.js Bidders](/dev-docs/bidders.html) page.
 
 For each bidder listed below, you'll find the following information:
@@ -20,51 +20,116 @@ For each bidder listed below, you'll find the following information:
 
 You can also download the full <a href="/dev-docs/bidder-data.csv" download>CSV data file</a>.
 
-{% assign bidder_pages = site.pages | where: "layout", "bidder" | where: "pbs", true %}
+{% assign bidder_pages = site.pages | where: "layout", "bidder" | where: "pbs", true | sort_natural: "title" %}
 
 {: .alert.alert-warning :}
 Publishers are advised to check with legal counsel before doing business with any particular bidder.
 
-## Prebid Server Bidder List
+## Search a Prebid Server bidder
 
-<ul>
+<input type="text" id="autocomplete-filter" class="autocomplete-filter">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/awesomplete/1.1.5/awesomplete.min.js" integrity="sha512-HcBl0GSJvt4Qecm4srHapirUx0HJDi2zYXm6KUKNNUGdTIN9cBwakVZHWmRVj4MKgy1AChqhWGYcMDbRKgO0zg==" crossorigin="anonymous"></script>
+<script>
+var AutocompleteList = [{% for page in bidder_pages %}{ label: '{{ page.title }}', value: '{{ page.url }}' },{% endfor %}];
+</script>
+<script src="{{site.baseurl}}/assets/js/autocomplete.js"></script>
+<div class="c-bidder-list-group" markdown="1">
+
+## Full List
+
+### #-A
+
+<ul class="c-bidder-list">
 {% for page in bidder_pages %}
-<li>
-<a href="#{{ page.biddercode }}">{{ page.title }}</a>
-</li>
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "0" or firstletter == "1" or firstletter == "2" or firstletter == "3" or firstletter == "4" or firstletter == "5" or firstletter == "6" or firstletter == "7" or firstletter == "8" or firstletter == "9" or firstletter == "a" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
 {% endfor %}
 </ul>
 
-## Bidder Documentation
+### B-C
 
+<ul class="c-bidder-list">
 {% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "b" or firstletter == "c" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-<div class="bs-docs-section" markdown="1">
-<a name="{{ page.biddercode }}" ></a>
-<h2>{{ page.title }}</h2>
+### D-G
 
-<h4>Features</h4>
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "d" or firstletter == "e" or firstletter == "f" or firstletter == "g" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-{% include dev-docs/bidder-meta-data.html page=page %}
+### H-L
 
-<h3>"Send All Bids" Ad Server Keys</h3>
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "h" or firstletter == "i" or firstletter == "j" or firstletter == "k" or firstletter == "l" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-<font size="-1">These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.</font>
+### M-O
 
-{: .table .table-bordered .table-striped }
-| <code>{{ "hb_pb_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_bidder_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_adid_" | append: page.biddercode | slice: 0,20 }}</code> |
-| <code>{{ "hb_size_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_source_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_format_" | append: page.biddercode | slice: 0,20 }}</code> |
-| <code>{{ "hb_cache_host_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_cache_id_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_uuid_" | append: page.biddercode | slice: 0,20 }}</code> |
-| <code>{{ "hb_cache_path_" | append: page.biddercode | slice: 0,20 }}</code> | <code>{{ "hb_deal_" | append: page.biddercode | slice: 0,20 }}</code> | |
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "m" or firstletter == "n" or firstletter == "o" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-{% if page.prevBiddercode %}
+### P-R
 
-This bidder previously had a bidder code of `{{ page.prevBiddercode }}`, but prefers new configurations to use `{{ page.biddercode }}`.
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "p" or firstletter == "q" or firstletter == "r" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-{% endif %}
+### S-T
 
-{{ page.content }}
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "s" or firstletter == "t" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
+{% endfor %}
+</ul>
 
-</div>
+### U-Z
 
+<ul class="c-bidder-list">
+{% for page in bidder_pages %}
+  {% assign firstletter = page.title | slice:0 | downcase %}
+  {% unless firstletter == "u" or firstletter == "v" or firstletter == "w" or firstletter == "x" or firstletter == "y" or firstletter == "z" %}{% continue %}{% endunless %}
+  <li>
+  <a href="{{ page.url }}">{{ page.title }}</a>
+  </li>
 {% endfor %}
+</ul>
+</div>

From f37e12a6b22c2314f326f1a7ccbb41df937f0195 Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 13 May 2025 12:33:32 -0400
Subject: [PATCH 136/665] updating algolia api key (#6035)

---
 _includes/body-end.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/body-end.html b/_includes/body-end.html
index e8bcc5edb4..417d319101 100644
--- a/_includes/body-end.html
+++ b/_includes/body-end.html
@@ -1,6 +1,6 @@
 <script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>
 <script type="text/javascript"> docsearch({
-  apiKey: 'a5def27499db73d2fd930c58f8dac145',
+  apiKey: '6f0eda209a805cfa66b415043ab5fbfc',
   appId: 'FN26QH8JE9',
   indexName: 'prebid',
   container: '.pb-header .c-search',

From 09a1508df0e3ebafa32fca0e4e0f52df68c0297b Mon Sep 17 00:00:00 2001
From: tarasmatokhniuk <4teras@gmail.com>
Date: Tue, 13 May 2025 22:05:08 +0200
Subject: [PATCH 137/665] Adtrgtme Bid Adapter: documentation changes (#6034)

---
 dev-docs/bidders/adtrgtme.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/adtrgtme.md b/dev-docs/bidders/adtrgtme.md
index 4b03e6916f..f653b5c584 100644
--- a/dev-docs/bidders/adtrgtme.md
+++ b/dev-docs/bidders/adtrgtme.md
@@ -23,12 +23,13 @@ sidebarType: 1
 
 ### Note
 
-The Adtrgtme bidding adapter requires setup before beginning. Please contact us at <info@adtarget.me>
+The Adtrgtme bidding adapter requires setup before beginning. Please contact us at <support@adtarget.me>
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name      | Scope    | Description | Example      | Type     |
-|-----------|----------|-------------|--------------|----------|
-| `site_id` | required | Site ID     | `1234567890` | `uint64` |
+| Name  | Scope    | Description | Example       | Type     |
+|-------|----------|-------------|---------------|----------|
+| `sid` | required | Site ID     | "1234567890"  | `string` |
+| `zid` | optional | Zone ID     | `1234567890`  | `number` |

From c481c79354e9210ce7fbf859de40e300a0bcb2cc Mon Sep 17 00:00:00 2001
From: Rafael Taveira <103446145+rafataveira@users.noreply.github.com>
Date: Thu, 15 May 2025 00:22:42 -0500
Subject: [PATCH 138/665] Nativo: Updating JS documentation (#6016)

* Added nativo markup documentation to dev-docs/bidders

* Added IAB Global Vendor List ID number.

* Adjusted placementId Type to be integer

* Changed pbjs value to true

* Added optional url parameter

* Updated placementId parameter to be optional

* Added userIds to nativo.md

* Reflecting Prebid Server Adapter metadata

* Update nativo bidder docs

* Add multiformat_supported field to nativo readme

* Nativo: updated documentation

* Nativo: Documentation Update

* Nativo: Documentation Update - after code review.

* Nativo: Fix on Prebid.js param table not rendering correctly

* Nativo: Updating JS documentation

* Nativo: Added new line at EOF

---------

Co-authored-by: Josh <jfledd@gmail.com>
Co-authored-by: jsfledd <jsfledd@users.noreply.github.com>
Co-authored-by: Joshua Fledderjohn <jfledderjohn@nativo.com>
Co-authored-by: Bill Coloe <clowd150@gmail.com>
Co-authored-by: doctafaustus <bcoloe@nativo.com>
---
 dev-docs/bidders/nativo.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/nativo.md b/dev-docs/bidders/nativo.md
index 23d363512a..5e39ab73fa 100644
--- a/dev-docs/bidders/nativo.md
+++ b/dev-docs/bidders/nativo.md
@@ -36,7 +36,8 @@ Prebid Server primarily relies on the OpenRTB specification for its field defini
 #### Prebid JS
 
 {: .table .table-bordered .table-striped }
-| Name       | Scope    | Description                                                                            | Example                                         | Type      |
-|------------|----------|----------------------------------------------------------------------------------------|-------------------------------------------------|-----------|
-| `ntv_url`  | required | Publication url associated with placement IDs within the Nativo platform. |  `https://publication.com/prebid_adpater.html`  | `string`  |
-| `ntv_ptd`  | optional | Refers to a list of Placement IDs assigned by the Nativo platform for the publication. |  `12345678,12345699`   | `array of integer` |
+ | Name          | Scope    | Description                                                                     | Example      | Type      |
+ |---------------|----------|---------------------------------------------------------------------------------|--------------|-----------|
+ | `placementId` | required | Publication placement ID value from the Nativo Platform                         |  `13144370`  | `integer` |
+ | `url`         | optional | Publication url value associated with placement ID value in the Nativo Platform |  `https://test-sites.internal.nativo.net/testing/prebid_adpater.html`  | `string` |
+ 
\ No newline at end of file

From a124b09bfb9cbcaf344e9701450cf8b2459b3f01 Mon Sep 17 00:00:00 2001
From: CPG <matthias@click-performance.com>
Date: Thu, 15 May 2025 14:12:56 +0200
Subject: [PATCH 139/665] Add documentation for new scoremedia aliases (#6037)

* added scoremedia.md documentation

* Update scoremedia.md Test ID
---
 dev-docs/modules/scoremedia.md | 121 +++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 dev-docs/modules/scoremedia.md

diff --git a/dev-docs/modules/scoremedia.md b/dev-docs/modules/scoremedia.md
new file mode 100644
index 0000000000..430c77b423
--- /dev/null
+++ b/dev-docs/modules/scoremedia.md
@@ -0,0 +1,121 @@
+---
+layout: bidder
+title: scoremedia
+description: Prebid scoremedia Bidder Adapter
+pbjs: true
+biddercode: scoremedia
+gvl_id: 965
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | tag ID                     | `"795dtj21"`                             | `string`  |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'scoremedia',
+         params: {
+            tagId: '795dtj21'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'scoremedia',
+            params: {
+               tagId: '795dtj21'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'scoremedia',
+            params: {
+               tagId: '795dtj21'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'scoremedia',
+            params: {
+               tagId: '795dtj21',
+               videoTagId: 'testscore'
+            }
+        }]
+    };
+];
+```

From ac43f93b32befbccae787731e60d0adc358c6a45 Mon Sep 17 00:00:00 2001
From: Pete <petropo@playbuzz.com>
Date: Thu, 15 May 2025 15:16:37 +0300
Subject: [PATCH 140/665] EX.CO adapter: Fix typo in param name (#6038)

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* Update exco bidder documentation

* fix(exco): typo
---
 dev-docs/bidders/exco.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/exco.md b/dev-docs/bidders/exco.md
index 927f18a8d7..e0089d715c 100644
--- a/dev-docs/bidders/exco.md
+++ b/dev-docs/bidders/exco.md
@@ -33,7 +33,7 @@ sidebarType: 1
 | `cId`         | deprecated | The connection ID from Exco.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`         | deprecated | The publisher ID from Exco.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor`    | deprecated | The minimum bid value desired. Exco will not respond with bids lower than this value. | `0.90`                       | `float`  |
-| `accountID`   | required   | A unique account identifier provided by EX.CO.                                        | `'1234567890'`               | `string` |
+| `accountId`   | required   | A unique account identifier provided by EX.CO.                                        | `'1234567890'`               | `string` |
 | `publisherId` | required   | Publisher ID provided by EX.CO.                                                       | `'1234567890'`               | `string` |
 | `tagId`       | required   | A unique Tag ID (supply id) identifier provided by EX.CO.                             | `'1234567890'`               | `string` |
 
@@ -53,7 +53,7 @@ var adUnits = [{
         bids: [{
             bidder: 'exco',
             params: {
-                accountID: '1234567890',   // Required - PROVIDED DURING SETUP...
+                accountId: '1234567890',   // Required - PROVIDED DURING SETUP...
                 publisherId: '1234567890', // Required - PROVIDED DURING SETUP...
                 tagId: '1234567890'        // Required - PROVIDED DURING SETUP...
             }

From 29fba14ba4c94e5a4816ef3533337d568a51999e Mon Sep 17 00:00:00 2001
From: Aaron Price <67345931+AaronColbyPrice@users.noreply.github.com>
Date: Thu, 15 May 2025 05:18:15 -0700
Subject: [PATCH 141/665] Epsilon - removing documentation for analytics as we
 are removing that functionality (#6039)

Co-authored-by: aarprice@publicisgroupe.net <aaron.price@epsilon.com>
---
 dev-docs/analytics/epsilon.md | 47 -----------------------------------
 1 file changed, 47 deletions(-)
 delete mode 100644 dev-docs/analytics/epsilon.md

diff --git a/dev-docs/analytics/epsilon.md b/dev-docs/analytics/epsilon.md
deleted file mode 100644
index bcb05025bf..0000000000
--- a/dev-docs/analytics/epsilon.md
+++ /dev/null
@@ -1,47 +0,0 @@
----
-layout: analytics
-title: Epsilon
-description: Epsilon Prebid Analytics Adapter (formerly Conversant)
-modulecode: conversant
-tcfeu_supported: true
-usp_supported: true
-coppa_supported: false
-prebid_member: true
-gvl_id: 24
-enable_download: true
----
-
-#### Registration
-
-Epsilon (formerly Conversant) analytics adapter requires approval from the
-Epsilon team, even for existing accounts. Please reach out to
-<publishersupport@epsilon.com> for more information.
-
-#### Analytics Options
-
-{: .table .table-bordered .table-striped }
-| Name       | Scope    | Description                                                                 | Example        | Default  |Type     |
-| ---------- | -------- | --------------------------------------------------------------------------- | -------------- | -------- |-------- |
-| site_id | required  | Epsilon site id for the site that will track prebid usage. | 1234  | n/a | integer |
-| cnvr_sampling | optional | Sample rate for analytics data. Value should be between 0 and 1 (inclusive), 0 == never sample,  1 == always sample, 0.5 == send analytics 50% of the time. | 0.5  | 1 | float |
-| send_error_data | optional | Adds extra analytics that tracks script runtime errors, bad data and bidders | true  | false | boolean |
-
-### Example Configuration
-
-Legacy provider code of 'conversant' is still supported
-
-```
-            <!-- should be called before requestBids() -->
-            pbjs.que.push(function(){
-                pbjs.enableAnalytics(
-                    {
-                        provider: 'epsilon',
-                        options: {
-                            site_id: 108060,
-                            cnvr_sampling: 0.5,
-                            send_error_data: true
-                        }
-                    }
-                );
-            });
-```

From b5102a4cd7d0b4ad6ffd1ad4ae968b8b7110a2ac Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 15 May 2025 09:48:45 -0400
Subject: [PATCH 142/665] Update ozone.md: add strictly necessary cookie
 description (#5967)

* Update ozone.md

* Update ozone.md

* Update ozone.md

* Update ozone.md
---
 dev-docs/bidders/ozone.md | 77 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)

diff --git a/dev-docs/bidders/ozone.md b/dev-docs/bidders/ozone.md
index 4f93fc6d09..80bb8470c9 100644
--- a/dev-docs/bidders/ozone.md
+++ b/dev-docs/bidders/ozone.md
@@ -29,6 +29,83 @@ sidebarType: 1
 | `placementId`    | required | The placement ID.  | `"0420420421"` | `string` |
 | `customData`     | optional | publisher key-values used for targeting | `[{"settings":{},"targeting":{"key1": "value1", "key2": "value2"}}],` | `array` |
 
+### Disclosure
+
+```legal
+Ozone Bid Adapter sets cookies without purpose one consent. They support essential technical functions such as load balancing traffic and identifying bot activity. These cookies are not set by Ozone's application but by our cloud providers – Cloudflare for security and performance, and Amazon Web Services for load balancing.
+
+Our immediate recommendation is to include information about these cookies in your CMP and privacy policy. This ensures transparency regarding the essential technical cookies that support site functionality and security. Given the nature and purpose of these cookies, they are typically categorised as strictly necessary and do not require user consent under regulations like GDPR or the ePrivacy Directive.Below is an example entry for your privacy policy:
+
+Strictly Necessary Cookies:
+Our website uses certain cookies that are essential for its operation and security. These cookies are automatically placed on your device when you access the site, ensuring that it functions properly and remains protected from malicious activity.
+
+Cookie Name: __cf_bm
+Provider: Cloudflare
+
+Purpose: This cookie is set by Cloudflare, our security and performance partner. It distinguishes between humans and bots to protect the website from automated malicious traffic. The cookie supports performance optimization and security features such as bot management and threat mitigation.
+
+Duration: Expires after 30 minutes of inactivity
+
+Data Collected: Encrypted, non-personally identifiable information used solely for security and performance purposes. No tracking of users across different websites or sessions.
+
+Consent: As this cookie is strictly necessary for the functioning and security of the website, it is exempt from consent requirements under applicable data protection laws, including the UK GDPR and ePrivacy Directive.
+
+Cookie Names: AWSALBG & AWSALBGTCORS
+Provider: Amazon Web Services (via our load balancing service)
+
+Purpose: These cookies are used to maintain session stickiness for load balancing purposes. When a load balancer receives a client request, it routes the request to a specific target server using a chosen algorithm.
+
+AWSALBG:
+
+Encodes and encrypts information about the selected target server.
+
+Is automatically included in the response to the client with a fixed expiry of 7 days, which is non-configurable.
+
+AWSALBGTCORS:
+
+For cross-origin resource sharing (CORS) requests, some browsers require cookies with SameSite=None; Secure attributes.
+
+This cookie is generated alongside AWSALBG and carries the same target information with the required SameSite attribute.
+
+Duration: Both cookies expire after 7 days.
+
+Data Collected: The cookies store information related to load balancing. The data is encrypted and used solely to ensure consistent session routing.
+
+Consent: As these are strictly necessary technical cookies, they are exempt from user consent requirements under applicable data protection laws.
+
+Technical Breakdown:
+
+__cf_bm:
+Cloudflare’s __cf_bm cookie is used to identify and mitigate automated traffic. It is essential for Cloudflare’s bot management and threat mitigation functions. Each end-user device visiting a protected site gets a unique __cf_bm cookie that expires after 30 minutes of inactivity. The content (except for time-related data) is encrypted and used only for computing a proprietary bot score and a session identifier if Anomaly Detection is enabled.
+
+AWSALBG & AWSALBGTCORS:
+When Amazon Web Services' load balancer receives a request, it routes the request to a target server based on a predetermined algorithm. The AWSALBG cookie encodes and encrypts information about the selected target server and is set with a fixed expiry of 7 days. For browsers that require cookies with SameSite=None; Secure attributes to support CORS, the AWSALBGTCORS cookie is generated alongside AWSALBG, containing the same target information with the necessary security attributes.
+```
+
+To require purpose one consent for Ozone, one could include the following
+
+```javascript
+pbjs.setConfig({
+    allowActivities: {
+        fetchBids: {
+            rules: [
+                {
+                    condition({componentType, adapterCode, gdprConsent}) {
+                        return (
+                            componentType === 'bidder' &&
+                            adapterCode === 'ozone' &&
+                            gdprConsent?.gdprApplies &&
+                            !gdprConsent?.vendorData?.purpose?.consents?.[1]
+                        )
+                    },
+                    allow: false
+                }
+            ]
+        }
+    }
+})
+```
+
 ### Test Parameters
 
 A test ad unit that will consistently return test creatives:

From 8603791bc107bf1fc3831317b78bd2c59db1b3bc Mon Sep 17 00:00:00 2001
From: "Evgen A. Epanchin" <Epanchine@gmail.com>
Date: Thu, 15 May 2025 16:51:21 +0300
Subject: [PATCH 143/665] Docs update: support LoopMe Prebid.js bid adapter
 (#6023)

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

diff --git a/dev-docs/bidders/loopme.md b/dev-docs/bidders/loopme.md
index 662ba301a4..3caa15cc04 100644
--- a/dev-docs/bidders/loopme.md
+++ b/dev-docs/bidders/loopme.md
@@ -9,7 +9,7 @@ coppa_supported: true
 tcfeu_supported: true
 usp_supported: true
 prebid_member: false
-pbjs: false
+pbjs: true
 pbs: true
 schain_supported: true
 floors_supported: true

From fdac1d732fd8ec3a7b7e092297f349f15b7ae649 Mon Sep 17 00:00:00 2001
From: ysfbsf <youssef.bsf@gmail.com>
Date: Thu, 15 May 2025 14:54:17 +0100
Subject: [PATCH 144/665] Docs/update missena params (#6013)

* New Prebid Server Adapter: Missena

* set prebid_member to true

* Add pbs: true to the metadata

* Update Missena bidder docs with formats and settings parameters
---
 dev-docs/bidders/missena.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/missena.md b/dev-docs/bidders/missena.md
index d6c2ddcc7b..9d6c7c2e8a 100644
--- a/dev-docs/bidders/missena.md
+++ b/dev-docs/bidders/missena.md
@@ -23,3 +23,5 @@ The Missena Bidding adapter requires setup before beginning. Please contact us a
 |------------|----------|----------------------------|-----------------|----------|
 | `apiKey`   | required | Missena's publisher token  | `'PA-34745704'` | `string` |
 | `placement`   | optional | Placement Type, default: 'sticky' | `'sticky'` | `string` |
+| `formats`  | optional | An array of formats to request (banner, native, or video) | `['banner', 'video']` | `array` |
+| `settings` | optional | An object containing extra settings for the Missena adapter | `{ settingName: 'value' }` | `object` |

From f7c3b65baa0ee3df13ba46de43fd34c118648682 Mon Sep 17 00:00:00 2001
From: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
Date: Thu, 15 May 2025 16:19:01 +0200
Subject: [PATCH 145/665] Basic example with debugging module instead of
 AppNexus placement (#5995)

* Basic example with debugging module instead of AppNexus placement

Fix issue : https://github.com/prebid/prebid.github.io/issues/5614

* Update dev-docs/examples/intercept-banner-not-for-prod.js

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/examples/basic-example.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/examples/intercept-banner-not-for-prod.js

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/examples/basic-example.md               | 12 +++++++++---
 .../examples/intercept-banner-not-for-prod.js    | 16 ++++++++++++++++
 2 files changed, 25 insertions(+), 3 deletions(-)
 create mode 100644 dev-docs/examples/intercept-banner-not-for-prod.js

diff --git a/dev-docs/examples/basic-example.md b/dev-docs/examples/basic-example.md
index 6ee2ec1203..1c22ec8ac6 100644
--- a/dev-docs/examples/basic-example.md
+++ b/dev-docs/examples/basic-example.md
@@ -16,7 +16,12 @@ pid: 10
 
 ## Basic Prebid.js Example
 
-{% capture htmlCodePrebid %}<h5>Div-1</h5>
+{% capture htmlCodePrebid %}
+<!-- DO NOT add this script in prod -->
+<script src="intercept-banner-not-for-prod.js" ></script>
+<!-- END -->
+
+<h5>Div-1</h5>
 <div id='div-1' style="min-height:250px;">
   <script type='text/javascript'>
     googletag.cmd.push(function() {
@@ -26,7 +31,8 @@ pid: 10
 </div>
 {% endcapture %}
 
-{% capture jsCode %}var sizes = [
+{% capture jsCode %}
+var sizes = [
   [300, 250]
 ];
 var PREBID_TIMEOUT = 700;
@@ -41,7 +47,7 @@ var adUnits = [{
   bids: [{
     bidder: 'appnexus',
     params: {
-      placementId: 13144370
+      placementId: 'XXXXXXX' //not used in prod
     }
   }]
 }];
diff --git a/dev-docs/examples/intercept-banner-not-for-prod.js b/dev-docs/examples/intercept-banner-not-for-prod.js
new file mode 100644
index 0000000000..a881714fc0
--- /dev/null
+++ b/dev-docs/examples/intercept-banner-not-for-prod.js
@@ -0,0 +1,16 @@
+window.pbjs = window.pbjs || { que: [] };
+pbjs.que.push(() => {
+    pbjs.setConfig({
+       debugging: {
+           enabled: true,
+           intercept: [{
+               when: {
+                     bidder: 'appnexus',
+               },
+               then: {
+                     ad: '<html><body><img src="https://files.prebid.org/creatives/prebid300x250.png" width="300" height="250" /></body></html>'
+               }
+           }]
+       }
+    })
+ })
\ No newline at end of file

From 2641987ca6abe9442187ae1b8bbd0b2a38c9605b Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Wed, 21 May 2025 21:49:13 -0700
Subject: [PATCH 146/665] docs for gzip support for bid requests (#6011)

---
 dev-docs/bidder-adaptor.md   | 14 ++++++++++++++
 dev-docs/bidders/pubmatic.md |  4 ++++
 2 files changed, 18 insertions(+)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index bfa42399c3..cce24c4cf6 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -271,6 +271,20 @@ Building the request will use data from several places:
 * **BidRequest Params**: Several important parameters such as first-party data, userId, GDPR, USP, and supply chain values are on the `bidderRequest` object.
 * **Prebid Config**: Publishers can set a number of config values that bid adapters should consider reading.
 
+#### Compression Support for Outgoing Requests
+
+Prebid.js core now includes support for gzip compression of bidder request payloads (This helps reduce payload size and improve performance).
+
+Prebid will pass compressed payloads if the following criteria are met:
+
+* `request.options.endpointCompression = true` is set by a bidder with outgoing requests (An example of this can be viewed [here](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
+* The browser supports gzip compression (Prebid core has a built-in utility function to check this)
+* Participating bidders have implemented compression support on their server-side endpoint
+
+If the above criteria is met, the new Gzip compression can be utilized.
+
+Note: If the Prebid.js debugging query param `?pbjs_debug=true` is present in the URL or `debug: true` has been configured in `pbjs.setConfig()`, the gzip compression feature will be disabled and all bidder requests will be sent uncompressed.
+
 #### Ad Unit Params in the validBidRequests Array
 
 Here is a sample array entry for `validBidRequests[]`:
diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 6f1ace23e7..24b1e44080 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -226,4 +226,8 @@ Publishers should use the `ortb2` method of setting [First Party Data](https://d
 - `ortb2.user.*`
 
 AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
+
+### Endpoint Compression
+
+This adapter utilizes gzip compression support built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests)
 <!-- workaround bug where code blocks at end of a file are incorrectly formatted-->

From caba1c6b90636d42f29c7a6d2575c8b409d711bb Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Thu, 22 May 2025 09:58:38 -0700
Subject: [PATCH 147/665] updated gzip doc text (#6045)

---
 dev-docs/bidder-adaptor.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index cce24c4cf6..bb801437f8 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -277,9 +277,9 @@ Prebid.js core now includes support for gzip compression of bidder request paylo
 
 Prebid will pass compressed payloads if the following criteria are met:
 
-* `request.options.endpointCompression = true` is set by a bidder with outgoing requests (An example of this can be viewed [here](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
-* The browser supports gzip compression (Prebid core has a built-in utility function to check this)
-* Participating bidders have implemented compression support on their server-side endpoint
+* Participating bidders must implement compression support on their server-side endpoint before making a change in their bid adapter in Prebid.js
+* Once server-side support is present, `request.options.endpointCompression = true` needs to be set for a bidder's outgoing requests within their Prebid.js bid adapter (An example of this can be viewed [here](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
+* The browser must support gzip compression (Prebid core has a built-in utility function to check this)
 
 If the above criteria is met, the new Gzip compression can be utilized.
 

From c4d415f6f8adb3301dea4e94f6ea434890c805cf Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Thu, 22 May 2025 13:37:15 -0700
Subject: [PATCH 148/665] updated gzip docs to add a few more details (#6046)

* updated gzip docs to add a few more details
* fixed markdown linter error
---
 dev-docs/bidder-adaptor.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index bb801437f8..d331ec25df 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -281,7 +281,11 @@ Prebid will pass compressed payloads if the following criteria are met:
 * Once server-side support is present, `request.options.endpointCompression = true` needs to be set for a bidder's outgoing requests within their Prebid.js bid adapter (An example of this can be viewed [here](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
 * The browser must support gzip compression (Prebid core has a built-in utility function to check this)
 
-If the above criteria is met, the new Gzip compression can be utilized.
+If the above criteria is met, Prebid.js core will do the following:
+
+* Gzip compress the request payload
+* Set the `Content-Type` header to `plain/text` (to avoid a preflight request)
+* Append the `gzip=1` query param to the bidder request (to signal to a bidder's server-side endpoint that the request is compressed)
 
 Note: If the Prebid.js debugging query param `?pbjs_debug=true` is present in the URL or `debug: true` has been configured in `pbjs.setConfig()`, the gzip compression feature will be disabled and all bidder requests will be sent uncompressed.
 

From 474224f531e58310a87bcbb9869d8af21d998210 Mon Sep 17 00:00:00 2001
From: Antonios Sarhanis <antonios@adnuntius.com>
Date: Sat, 24 May 2025 00:17:17 +1000
Subject: [PATCH 149/665] Adds Adnuntius analytics documentation. (#5726)

---
 dev-docs/analytics/adnuntius.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 dev-docs/analytics/adnuntius.md

diff --git a/dev-docs/analytics/adnuntius.md b/dev-docs/analytics/adnuntius.md
new file mode 100644
index 0000000000..f974eb229f
--- /dev/null
+++ b/dev-docs/analytics/adnuntius.md
@@ -0,0 +1,13 @@
+---
+layout: analytics
+title: Adnuntius
+description: Adnuntius Analytics Adapter
+modulecode: adnuntius
+prebid_member: true
+---
+
+#### Registration
+
+Best used for debugging, especially how the Adnuntius bid adapter interacts with the LiveWrapped analytics adapter and its metrics.
+
+Please visit [adnuntius.com/](https://adnuntius.com/) for more information.

From 42be01b1530220f544cfbc4bf966e48b4bf3b205 Mon Sep 17 00:00:00 2001
From: Saar Amrani <saar120@gmail.com>
Date: Fri, 23 May 2025 17:21:08 +0300
Subject: [PATCH 150/665] Add OpaMarketplace bidder adapter documentation
 (#5999)

---
 dev-docs/bidders/opamarketplace.md | 72 ++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 dev-docs/bidders/opamarketplace.md

diff --git a/dev-docs/bidders/opamarketplace.md b/dev-docs/bidders/opamarketplace.md
new file mode 100644
index 0000000000..ae83a56adc
--- /dev/null
+++ b/dev-docs/bidders/opamarketplace.md
@@ -0,0 +1,72 @@
+---
+layout: bidder
+title: OpaMarketplace
+description: PrebidOpaMarketplace Bidder Adaptor
+biddercode: opamarketplace
+filename: opaMarketplaceBidAdapter
+userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: false
+schain_supported: true
+gpp_supported: true
+floors_supported: true
+media_types: banner, video
+prebid_member: false
+safeframes_ok: false
+deals_supported: false
+pbs_app_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+pbjs: true
+pbs: false
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name       | Scope    | Description                                                                                     | Example                      | Type     |
+|------------|----------|-------------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from OpaMarketplace.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`      | required | The publisher ID from OpaMarketplace (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. OpaMarketplace will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+### Example
+
+  ```javascript
+var adUnits = [{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [728, 90]
+            ]
+        }
+    },
+    bids: [{
+        bidder: 'opamarketplace',
+        params: {
+            cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
+            pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
+            bidFloor: 1.23                   // Optional
+        }
+    }]
+}
+];
+
+// configure pbjs to enable user syncing
+pbjs.setConfig({
+    userSync: {
+        filterSettings: {
+            iframe: {
+                bidders: 'opamarketplace',
+                filter: 'include'
+            }
+        }
+    }
+});
+```

From 1da1c51e45f4d27a331e093a73ea2061914d7161 Mon Sep 17 00:00:00 2001
From: madmazoku <madmazoku@gmail.com>
Date: Fri, 23 May 2025 18:25:35 +0400
Subject: [PATCH 151/665] 8538: video media type will be supported in
 mediaforce bid adapter (#6033)

Co-authored-by: Dmitry Moskalyov <dmoskalyov@iponweb.net>
---
 dev-docs/bidders/mediaforce.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/mediaforce.md b/dev-docs/bidders/mediaforce.md
index 3d1c154804..dd5cebd85c 100644
--- a/dev-docs/bidders/mediaforce.md
+++ b/dev-docs/bidders/mediaforce.md
@@ -2,7 +2,7 @@
 layout: bidder
 title: MediaForce
 description: MediaForce Prebid Bidder Adapter
-media_types: banner, native 
+media_types: banner, native, video
 biddercode: mediaforce
 pbjs: true
 tcfeu_supported: false

From 0042ee2457b13061630c3b5a222b5c502c1c66ca Mon Sep 17 00:00:00 2001
From: Stav Ben Shlomo <137684171+StavBenShlomoBrowsi@users.noreply.github.com>
Date: Fri, 23 May 2025 17:30:00 +0300
Subject: [PATCH 152/665] browsi rtd provider fixes (#6024)

Co-authored-by: Stav Ben Shlomo <stavbe@gobrowsi.com>
---
 dev-docs/modules/browsiRtdProvider.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/browsiRtdProvider.md b/dev-docs/modules/browsiRtdProvider.md
index f18ec77705..737177d3a6 100644
--- a/dev-docs/modules/browsiRtdProvider.md
+++ b/dev-docs/modules/browsiRtdProvider.md
@@ -21,9 +21,10 @@ sidebarType : 1
 
 Browsi’s RTD module for Prebid.js provides real-time insights and predictive signals to optimize bid requests and ad delivery.
 This module leverages Browsi's AI models to give publishers access to:
--**Real-time predictions for GAM:** Enhance ad placements and maximize revenue by leveraging viewability and revenue predictions as key values in GAM ad requests.
--**Enhanced bid request signals**: Augment bid requests with additional contextual, behavioral, and engagement signals to improve demand partner performance.
--**Dynamic ad serving optimization**: Enable smarter ad delivery strategies based on predicted user behavior and page context.
+
+* **Real-time predictions for GAM**: Enhance ad placements and maximize revenue by leveraging viewability and revenue predictions as key values in GAM ad requests.
+* **Enhanced bid request signals**: Augment bid requests with additional contextual, behavioral, and engagement signals to improve demand partner performance.
+* **Dynamic ad serving optimization**: Enable smarter ad delivery strategies based on predicted user behavior and page context.
 
 ## Integration
 

From a419bac3a63615de604d2cfcdc002f833368adcf Mon Sep 17 00:00:00 2001
From: CPG <matthias@click-performance.com>
Date: Fri, 23 May 2025 16:40:04 +0200
Subject: [PATCH 153/665] added spm.md documentation (#6025)

---
 dev-docs/modules/spm.md | 121 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 dev-docs/modules/spm.md

diff --git a/dev-docs/modules/spm.md b/dev-docs/modules/spm.md
new file mode 100644
index 0000000000..15f6ab7a41
--- /dev/null
+++ b/dev-docs/modules/spm.md
@@ -0,0 +1,121 @@
+---
+layout: bidder
+title: Sportplatz Media
+description: Prebid spm Bidder Adapter
+pbjs: true
+biddercode: spm
+gvl_id: 965
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | tag ID                     | `"n1x53vta"`                             | `string`  |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'spm',
+         params: {
+            tagId: 'n1x53vta'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'spm',
+            params: {
+               tagId: 'n1x53vta'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'spm',
+            params: {
+               tagId: 'n1x53vta'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'spm',
+            params: {
+               tagId: 'n1x53vta',
+               videoTagId: 'n1x53vta'
+            }
+        }]
+    };
+];
+```

From 3af802c0d6e9e76128b4b99d1018fedde6fc2968 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 26 May 2025 01:19:09 -0400
Subject: [PATCH 154/665] docs: fix various typos (#6055)

---
 dev-docs/activity-controls.md                                 | 2 +-
 dev-docs/bidder-adaptor.md                                    | 4 ++--
 dev-docs/bidders/smartx.md                                    | 4 ++--
 .../modules/rendering/android-sdk-integration-admob.md        | 2 +-
 prebid-mobile/pbm-api/android/pbm-targeting-android.md        | 4 ++--
 prebid-mobile/pbm-api/ios/code-integration-ios.md             | 2 +-
 prebid-mobile/pbm-api/ios/pbm-targeting-ios.md                | 4 ++--
 prebid-mobile/pbm-api/ios/pbm-util-ios.md                     | 4 ++--
 .../subrecipes/android/gam-bidding-only-multiformat.md        | 2 +-
 .../recipes/subrecipes/ios/gam-bidding-only-html-banner.md    | 2 +-
 .../recipes/subrecipes/ios/gam-bidding-only-multiformat.md    | 4 ++--
 prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md      | 2 +-
 prebid-server/endpoints/openrtb2/pbs-endpoint-video.md        | 2 +-
 prebid-server/features/pbs-default-request.md                 | 2 +-
 prebid-server/use-cases/pbs-lfv.md                            | 2 +-
 15 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/dev-docs/activity-controls.md b/dev-docs/activity-controls.md
index 6642727951..488254fda9 100644
--- a/dev-docs/activity-controls.md
+++ b/dev-docs/activity-controls.md
@@ -235,7 +235,7 @@ If `allow` is not defined, the rule is assumed to assert **true** (i.e. allow th
 
 #### Always include a particular bidder in auctions
 
-This is similiar to the 'vendor exception' feature of the [TCF Control Module](/dev-docs/modules/tcfControl.html). This would always allow bidderA to participate in the auction, even without explicit consent in GDPR scenarios. It might indicate, for instance, that this is a 'first party bidder'.
+This is similar to the 'vendor exception' feature of the [TCF Control Module](/dev-docs/modules/tcfControl.html). This would always allow bidderA to participate in the auction, even without explicit consent in GDPR scenarios. It might indicate, for instance, that this is a 'first party bidder'.
 
 ```javascript
 pbjs.setConfig({
diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index d331ec25df..ed4b10c34e 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -650,7 +650,7 @@ Sample data received by this function:
 
 The `onBidBillable` function will be called when it deems a bid to be billable. When a bid wins, it is by default also billable. That is, by default, onBidWon and onBidBillable will be called one after the other. However, a publisher can flag adUnits as being separately billable: `pbjs.addAdUnits({deferBilling: true, ...})`. Winning bids for adUnits with `deferBilling` set to true, trigger the onBidWon function but not the onBidBillable function. When appropriate (e.g. an interstitial is displayed), the publisher may then call the public API method, `pbjs.triggerBilling(winningBidObjectToBill)` passing the winning bid to be billed, which will trigger onBidBillable.
 
-Sample data received by this function (same as what is recieved for onBidWon):
+Sample data received by this function (same as what is received for onBidWon):
 
 ```javascript
 {
@@ -814,7 +814,7 @@ If your adapter supports banner and video media types, make sure to include `'ba
 
 ### Step 2: Accept video parameters and pass them to your server
 
-Video parameters are often passed in from the ad unit in a `video` object. As of Prebid 4.0 the following paramters should be read from the ad unit when available; bidders can accept overrides of the ad unit on their bidder configuration parameters but should read from the ad unit configuration when their bidder parameters are not set. Parameters one should expect on the ad unit include:
+Video parameters are often passed in from the ad unit in a `video` object. As of Prebid 4.0 the following parameters should be read from the ad unit when available; bidders can accept overrides of the ad unit on their bidder configuration parameters but should read from the ad unit configuration when their bidder parameters are not set. Parameters one should expect on the ad unit include:
 
 * mimes
 * minduration
diff --git a/dev-docs/bidders/smartx.md b/dev-docs/bidders/smartx.md
index fc028e4483..0ea90f90c4 100644
--- a/dev-docs/bidders/smartx.md
+++ b/dev-docs/bidders/smartx.md
@@ -65,6 +65,6 @@ This adapter requires setup and approval from the smartclip team. Please contact
 | `title`         | optional | The player can show a freely definable text, a macro `[remainingTime]` in this string will be replaced with the remaining play time of the ad in seconds. | `'Advertisement [remainingTime]s'` | `string`    |
 | `skipOffset`    | optional | In order to enable skipping from the start set the delay to `0`, to show the skip button after 5 seconds set it to `5`. Setting a general skipOffset is discouraged. Note that linear creatives carrying a skipsoffet attribute will override the general player setting. By default the player does not set a general skipoffset, so a skip button will only be shown, if an ad has a specific skipoffset attached. |  `0`  | `integer`   |
 | `startOpen`     | optional | Per default the player will start fully expanded, if a valid ad can be played. Setting this option to `false` will trigger an expand animation instead once the player comes into view. Default is `true`.              | `'false'`        | `string`    |
-| `endingScreen`  | optional | By default the player will not close, but show the ending screen when an advertisement is complete (last frame of the ad and a replay button, if an advertisment comes with an endcard that will be shown). If set to `false` the player will collapse. Some VPAID creatives can cause issues with ending screen or replay behaviour. Default is `true`.              | `'true'`         | `string`    |
+| `endingScreen`  | optional | By default the player will not close, but show the ending screen when an advertisement is complete (last frame of the ad and a replay button, if an advertisement comes with an endcard that will be shown). If set to `false` the player will collapse. Some VPAID creatives can cause issues with ending screen or replay behaviour. Default is `true`.              | `'true'`         | `string`    |
 | `desiredBitrate`| optional | You can specify a target bitrate for the creative, higher values will increase video quality but will cost bandwidth. Value is given in kpbs. Default is `700`.                       | `800`            | `integer`   |
-| `visibilityThreshold`| optional | Defines the percentage of the player which has to be in the visible area to play and pause the advertisment. The default is `50`.                           | `50`             | `integer`   |
+| `visibilityThreshold`| optional | Defines the percentage of the player which has to be in the visible area to play and pause the advertisement. The default is `50`.                           | `50`             | `integer`   |
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
index a4e5c75ba4..a8c3393375 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
@@ -315,7 +315,7 @@ Prepare the `AdLoader` and `AdRequest` objects before you make the bid request.
 #### Step 2: Create NativeAdUnit
 {:.no_toc}
 
-The `NativeAdUnit` is responsible for making bid requests. Once the bid responce is received you can load an ad from AdMob.
+The `NativeAdUnit` is responsible for making bid requests. Once the bid response is received you can load an ad from AdMob.
 
 #### Step 3: Configure NativeAdUnit
 {:.no_toc}
diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 9ecf41c3d4..8426565ed9 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -447,9 +447,9 @@ Since version 2.0.6, Prebid SDK reads and sends GPP signals:
 ## Open Measurement SDK (OMSDK) API
 
 {: .alert.alert-info :}
-Defining OMSDK values is only relevant for the 'Bidding-Only' Prebid integration with GAM. In this case the creative is rendered by GMA SDK and publishers should provide OMID description in the bid request. If you use Prebid SDK as a rendering engine you shouldn’t use these properties -- it sends them automaticaly according to the current OMID setup.
+Defining OMSDK values is only relevant for the 'Bidding-Only' Prebid integration with GAM. In this case the creative is rendered by GMA SDK and publishers should provide OMID description in the bid request. If you use Prebid SDK as a rendering engine you shouldn’t use these properties -- it sends them automatically according to the current OMID setup.
 
-OMSDK is designed to facilitate 3rd party viewability and verification measurement for ads served in mobile app enviroments. Prebid SDK will provide the signaling component to Bid Adapters by way of Prebid Server, indicating that the impression is eligible for OMSDK support. Prebid SDK does not currently integrate with OMSDK itself, instead it will rely on a publisher ad server to render viewability and verification measurement code.
+OMSDK is designed to facilitate 3rd party viewability and verification measurement for ads served in mobile app environments. Prebid SDK will provide the signaling component to Bid Adapters by way of Prebid Server, indicating that the impression is eligible for OMSDK support. Prebid SDK does not currently integrate with OMSDK itself, instead it will rely on a publisher ad server to render viewability and verification measurement code.
 
 There are three components to signaling support for OMSDK:
 
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index 77bfb60169..6f0b421cc8 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -392,7 +392,7 @@ Prebid.shared.logLevel = .verbose
 // Set Prebid timeout in milliseconds
 Prebid.shared.timeoutMillis = 3000
 
-// Enable Prebid Server debug respones
+// Enable Prebid Server debug responses
 Prebid.shared.pbsDebug = true
 
 // Stored responses  can be one of storedAuction response or storedBidResponse
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index 09133e285b..cc45afcca3 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -318,9 +318,9 @@ Since version 2.0.6, Prebid SDK reads and sends GPP signals:
 ## Open Measurement SDK (OMSDK) API
 
 {: .alert.alert-info :}
-Defining OMSDK values is only relevant for the 'Bidding-Only' Prebid integration with GAM. In this case the creative is rendered by GMA SDK and publishers should provide OMID description in the bid request. If you use Prebid SDK as a rendering engine you shouldn’t use these properties -- it sends them automaticaly according to the current OMID setup.
+Defining OMSDK values is only relevant for the 'Bidding-Only' Prebid integration with GAM. In this case the creative is rendered by GMA SDK and publishers should provide OMID description in the bid request. If you use Prebid SDK as a rendering engine you shouldn’t use these properties -- it sends them automatically according to the current OMID setup.
 
-OMSDK is designed to facilitate 3rd party viewability and verification measurement for ads served in mobile app enviroments. Prebid SDK will provide the signaling component to Bid Adapters by way of Prebid Server, indicating that the impression is eligible for OMSDK support. Prebid SDK does not currently integrate with OMSDK itself, instead it will rely on a publisher ad server to render viewability and verification measurement code.
+OMSDK is designed to facilitate 3rd party viewability and verification measurement for ads served in mobile app environments. Prebid SDK will provide the signaling component to Bid Adapters by way of Prebid Server, indicating that the impression is eligible for OMSDK support. Prebid SDK does not currently integrate with OMSDK itself, instead it will rely on a publisher ad server to render viewability and verification measurement code.
 
 There are three components to signaling support for OMSDK:
 
diff --git a/prebid-mobile/pbm-api/ios/pbm-util-ios.md b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
index f823559914..afdc97915d 100755
--- a/prebid-mobile/pbm-api/ios/pbm-util-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
@@ -31,7 +31,7 @@ func bannerViewDidReceiveAd(_ bannerView: GoogleMobileAds.BannerView) {
         // In the case of Prebid's line item - resize te ad view
         bannerView.resize(adSizeFor(cgSize: size))
     }, failure: { (error) in
-        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+        PrebidDemoLogger.shared.error("Error occurring during searching for Prebid creative size: \(error)")
     })
 }
 {% endcapture %}
@@ -44,7 +44,7 @@ func bannerViewDidReceiveAd(_ bannerView: GoogleMobileAds.BannerView) {
         // In the case of Prebid's line item - resize te ad view
         bannerView.resize(GADAdSizeFromCGSize(size))
     }, failure: { (error) in
-        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+        PrebidDemoLogger.shared.error("Error occurring during searching for Prebid creative size: \(error)")
     })
 }
 {% endcapture %}
diff --git a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-multiformat.md b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-multiformat.md
index ecd7a5bae4..da3d70d6d8 100644
--- a/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-multiformat.md
+++ b/prebid-mobile/recipes/subrecipes/android/gam-bidding-only-multiformat.md
@@ -98,7 +98,7 @@ private fun createNativeParameters(): NativeParameters {
 }
 ```
 
-If you use Custom Native Ads follow the [guide](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/native-banner) on how to implement processing of the ad response of the respective type. The following code snipet demonstrates how you can process the banner, video and in-banner native (Native Styles) ad resposnse:
+If you use Custom Native Ads follow the [guide](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/native-banner) on how to implement processing of the ad response of the respective type. The following code snippet demonstrates how you can process the banner, video and in-banner native (Native Styles) ad response:
 
 ``` kotlin
 private fun loadGam(gamRequest: AdManagerAdRequest) {
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
index 7131ef68cc..b73f4cd4b0 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-html-banner.md
@@ -85,7 +85,7 @@ In case you use a single-size banner (e.g., 300x250), you don't need to make a c
         guard let bannerView = bannerView as? AdManagerBannerView else { return }
         bannerView.resize(adSizeFor(cgSize: size))
     }, failure: { (error) in
-        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+        PrebidDemoLogger.shared.error("Error occurring during searching for Prebid creative size: \(error)")
     })
 }
 {% endcapture %}
diff --git a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
index 9340f40d92..275c84a54a 100644
--- a/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
+++ b/prebid-mobile/recipes/subrecipes/ios/gam-bidding-only-multiformat.md
@@ -118,7 +118,7 @@ To handle the banner, video and in-banner native (Native Styles) ads:
         self?.bannerView.constraints.first { $0.firstAttribute == .width }?.constant = size.width
         self?.bannerView.constraints.first { $0.firstAttribute == .height }?.constant = size.height
     }, failure: { (error) in
-        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+        PrebidDemoLogger.shared.error("Error occurring during searching for Prebid creative size: \(error)")
     })
 }
 {% endcapture %}
@@ -134,7 +134,7 @@ To handle the banner, video and in-banner native (Native Styles) ads:
         self?.bannerView.constraints.first { $0.firstAttribute == .width }?.constant = size.width
         self?.bannerView.constraints.first { $0.firstAttribute == .height }?.constant = size.height
     }, failure: { (error) in
-        PrebidDemoLogger.shared.error("Error occuring during searching for Prebid creative size: \(error)")
+        PrebidDemoLogger.shared.error("Error occurring during searching for Prebid creative size: \(error)")
     })
 }
 {% endcapture %}
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index fdf2554860..ee304bea86 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -1414,7 +1414,7 @@ For example, this request:
           },
           "storedbidresponse": [
             { "bidder": "BidderA", "id": "5555555", "replaceimpid":true }
-            // note: no storedbidrespose for bidderB
+            // note: no storedbidresponse for bidderB
           ]
         }
       }
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
index c9ab121cf1..b098600c34 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
@@ -25,7 +25,7 @@ The process is similar to [Prebid.js client side](/prebid-video/video-long-form.
 1. Application makes request for a video stream.
 2. An SSAI Server sends a video request to PBS, specifying the pod requirements.
 3. PBS sends a request for bids to selected demand partners by relaying OpenRTB requests to them.
-4. Demand partners return a bid response to PBS. If competitive seperation is enabled, PBS peforms [category translation](/dev-docs/modules/categoryTranslation.html) on each bid. Whether category translation is required or not, the bids are stored in prebid cache.
+4. Demand partners return a bid response to PBS. If competitive separation is enabled, PBS performs [category translation](/dev-docs/modules/categoryTranslation.html) on each bid. Whether category translation is required or not, the bids are stored in prebid cache.
 5. PBS generates key-value pairs that are comprised of price, category, and duration values. The key is `hb_pb_cat_dur` and each component of the key name after the `hb` represents a related value.  
 &nbsp;&nbsp;&nbsp;&nbsp;
 &nbsp;&nbsp;&nbsp;&nbsp;  `_pb` represents the price bucket.
diff --git a/prebid-server/features/pbs-default-request.md b/prebid-server/features/pbs-default-request.md
index d11b01a092..5053f8401d 100644
--- a/prebid-server/features/pbs-default-request.md
+++ b/prebid-server/features/pbs-default-request.md
@@ -6,7 +6,7 @@ title: Prebid Server | Developers | Default Request
 
 # Server Based Global Default Request
 
-This allows a defaut stored request to be defined that allows the server to set up some defaults for all incoming requests. A request specified stored request will override these defaults, and of course any options specified directly in the stored request override both. The default stored request is only read on server startup, it is meant as an installation static default rather than a dynamic tuning option.
+This allows a default stored request to be defined that allows the server to set up some defaults for all incoming requests. A request specified stored request will override these defaults, and of course any options specified directly in the stored request override both. The default stored request is only read on server startup, it is meant as an installation static default rather than a dynamic tuning option.
 
 A common use case is to "hard code" aliases into the server. This saves having to specify them on all incoming requests, and/or on all stored requests. To help support automation and alias discovery we can flag that any aliases found in the file be added to the bidder info endpoints.
 
diff --git a/prebid-server/use-cases/pbs-lfv.md b/prebid-server/use-cases/pbs-lfv.md
index f61c5e085e..39b75fc421 100644
--- a/prebid-server/use-cases/pbs-lfv.md
+++ b/prebid-server/use-cases/pbs-lfv.md
@@ -22,7 +22,7 @@ Here's a workflow diagramming how this works.
 1. Application makes request for a video stream.
 2. An SSAI Server sends a video request to PBS, specifying the pod requirements.
 3. PBS sends a request for bids to selected demand partners by relaying OpenRTB requests to them.
-4. Demand partners return a bid response to PBS. If competitive seperation is enabled, PBS peforms [category translation](/dev-docs/modules/categoryTranslation.html) on each bid. Whether category translation is required or not, the bids are stored in prebid cache.
+4. Demand partners return a bid response to PBS. If competitive separation is enabled, PBS performs [category translation](/dev-docs/modules/categoryTranslation.html) on each bid. Whether category translation is required or not, the bids are stored in prebid cache.
 5. PBS generates key-value pairs that are comprised of price, category, and duration values.
 6. The SSAI server parses the returned key-values, appending them as a query string to the ad server request URL and submits the request.
 7. The ad server returns the optimized pod.

From 74917cb1d7b435f3c238f7a8ff4f887909053e53 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 26 May 2025 12:50:43 -0400
Subject: [PATCH 155/665] Fix markdownlint issues (#6061)

---
 dev-docs/publisher-api-reference/setConfig.md |  2 +-
 policies/privacy.md                           |  2 +-
 prebid-video/video-getting-started.md         |  2 +-
 prebid-video/video-long-form.md               |  2 +-
 prebid/events.md                              |  2 +-
 prebid/native-implementation.md               |  5 +++-
 support/privacy-resources.md                  |  3 +++
 tools/line-item-manager.md                    | 26 +++++++++----------
 troubleshooting/troubleshooting-guide.md      |  1 +
 9 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index f51cedf27a..814c50982c 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1191,7 +1191,7 @@ pbjs.setConfig({
 });
 ```
 
-More examples [here](/dev-docs/modules/instreamTracking.html#example-with-urlpattern).
+More examples can be found in [the instream tracking module documentation](/dev-docs/modules/instreamTracking.html#example-with-urlpattern).
 
 <a name="setConfig-site"></a>
 
diff --git a/policies/privacy.md b/policies/privacy.md
index 28ea7c1c71..07a9993f65 100644
--- a/policies/privacy.md
+++ b/policies/privacy.md
@@ -117,7 +117,7 @@ In addition, if you are a resident of the European Economic Area, you have the f
 
 * You may object to processing of your personal information, ask us to restrict processing of your personal information or request portability or correction of your personal information. Again, you can exercise these rights by contacting us using the contact details provided under the ["How to contact us"](#contact) heading below.
 * If we have collected and processed your personal information with your consent, then you can withdraw your consent at any time.  Withdrawing your consent will not affect the lawfulness of any processing we conducted prior to your withdrawal, nor will it affect processing of your personal information conducted in reliance on lawful processing grounds other than consent.
-* You have the right to complain to a data protection authority about our collection and use of your personal information.  For more information, please contact your local data protection authority. Contact details for data protection authorities in the European Economic Area are available [here](https://ec.europa.eu/justice/data-protection/article-29/structure/data-protection-authorities/index_en.htm).
+* You have the right to complain to a data protection authority about our collection and use of your personal information.  For more information, please contact your local data protection authority. Contact details for data protection authorities in the European Economic Area are available on [the EU data protection authorities website](https://ec.europa.eu/justice/data-protection/article-29/structure/data-protection-authorities/index_en.htm).
 
 Everyone has the right to opt-out of marketing communications we send you
 at any time. You can exercise this right by clicking on the "unsubscribe" or
diff --git a/prebid-video/video-getting-started.md b/prebid-video/video-getting-started.md
index 056f2a2f13..09fd766830 100644
--- a/prebid-video/video-getting-started.md
+++ b/prebid-video/video-getting-started.md
@@ -56,7 +56,7 @@ If you already have a Prebid integration for banner, you don’t need to do anyt
 
 Your first step to implementing header bidding for video is to [download Prebid.js](/download.html). Before downloading, select the adapters you want to include. (You can add more adapters later.)
 
-- Include at least one bid adapter that supports video. Find a list of eligible adapters [here](/dev-docs/bidders.html#bidder-video-native).
+- Include at least one bid adapter that supports video. Find a list of eligible adapters in [the video bidders table](/dev-docs/bidders.html#bidder-video-native).
 - If Google Ad Manager is your ad server, you must include the [Google Ad Manager Video module](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html).
 - If you’ll be integrating with Prebid Server, be sure to include “Prebid Server” in the list of adapters.
 
diff --git a/prebid-video/video-long-form.md b/prebid-video/video-long-form.md
index 2e4db9d4a8..38bed5fbbe 100644
--- a/prebid-video/video-long-form.md
+++ b/prebid-video/video-long-form.md
@@ -35,7 +35,7 @@ To implement header bidding for long-form video start by [downloading Prebid.js]
 
 Before downloading, select the adapters you want to include. (You can add more adapters later.)
 
-- Include at least one video adapter. Find a list of available video adapters [here](/dev-docs/bidders.html#bidder-video-native).
+- Include at least one video adapter. Find a list of available video adapters in [the video bidders table](/dev-docs/bidders.html#bidder-video-native).
 - Include the [FreeWheel](/dev-docs/modules/freewheel.html) Ad Server module.
 - Include the [Category Translation](/dev-docs/modules/categoryTranslation.html) module.  
 - If you’ll be integrating with Prebid Server, be sure to include “Prebid Server” in the list of adapters.
diff --git a/prebid/events.md b/prebid/events.md
index 15bbb53e51..335c61b902 100644
--- a/prebid/events.md
+++ b/prebid/events.md
@@ -14,7 +14,7 @@ sidebarType: 0
 {: .table .table-bordered .table-striped }
 | <b>Title:</b> | How to Make Prebid the Supply Path Buyers Choose |
 | <b>Date:</b> | Aug 27, 2020 |
-| <b>Registration:</b> | [link](https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&referrer=&eventid=2543494&sessionid=1&key=A724FF00CF11F4BF9C611B265C62DAEE&regTag=&sourcepage=register) |
+| <b>Registration:</b> | [event registration link](https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&referrer=&eventid=2543494&sessionid=1&key=A724FF00CF11F4BF9C611B265C62DAEE&regTag=&sourcepage=register) |
 
 ## Past Events
 
diff --git a/prebid/native-implementation.md b/prebid/native-implementation.md
index ad1ab29313..7a036a873b 100644
--- a/prebid/native-implementation.md
+++ b/prebid/native-implementation.md
@@ -62,6 +62,7 @@ This table summarizes how the 3 approaches work:
 **Table 1: Native Implementation Approaches**
 
 {: .table .table-bordered .table-striped }
+
 | Component | AdServer-Defined Creative Scenario | AdUnit-Defined Creative Scenario | Custom Renderer Scenario |
 | --- | --- |--- | --- |
 | Prebid.js | mediaTypes. native.ortb | mediaTypes. native.ortb and mediaTypes.native.adTemplate contains ##macros## | mediaTypes. native.ortb and mediaTypes.native.rendererUrl |
@@ -77,11 +78,12 @@ The Prebid.js AdUnit needs to define a native mediatype object to tell bidders w
 **Table 2: Prebid.js AdUnit Native MediaType Options**
 
 {: .table .table-bordered .table-striped }
+
 | Attribute | Scope | Description | Example | Type |
 | --- | --- | --- | --- | --- |
 | adTemplate | optional | Used in the ‘AdUnit-Defined Creative Scenario’, this value will contain the Native template right in the page. | See [example](#42-implementing-an-adunit-defined-template) below. | escaped ES5 string |
 | rendererUrl | optional | Used in the ‘Custom Renderer Scenario’, this points to javascript code that will produce the Native template. | `'https://host/path.js'` | string |
-| ortb | recommended | OpenRTB configuration of the Native assets. The Native 1.2 specification can be found [here](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) | { assets: [], eventtrackers: [] } | object |
+| ortb | recommended | OpenRTB configuration of the Native assets. The Native 1.2 specification can be found [the OpenRTB Native Ads Specification](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) | { assets: [], eventtrackers: [] } | object |
 | sendTargetingKeys | deprecated | (**NOTE**: not supported in 9.0 and later). Defines whether or not to send the hb_native_ASSET targeting keys to the ad server. Defaults to `false`. | `false` | boolean |
 
 ### 3.1. Prebid.js and the ORTB asset fields
@@ -157,6 +159,7 @@ Here's an example:
 For reference, this is the table that specifies all data types:
 
 {: .table .table-bordered .table-striped }
+
 | Type ID | Name |
 | ------- | ---- |
 | 1 | sponsored |
diff --git a/support/privacy-resources.md b/support/privacy-resources.md
index 5666071a65..570ceaf740 100644
--- a/support/privacy-resources.md
+++ b/support/privacy-resources.md
@@ -123,6 +123,7 @@ Prebid Server reads the HTTP header set by Chrome and copies the value to the Op
 This table may be useful to publishers trying to decide which version of Prebid.js to use to support Privacy Sandbox.
 
 {: .table .table-bordered .table-striped }
+
 | Prebid.js Version | Notes |
 |-------------------|-------|
 | 8.22| Makes Prebid FPD available to the PAAPI generateBid, scoreAds, and reportResult functions |
@@ -133,11 +134,13 @@ This table may be useful to publishers trying to decide which version of Prebid.
 #### Prebid Server Versions Supporting Privacy Sandbox
 
 {: .table .table-bordered .table-striped }
+
 | PBS-Go Version | Notes |
 |-------------------|-------|
 | 0.239.0 | Basic passthrough support |
 
 {: .table .table-bordered .table-striped }
+
 | PBS-Java Version | Notes |
 |-------------------|-------|
 | 2.11| Topics and Test Labels |
diff --git a/tools/line-item-manager.md b/tools/line-item-manager.md
index 78fd29e15f..9a911b9992 100644
--- a/tools/line-item-manager.md
+++ b/tools/line-item-manager.md
@@ -38,7 +38,7 @@ This tool uses a base (default) configuration as a starting point to create line
 line_item_manager show config
 ```
 
-You can look at the full config [here](https://github.com/prebid/line-item-manager/blob/master/line_item_manager/conf.d/line_item_manager.yml). To save time and build on the default config, create a new config file of your own using the following command:
+You can look at the full config in [the example configuration](https://github.com/prebid/line-item-manager/blob/master/line_item_manager/conf.d/line_item_manager.yml). To save time and build on the default config, create a new config file of your own using the following command:
 
 ```bash
 line_item_manager show config > my_config.yml
@@ -153,24 +153,24 @@ The create function has certain modifiers that can be used to do dry runs and te
 {: .table .table-bordered .table-striped }
 
 | Modifier | Type | Description |
-|----------|------|-------------|
-|--network-code | INTEGER | GAM network code, must reconcile with the network name.|
---network-name |TEXT|GAM network name, must reconcile with the network code.|
-|-k, --private-key-file |PATH |Path to json GAM credentials file. [default: gam_creds.json; required]
-|-s, --single-order||Create a single set of orders instead of orders per bidder. [default: False]
--b, --bidder-code |TEXT |Bidder code may be used multiple times.
--t, --test-run||Execute a limited number of line_items for testing and manual review. Please ensure that you archive the orders so as not to clash with the actual production orders and line items you wish to create. [default: False]
--n, --dry-run||Print commands that would be executed, but do not execute them. [default: False]
--q, --quiet||Logging is limited to warnings and errors. [default: False]
--v, --verbose||Verbose logging; use multiple times to increase verbosity. [default: False]
---skip-auto-archive||Upon failure or interruption, do NOT auto-archive already created orders. [default:False]
+| ----------|------|-------------|
+| --network-code | INTEGER | GAM network code, must reconcile with the network name. |
+| --network-name |TEXT|GAM network name, must reconcile with the network code. |
+| -k, --private-key-file |PATH |Path to json GAM credentials file. [default: gam_creds.json; required] |
+| -s, --single-order||Create a single set of orders instead of orders per bidder. [default: False] |
+| -b, --bidder-code |TEXT |Bidder code may be used multiple times. |
+| -t, --test-run||Execute a limited number of line_items for testing and manual review. Please ensure that you archive the orders so as not to clash with the actual production orders and line items you wish to create. [default: False] |
+| -n, --dry-run||Print commands that would be executed, but do not execute them. [default: False] |
+| -q, --quiet||Logging is limited to warnings and errors. [default: False] |
+| -v, --verbose||Verbose logging; use multiple times to increase verbosity. [default: False] |
+| --skip-auto-archive||Upon failure or interruption, do NOT auto-archive already created orders. [default:False] |
 
 ### Commands for _line_item_manager_
 
 {: .table .table-bordered .table-striped }
 
 | Modifier |  Description |
-|----------|-------------|
+| ----------|-------------|
 |create|Create line items|
 |show|Show resources. Options: "config" or "bidders" |
 
diff --git a/troubleshooting/troubleshooting-guide.md b/troubleshooting/troubleshooting-guide.md
index 6c58aeac38..d62d726bc1 100644
--- a/troubleshooting/troubleshooting-guide.md
+++ b/troubleshooting/troubleshooting-guide.md
@@ -41,6 +41,7 @@ This will add two types of messages to your browser’s developer console:
  "Prebid.js message log"){: height="50%"  width="50%" :}
 
  {: .table .table-bordered .table-striped }
+
 | Message |  Description   |
 | :----  |:--------|
 | Calling bidder |  When Prebid.js sends out bid requests, this message is logged |

From 18b9276d990b66f5eaaa83a9c63301924a220a23 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 02:21:50 -0400
Subject: [PATCH 156/665] fix markdownlint issues in docs (#6060)

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 _includes/default-keyword-targeting.md            | 12 +++++++-----
 _includes/send-all-bids-keyword-targeting.md      | 11 +++++++----
 adops/setting-up-prebidjs-with-Smart-Ad-Server.md |  6 +++---
 faq/prebid-server-faq.md                          |  2 +-
 prebid/events.md                                  |  2 +-
 5 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/_includes/default-keyword-targeting.md b/_includes/default-keyword-targeting.md
index fc733bd2cb..d9f1de06ba 100644
--- a/_includes/default-keyword-targeting.md
+++ b/_includes/default-keyword-targeting.md
@@ -1,7 +1,9 @@
+# Default Keyword Targeting
+
 {: .table .table-bordered .table-striped }
-| Default Key   | Scope    | Description                                                                                     | Example   |
-| :----         |:----     | :----                                                                                           | :----     |
-| `hb_pb`       | Required | The price bucket. Used by the line item to target.                                              | `2.10`    |
-| `hb_adid`     | Required | The ad Id. Used by the ad server creative to render ad.                                         | `234234`  |
-| `hb_bidder`   | Required | The bidder code. Used for logging and reporting to learn which bidder has higher fill rate/CPM. | `rubicon` |
 
+| Default Key   | Scope    | Description | Example   |
+| :----         |:----     | :----       | :----     |
+| `hb_pb`       | Required | The price bucket. Used by the line item to target. | `2.10`    |
+| `hb_adid`     | Required | The ad Id. Used by the ad server creative to render ad. | `234234`  |
+| `hb_bidder`   | Required | The bidder code. Used for logging and reporting to learn which bidder has higher fill rate/CPM. | `rubicon` |
diff --git a/_includes/send-all-bids-keyword-targeting.md b/_includes/send-all-bids-keyword-targeting.md
index f8f977684d..2ba6d4d662 100644
--- a/_includes/send-all-bids-keyword-targeting.md
+++ b/_includes/send-all-bids-keyword-targeting.md
@@ -1,8 +1,11 @@
+# Send-All-Bids Keyword Targeting
+
 **Important:** Google Ad Manager has a key-value key character [limit](https://support.google.com/dfp_premium/answer/1628457?hl=en#Key-values) of up to **20 characters**. Some of the keys without truncation will exceed 20 chars. Prebid.js automatically truncates the key length to 20 characters. For example, `hb_adid_longBidderName` is truncated to `hb_adid_longBidderNa` (`me` is truncated). Note that the key is case-sensitive. To get the exact key-value keys for each bidder, find them at [Bidder Params](/dev-docs/bidders.html).
 
 {: .table .table-bordered .table-striped }
-| Default Key   | Scope    | Description                                                                                     | Example   |
-| :----         |:----     | :----                                                                                           | :----     |
-| `hb_pb_BIDDERCODE`       | Required | The price bucket. Used by the line item to target. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_pb_rubicon` = `2.10`    |
-| `hb_adid_BIDDERCODE`     | Required | The ad Id. Used by the ad server creative to render ad. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_adid_longBidderNa` = `234234`  |
+
+| Default Key   | Scope    | Description | Example |
+| :----         | :----    | :----       | :----   |
+| `hb_pb_BIDDERCODE`       | Required | The price bucket. Used by the line item to target. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_pb_rubicon` = `2.10` |
+| `hb_adid_BIDDERCODE`     | Required | The ad Id. Used by the ad server creative to render ad. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_adid_longBidderNa` = `234234` |
 | `hb_size_BIDDERCODE`   | Optional | This is not required for adops. Case sensitive and truncated to 20 chars. | `hb_size_appnexus` = `300x250` |
diff --git a/adops/setting-up-prebidjs-with-Smart-Ad-Server.md b/adops/setting-up-prebidjs-with-Smart-Ad-Server.md
index 2dfc95c07a..35a2ac7b71 100644
--- a/adops/setting-up-prebidjs-with-Smart-Ad-Server.md
+++ b/adops/setting-up-prebidjs-with-Smart-Ad-Server.md
@@ -39,7 +39,7 @@ Proceed as follows:
 - Make sure you specify the timeout; the timeout is the maximum time to wait until the Smart AdServer ad call is executed - even if some partners have not responded yet.
 - Implement the Prebid.js file on the site.
 
-This step is also documented [here](https://support.smartadserver.com/s/article/Holistic-Setup#implement-wrapper).
+This step is also documented [Smart AdServer setup documentation](https://support.smartadserver.com/s/article/Holistic-Setup#implement-wrapper).
 
 ### Step 2 - Implement Smart AdServer’s tag
 
@@ -47,7 +47,7 @@ Smart AdServer’s OneCall tagging is strongly recommended. With OneCall, you ca
 
 Make sure you use Smart AdServer’s **new OneCall tagging**, which uses POST requests with all the necessary information in the request body; simply check if you see the `formats` array in your tag. If you see `formatId`, you are still dealing with an old tag - in this case, get back to your service contact at Smart AdServer.
 
-For samples of both the new and legacy OneCall as well as a full implementation example, read [here](https://support.smartadserver.com/s/article/Holistic-Setup#onecall).
+For samples of both the new and legacy OneCall as well as a full implementation example, read [OneCall documentation](https://support.smartadserver.com/s/article/Holistic-Setup#onecall).
 
 **Additional resources**:
 
@@ -63,7 +63,7 @@ Things to keep in mind for the Setup in [Smart AdServer’s UI](https://manage.s
 - The Holistic+ feature must be enabled on the network.
 - You must use the official and Holistic RTB+ script templates in the insertions.
 
-For more details, read [here](https://support.smartadserver.com/s/article/Holistic-Setup#setup-ui).
+For more details, read [setup instructions](https://support.smartadserver.com/s/article/Holistic-Setup#setup-ui).
 
 ### Step 4 - Get reporting
 
diff --git a/faq/prebid-server-faq.md b/faq/prebid-server-faq.md
index 7e53c75dc8..dd67a6b3db 100644
--- a/faq/prebid-server-faq.md
+++ b/faq/prebid-server-faq.md
@@ -267,7 +267,7 @@ The supply chain is meant to track financial arrangements, and PBS is basically
 
 Generally, people and companies will work on features and bug fixes that directly affect them. The process is:
 
-1. If there's not already an issue tracking the work, create an issue in the PBS-Go repo [here](https://github.com/prebid/prebid-server/issues/new). Note: we track enhancement requests in the PBS-Go repo. If it's a bug that affects PBS-Java only, then you can open the issue [here](https://github.com/prebid/prebid-server-java/issues/new).
+1. If there's not already an issue tracking the work, create an issue in the PBS-Go repo [the PBS-Go issue tracker](https://github.com/prebid/prebid-server/issues/new). Note: we track enhancement requests in the PBS-Go repo. If it's a bug that affects PBS-Java only, then you can open the issue [the PBS-Java issue tracker](https://github.com/prebid/prebid-server-java/issues/new).
 2. The issue should describe what you're planning to build/fix. We'll want to review any interfaces, config options, or metrics for consistency.
 3. After getting approval (if needed), you'll make a Pull Request against the appropriate repo, whether PBS-Go or PBS-Java. Be sure to have read the contribution guidelines for [PBS-Go](https://github.com/prebid/prebid-server/tree/master/docs/developers) or [PBS-Java](https://github.com/prebid/prebid-server-java/tree/master/docs/developers).
 4. The core team will review your PR.
diff --git a/prebid/events.md b/prebid/events.md
index 335c61b902..be0127c44a 100644
--- a/prebid/events.md
+++ b/prebid/events.md
@@ -14,7 +14,7 @@ sidebarType: 0
 {: .table .table-bordered .table-striped }
 | <b>Title:</b> | How to Make Prebid the Supply Path Buyers Choose |
 | <b>Date:</b> | Aug 27, 2020 |
-| <b>Registration:</b> | [event registration link](https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&referrer=&eventid=2543494&sessionid=1&key=A724FF00CF11F4BF9C611B265C62DAEE&regTag=&sourcepage=register) |
+| <b>Registration:</b> | [Event Registration](https://event.on24.com/eventRegistration/EventLobbyServlet?target=reg20.jsp&referrer=&eventid=2543494&sessionid=1&key=A724FF00CF11F4BF9C611B265C62DAEE&regTag=&sourcepage=register) |
 
 ## Past Events
 

From a83b0f9873611eeda2a7168a436b10cb3d35611c Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 02:23:51 -0400
Subject: [PATCH 157/665] Codex support: Update README.md and define AGENTS.md
 (#6059)

* Update README.md

* Create AGENTS.md

* Update AGENTS.md

* Update AGENTS.md

* Update README.md

* Update README.md

* Update AGENTS.md
---
 AGENTS.md |  7 +++++++
 README.md | 20 ++++++++++++++++++++
 2 files changed, 27 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000..028d81b2c6
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# Agent Guidelines
+
+- Run `markdownlint` on any edited Markdown files using the repository configuration with `markdownlint --config .markdownlint.json README.md`. Replace `README.md` with each file you change.
+- If lint errors occur, fix them before creating a pull request.
+- Verify the site builds with `bundle exec jekyll build` when possible.
+- Please name your branch to include codex or agent in the branch name
+- If you cannot run markdownlint please warn your user to setup their environment using the instructions in README.md and document your failure in your pr description
diff --git a/README.md b/README.md
index 3825aa02c9..744af1333d 100755
--- a/README.md
+++ b/README.md
@@ -112,6 +112,26 @@ This means an adaptor is not available to download from Prebid.org as soon as th
 
 * [jekyll - check for non empty](https://michaelcurrin.github.io/dev-cheatsheets/cheatsheets/jekyll/liquid/conditionals/non-empty.html)
 
+## Codex
+
+To get started with Codex with Ruby 3.4.4 preinstalled on this repo, you can set up your environment like this
+
+```bash
+echo "3.4.4" > .ruby-version
+export NOKOGIRI_USE_SYSTEM_LIBRARIES=1
+gem install jekyll bundler
+npm install boostrap
+gem install github-pages --no-document --force
+npm install -g markdownlint-cli
+bundle install
+```
+
+Codex can then check for linting success with
+
+```bash
+markdownlint --config .markdownlint.json "**/*.md"
+```
+
 ## Thanks
 
 Many thanks to the following people who have submitted content to Prebid.org.  We really appreciate the help!

From 460029fb063f2f5d20ed32d9bea449057aa5e01c Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 05:10:28 -0400
Subject: [PATCH 158/665] docs: add failsafe checks to more examples (#6056)

---
 _includes/video/pb-os-dfp.html                    | 10 +++++++---
 dev-docs/examples/basic-example.md                | 10 ++++++++--
 dev-docs/examples/custom-price-buckets.md         | 10 +++++++---
 dev-docs/examples/instream-banner-mix.md          | 10 +++++++---
 dev-docs/examples/meta-bid-filtering.md           | 10 ++++++++--
 dev-docs/examples/native-ad-example.md            | 10 +++++++---
 dev-docs/examples/size-mapping.md                 | 10 +++++++---
 dev-docs/examples/sync-tid.md                     | 13 ++++++++++---
 docs-examples/web-example.md                      | 10 ++++++++--
 examples/video/outstream/pb-ve-outstream-dfp.html | 10 +++++++---
 10 files changed, 76 insertions(+), 27 deletions(-)

diff --git a/_includes/video/pb-os-dfp.html b/_includes/video/pb-os-dfp.html
index 4496ea51a0..bc7fe61309 100644
--- a/_includes/video/pb-os-dfp.html
+++ b/_includes/video/pb-os-dfp.html
@@ -48,10 +48,14 @@
         if (pbjs.initAdserverSet) return;
         pbjs.initAdserverSet = true;
         googletag.cmd.push(function () {
-          pbjs.que.push(function () {
-            pbjs.setTargetingForGPTAsync();
+          if (pbjs.libLoaded) {
+            pbjs.que.push(function () {
+              pbjs.setTargetingForGPTAsync();
+              googletag.pubads().refresh();
+            });
+          } else {
             googletag.pubads().refresh();
-          });
+          }
         });
       }
 
diff --git a/dev-docs/examples/basic-example.md b/dev-docs/examples/basic-example.md
index 1c22ec8ac6..e4f2519984 100644
--- a/dev-docs/examples/basic-example.md
+++ b/dev-docs/examples/basic-example.md
@@ -73,8 +73,14 @@ function initAdserver() {
   if (pbjs.initAdserverSet) return;
   pbjs.initAdserverSet = true;
   googletag.cmd.push(function() {
-    pbjs.setTargetingForGPTAsync && pbjs.setTargetingForGPTAsync();
-    googletag.pubads().refresh();
+    if (pbjs.libLoaded) {
+      pbjs.que.push(function() {
+        pbjs.setTargetingForGPTAsync();
+        googletag.pubads().refresh();
+      });
+    } else {
+      googletag.pubads().refresh();
+    }
   });
 }
 
diff --git a/dev-docs/examples/custom-price-buckets.md b/dev-docs/examples/custom-price-buckets.md
index 7990cfb310..b8bc178adc 100644
--- a/dev-docs/examples/custom-price-buckets.md
+++ b/dev-docs/examples/custom-price-buckets.md
@@ -97,10 +97,14 @@ function initAdserver() {
     if (pbjs.initAdserverSet) return;
     pbjs.initAdserverSet = true;
     googletag.cmd.push(function() {
-        pbjs.que.push(function() {
-            pbjs.setTargetingForGPTAsync();
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync();
+                googletag.pubads().refresh();
+            });
+        } else {
             googletag.pubads().refresh();
-        });
+        }
     });
 }
 
diff --git a/dev-docs/examples/instream-banner-mix.md b/dev-docs/examples/instream-banner-mix.md
index 4c6c2bab5f..3bdd997581 100644
--- a/dev-docs/examples/instream-banner-mix.md
+++ b/dev-docs/examples/instream-banner-mix.md
@@ -177,10 +177,14 @@ function initAdserver(bids) {
 
     // Set targeting for each display slot
     googletag.cmd.push(function() {
-        pbjs.que.push(function() {
-            pbjs.setTargetingForGPTAsync(displayAdUnitCodes);
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync(displayAdUnitCodes);
+                googletag.pubads().refresh();
+            });
+        } else {
             googletag.pubads().refresh();
-        });
+        }
     });
 
     // Build DFP URL with targeting for videoAdUnit
diff --git a/dev-docs/examples/meta-bid-filtering.md b/dev-docs/examples/meta-bid-filtering.md
index d2b8225b66..aae19d1e21 100644
--- a/dev-docs/examples/meta-bid-filtering.md
+++ b/dev-docs/examples/meta-bid-filtering.md
@@ -78,8 +78,14 @@ function initAdserver() {
     if (pbjs.initAdserverSet) return;
     pbjs.initAdserverSet = true;
     googletag.cmd.push(function() {
-        pbjs.setTargetingForGPTAsync && pbjs.setTargetingForGPTAsync();
-        googletag.pubads().refresh();
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync();
+                googletag.pubads().refresh();
+            });
+        } else {
+            googletag.pubads().refresh();
+        }
     });
 }
 
diff --git a/dev-docs/examples/native-ad-example.md b/dev-docs/examples/native-ad-example.md
index 79d01f6759..4d87c6fe72 100644
--- a/dev-docs/examples/native-ad-example.md
+++ b/dev-docs/examples/native-ad-example.md
@@ -48,10 +48,14 @@ function initAdserver() {
     if (pbjs.initAdserverSet) return;
 
     googletag.cmd.push(function() {
-        pbjs.que.push(function() {
-            pbjs.setTargetingForGPTAsync();
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync();
+                googletag.pubads().refresh();
+            });
+        } else {
             googletag.pubads().refresh();
-        });
+        }
     });
 
     pbjs.initAdserverSet = true;
diff --git a/dev-docs/examples/size-mapping.md b/dev-docs/examples/size-mapping.md
index 135b18cec2..4ad3401392 100644
--- a/dev-docs/examples/size-mapping.md
+++ b/dev-docs/examples/size-mapping.md
@@ -104,10 +104,14 @@ function sendAdserverRequest() {
     if (pbjs.adserverRequestSent) return;
     pbjs.adserverRequestSent = true;
     googletag.cmd.push(function() {
-        pbjs.que.push(function() {
-            pbjs.setTargetingForGPTAsync();
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync();
+                googletag.pubads().refresh();
+            });
+        } else {
             googletag.pubads().refresh();
-        });
+        }
     });
 }
 
diff --git a/dev-docs/examples/sync-tid.md b/dev-docs/examples/sync-tid.md
index d6b1e05074..0922e41ffd 100644
--- a/dev-docs/examples/sync-tid.md
+++ b/dev-docs/examples/sync-tid.md
@@ -83,9 +83,16 @@ pbjs.que.push(function() {
 function prebidBidsBack() {
     pbjs.initAdserverSet = true;
     googletag.cmd.push(function() {
-        pbjs.setTargetingForGPTAsync && pbjs.setTargetingForGPTAsync();
-        requestManager.prebid = true;
-        sendBidsToAdServer();
+        if (pbjs.libLoaded) {
+            pbjs.que.push(function() {
+                pbjs.setTargetingForGPTAsync();
+                requestManager.prebid = true;
+                sendBidsToAdServer();
+            });
+        } else {
+            googletag.pubads().refresh();
+            requestManager.adserverRequestSent = true;
+        }
     });
 }
 
diff --git a/docs-examples/web-example.md b/docs-examples/web-example.md
index 7e88fe7505..79c5246494 100644
--- a/docs-examples/web-example.md
+++ b/docs-examples/web-example.md
@@ -84,8 +84,14 @@ function initAdserver() {
   if (pbjs.initAdserverSet) return;
   pbjs.initAdserverSet = true;
   googletag.cmd.push(function() {
-    pbjs.setTargetingForGPTAsync && pbjs.setTargetingForGPTAsync();
-    googletag.pubads().refresh();
+    if (pbjs.libLoaded) {
+      pbjs.que.push(function() {
+        pbjs.setTargetingForGPTAsync();
+        googletag.pubads().refresh();
+      });
+    } else {
+      googletag.pubads().refresh();
+    }
   });
 }
 
diff --git a/examples/video/outstream/pb-ve-outstream-dfp.html b/examples/video/outstream/pb-ve-outstream-dfp.html
index 25f2130937..62d52de1e2 100644
--- a/examples/video/outstream/pb-ve-outstream-dfp.html
+++ b/examples/video/outstream/pb-ve-outstream-dfp.html
@@ -120,10 +120,14 @@ <h4>Place this code in the page header.</h4>
           if (pbjs.initAdserverSet) return;
           pbjs.initAdserverSet = true;
           googletag.cmd.push(function() {
-              pbjs.que.push(function() {
-                  pbjs.setTargetingForGPTAsync();
+              if (pbjs.libLoaded) {
+                  pbjs.que.push(function() {
+                      pbjs.setTargetingForGPTAsync();
+                      googletag.pubads().refresh();
+                  });
+              } else {
                   googletag.pubads().refresh();
-              });
+              }
           });
       }
 

From 733e5d4a1e24593ef4d63e89b0ad464de4b623c8 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 06:52:18 -0400
Subject: [PATCH 159/665] Update prebidServer.md: routing to multiple pbs
 instances (#6026)

* Update prebidServer.md

* Update prebidServer.md
---
 dev-docs/modules/prebidServer.md | 42 ++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index 15aeb0b171..e22a972cf4 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -204,6 +204,48 @@ Here's how it works:
 1. The s2sConfig.bidders array contains 'tripleliftVideo' telling Prebid.js to direct bids for that code to the server
 1. Finally, the extPrebid.aliases line tells Prebid Server to route the 'tripleliftVideo' biddercode to the 'triplelift' server-side adapter.
 
+### Routing for Multiple PBS instances
+
+Bids:
+
+```javascript
+[{
+    bidder: 'foobar',
+    params: {...},
+},
+{
+    bidder: 'foobar',
+    params: {...},
+    pbsHost: 'foobar-2'
+}]
+```
+
+s2sConfig:
+
+```javascript
+[{
+    accountId: 1234,
+    bidders: ['foobar'],
+    enabled: true,
+    endpoint: {
+        noP1Consent : 'https://pbs.auction/openrtb2/auction',
+        p1Consent : 'https://pbs.auction/openrtb2/auction'
+    }
+},
+{
+     accountId: 5678,
+     bidders: ['foobar-2'],
+     syncBidders: ['foobar'],
+     enabled: true,
+     endpoint: {
+        noP1Consent : 'https://pbs.alt.auction/openrtb2/auction',
+        p1Consent : 'https://pbs.alt.auction/openrtb2/auction'
+     }
+}]
+```
+
+The above would distribute `bid[0]` to s2s endpoint `https://pbs.auction/openrtb2/auction`, whereas `bid[1]` will be distributed to `https://pbs.alt.auction/openrtb2/auction`. The syncBidders is used to sync both with the original biddercode to as well as applying bidder specific FPD for pbs calls via bidderconfig.
+
 ### Video via s2sConfig
 
 Supporting video through the Server-to-Server route can be done by providing a couple of extra arguments on the `extPrebid` object. e.g.

From 065df9a276bfa823d6a723482b0ed0faa3fb5c61 Mon Sep 17 00:00:00 2001
From: naru-tsujine <159880063+naru-tsujine@users.noreply.github.com>
Date: Tue, 27 May 2025 20:00:20 +0900
Subject: [PATCH 160/665] Adding supported schain to logicad bid adapter
 documentation (#6029)

---
 dev-docs/bidders/logicad.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/logicad.md b/dev-docs/bidders/logicad.md
index 1c8dfe434d..f8eb3ec61b 100644
--- a/dev-docs/bidders/logicad.md
+++ b/dev-docs/bidders/logicad.md
@@ -12,6 +12,7 @@ userIds: all
 tcfeu_supported: false
 prebid_member: false
 sidebarType: 1
+schain_supported: true
 ---
 
 

From 18a388f44dc4d7b6756cbc6987cf95384098306f Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Tue, 27 May 2025 13:03:30 +0200
Subject: [PATCH 161/665] Update geoedgeRtdProvider.md (#6047)

Typo
---
 dev-docs/modules/geoedgeRtdProvider.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/geoedgeRtdProvider.md b/dev-docs/modules/geoedgeRtdProvider.md
index 9593e8772c..944cf0f5bc 100644
--- a/dev-docs/modules/geoedgeRtdProvider.md
+++ b/dev-docs/modules/geoedgeRtdProvider.md
@@ -20,7 +20,7 @@ sidebarType : 1
 ## Overview
 
 The Geoedge Realtime module lets publishers block bad ads such as automatic redirects, malware, offensive creatives and landing pages.
-To use this module, you'll need to work with [Geoedge](https://www.geoedge.com/publishers-real-time-protection/) to get an account and cutomer key.
+To use this module, you'll need to work with [Geoedge](https://www.geoedge.com/publishers-real-time-protection/) to get an account and customer key.
 
 {% include dev-docs/loads-external-javascript.md %}
 

From 1a26884d83accf64ae2e0ba3d4774a65d0b723af Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 07:07:29 -0400
Subject: [PATCH 162/665] docs: clarify imp-level floorMin location (#6066)

---
 dev-docs/modules/floors.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index c9733c289d..3495955c10 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -1295,7 +1295,7 @@ Even if a publisher is using a floors provider, they may wish to provide additio
 
 1. default floor data if dynamic data fails to load on time
 2. global floorMin: allows the publisher to constrain dynamic floors with a global min
-3. impression-level floor min (PBJS 6.24+): allows the publisher to constrain dynamic floors with an adunit-specific value
+3. impression-level floor min (PBJS 6.24+): allows the publisher to constrain dynamic floors with an adunit-specific value. Specify this in `ortb2Imp.ext.prebid.floors.floorMin` (prior to Prebid.js 8 it was `ortb2Imp.ext.prebid.floorMin`).
 
 Here's an example covering the first two scenarios:
 

From e5284f6debf16b1fc2125a186f54c437403da51a Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 07:11:58 -0400
Subject: [PATCH 163/665] fix typos (#6063)

---
 dev-docs/bidder-adaptor.md                            | 11 +++++++++--
 dev-docs/modules/tcfControl.md                        |  2 +-
 .../plugins/bc/bc-prebid-plugin-render-options.md     |  2 +-
 dev-docs/publisher-api-reference/offEvent.md          |  2 +-
 dev-docs/show-prebid-ads-on-amp-pages.md              |  2 +-
 overview/glossary.md                                  |  2 +-
 prebid-mobile/prebid-mobile.md                        |  2 +-
 .../pbs-modules/51degrees-device-detection.md         |  7 ++++---
 prebid-server/pbs-modules/ortb2-blocking.md           |  2 +-
 9 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index ed4b10c34e..e2b4d52657 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -278,7 +278,7 @@ Prebid.js core now includes support for gzip compression of bidder request paylo
 Prebid will pass compressed payloads if the following criteria are met:
 
 * Participating bidders must implement compression support on their server-side endpoint before making a change in their bid adapter in Prebid.js
-* Once server-side support is present, `request.options.endpointCompression = true` needs to be set for a bidder's outgoing requests within their Prebid.js bid adapter (An example of this can be viewed [here](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
+* Once server-side support is present, `request.options.endpointCompression = true` needs to be set for a bidder's outgoing requests within their Prebid.js bid adapter (see the [PubMatic adapter example](https://github.com/prebid/Prebid.js/blob/master/modules/pubmaticBidAdapter.js#L730))
 * The browser must support gzip compression (Prebid core has a built-in utility function to check this)
 
 If the above criteria is met, Prebid.js core will do the following:
@@ -389,6 +389,7 @@ When disabled, `auctionId`/`transactionId` are set to `null`; `ortb2.source.tid`
 There are a number of important values that a publisher expects to be handled in a standard way across all Prebid.js adapters:
 
 {: .table .table-bordered .table-striped }
+
 | Parameter | Description                                   | Example               |
 | ----- | ------------ | ---------- |
 | Ad Server Currency | If your endpoint supports responding in different currencies, read this value. | config.getConfig('currency.adServerCurrency') |
@@ -423,6 +424,7 @@ You shouldn't call your bid endpoint directly. Rather, the end result of your bu
 ServerRequest objects. These objects have this structure:
 
 {: .table .table-bordered .table-striped }
+
 | Attribute | Type             | Description                                                        | Example Value               |
 |-----------+------------------+--------------------------------------------------------------------+-----------------------------|
 | `method`  | String           | Which HTTP method should be used.                                  | `POST`                      |
@@ -504,6 +506,7 @@ particularly useful. Publishers may have analytics or security vendors with the
 The parameters of the `bidResponse` object are:
 
 {: .table .table-bordered .table-striped }
+
 | Key          | Scope                                       | Description                                                                                                                                   | Example                              |
 |--------------+---------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------|
 | `requestId`  | Required                                    | The bid ID that was sent to `spec.buildRequests` as `bidRequests[].bidId`. Used to tie this bid back to the request.                          | 12345                                |
@@ -760,6 +763,7 @@ spec.aliases can be an array of strings or objects.
 If the alias entry is an object, the following attributes are supported:
 
 {: .table .table-bordered .table-striped }
+
 | Name  | Scope | Description   | Type      |
 |-------|-------|---------------|-----------|
 | `code` | required | shortcode/partner name | `string` |
@@ -962,7 +966,7 @@ Adapter must add following new properties to bid response
 }
 ```
 
-Appnexus Adapter uses above explained approach. You can refer [here](https://github.com/prebid/Prebid.js/blob/master/modules/appnexusBidAdapter.js)
+Appnexus Adapter uses the approach explained above. You can see an example in the [AppNexus adapter](https://github.com/prebid/Prebid.js/blob/master/modules/appnexusBidAdapter.js)
 
 Adapter must return one [IAB accepted subcategories](https://iabtechlab.com/wp-content/uploads/2017/11/IAB_Tech_Lab_Content_Taxonomy_V2_Final_2017-11.xlsx) (links to MS Excel file) if they want to support competitive separation. These IAB sub categories will be converted to Ad server industry/group. If adapter is returning their own proprietary categroy, it is the responsibility of the adapter to convert their categories into [IAB accepted subcategories](https://iabtechlab.com/wp-content/uploads/2017/11/IAB_Tech_Lab_Content_Taxonomy_V2_Final_2017-11.xlsx) (links to MS Excel file).
 
@@ -971,6 +975,7 @@ If the demand partner is going to use Prebid API for this process, their adapter
 **Params**  
 
 {: .table .table-bordered .table-striped }
+
 | Key             | Scope    | Description                                                                                        | Example                    |
 |-----------------|----------|----------------------------------------------------------------------------------------------------|----------------------------|
 | `url`             | Required | The URL to the mapping file.                                                                       | `"//example.com/mapping.json"` |
@@ -1000,6 +1005,7 @@ getIabSubCategory(bidderCode, pCategory)
 **Params**
 
 {: .table .table-bordered .table-striped }
+
 | Key          | Scope    | Description                                   | Example               |
 |--------------|----------|-----------------------------------------------|-----------------------|
 | `bidderCode` | Required | BIDDER_CODE defined in spec.                  | `"sample-biddercode"` |
@@ -1370,6 +1376,7 @@ The Example Bidding adapter requires setup before beginning. Please contact us a
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
 | `placement`      | required | Placement id         | `'11111'`    | `string` |
diff --git a/dev-docs/modules/tcfControl.md b/dev-docs/modules/tcfControl.md
index ce10412285..c3d385eeaa 100644
--- a/dev-docs/modules/tcfControl.md
+++ b/dev-docs/modules/tcfControl.md
@@ -83,7 +83,7 @@ The following fields related to anonymizing aspects of the auction are supported
 Notes:
 
 * <a id="strictStorageEnforcement"></a> By default, Prebid allows some limited use of storage even when purpose 1 consent was not given: this is limited to non-PII, such as [category translation mappings](/dev-docs/modules/categoryTranslation.html), or temporary test data used to probe the browser's storage features. If `strictStorageEnforcement` is true, Purpose 1 consent will always be enforced for any access to storage.
-* To accomodate Prebid.js modules and adapters that don't have GVL IDs, the vendorExceptions list is based on Prebid.js biddercodes instead of Global Vendor List (GVL) IDs (i.e. "bidderA" instead of "12345").
+* To accommodate Prebid.js modules and adapters that don't have GVL IDs, the vendorExceptions list is based on Prebid.js biddercodes instead of Global Vendor List (GVL) IDs (i.e. "bidderA" instead of "12345").
 * An alternate way of establishing a GVL mapping is to define a 'gvlMapping' object:
 
 ```javascript
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-render-options.md b/dev-docs/plugins/bc/bc-prebid-plugin-render-options.md
index 57f5c104e7..4a60a60c3b 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-render-options.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-render-options.md
@@ -321,7 +321,7 @@ String that can be one of the following:
 * `'start'` (for preroll)
 * `'end'` (for postroll)
 * `'hh:mm:ss'` (to specify a midroll at a specific time)
-* `'hh:mm:ss.mmm'` (to specify a midroll at a specfic time, including millseconds)
+* `'hh:mm:ss.mmm'` (to specify a midroll at a specific time, including milliseconds)
 * `'n%'` (to specify a midroll to play after the specified percentage of the content video has played)
 
 **Required?**
diff --git a/dev-docs/publisher-api-reference/offEvent.md b/dev-docs/publisher-api-reference/offEvent.md
index 603b168032..e39872e19a 100644
--- a/dev-docs/publisher-api-reference/offEvent.md
+++ b/dev-docs/publisher-api-reference/offEvent.md
@@ -16,7 +16,7 @@ Turns off an event callback defined with [onEvent](/dev-docs/publisher-api-refer
 See the [getEvents](/dev-docs/publisher-api-reference/getEvents.html) function for the full list of eventTypes supported.
 
 Causes PBJS to search through registered event callbacks and remove the
-supplied callbackFunction for the specifc eventType.
+supplied callbackFunction for the specific eventType.
 
 The optional `id` parameter provides more finely-grained event
 callback de-registration.  This makes it possible to de-register callback
diff --git a/dev-docs/show-prebid-ads-on-amp-pages.md b/dev-docs/show-prebid-ads-on-amp-pages.md
index 09a80d6d63..78fdedc434 100644
--- a/dev-docs/show-prebid-ads-on-amp-pages.md
+++ b/dev-docs/show-prebid-ads-on-amp-pages.md
@@ -292,7 +292,7 @@ If you're using a custom RTC callout rather than one of the pre-defined [vendor
 
 To review that Prebid on AMP is working properly the following aspects can be looked at:
 
-- Include `#development=1` to the URL to review AMP specifc debug messages in the browser console.
+- Include `#development=1` to the URL to review AMP specific debug messages in the browser console.
 - Look for the Prebid server call in the network panel. You can open this URL in a new tab to view additional debugging information relating to the Prebid Server Stored Bid Request. If working properly, Prebid server will display the targeting JSON for AMP to use.
 - Look for the network call from the Ad Server to ensure that key values are being passed. (For Google Ad Manager these are in the `scp` query string parameter in the network request)
 - Most of the debugging information is omitted from the Prebid Server response unless the `debug=1` parameter is present in the Prebid Server query string. AMP won't add this parameter, so you'll need to grab the Prebid Server URL and manually add it to see the additional information provided.
diff --git a/overview/glossary.md b/overview/glossary.md
index 9045329b89..0a5bbeb6a2 100644
--- a/overview/glossary.md
+++ b/overview/glossary.md
@@ -150,7 +150,7 @@ A URL provided by a bidder requesting to be notified when their bid did not win
 
 ### Notice URL (nurl)
 
-A URL provided by a bidder as an alternate source of the creative. See the [nurl FAQ entry](/faq/prebid-server-faq.html#how-does-the-notice-url-work-for-prebid-server) for Prebid-specfic details.
+A URL provided by a bidder as an alternate source of the creative. See the [nurl FAQ entry](/faq/prebid-server-faq.html#how-does-the-notice-url-work-for-prebid-server) for Prebid-specific details.
 
 ## Prebid Mobile
 
diff --git a/prebid-mobile/prebid-mobile.md b/prebid-mobile/prebid-mobile.md
index c35bf8152e..08e53b6af4 100644
--- a/prebid-mobile/prebid-mobile.md
+++ b/prebid-mobile/prebid-mobile.md
@@ -178,7 +178,7 @@ Follow these steps to integrate the rendering API:
 Currently Prebid Mobile SDK doesn't offer direct analytics capabilities. While we build out analytics in Prebid Server to support the SDK, some options are:
 
 - Generate analytics from the ad server, as key metrics are available there if the line items are broken out by bidder.
-- Integrate an analytics package directly into the app. You may have one already that can accomodate header bidding metrics.
+- Integrate an analytics package directly into the app. You may have one already that can accommodate header bidding metrics.
 - Utilize a server-side [analytics module for Prebid Server](/prebid-server/developers/pbs-build-an-analytics-adapter.html).
 
 ## Further Reading
diff --git a/prebid-server/pbs-modules/51degrees-device-detection.md b/prebid-server/pbs-modules/51degrees-device-detection.md
index 4e04701aa7..6d936e3169 100644
--- a/prebid-server/pbs-modules/51degrees-device-detection.md
+++ b/prebid-server/pbs-modules/51degrees-device-detection.md
@@ -7,7 +7,7 @@ sidebarType : 5
 ---
 
 {: .alert.alert-warning :}
-51Degrees module operates using a data file. You can get started with a free Lite data file that can be downloaded [here](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash). The Lite file is updated monthly and detects limited device information. To access the daily updated full data file with comprehensive device information please [contact 51Degrees](https://51degrees.com/contact-us).
+51Degrees module operates using a data file. You can get started with a free Lite data file that can be downloaded from the [51Degrees data repository](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash). The Lite file is updated monthly and detects limited device information. To access the daily updated full data file with comprehensive device information please [contact 51Degrees](https://51degrees.com/contact-us).
 
 # 51Degrees Device Detection Module
 {:.no_toc}
@@ -43,7 +43,7 @@ pbjs.setConfig({
 
 ### Data File Updates
 
-The module operates **fully autonomously and does not make any requests to any cloud services in real time to do device detection**. This is an [on-premise data](https://51degrees.com/developers/deployment-options/on-premise-data) deployment in 51Degrees terminology. The module operates using a local data file that is loaded into memory fully or partially during operation. The data file is occasionally updated to accomodate new devices, so it is recommended to enable automatic data updates in the module configuration. Alternatively `watch_file_system` option can be used and the file may be downloaded and replaced on disk manually. See the configuration options below. 
+The module operates **fully autonomously and does not make any requests to any cloud services in real time to do device detection**. This is an [on-premise data](https://51degrees.com/developers/deployment-options/on-premise-data) deployment in 51Degrees terminology. The module operates using a local data file that is loaded into memory fully or partially during operation. The data file is occasionally updated to accommodate new devices, so it is recommended to enable automatic data updates in the module configuration. Alternatively `watch_file_system` option can be used and the file may be downloaded and replaced on disk manually. See the configuration options below.
 
 ## Setup
 
@@ -251,10 +251,11 @@ The parameter names are specified with full path using dot-notation.  F.e. `sect
 ```
 
 {: .table .table-bordered .table-striped }
+
 | PBS-Java Name | PBS-Go Name | Required| Type | Default  value | Description |
 |:-------|:-------|:------|:------|:------|:---------------------------------------|
 | `account-filter` .`allow-list` |  `account_filter` .`allow_list`  |  No | list of strings | [] (empty list) | A list of account IDs that are allowed to use this module - only relevant if enabled globally for the host. If empty, all accounts are allowed. Full-string match is performed (whitespaces and capitalization matter). |
-| `data-file` .`path`    |  `data_file` .`path`  |  **Yes** | string | null |The full path to the device detection data file. Sample file can be downloaded from [data repo on GitHub](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash), or get an Enterprise data file [here](https://51degrees.com/pricing). |
+| `data-file` .`path`    |  `data_file` .`path`  |  **Yes** | string | null |The full path to the device detection data file. Sample file can be downloaded from the [51Degrees data repository](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash), or get an Enterprise data file from the [51Degrees pricing page](https://51degrees.com/pricing). |
 | `data-file` .`make-temp-copy` | `data_file` .`make_temp_copy` | No | boolean | true | If true, the engine will create a temporary copy of the data file rather than using the data file directly. |
 | `data-file` .`update` .`auto` | `data_file` .`update` .`auto` | No | boolean | true | If enabled, the engine will periodically (at predefined time intervals - see `polling-interval` parameter) check if new data file is available. When the new data file is available engine downloads it and switches to it for device detection. If custom `url` is not specified `license_key` param is required. |
 | `data-file` .`update` .`on-startup` | `data_file` .`update` .`on_startup` | No | boolean | true | If enabled, engine will check for the updated data file right away without waiting for the defined time interval. |
diff --git a/prebid-server/pbs-modules/ortb2-blocking.md b/prebid-server/pbs-modules/ortb2-blocking.md
index 59ea5738cb..9c809859c4 100644
--- a/prebid-server/pbs-modules/ortb2-blocking.md
+++ b/prebid-server/pbs-modules/ortb2-blocking.md
@@ -687,7 +687,7 @@ This attribute is related to the 'btype' of the request.
 
 See Table 5.2 in the [OpenRTB 2.5 spec](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for the possible values.
 
-**Note:** no enforcement is possible because the creative type is not explictly
+**Note:** no enforcement is possible because the creative type is not explicitly
 part of the response and Prebid Server does not currently contain logic to
 parse creatives to derive the type.
 

From 958c238c87ce24f6f67d6c303524a4c36129fa7f Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 07:46:15 -0400
Subject: [PATCH 164/665] Fix GPT script references and clean JSDoc (#6054)

---
 dev-docs/bidder-adaptor.md                       | 16 ++++++++--------
 .../video/outstream/pb-ve-outstream-dfp.html     |  2 +-
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index e2b4d52657..9038bab88a 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -1172,7 +1172,7 @@ export const spec = {
          * Determines whether or not the given bid request is valid.
          *
          * @param {BidRequest} bid The bid params to validate.
-         * @return boolean True if this is a valid bid, and false otherwise.
+         * @return {boolean} True if this is a valid bid, and false otherwise.
          */
         isBidRequestValid: function(bid) {
             return !!(bid.params.placementId || (bid.params.member && bid.params.invCode));
@@ -1180,8 +1180,8 @@ export const spec = {
         /**
          * Make a server request from the list of BidRequests.
          *
-         * @param {validBidRequests[]} - an array of bids
-         * @return ServerRequest Info describing the request to the server.
+         * @param {BidRequest[]} validBidRequests - an array of bids
+         * @return {ServerRequest} Info describing the request to the server.
          */
         buildRequests: function(validBidRequests) {
             const payload = {
@@ -1266,7 +1266,7 @@ export const spec = {
 
     /**
      * Register bidder specific code, which will execute if bidder timed out after an auction
-     * @param {data} Containing timeout specific data
+     * @param {Object} data Containing timeout specific data
      */
     onTimeout: function(data) {
         // Bidder specifc code
@@ -1274,7 +1274,7 @@ export const spec = {
 
     /**
      * Register bidder specific code, which will execute if a bid from this bidder won the auction
-     * @param {Bid} The bid that won the auction
+     * @param {Bid} bid The bid that won the auction
      */
     onBidWon: function(bid) {
         // Bidder specific code
@@ -1282,7 +1282,7 @@ export const spec = {
 
     /**
      * Register bidder specific code, which will execute when the adserver targeting has been set for a bid from this bidder
-     * @param {Bid} The bid of which the targeting has been set
+     * @param {Bid} bid The bid of which the targeting has been set
      */
     onSetTargeting: function(bid) {
         // Bidder specific code
@@ -1290,7 +1290,7 @@ export const spec = {
 
     /**
      * Register bidder specific code, which will execute if the bidder responded with an error
-     * @param {error, bidderRequest} An object with the XMLHttpRequest error and the bid request object
+     * @param {Object} params An object with the XMLHttpRequest error and the bid request object
      */
     onBidderError: function({ error, bidderRequest }) {
         // Bidder specific code
@@ -1299,7 +1299,7 @@ export const spec = {
     /**
      * Register bidder specific code, which will execute if the ad
      * has been rendered successfully
-     * @param {bid} bid request object
+     * @param {Bid} bid Bid request object
      */
     onAdRenderSucceeded: function(bid) {
         // Bidder specific code
diff --git a/examples/video/outstream/pb-ve-outstream-dfp.html b/examples/video/outstream/pb-ve-outstream-dfp.html
index 62d52de1e2..803e067576 100644
--- a/examples/video/outstream/pb-ve-outstream-dfp.html
+++ b/examples/video/outstream/pb-ve-outstream-dfp.html
@@ -75,7 +75,7 @@ <h4>Place this code in the page header.</h4>
     <div class="pb-code-hl-wrap">
       <pre class="pb-code-hl">
   <!--put javascript code here-->
-  &lt;script async src="//securepubads.g.doubleclick.net/tag/js/gpt.js"&gt;&lt;/script&gt;
+  &lt;script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"&gt;&lt;/script&gt;
 
   &lt;script&gt;
 

From f19f8ee861542a2adbe1cec670d99ea67ee51ba5 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 07:49:35 -0400
Subject: [PATCH 165/665] docs(prebid-mobile): fix markdownlint issues (#6062)

---
 .../android-sdk-integration-gam-native.md       |  2 +-
 .../rendering/ios-sdk-integration-gam-native.md |  2 +-
 .../modules/rendering/rendering-deeplinkplus.md | 17 ++++++++---------
 .../pbm-api/android/pbm-util-android.md         |  4 +---
 .../pbm-api/ios/code-integration-ios.md         |  2 +-
 prebid-mobile/pbm-api/ios/pbm-util-ios.md       |  2 +-
 .../prebid-mobile-privacy-regulation.md         |  1 +
 7 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-gam-native.md b/prebid-mobile/modules/rendering/android-sdk-integration-gam-native.md
index 2211345625..091c282435 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-gam-native.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-gam-native.md
@@ -157,7 +157,7 @@ private fun createNativeAdConfiguration(): NativeAdConfiguration {
 }
 ```
 
-See more NativeAdConfiguration options [here](rendering-native-ad-configuration.html).
+See more NativeAdConfiguration options in the [NativeAdConfiguration guide](rendering-native-ad-configuration.html).
 
 ### Step 4: Load the Ad
 
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-gam-native.md b/prebid-mobile/modules/rendering/ios-sdk-integration-gam-native.md
index 1b378f87d3..7f99f2ac6f 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-gam-native.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-gam-native.md
@@ -173,7 +173,7 @@ let assets = [
 ]
 ```
 
-See the full description of NativeAdConfiguration options [here](rendering-native-ad-configuration.md).
+See the full description of NativeAdConfiguration options in the [NativeAdConfiguration guide](rendering-native-ad-configuration.md).
 
 ### Step 4: Load the Ad
 
diff --git a/prebid-mobile/modules/rendering/rendering-deeplinkplus.md b/prebid-mobile/modules/rendering/rendering-deeplinkplus.md
index 4b5d8c943d..b0364bfada 100644
--- a/prebid-mobile/modules/rendering/rendering-deeplinkplus.md
+++ b/prebid-mobile/modules/rendering/rendering-deeplinkplus.md
@@ -19,10 +19,10 @@ Deep Link+ provides a premium user experience while letting advertisers scale re
 
 The new deeplinking format enables buyers to submit:
 
- * primary URL
- * fallback URL
- * primary tracking URL
- * fallback tracking URL
+* primary URL
+* fallback URL
+* primary tracking URL
+* fallback tracking URL
 
 And since Deep Link+ is built into the SDK, there is no need to pop up browser windows and re-directs that deteriorate the user experience.
 
@@ -32,12 +32,11 @@ The schema is supported for both kinds of ads - video and display.
 
 The JSTag integration is not supported yet.
 
-
 ## How it works
 
-
 DSPs should rely on the SDK version in the bid request:
-```
+
+```json
 "displaymanagerver": "4.11.0"
 ```
 
@@ -45,7 +44,7 @@ Starting with version 4.11.0 Android SDK supports deeplink+
 
 To leverage the retargeting campaigns buyers use a specific scheme as click URL in the ad response. That URL describes the deep-linking and failover logic:
 
-```
+```text
 deeplink+://navigate?
     primaryUrl=PRIMARY_DEEPLINK&
     primaryTrackingUrl=PRIMARY_TRACKER&
@@ -59,7 +58,7 @@ The `fallbackUrl` can be any supported URI type (e.g., http, traditional deeplin
 
 For example, below is a Deep Link+ URL whose primary target is the Twitter app, with two (2) primary tracker URLs, a fallback URL directing the user to Twitter’s mobile website if the primary deeplink fails and zero (0) fallback tracker URLs:
 
-```
+```text
 deeplink+://navigate?
     primaryUrl=twitter%3A%2F%2Ftimeline&
     primaryTrackingUrl=http%3A%2F%2Fmopub.com%2Fclicktracking&
diff --git a/prebid-mobile/pbm-api/android/pbm-util-android.md b/prebid-mobile/pbm-api/android/pbm-util-android.md
index a5c02d08aa..f093ffbb9c 100755
--- a/prebid-mobile/pbm-api/android/pbm-util-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-util-android.md
@@ -16,11 +16,10 @@ This page will store any utilities that can used in conjuntion with the Prebid S
 {:toc}
 
 ## Find Prebid Creative Size
-Prebid SDK provides a function `findPrebidCreativeSize` to address a bug in the Google Ad Manager ad server (described [here](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!category-topic/google-admob-ads-sdk/ios/648jzAP2EQY)) where under certain situations ads fail to render. 
+Prebid SDK provides a function `findPrebidCreativeSize` to address a bug in the Google Ad Manager ad server (described in [this Google forum thread](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!category-topic/google-admob-ads-sdk/ios/648jzAP2EQY)) where under certain situations ads fail to render.
 
 It is recommended all Google Ad Manager integrations resize all ads served based on the winning Prebid creative size `findPrebidCreativeSize`. Functionally speaking the Prebid SDK resizes ad slots based on the [onAdLoaded](https://developers.google.com/android/reference/com/google/android/gms/ads/AdListener.html#onAdLoaded()) (when an ad is received) to determine the winning Prehbid ad size to determine how to resize the ad slot.
 
-
 {% include alerts/alert_note.html content="`findPrebidCreativeSize` is supported on Android API versions 19+. Using on earlier versions is safe to use, however the resizing would not function." %}
 
 Usage example:
@@ -43,4 +42,3 @@ adView.adListener = object : AdListener() {
     }
 }
 ```
-
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index 6f0b421cc8..15658748ab 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -221,7 +221,7 @@ As part of Apple's evolving privacy policies, SDKs that access user data in a wa
 
 Currently, the Prebid Mobile SDK is not classified as one of these SDKs. But future changes from Apple or internal app review policies may prompt publishers to proactively register the Prebid Server (PBS) endpoint in the privacy manifest. To support this, the Prebid SDK is designed to accommodate both tracking and non-tracking PBS domains. Here are the Prebid recommendations:
 
-- Include the relevant `NSPrivacyCollectedDataTypes` and define your primary Prebid Server domain in the `NSPrivacyTrackingDomains` array in your the `PrivacyInfo.xcprivacy` file to cover a potential "worst case" scenario. Read more about the `PrivacyInfo.xcprivacy` data [here](https://docs.prebid.org/faq/prebid-mobile-faq.html#privacysecurity).
+- Include the relevant `NSPrivacyCollectedDataTypes` and define your primary Prebid Server domain in the `NSPrivacyTrackingDomains` array in your the `PrivacyInfo.xcprivacy` file to cover a potential "worst case" scenario. Read more about the `PrivacyInfo.xcprivacy` data in the [Prebid Mobile FAQ](https://docs.prebid.org/faq/prebid-mobile-faq.html#privacysecurity).
 - You may choose to provide a secondary, privacy-mode PBS URL to the SDK. This secondary domain can be used when tracking is disallowed. Get this additional hostname from your Prebid Server host provider. Every initialization method contains optional parameter to define this privacy-safe PBS domain. Since these requests will have the `limit ad tracking` flag defined, Prebid Server will anonymize the requests.
 
 You’re not required to use a secondary PBS domain -- you can simply allow iOS to block PBS requests when the user opts out of tracking.
diff --git a/prebid-mobile/pbm-api/ios/pbm-util-ios.md b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
index afdc97915d..4ebfb2de3c 100755
--- a/prebid-mobile/pbm-api/ios/pbm-util-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-util-ios.md
@@ -17,7 +17,7 @@ This page will store any utilities that can used in conjuntion with the Prebid S
 
 ## Find Prebid Creative Size
 
-Prebid SDK provides a function `findPrebidCreativeSize` to address a bug in the Google Ad Manager ad server (described [here](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!category-topic/google-admob-ads-sdk/ios/648jzAP2EQY)) where under certain situations ads fail to render. 
+Prebid SDK provides a function `findPrebidCreativeSize` to address a bug in the Google Ad Manager ad server (described in [this Google forum thread](https://groups.google.com/forum/?utm_medium=email&utm_source=footer#!category-topic/google-admob-ads-sdk/ios/648jzAP2EQY)) where under certain situations ads fail to render.
 
 It is recommended all Google Ad Manager integrations resize all ads served based on the winning Prebid creative size `findPrebidCreativeSize`. Functionally speaking the Prebid SDK resizes ad slots based on the [adViewDidReceiveAd event](https://developers.google.com/admob/ios/banner) (when an ad is received) to determine the winning Prehbid ad size to determine how to resize the ad slot.
 
diff --git a/prebid-mobile/prebid-mobile-privacy-regulation.md b/prebid-mobile/prebid-mobile-privacy-regulation.md
index 4171f381ca..368e536103 100644
--- a/prebid-mobile/prebid-mobile-privacy-regulation.md
+++ b/prebid-mobile/prebid-mobile-privacy-regulation.md
@@ -57,6 +57,7 @@ To ensure proper monetization and relevant targeting, the SDK should be enabled
 - Describing the actions taken for the different purposeConsents values in combination with consentRequired values.
 
 {: .table .table-bordered .table-striped }
+
 |                     | deviceAccessConsent= true    | deviceAccessConsent= false     | deviceAccessConsent= undefined        |
 |---------------------|------------------------------|--------------------------------|---------------------------------------|
 |consentRequired=false<br>(gdprApplies = false)|The SDK will read and pass IDFA/AAID info to server. |The SDK will **not** read and pass IDFA/AAID info to server. | The SDK will read and pass IDFA/AAID info to server.|

From 7708e3274eee7e75f55a09b99e41c8e1ca60819c Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 27 May 2025 11:37:51 -0400
Subject: [PATCH 166/665] fix bidder markdown lint (#6064)

---
 dev-docs/bidders/deltaprojects.md | 3 ++-
 dev-docs/bidders/discovery.md     | 5 +++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/deltaprojects.md b/dev-docs/bidders/deltaprojects.md
index 397b461908..6af19c1487 100644
--- a/dev-docs/bidders/deltaprojects.md
+++ b/dev-docs/bidders/deltaprojects.md
@@ -20,6 +20,7 @@ will always bid and log values in the agreed upon currency, utilizing the curren
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name           | Scope    | Description                                                              | Example         | Type     |
 |----------------|----------|--------------------------------------------------------------------------|-----------------|----------|
 | `publisherId`  | required | Publisher ID from Delta Projects. Contact <publishers@deltaprojects.com>   | `'4'`           | `string` |
@@ -32,7 +33,7 @@ will always bid and log values in the agreed upon currency, utilizing the curren
 
 #### Banner
 
-```
+```javascript
 var adUnits = [
   {
     code: 'adunit-code',
diff --git a/dev-docs/bidders/discovery.md b/dev-docs/bidders/discovery.md
index e094aea49c..c56c23fffe 100644
--- a/dev-docs/bidders/discovery.md
+++ b/dev-docs/bidders/discovery.md
@@ -15,6 +15,7 @@ The DiscoveryDSP Bidding adapter requires setup before beginning. Please contact
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
 | `token`      | required | publisher token        | `'1e100887dd614b7f69fdd1360437'`    | `string` |
@@ -26,7 +27,7 @@ The DiscoveryDSP Bidding adapter requires setup before beginning. Please contact
 
 banner
 
-```
+```javascript
 var adUnits = [
       {
         code: "test-div-1",
@@ -51,7 +52,7 @@ var adUnits = [
 
 native
 
-```
+```javascript
 var adUnits = [
       {
         code: "test-div-2",

From 813930313e00a8fbe9e04b20ed46b0535ac90386 Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Wed, 28 May 2025 11:25:18 -0700
Subject: [PATCH 167/665] added new endpoint compression flag (#6070)

This will help to know which bidders support Endpoint Compression!
---
 _includes/dev-docs/bidder-meta-data.html | 10 ++++++++--
 dev-docs/bidders/pubmatic.md             |  1 +
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/_includes/dev-docs/bidder-meta-data.html b/_includes/dev-docs/bidder-meta-data.html
index 734f9bbff4..4fd1a4da92 100644
--- a/_includes/dev-docs/bidder-meta-data.html
+++ b/_includes/dev-docs/bidder-meta-data.html
@@ -54,14 +54,18 @@
       <td class="pbTd">{% if page.fpd_supported == true %}yes{% elsif page.fpd_supported == false %}no{% else %}check with bidder{% endif %}</td>
     </tr>
     <tr>
-      <th class="pbTh">User IDs</th>
-      <td class="pbTd">{% if page.userIds and page.userIds != '' %}{{page.userIds}}{% else %}none{% endif %}</td>
+      <th class="pbTh">Endpoint Compression</th>
+      <td class="pbTd">{% if page.endpoint_compression == true %}yes{% elsif page.endpoint_compression == false %}no{% else %}check with bidder{% endif %}</td>
       <th class="pbTh">ORTB Blocking Support</th>
       <td class="pbTd">{% if page.ortb_blocking_supported == true %}yes{% elsif page.ortb_blocking_supported == false %}no{% elsif page.ortb_blocking_supported == 'partial' %}partial{% else %}check with bidder{% endif %}</td>
     </tr>
     <tr>
+      <th class="pbTh">User IDs</th>
+      <td class="pbTd">{% if page.userIds and page.userIds != '' %}{{page.userIds}}{% else %}none{% endif %}</td>
       <th class="pbTh">Privacy Sandbox</th>
       <td class="pbTd">{% if page.privacy_sandbox %}{{page.privacy_sandbox}}{% else %}check with bidder{% endif %}</td>
+    </tr>
+    <tr>
       {% if page.pbs == true %}
       <th class="pbTh">Prebid Server App Support</th>
       <td class="pbTd">{% if page.pbs_app_supported == false %}no{% elsif page.pbs_app_supported == true %}yes{% else %}check with bidder{% endif %}</td>
@@ -69,6 +73,8 @@
       <th class="pbTh"></th>
       <td class="pbTd"></td>
       {% endif %}
+      <th class="pbTh"></th>
+      <td class="pbTd"></td>
     </tr>
 
   </table>
diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 24b1e44080..706217f9c7 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -22,6 +22,7 @@ ortb_blocking_supported: true
 gvl_id: 76
 multiformat_supported: will-bid-on-one
 sidebarType: 1
+endpoint_compression: true
 ---
 
 ### Prebid Server Note

From 1d6d32c0de3360e780c39db97c00628c94341eb0 Mon Sep 17 00:00:00 2001
From: jkneiphof <64132960+jkneiphof@users.noreply.github.com>
Date: Thu, 29 May 2025 14:41:19 +0200
Subject: [PATCH 168/665] Welect Adapter: update docs with new params (#6058)

---
 dev-docs/bidders/welect.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/welect.md b/dev-docs/bidders/welect.md
index 40879ba494..fecc3b5bad 100644
--- a/dev-docs/bidders/welect.md
+++ b/dev-docs/bidders/welect.md
@@ -24,15 +24,16 @@ sidebarType: 1
 ---
 
 ### Note
+
 The Welect bidder adapter requires setup and approval from the Welect team. Please reach out to [dev@welect.de](mailto:dev@welect.de) for more information.
 
 ### Bid params
 
 {: .table .table-bordered .table-striped }
+
 | Name | Description | Example | Type |
 |---|---|---|---|
 | `placementId` | an identifier for your placement, provided by Welect | `'exampleID'` | `string` |
-| `domain` | The domain of your placement | `'www.example.com'` | `string` |
 
 ### Example Ad Unit Setup
 
@@ -41,13 +42,12 @@ var adUnits = [
   {
     bidder: 'welect',
     params: {
-      placementId: 'exampleId',
-      domain: 'www.welect.de'
+      placementId: 'exampleId'
     },
-    sizes: [[640, 360]],
     mediaTypes: {
       video: {
-        context: 'instream'
+        context: 'instream',
+        playerSize: [640, 360]
       }
     },
   };

From 3b3ad1bf632696e46c1edd1c811d488710b1bc08 Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Thu, 29 May 2025 14:41:46 +0200
Subject: [PATCH 169/665] movingup and glomex added (#6068)

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/glomexbidder.md | 125 +++++++++++++++++++++++++++++++
 dev-docs/bidders/movingup.md     | 125 +++++++++++++++++++++++++++++++
 2 files changed, 250 insertions(+)
 create mode 100644 dev-docs/bidders/glomexbidder.md
 create mode 100644 dev-docs/bidders/movingup.md

diff --git a/dev-docs/bidders/glomexbidder.md b/dev-docs/bidders/glomexbidder.md
new file mode 100644
index 0000000000..07c6b00523
--- /dev/null
+++ b/dev-docs/bidders/glomexbidder.md
@@ -0,0 +1,125 @@
+---
+layout: bidder
+title: Glomex Bidder
+description: Prebid Glomex Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: glomexbidder
+gvl_id: 967
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: true
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | optional | tag ID                     | `"testnexx"`                              | `string`  |
+| `placement`   | optional | Placement                  | `"test"`                                  | `string`  |
+
+For the prebid.js you only need to use one parameter: either tagId or placement
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'glomexbidder',
+         params: {
+            tagId: 'testeasy'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'glomexbidder',
+            params: {
+               tagId: 'testeasy'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'glomexbidder',
+            params: {
+               tagId: 'testeasy'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'glomexbidder',
+            params: {
+               tagId: 'testeasy',
+               videoTagId: 'testeasy'
+            }
+        }]
+    };
+];
+```
diff --git a/dev-docs/bidders/movingup.md b/dev-docs/bidders/movingup.md
new file mode 100644
index 0000000000..1b4ddb8e1e
--- /dev/null
+++ b/dev-docs/bidders/movingup.md
@@ -0,0 +1,125 @@
+---
+layout: bidder
+title: Moving Up
+description: Prebid Moving Up Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: movingup
+gvl_id: 1416
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: true
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | optional | tag ID                     | `"testnexx"`                              | `string`  |
+| `placement`   | optional | Placement                  | `"test"`                                  | `string`  |
+
+For the prebid.js you only need to use one parameter: either tagId or placement
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'movingup',
+         params: {
+            tagId: 'testeasy'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'movingup',
+            params: {
+               tagId: 'testeasy'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'movingup',
+            params: {
+               tagId: 'testeasy'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'movingup',
+            params: {
+               tagId: 'testeasy',
+               videoTagId: 'testeasy'
+            }
+        }]
+    };
+];
+```

From 4f2cd47d8b4d51e6a75c987b3b64e15f4604df2e Mon Sep 17 00:00:00 2001
From: Komal Kumari <169047654+pm-komal-kumari@users.noreply.github.com>
Date: Thu, 29 May 2025 18:12:33 +0530
Subject: [PATCH 170/665] Update docs for getAllPrebidWinningBids API (#6069)

Co-authored-by: Komal Kumari <komalkumari@Komals-MacBook-Pro-L1834.local>
---
 dev-docs/publisher-api-reference/getAllPrebidWinningBids.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/getAllPrebidWinningBids.md b/dev-docs/publisher-api-reference/getAllPrebidWinningBids.md
index 9d9bb09271..251f4f760b 100644
--- a/dev-docs/publisher-api-reference/getAllPrebidWinningBids.md
+++ b/dev-docs/publisher-api-reference/getAllPrebidWinningBids.md
@@ -6,6 +6,6 @@ sidebarType: 1
 ---
 
 
-Use this method to get all of the bids that have won their respective auctions but not rendered on the page.  Useful for [troubleshooting your integration]({{site.baseurl}}/dev-docs/prebid-troubleshooting-guide.html).
+Use this method to get all the bids that have been used to generate targeting but have not yet been rendered on the page. It matches winning bids only after targeting has been applied and before the ad is rendered. Useful for [troubleshooting your integration]({{site.baseurl}}/dev-docs/prebid-troubleshooting-guide.html).
 
-* `pbjs.getAllPrebidWinningBids()`: returns an array of bid objects that have won their respective auctions but not rendered on the page.
+* `pbjs.getAllPrebidWinningBids()`: returns an array of bid objects that have been used to generate targeting and have not yet been rendered on the page.

From b9e31726dbe8dbee749b3230d0dc9c93e2e99484 Mon Sep 17 00:00:00 2001
From: Flo <52820762+Floz42@users.noreply.github.com>
Date: Thu, 29 May 2025 14:43:09 +0200
Subject: [PATCH 171/665] update weborama rtd module documentation (#6050)

Co-authored-by: Florian THIEBAUD <fthiebaud@weborama.com>
Co-authored-by: Tiago Peczenyj <tpeczenyj@weborama.com>
---
 dev-docs/modules/weboramaRtdProvider.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/dev-docs/modules/weboramaRtdProvider.md b/dev-docs/modules/weboramaRtdProvider.md
index d3046f2890..f558c47da3 100644
--- a/dev-docs/modules/weboramaRtdProvider.md
+++ b/dev-docs/modules/weboramaRtdProvider.md
@@ -150,12 +150,8 @@ On this section we will explain the `params.weboUserDataConf` subconfiguration:
 
 ##### User Consent
 
-The WAM User-Centric configuration will check for user consent if gdpr applies. It will check for consent:
-
-* Vendor ID 284 (Weborama)
-* Purpose IDs: 1, 3, 4, 5 and 6
-
-If the user consent does not match such conditions, this module will not load, means we will not check for any data in local storage and the default profile will be ignored.
+In a user-centric configuration, the WAM module will verify user consent when GDPR is applicable. It specifically checks for consent related to the purposes declared by Weborama in the Global Vendor List (Vendor ID 284). 
+If the required consent is not provided, the module will not activate, and it will neither access local storage nor apply any default user profile.
 
 #### Sfbx LiTE Site-Centric Configuration
 

From 46e0423cbebab72165dda7fb1d0771c5562f8959 Mon Sep 17 00:00:00 2001
From: ProgrammaticX <pxteam@programmaticx.ai>
Date: Thu, 29 May 2025 15:46:24 +0300
Subject: [PATCH 172/665] ProgrammaticX: new adapter (#6049)

* init new adapter

* Turn prebid-server support to false

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/programmaticX.md | 36 +++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/programmaticX.md

diff --git a/dev-docs/bidders/programmaticX.md b/dev-docs/bidders/programmaticX.md
new file mode 100644
index 0000000000..ce4c993f72
--- /dev/null
+++ b/dev-docs/bidders/programmaticX.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: ProgrammaticX
+description: Prebid ProgrammaticX Bidder Adapter
+biddercode: ProgrammaticX
+gpp_sids: usstate_all
+gvl_id: 1344
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 7cd168d9479e80ef583327c84296ba404f9260a2 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 29 May 2025 11:04:32 -0400
Subject: [PATCH 173/665] docs(consentManagementGpp): document actionTimeout
 (#6071)

---
 dev-docs/modules/consentManagementGpp.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/modules/consentManagementGpp.md b/dev-docs/modules/consentManagementGpp.md
index 9a99ac96ce..fe72296cdd 100644
--- a/dev-docs/modules/consentManagementGpp.md
+++ b/dev-docs/modules/consentManagementGpp.md
@@ -54,11 +54,13 @@ Once the CMP is implemented, simply include this module into your build and add
 Here are the parameters supported in the `consentManagement` object specific for the GPP consent module:
 
 {: .table .table-bordered .table-striped }
+
 | Param | Type | Description | Example |
 | --- | --- | --- | --- |
 | gpp | `Object` | | |
 | gpp.cmpApi | `string` | The CMP interface that is in use. Supported values are **'iab'** or **'static'**. Static allows integrations where IAB-formatted consent strings are provided in a non-standard way. Default is `'iab'`. | `'iab'` |
 | gpp.timeout | `integer` | Length of time (in milliseconds) to allow the CMP to obtain the GPP consent information. Default is `10000`. | `10000` |
+| gpp.actionTimeout | `integer` | Length of time (in milliseconds) to allow the user to take action to consent if they have not already done so. The actionTimer first waits for the CMP to load, then the actionTimeout begins for the specified duration. Default is `undefined`. | `10000` |
 | gpp.consentData | `Object` | An object representing the IAB GPP consent data being passed directly; only used when cmpApi is 'static'. Default is `undefined`. | |
 | gpp.consentData.sectionId | `integer` | Indicates the header section of the GPP consent string, recommended to be `3`. | |
 | gpp.consentData.gppVersion | `string` | The version number parsed from the header of the GPP consent string. | |

From aa1daab53bdf79c19fc2fac83de2031d04d2f6c1 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 29 May 2025 11:14:41 -0400
Subject: [PATCH 174/665] docs: add missing fpidStorageType parameter for
 1plusX RTD (#6072)

---
 dev-docs/modules/1plusXRtdProvider.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/1plusXRtdProvider.md b/dev-docs/modules/1plusXRtdProvider.md
index de13dc775c..8ce79efad6 100644
--- a/dev-docs/modules/1plusXRtdProvider.md
+++ b/dev-docs/modules/1plusXRtdProvider.md
@@ -46,7 +46,8 @@ pbjs.setConfig({
             params: {
                 customerId: 'acme',
                 bidders: ['appnexus', 'rubicon'],
-                timeout: TIMEOUT
+                timeout: TIMEOUT,
+                fpidStorageType: 'html5'
             }
         }]
     }
@@ -56,6 +57,7 @@ pbjs.setConfig({
 ## Parameters
 
 {: .table .table-bordered .table-striped }
+
 | Name              | Type          | Description                                                      | Default           |
 | :---------------- | :------------ | :--------------------------------------------------------------- |:----------------- |
 | name              | String        | Real time data module name                                       | Always '1plusX'   |
@@ -64,3 +66,4 @@ pbjs.setConfig({
 | params.customerId | String        | Your 1plusX customer id                                          |                   |
 | params.bidders    | Array<string> | List of bidders for which you would like data to be set          |                   |
 | params.timeout    | Integer       | timeout (ms)                                                     | 1000ms            |
+| params.fpidStorageType | String | Where to read the first party id ('html5' or 'cookie') | 'html5' |

From e61d72dd98485cb12017d3c706d786f63d5c9a48 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 3 Jun 2025 02:35:01 -0400
Subject: [PATCH 175/665] Fix markdown lint issues (#6075)

---
 prebid/native-implementation-legacy.md | 2 ++
 prebid/prebidjsReleases.md             | 1 +
 2 files changed, 3 insertions(+)

diff --git a/prebid/native-implementation-legacy.md b/prebid/native-implementation-legacy.md
index 457457330c..6ae5c5808c 100644
--- a/prebid/native-implementation-legacy.md
+++ b/prebid/native-implementation-legacy.md
@@ -52,6 +52,7 @@ This table summarizes how the 3 approaches work:
 **Table 1: Native Implementation Approaches**
 
 {: .table .table-bordered .table-striped }
+
 | Component | AdServer-Defined Creative Scenario | AdUnit-Defined Creative Scenario | Custom Renderer Scenario |
 | --- | --- |--- | --- |
 | Prebid.js | mediaTypes. native.sendTargetingKeys: false | sendTargetingKeys:false and mediaTypes.native.adTemplate contains ##macros## | sendTargetingKeys:false and mediaTypes.native.rendererUrl |
@@ -67,6 +68,7 @@ The Prebid.js AdUnit needs to defines a native mediatype object to tell bidders
 **Table 2: Prebid.js AdUnit Native MediaType Options**
 
 {: .table .table-bordered .table-striped }
+
 | Attribute | Scope | Description | Example | Type |
 | --- | --- | --- | --- | --- |
 | sendTargetingKeys | optional | Defines whether or not to send the hb_native_ASSET targeting keys to the ad server. Defaults to `true` for now, though we recommend setting this to `false` and utilizing one of the ways to define a native template. | `false` | boolean |
diff --git a/prebid/prebidjsReleases.md b/prebid/prebidjsReleases.md
index 22896dd6e8..e439249778 100644
--- a/prebid/prebidjsReleases.md
+++ b/prebid/prebidjsReleases.md
@@ -14,6 +14,7 @@ the [GitHub releases page](https://github.com/prebid/Prebid.js/releases) can be
 The table below is a summary of feature changes and important bug fixes in core of Prebid.js. Almost [all releases](https://github.com/prebid/Prebid.js/releases) have new bid adapters or updates to existing adapters -- what's listed here is limited to core functionality. Releases with only minor core changes may not be shown here, and releases with multiple important changes may be shown more than once.
 
 {: .table .table-bordered .table-striped }
+
 | Release | Feature |
 | --- | --- |
 | 8.0 | Module removals, reliabe (opt-in) transaction identifier, size mapping module & acitivy control. See the [PBJS 8 release notes](/dev-docs/pb8-notes.html) |

From 850bb6fd6a6bf8d806cc68a9a3cebbe90d5fc57b Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 3 Jun 2025 02:40:05 -0400
Subject: [PATCH 176/665] Codex/document gvlmapping based on tests (#6082)

* docs: add gvlMapping configuration

* Update .gitignore

* Update prebidServer.md

* fix markdown lint

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/prebidServer.md              |  2 ++
 dev-docs/publisher-api-reference/setConfig.md | 20 +++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index e22a972cf4..462fa31719 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -204,6 +204,8 @@ Here's how it works:
 1. The s2sConfig.bidders array contains 'tripleliftVideo' telling Prebid.js to direct bids for that code to the server
 1. Finally, the extPrebid.aliases line tells Prebid Server to route the 'tripleliftVideo' biddercode to the 'triplelift' server-side adapter.
 
+Make sure to register your aliases' [`gvlMapping`](/dev-docs/publisher-api-reference/setConfig.html#setConfig-gvlMapping) via setConfig as well.
+
 ### Routing for Multiple PBS instances
 
 Bids:
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 814c50982c..8c828a863a 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -982,6 +982,7 @@ The Prebid Video Module allows Prebid to directly integrate with a Video Player,
 To register a video player with Prebid, you must use `setConfig` to set a `video` config compliant with the following structure:
 
 {: .table .table-bordered .table-striped }
+
 | Field | Required? | Type | Description |
 |---|---|---|---|
 | video.providers[] | yes | array of objects | List of Provider configurations. You must define a provider configuration for each player instance that you would like integrate with. |
@@ -1333,6 +1334,7 @@ pbjs.setConfig({
 The controls publishers have over the RTD modules:
 
 {: .table .table-bordered .table-striped }
+
 | Field | Required? | Type | Description |
 |---|---|---|---|
 | realTimeData.auctionDelay | no | integer | Defines the maximum amount of time, in milliseconds, the header bidding auction will be delayed while waiting for a response from the RTD modules as a whole group. The default is 0 ms delay, which means that RTD modules need to obtain their data when the page initializes. |
@@ -1386,6 +1388,7 @@ pbjs.setConfig({
 ```
 
 {: .table .table-bordered .table-striped }
+
 | Field | Required? | Type | Description |
 |---|---|---|---|
 | topics.maxTopicCaller | no | integer | Defines the maximum numbers of Bidders Iframe which needs to be loaded on the publisher page. Default is 1 which is hardcoded in Module. Eg: topics.maxTopicCaller is set to 3. If there are 10 bidders configured along with their iframe URLS, random 3 bidders iframe URL is loaded which will call TOPICS API. If topics.maxTopicCaller is set to 0, it will load random 1(default) bidder iframe atleast. |
@@ -1420,6 +1423,23 @@ Inversely, if you wish for the alias registry to be private you can do so by usi
 pbjs.setConfig({aliasRegistry: 'private'})
 ```
 
+<a id="setConfig-gvlMapping"></a>
+
+### Map modules to Global Vendor IDs
+
+Prebid modules sometimes need to know the [IAB Global Vendor List](https://iabeurope.eu/tcf-for-vendors/) (GVL) ID associated with a bidder alias or other module. The optional `gvlMapping` object lets publishers specify these IDs or override the ones declared by the module itself.
+
+```javascript
+pbjs.setConfig({
+  gvlMapping: {
+    appnexus: 4,
+    someModule: 123
+  }
+});
+```
+
+Prebid Server uses this mapping when it sends `ext.prebid.aliasgvlids` for bidder aliases, and the [TCF Control Module](/dev-docs/modules/tcfControl.html) references it when enforcing consent.
+
 ### Set Max Bid
 
 <a id="setConfig-maxBid"></a>

From 053517fbc0e28b5394ae0513d644fc6bbe4de36f Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 3 Jun 2025 02:40:48 -0400
Subject: [PATCH 177/665] docs: document additional bidder params (#6081)

---
 dev-docs/bidders/33across.md | 2 ++
 dev-docs/bidders/mediago.md  | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/dev-docs/bidders/33across.md b/dev-docs/bidders/33across.md
index c5dea1516c..7ba0f57f03 100644
--- a/dev-docs/bidders/33across.md
+++ b/dev-docs/bidders/33across.md
@@ -26,10 +26,12 @@ sidebarType: 1
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+ 
 | Name        | Scope    | Description                                                                                                                    | Example    | Type     |
 |-------------|----------|--------------------------------------------------------------------------------------------------------------------------------|------------|----------|
 | `siteId`    | required | Publisher  GUID from 33Across                                                                                                  | `'examplePub123'` | `string` |
 | `productId` | required | 33Across Product ID that the Publisher has registered for (use `'siab'` for Banner or Outstream Video , `'inview'` for Adhesion, `'instream'` for Instream Video) | `'siab'`   | `string` |
+| `test` | optional | Set to `1` to enable test mode | `1` | `integer` |
 
 ### Ad Unit Setup for Banner
 
diff --git a/dev-docs/bidders/mediago.md b/dev-docs/bidders/mediago.md
index 75f2d26c8e..bb59226972 100644
--- a/dev-docs/bidders/mediago.md
+++ b/dev-docs/bidders/mediago.md
@@ -27,6 +27,7 @@ The MediaGo Bidding adapter requires setup before beginning. Please contact us a
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+ 
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
 | `token`      | required | publisher token, This parameter expects all imps to be the same        | `'1e100887dd614b7f69fdd1360437'`    | `string` |
@@ -35,3 +36,4 @@ The MediaGo Bidding adapter requires setup before beginning. Please contact us a
 | `bidfloor` | recommend | Sets a floor price for the bid. This parameter is available for PBJS only. | `0.05` | `float` |
 | `publisher`      | required | publisher id         | `'abcdefg'`    | `string` |
 | `placementId` | recommend | The AD placement ID | `12341234` | `string` |
+| `tagid` | optional | Tag identifier for the impression | `"1"` | `string` |

From bda8bc3097d2ab120e87e9c659b4df09e634f69b Mon Sep 17 00:00:00 2001
From: Seba Perez <12091528+sebaperez@users.noreply.github.com>
Date: Tue, 3 Jun 2025 03:42:00 -0300
Subject: [PATCH 178/665] EPlanning: Update bidder docs information (#6080)

---
 dev-docs/bidders/eplanning.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/eplanning.md b/dev-docs/bidders/eplanning.md
index 3938737592..1afca16057 100644
--- a/dev-docs/bidders/eplanning.md
+++ b/dev-docs/bidders/eplanning.md
@@ -8,18 +8,20 @@ media_types: banner, video
 biddercode: eplanning
 usp_supported: true
 tcfeu_supported: true
+schain_supported: true
 pbs_app_supported: true
 floors_supported: true
 userIds: all
 gvl_id: 90
 sidebarType: 1
+prebid_member: true
 ---
 
 
 
 ### Note
 
-The E-Planning Header Bidding adaptor requires setup and approval from the E-Planning team. Please go to [E-Planning website](http://www.e-planning.net) for more details.
+To use E-Planning bidder, you need to have an existing E-Planning account. To create a new account visit <https://www.e-planning.net/signup.html>. If you are an existing user, contact your account rep for information.
 
 ### Bid Params
 

From 19ee99bfa2a13018051aaabb4b0ad98b5523e648 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 3 Jun 2025 02:49:37 -0400
Subject: [PATCH 179/665] docs: add parameter tables for several modules
 (#6077)

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/arcspanRtdProvider.md     |  8 ++++++++
 dev-docs/modules/categoryTranslation.md    |  8 ++++++++
 dev-docs/modules/confiantRtdProvider.md    | 11 +++++++++++
 dev-docs/modules/dsaControl.md             | 11 ++++++++++-
 dev-docs/modules/freewheel.md              |  9 +++++++++
 dev-docs/modules/mediafilterRtdProvider.md |  8 ++++++++
 6 files changed, 54 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/arcspanRtdProvider.md b/dev-docs/modules/arcspanRtdProvider.md
index 5f90e986b3..b2fa82bd16 100644
--- a/dev-docs/modules/arcspanRtdProvider.md
+++ b/dev-docs/modules/arcspanRtdProvider.md
@@ -56,5 +56,13 @@ pbjs.setConfig({
 })
 ```
 
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `silo` | Integer | ArcSpan provided silo identifier used to load the contextual script | yes | n/a |
+
 {: .alert.alert-info :}
 For best results, we recommend that you also deploy ArcSpan's JavaScript tag in your tag management solution, as instructed in the implementation overview you received from your ArcSpan representative. This will ensure that more of your auctions contain ArcSpan's contextual signals. Please reach out to your ArcSpan representative if you have any questions.
diff --git a/dev-docs/modules/categoryTranslation.md b/dev-docs/modules/categoryTranslation.md
index aaa01b8d8b..8651c6aff1 100644
--- a/dev-docs/modules/categoryTranslation.md
+++ b/dev-docs/modules/categoryTranslation.md
@@ -38,6 +38,14 @@ pbjs.setConfig({
 });
 ```
 
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `translationFile` | String | URL of a custom brand category translation map | no | Prebid default map |
+
 This file will be stored locally to expedite the conversion process. If a publisher opts to not provide a conversion mapping file Prebid will use its default conversion mapping file.
 
 Publishers should ensure that the JSON returned from their custom file is valid for Prebid by adhering to the following structure:
diff --git a/dev-docs/modules/confiantRtdProvider.md b/dev-docs/modules/confiantRtdProvider.md
index e8c8af20b7..7d881c4386 100644
--- a/dev-docs/modules/confiantRtdProvider.md
+++ b/dev-docs/modules/confiantRtdProvider.md
@@ -53,3 +53,14 @@ pbjs.setConfig({
     }
 });
 ```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `propertyId` | String | Identifier provided by Confiant | yes | n/a |
+| `prebidExcludeBidders` | String | Comma separated bidder codes to exclude from Confiant scanning | no | empty |
+| `prebidNameSpace` | String | Custom namespace for the integration | no | empty |
+| `shouldEmitBillableEvent` | Boolean | Emit a billable event when a Confiant scan occurs | no | `false` |
diff --git a/dev-docs/modules/dsaControl.md b/dev-docs/modules/dsaControl.md
index 7df4d686d9..9df36217eb 100644
--- a/dev-docs/modules/dsaControl.md
+++ b/dev-docs/modules/dsaControl.md
@@ -30,7 +30,7 @@ pbjs.setConfig({
       regs: {
           ext: {
               dsa: {
-                  dsarequired: 2,  
+                  dsarequired: 2,
                   pubrender: 0
                   // ...
               }
@@ -40,6 +40,15 @@ pbjs.setConfig({
 })
 ```
 
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `dsarequired` | Integer | Indicates if DSA transparency information must be included (`0` = not required, `2` = required but advertiser may render, `3` = required and advertiser must render) | yes | n/a |
+| `pubrender` | Integer | Signals publisher rendering capabilities (`0` = cannot render, `2` = will render) | yes | n/a |
+
 This module will then enforce that:
 
 * all bids include DSA information, if required (`dsarequired` is either `2` or `3`);
diff --git a/dev-docs/modules/freewheel.md b/dev-docs/modules/freewheel.md
index c6a4308360..43f23ea15e 100644
--- a/dev-docs/modules/freewheel.md
+++ b/dev-docs/modules/freewheel.md
@@ -59,6 +59,15 @@ pbjs.adServers.freewheel.getTargeting({
 }
 ```
 
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `codes` | Array<string> | AdUnit codes to retrieve targeting for | yes | n/a |
+| `callback` | Function | Function invoked with error and targeting map | yes | n/a |
+
 The values returned by `getTargeting` are concatenation of CPM, industy code, and video duration. FreeWheel SDK will send those values to FreeWheel Ad Server within the following query:
 
 ```text
diff --git a/dev-docs/modules/mediafilterRtdProvider.md b/dev-docs/modules/mediafilterRtdProvider.md
index 3020d971f9..74dab375c2 100644
--- a/dev-docs/modules/mediafilterRtdProvider.md
+++ b/dev-docs/modules/mediafilterRtdProvider.md
@@ -47,3 +47,11 @@ pbjs.setConfig({
     }
 });
 ```
+
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Description | Required | Default |
+| :--- | :--- | :--- | :--- | :--- |
+| `configurationHash` | String | Hash provided by The Media Trust to load the protection script | yes | n/a |

From 04adbcd494e6fa322355b78a517d6b34c4c7e8f2 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Tue, 3 Jun 2025 04:46:21 -0400
Subject: [PATCH 180/665] Codex: Add config upload and zip download (#6065)

* Add config upload and zip download

* Remove JSZip usage from download page

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 assets/js/download.js | 70 ++++++++++++++++++++++++++++++++++++-------
 download.md           |  3 ++
 2 files changed, 63 insertions(+), 10 deletions(-)

diff --git a/assets/js/download.js b/assets/js/download.js
index e5cc8f7538..86e9175532 100644
--- a/assets/js/download.js
+++ b/assets/js/download.js
@@ -9,6 +9,24 @@
         $(".adapters .col-md-4").show();
         setPrepickedModules();
 
+        var configInput = document.getElementById('configFileInput');
+        if (configInput) {
+            configInput.addEventListener('change', function(event) {
+                var file = event.target.files[0];
+                if (!file) return;
+                var reader = new FileReader();
+                reader.onload = function(e) {
+                    try {
+                        var cfg = JSON.parse(e.target.result);
+                        applyConfig(cfg);
+                    } catch (err) {
+                        alert('Invalid configuration file');
+                    }
+                };
+                reader.readAsText(file);
+            });
+        }
+
         document.getElementById('download-button').addEventListener('click', function (event) {
             event.preventDefault();
             submit_download();
@@ -79,9 +97,7 @@
             setTimeout(function () {
                 $('#download-button').html('<i class="glyphicon glyphicon-download-alt"></i> Download Prebid.js').removeClass('disabled');
             }, 5000);
-            // Try to find out the filename from the content disposition `filename` value
             var filename = "prebid" + form_data["version"] + ".js";
-            // this doens't work in our current jquery version.
             var disposition = jqXHR.getResponseHeader("Content-Disposition");
             if (disposition && disposition.indexOf("attachment") !== -1) {
                 var filenameRegex = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/;
@@ -89,14 +105,13 @@
                 if (matches != null && matches[1])
                     filename = matches[1].replace(/['"]/g, "");
             }
-            // The actual download
-            var blob = new Blob([data], { type: "text/javascript" });
-            var link = document.createElement("a");
-            link.href = window.URL.createObjectURL(blob);
-            link.download = filename;
-            document.body.appendChild(link);
-            link.click();
-            document.body.removeChild(link);
+
+            var jsBlob = new Blob([data], { type: "text/javascript" });
+            var configData = JSON.stringify({ version: form_data.version, modules: form_data.modules }, null, 2);
+
+            triggerDownload(jsBlob, filename);
+            triggerDownload(new Blob([configData], { type: "application/json" }), "prebid-config.json");
+
             if (form_data["removedModules"].length > 0) {
                 alert(
                     "The following modules were removed from your download because they aren't present in Prebid.js version " +
@@ -112,6 +127,15 @@
         });
     }
 
+    function triggerDownload(blob, filename) {
+        var link = document.createElement("a");
+        link.href = window.URL.createObjectURL(blob);
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+    }
+
     const renameModules = (function() {
         const RENAMES = [
             [
@@ -206,6 +230,32 @@
         });
     }
 
+    function applyConfig(cfg) {
+        if (!cfg) return;
+        if (cfg.version) {
+            var versionOption = document.querySelector('#version_selector option[value="' + cfg.version + '"]');
+            if (versionOption) {
+                versionOption.selected = true;
+                searchParams.set("version", cfg.version);
+            }
+        }
+
+        if (Array.isArray(cfg.modules)) {
+            var moduleCheckboxes = document.querySelectorAll('.module-check-box');
+            moduleCheckboxes.forEach(function(cb){ cb.checked = false; });
+            cfg.modules.forEach(function(module){
+                var cb = document.getElementById(module);
+                if (cb) cb.checked = true;
+            });
+            if (cfg.modules.length) {
+                searchParams.set("modules", cfg.modules.join(','));
+            } else {
+                searchParams.delete("modules");
+            }
+            window.history.replaceState(null, "", window.location.pathname + "?" + searchParams.toString());
+        }
+    }
+
     function setPrepickedVersion() {
         var version = searchParams.get("version");
         if (version) {
diff --git a/download.md b/download.md
index 9c6f6fcacd..9226c1d162 100644
--- a/download.md
+++ b/download.md
@@ -64,6 +64,9 @@ Prebid.js is open source software that is offered for free as a convenience. Whi
 <h4>Select Prebid Version</h4>
 <select id="version_selector" class="selectpicker">
 </select>
+<br/>
+<label for="configFileInput"><strong>Upload Configuration</strong></label>
+<input type="file" id="configFileInput" accept="application/json" />
 <br>
 <h4>Select Bidder Adapters</h4>
 <div class="row adapters">

From 186aeeea769fe4fc0c9609a29a228feadc065e9c Mon Sep 17 00:00:00 2001
From: ghluo-fw <ghluo@freewheel.com>
Date: Fri, 6 Jun 2025 15:13:34 +0800
Subject: [PATCH 181/665] add fwssp.md (#6000)

---
 dev-docs/bidders/fwssp.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 dev-docs/bidders/fwssp.md

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
new file mode 100644
index 0000000000..ea59bac082
--- /dev/null
+++ b/dev-docs/bidders/fwssp.md
@@ -0,0 +1,25 @@
+---
+layout: bidder
+title: FWSSP
+description: Freewheel Bidder Adaptor
+pbs: true
+biddercode: fwssp
+gvl_id: 285
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: video
+ortb_blocking_supported: partial
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description | Example | Type     |
+|----------|----------|-------------------------|--------|----------|
+| `custom_site_section_id` | required | custom Site Section tag or numeric Site Section ID | "ss_12345" | `string` |
+| `network_id` | required | Network ID | "12345" | `string` |
+| `profile_id` | required | The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "prof_12345" | `string` |
+

From fb811cca8a06d82140c967d824d32371a636f26a Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 7 Jun 2025 04:18:56 -0400
Subject: [PATCH 182/665] Codex/document undocumented public api functions
 (#6092)

* docs: add missing public api pages

* Delete dev-docs/publisher-api-reference/createBid.md
---
 .../getAdserverTargetingForAdUnitCodeStr.md   | 27 ++++++++++++++++++
 .../publisher-api-reference/processQueue.md   | 18 ++++++++++++
 .../registerAnalyticsAdapter.md               | 28 +++++++++++++++++++
 .../registerBidAdapter.md                     | 28 +++++++++++++++++++
 .../triggerUserSyncs.md                       | 16 +++++++++++
 5 files changed, 117 insertions(+)
 create mode 100644 dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
 create mode 100644 dev-docs/publisher-api-reference/processQueue.md
 create mode 100644 dev-docs/publisher-api-reference/registerAnalyticsAdapter.md
 create mode 100644 dev-docs/publisher-api-reference/registerBidAdapter.md
 create mode 100644 dev-docs/publisher-api-reference/triggerUserSyncs.md

diff --git a/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md b/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
new file mode 100644
index 0000000000..bd4fe3627a
--- /dev/null
+++ b/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
@@ -0,0 +1,27 @@
+---
+layout: api_prebidjs
+title: pbjs.getAdserverTargetingForAdUnitCodeStr(adunitCode)
+description: getAdserverTargetingForAdUnitCodeStr API
+sidebarType: 1
+---
+
+Returns the query string targeting parameters available at the moment for the specified ad unit.
+
+**Kind**: static method of `pbjs`.
+
+**Returns**: `Array` - list of targeting key-value strings.
+
+**Request Params:**
+
+{: .table .table-bordered .table-striped }
+
+| Param | Type | Description |
+| --- | --- | --- |
+| `adunitCode` | `string` | adUnitCode to get the bid responses for |
+
+**Example**
+
+```javascript
+const targetingStrings = pbjs.getAdserverTargetingForAdUnitCodeStr('div-1');
+// ["hb_bidder=appnexus", "hb_adid=233bcbee889d46d", ...]
+```
diff --git a/dev-docs/publisher-api-reference/processQueue.md b/dev-docs/publisher-api-reference/processQueue.md
new file mode 100644
index 0000000000..28c3968357
--- /dev/null
+++ b/dev-docs/publisher-api-reference/processQueue.md
@@ -0,0 +1,18 @@
+---
+layout: api_prebidjs
+title: pbjs.processQueue()
+description: processQueue API
+sidebarType: 1
+---
+
+Processes commands that were pushed onto `pbjs.cmd` or `pbjs.que` before Prebid.js finished loading.
+
+**Kind**: static method of `pbjs`.
+
+Calling this method manually is rarely necessary because Prebid.js runs it automatically when the library loads.
+
+**Example**
+
+```javascript
+pbjs.processQueue();
+```
diff --git a/dev-docs/publisher-api-reference/registerAnalyticsAdapter.md b/dev-docs/publisher-api-reference/registerAnalyticsAdapter.md
new file mode 100644
index 0000000000..884453e986
--- /dev/null
+++ b/dev-docs/publisher-api-reference/registerAnalyticsAdapter.md
@@ -0,0 +1,28 @@
+---
+layout: api_prebidjs
+title: pbjs.registerAnalyticsAdapter(options)
+description: registerAnalyticsAdapter API
+sidebarType: 1
+---
+
+Registers an analytics adapter so it can listen to auction events.
+
+**Kind**: static method of `pbjs`.
+
+**Request Params:**
+
+{: .table .table-bordered .table-striped }
+
+| Param | Type | Description |
+| --- | --- | --- |
+| `options` | `object` | Object containing the adapter instance and code |
+
+**Example**
+
+```javascript
+pbjs.registerAnalyticsAdapter({
+  adapter: myAnalyticsAdapter,
+  code: 'myAnalytics',
+  gvlid: 1
+});
+```
diff --git a/dev-docs/publisher-api-reference/registerBidAdapter.md b/dev-docs/publisher-api-reference/registerBidAdapter.md
new file mode 100644
index 0000000000..0b7e53c1d3
--- /dev/null
+++ b/dev-docs/publisher-api-reference/registerBidAdapter.md
@@ -0,0 +1,28 @@
+---
+layout: api_prebidjs
+title: pbjs.registerBidAdapter(bidderAdapter, bidderCode)
+description: registerBidAdapter API
+sidebarType: 1
+---
+
+Registers a custom bid adapter for use within Prebid.js.
+
+**Kind**: static method of `pbjs`.
+
+**Request Params:**
+
+{: .table .table-bordered .table-striped }
+
+| Param | Type | Description |
+| --- | --- | --- |
+| `bidderAdapter` | `function` | Adapter instance that returns a `callBids` function |
+| `bidderCode` | `string` | Code that identifies the adapter |
+
+**Example**
+
+```javascript
+function myAdapter() {
+  return { callBids: function() { /* ... */ } };
+}
+pbjs.registerBidAdapter(myAdapter, 'my');
+```
diff --git a/dev-docs/publisher-api-reference/triggerUserSyncs.md b/dev-docs/publisher-api-reference/triggerUserSyncs.md
new file mode 100644
index 0000000000..f70d0f6a29
--- /dev/null
+++ b/dev-docs/publisher-api-reference/triggerUserSyncs.md
@@ -0,0 +1,16 @@
+---
+layout: api_prebidjs
+title: pbjs.triggerUserSyncs()
+description: triggerUserSyncs API
+sidebarType: 1
+---
+
+Manually initiates user syncs when the `userSync.enableOverride` setting is enabled.
+
+**Kind**: static method of `pbjs`.
+
+**Example**
+
+```javascript
+pbjs.triggerUserSyncs();
+```

From f6b8d9f4ee239e9e57e3fab0e13e779b28667436 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 7 Jun 2025 04:19:44 -0400
Subject: [PATCH 183/665] docs: fix markdownlint issues (#6091)

---
 _includes/dev-docs/native-assets.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/_includes/dev-docs/native-assets.md b/_includes/dev-docs/native-assets.md
index 912b0e62ee..58468731cc 100644
--- a/_includes/dev-docs/native-assets.md
+++ b/_includes/dev-docs/native-assets.md
@@ -1,3 +1,4 @@
+<!-- markdownlint-disable MD041 -->
 {: .table .table-bordered .table-striped }
 | Asset Code       | Description                                                                          | Macro |
 |---------------+--------------------------------------------------------------------------------------|-----------------------|
@@ -9,8 +10,8 @@
 | `image`       | A picture that is associated with the brand, or grabs the user's attention.          | `##hb_native_image##`     |
 | `clickUrl`    | Where the user will end up if they click the ad.                                     | `##hb_native_linkurl##`   |
 | `displayUrl`  | Text that can be displayed instead of the raw click URL. e.g, "Example.com/Specials" | `##hb_native_displayUrl##`|
-| `privacyLink` | Link to the Privacy Policy of the Buyer, e.g. http://example.com/privacy             | `##hb_native_privacy##`   |
-| `privacyIcon` | Icon to display for the privacy link, e.g. http://example.com/privacy_icon.png       | `##hb_native_privicon##`  |
+| `privacyLink` | Link to the Privacy Policy of the Buyer, e.g. <http://example.com/privacy>             | `##hb_native_privacy##`   |
+| `privacyIcon` | Icon to display for the privacy link, e.g. <http://example.com/privacy_icon.png>       | `##hb_native_privicon##`  |
 | `cta`         | *Call to Action* text, e.g., "Click here for more information".                      | `##hb_native_cta##`       |
 | `rating`      | Rating information, e.g., "4" out of 5.                                              | `##hb_native_rating##`    |
 | `downloads`   | The total downloads of the advertised application/product                            | `##hb_native_downloads##` |

From 4889951cbc5eb9ef15162bb6424cbff50d67568e Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 7 Jun 2025 04:20:54 -0400
Subject: [PATCH 184/665] docs: fix typos (#6090)

---
 adops/mobile-rendering-max-line-item-setup.md          |  2 +-
 dev-docs/bidders/deepintent.md                         |  3 ++-
 dev-docs/bidders/pubmatic.md                           |  5 ++++-
 dev-docs/bidders/pwbid.md                              |  4 +++-
 dev-docs/modules/floors.md                             |  4 ++--
 guide/pb-guide-alerts.md                               |  2 +-
 .../modules/rendering/android-sdk-integration-admob.md |  6 +++---
 .../modules/rendering/android-sdk-integration-max.md   |  8 ++++----
 .../modules/rendering/ios-sdk-integration-admob.md     | 10 +++++-----
 .../modules/rendering/ios-sdk-integration-max.md       | 10 +++++-----
 10 files changed, 30 insertions(+), 24 deletions(-)

diff --git a/adops/mobile-rendering-max-line-item-setup.md b/adops/mobile-rendering-max-line-item-setup.md
index 63183d82ae..b95e83f50f 100644
--- a/adops/mobile-rendering-max-line-item-setup.md
+++ b/adops/mobile-rendering-max-line-item-setup.md
@@ -37,7 +37,7 @@ Create or choose an existing Ad Unit. Go the the `Custom Networks & Deals` secti
 
 <img src="/assets/images/prebid-mobile/modules/rendering/max-ad-unit-setup.png" alt="Pipeline Screenshot" align="center">
 
-Make sure that the `Custom Parameters` field contains expecting targetting keywords of the winning bid:
+Make sure that the `Custom Parameters` field contains the expected targeting keywords of the winning bid:
 
 ```json
 {"hb_pb":"0.10"}
diff --git a/dev-docs/bidders/deepintent.md b/dev-docs/bidders/deepintent.md
index 080e4a07aa..b865845d96 100644
--- a/dev-docs/bidders/deepintent.md
+++ b/dev-docs/bidders/deepintent.md
@@ -88,6 +88,7 @@ var adUnits = [
 Deepintent supports video as of Prebid v1.16.0
 
 {: .table .table-bordered .table-striped }
+
 | Name                      | Scope    | Description                                                  | Example |
 | :----------------------| :------- | :---------------------------------------------------------- | :------ |
 | `video.mimes`          | required | Video MIME types                                               | `['video/mp4','video/x-flv']` |
@@ -101,7 +102,7 @@ Deepintent supports video as of Prebid v1.16.0
 | `video.battr`          | optional | Blocked creative attributes, See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.3 for values             | `[3, 9]` |
 | `video.linearity`      | optional | Indicates if the impression is linear or nonlinear<br/>Values:<br/>`1`: Linear/In-Stream<br/>`2`: Non-Linear/Overlay.                                                                                | `1` |
 | `video.placement`      | optional | Video placement type.  See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.9 for Values                            | `1` |
-| `video.minbitrate`      | optional | Minumim bit rate in Kbps.                                   | 50 |
+| `video.minbitrate`      | optional | Minimum bit rate in Kbps.                                   | 50 |
 | `video.maxbitrate`      | optional | Maximum bit rate in Kbps.                                   | 70 |
 
 ### AdUnit Format for Video
diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 706217f9c7..5e6c22a558 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -32,6 +32,7 @@ endpoint_compression: true
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description        | Example                      | Type     |
 |---------------|----------|--------------------|------------------------------|----------|
 | `publisherId` | required | Publisher ID       | `'32572'`                    | `string` |
@@ -74,6 +75,7 @@ Note: Combine the above the configuration with any other UserSync configuration.
 The adSlot parameter supports two different formats:
 
 {: .table .table-bordered .table-striped }
+
 | Format         | Example              |
 |----------------|----------------------|
 | Without Size   | `'38519891'`         |
@@ -86,6 +88,7 @@ adSlot parameter is optional.  To omit the adSlot parameter, your publisher acco
 The PubMatic adapter supports video as of Prebid v1.16.0
 
 {: .table .table-bordered .table-striped }
+
 | Name                      | Scope    | Description                                              | Example |
 | :----------------------| :------- | :---------------------------------------------------------- | :------ |
 | `video.mimes`          | required | Video MIME types                                            | `['video/mp4','video/x-flv']` |
@@ -100,7 +103,7 @@ The PubMatic adapter supports video as of Prebid v1.16.0
 | `video.linearity`      | optional | Indicates if the impression is linear or nonlinear<br/>Values:<br/>`1`: Linear/In-Stream<br/>`2`: Non-Linear/Overlay.                                                                                | `1` |
 | `video.placement`      | optional | Video placement type.  See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.9 for Values                            | `1` |
 | `video.plcmt`          | optional | Video placement type. See [OpenRTB 2.6 specification - github](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/develop/2.6.md#327---object-video-), For values [plcmt subtypes](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo)                            | `1` |
-| `video.minbitrate`     | optional | Minumim bit rate in Kbps.                                   | 50 |
+| `video.minbitrate`     | optional | Minimum bit rate in Kbps.                                   | 50 |
 | `video.maxbitrate`     | optional | Maximum bit rate in Kbps.                                   | 70 |
 
 ### AdUnit Format for Video
diff --git a/dev-docs/bidders/pwbid.md b/dev-docs/bidders/pwbid.md
index 9919486e76..f60c7519aa 100644
--- a/dev-docs/bidders/pwbid.md
+++ b/dev-docs/bidders/pwbid.md
@@ -27,6 +27,7 @@ The PubWise bid adapter is now availalbe self service. Visit <http://www.PubWise
 siteID is sufficient for bidding.
 
 {: .table .table-bordered .table-striped }
+
 | Name         | Scope    | Description                                                                                       | Example                  | Type      |
 |--------------|----------|---------------------------------------------------------------------------------------------------|--------------------------|-----------|
 | `siteId`     | required | The site ID provided by the PubWise system                                                       | `'XXXXXX'`               | `string`  |
@@ -38,6 +39,7 @@ siteID is sufficient for bidding.
 The PubWise adapter supports video as of Prebid v7.39.0. Outstream is NOT supported currently.
 
 {: .table .table-bordered .table-striped }
+
 | Name                      | Scope    | Description                                                  | Example |
 | :----------------------| :------- | :---------------------------------------------------------- | :------ |
 | `video.mimes`          | required | Video MIME types                                               | `['video/mp4','video/x-flv']` |
@@ -51,7 +53,7 @@ The PubWise adapter supports video as of Prebid v7.39.0. Outstream is NOT suppor
 | `video.battr`          | optional | Blocked creative attributes, See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.3 for values             | `[3, 9]` |
 | `video.linearity`      | optional | Indicates if the impression is linear or nonlinear<br/>Values:<br/>`1`: Linear/In-Stream<br/>`2`: Non-Linear/Overlay.                                                                                | `1` |
 | `video.placement`      | optional | Video placement type.  See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.9 for Values                            | `1` |
-| `video.minbitrate`      | optional | Minumim bit rate in Kbps.                                   | 50 |
+| `video.minbitrate`      | optional | Minimum bit rate in Kbps.                                   | 50 |
 | `video.maxbitrate`      | optional | Maximum bit rate in Kbps.                                   | 70 |
 
 ### Example
diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index 3495955c10..0302c07c51 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -369,7 +369,7 @@ You **cannot** set the `floorMin` parameter without specifying a `data` object.
 | data.floorProvider | string | Optional atribute (as of prebid version 4.2) used to signal to the Floor Provider's Analytics adapter their floors are being applied. They can opt to log only floors that are applied when they are the provider. If floorProvider is supplied in both the top level of the floors object and within the data object, the data object's configuration shall prevail.| - |
 | data.currency | string | Currency of floor data. Floor Module will convert currency where necessary. See Currency section for more details. | 'USD' |
 | data.skipRate | integer | skipRate is a random function whose input value is any integer 0 through 100 to determine when to skip all floor logic, where 0 is always use floor data and 100 is always skip floor data. The use case is for publishers or floor providers to learn bid behavior when floors are applied or skipped. Analytics adapters will  have access to model version (if defined) when skipped is true to signal the Price Floors Module is in floors mode. If skipRate is supplied in both the root level of the floors object and within the data object, the skipRate configuration within the data object shall prevail. | 0 |
-| data.floorsSchemaVersion | integer | The module supports two versions of the data schema. Version 1 allows for only one model to be applied in a given data set, whereas Version 2 allows you to sample multiple models selected by supplied weights. If no schema version is provided, the module will assume version 1 for the sake of backwards compatiblity. For schema version 2 see the next section. | 1 |
+| data.floorsSchemaVersion | integer | The module supports two versions of the data schema. Version 1 allows for only one model to be applied in a given data set, whereas Version 2 allows you to sample multiple models selected by supplied weights. If no schema version is provided, the module will assume version 1 for the sake of backwards compatibility. For schema version 2 see the next section. | 1 |
 | data.modelVersion | string | Used by floor providers to train on model version performance. The expectation is a floor provider’s analytics adapter will pass the model verson back for algorithm training. | - |
 | data.modelTimestamp | integer | Epoch timestamp associated with modelVersion. Can be used to track model creation of floor file for post auction analysis.| - |
 | data.schema | object |allows for flexible definition of how floor data is formatted. | - |
@@ -436,7 +436,7 @@ You **cannot** set the `floorMin` parameter without specifying a `data` object.
 | data.currency | string | Currency of floor data. The module will convert currency where necessary. See Currency section for more details. | 'USD' |
 | data.skipRate | integer | skipRate is a random function whose input value is any integer 0 through 100 to determine when to skip all floor logic, where 0 is always use floor data and 100 is always skip floor data. The use case is for publishers or floor providers to learn bid behavior when floors are applied or skipped. Analytics adapters will  have access to model version (if defined) when skipped is true to signal the module is in floors mode. If skipRate is supplied in both the root level of the floors object and within the data object, the skipRate configuration within the data object shall prevail.| 0 |
 | data.useFetchDataRate | integer | (PBS-Go 2.6+) useFetchDataRate is a random function whose input value is any integer 0 through 100 to determine when to skip dynamic floor data and fall back to static floor data. 0 means always use static floor data and 100 means always use dynamic floor data. The use case is for publishers or floor providers to confirm how dynamic floors data compares to static floors data. Analytics adapters will have access to the location of the actual floors data used, either "request" or "fetch". | 100 |
-| data.floorsSchemaVersion | integer | The module supports two version of the data schema. Version 1 allows for only one model to be applied in a given data set, whereas Version 2 allows you to sample multiple models selected by supplied weights. If no schema version is provided, the module will assume version 1 for the sake of backwards compatiblity.| 1 |
+| data.floorsSchemaVersion | integer | The module supports two versions of the data schema. Version 1 allows for only one model to be applied in a given data set, whereas Version 2 allows you to sample multiple models selected by supplied weights. If no schema version is provided, the module will assume version 1 for the sake of backwards compatibility.| 1 |
 | data.modelTimestamp | int | Epoch timestamp associated with modelVersion. Can be used to track model creation of floor file for post auction analysis.| - |
 | data.noFloorSignalBidders | array of strings | (PBJS 8.31+, PBS-Java 3.4+) This is an array of bidders for which to avoid sending floors. This is useful for bidders where the publishers has established different floor rules in their systems. The value can be `["*"]`. | - |
 | data.modelGroups | array of objects | Array of model objects to be used for A/B sampling multiple models. This field is only used when data.floorsSchemaVersion = 2 | - |
diff --git a/guide/pb-guide-alerts.md b/guide/pb-guide-alerts.md
index 50f7b5a2fe..321bd5497e 100644
--- a/guide/pb-guide-alerts.md
+++ b/guide/pb-guide-alerts.md
@@ -134,4 +134,4 @@ For example, if you had content such as "The adpod unit is only available for lo
 
 {% include alerts/alert_note.html content="The adpod unit is only available for long-form video." %}
 
-Use the Liquid `capture` command when you are creating an alert that is very long or contains HTML formating.
+Use the Liquid `capture` command when you are creating an alert that is very long or contains HTML formatting.
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
index a8c3393375..03d84b06d3 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-admob.md
@@ -85,7 +85,7 @@ This step is the same as for the original [AdMob integration](https://developers
 #### Step 2: Create AdMobMediationBannerUtils
 {:.no_toc}
 
-The `AdMobBannerMediationUtils` is a helper class, which performs certain utilty work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `AdMobBannerMediationUtils` is a helper class, which performs certain utility work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationBannerAdUnit
 {:.no_toc}
@@ -153,7 +153,7 @@ This step is the same as for original [AdMob integration](https://developers.goo
 #### Step 2: Create AdMobInterstitialMediationUtils
 {:.no_toc}
 
-The `AdMobInterstitialMediationUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to adapters.
+The `AdMobInterstitialMediationUtils` is a helper class, which performs certain utility work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to adapters.
 
 #### Step 3: Create MediationInterstitialAdUnit
 {:.no_toc}
@@ -240,7 +240,7 @@ This step is the same as for the original [AdMob integration](https://developers
 ##### Step 2: Create AdMobRewardedMediationUtils
 {:.no_toc}
 
-The `AdMobRewardedMediationUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to adapters.
+The `AdMobRewardedMediationUtils` is a helper class, which performs certain utility work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to adapters.
 
 ##### Step 3: Create MediationRewardedVideoAdUnit
 {:.no_toc}
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-max.md b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
index c9336a85b6..8c2c5c7724 100644
--- a/prebid-mobile/modules/rendering/android-sdk-integration-max.md
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-max.md
@@ -74,7 +74,7 @@ This step is totally the same as for original [MAX integration](https://dash.app
 #### Step 2: Create MaxMediationBannerUtils
 {:.no_toc}
 
-The `MaxMediationBannerUtils` is a helper class, which performs certain utilty work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `MaxMediationBannerUtils` is a helper class, which performs certain utility work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationBannerAdUnit
 {:.no_toc}
@@ -139,7 +139,7 @@ This step is totally the same as for original [MAX integration](https://dash.app
 #### Step 2: Create MaxMediationInterstitialUtils
 {:.no_toc}
 
-The `MaxMediationInterstitialUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `MaxMediationInterstitialUtils` is a helper class, which performs certain utility work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationInterstitialAdUnit
 {:.no_toc}
@@ -202,7 +202,7 @@ This step is totally the same as for original [MAX integration](https://dash.app
 ##### Step 2: Create MaxMediationRewardedUtils
 {:.no_toc}
 
-The `MaxMediationRewardedUtils` is a helper class, which performs certain utilty work for the `MediationRewardedVideoAdUnit`, like passing the targeting keywords to the adapters.
+The `MaxMediationRewardedUtils` is a helper class, which performs certain utility work for the `MediationRewardedVideoAdUnit`, like passing the targeting keywords to the adapters.
 
 ##### Step 3: Create MediationRewardedVideoAdUnit
 {:.no_toc}
@@ -262,7 +262,7 @@ Prepare the `MaxNativeAdLoader` object before you make a bid request. It will be
 #### Step 2: Create and configure NativeAdUnit
 {:.no_toc}
 
-The `NativeAdUnit` class is responsible for making a bid request and providing a winning bid and targeting keywords. Fot the better targetting you should provide additional properties like `conteaxtType` and `placemantType`. 
+The `NativeAdUnit` class is responsible for making a bid request and providing a winning bid and targeting keywords. For better targeting you should provide additional properties like `contextType` and `placementType`.
  
 #### Step 3: Set up assets for bid request
 {:.no_toc}
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
index 4d0cab980d..3651f316f3 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-admob.md
@@ -105,7 +105,7 @@ This step is the same as for the original [AdMob integration](https://developers
 #### Step 2: Create AdMobMediationBannerUtils
 {:.no_toc}
 
-The `AdMobMediationBannerUtils` is a helper class, which performs certain utilty work for the `MediationBannerAdUnit`, such as passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `AdMobMediationBannerUtils` is a helper class, which performs certain utility work for the `MediationBannerAdUnit`, such as passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationBannerAdUnit
 {:.no_toc}
@@ -213,7 +213,7 @@ This step is the same as for the original [AdMob integration](https://developers
 #### Step 2: Create AdMobMediationInterstitialUtils
 {:.no_toc}
 
-The `AdMobMediationInterstitialUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, such as passing the targeting keywords to adapters and checking the visibility of the ad view.
+The `AdMobMediationInterstitialUtils` is a helper class, which performs certain utility work for the `MediationInterstitialAdUnit`, such as passing the targeting keywords to adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationInterstitialAdUnit
 {:.no_toc}
@@ -328,7 +328,7 @@ This step is the same as for the original [AdMob integration](https://developers
 #### Step 2: Create MediationRewardedAdUnit
 {:.no_toc}
 
-The `AdMobMediationRewardedUtils` is a helper class, which performs certain utilty work for the `MediationRewardedAdUnit`, like passing the targeting keywords to the adapters.
+The `AdMobMediationRewardedUtils` is a helper class, which performs certain utility work for the `MediationRewardedAdUnit`, like passing the targeting keywords to the adapters.
 
 #### Step 3: Create MediationInterstitialAdUnit
 {:.no_toc}
@@ -442,12 +442,12 @@ Prepare the `Request` object before you make a bid request. It will be needed fo
 #### Step 2: Create AdMobMediationNativeUtils
 {:.no_toc}
 
-The `AdMobMediationNativeUtils` is a helper class, which performs certain utilty work for `MediationNativeAdUnit`, like passing the targeting keywords to adapters and checking the visibility of the ad view.
+The `AdMobMediationNativeUtils` is a helper class, which performs certain utility work for `MediationNativeAdUnit`, like passing the targeting keywords to adapters and checking the visibility of the ad view.
 
 #### Step 3: Create and configure MediationNativeAdUnit
 {:.no_toc}
 
-The `MediationNativeAdUnit` is part of the Prebid mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters. For better targetting you should provide additional properties like `conteaxtType` and `placemantType`.
+The `MediationNativeAdUnit` is part of the Prebid mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters. For better targeting you should provide additional properties like `contextType` and `placementType`.
 
 #### Step 4: Set up assets for bid request
 {:.no_toc}
diff --git a/prebid-mobile/modules/rendering/ios-sdk-integration-max.md b/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
index cd3a541f55..d8940e627c 100644
--- a/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
+++ b/prebid-mobile/modules/rendering/ios-sdk-integration-max.md
@@ -56,7 +56,7 @@ This step is the same as for the original [MAX integration](https://dash.applovi
 #### Step 2: Create MAXMediationBannerUtils
 {:.no_toc}
 
-The `MAXMediationBannerUtils` is a helper class, which performs certain utilty work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `MAXMediationBannerUtils` is a helper class, which performs certain utility work for the `MediationBannerAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationBannerAdUnit
 {:.no_toc}
@@ -126,7 +126,7 @@ This step is the same as for the original [MAX integration](https://dash.applovi
 #### Step 2: Create MAXMediationInterstitialUtils
 {:.no_toc}
 
-The `MAXMediationInterstitialUtils` is a helper class, which performs certain utilty work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
+The `MAXMediationInterstitialUtils` is a helper class, which performs certain utility work for the `MediationInterstitialAdUnit`, like passing the targeting keywords to the adapters and checking the visibility of the ad view.
 
 #### Step 3: Create MediationInterstitialAdUnit
 {:.no_toc}
@@ -186,7 +186,7 @@ This step is the same as for the original [MAX integration](https://dash.applovi
 ##### Step 2: Create MAXMediationRewardedUtils
 {:.no_toc}
 
-The `MAXMediationRewardedUtils` is a helper class, which performs certain utilty work for the `MediationRewardedAdUnit`, like passing the targeting keywords to the adapters.
+The `MAXMediationRewardedUtils` is a helper class, which performs certain utility work for the `MediationRewardedAdUnit`, like passing the targeting keywords to the adapters.
 
 ##### Step 3: Create MediationRewardedAdUnit
 {:.no_toc}
@@ -250,12 +250,12 @@ Prepare the `MANativeAdLoader` object before you make a bid request. It will be
 #### Step 2: Create MAXMediationNativeUtils
 {:.no_toc}
 
-The `MAXMediationNativeUtils` is a helper class, which performs certain utilty work for `MediationNativeAdUnit`, like passing the targeting keywords to adapters and checking the visibility of the ad view.
+The `MAXMediationNativeUtils` is a helper class, which performs certain utility work for `MediationNativeAdUnit`, like passing the targeting keywords to adapters and checking the visibility of the ad view.
 
 #### Step 3: Create and configure MediationNativeAdUnit
 {:.no_toc}
 
-The `MediationNativeAdUnit` is a part of the Prebid Mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters. Fot the better targetting you should provide additional properties like `conteaxtType` and `placemantType`. 
+The `MediationNativeAdUnit` is a part of the Prebid Mediation API. This class is responsible for making a bid request and providing a winning bid and targeting keywords to the adapters. For better targeting you should provide additional properties like `contextType` and `placementType`.
  
 #### Step 4: Set up assets for bid request
 {:.no_toc}

From ccb57c9caff122c82b01b24b6bcff181b1692758 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 7 Jun 2025 04:23:41 -0400
Subject: [PATCH 185/665] Document additional module parameters (#6088)

---
 dev-docs/modules/intersectionRtdProvider.md   | 7 +++++++
 dev-docs/modules/userid-submodules/unified.md | 2 ++
 dev-docs/modules/userid-submodules/yandex.md  | 2 ++
 identity/sharedid.md                          | 5 ++++-
 4 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/intersectionRtdProvider.md b/dev-docs/modules/intersectionRtdProvider.md
index cba5bed852..ced4de6aca 100644
--- a/dev-docs/modules/intersectionRtdProvider.md
+++ b/dev-docs/modules/intersectionRtdProvider.md
@@ -2,6 +2,7 @@
 layout: page_v2
 title: Intersection Module
 display_name: Intersection
+
 description: Real Time Intersection
 page_type: module
 module_type: rtd
@@ -26,6 +27,7 @@ Implementation works like this:
 1. Build the Intersection module into the Prebid.js package with:
 
     ```bash
+
     gulp build --modules=intersectionRtdProvider&...
     ```
 
@@ -36,6 +38,7 @@ Implementation works like this:
 This module is configured as part of the `realTimeData.dataProviders` object:
 
 ```javascript
+
 pbjs.setConfig({
     "realTimeData": {
         auctionDelay: 100,
@@ -45,14 +48,18 @@ pbjs.setConfig({
         }]
     }
 });
+
 ```
 
+The optional `waitForIt` flag instructs the module to delay the auction until intersection data is collected for all ad units or the `auctionDelay` timeout is reached. It defaults to `false`.
+
 ## Output
 
 For each bidder, the module adds intersection in a JSON format.
 Example:
 
 ```javascript
+
 {
   "intersection":{
     'boundingClientRect': {
diff --git a/dev-docs/modules/userid-submodules/unified.md b/dev-docs/modules/userid-submodules/unified.md
index 4a94c76a02..3192b42492 100644
--- a/dev-docs/modules/userid-submodules/unified.md
+++ b/dev-docs/modules/userid-submodules/unified.md
@@ -38,6 +38,8 @@ The Unified ID privacy is covered under the [TradeDesk Services Privacy Policy](
 | params.url | Required for UnifiedId if not using TradeDesk | String | If specified for UnifiedId, overrides the default Trade Desk URL. | "<https://unifiedid.org/somepath?args>" |
 | value | Optional | Object | Used only if the page has a separate mechanism for storing the Unified ID. The value is an object containing the values to be sent to the adapters. In this scenario, no URL is called and nothing is added to local storage | `{"tdid": "D6885E90-2A7A-4E0F-87CB-7734ED1B99A3"}` |
 
+Either `params.partner` or `params.url` must be provided.
+
 ## Unified ID Examples
 
 1. Publisher has a partner ID with The Trade Desk, and is using the default endpoint for Unified ID.
diff --git a/dev-docs/modules/userid-submodules/yandex.md b/dev-docs/modules/userid-submodules/yandex.md
index 7ff4e9ce0a..7d7884de0f 100644
--- a/dev-docs/modules/userid-submodules/yandex.md
+++ b/dev-docs/modules/userid-submodules/yandex.md
@@ -39,3 +39,5 @@ pbjs.setConfig({
     },
 });
 ```
+
+**Storage Requirements**: Yandex ID requires the storage object to specify cookie `type`, name `_ym_uid`, and an expiration of at least 30 days.
diff --git a/identity/sharedid.md b/identity/sharedid.md
index 78c7acc23c..80cab18f7d 100644
--- a/identity/sharedid.md
+++ b/identity/sharedid.md
@@ -21,6 +21,7 @@ SharedId is a convenient Prebid-owned first party identifier within the [Prebid
 There are multiple ways to integrate SharedId on your site. See the table below for a breakout of options, and the rest of this document for detailed integration instructions.
 
 {: .table .table-bordered .table-striped }
+
 | Implementation | Description | Cookie Lifetime | Safari Cookie Lifetime | Technical Difficulty | Revenue Benefit |
 | --- | --- | --- | --- | --- | --- |
 | 3rd Party Cookie Only | No first party cookie solution. | Some Blocked | Blocked | None | Low |
@@ -149,7 +150,7 @@ removed in Prebid.js 5.0.
 
 ### Configuration
 
-You can find available configuration options for the SharedID module [here](https://docs.prebid.org/dev-docs/modules/userid-submodules/sharedid.html)
+You can find available configuration options for the SharedID module [in the SharedId user ID submodule documentation](https://docs.prebid.org/dev-docs/modules/userid-submodules/sharedid.html)
 
 ### Privacy Discussion
 
@@ -211,6 +212,7 @@ If custom configurations are needed, define the pubcid_options object before inc
 Below are the available configuration options for the PubCID script.
 
 {: .table .table-bordered .table-striped }
+
 | Parameter Name | Type | Description | | Example |
 | --- | --- | --- | --- | --- |
 | create | boolean | If true, then an id is created automatically by the script if it's missing. Default is true. If your server has a component that generates the id instead, then this should be set to false | | `true` |
@@ -218,6 +220,7 @@ Below are the available configuration options for the PubCID script.
 | extend | boolean | If true, the the expiration time is automatically extended whenever the script is executed even if the id exists already. Default is true. If false, then the id expires from the time it was initially created. | For publisher server support only. If true, the publisher's server will create the (pubcid) cookie. Default is true. | `true` |
 | pixelUrl | string (optional) | For publisher server support only. Where to call out to for a server cookie. | | `/wp-json/pubcid/v1/extend/` |
 | type | string | Type of storage. It's possible to specify one of the following: 'html5', 'cookie'. Default is 'html5' priority, aka local storage, and fall back to cookie if local storage is unavailable. | If true, the expiration time of the stored IDs will be refreshed during each page load. Default is false. | `cookie` |
+| inserter | string (optional) | Adds this value into the EID object `inserter` field. | | `myPartner` |
 
 #### Example Configurations
 

From 1177052d8ab547757345eda40367864143365871 Mon Sep 17 00:00:00 2001
From: rimaburder-index <55195208+rimaburder-index@users.noreply.github.com>
Date: Sat, 7 Jun 2025 04:24:12 -0400
Subject: [PATCH 186/665] Update ix-server.md (#6084)

Added a note that we are pausing PAAPI support for now
---
 dev-docs/bidders/ix-server.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/ix-server.md b/dev-docs/bidders/ix-server.md
index 062867d155..a7624c3b19 100644
--- a/dev-docs/bidders/ix-server.md
+++ b/dev-docs/bidders/ix-server.md
@@ -240,6 +240,8 @@ To request bids from Index:
 
 ### Receive Protected Audience API demand from Index
 
+**Info:** Starting in June 2025, Index is pausing support for the Protected Audience API. After this date, you will no longer receive Protected Audience API demand from Index, even if your inventory is configured to be eligible for it.
+
 Publishers who want to use the Protected Audience API with Prebid Server, must first set up their inventory to be eligible for Protected Audience API in Prebid.js. Prebid Server will automatically pass through the on-device auction signals received from Prebid.js to Index. To receive Protected Audience API auction demand from Index, contact your Index Representative.
 
 **Before you begin:** Depending on whether you are using the Prebid Server Go or Java code base and the Prebid.js version, you must make sure that you are using the appropriate Prebid Server version:

From 882a5a12dd7d5cea4af5be2fd7b725b030e3bc27 Mon Sep 17 00:00:00 2001
From: rimaburder-index <55195208+rimaburder-index@users.noreply.github.com>
Date: Sat, 7 Jun 2025 04:24:36 -0400
Subject: [PATCH 187/665] Update ix.md (#6083)

Added a note that we are pausing PAAPI support
---
 dev-docs/bidders/ix.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/ix.md b/dev-docs/bidders/ix.md
index 8485dd9d0b..ac852a9bd0 100644
--- a/dev-docs/bidders/ix.md
+++ b/dev-docs/bidders/ix.md
@@ -374,6 +374,8 @@ pbjs.addAdUnits({
 
 ### Protected Audience API support
 
+**Info:** Starting in June 2025, Index is pausing support for the Protected Audience API. After this date, you will no longer receive Protected Audience API demand from Index, even if your inventory is configured to be eligible for it.
+
 **Before you begin:**
 
 * You must be using Google Ad Manager as your ad server.

From 30ba476f216f07c1b7726cb4ad9694e1c1a65c52 Mon Sep 17 00:00:00 2001
From: Piotr Jaworski <109736938+piotrj-rtbh@users.noreply.github.com>
Date: Sat, 7 Jun 2025 10:25:18 +0200
Subject: [PATCH 188/665] RTB House: PAAPI support removed (#6078)

---
 dev-docs/bidders/rtbhouse.md | 48 +-----------------------------------
 dev-docs/modules/paapi.md    |  2 +-
 2 files changed, 2 insertions(+), 48 deletions(-)

diff --git a/dev-docs/bidders/rtbhouse.md b/dev-docs/bidders/rtbhouse.md
index 2d85327c7d..0a0bbc2313 100644
--- a/dev-docs/bidders/rtbhouse.md
+++ b/dev-docs/bidders/rtbhouse.md
@@ -21,7 +21,7 @@ userIds: id5Id, identityLink, pubProvidedId
 pbs_app_supported: true
 ortb_blocking_supported: partial
 multiformat_supported: will-bid-on-any
-privacy_sandbox: paapi, topics
+privacy_sandbox: topics
 sidebarType: 1
 ---
 
@@ -79,49 +79,3 @@ pbjs.setBidderConfig({
 ### Setting up the Prebid Server Adapter
 
 If you’re a Prebid Server host company looking to enable the RTB House server-side adapter, you'll need to contact <prebid@rtbhouse.com>. They will guide you through the process. Do not use the default bidder config file as it will require custom partner code to be entered. It will be provided by RTB House.
-
-### Protected Audience API (PAAPI) support
-
-There’s an option to receive demand for Protected Audience API (FLEDGE/PAAPI)
-ads using RTB House bid adapter.
-Prebid’s [paapiForGpt](https://docs.prebid.org/dev-docs/modules/paapiForGpt.html)
-module and Google Ad Manager is currently required.
-
-The following steps should be taken to setup Protected Audience for RTB House:
-
-1. Reach out to your RTB House representative for setup coordination.
-
-2. Build and enable PAAPI module as described in
-[paapiForGpt](https://docs.prebid.org/dev-docs/modules/paapiForGpt.html)
-module documentation.
-
-    a. Make sure to enable RTB House bidder to participate in PAAPI. If there are any other bidders to be allowed for that, add them to the **bidders** array:
-
-    ```javascript
-    pbjs.setConfig({
-        paapi: {
-           enabled: true,
-           bidders: ["rtbhouse"]           
-        }    
-    })
-    ```
-
-    b. If you as a publisher have your own [decisionLogicUrl](https://github.com/WICG/turtledove/blob/main/FLEDGE.md#21-initiating-an-on-device-auction)
-    you may utilize it by setting up a dedicated `fledgeConfig` object:
-
-    ```javascript
-    pbjs.setBidderConfig({
-        bidders: ["rtbhouse"],
-        config: {
-            fledgeConfig: {
-                seller: 'https://seller.domain',
-                decisionLogicUrl: 'https://seller.domain/decisionLogicFile.js',
-                sellerTimeout: 100
-            }
-        }
-    });
-    ```
-
-    The `decisionLogicUrl` must be in the same domain as `seller` and has to respond with `X-Allow-FLEDGE: true` http header.
-
-    `sellerTimeout` is optional, defaults to 50 as per spec, will be clamped to 500 if greater.
diff --git a/dev-docs/modules/paapi.md b/dev-docs/modules/paapi.md
index ce29749fdb..e158687e78 100644
--- a/dev-docs/modules/paapi.md
+++ b/dev-docs/modules/paapi.md
@@ -178,7 +178,7 @@ function interpretResponse(resp, req) {
 
 Each object must specify exactly one of `igb` or `config`.
 
-An example of this can be seen in the OpenX bid adapter [here](https://github.com/prebid/Prebid.js/blob/master/modules/openxBidAdapter.js) or RTB House bid adapter [here](https://github.com/prebid/Prebid.js/blob/master/modules/rtbhouseBidAdapter.js).
+An example of this can be seen in the OpenX bid adapter [here](https://github.com/prebid/Prebid.js/blob/master/modules/openxBidAdapter.js).
 
 <a id="parallel"></a>
 ## Parallel auctions

From 602b7fb8395d7d7a978d1996814df7d42d12e350 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 7 Jun 2025 04:31:13 -0400
Subject: [PATCH 189/665] docs: document additional bidder params (#6089)

---
 dev-docs/bidders/33across.md | 2 ++
 dev-docs/bidders/adf.md      | 4 +++-
 dev-docs/bidders/eskimi.md   | 5 +++++
 dev-docs/bidders/madsense.md | 3 +++
 4 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/33across.md b/dev-docs/bidders/33across.md
index 7ba0f57f03..46577309c7 100644
--- a/dev-docs/bidders/33across.md
+++ b/dev-docs/bidders/33across.md
@@ -52,6 +52,8 @@ var adUnits = [
     params: {
         siteId: 'examplePub123',    // required 
         productId: 'siab|inview'    // required
+        // optional: uncomment to enable test requests
+        // test: 1
     }
   }]
 }
diff --git a/dev-docs/bidders/adf.md b/dev-docs/bidders/adf.md
index fb79528c66..d471c41c70 100644
--- a/dev-docs/bidders/adf.md
+++ b/dev-docs/bidders/adf.md
@@ -23,13 +23,15 @@ sidebarType: 1
 ### Bid params
 
 {: .table .table-bordered .table-striped }
+
 | Name        | Scope                      | Description          | Example            | Type      |
 |-------------|----------------------------|----------------------|--------------------|-----------|
 | `mid`       | required, if `inv` and `nmane` not set | Placement ID | `12345`        | `integer` |
 | `inv`       | required, if `mid` not set | Inventory source ID  | `1234`             | `integer` |
 | `mname`     | required, if `mid` not set | Placement name       | `"Leaderboard"`    | `string`  |
 | `adxDomain` | optional, Prebid.js only   | The Adform domain    | `"adx.adform.net"` | `string`  |
-| `priceType` | optional                   | Price type           | `"gross"`          | `string`  |
+| `priceType` (alias `pt`) | optional | Price type | `"gross"` | `string` |
+| `test` | optional | Set to `1` to enable test mode | `1` | `integer` |
 
 Note: Bid placement should be defined using the `mid` parameter or `inv` and `mname` parameters (dynamic master tag) but not both.
 
diff --git a/dev-docs/bidders/eskimi.md b/dev-docs/bidders/eskimi.md
index ce45645705..c4e7ce5c61 100644
--- a/dev-docs/bidders/eskimi.md
+++ b/dev-docs/bidders/eskimi.md
@@ -24,12 +24,17 @@ sidebarType: 1
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name              | Scope    | Description                     | Example                | Type      |
 |-------------------|----------|---------------------------------|------------------------|-----------|
 | `placementId`     | required | The placement ID from Eskimi.   | `612`                  | `integer` |
 | `bcat`            | optional | ORTB blocked categories         | `['IAB-1-1']`          | `string[]`|
 | `badv`            | optional | ORTB blocked advertiser domains | `['example.com']`      | `string[]`|
 | `bapp`            | optional | ORTB blocked applications       | `['com.example.game']` | `string[]`|
+| `bidFloor`        | optional | Minimum CPM                   | `0.3`                | `number` |
+| `bidFloorCur`     | optional | Currency of bid floor         | `'USD'`              | `string` |
+| `coppa`           | optional | Set to `true` to enable COPPA  | `true`               | `boolean` |
+| `test`            | optional | Set to `1` to enable test mode | `1`                  | `integer` |
 
 Additionally `battr` ORTB blocking param may be set on `BANNER` and `VIDEO` media types to specify blocked creative
 attributes.
diff --git a/dev-docs/bidders/madsense.md b/dev-docs/bidders/madsense.md
index c042e96032..b171580c92 100644
--- a/dev-docs/bidders/madsense.md
+++ b/dev-docs/bidders/madsense.md
@@ -26,6 +26,9 @@ The MadSense Header Bidding adapter needs approval from the MadSense team. For m
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name | Scope    | Description        | Example     | Type      |
 |------|----------|--------------------|-------------|-----------|
 | `company_id` | required | Company ID | `'1234567'` | `string`  |
+| `bidfloor`   | optional | Bid floor price | `0.5` | `number` |
+| `currency`   | optional | Bid floor currency | `'USD'` | `string` |

From 5bb816a45af1d9e2695f7261453876549621b0fb Mon Sep 17 00:00:00 2001
From: GodefroiRoussel <GodefroiRoussel@users.noreply.github.com>
Date: Tue, 10 Jun 2025 11:28:37 +0200
Subject: [PATCH 190/665] Adagio Prebid Server Adapter: Add section Bid Params
 for Prebid Server and update adagio's metadata (#5993)

Co-authored-by: Godefroi Roussel <groussel@adagio.io>
---
 dev-docs/bidders/adagio.md | 48 +++++++++++++++++++++++++++-----------
 1 file changed, 35 insertions(+), 13 deletions(-)

diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index 5d2d04404e..a9b607ceb3 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -2,10 +2,13 @@
 layout: bidder
 title: Adagio
 description: Prebid Adagio Bidder Adaptor
+pbs: true
+pbs_app_supported: true
 pbjs: true
 biddercode: adagio
 media_types: banner, native, video
 userIds: all
+multiformat_supported: will-bid-on-any
 floors_supported: true
 tcfeu_supported: true
 dsa_supported: true
@@ -16,6 +19,10 @@ schain_supported: true
 gvl_id: 617
 prebid_member: true
 fpd_supported: false
+safeframes_ok: true
+dchain_supported: false
+deals_supported: false
+ortb_blocking_supported: false
 sidebarType: 1
 ---
 
@@ -23,7 +30,7 @@ sidebarType: 1
 
 The Adagio bidder adapter requires setup and approval from the Adagio team. Please reach out to [contact@adagio.io](mailto:contact@adagio.io) for more information.
 
-### Configuration
+### Configuration for Prebid.js
 
 #### User Sync
 
@@ -58,11 +65,12 @@ pbjs.bidderSettings = {
 }
 ```
 
-### Bid Params
+#### Bid Params for Prebid.js
 
 **Important**: Adagio needs to collect attention data about the ads displayed on a page and must listen to some specifics ad-server events. Please refer to the [Adagio user guide](https://adagioio.notion.site/Adagio-Account-Setup-Guide-fbcd940649224cdfa10393d2f008792e) for details.
 
 {: .table .table-bordered .table-striped }
+
 | Name              | Scope              | Description                                                                                                                                                                                                                                          | Example                                                      | Type     |
 | ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- |
 | `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
@@ -73,18 +81,12 @@ pbjs.bidderSettings = {
 | `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
 | `video`           | optional           | OpenRTB 2.5 video options object. All options will override ones defined in mediaTypes video.<br>Mandatory: <br>- api <small><i>(your video player must at least support the value 2)</i></small><br> Highly recommended: <br> - playbackmethod <br> Not supported: <br>`protocol`, `companionad`, `companiontype`, `ext` options| `{api: [2], playbackmethod: [6], skip: 1, startdelay: 0}` | `object` |
 | `native`          | optional           | Partial OpenRTB Native 1.2 request object. Supported fields are:<br>- context<br>- plcmttype                                                                                                                                                         | `{context: 1, plcmttype: 2}`                                 | `object` |
-| `splitKeyword`     | optional           | Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) |  `'splitrule-one'` | `string` |
-| `dataLayer`        | optional           | A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. | `{placement: 'my-placement', siteid: 'my-siteid'}` | `object` |
-
-<i>*These parameters will have its accentuated characters converted to their non-accentuated version:&nbsp;`é`&nbsp;=>&nbsp;`e`</i>
+| `splitKeyword`     | optional          | Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) |  `'splitrule-one'` | `string` |
+| `dataLayer`        | optional          | A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. | `{placement: 'my-placement', siteid: 'my-siteid'}` | `object` |
 
-### Native Custom assets
+<i>*These parameters will have their accentuated characters converted to their non-accentuated version:&nbsp;`é`&nbsp;=>&nbsp;`e`</i>
 
-| Name         | description                  |
-| ------------ | ---------------------------- |
-| `adagio_bvw` | Url to handle Measure beacon |
-
-### First Party Data
+#### First Party Data
 
 Adagio will use FPD data as fallback for the params below:
 
@@ -93,6 +95,26 @@ Adagio will use FPD data as fallback for the params below:
 
 If the FPD value is an array, the 1st value of this array will be used.
 
-### Video outstream
+#### Video outstream
 
 The AdagioBidAdapter includes a default video player powered by [Blue Billywig](https://www.bluebillywig.com). This default player is used when no renderer is configured for the adUnit.
+
+### Configuration for Prebid Server
+
+{: .alert.alert-warning :}
+Adagio Prebid Server adapter is currently **available for apps**. Website support is coming soon. Activation requires setup and approval before beginning. Please reach out to your account manager or <contact@adagio.io> for more details.
+
+Adagio supports different regions for the Prebid Server. Please deploy the prebid config in each of your datacenters with the appropriate regional subdomain.
+
+#### Bid Params for Prebid Server
+
+{: .table .table-bordered .table-striped }
+
+| Name              | Scope              | Description | Example | Type |
+|-------------------|--------------------|-------------|---------|------|
+| `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
+| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 30</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
+| `pagetype`*       | highly recommended | Describes what kind of content will be present in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                       | `'article'`                                                  | `string` |
+| `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
+
+<i>*These parameters will have their accentuated characters converted to their non-accentuated version:&nbsp;`é`&nbsp;=>&nbsp;`e`</i>

From 271023c03416a50ec82369463b39fcc33bd20e7c Mon Sep 17 00:00:00 2001
From: andreafassina <127768714+andreafassina@users.noreply.github.com>
Date: Wed, 11 Jun 2025 21:45:24 +0200
Subject: [PATCH 191/665] Nativery: Add Adapter Documentation (#6015)

* Nativery: Add Adapter Documentation

* style: fix lint bare URL used

* Update dev-docs/bidders/nativery.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* docs: temporary disable pbs

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/nativery.md | 37 ++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/nativery.md

diff --git a/dev-docs/bidders/nativery.md b/dev-docs/bidders/nativery.md
new file mode 100644
index 0000000000..4259ef49cf
--- /dev/null
+++ b/dev-docs/bidders/nativery.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Nativery
+description: Prebid Nativery Bidder Adapter
+biddercode: nativery
+tcfeu_supported: true
+gvl_id: 1133
+usp_supported: false
+coppa_supported: false
+gpp_sids: false
+schain_supported: true
+dchain_supported: false
+userId:
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: false
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: false
+privacy_sandbox: no
+---
+
+### Registration
+
+The Nativery Bidding adapter requires setup before beginning. Please contact us at <developer@nativery.com>
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example   | Type     |
+|---------------|----------|--------------|-----------|----------|
+| `widgetId` | required | Widget ID | `'680f3e6326ef69d8ad04b6f6'` | `string` |

From 9ee68cbfb8cf3377304c9482c28d6d6dc06c84dd Mon Sep 17 00:00:00 2001
From: natanavra <natan@provesrc.com>
Date: Thu, 12 Jun 2025 17:30:43 +0300
Subject: [PATCH 192/665] Add valuad bid adapter (#6001)

* Add valuad bid adapter

* Add missing new line in end of file

* Update dev-docs/bidders/valuad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/valuad.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 dev-docs/bidders/valuad.md

diff --git a/dev-docs/bidders/valuad.md b/dev-docs/bidders/valuad.md
new file mode 100644
index 0000000000..fa1660cfcd
--- /dev/null
+++ b/dev-docs/bidders/valuad.md
@@ -0,0 +1,34 @@
+---
+layout: bidder
+title: Valuad
+description: Prebid Valuad Bidder Adapter
+biddercode: valuad
+pbjs: true
+pbs: false
+prebid_member: false
+userId: none
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: true
+floors_supported: true
+dchain_supported: false
+ortb_blocking_supported: false
+media_types: banner
+safeframes_ok: true
+ortb_blocking_supported: false
+sidebarType: 1
+---
+
+### Note
+
+The Valuad Header Bidding adapter requires setup and approval from Valuad. 
+Please reach out to your account manager or <hello@valuad.io> for more information
+
+### Bid Params
+
+| Name          | Scope    | Description                    | Example    | Type      |
+|---------------|----------|--------------------------------|------------|-----------|
+| `placementId` | required | Placement ID provided by VAluad | `'10000'`  | `string`  |

From 59b1ac6025c6700c4b8befc7c77ac80f7eba5c97 Mon Sep 17 00:00:00 2001
From: Leandro Marty <leandro.marty@rocketlab.ai>
Date: Fri, 13 Jun 2025 12:45:13 +0200
Subject: [PATCH 193/665] New Adapter: RocketLab (#6099)

* New Adapter: RocketLab

* Update dev-docs/bidders/rocketlab.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/rocketlab.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/rocketlab.md | 40 +++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 dev-docs/bidders/rocketlab.md

diff --git a/dev-docs/bidders/rocketlab.md b/dev-docs/bidders/rocketlab.md
new file mode 100644
index 0000000000..333dd71d52
--- /dev/null
+++ b/dev-docs/bidders/rocketlab.md
@@ -0,0 +1,40 @@
+---
+layout: bidder
+title: RocketLab
+description: Prebid RocketLab Bidder Adapter
+biddercode: rocketlab
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Note
+
+The RocketLab Bidding adapter requires setup before beginning. Please contact us at <support@rocketlab.ai>
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description  | Example | Type       |
+| ------------- | -------- | ------------ | ------- | ---------- |
+| `placementId` | optional | Placement Id | `'0'`   | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`   | `'string'` |
+
+### Note
+
+For prebid.js you only need to use one parameter: either `placementId` or `endpointId`

From 058ccd2431ab6225d3ae5825c0c41583939cca23 Mon Sep 17 00:00:00 2001
From: blakemart557 <Udhav@vidcrunch.com>
Date: Fri, 13 Jun 2025 18:33:49 +0530
Subject: [PATCH 194/665] Update vidcrunch.md to align with whitelabel bidder
 aniview (#6098)

* Update vidcrunch.md

This PR updates the vidcrunch.md bidder documentation to mirror the structure and content of the aniview.md file, as VidCrunch operates as a whitelabel solution of Aniview.

Key updates:

Applied all bidder configurations from aniview.md

Replaced all instances of aniview with vidcrunch

Preserved the aliasCode: aniview for compatibility

Updated contact information and example placeholder values specific to VidCrunch

These changes ensure accurate setup instructions and consistency with Prebid documentation standards.

Please review and merge. Let me know if any additional adjustments are required.

Thank you!

* Update dev-docs/bidders/vidcrunch.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/vidcrunch.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/vidcrunch.md | 135 ++++++++++++++++++++++++++++++----
 1 file changed, 121 insertions(+), 14 deletions(-)

diff --git a/dev-docs/bidders/vidcrunch.md b/dev-docs/bidders/vidcrunch.md
index 6b485ca8d8..0560558e38 100644
--- a/dev-docs/bidders/vidcrunch.md
+++ b/dev-docs/bidders/vidcrunch.md
@@ -6,12 +6,17 @@ pbjs: true
 biddercode: vidcrunch
 aliasCode: aniview
 media_types: banner, video
-gvl_id: 780 (aniview)
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-any
 tcfeu_supported: true
+floors_supported: true
 usp_supported: true
 schain_supported: true
 safeframes_ok: true
+gvl_id: 780 (aniview)
 sidebarType: 1
+userIds: all
 ---
 
 ### Note
@@ -21,29 +26,131 @@ For more information about [VidCrunch](https://vidcrunch.com/), please contact <
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name             | Scope    | Description      | Example                      | Type     |
-|------------------|----------|------------------|------------------------------|----------|
-| `AV_PUBLISHERID` | required | Publisher/Netid  | `'55b88d4a181f465b3e8b4567'` | `string` |
-| `AV_CHANNELID`   | required | Channel id       | `'5a5f17a728a06102d14c2718'` | `string` |
+| Name             | Scope    | Description           | Example              | Type     |
+|------------------|----------|-----------------------|----------------------|----------|
+| `AV_PUBLISHERID` | required | Publisher/Network ID  | `'Get from VidCrunch'` | `string` |
+| `AV_CHANNELID`   | required | Channel ID            | `'Get from VidCrunch'` | `string` |
+
+### Setup for Video
+
+```javascript
+const adUnit = [{
+  code: 'videoAdUnit',
+  mediaTypes: {
+    video: {
+      // Required
+      playerSize: [[640, 480]],
+      context: 'outstream',
+      mimes: ['video/mp4', 'video/mpeg', 'application/javascript'],
+      
+      // Optional
+      playbackmethod: [1, 2],
+      protocols: [1, 2, 3, 5, 6, 7, 8],
+      api: [1, 2],
+      maxduration: 60,
+      plcmt: 4,
+    },
+  },
+  bids: [{
+    bidder: 'vidcrunch',
+    params: {
+      // Required
+      AV_PUBLISHERID: 'Get from VidCrunch',
+      AV_CHANNELID: 'Get from VidCrunch',
+    },
+  }],
+}];
+```
+
+### Setup for Banner
+
+```javascript
+const adUnit = [{
+  code: 'bannerAdUnit',
+  mediaTypes: {
+    banner: {
+      // Required
+      sizes: [[300, 250], [300, 600]],
+    },
+  },
+  bids: [{
+    bidder: 'vidcrunch',
+    params: {
+      // Required
+      AV_PUBLISHERID: 'Get from VidCrunch',
+      AV_CHANNELID: 'Get from VidCrunch',
+    },
+  }],
+}];
+```
 
-### Test Parameters
+### Setup for Multi-format (Banner & Video)
 
 ```javascript
-const videoAdUnit = [
-{
-  code: 'video1',
+const adUnit = [{
+  code: 'multiformatAdUnit',
   mediaTypes: {
+    banner: {
+      // Required
+      sizes: [[300, 250], [300, 600]],
+    },
     video: {
+      // Required
       playerSize: [[640, 480]],
-      context: 'outstream'
+      context: 'outstream', 
+      mimes: ['video/mp4', 'video/mpeg', 'application/javascript'],
     },
   },
   bids: [{
     bidder: 'vidcrunch',
     params: {
-      AV_PUBLISHERID: '55b78633181f4603178b4568',
-      AV_CHANNELID: '5d19dfca4b6236688c0a2fc4'
-    }
-  }]
+      // Required
+      AV_PUBLISHERID: 'Get from VidCrunch',
+      AV_CHANNELID: 'Get from VidCrunch',
+    },
+  }],
 }];
 ```
+
+### Bidder specific configs
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['vidcrunch'],
+  config: {
+    ortb2: {
+      ext: {
+        vidcrunch: {
+          // Additional data to send to the Ad Server
+        },
+      },
+    },
+  },
+}, true);
+```
+
+### User Sync example
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      // Iframe and Image
+      all: {
+        bidders: ['vidcrunch'],
+        filter: 'include',
+      },
+        
+      // Or you can specify which type should be enabled/disabled:
+      iframe: {
+        bidders: ['vidcrunch'],
+        filter: 'include',
+      },
+      image: {
+        bidders: '*', // '*' represents all bidders
+        filter: 'include', // or 'exclude'
+      },
+    },
+  },
+});
+```

From 6f395b19adf7451c6f2409348eb2a1e867db0051 Mon Sep 17 00:00:00 2001
From: Saar Amrani <saar120@gmail.com>
Date: Wed, 18 Jun 2025 17:27:43 +0300
Subject: [PATCH 195/665] Add Omnidex Bidder Adapter documentation (#6020)

* Add Omnidex Bidder Adapter documentation in omnidex.md

* Update dev-docs/bidders/omnidex.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/omnidex.md | 72 +++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 dev-docs/bidders/omnidex.md

diff --git a/dev-docs/bidders/omnidex.md b/dev-docs/bidders/omnidex.md
new file mode 100644
index 0000000000..719547c393
--- /dev/null
+++ b/dev-docs/bidders/omnidex.md
@@ -0,0 +1,72 @@
+---
+layout: bidder
+title: Omnidex
+description: Prebid Omnidex Bidder Adaptor
+biddercode: omnidex
+filename: omnidexBidAdapter
+userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: false
+schain_supported: true
+gpp_supported: true
+floors_supported: true
+media_types: banner, video
+prebid_member: false
+safeframes_ok: false
+deals_supported: false
+pbs_app_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+pbjs: true
+pbs: false
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from Omnidex.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`      | required | The publisher ID from Omnidex (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. omnidex will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+### Example
+
+  ```javascript
+var adUnits = [{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [728, 90]
+            ]
+        }
+    },
+    bids: [{
+        bidder: 'omnidex',
+        params: {
+            cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
+            pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
+            bidFloor: 1.23                   // Optional
+        }
+    }]
+}
+];
+
+// configure pbjs to enable user syncing
+pbjs.setConfig({
+    userSync: {
+        filterSettings: {
+            iframe: {
+                bidders: 'omnidex',
+                filter: 'include'
+            }
+        }
+    }
+});
+```

From b69a8a212e373606ccb7848fde359b3c9699a61e Mon Sep 17 00:00:00 2001
From: Milos Andrejic <53998566+milosandrejic@users.noreply.github.com>
Date: Mon, 23 Jun 2025 18:59:36 +0200
Subject: [PATCH 196/665] Luponmedia bid adapter update, DynamicAdBoost rtd
 module docs (#6005)

* Luponmedia: params update

* Luponmedia: params update

* DynamicAdBoost rtd module

* Dynamic Ad Boost name and description

* dynamicAdBoostRtdProvider folder location change, included info about external script

* dynamicAdBoostRtd provider - removed link to itself
---
 dev-docs/bidders/luponmedia.md                |  7 +++----
 dev-docs/modules/dynamicAdBoostRtdProvider.md | 18 ++++++++++++++++++
 2 files changed, 21 insertions(+), 4 deletions(-)
 create mode 100644 dev-docs/modules/dynamicAdBoostRtdProvider.md

diff --git a/dev-docs/bidders/luponmedia.md b/dev-docs/bidders/luponmedia.md
index a9821d6e76..a402e61586 100644
--- a/dev-docs/bidders/luponmedia.md
+++ b/dev-docs/bidders/luponmedia.md
@@ -20,7 +20,6 @@ The LuponMedia bidder adapter requires setup and approval from the LuponMedia su
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name   | Scope    | Description              | Example | Type      |
-|--------|----------|--------------------------|---------|-----------|
-| `siteId`  | required | The publisher's unique site ID | `12345`   | `integer` |
-| `keyId` | required | The key ID              | `4o2c4` | `string` |
+| Name   | Scope    | Description              | Example         | Type      |
+|--------|----------|--------------------------|-----------------|-----------|
+| `keyId`| required | The key ID               | `uid_test_1234` | `string`  |
diff --git a/dev-docs/modules/dynamicAdBoostRtdProvider.md b/dev-docs/modules/dynamicAdBoostRtdProvider.md
new file mode 100644
index 0000000000..8474fc6bef
--- /dev/null
+++ b/dev-docs/modules/dynamicAdBoostRtdProvider.md
@@ -0,0 +1,18 @@
+---
+layout: page_v2
+title: Dynamic Ad Boost Real Time Data Provider
+display_name: Dynamic Ad Boost Real Time Data Provider
+description: Dynamic Ad Boost Real Time Data Provider
+page_type: module
+module_type: rtd
+module_code: dynamicAdBoostRtd
+enable_download: false
+vendor_specific: true
+sidebarType : 1
+---
+
+# Dynamic Ad Boost Real-time Data Submodule
+
+There is no need for any parameters — we will do all the work automatically for you.
+
+{% include dev-docs/loads-external-javascript.md %}

From 17b02f2d55f307a644c2ba43a232109c7c22c6f4 Mon Sep 17 00:00:00 2001
From: prebid-startio <prebid@start.io>
Date: Tue, 24 Jun 2025 00:19:17 +0300
Subject: [PATCH 197/665] New Adapter: Start.io (#6018)

* Add initial documentation for Start.io adapters

* Adjustments based on review comments
---
 dev-docs/bidders/startio.md | 69 +++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 dev-docs/bidders/startio.md

diff --git a/dev-docs/bidders/startio.md b/dev-docs/bidders/startio.md
new file mode 100644
index 0000000000..72dd7fbd2a
--- /dev/null
+++ b/dev-docs/bidders/startio.md
@@ -0,0 +1,69 @@
+---
+layout: bidder
+title: Start.io
+biddercode: startio
+description: Prebid Start.io Adapter
+tcfeu_supported: true
+coppa_supported: false
+gpp_supported: false
+floors_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-any
+safeframes_ok: false
+schain_supported: false
+gvl_id: 1216
+usp_supported: false
+pbjs: true
+pbs: true
+prebid_member: false
+fpd_supported: false
+privacy_sandbox: no
+ortb_blocking_supported: false
+sidebarType: 1
+---
+
+### Before You Begin
+
+The Start.io bidder adapter requires additional setup and approval from the Start.io team. For additional information, please reach out to <prebid@start.io>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                       | Example                | Type         |
+|---------------|----------|-----------------------------------|------------------------|--------------|
+| `publisherId` | required | Publisher ID                      | `'publisher-1234'`     | `string`     |
+
+#### Configuration
+
+Sample banner setup:
+
+```js
+var adUnits = [
+  {
+    code: "div-gpt-ad-12345-0",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]]
+      }
+    },
+    bids: [
+      {
+        bidder: "startio",
+        params: {
+          publisherId: "publisher-12345"
+        }
+      }
+    ]
+  }
+]
+
+pbjs.que.push(function() {
+  pbjs.addAdUnits(adUnits);
+});
+```
+
+### Additional Notes
+
+#### Request and Response Attributes
+
+- Bids are returned in **net** - that is, the bids returned reflect the bid amount with revenue sharing already taken into account. No adjustment is necessary.

From a58eb8550bfc1fc05b8409e3df827d6bafa85d10 Mon Sep 17 00:00:00 2001
From: epomrnd <epomrnd@users.noreply.github.com>
Date: Tue, 24 Jun 2025 09:31:10 +0300
Subject: [PATCH 198/665] Update documentation for Epom Bid Adapter (#6073)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add doc md

* add real data for EPOM DSP

* update doc

* fix markup

---------

Co-authored-by: Vladyslav <v.vit@epom.com”>
---
 dev-docs/bidders/epomDspBidAdapter.md | 226 ++++++++++++++------------
 1 file changed, 125 insertions(+), 101 deletions(-)

diff --git a/dev-docs/bidders/epomDspBidAdapter.md b/dev-docs/bidders/epomDspBidAdapter.md
index 81dc74682c..3449f30508 100644
--- a/dev-docs/bidders/epomDspBidAdapter.md
+++ b/dev-docs/bidders/epomDspBidAdapter.md
@@ -27,119 +27,143 @@ sidebarType: 1
 
 ## Overview
 
-The **Epom DSP Bid Adapter** allows publishers to connect with the Epom DSP Exchange for programmatic advertising. It supports banner formats and adheres to the OpenRTB protocol.
+The **Epom DSP Bid Adapter** enables publishers to monetize inventory via the Epom DSP Exchange using the OpenRTB protocol. It supports **banner media types** and enforces required fields to ensure bid validity and proper auction participation.
 
-## Bid Params
+---
+
+## Bid Parameters
 
-{: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                              | Example  | Type    |
-|------------|---------|----------------------------------|---------|--------|
-| `endpoint` | required | The URL of the Epom DSP bidding endpoint | `'https://bidder.epommarket.com/bidder/v2_5/bid?key=your_api_key'` | `string` |
-| `placementId` | optional | Unique identifier for the placement      | `'12345'` | `string` |
-| `bidfloor` | optional | Minimum CPM value for the bid in USD    | `0.5`     | `number` |
+| Name          | Scope    | Description                                                     | Example                                                            | Type     |
+| ------------- | -------- | --------------------------------------------------------------- | ------------------------------------------------------------------ | -------- |
+| `endpoint`    | required | Full URL to the Epom DSP bidding endpoint                       | `'https://bidder.epommarket.com/bidder/v2_5/bid?key=your_api_key'` | `string` |
+| `placementId` | optional | Placement identifier provided by Epom                           | `'12345'`                                                          | `string` |
+| `bidfloor`    | optional | Minimum CPM for bid, in USD (unless FX enabled on tenant level) | `0.50`                                                             | `number` |
+
+---
 
-## Example Configuration
+## Example Ad Unit Configuration
 
 ```javascript
-     var adUnits = [
-    {
-        code: 'epom-banner-div',
-        mediaTypes: {
+var adUnits = [{
+    code: 'epom-banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250]]
+        }
+    },
+    bids: [{
+        bidder: 'epom_dsp',
+        params: {
+            endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+        },
+        imp: [{
+            id: '2',
             banner: {
-                sizes: [
-                    [300, 250]
-                ]
+                w: 300,
+                h: 250,
+                btype: [4],
+                pos: 0,
+                api: [3]
+            },
+            bidfloor: 0.01,
+            bidfloorcur: 'USD'
+        }],
+        site: {
+            id: 'fc59bd54-36df-4d33-830c-fdsfds',
+            domain: 'epom.com',
+            publisher: {
+                id: 'testid'
+            },
+            content: {
+                id: '1234567',
+                title: 'Car Show',
+                series: 'All About Cars',
+                season: '2',
+                cat: ['IAB2-2']
             }
         },
-        bids: [
-            {
-                bidder: 'epom_dsp',
-                params: {
-                    endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
-                },
-                "imp": [
-                    {
-                        "banner": {
-                            "w": 300,
-                            "h": 250,
-                            "btype": [
-                                4
-                            ],
-                            "pos": 0,
-                            "api": [
-                                3
-                            ]
-                        },
-                        "instl": 0,
-                        "tagid": "test4",
-                        "bidfloor": 0.01,
-                        "bidfloorcur": "USD",
-                        "id": "2"
-                    }
-                ],
-                "site": {
-                    "id": "fc59bd54-36df-4d33-830c-fdsfds",
-                    "domain": "epom.com",
-                    "privacypolicy": 0,
-                    "publisher": {
-                        "id": "testid"
-                    },
-                    "content": {
-                        "id": "1234567",
-                        "episode": 23,
-                        "title": "Car Show",
-                        "series": "All About Cars",
-                        "season": "2",
-                        "cat": [
-                            "IAB2-2"
-                        ]
-                    }
-                },
-                "device": {
-                    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
-                    "geo": {
-                        "country": "UKR",
-                        "region": "",
-                        "city": ""
-                    },
-                    "ip": "176.112.120.50",
-                    "devicetype": 2,
-                    "os": "windows",
-                    "osv": "",
-                    "js": 1,
-                    "language": "US",
-                    "carrier": "VERIZON",
-                    "connectiontype": 5,
-                    "ifa": "AA000DFE74168477C70D291f574D344790E0BB11"
-                },
-                "user": {
-                    "id": "testiduser"
-                },
-                "test": 0,
-                "at": 2,
-                "allimps": 0,
-                "cur": [
-                    "USD"
-                ],
-                "bcat": [
-                    "IAB25-2",
-                    "IAB25-1"
-                ],
-                "badv": [],
-                "id": "NewIdTest"
-            }
-        ]
-    }
-];
+        device: {
+            ua: navigator.userAgent,
+            ip: '176.112.120.50',
+            devicetype: 2,
+            os: 'windows',
+            js: 1,
+            language: 'US',
+            carrier: 'VERIZON',
+            connectiontype: 5
+        },
+        user: {
+            id: 'testiduser'
+        },
+        id: 'NewIdTest',
+        cur: ['USD'],
+        bcat: ['IAB25-2', 'IAB25-1'],
+        badv: []
+    }]
+}];
 ```
 
-## GDPR and Privacy Compliance
+---
+
+## Required Fields for Bid Request Validation
+
+To be considered **valid**, a bid request must include the following:
+
+| Field         | Location      | Description                                                           |
+| ------------- | ------------- | --------------------------------------------------------------------- |
+| `request.id`  | root          | Unique ID for the request                                             |
+| `imp[]`       | root          | Must contain at least one impression object                           |
+| `imp[i].id`   | imp object    | Unique impression ID                                                  |
+| `site.domain` | site object   | Must be present (or `app.bundle` if app-based)                        |
+| `device.ip`   | device object | Device IP address (required unless IP forwarding feature is disabled) |
+| `cur[]`       | root          | Must be `['USD']` unless currency FX is enabled on tenant level       |
+
+If any of the above is missing or malformed, the bid request will be **rejected** by the adapter during validation (`isBidRequestValid`).
 
-The **Epom DSP Bid Adapter** supports GDPR and CCPA compliance. Consent information can be passed via:
+---
+
+## Privacy Compliance
+
+The Epom DSP adapter supports the following privacy frameworks:
+
+* **GDPR**: via `bidderRequest.gdprConsent.consentString`
+* **US Privacy (CCPA)**: via `bidderRequest.uspConsent`
+* **GPP**: Supports `tcfeu` and `usnat` sections
+
+---
+
+## Testing & Debugging
 
-- `bidderRequest.gdprConsent`
-- `bidderRequest.uspConsent`
+To test integration, use a configuration similar to this inside a local HTML page with Prebid.js:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/prebid.js@9.41.0/dist/not-for-prod/prebid.min.js"></script>
+<script>
+  pbjs.que.push(function() {
+    pbjs.setConfig({ debug: true });
+
+    pbjs.setBidderConfig({
+      bidders: ['epom_dsp'],
+      config: {
+        epomSettings: {
+          endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=your_key'
+        }
+      }
+    });
+
+    pbjs.addAdUnits([/* ...adUnits as above... */]);
+    pbjs.requestBids({
+      bidsBackHandler: function(bidResponses) {
+        console.log('Epom DSP Responses:', bidResponses);
+      }
+    });
+  });
+</script>
+```
+
+---
 
 ## Support
 
-For integration assistance, contact [Epom Support](mailto:support@epom.com).
+For questions or assistance integrating Epom DSP into your Prebid setup, please contact:
+📩 [support@epom.com](mailto:support@epom.com)

From 4600da35744cf19a6c41ab0a3fb4d2973112799b Mon Sep 17 00:00:00 2001
From: tal avital <tal.a@taboola.com>
Date: Tue, 24 Jun 2025 14:47:18 +0300
Subject: [PATCH 199/665] add taboolaId user id submodule documentation (#6106)

* add taboolaId user id submodule documentation

* fix blank lines
---
 dev-docs/bidders/taboola.md                   |  1 +
 dev-docs/modules/userid-submodules/taboola.md | 60 +++++++++++++++++++
 2 files changed, 61 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/taboola.md

diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md
index 2b4572d3cb..cf763dc00f 100644
--- a/dev-docs/bidders/taboola.md
+++ b/dev-docs/bidders/taboola.md
@@ -19,6 +19,7 @@ safeframes_ok: true
 fpd_supported: true
 ortb_blocking_supported: partial
 deals_supported: false
+userIds: taboolaId
 pbs_app_supported: true
 multiformat_supported: will-not-bid
 sidebarType: 1
diff --git a/dev-docs/modules/userid-submodules/taboola.md b/dev-docs/modules/userid-submodules/taboola.md
new file mode 100644
index 0000000000..5e6cca82e7
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/taboola.md
@@ -0,0 +1,60 @@
+---
+layout: userid
+title: Taboola ID
+description: Taboola ID User ID sub-module
+useridmodule: taboolaIdSystem
+bidRequestUserId: taboolaId
+eidsource: taboola.com
+example: '"abc123def456"'
+---
+
+
+Taboola is a global leader in powering recommendations across the open web. The Taboola ID module allows publishers to enable identity support for Taboola demand by leveraging a persistent user ID from Taboola's identity infrastructure.
+
+This ID helps improve addressability, performance, and monetization opportunities across Taboola-integrated supply paths, particularly in environments where third-party cookies are limited or unavailable.
+
+The Taboola privacy policy can be found at [www.taboola.com/privacy-policy](https://www.taboola.com/privacy-policy).
+
+Add it to your Prebid.js package with:
+
+```bash
+gulp build --modules=taboolaIdSystem,userId
+```
+
+## Taboola ID Configuration
+
+The Taboola ID module does not require any configuration parameters. If needed, it supports an optional `storage` config to persist the ID locally.
+
+{: .alert.alert-info :}
+NOTE: The Taboola ID module supports both first-party and server-side Prebid identity environments.
+
+The following configuration parameters are available:
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description                                               | Example                                                   |
+| --- | --- | --- |-----------------------------------------------------------|-----------------------------------------------------------|
+| name | Required | String | The name of this sub-module                               | `"taboolaId"`                                             |
+| storage |||                                                           |                                                           |
+| storage.name | Required | String | The name of the cookie or html5 local storage key         | `"taboolaId"` (recommended)                               |
+| storage.type | Required | String | This is where the taboola user ID will be stored          | `"cookie&html5"` (recommended) or `"html5"` |
+| storage.expires | Strongly Recommended | Number | How long (in days) the user ID information will be stored | `365` (recommended)                                       |
+
+## Taboola ID Example
+
+```javascript
+pbjs.setConfig({
+       userSync: {
+           userIds: [
+               {
+                   name: 'taboolaId',
+                   storage: {          //Optionally specify where to store the ID, e.g. cookies or localStorage
+                       name: 'taboolaId',
+                       type: 'html5', // or 'html5&cookie'
+                       expires: 365  // days
+                   }
+               }
+           ]
+       }
+});
+```

From 14d6cb427754f51d8f67c22c5c66c46b1369e218 Mon Sep 17 00:00:00 2001
From: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Date: Wed, 25 Jun 2025 21:53:08 +0300
Subject: [PATCH 200/665] IntentIq ID & Analytics Modules: Supports additional
 configuration parameters (#6043)

* fix spelling

* Agt 454 group changes (#13)

* AGT-403: Add adType parameter description

* Merge pull request #2 from DimaIntentIQ/AGT-466-module-reporting-placement-id-unit-code

IntentIq ID & Analytics Modules: placementId parameter documentation

* IntentIq ID: Documentation for sourceMetaData and sourceMetaDataExternal (#5)

* Fix table

* AGT-453: Documentation for sourceMetaData

* fix docs and add docs (#6)

* AGT-498: reportMethod description (#7)

* add groupchanged param docs

* remove/add new lines

* Add missed params

---------

Co-authored-by: dmytro-po <dmytro.po@intentiq.com>
Co-authored-by: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Co-authored-by: dLepetynskyiIntentiq <danylo.le@intentiq.com>
Co-authored-by: Eyvaz Ahmadzada <eyvazahmadzada@gmail.com>
Co-authored-by: DimaIntentIQ <dmytro.piskun@intentiq.com>

---------

Co-authored-by: Eyvaz <62054743+eyvazahmadzada@users.noreply.github.com>
Co-authored-by: dmytro-po <dmytro.po@intentiq.com>
Co-authored-by: dLepetynskyiIntentiq <danylo.le@intentiq.com>
Co-authored-by: Eyvaz Ahmadzada <eyvazahmadzada@gmail.com>
---
 dev-docs/analytics/intentiq.md                |  3 ++
 .../modules/userid-submodules/intentiq.md     | 46 +++++++++++++++----
 2 files changed, 41 insertions(+), 8 deletions(-)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index d56f2f7069..c44c28ca73 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -80,9 +80,11 @@ originalCpm: 1.5, // Original CPM value.
 originalCurrency: 'USD', // Original currency.
 status: 'rendered', // Auction status, e.g., 'rendered'.
 placementId: 'div-1' // ID of the ad placement.
+adType: 'banner' // Specifies the type of ad served
 }
 ```
 
+{: .table .table-bordered .table-striped }
 | Field              | Data Type | Description                                                                                                                                      | Example                       | Mandatory |
 |--------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|-----------|
 | biddingPlatformId   | Integer   | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1                             | Yes       |
@@ -95,6 +97,7 @@ placementId: 'div-1' // ID of the ad placement.
 | originalCurrency    | String    | Currency of the original auction                                                                                                                 | USD                           | No        |
 | status              | String    | Status of the impression. Leave empty or undefined if Prebid is not the bidding platform                                                          | rendered                      | No        |
 | placementId         | String    | Unique identifier of the ad unit on the webpage that showed this ad                                                                               | div-1                         | No        |
+| adType              | String    | Specifies the type of ad served. Possible values: “banner“, “video“, “native“, “audio“.                                                           | banner                        | No        |
 
 To report the auction win, call the function as follows:
 
diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 4e3044de0e..adc47a0ebd 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -41,13 +41,26 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.partner                 | Required | Number   | This is the partner ID value obtained from registering with IntentIQ.                                                                                                                                                                                                                                                                     | `1177538`                                     |
 | params.pcid                    | Optional | String   | This is the partner cookie ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                                             | `"g3hC52b"`                                   |
 | params.pai                     | Optional | String   | This is the partner customer ID / advertiser ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                           | `"advertiser1"`                               |
-| params.callback                | Optional | Function | This is a callback which is trigered with data and AB group                                                                                                                                                                                                                                                                               | `(data, group) => console.log({ data, group })` |
+| params.callback                | Optional | Function | This is a callback which is triggered with data                                                                                                                                                                                                                                                                               | `(data) => console.log({ data })` |
 | params.timeoutInMillis         | Optional | Number   | This is the timeout in milliseconds, which defines the maximum duration before the callback is triggered. The default value is 500.                                                                                                                                                                                                       | `450`                                         |
-| params.browserBlackList        | Optional |  String  | This is the name of a browser that can be added to a blacklist.                                                                                                                                                                                                                                                                           | `"chrome"`                                    |
-| params.manualWinReportEnabled  | Optional | Boolean  | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `true`|
+| params.browserBlackList        | Optional | String   | This is the name of a browser that can be added to a blacklist.                                                                                                                                                                                                                                                                           | `"chrome"`                                    |
+| params.manualWinReportEnabled  | Optional | Boolean  | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `true`                                        |
 | params.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.                     | `"currentDomain.com"`                         |
-| params.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.                                                                                                                                                                  | `googletag`                           |
+| params.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.                                                                                                                                                            | `googletag`                                   |
 | params.gamParameterName        | Optional | String   | The name of the targeting parameter that will be used to pass the group. If not specified, the default value is `intent_iq_group`.                                                                                                                                                                                                        | `"intent_iq_group"`                           |
+| params.adUnitConfig            | Optional | Number   | Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId                                                                                                                                             | `1`                                           |
+| params.sourceMetaData          | Optional | String   | This metadata can be provided by the partner and will be included in the requests URL as a query parameter                                                                                                                                                                                                                                | `"123.123.123.123"`                           |
+| params.sourceMetaDataExternal  | Optional | Number   | This metadata can be provided by the partner and will be included in the requests URL as a query parameter                                                                                                                                                                                                                                | `123456`                                      |
+| params.iiqServerAddress        | Optional | String   | The base URL for the IntentIQ API server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                                    | `"https://domain.com"`                        |
+| params.iiqPixelServerAddress   | Optional | String   | The base URL for the IntentIQ pixel synchronization server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                  | `"https://domain.com"`                        |
+| params.reportingServerAddress  | Optional | String   | The base URL for the IntentIQ reporting server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                              | `"https://domain.com"`                        |
+| params.reportMethod            | Optional | String   | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL.                                                                                             |`"GET"`                                        |
+| params.siloEnabled             | Optional | Boolean  | Determines if first-party data is stored in a siloed storage key. When set to `true`, first-party data is stored under a modified key that appends `_p_` plus the partner value rather than using the default storage key. The default value is `false`.                                                                          | `true`                                        |
+| params.groupChanged            | Optional | Function | A callback that is triggered every time the user’s A/B group is set or updated.                                                                                         |`(group) => console.log('Group changed:', group)` |
+| params.additionalParameters | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
+| params.additionalParameters [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
+| params.additionalParameters [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
+| params.additionalParameters [0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
 
 ### Configuration example
 
@@ -60,11 +73,28 @@ pbjs.setConfig({
                 partner: 123456,     // valid partner id
                 timeoutInMillis: 500,
                 browserBlackList: "chrome",
-                callback: (data, group) => window.pbjs.requestBids(),
-                manualWinReportEnabled: true,
+                callback: (data) => {...}, // your logic here
+                groupChanged: (group) => console.log('Group is', group),
+                manualWinReportEnabled: true, // Optional parameter
                 domainName: "currentDomain.com",
-                gamObjectReference: googletag,
-                gamParameterName: "intent_iq_group"
+                gamObjectReference: googletag, // Optional parameter
+                gamParameterName: "intent_iq_group", // Optional parameter
+                adUnitConfig: 1, // Extracting placementId strategy (adUnitCode or placementId order of priorities)
+                sourceMetaData: "123.123.123.123", // Optional parameter
+                sourceMetaDataExternal: 123456, // Optional parameter
+                reportMethod: "GET", // Optional parameter
+                additionalParameters: [ // Optional parameter
+                    {
+                      parameterName: "abc",
+                      parameterValue: 123,
+                      destination: [1, 1, 0] // sendWithSync: true, sendWithVr: true, winreport: false
+                    },
+                    {
+                      parameterName: "xyz",
+                      parameterValue: 111,
+                      destination: [0, 1, 1] // sendWithSync: false, sendWithVr: true, winreport: true
+                    }
+                ]
             },
             storage: {
                 type: "html5",

From 40cf5bc759e0e8501162befb144fbb6d5e2cd598 Mon Sep 17 00:00:00 2001
From: Valentin Petrovych
 <72038591+ValentinPostindustria@users.noreply.github.com>
Date: Thu, 26 Jun 2025 17:35:33 +0200
Subject: [PATCH 201/665] Impression tracking for Mobile Original api (#5713)

* Impression tracking for Mobile Original api.

* Lint correction.

* doc: add ios impression tracking section

* Update android-sdk-integration-gam-original-api.md

doc: update Android section

* Update ios-sdk-integration-gam-original-api.md

doc: update iOS DOC

* doc: minor change in ios-sdk-integration-gam-original-api.md

* Update android-sdk-integration-gam-original-api.md

doc: small change

---------

Co-authored-by: Olena Stepaniuk <olena.stepaniuk@postindustria.com>
Co-authored-by: Yuriy Velichko <yuriy.velichko@postindustria.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 ...ndroid-sdk-integration-gam-original-api.md | 22 +++++++++++++++++
 .../ios-sdk-integration-gam-original-api.md   | 24 +++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.md b/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.md
index 9642040148..7d2df6902c 100755
--- a/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.md
+++ b/prebid-mobile/pbm-api/android/android-sdk-integration-gam-original-api.md
@@ -41,6 +41,28 @@ This section describes the integration details for different ad formats. In each
 
 {% include mobile/adunit-config-android.md %}
 
+### Impression tracking
+
+In the Bidding Only integration scenario, PUC is responsible for tracking events for banner ads, like `burl`, `imp`, and `win`. The disadvantage of this approach is that PUC doesn't have reliable information about the viewability of the WebView. As a result, impression tracking happens at the rendering stage of the ad. Or, if MRAID is supported, once the `viewableChange` event is fired. It leads to big discrepancies since the "1 pixel in view" requirement is not met.
+
+Starting with version `2.4.0`, Prebid SDK introduced the API to track the viewability of the ad and track impression event, respectively. 
+
+To activate impression tracking for the banner ad unit - use the `activatePrebidImpressionTracker(adView)` method. The `adView` parameter should be an instance of AdManagerAdView:
+
+```java
+adUnit.activatePrebidImpressionTracker(adView)
+adUnit.fetchDemand(builder, resultCode -> { ... })
+```
+
+For activation for the interstitial ad unit, you should set `activatePrebidImpressionTracker()` flag:
+
+```java
+Interstitial adUnit = InterstitialAdUnit(CONFIG_ID, WIDTH, HEIGTH);
+adUnit.activatePrebidImpressionTracker();
+```
+
+After the invocation of `activatePrebidImpressionTracker(),` the Prebid SDK will start analyzing the View Hierarchy and track the viewability of the ad view. Once the ad view is viewable for the user for at least 1 pixel for 1 second, the SDK will track an impression event for the presented ad. The SDK will stop analyzing the View Hierarchy once the caller object of `activatePrebidImpressionTracker()` is destroyed. 
+
 ## Further Reading
 
 - [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
diff --git a/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.md b/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.md
index 391385004e..f7b849f3e6 100644
--- a/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.md
+++ b/prebid-mobile/pbm-api/ios/ios-sdk-integration-gam-original-api.md
@@ -41,6 +41,30 @@ This section describes the integration details for different ad formats. In each
 
 {% include mobile/adunit-config-ios.md %}
 
+### Impression tracking
+
+In the Bidding Only integration scenario, PUC is responsible for tracking events for banner ads, like `burl`, `imp`, and `win`. The disadvantage of this approach is that PUC doesn't have reliable information about the viewability of the WebView. As a result, impression tracking happens at the rendering stage of the ad. Or, if MRAID is supported, once the `viewableChange` event is fired. It leads to big discrepancies since the "1 pixel in view" requirement is not met.
+
+Starting with version `2.4.0`, Prebid SDK introduced the API to track the viewability of the ad and track impression event, respectively. 
+
+To activate impression tracking for the banner ad unit - use the `activatePrebidImpressionTracker(adView)` method. The `adView` parameter should be an instance of AdManagerAdView:
+
+```swift
+adUnit.activatePrebidImpressionTracker(adView: gamBanner)
+adUnit.fetchDemand(adObject: gamRequest) { [weak self] resultCode in
+    // ...
+}
+```
+
+For activation for the interstitial ad unit, you should set `activatePrebidImpressionTracker()` flag:
+
+```swift
+let adUnit = InterstitialAdUnit(configId: CONFIG_ID, minWidthPerc: WIDTH_PERC, minHeightPerc: HEIGTH_PERC)
+adUnit.activatePrebidImpressionTracker()
+```
+
+After the invocation of `activatePrebidImpressionTracker(),` the Prebid SDK will start analyzing the View Hierarchy and track the viewability of the ad view. Once the ad view is viewable for the user for at least 1 pixel for 1 second, the SDK will track an impression event for the presented ad. The SDK will stop analyzing the View Hierarchy once the caller object of `activatePrebidImpressionTracker()` is destroyed. 
+
 ## Further Reading
 
 - [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)

From 05850fd494dc8b10e1ee3fc207085d46b7769690 Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.com>
Date: Thu, 26 Jun 2025 11:36:08 -0400
Subject: [PATCH 202/665] Update fwssp dev-docs for Prebid.js fwsspBidAdapter
 (#6104)

* Update dev-docs for Prebid.js fwssp bid adapter

* Fix linting issues

---------

Co-authored-by: Aaron Friedman <afriedman@freewheel.com>
---
 dev-docs/bidders/fwssp.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index ea59bac082..586257843e 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -2,6 +2,7 @@
 layout: bidder
 title: FWSSP
 description: Freewheel Bidder Adaptor
+pbjs: true
 pbs: true
 biddercode: fwssp
 gvl_id: 285
@@ -16,6 +17,7 @@ ortb_blocking_supported: partial
 
 ### Bid Params
 
+The following bid params are for use with the Prebid Server bid adapter:
 {: .table .table-bordered .table-striped }
 | Name     | Scope    | Description | Example | Type     |
 |----------|----------|-------------------------|--------|----------|
@@ -23,3 +25,28 @@ ortb_blocking_supported: partial
 | `network_id` | required | Network ID | "12345" | `string` |
 | `profile_id` | required | The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "prof_12345" | `string` |
 
+The following bid params are for use with the Prebid.js bid adapter:
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description | Example | Type     |
+|----------|----------|-------------------------|--------|----------|
+| `serverUrl` | required | Server Url | "`https://81cec.v.fwmrm.net/ad/g/1`"   | `string` |
+| `networkId` | required | Network ID | "96749" | `string` |
+| `profile` | required | Profile Name - The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "96749:global-js"   | `string`   |
+| `siteSectionId` | required | Custom Site Section tag or numeric Site Section ID | "ss_12345" | `string` |
+| `videoAssetId` | required | Custom content Video Asset ID | "pause_ad_video" | `string` |
+| `flags` | optional | Optional flags to include in the ad request | '+play-uapl' | `string` |
+| `mode` | optional | Request mode. Valid values are: “on-demand", "live". Default: "on-demand" | "live" | `string` |
+| `adRequestKeyValues` | optional | An object of ad request key-value pairs. | { \_fw_player_width: '1920', \_fw_player_height: '1080' } | `object` |
+| `gdpr_consented_providers` | optional | List of Consented Providers. A comma-separated list of ids. | "216,229,80,359,479" | `string` |
+| `tpos` | optional | Slot time position in seconds. Default: 0 | 10 | `number` |
+| `slid` | optional | Slot custom ID. Any string with valid letters/digits/symbols. Default: "Preroll_1" | "CustomPreroll" | `string` |
+| `slau` | optional | Specify custom ad unit names for this slot. Multiple ad unit names can be put into this parameter, separated by "\|". Ad unit group names are also supported but you can only specify one ad unit group; multiple ad unit groups or mixed ad unit group and ad unit names are not supported. Default: "preroll" | "pre1\|pre2" | `string` |
+| `minD` | optional | The minimum duration of a slot, in seconds. | 30 | `number` |
+| `maxD` | optional | The maximum duration of a slot, in seconds. | 30 | `number` |
+| `listeners` | optional | An object of AdManager event listeners | { onSlotStarted: this.onSlotStarted, adEvent: this.onAdEvent, onSlotEnded: this.onSlotEnded } | `object` |
+| `isMuted` | optional | Constrols if ad playback should start with volume muted. Default: true | false | `boolean` |
+| `showMuteButton` | optional | Controls if a mute button should be shown during ad playback.  Default: false | true | `boolean` |
+| `playerParams` | optional | An object of AdManager player parameter values | { "renderer.video.startDetectTimeout": 5000 } | `object` |
+| `sdkVersion` | optional | The AdManager sdk version to use for playback. This is only valid for "outstream" formats. Default: "7.10.0" | "7.11.0" | `string` |
+| `format` | optional | The format to use for displaying the ad. Default: outstream | "inbanner" | `string` |
+| `env` | optional | The AdManager build to use for ad playback. Valid values: "prd", "stg". Default: "prd" | "stg" | `string` |

From 282ede5cf2d2c8a0b72bc445d2271fcd1210387e Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.com>
Date: Fri, 27 Jun 2025 00:36:22 -0400
Subject: [PATCH 203/665] Fix dev-docs formatting (#6112)

Co-authored-by: Aaron Friedman <afriedman@freewheel.com>
---
 dev-docs/bidders/fwssp.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index 586257843e..c483c11de5 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -18,6 +18,7 @@ ortb_blocking_supported: partial
 ### Bid Params
 
 The following bid params are for use with the Prebid Server bid adapter:
+
 {: .table .table-bordered .table-striped }
 | Name     | Scope    | Description | Example | Type     |
 |----------|----------|-------------------------|--------|----------|
@@ -26,6 +27,7 @@ The following bid params are for use with the Prebid Server bid adapter:
 | `profile_id` | required | The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "prof_12345" | `string` |
 
 The following bid params are for use with the Prebid.js bid adapter:
+
 {: .table .table-bordered .table-striped }
 | Name     | Scope    | Description | Example | Type     |
 |----------|----------|-------------------------|--------|----------|

From 8b1196cf6242714331713106b29ea00e6cabc863 Mon Sep 17 00:00:00 2001
From: CPG <matthias@click-performance.com>
Date: Fri, 27 Jun 2025 13:44:39 +0200
Subject: [PATCH 204/665] Add documentation for new bidstailamedia aliase
 (#6028)

* added bidstailamedia.md documentation

* Update dev-docs/modules/bidstailamedia.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/bidstailamedia.md | 120 +++++++++++++++++++++++++++++
 1 file changed, 120 insertions(+)
 create mode 100644 dev-docs/modules/bidstailamedia.md

diff --git a/dev-docs/modules/bidstailamedia.md b/dev-docs/modules/bidstailamedia.md
new file mode 100644
index 0000000000..24ea3f3de9
--- /dev/null
+++ b/dev-docs/modules/bidstailamedia.md
@@ -0,0 +1,120 @@
+---
+layout: bidder
+title: stailamedia Bidder
+description: Prebid bidstailamedia Bidder Adapter
+pbjs: true
+biddercode: bidstailamedia
+gvl_id: 965 (nexx360)
+tcfeu_supported: true
+usp_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | tag ID                     | `"hk15z9sy"`                             | `string`  |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'bidstailamedia',
+         params: {
+            tagId: 'hk15z9sy'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'bidstailamedia',
+            params: {
+               tagId: 'hk15z9sy'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'bidstailamedia',
+            params: {
+               tagId: 'hk15z9sy'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'bidstailamedia',
+            params: {
+               tagId: 'hk15z9sy',
+               videoTagId: 'hk15z9sy'
+            }
+        }]
+    };
+];
+```

From f65a753463bef1cda84119c26d130931cc4c356e Mon Sep 17 00:00:00 2001
From: Jason Quaccia <jason.quaccia@pubmatic.com>
Date: Fri, 27 Jun 2025 04:44:58 -0700
Subject: [PATCH 205/665] fixed typo in config example (#6107)

---
 dev-docs/modules/userid-submodules/pubmatic.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/pubmatic.md b/dev-docs/modules/userid-submodules/pubmatic.md
index 0231a6ddad..eded7445e3 100644
--- a/dev-docs/modules/userid-submodules/pubmatic.md
+++ b/dev-docs/modules/userid-submodules/pubmatic.md
@@ -40,7 +40,7 @@ pbjs.setConfig({
     userIds: [{
       name: "pubmaticId",
       params: {
-        publisherId: "123456" // Example ID
+        publisherId: 123456 // Example ID
       },
       storage: {
         name: "pubmaticId",

From 165d2283c5167db0ce6bf90a2ee2362ea571253b Mon Sep 17 00:00:00 2001
From: Vadym Shatov <135347097+Gunnar97@users.noreply.github.com>
Date: Fri, 27 Jun 2025 14:47:24 +0300
Subject: [PATCH 206/665] Documentation for Adlane Real Time Data Provider
 Module (#6094)

* Documentation for Adlane Real Time Data Provider Module

* Update  Documentation for Adlane Real Time Data Provider Module

* Update  Documentation for Adlane Real Time Data Provider Module

* Update  Documentation for Adlane Real Time Data Provider Module
---
 dev-docs/modules/adlaneRtdProvider.md | 76 +++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 dev-docs/modules/adlaneRtdProvider.md

diff --git a/dev-docs/modules/adlaneRtdProvider.md b/dev-docs/modules/adlaneRtdProvider.md
new file mode 100644
index 0000000000..955358d6bb
--- /dev/null
+++ b/dev-docs/modules/adlaneRtdProvider.md
@@ -0,0 +1,76 @@
+---
+layout: page_v2
+title: Adlane Real-Time Data Module
+display_name: Adlane RTD Module
+description: Adlane Real-Time Data Provider for Age Verification
+page_type: module
+module_type: rtd
+module_code: adlaneRtdProvider
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# Adlane RTD Provider
+
+## Overview
+
+The Adlane Real-Time Data (RTD) Provider automatically retrieves age verification information and adds it to the bid stream, allowing for age-appropriate ad targeting. This module does not have a Global Vendor List ID (GVL ID).
+
+## Integration
+
+1. Compile the Adlane RTD Module into your Prebid build:
+
+    ```bash
+    gulp build --modules=adlaneRtdProvider ...
+    ```
+
+2. Use `setConfig` to instruct Prebid.js to initialize the adlaneRtdProvider module, as specified below.
+
+## Configuration
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 1000,
+    dataProviders: [
+      {
+        name: "adlane",
+        waitForIt: true,
+      }
+    ]
+  }
+});
+```
+
+## Parameters
+
+| Name      | Type    | Description                                   | Default |
+|-----------|---------|-----------------------------------------------|---------|
+| name      | String  | Must be "adlane"                           | n/a     |
+| waitForIt | Boolean | Whether to wait for the module before auction | true    |
+
+## Age Verification Data
+
+The module attempts to retrieve age verification data from the following sources, in order:
+
+1. AdlCmp API (if available)
+2. Local storage
+
+The age verification data is added to the bid request in the following format:
+
+```javascript
+{
+   ortb2: {
+      regs: {
+         ext: {
+            age_verification: {
+               status: 'accepted', //The acceptance indicates that the user has confirmed they are 21 years of age or older (accepted/declined)
+               id: "123456789123456789", //unique identifier for the age verification // Optional
+               decisionDate: "2011-10-05T14:48:00.000Z", //ISO 8601 date string (e.g.,"2011-10-05T14:48:00.000Z") // Optional, represents the date when the age verification decision was made
+            }
+         }
+      }
+   }
+}
+```

From eb075d5827d280097914d77bd039e8ff1ad675ed Mon Sep 17 00:00:00 2001
From: Ivan Krdzavac <ivan.krdzavac@ogury.co>
Date: Fri, 27 Jun 2025 13:48:24 +0200
Subject: [PATCH 207/665] Ogury: set pbs_app_supported to true (#6041)

---
 dev-docs/bidders/ogury.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/ogury.md b/dev-docs/bidders/ogury.md
index 35380a40cb..416d44ac71 100644
--- a/dev-docs/bidders/ogury.md
+++ b/dev-docs/bidders/ogury.md
@@ -15,6 +15,7 @@ safeframes_ok: false
 deals_supported: false
 pbjs: true
 pbs: true
+pbs_app_supported: true
 prebid_member: false
 sidebarType: 1
 gpp_sids: tcfeu, usnat, usstate_all

From ae2c6557e5f10a34401fce8c424aaa9dddb266f4 Mon Sep 17 00:00:00 2001
From: Lyubomir Shishkov <61063794+lyubomirshishkov@users.noreply.github.com>
Date: Fri, 27 Jun 2025 14:48:47 +0300
Subject: [PATCH 208/665] Add documentation for Improve Digital Bid Adapter's
 newly added support for outgoing request compression (#6096)

---
 dev-docs/bidders/improvedigital.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/improvedigital.md b/dev-docs/bidders/improvedigital.md
index b4bbd09431..32fd0497b8 100644
--- a/dev-docs/bidders/improvedigital.md
+++ b/dev-docs/bidders/improvedigital.md
@@ -16,6 +16,7 @@ gvl_id: 253
 pbs_app_supported: true
 floors_supported: true
 sidebarType: 1
+endpoint_compression: true
 ---
 
 <a name="improvedigital-params"></a>

From 591f71ff94b9057b10f1613455b2d81ec21b106a Mon Sep 17 00:00:00 2001
From: PeiZ <74068135+peixunzhang@users.noreply.github.com>
Date: Fri, 27 Jun 2025 13:51:47 +0200
Subject: [PATCH 209/665] DATA-25163 (#6109)

Remove documentation asking clients not to cache things in storage
---
 dev-docs/modules/userid-submodules/liveintent.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/liveintent.md b/dev-docs/modules/userid-submodules/liveintent.md
index 842cdb94fb..16696bd312 100644
--- a/dev-docs/modules/userid-submodules/liveintent.md
+++ b/dev-docs/modules/userid-submodules/liveintent.md
@@ -106,7 +106,7 @@ The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`,
 #### Note
 
 * `thetradedesk` will be exposed as `tdid` because of historical reasons.
-* In order for `segments` to be present in `ortb2.user.data` of the bid requests, you need to configure the [liveIntentRTDProvider](/dev-docs/modules/liveIntentRtdProvider.html) module. 
+* In order for `segments` to be present in `ortb2.user.data` of the bid requests, you need to configure the [liveIntentRTDProvider](/dev-docs/modules/liveIntentRtdProvider.html) module.
 
 For example, in case `uid2` is configured to be requested in addition to the `nonID`, the `request.userId` object would look like the following:
 
@@ -195,9 +195,6 @@ pbjs.setConfig({
 
 ## LiveIntent ID configuration
 
-{: .alert.alert-info :}
-NOTE: For optimal performance, the LiveIntent ID sub-module should be called at every opportunity. It is best not to use `params.storage` with this sub-module as it has its own optimal caching mechanism.
-
 {: .table .table-bordered .table-striped }
 
 | Param under userSync.userIds[] | Scope | Type | Description | Example |

From 8ec4dc9b5c32bc0ef2fcaf83286f30f39169d0b3 Mon Sep 17 00:00:00 2001
From: CondorXIO <admin@condorx.io>
Date: Fri, 27 Jun 2025 14:52:58 +0300
Subject: [PATCH 210/665] add support to bidfloor + open RTB (#6095)

* add support to bidfloor + open RTB

* fix md file
---
 dev-docs/bidders/condorx.md | 95 +++++++++++++++++++++++++++++++++----
 1 file changed, 85 insertions(+), 10 deletions(-)

diff --git a/dev-docs/bidders/condorx.md b/dev-docs/bidders/condorx.md
index fe4c7c013e..79fbdbeabf 100644
--- a/dev-docs/bidders/condorx.md
+++ b/dev-docs/bidders/condorx.md
@@ -8,7 +8,7 @@ dsa_supported: false
 gvl_id: 1375
 usp_supported: false
 coppa_supported: false
-schain_supported: false
+schain_supported: true
 dchain_supported: false
 media_types: banner, native
 safeframes_ok: false
@@ -30,20 +30,42 @@ The CondorX Bidding adapter requires setup before beginning. Please contact us a
 
 ### Bid params
 
-| Name     | Scope    | Description                                                 | Example              |
-|----------|----------|-------------------------------------------------------------|----------------------|
-| `widget` | required | The widget ID, by CondorX                                  | `12345`              |
-| `website`| required | The website ID, by Condorx                                  | `12345`              |
-| `url`    | optional | Current url                                                 | `https://condorx.io` |
+| Name     | Scope    | Description                                                 | Example              | Type    | Default |
+|----------|----------|-------------------------------------------------------------|----------------------|---------|---------|
+| `widget` | required | The widget ID, by CondorX                                  | `12345`              | integer | - |
+| `website`| required | The website ID, by CondorX                                  | `12345`              | integer | - |
+| `url`    | optional | Current url                                                 | `https://condorx.io` | string  | `'current url'` |
+| `bidfloor` | optional | Minimum bid price in USD                                  | `0.50`               | number  | `-1` |
+| `useOpenRTB` | optional | Enable OpenRTB format requests                          | `true`               | boolean | `false` |
 
-### Example Ad Unit
+### Request Formats
+
+The adapter supports both legacy and OpenRTB request formats:
+
+#### Legacy Format (Default)
+Uses GET request to legacy endpoint:
+
+```http
+GET https://api.condorx.io/cxb/get.json
+```
+
+#### OpenRTB Format
+Uses POST request to OpenRTB endpoint:
+
+```http
+POST https://api.condorx.io/cxb/openrtb.json
+```
+
+To enable OpenRTB format, set `useOpenRTB: true` in the bid parameters.
+
+### Example Ad Units
 
 ```javascript
 var adUnits = [{
     code: 'condorx-container-id',
     mediaTypes: {
         banner: {
-            sizes: [[300, 250]],  
+            sizes: [[300, 250]],
         }
     },
     bids: [{
@@ -51,7 +73,60 @@ var adUnits = [{
         params: {
             widget: 'widget id by CondorX',
             website: 'website id by CondorX',
-            url:'current url'
+            url:'current url',
+            bidfloor: 0.50
         }
     }]
-}];
+},
+    {
+        code: 'condorx-container-id',
+        mediaTypes: {
+            native: {
+                image: {
+                    required: true,
+                    sizes: [236, 202]
+                },
+                title: {
+                    required: true,
+                    len: 100
+                },
+                sponsoredBy: {
+                    required: true
+                },
+                clickUrl: {
+                    required: true
+                },
+                body: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: "condorx",
+            params: {
+                widget: 'widget id by CondorX',
+                website: 'website id by CondorX',
+                url:'current url',
+                bidfloor: 0.75
+            }
+        }]
+    },
+    {
+        code: 'condorx-container-id',
+        mediaTypes: {
+            banner: {
+                sizes: [[728, 90]],
+            }
+        },
+        bids: [{
+            bidder: "condorx",
+            params: {
+                widget: 'widget id by CondorX',
+                website: 'website id by CondorX',
+                url:'current url',
+                bidfloor: 1.00,
+                useOpenRTB: true
+            }
+        }]
+    }];
+```

From 3e23d1e56d126fbe679f13c967a37eac981314ae Mon Sep 17 00:00:00 2001
From: Milos Andrejic <53998566+milosandrejic@users.noreply.github.com>
Date: Fri, 27 Jun 2025 18:59:15 +0200
Subject: [PATCH 211/665] DynamicAdBoost RTD module docs update (#6111)

* Luponmedia: params update

* Luponmedia: params update

* DynamicAdBoost rtd module

* Dynamic Ad Boost name and description

* dynamicAdBoostRtdProvider folder location change, included info about external script

* dynamicAdBoostRtd provider - removed link to itself

* dynamic ad boost module docs update

* dynamicAdBoost docs update

* dynamicAdBoost lint fix

* DynamicAdBoost RTD -  docs update
---
 dev-docs/modules/dynamicAdBoostRtdProvider.md | 32 ++++++++++++++-----
 1 file changed, 24 insertions(+), 8 deletions(-)

diff --git a/dev-docs/modules/dynamicAdBoostRtdProvider.md b/dev-docs/modules/dynamicAdBoostRtdProvider.md
index 8474fc6bef..38f4ce1a46 100644
--- a/dev-docs/modules/dynamicAdBoostRtdProvider.md
+++ b/dev-docs/modules/dynamicAdBoostRtdProvider.md
@@ -1,18 +1,34 @@
 ---
 layout: page_v2
-title: Dynamic Ad Boost Real Time Data Provider
-display_name: Dynamic Ad Boost Real Time Data Provider
-description: Dynamic Ad Boost Real Time Data Provider
+title: Dynamic Ad Boost RTD Module
+display_name: Dynamic Ad Boost RTD Module
+description: This module is intended for publishers looking to enhance ad performance visibility and improve monetization through data analytics.
 page_type: module
 module_type: rtd
 module_code: dynamicAdBoostRtd
-enable_download: false
+enable_download: true
 vendor_specific: true
-sidebarType : 1
+sidebarType: 1
 ---
 
-# Dynamic Ad Boost Real-time Data Submodule
-
-There is no need for any parameters — we will do all the work automatically for you.
+# Dynamic Ad Boost Module
 
 {% include dev-docs/loads-external-javascript.md %}
+
+The Dynamic Ad Boost module integrates with Lupon Media to collect ad unit viewability data, enabling performance analysis and revenue optimization.
+
+## Key features
+
+- Captures real-time viewability metrics per ad unit.
+- Supports site-specific configuration.
+- Enables data-driven ad optimization.
+
+## Requirements
+
+- A Lupon Media account.
+- Site integration guidelines provided by Lupon Media.
+- Coordination with Lupon Media for setup and deployment.
+
+## Parameters
+
+There is no need for any parameters — the module will handle everything automatically.

From 7919ad8fd57888d45ed5f894ea36834e57f5144d Mon Sep 17 00:00:00 2001
From: optidigital-prebid
 <124287395+optidigital-prebid@users.noreply.github.com>
Date: Mon, 30 Jun 2025 16:14:53 +0200
Subject: [PATCH 212/665] Update Adapter: Optidigital (#5976)

* update optidigital documentation

* update optidigital documentation

* add gpp support

* add gpp_sids

* enable `pbs`

* Update optidigital.md

---------

Co-authored-by: Dawid W <dawid@optidigital.fr>
Co-authored-by: Victor Gonzalez <victor@optidigital.com>
Co-authored-by: Chris Huie <phoenixtechnerd@gmail.com>
---
 dev-docs/bidders/optidigital.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/optidigital.md b/dev-docs/bidders/optidigital.md
index f9616fc97f..c1681dff59 100644
--- a/dev-docs/bidders/optidigital.md
+++ b/dev-docs/bidders/optidigital.md
@@ -3,7 +3,9 @@ layout: bidder
 title: Optidigital
 description: Prebid Optidigital Bidder Adapter
 biddercode: optidigital
+prebid_member: true
 pbjs: true
+pbs: true
 floors_supported: true
 tcfeu_supported: true
 tcf2_supported: true

From 62db8762d36038ba907a803db4a7a31e10249d5d Mon Sep 17 00:00:00 2001
From: Nitin Nimbalkar <96475150+pm-nitin-nimbalkar@users.noreply.github.com>
Date: Wed, 2 Jul 2025 20:29:46 +0530
Subject: [PATCH 213/665] PubMatic RTD Module doc updated with KVP details
 (#6115)

* Docs: Updated PubMatic RTD module description and added targeting key documentation

* Lint issue resolved

* Lint issue resolved(end with a single newline character )
---
 dev-docs/modules/pubmaticRtdProvider.md | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/pubmaticRtdProvider.md b/dev-docs/modules/pubmaticRtdProvider.md
index f02ef2e190..f1c159f4a2 100644
--- a/dev-docs/modules/pubmaticRtdProvider.md
+++ b/dev-docs/modules/pubmaticRtdProvider.md
@@ -3,7 +3,7 @@ layout: page_v2
 page_type: module
 title: PubMatic RTD Provider
 display_name: PubMatic RTD Module
-description: RTD module for Prebid provided by PubMatic to set dynamic floors
+description: RTD module for Prebid provided by PubMatic for dynamic yield optimization
 module_type: rtd
 module_code: pubmaticRtdProvider
 enable_download: true
@@ -19,11 +19,11 @@ sidebarType: 1
 
 ## Overview
 
-The PubMatic RTD module fetches pricing floor data and updates the Price Floors Module based on user's context in real-time as per Price Floors Modules Floor Data Provider Interface guidelines [Dynamic Floor Data Provider](https://docs.prebid.org/dev-docs/modules/floors.html#floor-data-provider-interface).
+The PubMatic RTD module provides dynamic yield optimization by fetching real-time pricing floor data and generating targeting data for ad server integration and reporting. The module integrates with Prebid's Price Floors system as per [Dynamic Floor Data Provider](https://docs.prebid.org/dev-docs/modules/floors.html#floor-data-provider-interface) guidelines.
 
 ## Integration
 
-Step 1: Contact PubMatic to get a publisher ID and create your first profile.
+Step 1: Contact PubMatic to get a publisher ID and create your first profile. Additional settings like floor multipliers, and key-values enablement can be managed through the PubMatic UI.
 
 Step 2: Integrate the PubMatic Analytics Adapter (see Prebid Analytics modules) as well as the Price Floors module.
 
@@ -79,3 +79,14 @@ pbjs.setConfig({
 | params             | Object  |                                                                |                            |
 | params.publisherId | String  | Publisher ID                                                   |                            |
 | params.profileId   | String  | Profile ID                                                     |                            |
+
+## Targeting Keys
+
+The module sets the following targeting keys for ad server integration and reporting:
+
+{: .table .table-bordered .table-striped }
+| Key | Description | Values |
+| :-- | :---------- | :----- |
+| pm_ym_flrs | Whether RTD floor was applied to the auction | 0 (not applied)/1 (applied) |
+| pm_ym_flrv | Floor value after applying dynamic multipliers | Decimal value (e.g., "1.25") |
+| pm_ym_bid_s | Bid outcome status | 0 (no bid), 1 (won), 2 (floored) |

From 489962e7afaf814ac90adc07102aaafe4314cbc2 Mon Sep 17 00:00:00 2001
From: Erik <omlid@users.noreply.github.com>
Date: Wed, 2 Jul 2025 10:04:03 -0500
Subject: [PATCH 214/665] NewsPassID Adapter: README updates (#6117)

---
 dev-docs/bidders/newspassid.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/newspassid.md b/dev-docs/bidders/newspassid.md
index e09b22a326..6678841260 100644
--- a/dev-docs/bidders/newspassid.md
+++ b/dev-docs/bidders/newspassid.md
@@ -8,6 +8,7 @@ gvl_id: 1317
 tcfeu_supported: true
 usp_supported: true
 coppa_supported: true
+gpp_supported: true
 schain_supported: true
 userIds: all
 safeframes_ok: true
@@ -38,7 +39,7 @@ This requires setup on the NewsPassID provider's end before beginning. Don't hes
 
 ### Integration
 
-#### Step 1: Add your NewsPassID accountId to the Prebid.js bidder config before users syncs and initial ads are requested (Recommended)
+#### Step 1: Configure NewsPassID publisher ID in global pbjs config to enable user syncs (Recommended)
 
 ```javascript
 window.pbjs = window.pbjs || { que: [] };
@@ -67,7 +68,7 @@ const adUnits = [
         bidder: 'newspassid',
         params: {
             publisherId: 'test-publisher', /* an ID to identify the publisher account  - required if you skip step 1 */
-            placementId: 'test-group1' /* An ID used to identify the ad placement configuration within a publisher account - required */                          
+            placementId: 'test-group1' /* An ID used to identify the ad placement configuration - required */                          
         }
       }
     ]

From cbecb88f0a28f30e2b52ca7793aee3b601ecc935 Mon Sep 17 00:00:00 2001
From: Olena Stepaniuk <92721590+OlenaPostindustria@users.noreply.github.com>
Date: Wed, 2 Jul 2025 18:09:34 +0300
Subject: [PATCH 215/665] docs: fix broken links (#6121)

---
 prebid-mobile/updates-3.0/sdk-key-features.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prebid-mobile/updates-3.0/sdk-key-features.md b/prebid-mobile/updates-3.0/sdk-key-features.md
index 032f33f2c6..d432491f94 100644
--- a/prebid-mobile/updates-3.0/sdk-key-features.md
+++ b/prebid-mobile/updates-3.0/sdk-key-features.md
@@ -96,6 +96,6 @@ Prebid Mobile introduces enhanced support and configuration of video ads, includ
 
 ## API Cleanup
 
-Documentation: [iOS](/prebid-mobile/updates-3.0/ios/updates-3.0.html), [Android](/prebid-mobile/updates-3.0/android/updates-3.0.html)
+Documentation: [iOS](/prebid-mobile/updates-3.0/ios/api-changes.html), [Android](/prebid-mobile/updates-3.0/android/api-changes.html)
 
 In the 3.0 release, the Prebid Mobile SDK gets rid of all previously deprecated methods in order to keep the API clean and minimalistic. Instead of using Ad Unit and configuration properties, the Prebid SDK encourages publishers to use methods to set [Arbitrary OpenRTB](#arbitrary-openrtb) parameters.

From 220164145de701e5c20ec0a785eed968abf06965 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Krzysztof=20Sok=C3=B3=C5=82?=
 <88041828+krzysztofequativ@users.noreply.github.com>
Date: Wed, 2 Jul 2025 17:32:23 +0200
Subject: [PATCH 216/665] Equativ Bid Adapter: adding integration examples
 (#6122)

* SADR-6590: initial documentation for Equativ JS bid adapter

* SADR-6590: doc refinements

* Update equativ.md

SADR-6590: adjustments to doc from review feedback.

* SADR-6590: fix linting issues

* SADR-6590: another linting issue

* update app.publisher.id

* SADR-6590: providing link to Equativ OpenRTB API documentation

* SADR-6590: providing additional required fields for documentation

* SADR-6590: adding peer answers to questions

* SADR-6590: remove FPD section for now

* Equativ: updating documentation on bid adapter parameter requirements

* SADR-6882: expanding documentation with additional examples

* update features

* added info about first party data

* add examples

---------

Co-authored-by: Jeff Mahoney <jeff.t.mahoney@gmail.com>
---
 dev-docs/bidders/equativ.md | 215 ++++++++++++++++++++++++++++++++++++
 1 file changed, 215 insertions(+)

diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index c126fe867a..c6f5b27625 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -212,6 +212,39 @@ pbjs.que.push(function () {
 });
 ```
 
+#### Outstream Video
+
+Following the setup described [here](https://docs.prebid.org/dev-docs/show-outstream-video-ads.html), this adapter supports scenarios where the publisher does not provide a custom renderer. In such cases, the configuration shown below will work, and the outstream ad will be rendered using Equativ's default player.
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250]
+        ]
+      },
+      video: {
+        context: 'outstream',
+        mimes: ['video/mp4'],
+        placement: 3,
+        playerSize: [300, 250]
+      }
+    },
+    bids: [
+      {
+        bidder: 'equativ',
+        params: {
+          networkId: 42
+        }
+      }
+    ]
+  }
+];
+```
+
 #### Native
 
 As mentioned in the **Bid Params > Usage** section, when including `'equativ'` as one of the available bidders in an adunit setup, there are two approaches to how publishers can specify parameters. The below example uses the approach using the `params` object.
@@ -348,6 +381,188 @@ pbjs.que.push(function () {
 {: .alert.alert-warning :}
 **Note**: If a demand partner of Equativ is not capable of reading an audio object, the audio object will be converted into a video object with audio mime types. There is, as of this writing, no built-in/default support for serving audio assets in Prebid, so publishers that wish to do so will need to ensure their ad server setups can process whatever hand-offs are necessary.
 
+#### Multi-formats and multi-sizes examples
+
+##### Banner, Outstream Video, and Native with different floors
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250],
+          [300, 600]
+        ]
+      },
+      video: {
+        context: 'outstream',
+        mimes: ['video/mp4'],
+        placement: 3,
+        playerSize: [300, 250]
+      },
+      native: {
+        title: {
+          len: 80,
+          required: true
+        },
+        image: {
+          required: true,
+          sizes: [300, 150]
+        }
+      }
+    },
+    floors: {
+      currency: 'USD',
+      schema: {
+        fields: ['mediaType']
+      },
+      values: {
+        'banner': 1.04,
+        'video': 1.87,
+        'native': 1.35
+      }
+    },
+    bids: [
+      {
+        bidder: 'equativ',
+        params: {
+          networkId: 42
+        }
+      }
+    ]
+  }
+];
+```
+
+##### Banner, Outstream Video, and Native with one floor
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250],
+          [300, 600]
+        ]
+      },
+      video: {
+        context: 'outstream',
+        mimes: ['video/mp4'],
+        placement: 3,
+        playerSize: [300, 250]
+      },
+      native: {
+        title: {
+          len: 80,
+          required: true
+        },
+        image: {
+          required: true,
+          sizes: [300, 150]
+        }
+      }
+    },
+    floors: {
+      currency: 'USD',
+      schema: {
+        fields: ['mediaType']
+      },
+      values: {
+        '*': 1.48
+      }
+    },
+    bids: [
+      {
+        bidder: 'equativ',
+        params: {
+          networkId: 42
+        }
+      }
+    ]
+  }
+];
+```
+
+##### Multiple Banner sizes with different floors
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 160],
+          [300, 250],
+          [300, 600]
+        ]
+      }
+    },
+    floors: {
+      currency: 'USD',
+      schema: {
+        delimiter: '|',
+        fields: ['mediaType', 'size']
+      },
+      values: {
+        'banner|300x250': 1.37,
+        'banner|300x600': 1.52,
+        'banner|*': 1.23
+      }
+    },
+    bids: [
+      {
+        bidder: 'equativ',
+        params: {
+          networkId: 42
+        }
+      }
+    ]
+  }
+];
+```
+
+##### Multiple Banner sizes with one floor
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 160],
+          [300, 250],
+          [300, 600]
+        ]
+      }
+    },
+    floors: {
+      currency: 'USD',
+      schema: {
+        delimiter: '|',
+        fields: ['mediaType', 'size']
+      },
+      values: {
+        'banner|*': 1.19
+      }
+    },
+    bids: [
+      {
+        bidder: 'equativ',
+        params: {
+          networkId: 42
+        }
+      }
+    ]
+  }
+];
+```
+
 ### First Party Data
 
 Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).

From 29d7193bfe27b8c4b458088f5488664782bc6697 Mon Sep 17 00:00:00 2001
From: hasanideepak <80700939+hasanideepak@users.noreply.github.com>
Date: Thu, 3 Jul 2025 00:52:17 +0530
Subject: [PATCH 217/665] Relevatehealth - removed user_id compulsion and used
 common library (#6119)

---
 dev-docs/bidders/relevatehealth.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/relevatehealth.md b/dev-docs/bidders/relevatehealth.md
index 5b9e80ab16..6fd7eecc08 100644
--- a/dev-docs/bidders/relevatehealth.md
+++ b/dev-docs/bidders/relevatehealth.md
@@ -20,10 +20,10 @@ sidebarType: 1
 
 ### Bid Params
 
+{: .table .table-bordered .table-striped }
 | Name          | Scope     | Description           | Example        | Type     |
 |---------------|-----------|-----------------------|----------------|----------|
-| `placement_id` | mandatory | Placement Id          | `110011`       | `number` |
-| `user_id`     | mandatory | Unique id for HCP     | `'1111111'`    | `string` |
+| `placement_id`| mandatory | Placement Id          | `110011`       | `number` |
 | `height`      | optional  | Height of the creative| `600`          | `number` |
 | `width`       | optional  | Width of the creative | `160`          | `number` |
 | `domain`      | optional  | Domain                | `'domain.com'` | `string` |

From 3a143e7fd442e721187fa3661ab985a8a88da890 Mon Sep 17 00:00:00 2001
From: FlatAds <83808812+flatads@users.noreply.github.com>
Date: Thu, 3 Jul 2025 03:29:26 +0800
Subject: [PATCH 218/665] New Adapter: Flatads (#5920)

* New Adapter: Flatads

* New Adapter: Flatads

* New Adapter: Flatads

* Update Flatads bidders docs

* Adapter Flatads: update email address

* Update flatads.md

removed gpp_supported field (not used) and removed backticks from around `string` in the table

---------

Co-authored-by: wuzhijian <wuch1k1n@qq.com>
Co-authored-by: bretg <bgorsline@gmail.com>
---
 dev-docs/bidders/flatads.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/flatads.md

diff --git a/dev-docs/bidders/flatads.md b/dev-docs/bidders/flatads.md
new file mode 100644
index 0000000000..e14cc4e10d
--- /dev/null
+++ b/dev-docs/bidders/flatads.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: flatads
+description: Prebid Flatads Bidder Adapter
+biddercode: flatads
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+userIds: all
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: false
+deals_supported: true
+floors_supported: true
+pbjs: false
+pbs: true
+pbs_app_supported: true
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+sidebarType: 1
+---
+
+### Registration
+
+Flatads header bidding adapter connects with Flatads demand sources to fetch bids for banner publisher ID. Please reach
+out to your account manager or <adxbusiness@flat-ads.com> for more information.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|---------------|----------|--------------|-----------|----------|
+| `publisherId` | required | The publisher ID from Flatads | "1111" | string |
+| `token` | required | Token of the publisher | "66668888" | string |

From 12a34ff5b7ffaf6ffce21a779efb2a9b05c41501 Mon Sep 17 00:00:00 2001
From: CMDezz <53512796+CMDezz@users.noreply.github.com>
Date: Thu, 3 Jul 2025 02:34:17 +0700
Subject: [PATCH 219/665] EClickAds: rename bidder from EClickAds to eClick
 (#5556)

* EClickAds: rename bidder from EClickAds to eClick

* Revert "EClickAds: rename bidder from EClickAds to eClick"

This reverts commit fa70a6ace874dae64d418f594a6f074c4e8d141c.

* EClickAds: Rename bidder  to EClick

---------

Co-authored-by: LeViet <VietLV14@fo.com>
---
 dev-docs/bidders/eclick.md    | 41 +++++++++++++++++++++++++++++++++++
 dev-docs/bidders/eclickads.md |  3 ++-
 2 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 dev-docs/bidders/eclick.md

diff --git a/dev-docs/bidders/eclick.md b/dev-docs/bidders/eclick.md
new file mode 100644
index 0000000000..dc1db776ad
--- /dev/null
+++ b/dev-docs/bidders/eclick.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: eClick
+description: eClick Bidder Adaptor
+biddercode: eclick
+media_types: native
+sidebarType: 1
+pbjs: true
+pbs: false
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+prebid_member: false
+ortb_blocking_supported: false
+fpd_supported: true
+multiformat_supported: will-bid-on-one
+pbjs_version_notes: v10.x and later
+
+---
+
+### Note
+
+The eClick adapter requires setup and approval from the eClick Team. Please contact us via <sales@eclick.vn> for detail.
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+| Name  | Scope    | Description    | Example   | Type     |
+|-------|----------|----------------|-----------|----------|
+| `zid` | required | The Zone Id    | `'7096'`  | `string` |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+
+- ortb2.site.ext.data.*
diff --git a/dev-docs/bidders/eclickads.md b/dev-docs/bidders/eclickads.md
index 54e7afe357..65b878160f 100644
--- a/dev-docs/bidders/eclickads.md
+++ b/dev-docs/bidders/eclickads.md
@@ -19,10 +19,11 @@ prebid_member: false
 ortb_blocking_supported: false
 fpd_supported: true
 multiformat_supported: will-bid-on-one
+pbjs_version_notes: available in 9.9.0 and later, not in 10.x
 ---
 
 ### Note
-
+The EClickAds bidder adapter is going to be renamed to eClick in PBJS 10.x, using a bidder code of `eclick`. Please update your implementation accordingly. This bidder adapter is still available for PBJS versions 9.9.0 and later.
 The EClickAds adapter requires setup and approval from the EClick Team. Please contact us via <sales@eclick.vn> for detail.
 
 ### Bid params

From 21eaced5144ddea8f674954a3a5ae3816c3031cc Mon Sep 17 00:00:00 2001
From: pratik-chavan-advertising-dot-com <pchavan@advertising.com>
Date: Wed, 2 Jul 2025 15:39:08 -0400
Subject: [PATCH 220/665] Rename imds adapter to advertising to reflect
 ownership change to advertising.com (#5943)

* Update imds adapter to advertising to reflect the ownership change

* Add newline char to synacormedia docs

* Add aliasCode advertising to imds and synacormedia adapter and update version notes on both
---
 dev-docs/bidders/advertising.md  | 111 +++++++++++++++++++++++++++++++
 dev-docs/bidders/imds.md         |  14 +++-
 dev-docs/bidders/synacormedia.md |   7 +-
 3 files changed, 126 insertions(+), 6 deletions(-)
 create mode 100644 dev-docs/bidders/advertising.md

diff --git a/dev-docs/bidders/advertising.md b/dev-docs/bidders/advertising.md
new file mode 100644
index 0000000000..4cd85c2b47
--- /dev/null
+++ b/dev-docs/bidders/advertising.md
@@ -0,0 +1,111 @@
+---
+layout: bidder
+title: Advertising.com
+description: Prebid Advertising.com Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: advertising
+tcfeu_supported: false
+usp_supported: true
+userIds: all
+media_types: banner, video
+coppa_supported: false
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+safeframes_ok: true
+pbs_app_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-any
+prebid_member: false
+gvl_id: none
+sidebarType: 1
+---
+
+### Note
+
+The Advertising.com bidder adapter requires setup and approval from Advertising.com. Please reach out to your account manager for more information and to start using it.
+
+### Configuration
+
+Advertising.com requires that `iframe` is used for user syncing.
+
+Example configuration:
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      iframe: {
+        bidders: '*', // represents all bidders
+        filter: 'include'
+      }
+    }
+  }
+});
+```
+
+### DFP Video Creative
+To use video, setup a `VAST redirect` creative within Google Ad Manager with the following VAST tag URL:
+
+If using the new `advertising` adapter with x9.x or later:
+
+```text
+https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%%
+```
+
+If using the legacy `imds` adapter with x8.x or later:
+
+```text
+https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%%
+```
+
+If using the legacy `synacormedia` adapter with v7.x or earlier:
+
+```text
+https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_synacormedia%%&AUCTION_PRICE=%%PATTERN:hb_pb_synacormedia%%
+```
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| ---- | ----- | ----------- | ------- | ---- |
+| `seatId` | required | The seat ID from Advertising.com. This will be the same for all ad units. | `'prebid'` | `string` |
+| `tagId` | required | The placement ID or tag ID from Advertising.com. | `'demo1'` | `string` |
+| `placementId` | optional | Legacy parameter replaced by `tagId` | `'demo1'` | `string` |
+| `bidfloor` | optional | Legacy parameter for floor price for the request. Replaced by [Price Floors Module](/dev-docs/modules/floors.html) | `0.1` | `float` |
+
+### Example Ad Unit
+
+```javascript
+var adUnits = [{
+    "code": "test-div",
+    "mediaTypes": {
+        "video": {
+            "pos": 1,
+            "playerSize": [300, 250],
+            "context": "instream",
+            "mimes": ["video/mp4"],
+            "protocols": [2, 3, 5, 6, 7, 8],
+            "playbackmethod": [2],
+            "skip": 0,
+            "minduration": 15,
+            "maxduration": 30,
+            "startdelay": 0,
+            "linearity": 1
+        }
+    },
+    "bids": [{
+        "bidder": "advertising",
+        "params": {
+            "seatId": "prebid",
+            "tagId": "demo1",
+            "bidfloor": 0.20
+        }
+    }]
+}]
+```
diff --git a/dev-docs/bidders/imds.md b/dev-docs/bidders/imds.md
index f526d56702..d7af519f32 100644
--- a/dev-docs/bidders/imds.md
+++ b/dev-docs/bidders/imds.md
@@ -1,10 +1,11 @@
 ---
 layout: bidder
 title: iMedia Digital Services (iMDS)
-description: Prebid iMedia Digital Services Bidder (iMDS) Adapter
+description: Prebid iMedia Digital Services Bidder (iMDS) Adapter (replaced by "Advertising.com")
 pbjs: true
 pbs: true
 biddercode: imds
+aliasCode: advertising
 tcfeu_supported: false
 usp_supported: true
 userIds: all
@@ -23,11 +24,12 @@ multiformat_supported: will-bid-on-any
 prebid_member: false
 gvl_id: none
 sidebarType: 1
+pbjs_version_notes: use advertising after 10.0
 ---
 
 ### Note
 
-The iMedia Digital Services bidder adapter requires setup and approval from iMedia Digital Services. Please reach out to your account manager for more information and to start using it.
+The iMedia Digital Services (iMDS) bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using a bidder code of `advertising`. Please update your implementation accordingly. This bidder adapter requires setup and approval from Advertising.com. Please reach out to your account manager for more information and to start using it.
 
 ### Configuration
 
@@ -51,7 +53,13 @@ pbjs.setConfig({
 ### DFP Video Creative
 To use video, setup a `VAST redirect` creative within Google Ad Manager with the following VAST tag URL:
 
-If using the new `imds` adapter with x8.x or later:
+If using the new `advertising` adapter with x9.x or later:
+
+```text
+https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%%
+```
+
+If using the legacy `imds` adapter with x8.x or later:
 
 ```text
 https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%%
diff --git a/dev-docs/bidders/synacormedia.md b/dev-docs/bidders/synacormedia.md
index 29bab594b6..bd4a7e7b1b 100644
--- a/dev-docs/bidders/synacormedia.md
+++ b/dev-docs/bidders/synacormedia.md
@@ -1,10 +1,11 @@
 ---
 layout: bidder
 title: Synacor Media
-description: Prebid Synacor Media Bidder Adapter (replaced by "imds")
+description: Prebid Synacor Media Bidder Adapter (replaced by "Advertising.com")
 pbjs: true
 pbs: true
 biddercode: synacormedia
+aliasCode: advertising
 tcfeu_supported: false
 usp_supported: true
 userIds: all
@@ -22,9 +23,9 @@ multiformat_supported: will-bid-on-any
 prebid_member: false
 gvl_id: none
 sidebarType: 1
-pbjs_version_notes: use imds after 8.0
+pbjs_version_notes: use imds after 8.0 and advertising after 10.0
 ---
 
 ### Note
 
-The Synacor Media bidder adapter has been renamed to the [iMedia Digital Services (iMDS)](/dev-docs/bidders/imds.html) adapter, using an bidder code of `imds`. Please update your implementation accordingly.
+The Synacor Media bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using an bidder code of `advertising`. Please update your implementation accordingly.

From 1526ca6ff7c9d0a3f906c2cd063a98d8ab135629 Mon Sep 17 00:00:00 2001
From: boris-polyakov-dv <boris.p@dvgroup.com>
Date: Wed, 2 Jul 2025 22:48:40 +0300
Subject: [PATCH 221/665] dvgroup bid adapter (#6008)

* dvgroup bid adapter

* dvgroup bid adapter: update

add to dvgroup adapter required ssid
---
 dev-docs/bidders/dvgroup.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 dev-docs/bidders/dvgroup.md

diff --git a/dev-docs/bidders/dvgroup.md b/dev-docs/bidders/dvgroup.md
new file mode 100644
index 0000000000..e94e67efd2
--- /dev/null
+++ b/dev-docs/bidders/dvgroup.md
@@ -0,0 +1,26 @@
+---
+layout: bidder
+title: dvgroup
+description: dvgroup bid adapter
+biddercode: dvgroup
+pbjs: true
+gvl_id: none
+tcfeu_supported: false
+usp_supported: false
+media_types: banner, video
+coppa_supported: false
+safeframes_ok: true
+floors_supported: true
+deals_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description   | Example      | Type     |
+|---------------|----------|---------------|--------------|----------|
+| `sspId`       | required | ssp id        | `'prebidssp'`| `string` |

From 052708b7aff6356413b9725bdf26ab36319ed4b1 Mon Sep 17 00:00:00 2001
From: support-gotham-ads <support@gothamads.com>
Date: Wed, 2 Jul 2025 22:57:15 +0300
Subject: [PATCH 222/665] rename gothamads to intenze (#6010)

---
 dev-docs/bidders/{gothamads.md => intenze.md} | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
 rename dev-docs/bidders/{gothamads.md => intenze.md} (80%)

diff --git a/dev-docs/bidders/gothamads.md b/dev-docs/bidders/intenze.md
similarity index 80%
rename from dev-docs/bidders/gothamads.md
rename to dev-docs/bidders/intenze.md
index 1bce4b496f..455a409800 100644
--- a/dev-docs/bidders/gothamads.md
+++ b/dev-docs/bidders/intenze.md
@@ -1,8 +1,8 @@
 ---
 layout: bidder
-title: gothamads
-description: Prebid gothamads Bidder Adaptor
-biddercode: gothamads
+title: intenze
+description: Prebid Intenze Bidder Adaptor
+biddercode: intenze
 tcfeu_supported: false
 usp_supported: true
 coppa_supported: true
@@ -24,8 +24,8 @@ userIds: all
 ---
 
 ### Note
-Gothamads will bid only on first impresion in bid request.
-The Example Bidding adapter requires setup before beginning. Please contact us at <support@gothamads.com>
+Intenze will bid only on first impresion in bid request.
+The Example Bidding adapter requires setup before beginning. Please contact us at <connect@intenze.co>
 
 ### Bid Params
 

From dbaeaee2137c40a8719806fced99fea7f7532ef0 Mon Sep 17 00:00:00 2001
From: jxdeveloper1 <71084096+jxdeveloper1@users.noreply.github.com>
Date: Thu, 3 Jul 2025 04:00:37 +0800
Subject: [PATCH 223/665] adding documentation for jixie Id module which is
 applying for submission into the PrebidJs repo concurrently (#6030)

* as we are adding the prebid-server adaptor and introduced a few extra params , they are added here too
(note: those 3 new params would also reach the headerbid adserver in the case of prebid "clientside HB" too. So all good)

* added quotes around string params

* add jixieId module md file

---------

Co-authored-by: bretg <bgorsline@gmail.com>
---
 dev-docs/modules/userid-submodules/jixie.md | 49 +++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/jixie.md

diff --git a/dev-docs/modules/userid-submodules/jixie.md b/dev-docs/modules/userid-submodules/jixie.md
new file mode 100644
index 0000000000..8fa3f89cfd
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/jixie.md
@@ -0,0 +1,49 @@
+---
+layout: userid
+title: Jixie ID
+description: Jixie ID User ID sub-module
+useridmodule: jixieId
+bidRequestUserId: jixieId
+eidsource: jixie.io
+example: '"1111"'
+---
+
+
+The Jixie ID module is specially useful for publishers that will connect with Jixie bidder through PrebidServer adapter feature of PrebidJS and/or for publishers that are unable to integrate with the Jixie ID/event script to still acquire the important Jixie client ID for users. 
+
+For assistance setting up your module, please contact us at <partners.jixie.io>
+
+Add the Jixie ID to your Prebid.js Package with:
+
+```bash
+gulp build --modules=userId,jixieIdSystem
+```
+
+## Jixie ID Registration
+
+Please reach out to [partners.jixie.io](mailto:partners.jixie.io) to request your `accountid`
+
+## Jixie ID Configuration
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | The name of Module | `"jixieId"` |
+| params | optional | Object | Container of all module params. |  |
+| params.accountid | optional | String | This is your `accountid` as provided by Jixie. | `Mo165qXxxx` |
+
+## DMD ID Example
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [{
+            name: 'jixieId',
+            params: {
+                accountid: 'Mo165qXxxx' // provided to you by Jixie
+            }
+        }]
+    }
+});
+```

From cc75a124258616c36bef1d3c12e9f3817fa5e255 Mon Sep 17 00:00:00 2001
From: rororo <16588724+rororo@users.noreply.github.com>
Date: Thu, 3 Jul 2025 05:05:36 +0900
Subject: [PATCH 224/665] add suim docs (#6040)

---
 dev-docs/bidders/suim.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 dev-docs/bidders/suim.md

diff --git a/dev-docs/bidders/suim.md b/dev-docs/bidders/suim.md
new file mode 100644
index 0000000000..9eef80f66f
--- /dev/null
+++ b/dev-docs/bidders/suim.md
@@ -0,0 +1,20 @@
+---
+layout: bidder
+title: Suim
+description: Prebid Suim Bidder Adapter
+pbjs: true
+biddercode: suim
+media_types: banner
+sidebarType: 1
+---
+
+Note:
+The Suim Bidding adapter requires setup before beginning.
+For more information, visit [Suim website](https://suim.co.jp/).
+
+### Bid parameters
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                  | Example                         | Type     |
+|---------------|----------|------------------------------|---------------------------------|----------|
+| `ad_space_id` | required | Ad space ID provided by Suim | `'101hw085aphx9qdttwgdnm5q5b8'` | `string` |

From df680f95dc3ad31566c0df13d1857b18707641f7 Mon Sep 17 00:00:00 2001
From: pm-azhar-mulla <75726247+pm-azhar-mulla@users.noreply.github.com>
Date: Thu, 3 Jul 2025 01:43:02 +0530
Subject: [PATCH 225/665] Prebid10: updated schain docs for prebid10 (#6093)

* updated schain docs for prebid10

* resolved linting error

---------

Co-authored-by: pm-azhar-mulla <azhar@L2047.local>
---
 dev-docs/modules/schain.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/schain.md b/dev-docs/modules/schain.md
index 128b4410ff..777cd2d3e1 100644
--- a/dev-docs/modules/schain.md
+++ b/dev-docs/modules/schain.md
@@ -27,6 +27,9 @@ Two modes are supported:
 
 ## How to Use the Module
 
+{: .alert.alert-warning :}
+**Prebid 10 :** You don't need to add the schain module explicitly starting from Prebid 10.
+
 First, build the schain module into your Prebid.js package:
 
 ```bash
@@ -86,20 +89,29 @@ pbjs.setBidderConfig({
 
 You can find more information about the `pbjs.setBidderConfig` function in the [Publisher API Reference]({{site.baseurl}}/dev-docs/publisher-api-reference/setBidderConfig.html).
 
+{: .alert.alert-warning :}
+**Prebid 10 :** You can either use above method or `ortb2.source.schain` property to pass schain. You can read more about passing [First Party Data](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#first-party-data). As far as precedence is concerned, `ortb2.source.schain` property takes precedence over the schain config setup via `pbjs.setConfig` using above mentioned method.
+
 ### Global and Bidder-Specific Together
 
 Yes, you can set both global and bidder-specific SChain configs. When together, the schain config setup via `pbjs.setConfig` acts as a global config that applies to all your bidders, while `pbjs.setBidderConfig` overrides the global config for the noted bidder(s).
 
 ## SChain Config Syntax
 
+{: .alert.alert-warning :}
+**Prebid 10 :** Validation will be automatically performed by the **validationFpdModule** if you have included it in your Prebid.js build. If the `skipValidation` parameter is set to true in the validationFpdModule configuration, validation will be skipped. Please visit the [validationFpdModule documentation](https://docs.prebid.org/dev-docs/modules/validationFpdModule.html) for more information.
+
 {: .table .table-bordered .table-striped }
 | SChain Param | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
-| validation | optional | string | `'strict'`: In this mode, schain object will not be passed to adapters if it is invalid. Errors are thrown for invalid schain object. `'relaxed'`: Errors are thrown for an invalid schain object but the invalid schain object is still passed to adapters. `'off'`: No validations are performed and schain object is passed as-is to adapters. The default value is `'strict'`. | 'strict' |
+| validation (deprecated from Prebid 10) | optional | string | `'strict'`: In this mode, schain object will not be passed to adapters if it is invalid. Errors are thrown for invalid schain object. `'relaxed'`: Errors are thrown for an invalid schain object but the invalid schain object is still passed to adapters. `'off'`: No validations are performed and schain object is passed as-is to adapters. The default value is `'strict'`. | 'strict' |
 | config | required | object | This is the full Supply Chain object sent to bidders conforming to the [IAB OpenRTB SupplyChain Object Specification](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md). | (See examples above) |
 
 ## Adapter Information
 
+{: .alert.alert-warning :}
+**Prebid 10 :** Adapters can read `bidderRequest.ortb2.source.ext.schain` instead of `bidRequest.schain`.
+
 Adapters can read the `bidRequest.schain` object and pass it through to their endpoint. The adapter does not need to be concerned about whether a bidder-specific schain was provided; the system will provide the relevant one.
 
 ## Adapters Supporting the schain Module

From 4b1342216b9a10f6ff2d970dfef50018b94992d4 Mon Sep 17 00:00:00 2001
From: t-sormonte <t.sormonte@sparteo.com>
Date: Wed, 2 Jul 2025 22:19:26 +0200
Subject: [PATCH 226/665] New PBS Adapters: Sparteo (#6100)

---
 dev-docs/bidders/sparteo.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/sparteo.md b/dev-docs/bidders/sparteo.md
index 8928357e7b..c5de22b6ed 100644
--- a/dev-docs/bidders/sparteo.md
+++ b/dev-docs/bidders/sparteo.md
@@ -3,9 +3,9 @@ layout: bidder
 title: Sparteo
 description: Prebid Sparteo Bidder Adaptor
 pbjs: true
-pbs: false
+pbs: true
 biddercode: sparteo
-media_types: banner, video
+media_types: banner, video, native
 tcfeu_supported: true
 gvl_id: 1028
 usp_supported: true

From c5ebe7ca6f01de37acb880cef3f776fd71841356 Mon Sep 17 00:00:00 2001
From: abermanov-zeta <95416296+abermanov-zeta@users.noreply.github.com>
Date: Wed, 2 Jul 2025 22:25:32 +0200
Subject: [PATCH 227/665] Zeta SSP Adapter: add GPP support. (#6101)

---
 dev-docs/bidders/zeta_global_ssp.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/zeta_global_ssp.md b/dev-docs/bidders/zeta_global_ssp.md
index 11f32dceda..afd21cab0a 100644
--- a/dev-docs/bidders/zeta_global_ssp.md
+++ b/dev-docs/bidders/zeta_global_ssp.md
@@ -13,6 +13,7 @@ schain_supported: true
 fpd_supported: true
 usp_supported: true
 coppa_supported: true
+gpp_supported: true
 userIds: all
 prebid_member: true
 gvl_id: 469

From d721bac3f2f4e984263d01465db8b3c69d2c514c Mon Sep 17 00:00:00 2001
From: pb360playvid <prebid@360playvid.com>
Date: Wed, 2 Jul 2025 23:30:34 +0300
Subject: [PATCH 228/665] New adapter 360playvid (#6103)

* New adapter 360playvid

* Set pbs to 0 in the 360playvid adapter

* Update 360playvid.md

---------

Co-authored-by: Bohdan Lashko <bohdan.lashko@teqblaze.com>
Co-authored-by: Chris Huie <phoenixtechnerd@gmail.com>
---
 dev-docs/bidders/360playvid.md | 36 ++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/360playvid.md

diff --git a/dev-docs/bidders/360playvid.md b/dev-docs/bidders/360playvid.md
new file mode 100644
index 0000000000..ccdd470759
--- /dev/null
+++ b/dev-docs/bidders/360playvid.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: 360PlayVid
+description: Prebid 360PlayVid Bidder Adapter
+biddercode: 360playvid
+gpp_sids: usstate_all
+gvl_id: none
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From f4c4a5ad8bfc7511007cc2c8198b23ee83038b5f Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Wed, 2 Jul 2025 16:33:57 -0400
Subject: [PATCH 229/665] Prebid 10 release notes (#6113)

* docs: add Prebid 10 release notes

* Update release-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* add more renames

* fix lint

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Update pb10-notes.md

* Apply suggestions from code review

Co-authored-by: Demetrio Girardi <demetrio.girardi@proton.me>

* Update dev-docs/pb10-notes.md

Co-authored-by: Demetrio Girardi <demetrio.girardi@proton.me>

* Update pb10-notes.md

---------

Co-authored-by: Chris Huie <phoenixtechnerd@gmail.com>
Co-authored-by: Demetrio Girardi <demetrio.girardi@proton.me>
---
 dev-docs/pb10-notes.md    | 113 ++++++++++++++++++++++++++++++++++++++
 dev-docs/release-notes.md |   1 +
 2 files changed, 114 insertions(+)
 create mode 100644 dev-docs/pb10-notes.md

diff --git a/dev-docs/pb10-notes.md b/dev-docs/pb10-notes.md
new file mode 100644
index 0000000000..c1026b2447
--- /dev/null
+++ b/dev-docs/pb10-notes.md
@@ -0,0 +1,113 @@
+---
+layout: page_v2
+title: Prebid.js 10.0 Release Notes & Publisher API Changes
+description: Description of the breaking changes included for Prebid.js 10.0
+sidebarType: 1
+---
+
+# Prebid.js 10.0 Bidder Interface and Publisher API Changes
+
+{:.no_toc}
+
+This document describes the changes included for Prebid.js version 10.0.
+
+* TOC
+{:toc}
+
+## Publisher Summary
+
+1. A large number of obsolete modules have been removed. Many modules have changed name. See below for the list.
+2. The legacy method of native targeting keys, `sendTargetingKeys`, has been removed.
+3. `pbadslot` has been removed from the preAuction module. Use `ortb2Imp.ext.gpid` instead.
+4. The API methods `getBidResponses` and `getNoBidsForAdUnitCode` now return arrays of bids.
+5. TypeScript support has landed and Node.js 20+ is required to build.
+6. Using Prebid as an NPM dependency no longer requires using Babel or Prebid's Babel settings.
+7. `targetingControls.allBidsCustomTargeting` now defaults to `false`, this prevents custom targeting values from being set for non-winning bids.
+8. Storage use disclosures can now be enforced and catalogued 
+
+## Removed Modules
+
+The following modules have been removed from Prebid.js as part of the 10.0 release. The `dfp` modules are still there but now import the `gam` modules. Publishers building with one of them will need to point to its replacement or remove the module from their build.
+
+{: .table .table-bordered .table-striped }
+
+| Module | Replacement |
+|:-----------------------------|:-------------------------|
+| dfpAdServerVideo | gamAdServerVideo |
+| dfpAdPod | gamAdPod |
+| telariaBidAdapter | |
+| eclickads | eclick |
+| imdsBidAdapter | advertisingBidAdapter |
+| cleanmedianetBidAdapter | gamoshiBidAdapter |
+| kueezBidAdapter | kueezRTBBidAdapter |
+| saambaaBidAdapter | advangelistBidAdapter |
+| adoceanBidAdapter | |
+| radsBidAdapter | |
+| freewheelsspBidAdapter | fwsspBidAdapter |
+| akamaiDapRtdProvider | symetriRtdProvider |
+| bidwatchAnalyticsAdapter | oxxionAnalyticsAdapter |
+| conversantAnalyticsAdapter | |
+| konduitAnalyticsAdapter | |
+| konduitWrapper | |
+| globalsunBidAdapter | global_sunBidAdapter |
+| verizonMediaIdSystem | yahooConnectId |
+| loglyliftBidAdapter | |
+| apnPspParamsConverter | |
+| yieldmoSyntheticInventoryModule | |
+| adsinteractiveBidAdapter | ads_interactiveBidAdapter |
+| admanBidAdapter | |
+| bridgeuppBidAdapter | sonaradsBidAdapter |
+| BTBidAdapter | blockthroughBidAdaper |
+| brightMountainMediaBidAdapter | bmtmBidAdapter |
+| vubleAnalyticsAdapter | |
+| serverbidServerBidAdapter | |
+| gothamAdsBidAdapter | intenzeBidAdapter |
+| growadvertisingBidAdapter | growAdsBidAdapter |
+| incrxBidAdapter | incrementxBidAdapter |
+| viantOrtbBidAdapter | viantBidAdapter |
+| zetaBidAdapter | zeta_globalBidAdapter |
+| fanAdapter | fanBidAdapter |
+| cadentaperturemxBidAdapter | cadent_aperture_mxBidAdapter |
+| epomDspBidAdapter | epom_dspBidAdapter |
+| pubwiseBidAdapter | pwbidBidAdapter |
+
+## Consent and Data Handling
+
+* **Default behavior for publisher purpose permissions in the TCF control module now enables purposes P4, P7 and special feature 1.**
+* Global vendor list IDs have been filled in for a number of bidder and analytics modules.
+* **A new activity control, and purpose 1 enforcement, prevent bidder endpoint access to third party storage via set-cookie headers.**
+* **The storage disclosures module enables publishers to identify all keys used in the first party and deny access to undisclosed keys. A build artifact is produced to help provide clear and concise information on device storage use for e-privacy directive adherence.**
+
+## User Id Module
+
+* **The user ID module introduces an `enforceStorageType` flag, which why by default warn when a userId submodule accesses the incorrect storage type. Future versions will prevent access.**
+* **`userId` accepts two new config flags, autoRefresh (default false) and retainConfig (default true).** With `autoRefresh: true`, `userId` automatically refreshes IDs for which the configuration changed (either a previously configured module now has different config, or a new module was configured). With `retainConfig: false`, `userId` "forgets" userIds that were previously configured, but are missing from `userSync.userIds[]` in a later setConfig.
+* For bidders: `bid.userId` is no longer populated; bid modules should rely on `userIdAsEids` or `user.ext.eids`. Several bid adapters made this change in the 10.0 release; others in 9.x in anticipation.
+* Eids in `user.eids` are appended to the array in `user.ext.eids` and de-duplicated.
+
+## TypeScript and Build Updates
+
+* **TypeScript files are now accepted in the code base. Tooling and linting were updated accordingly.**
+* The build target browser use statistics are now updated as part of the build process.
+* Tests now target Chrome 109 as the minimum version. `not dead` was added to the babel target.
+* **The `pbYield` helper was added and greedy rendering is disabled by default.**
+
+## API Changes
+
+* The `ADPOD` mediatype has received a deprecation warning.
+* Bid response helper methods (`getBidResponses*` and `getNoBids*`) now return an array which also exposes the array under `.bids` for backward compatibility.
+* `getHighestUnusedBidResponseForAdUnitCode` returns null instead of an empty object when no suitable bid exists.
+* **Schain data now lives under `ortb2.source.ext.schain` and is normalized when provided in first party data. The module is now superfluous for publishers transitioned to seeing this object directly and will be removed in the future.**
+* **Native ad units no longer support `sendTargetingKeys`, and native key-value pairs can no longer be sent to the ad server. Please migrate to a newer setup.**
+* The `createBid` API has been removed.
+* The `statusMessage` and `getStatusCode()` properties were removed from bid objects.
+* **The DFP modules have been renamed to GAM modules (`gamAdServerVideo`, `gamAdpod`, etc.). Please migrate to the new names.**
+* **Default configuration of various PBS Host companies has been removed. The PBS adapter now requires an explicit endpoint in its configuration.**
+* Support for the legacy `pbadslot` field has been removed from all utilities and adapters.
+* All public API methods have a log message in debug mode.
+* **`mediatypes.banner` params that match to imp[].banner are type checked**
+
+## Further Reading
+
+* [Publisher API Reference](/dev-docs/publisher-api-reference.html)
+* [First Party Data](/features/firstPartyData.html)
diff --git a/dev-docs/release-notes.md b/dev-docs/release-notes.md
index 90b21a65c9..19e49c530f 100644
--- a/dev-docs/release-notes.md
+++ b/dev-docs/release-notes.md
@@ -15,6 +15,7 @@ This page has links to release notes for each of the projects associated with Pr
 ## Prebid.js
 
 + [Release notes on GitHub](https://github.com/prebid/Prebid.js/releases)
++ [Prebid.js 10 Release Notes](/dev-docs/pb10-notes.html)
 + [Prebid.js 9 Release Notes](/dev-docs/pb9-notes.html)
 + [Prebid.js 8 Release Notes](/dev-docs/pb8-notes.html)
 + [Prebid.js 7 Release Notes](/dev-docs/pb7-notes.html)

From eebce06bf4cc54848c49b389f4669583ffa30e1d Mon Sep 17 00:00:00 2001
From: Dimitra Mazaraki <7673832+mazaraki@users.noreply.github.com>
Date: Mon, 7 Jul 2025 16:25:04 +0200
Subject: [PATCH 230/665] fix typo on bidRequestUserId on utiq.md (#6127)

Co-authored-by: Dimitra-Niki Mazaraki <dimitra-niki.mazaraki@utiq.com>
---
 dev-docs/modules/userid-submodules/utiq.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/utiq.md b/dev-docs/modules/userid-submodules/utiq.md
index 7a95f72af5..87ca81589f 100644
--- a/dev-docs/modules/userid-submodules/utiq.md
+++ b/dev-docs/modules/userid-submodules/utiq.md
@@ -3,7 +3,7 @@ layout: userid
 title: Utiq ID
 description: Utiq User ID sub-module
 useridmodule: utiqIdSystem
-bidRequestUserId: utiId
+bidRequestUserId: utiqId
 eidsource: utiq.com
 example: '"1111"'
 ---

From 90bd0471f75be1f47e1eb06838aa38ce262b8f92 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 7 Jul 2025 10:25:36 -0400
Subject: [PATCH 231/665] Document new userId and PBS parameters (#6124)

---
 dev-docs/modules/prebidServer.md | 2 ++
 dev-docs/modules/userId.md       | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index 462fa31719..fb39f600db 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -97,6 +97,8 @@ There are many configuration options for s2sConfig:
 | `adapterOptions` | Optional | Object | Arguments will be added to resulting OpenRTB payload to Prebid Server in every impression object at request.imp[].ext.BIDDER. See the example above. |
 | `extPrebid` | Optional | Object | Arguments will be added to resulting OpenRTB payload to Prebid Server in request.ext.prebid. See the examples below. |
 | `customHeaders` | Optional | Object | These custom headers will be included in the XHR call to the bidder's endpoint. This will allow you to send data specific to your use case. The format consists of an object where the keys represent the header names and the values correspond to the respective header values. Here is an example how a customHeader object might look like - `{"Header1": "Value1", "Header2": "Value2"}`|
+| `endpointCompression` | Optional | Boolean | Enable gzip compression of outgoing requests when supported. | `true` |
+| `filterBidderlessCalls` | Optional | Boolean | When `true`, ad units that have no bidders defined are excluded from Prebid Server requests. Defaults to `false`. | `true` |
 
 If `endpoint` and `syncEndpoint` are objects, these are the supported properties:
 
diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md
index 33d2e1b68d..a9e932bdfc 100644
--- a/dev-docs/modules/userId.md
+++ b/dev-docs/modules/userId.md
@@ -75,6 +75,9 @@ The PPID in GAM (which is unrelated to the PPID UserId Submodule) has strict rul
 | Param under userSync | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
 | ppid | Optional | String | Must be a source from the [pbjs.getUserIdsAsEids()](#getUserIdsAsEids) array | `"pubcid.org"` |
+| autoRefresh | Optional | Boolean | Refresh IDs automatically when their configuration changes. Defaults to `false`. | `true` |
+| retainConfig | Optional | Boolean | When set to `false`, previously configured IDs are removed if they are not present in updated configuration. Defaults to `true`. | `false` |
+| enforceStorageType | Optional | Boolean | Restrict submodules to storing IDs only in the location defined by `storage.type`. | `true` |
 
 The table below has the options that are common across ID systems. See the sections below for specific configuration needed by each system and examples.
 

From 1e2292315097e9a45bd9f7052a06c8ad6367afbb Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Wed, 9 Jul 2025 10:21:19 -0400
Subject: [PATCH 232/665] pbs adapter: request compressions (#6118)

* docs: note PBS auction compression

* Update prebidServer.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/prebidServer.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index fb39f600db..627a94a890 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -97,7 +97,7 @@ There are many configuration options for s2sConfig:
 | `adapterOptions` | Optional | Object | Arguments will be added to resulting OpenRTB payload to Prebid Server in every impression object at request.imp[].ext.BIDDER. See the example above. |
 | `extPrebid` | Optional | Object | Arguments will be added to resulting OpenRTB payload to Prebid Server in request.ext.prebid. See the examples below. |
 | `customHeaders` | Optional | Object | These custom headers will be included in the XHR call to the bidder's endpoint. This will allow you to send data specific to your use case. The format consists of an object where the keys represent the header names and the values correspond to the respective header values. Here is an example how a customHeader object might look like - `{"Header1": "Value1", "Header2": "Value2"}`|
-| `endpointCompression` | Optional | Boolean | Enable gzip compression of outgoing requests when supported. | `true` |
+| `endpointCompression` | Optional | Boolean | Gzip compress the auction request payload when supported and debug mode is off. Adds `gzip=1` to the request URL. |
 | `filterBidderlessCalls` | Optional | Boolean | When `true`, ad units that have no bidders defined are excluded from Prebid Server requests. Defaults to `false`. | `true` |
 
 If `endpoint` and `syncEndpoint` are objects, these are the supported properties:
@@ -115,6 +115,7 @@ If `endpoint` and `syncEndpoint` are objects, these are the supported properties
 - If `bidders` is omitted, only adUnits that also omit bidders will be sent to Prebid Server. See the [stored impressions](#stored-imp) example below.
 - If the `s2sConfig` timeout is not specified, Prebid Server will utilize a configured default for `tmax`.
 - When using the `endpoint` or `syncEndpoint` object configs, you should define both properties.  If either property is not defined, Prebid Server requests for that type of user will not be made.  If you do not need to distinguish endpoints for consent reasons, you can simply define the same URL value in both fields or use the String version of the field (which is configured to use defined URL for all users).
+- When `endpointCompression` is enabled, Prebid.js compresses the request body sent to Prebid Server and appends `gzip=1` to the endpoint URL. This feature is skipped when debug mode is active or the browser lacks GZIP support. Do not use if your PBS Host does not yet support gzip request compression.
 - <a name="allowUnknownBidderCodes" ></a> When `allowUnknownBidderCodes` is `true`, bidders that have not been explicitly requested in [`adUnit.bids`](../adunit-reference.html#adunitbids) may take part in the auction. This can break custom logic that relies on the availability of a bid request object for any given bid. Known scenarios where custom code won't get the request when there's an "unknown bidder":
   - There will not be a [`bidRequested`](/dev-docs/publisher-api-reference/getEvents.html) event.
   - In the [MASS custom renderers](/dev-docs/modules/mass.html#configuration-parameters) module, `payload.bidRequest` will be undefined.

From 9c43a378b6e1de4bc08603e6e2d6aee5b94ad13d Mon Sep 17 00:00:00 2001
From: Edge226Ads <144908224+Edge226Ads@users.noreply.github.com>
Date: Thu, 10 Jul 2025 16:25:28 +0300
Subject: [PATCH 233/665] Edge226: change tcfeu_supported value change to true
 (#6138)

* New adapter Edge226

* New adapter Edge226

* tcfeu_supported value change to true
---
 dev-docs/bidders/edge226.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/edge226.md b/dev-docs/bidders/edge226.md
index 9eccba455e..257d468fe4 100644
--- a/dev-docs/bidders/edge226.md
+++ b/dev-docs/bidders/edge226.md
@@ -4,7 +4,7 @@ title: Edge226
 description: Prebid Edge226 Bidder Adapter
 biddercode: edge226
 usp_supported: true
-tcfeu_supported: false
+tcfeu_supported: true
 coppa_supported: true
 schain_supported: true
 floors_supported: true

From 602a89b9f8c58826ce2229c888d75e2672d9f638 Mon Sep 17 00:00:00 2001
From: "Adserver.Online" <61009237+adserver-online@users.noreply.github.com>
Date: Thu, 10 Jul 2025 16:35:16 +0300
Subject: [PATCH 234/665] Kuantyx Adapter: endpoint example update (#6132)

* Server endpoint update

* Contact email update

---------

Co-authored-by: dev <dev@adsrv.org>
---
 dev-docs/bidders/kuantyx.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/kuantyx.md b/dev-docs/bidders/kuantyx.md
index cf13210888..29855cc2a9 100644
--- a/dev-docs/bidders/kuantyx.md
+++ b/dev-docs/bidders/kuantyx.md
@@ -21,14 +21,14 @@ aliasCode: aso
 ---
 ### Note
 
-The Kuantyx adapter requires approval and setup. Please reach out to <support@kuantyx.com> or visit us at [kuantyx.com](https://kuantyx.com) for more details.
+The Kuantyx adapter requires approval and setup. Please reach out to <ssp@kuantyx.com> or visit us at [kuantyx.com](https://kuantyx.com) for more details.
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description      | Example                     | Type      |
 |---------------|----------|------------------|-----------------------------|-----------|
-| `server`      | required | Server endpoint  | `https://srv.kuantyx.com`   | `String`  |
+| `server`      | required | Server endpoint  | `https://srv.kntxy.com`     | `String`  |
 | `zone`        | required | Zone ID          | `73815`                     | `Integer` |
 
 #### Video Caching

From ca6f2c0260106866acf084f1a7b5266ab2ab2e90 Mon Sep 17 00:00:00 2001
From: AcuityAdsIntegrations
 <72594990+AcuityAdsIntegrations@users.noreply.github.com>
Date: Thu, 10 Jul 2025 16:38:20 +0300
Subject: [PATCH 235/665] Acuity update (#6126)

* add prebid.js adapter

* updates

* updates

* update Prebid Server documentation

* add gpp

* upd filename

* add endpointId param

* handle publisherId

---------

Co-authored-by: Kanceliarenko <kostiantyn.k@teqblaze.com>
---
 dev-docs/bidders/acuityads.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/acuityads.md b/dev-docs/bidders/acuityads.md
index 7cfb180f55..b94df0d385 100644
--- a/dev-docs/bidders/acuityads.md
+++ b/dev-docs/bidders/acuityads.md
@@ -30,6 +30,7 @@ The Example Bidding adapter requires setup before beginning. Please contact us a
 |---------------|----------|--------------|---------------------------------|------------|
 | `placementId` | optional | Placement Id | `'123'`                         | `'string'` |
 | `endpointId`  | optional | Endpoint Id  | `'456'`                         | `'string'` |
+| `publisherId`  | optional | Publisher Id  | `'789'`                       | `'string'` |
 
 For the prebid.js you only need to use one parameter: either placementId or endpointId
 

From 5d02757581f6252bbd1913c89f57dc1085764601 Mon Sep 17 00:00:00 2001
From: smounitz <smounitz@gmail.com>
Date: Thu, 10 Jul 2025 09:41:49 -0400
Subject: [PATCH 236/665] declare GPP support (#6123)

Co-authored-by: Shlomo Mounitz <>
---
 dev-docs/bidders/sovrn.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/sovrn.md b/dev-docs/bidders/sovrn.md
index 10518d325d..98f5ceae36 100644
--- a/dev-docs/bidders/sovrn.md
+++ b/dev-docs/bidders/sovrn.md
@@ -7,6 +7,7 @@ pbs: true
 biddercode: sovrn
 tcfeu_supported: true
 usp_supported: true
+gpp_supported: true
 userIds: all
 prebid_member: true
 schain_supported: true

From 84c436cceaa2c7a424cd44df28df774cf70f8d65 Mon Sep 17 00:00:00 2001
From: Rupesh Lakhani <35333377+AskRupert-DM@users.noreply.github.com>
Date: Thu, 10 Jul 2025 14:42:12 +0100
Subject: [PATCH 237/665] Update ozone.md (#6120)

remove disclosure as no longer valid, updated supported modules, etc
---
 dev-docs/bidders/ozone.md | 81 ++-------------------------------------
 1 file changed, 4 insertions(+), 77 deletions(-)

diff --git a/dev-docs/bidders/ozone.md b/dev-docs/bidders/ozone.md
index 80bb8470c9..0f2a50799d 100644
--- a/dev-docs/bidders/ozone.md
+++ b/dev-docs/bidders/ozone.md
@@ -12,9 +12,13 @@ deals_supported: true
 schain_supported: true
 coppa_supported: true
 usp_supported: true
+gpp_supported: true
+gpp_sids: tcfeu, usnat, usstate_all, usp
 floors_supported: true
 prebid_member: true
 sidebarType: 1
+fpd_supported: true
+privacy_sandbox: paapi, topics
 
 ---
 
@@ -29,83 +33,6 @@ sidebarType: 1
 | `placementId`    | required | The placement ID.  | `"0420420421"` | `string` |
 | `customData`     | optional | publisher key-values used for targeting | `[{"settings":{},"targeting":{"key1": "value1", "key2": "value2"}}],` | `array` |
 
-### Disclosure
-
-```legal
-Ozone Bid Adapter sets cookies without purpose one consent. They support essential technical functions such as load balancing traffic and identifying bot activity. These cookies are not set by Ozone's application but by our cloud providers – Cloudflare for security and performance, and Amazon Web Services for load balancing.
-
-Our immediate recommendation is to include information about these cookies in your CMP and privacy policy. This ensures transparency regarding the essential technical cookies that support site functionality and security. Given the nature and purpose of these cookies, they are typically categorised as strictly necessary and do not require user consent under regulations like GDPR or the ePrivacy Directive.Below is an example entry for your privacy policy:
-
-Strictly Necessary Cookies:
-Our website uses certain cookies that are essential for its operation and security. These cookies are automatically placed on your device when you access the site, ensuring that it functions properly and remains protected from malicious activity.
-
-Cookie Name: __cf_bm
-Provider: Cloudflare
-
-Purpose: This cookie is set by Cloudflare, our security and performance partner. It distinguishes between humans and bots to protect the website from automated malicious traffic. The cookie supports performance optimization and security features such as bot management and threat mitigation.
-
-Duration: Expires after 30 minutes of inactivity
-
-Data Collected: Encrypted, non-personally identifiable information used solely for security and performance purposes. No tracking of users across different websites or sessions.
-
-Consent: As this cookie is strictly necessary for the functioning and security of the website, it is exempt from consent requirements under applicable data protection laws, including the UK GDPR and ePrivacy Directive.
-
-Cookie Names: AWSALBG & AWSALBGTCORS
-Provider: Amazon Web Services (via our load balancing service)
-
-Purpose: These cookies are used to maintain session stickiness for load balancing purposes. When a load balancer receives a client request, it routes the request to a specific target server using a chosen algorithm.
-
-AWSALBG:
-
-Encodes and encrypts information about the selected target server.
-
-Is automatically included in the response to the client with a fixed expiry of 7 days, which is non-configurable.
-
-AWSALBGTCORS:
-
-For cross-origin resource sharing (CORS) requests, some browsers require cookies with SameSite=None; Secure attributes.
-
-This cookie is generated alongside AWSALBG and carries the same target information with the required SameSite attribute.
-
-Duration: Both cookies expire after 7 days.
-
-Data Collected: The cookies store information related to load balancing. The data is encrypted and used solely to ensure consistent session routing.
-
-Consent: As these are strictly necessary technical cookies, they are exempt from user consent requirements under applicable data protection laws.
-
-Technical Breakdown:
-
-__cf_bm:
-Cloudflare’s __cf_bm cookie is used to identify and mitigate automated traffic. It is essential for Cloudflare’s bot management and threat mitigation functions. Each end-user device visiting a protected site gets a unique __cf_bm cookie that expires after 30 minutes of inactivity. The content (except for time-related data) is encrypted and used only for computing a proprietary bot score and a session identifier if Anomaly Detection is enabled.
-
-AWSALBG & AWSALBGTCORS:
-When Amazon Web Services' load balancer receives a request, it routes the request to a target server based on a predetermined algorithm. The AWSALBG cookie encodes and encrypts information about the selected target server and is set with a fixed expiry of 7 days. For browsers that require cookies with SameSite=None; Secure attributes to support CORS, the AWSALBGTCORS cookie is generated alongside AWSALBG, containing the same target information with the necessary security attributes.
-```
-
-To require purpose one consent for Ozone, one could include the following
-
-```javascript
-pbjs.setConfig({
-    allowActivities: {
-        fetchBids: {
-            rules: [
-                {
-                    condition({componentType, adapterCode, gdprConsent}) {
-                        return (
-                            componentType === 'bidder' &&
-                            adapterCode === 'ozone' &&
-                            gdprConsent?.gdprApplies &&
-                            !gdprConsent?.vendorData?.purpose?.consents?.[1]
-                        )
-                    },
-                    allow: false
-                }
-            ]
-        }
-    }
-})
-```
-
 ### Test Parameters
 
 A test ad unit that will consistently return test creatives:

From 1f6c748039ad008b9d2a4b9870a26b507e46a542 Mon Sep 17 00:00:00 2001
From: Dimitra Mazaraki <7673832+mazaraki@users.noreply.github.com>
Date: Thu, 10 Jul 2025 15:47:46 +0200
Subject: [PATCH 238/665] =?UTF-8?q?add=20bidders=20on=20UtiqMtp=20ID=20con?=
 =?UTF-8?q?figuration,=20add=20TCF=20integration=20section=20=E2=80=A6=20(?=
 =?UTF-8?q?#6128)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add bidders on UtiqMtp ID configuration, add TCF integration section below UtiwMtp ID configuration section

* Use standard markdown links

* Absolute link

---------

Co-authored-by: Dimitra-Niki Mazaraki <dimitra-niki.mazaraki@utiq.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/userid-submodules/utiqMtp.md | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/dev-docs/modules/userid-submodules/utiqMtp.md b/dev-docs/modules/userid-submodules/utiqMtp.md
index 94cbc2323c..4de21ce7d8 100644
--- a/dev-docs/modules/userid-submodules/utiqMtp.md
+++ b/dev-docs/modules/userid-submodules/utiqMtp.md
@@ -37,12 +37,35 @@ pbjs.setConfig({
     userIds: [
       {
         name: "utiqMtpId",
+        bidders: ["bidder1", "bidder2", ...]
       },
     ],
   },
 })
 ```
 
+## TCF Activity Integration
+
+If you use the Prebid.js [TCF Control Module](/dev-docs/modules/tcfControl), which prevents access to local storage for non consented vendors, you may need to add a vendor exception for the Utiq user id module to work, as Utiq is not a TCF vendor and will be automatically blocked by Prebid when TCF Control is enabled. Utiq performs its own consent check, outside TCF, to ensure that there is no device storage access in the absence of consent.
+
+To do that, you can use below configuration:
+
+```javascript
+pbjs.setConfig({
+  consentManagement: {
+    gdpr: {
+      cmpApi: 'iab',
+      rules: [{        // these are the default values
+        purpose: "storage",
+        enforcePurpose: true, // block localStorage based on purpose 1 of TCF
+        enforceVendor: true,  // block localStorage for non consented / non TCF vendors
+        vendorExceptions: ["utiqMtpId"] // configuration line to add to make utiq exception
+      }]
+    }
+  }
+});
+```
+
 ## Utiq ID onboarding
 
 If you wish to find out more about Utiq, please contact <csm@utiq.com>

From 510515ad0a21ef6df44f69f817e373c241e883fe Mon Sep 17 00:00:00 2001
From: Dimitra Mazaraki <7673832+mazaraki@users.noreply.github.com>
Date: Tue, 15 Jul 2025 09:59:53 +0200
Subject: [PATCH 239/665] add text on UtiqMtp ID configuration, add row on
 table for bidders (#6143)

Co-authored-by: Dimitra-Niki Mazaraki <dimitra-niki.mazaraki@utiq.com>
---
 dev-docs/modules/userid-submodules/utiqMtp.md | 30 +++++++++++--------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/utiqMtp.md b/dev-docs/modules/userid-submodules/utiqMtp.md
index 4de21ce7d8..6f061622a4 100644
--- a/dev-docs/modules/userid-submodules/utiqMtp.md
+++ b/dev-docs/modules/userid-submodules/utiqMtp.md
@@ -25,9 +25,10 @@ If you are interested in using Utiq on your website, please contact Utiq on <htt
 
 {: .table .table-bordered .table-striped }
 
-| Param under userSync.userIds[] | Scope | Type | Description | Example |
-| --- | --- | --- | --- | --- |
-| name | Required | String | The name of the module | `"utiqMtpId"` |
+| Param under userSync.userIds[] | Scope    | Type   | Description                 | Example                       |
+| ------------------------------ | -------- | ------ | --------------------------- | ----------------------------- |
+| name                           | Required | String | The name of the module      | `"utiqMtpId"`                 |
+| bidders                        | Required | Array  | SSPs to send martechpass to | `["bidder1", "bidder2", ...]` |
 
 Configuration example:
 
@@ -44,6 +45,8 @@ pbjs.setConfig({
 })
 ```
 
+You may like to consider limiting the SSPs that receive the martechpass by **adding the bidders array**, to make sure they are not forwarding this first party ID to DSPs. We are working with SSPs to blacklist the above source from being sent to DSPs, please reach out to <csm@utiq.com> to verify which are these SSPs.
+
 ## TCF Activity Integration
 
 If you use the Prebid.js [TCF Control Module](/dev-docs/modules/tcfControl), which prevents access to local storage for non consented vendors, you may need to add a vendor exception for the Utiq user id module to work, as Utiq is not a TCF vendor and will be automatically blocked by Prebid when TCF Control is enabled. Utiq performs its own consent check, outside TCF, to ensure that there is no device storage access in the absence of consent.
@@ -54,15 +57,18 @@ To do that, you can use below configuration:
 pbjs.setConfig({
   consentManagement: {
     gdpr: {
-      cmpApi: 'iab',
-      rules: [{        // these are the default values
-        purpose: "storage",
-        enforcePurpose: true, // block localStorage based on purpose 1 of TCF
-        enforceVendor: true,  // block localStorage for non consented / non TCF vendors
-        vendorExceptions: ["utiqMtpId"] // configuration line to add to make utiq exception
-      }]
-    }
-  }
+      cmpApi: "iab",
+      rules: [
+        {
+          // these are the default values
+          purpose: "storage",
+          enforcePurpose: true, // block localStorage based on purpose 1 of TCF
+          enforceVendor: true, // block localStorage for non consented / non TCF vendors
+          vendorExceptions: ["utiqMtpId"], // configuration line to add to make utiq exception
+        },
+      ],
+    },
+  },
 });
 ```
 

From 237a48b495cef579888cbb065ef118787f67d272 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Tue, 15 Jul 2025 17:17:37 +0200
Subject: [PATCH 240/665] Adding bidResponseFilter reference (#6145)

* Adding bidResponseFilter reference

* Use standard markdown links

* markdown in jekyll includes not working

* relative links

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/examples/meta-bid-filtering.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/examples/meta-bid-filtering.md b/dev-docs/examples/meta-bid-filtering.md
index aae19d1e21..7ff0d28077 100644
--- a/dev-docs/examples/meta-bid-filtering.md
+++ b/dev-docs/examples/meta-bid-filtering.md
@@ -8,6 +8,7 @@ sidebarType: 1
 about:
 - This is an example that filters bid responses based on the metadata object.
 - Bidders can supply metadata about the bid such as advertiser domain. See the "meta" fields in the <a href="/dev-docs/bidder-adaptor.html#interpreting-the-response">bid response</a> for the full list of metadata.
+- Please note that we recommend a dedicated module for this case. See <a href="/dev-docs/modules/bidResponseFilter.html">Bid Response Filter</a>
 
 ---
 

From 7b01a5e835374f0d98dab0ff8b1a9b0324adcec6 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Tue, 15 Jul 2025 12:36:13 -0700
Subject: [PATCH 241/665] PBJS: new storageControl module docs (#6116)

* PBJS: new storageControl module docs

* Fix lint

* set recommended flag

* add min_js_version
---
 dev-docs/modules/storageControl.md | 124 +++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 dev-docs/modules/storageControl.md

diff --git a/dev-docs/modules/storageControl.md b/dev-docs/modules/storageControl.md
new file mode 100644
index 0000000000..9c467841f0
--- /dev/null
+++ b/dev-docs/modules/storageControl.md
@@ -0,0 +1,124 @@
+---
+layout: page_v2
+page_type: module
+title: Module - Storage Control
+description: Check or enforce disclosure of device storage use
+module_code : storageControl
+display_name : storageControl
+enable_download : true
+recommended: true
+sidebarType : 1
+min_js_version: 10.0.0
+---
+
+# Storage Control Module
+
+This module checks other modules' use of device storage against their disclosed list of storage keys and warns about or (optionally) denies undisclosed storage use.
+Additionally, it provides an API to list all disclosed storage keys.
+
+## Background
+
+The TCF Global Vendor List (GVL) requires vendors to disclose their use of device storage by publishing a [JSON file](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/Vendor%20Device%20Storage%20%26%20Operational%20Disclosures.md) that lists all the identifiers (cookie names and/or localStorage keys) and their associated domains.
+The Storage Control module uses that information to validate that when a Prebid module accesses storage, it uses identifiers that have been disclosed as in use for first party domains. 
+Vendors not in the GVL can provide a disclosure JSON to Prebid directly - see [adapter integration](#adapter-integration) below. 
+
+## Publisher Integration
+
+Include this module in the Prebid bundle:
+
+   ```bash
+   gulp build --modules=storageControl,...
+   ```
+
+If you are instead using Prebid as an NPM dependency, you'll need to explicitly import disclosure metadata. 
+This is done by including `metadata/prebid-core` and pairing each module import with a corresponding `import 'prebid.js/metadata/<module>'`. For example:
+
+```javascript
+import {pbjs} from 'prebid.js';
+import 'prebid.js/modules/userId';
+import 'prebid.js/modules/sharedIdSystem';
+
+import 'prebid.js/metadata/prebid-core';
+import 'prebid.js/metadata/userId';
+import 'prebid.js/metadata/sharedIdSystem';
+
+// ...
+```
+
+### Module Configuration
+
+This module exposes a single configuration option `storageControl.enforcement`, e.g.:
+
+```javascript
+pbjs.setConfig({
+  storageControl: {
+    enforcement: 'off'
+  }
+})
+```
+
+Possible values for it are:
+
+{: .table .table-bordered .table-striped }
+|Value | Description |
+| ------------ | ------------ |
+|`'off''` | The default. Use of undisclosed storage keys only generates a console warning. |
+|`'strict'` | Deny access to undisclosed storage keys |
+|`'allowAliases'` | Deny access to undisclosed storage keys, unless the use is from an alias of a module that does disclose them, in which case only log a warning. This can happen for instance when a bidder provides an alias linked to a different vendor in the GVL. |
+
+### Storage Disclosure Summary
+
+With this module included, the `getStorageUseDisclosures` API returns a list of all disclosures pertaining the first party domain for all installed modules. For example:
+
+```javascript
+pbjs.getStorageUseDisclosures()
+
+/**
+    [
+      {
+        "disclosedIn": "https://cdn.jsdelivr.net/gh/prebid/Prebid.js/metadata/disclosures/prebid/sharedId-optout.json",
+        "disclosedBy": [
+          "sharedIdSystem"
+        ],
+        "identifier": "_pubcid_optout",
+        "type": "cookie",
+        "maxAgeSeconds": 31536000,
+        "cookieRefresh": false,
+        "purposes": []
+      },
+      ...
+    ]
+ */
+```
+
+The return value follows the same format as the TCF [disclosures array](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/Vendor%20Device%20Storage%20%26%20Operational%20Disclosures.md), except that 
+
+- `domain`/`domains` is omitted (and always `'*'` in the original disclosure, as Prebid's storage is always on the first party domain);
+- each item in the array contains these additional fields:
+
+{: .table .table-bordered .table-striped }
+|Name | Type | Description |
+| ------------ | ------------ | ------------ |
+|`disclosedIn` | String | URL of the JSON containing this disclosure. Can be `null` for identifiers chosen trough publisher configuration - such as those set by the [userId module](/dev-docs/modules/userId.html) |
+|`disclosedBy` | Array of Strings | Names of the Prebid modules providing this disclosure |
+
+<a id="adapter-integration"></a>
+
+## Adapter Integration
+
+Modules that use storage should publish a [disclosure file](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/Vendor%20Device%20Storage%20%26%20Operational%20Disclosures.md) listing all keys that the pass to `storageManager` for the first party domain (`'*'`). This can be done by either:
+
+- providing a GVL ID in your adapter. The corresponding `deviceStorageDisclosureUrl` from the GVL is then used as your disclosure.
+- providing a `disclosureURL` directly. This does not require membership in the GVL, and overrides its disclosure if provided. For example:
+
+```javascript
+registerBidder({
+  code: 'exampleBidder',
+  disclosureURL: 'https://exampleBidder.com/disclosures.json'
+})
+```
+
+## Related Reading
+
+- [Vendor Device Storage & Operational Disclosures](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/Vendor%20Device%20Storage%20%26%20Operational%20Disclosures.md)
+- [Consent string and vendor list formats](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20Consent%20string%20and%20vendor%20list%20formats%20v2.md)

From 32f6e3c4bc35baf9f0054004d5d0586461616aea Mon Sep 17 00:00:00 2001
From: Roger <104763658+rogerDyl@users.noreply.github.com>
Date: Tue, 15 Jul 2025 22:43:04 +0200
Subject: [PATCH 242/665] Enable Prebid Server support for Akcelo (#6148)

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

diff --git a/dev-docs/bidders/akcelo.md b/dev-docs/bidders/akcelo.md
index 7072e54fee..ed03704e9d 100644
--- a/dev-docs/bidders/akcelo.md
+++ b/dev-docs/bidders/akcelo.md
@@ -4,7 +4,7 @@ title: Akcelo
 description: Prebid Akcelo Bidder Adapter
 biddercode: akcelo
 pbjs: true
-pbs: false
+pbs: true
 gvl_id: none
 tcfeu_supported: false
 usp_supported: false

From 4f0af5294888fbda7bc41a6d5d80f1fe29ea2f72 Mon Sep 17 00:00:00 2001
From: JacobKlein26 <42449375+JacobKlein26@users.noreply.github.com>
Date: Tue, 15 Jul 2025 16:49:46 -0400
Subject: [PATCH 243/665] Update nextMillennium.md: placement_id optional
 (#6146)

Only ONE of `placement_id` or `group_id` is required.
---
 dev-docs/bidders/nextMillennium.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/nextMillennium.md b/dev-docs/bidders/nextMillennium.md
index e851765e30..c957edd8ff 100644
--- a/dev-docs/bidders/nextMillennium.md
+++ b/dev-docs/bidders/nextMillennium.md
@@ -26,7 +26,7 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name           | Scope | Description                              | Example   | Type    |
 |----------------+-------+-----------------------------------+-----------+---------|
-| `placement_id` | required | Placement ID, provided by nextMillennium | `'12345'` | String  |
+| `placement_id` | optional | Placement ID, provided by nextMillennium | `'12345'` | String  |
 | `group_id`     | optional | Group ID, provided by nextMillennium     | `'12345'` | String  |
 
 Required one of the two parameters placement_id or group_id.

From dc4dd409b59bb69ff0afbc36d1670c47fe50e3c9 Mon Sep 17 00:00:00 2001
From: Maksym Danylov <146753616+mdanylov-sigma@users.noreply.github.com>
Date: Wed, 16 Jul 2025 20:52:43 +0300
Subject: [PATCH 244/665] SPM integration (#6153)

* Adds info about `shouldDisableStatusCheck`

* Modifies SPM integration section

* Resolve linter issues
---
 .../pbm-api/android/pbm-targeting-android.md  | 17 +++++++++
 .../pbm-api/ios/code-integration-ios.md       | 38 +++++++------------
 .../pbm-api/ios/pbm-targeting-ios.md          |  1 +
 3 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 8426565ed9..3aec4b66fb 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -348,6 +348,23 @@ Parameters:
 | --- | --- | --- | --- | --- |
 | eventDelegate | required | PrebidEventDelegate | The callback for handling all requests and responses. This interface takes request and response as the JSONObject types. | `{ request, response -> ... }` |
 
+#### setDisableStatusCheck()
+
+Informs the SDK whether it should check the PBS status during initialization. This will save initialization time if the PBS endpoint is always live and handled client side.
+
+Signature:
+
+```java
+public static void setDisableStatusCheck(boolean disableStatusCheck)
+```
+
+Parameters:
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| disableStatusCheck | required | boolean | Indicates whether the SDK should opt out of the PBS status checking during initialization. Default is `false`. | `true` |
+
 ---
 
 ## Consent Management Parameters
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index 15658748ab..a686b878af 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -47,36 +47,24 @@ If you are not familiar with the Carthage package builder, please refer to the p
 2. Drag `PrebidMobile.xcframework` from `generated/output` directory into your project. Make sure "Copy items if needed" is selected.
 3. Go to your Xcode project’s `General -> Frameworks, Libraries, and Embedded Content` settings. Use `Embed & Sign` for dynamic and `Do Not Embed` for static linking
 
-### Swift PM
+### Swift Package Manager (SPM)
 
-SPM isn't supported for Prebid SDK `2.0.0` and higher ([details](https://github.com/prebid/prebid-mobile-ios/issues/640)).
+Starting from version `3.1.0`, PrebidMobile supports the Swift Package Manager (SPM), making integration much easier and more maintainable compared to manual setups or CocoaPods.
 
-The next guide is applicable to `1.x` versions of the SDK.
+To [add the Prebid Mobile SDK package dependency](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#Add-a-package-dependency) using SPM, follow these steps:
 
-If you are not familiar with the Swift Package Manager, please refer to the project [github page](https://github.com/apple/swift-package-manager) for more details.
+1. In Xcode, install the Prebid Mobile SDK by navigating to File > Add Package Dependencies...
+2. In the prompt that appears, search for the Prebid Mobile SDK GitHub repository:
 
-1. Add Prebid dependency `File -> Swift Packages -> Add Package Dependency...`
-2. Select desired version, branch or commit
-3. Select Prebid [module]({{site.baseurl}}/prebid-mobile/modules/modules-overview.html)
-4. Build the specific schema `CarthageBuild.sh`
+    ```bash
+    https://github.com/prebid/prebid-mobile-ios.git
+    ```
+    
+3. Select the version of the Prebid Mobile SDK you want to use. For new projects, we recommend using the `Up to Next Major Version`.
+4. In the package selection screen, make sure to check the modules you need for your integration and link it to your application target.
 
-    **Variant 1**
-
-    - Run CarthageBuild.sh script from Cartfile folder. The path should be:
-        `.../Carthage/Checkouts/prebid-mobile-ios/scripts/CarthageBuild.sh`
-    - Enter Schema name (PrebidMobile or PrebidMobileCore)
-        - If you run CarthageBuild.sh and see Permission denied use:
-             `chmod +x <path_to_CarthageBuild.sh>`
-
-    **Variant 2**
-
-    - Open `PrebidMobile.xcodeproj` at `.../Carthage/Checkouts/prebid-mobile-ios/PrebidMobile.xcodeproj` using Xcode
-    - Manage Schemes -> Check Shared checkbox for a necessary schema
-    - run `carthage build prebid-mobile-ios`
-
-5. Integrate the binary into your project
-
-You can find the schema name in the build PrebidSDK framework inside Info.plist with `PrebidMobileName` key
+{: .alert.alert-info :}
+The Swift Package Manager (SPM) integration is currently marked as beta. We are actively working on refining the project structure and modularization to improve clarity, performance, and ease of integration. During this period, some modules or dependencies may be reorganized. We welcome your feedback - if you encounter any issues or have suggestions, please don't hesitate to reach out and help us shape the future of the PrebidMobile SPM support.
 
 ### Build framework from source
 
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index cc45afcca3..d7d73fdfe6 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -65,6 +65,7 @@ Prebid.shared.customStatusEndpoint="https://pbs.example.com/v2/status"
 | includeWinners | optional | boolean | ORTB | If `true`, Prebid sdk will add `includewinners` flag inside the targeting object described in [PBS Documentation](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#targeting) . Default is `false`. | `true` |
 | includeBidderKeys | optional | boolean | ORTB | If `true`, Prebid sdk will add `includebidderkeys` flag inside the targeting object described in [PBS Documentation](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#targeting) . Default is `false`. | `true` |
 | eventDelegate | optional | PrebidEventDelegate | init | Sets an event delegate to handle all auction requests and responses. It allows to collect some statistical data. Note that the SDK stores this callback as a weak reference so you need to store a reference to it. | `class PrebidEventDelegateTestsMockDelegate: PrebidEventDelegate { func prebidBidRequestDidFinish(requestData: Data?, responseData: Data?) { ... } }` |
+| shouldDisableStatusCheck | optional | boolean | init | If `true`, the SDK will not check the PBS status during initialization. This will save initialization time if the PBS endpoint is always live and handled client side. Default is `false`. | `true` |
 
 ### Prebid Class Global Methods
 

From a3824f258feb8e40abda5160b6a93e0d6fbc98c4 Mon Sep 17 00:00:00 2001
From: eugen-tikhonov <31205179+eugen-tikhonov@users.noreply.github.com>
Date: Wed, 16 Jul 2025 21:48:20 +0300
Subject: [PATCH 245/665] humansecurityMalvDefense Rtd Provider: replacement
 for cleanioRtdProvider (#6125)

* Add humansecurityMalvDefenseRTDProvider doc as near 1:1 copy of cleanioRTDProvider

* Update dev-docs/modules/cleanioRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Add a small fix for the link

---------

Co-authored-by: yevhen.tykhonov <yevhen.tykhonov@gmail.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/cleanioRtdProvider.md        | 13 +++-
 .../humansecurityMalvDefenseRtdProvider.md    | 74 +++++++++++++++++++
 2 files changed, 86 insertions(+), 1 deletion(-)
 create mode 100644 dev-docs/modules/humansecurityMalvDefenseRtdProvider.md

diff --git a/dev-docs/modules/cleanioRtdProvider.md b/dev-docs/modules/cleanioRtdProvider.md
index 455b8487b6..6bfe33b0a7 100644
--- a/dev-docs/modules/cleanioRtdProvider.md
+++ b/dev-docs/modules/cleanioRtdProvider.md
@@ -6,11 +6,20 @@ description: clean.io Real-time Anti-Malvertising Module
 page_type: module
 module_type: rtd
 module_code : cleanioRtdProvider
-enable_download : true
+enable_download : false
 vendor_specific: true
 sidebarType : 1
 ---
 
+
+{: .alert.alert-warning :}
+**Warning!**
+
+The **cleanioRtdProvider** module has been renamed to [humansecurityMalvDefenseRtdProvider](humansecurityMalvDefenseRtdProvider.html) following HUMAN Security's acquisition of the Clean.io project in 2022.
+ **cleanioRtdProvider** module is maintained for backward compatibility until the next major Prebid release.
+
+Please use **humansecurityMalvDefenseRtdProvider** instead of **cleanioRtdProvider** in your Prebid integration.
+
 # clean.io Real-time Anti-Malvertising Module
 
 ## Overview
@@ -49,6 +58,7 @@ pbjs.setConfig({
 ### Configuration parameters
 
 {: .table .table-bordered .table-striped }
+
 | Name | Type  | Scope | Description |
 | :------------ | :------------ | :------------ |:------------ |
 | ``cdnUrl`` | ``string`` | Required | CDN URL of the script, which is to be used for protection. |
@@ -57,6 +67,7 @@ pbjs.setConfig({
 ## Integration modes
 
 {: .table .table-bordered .table-striped }
+
 | Integration Mode | Parameter Value | Description |
 | :------------ | :------------ | :------------ |
 | Full page protection | ``'full'`` | Preferred mode. The module will add the protector agent script directly to the page, and it will protect all placements. This mode will make the most out of various behavioral detection mechanisms, and will also prevent typical malicious behaviors. Please note that in this mode, depending on Prebid library naming, Chrome may mistakenly tag non-ad-related content as ads: <https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/ad_tagging.md>. |
diff --git a/dev-docs/modules/humansecurityMalvDefenseRtdProvider.md b/dev-docs/modules/humansecurityMalvDefenseRtdProvider.md
new file mode 100644
index 0000000000..8780ff2526
--- /dev/null
+++ b/dev-docs/modules/humansecurityMalvDefenseRtdProvider.md
@@ -0,0 +1,74 @@
+---
+layout: page_v2
+title: HUMAN Security Malvertising Defense Real-Time Data Submodule
+display_name: HUMAN Security Malvertising Defense RTD Submodule
+description: The HUMAN Malvertising Defense RTD blocks 0-/1-click redirects and deceptive creatives in real time, lets safe ads render, and can optionally include HUMAN Ad Quality for broader protection.
+page_type: module
+module_type: rtd
+module_code : humansecurityMalvDefense
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+# HUMAN Security Malvertising Defense Real-Time Data Submodule
+
+## Overview
+
+The HUMAN Security Malvertising Defense RTD submodule offers a robust, easy-to-implement anti-malvertising solution for publishers. 
+Its automatic updates continuously detect and block on-page malicious ad behaviors — such as unwanted redirects and deceptive ads with harmful landing pages. 
+This safeguards revenue and visitor experience without extra maintenance, and with minimal impact on page load speed and overall site performance. 
+Publishers can also opt in to add HUMAN Ad Quality monitoring for broader protection.
+
+Using this module requires prior agreement with [HUMAN Security](https://www.humansecurity.com/) to obtain the necessary distribution key.
+
+{% include dev-docs/loads-external-javascript.md %}
+
+## Integration
+
+To integrate, add the HUMAN Security Malvertising Defense submodule to your Prebid.js package with:
+
+```bash
+gulp build --modules="rtdModule,humansecurityMalvDefenseRtdProvider,..."
+```
+
+> `rtdModule` is a required module to use HUMAN Security RTD module.
+
+## Configuration
+
+This module is configured as part of the `realTimeData.dataProviders` object.
+
+When built into Prebid.js, this module can be configured through the following `pbjs.setConfig` call:
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        dataProviders: [{
+            name: 'humansecurityMalvDefense',
+            params: {
+                cdnUrl: 'https://cadmus.script.ac/<yourUniqueId>/script.js', // Contact HUMAN Security to get your own CDN URL
+                protectionMode: 'full', // Supported modes are 'full', 'bids' and 'bids-nowait', see below.
+            }
+        }]
+    }
+});
+```
+
+### Configuration parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Scope | Description |
+| :------------ | :------------ | :------------ |:------------ |
+| ``cdnUrl`` | ``string`` | Required | CDN URL of the script, which is to be used for protection. |
+| ``protectionMode`` | ``'full'`` or ``'bids'`` or ``'bids-nowait'`` | Required | Integration mode. Please refer to the "Integration modes" section for details. |
+
+### Integration modes
+
+{: .table .table-bordered .table-striped }
+
+| Integration Mode | Parameter Value | Description  |
+| :------------ | :------------ | :------------ |
+| Full page protection | ``'full'`` | Preferred mode. The module will add the protector agent script directly to the page, and it will protect all placements. This mode will make the most out of various behavioral detection mechanisms, and will also prevent typical malicious behaviors. |
+| Bids-only protection | ``'bids'`` | The module will protect specific bid responses - specifically, the HTML that represents the ad payload - by wrapping them with the agent script. Ads served outside of Prebid will not be protected in this mode, as the module can only access ads delivered through Prebid. |
+| Bids-only protection with no delay on bid rendering | ``'bids-nowait'`` | Same as above, but in this mode, the script will also *not* wrap those bid responses, which arrived prior to successful preloading of agent script.   |

From 4edf690ac00192fe9d896d486965faa5699ebbeb Mon Sep 17 00:00:00 2001
From: rimaburder-index <55195208+rimaburder-index@users.noreply.github.com>
Date: Thu, 17 Jul 2025 10:59:59 -0400
Subject: [PATCH 246/665] Update ix-server.md (#6156)

updated Prebid Cache url
---
 dev-docs/bidders/ix-server.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/ix-server.md b/dev-docs/bidders/ix-server.md
index a7624c3b19..78f8e8088f 100644
--- a/dev-docs/bidders/ix-server.md
+++ b/dev-docs/bidders/ix-server.md
@@ -178,7 +178,7 @@ To call Index from a web browser using Prebid Server, you must first configure P
     ```javascript
     pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://my-pbs.example.com/cache'
         }
     });
     ```

From e1fdd7d693216ab27089dea19e6c6b4a73b3448b Mon Sep 17 00:00:00 2001
From: Baptiste Haudegand
 <89531368+github-baptiste-haudegand@users.noreply.github.com>
Date: Thu, 17 Jul 2025 17:00:44 +0200
Subject: [PATCH 247/665] Add Teads to codepath-notification (#6152)

---
 .github/workflows/scripts/codepath-notification | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/scripts/codepath-notification b/.github/workflows/scripts/codepath-notification
index 3b40b766c9..dd8b369c26 100644
--- a/.github/workflows/scripts/codepath-notification
+++ b/.github/workflows/scripts/codepath-notification
@@ -14,3 +14,4 @@
 /dev-docs/bidders/appnexus|/dev-docs/bidders/msft : prebid@microsoft.com
 /dev-docs/bidders/pubmatic : header-bidding@pubmatic.com
 /dev-docs/bidders/openx : prebid@openx.com
+/dev-docs/bidders/teads : tech-ssp-video@teads.tv

From 930349d655ec3b2a243aba68634da3fb44c6ffdf Mon Sep 17 00:00:00 2001
From: Mikhail Malkov <mhlmlkv@gmail.com>
Date: Fri, 18 Jul 2025 11:19:05 +0300
Subject: [PATCH 248/665] updated option safeframe_ok in documentation (#6158)

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

diff --git a/dev-docs/bidders/nextMillennium.md b/dev-docs/bidders/nextMillennium.md
index c957edd8ff..d218b1d02b 100644
--- a/dev-docs/bidders/nextMillennium.md
+++ b/dev-docs/bidders/nextMillennium.md
@@ -8,7 +8,7 @@ usp_supported: true
 coppa_supported: true
 schain_supported: true
 dchain_supported: false
-safeframes_ok: false
+safeframes_ok: true
 deals_supported: false
 floors_supported: false
 fpd_supported: false

From aac932209e69c8d5cfe11f2a01ce658899578731 Mon Sep 17 00:00:00 2001
From: rimaburder-index <55195208+rimaburder-index@users.noreply.github.com>
Date: Fri, 18 Jul 2025 04:19:28 -0400
Subject: [PATCH 249/665] Update ix.md (#6155)

Updated the link to Prebid cache
---
 dev-docs/bidders/ix.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/ix.md b/dev-docs/bidders/ix.md
index ac852a9bd0..e610582968 100644
--- a/dev-docs/bidders/ix.md
+++ b/dev-docs/bidders/ix.md
@@ -226,7 +226,7 @@ To monetize instream video, complete the following steps:
    ```javascript
    pbjs.setConfig({ 
      cache: { 
-             url: 'https://prebid.adnxs.com/pbc/v1/cache' 
+             url: 'https://my-pbs.example.com/cache'
          } 
    });
    ```

From fd2647c8a7d7495f62725a4db97dcc430054a41f Mon Sep 17 00:00:00 2001
From: zeeye <56828723+zeeye@users.noreply.github.com>
Date: Fri, 18 Jul 2025 09:20:16 +0100
Subject: [PATCH 250/665] updated doc for user sync inpementation (#6147)

---
 dev-docs/bidders/mobkoi.md | 58 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/mobkoi.md b/dev-docs/bidders/mobkoi.md
index 9406f061d5..40be910862 100644
--- a/dev-docs/bidders/mobkoi.md
+++ b/dev-docs/bidders/mobkoi.md
@@ -46,7 +46,7 @@ const adUnits = [
   {
     code: 'banner-ad',
     mediaTypes: {
-      banner: { sizes: [300, 200] },
+      banner: { sizes: [[300, 600]] },
     },
     bids: [
       {
@@ -63,3 +63,59 @@ pbjs.que.push(function () {
   pbjs.addAdUnits(adUnits);
 });
 ```
+
+#### User ID Module Integration
+
+For optimal targeting and yield, configure the Mobkoi User ID module alongside the bidder adapter.
+
+**Required modules:** `mobkoiBidAdapter`, `mobkoiIdSystem`, `userId`, `consentManagementTcf`, `tcfControl`
+
+```js
+pbjs.que.push(function () {
+  // Configuration for enabling the User ID module
+  pbjs.setConfig({
+    userSync: {
+      userIds: [
+        {
+          name: 'mobkoiId',
+          storage: {
+            type: 'cookie',
+            name: '_mobkoi_id',
+            expires: 30, // days
+          },
+        },
+      ],
+    },
+  });
+
+  pbjs.addAdUnits(adUnits);
+});
+```
+
+#### User Sync Configuration (Alternative)
+
+Alternatively, enable user sync without the User ID module.
+
+**Required modules:** `mobkoiBidAdapter`, `consentManagementTcf`, `tcfControl`
+
+```js
+pbjs.que.push(function () {
+  // Configuration for enabling getUserSyncs functionality
+  pbjs.setConfig({
+    userSync: {
+      filterSettings: {
+        image: {
+          bidders: ['mobkoi'],
+          filter: 'include'
+        }
+      }
+    }
+  });
+
+  pbjs.addAdUnits(adUnits);
+});
+```
+
+#### Additional Resources
+
+For comprehensive setup guidelines and detailed integration instructions, visit our [complete integration documentation](https://mobkoi.gitbook.io/docs).

From 1dc618a40a352215974e0113b89bbf38c9077189 Mon Sep 17 00:00:00 2001
From: pm-asit-sahoo <102290803+pm-asit-sahoo@users.noreply.github.com>
Date: Tue, 22 Jul 2025 19:21:05 +0530
Subject: [PATCH 251/665] PubMatic Bid Adapter: Updated the pubmatic.md file
 for gzip support (#6163)

* Updated the pubmatic.md file for gzip support

* Update pubmatic.md

* Update pubmatic.md

* Updated doc to disable gzip in bidder config
---
 dev-docs/bidders/pubmatic.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 5e6c22a558..1f7d27767e 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -234,4 +234,20 @@ AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
 ### Endpoint Compression
 
 This adapter utilizes gzip compression support built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests)
+
+#### Disabling Compression
+
+You can disable gzip compression at the bidder level using `pbjs.setBidderConfig`. Set the `gzipEnabled` value to false:
+
+```javascript
+pbjs.que.push(function () {
+  pbjs.setBidderConfig({
+    bidders: ['pubmatic'],
+    config: {
+      gzipEnabled: false
+    }
+  });
+});
+```
+
 <!-- workaround bug where code blocks at end of a file are incorrectly formatted-->

From d7c62792fd9d9932de5e4ba06ab23d002e49a27a Mon Sep 17 00:00:00 2001
From: Ivan Krdzavac <ivan.krdzavac@ogury.co>
Date: Tue, 22 Jul 2025 15:51:59 +0200
Subject: [PATCH 252/665] Ogury update prebid doc (#6159)

* update ogury documentation with inventory mapping

* add note for in-app inventory mapping

* add contact info and note for inventory mapping

* return links to email doc

* fix formatting

* missed whitespace
---
 dev-docs/bidders/ogury.md | 82 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 77 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/ogury.md b/dev-docs/bidders/ogury.md
index 416d44ac71..c6407a2a4b 100644
--- a/dev-docs/bidders/ogury.md
+++ b/dev-docs/bidders/ogury.md
@@ -22,15 +22,15 @@ gpp_sids: tcfeu, usnat, usstate_all
 ---
 ### Registration
 
- Before Ogury's adapter integration, you have to register an account in the Ogury Platform. Please contact <supply-development@ogury.co> if you're interested in a partnership.
+Before Ogury's adapter integration, you have to register an account in the Ogury Platform. Please contact <supply-development@ogury.co> if you're interested in a partnership.
 If you already have an account you'll need to register your websites (= assets) and the placements (= ad units) within the Platform. Alternatively reach out to your POC within Ogury to assist you with the placement creation.
 A detailed overview about the integration process can be found in [this documentation](https://ogury-ltd.gitbook.io/mobile-web/header-bidding/ogury-prebid.js-adapter-integration).
 
  After this registration, you will receive the Asset IDs and Ad Unit IDs to start the integration.
 
-### Mandatory bid Params
+### Bid Params
 
-The minimal list of bid params is:
+This is the minimal list of params for integrating with Ogury:
 
 {: .table .table-bordered .table-striped }
 
@@ -39,10 +39,82 @@ The minimal list of bid params is:
 | `assetKey`    | required | The asset key provided by Ogury   | `'OGY-CA41D116484F'` | `string`  |
 | `adUnitId`    | required | Your ad unit id configured with Ogury | `'2c4d61d0-90aa-0139-0cda-0242ac120004'` | `string`  |
 
+NOTE: You don't need these params to integrate with Ogury, see [inventory mapping](#inventory-mapping)
+
+#### First Party Data
+
+Publishers can use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.publisher.id
+
+this will be used with the inventory mapping method of integrating with Ogury.
+
+### Bidder config
+There are two ways to integrate with Ogury ad server, via the "bid params" i.e. `assetKey/adUnitId` or via inventory mapping.
+
+#### With bid params
+Use this example configuration for enabling Ogury ad server integration on a specific ad unit:
+
+```javascript
+ pbjs.que.push(function () {
+    pbjs.addAdUnits([
+        {
+            code: 'example-ad-unit-code',
+            mediaTypes: {banner: {sizes: [[1, 1]]} // example sizes
+            },
+            bids: [
+                {
+                    bidder: 'ogury',
+                    params: {
+                        assetKey: '$OGURY_ASSET_KEY',
+                        adUnitId: '$OGURY_AD_UNIT_ID',
+                    },
+                }
+            ]
+            // rest of bidders
+        }
+        // rest of ad units
+    ])
+})
+
+```
+
+#### Inventory mapping
+
+_"Inventory mapping" is only available for request coming from **web**. For **in-app** request use the "bid param" integration method._
+
+_Note: If you choose inventory mapping, you can skip specifying assetKey and adUnitId per ad unit._
+
+With inventory mapping you don't need to setup `assetKey/adUnitId` for every ad unit that you want to integrate. You use a single `id` and provide Ogury with list of sites and `ad_unit_code`s that you want to integrate and the mapping will be done on our side.
+The example configuration for this type of integration looks like this:
+
+```javascript
+pbjs.que.push(function () {
+            // setup publisherId for ogury
+            pbjs.setBidderConfig({
+                bidders: ['ogury'],
+                config: {
+                    ortb2: {
+                        site: {
+                            publisher: {
+                                id: '$OGURY_PUBLISHER_ID',
+                            },
+                        }
+                    }
+                }
+            })
+})
+````
+
+`$OGURY_PUBLISHER_ID` is a Ogury provided id. 
+
 ### Optional bid Params
 
 Depending on your advertising format needs, other optional parameters can be used. Supported parameters are detailed [here](https://ogury-ltd.gitbook.io/mobile-web/header-bidding/ogury-prebid.js-adapter-integration#optional-configuration).
 
-### How to contact us
+### Contact information
 
-If you have any technical concerns or questions about the adapter, please contact <web.inventory@ogury.co>.
+* For platform registration and partnership questions: <supply-development@ogury.co>
+* For technical or integration issues with the adapter: <web.inventory@ogury.co>
+* For technical issues with Prebid Server:  <deliveryservices@ogury.co>

From 799e30a3576d51c7abf20b89165d385e00afc7dd Mon Sep 17 00:00:00 2001
From: Daria Boyko <dariaboiko03@gmail.com>
Date: Wed, 23 Jul 2025 20:14:39 +0300
Subject: [PATCH 253/665] Add theads alias to admixer (#6144)

* Add admixerwl alias for admixerBidAdapter.

* Specify multiformat_supported and safeframes_ok for admixerwl adapter.

* add admixer: The Ads bidder description

* markdown lint

* remove tcfeu_supported

---------

Co-authored-by: Yaroslav Masenko <intgr-user@admixer.ua>
Co-authored-by: AdmixerTech <35560933+AdmixerTech@users.noreply.github.com>
Co-authored-by: Daria Boyko <dboyko@admixer.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/theads.md | 52 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 dev-docs/bidders/theads.md

diff --git a/dev-docs/bidders/theads.md b/dev-docs/bidders/theads.md
new file mode 100644
index 0000000000..8f4bbc76f5
--- /dev/null
+++ b/dev-docs/bidders/theads.md
@@ -0,0 +1,52 @@
+---
+layout: bidder
+title: The Ads
+description: Prebid AdMixer Bidder Adaptor
+pbjs: true
+biddercode: theads
+aliasCode: admixer
+media_types: banner, video, native
+usp_supported: true
+schain_supported: true
+prebid_member: true
+floors_supported: true
+sidebarType: 1
+multiformat_supported: will-bid-on-any
+safeframes_ok: true
+---
+
+#### Bidder Configuration
+
+The Ads bidder requires bidderURL to be set. Please note that theads bids will not be requested without this config. It must be set before auction starts.
+
+```js
+pbjs.setBidderConfig({
+  bidders: ['theads'],
+  config: {
+    bidderURL: 'https://us-adx-example.rtb-stack.com/prebid?client=44e2d241-5051-4b58-8ac6-f17e13732339&ssp=3&endpoint=777'
+  }
+});
+```
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name                | Scope    | Description                                                                                | Example                      | Type     |
+|---------------------|----------|--------------------------------------------------------------------------------------------|------------------------------|----------|
+| `tagId`        | required |The unique identifier of the ad placement. Will be used for comparison of statistics.                             | 51772                        | `int`    |
+| `kvTargeting`       | optional | Key/Value - a pair of the unique values that will be used for the custom targeting option. | {key1: value2, key2: value2} | `object` |
+
+#### Bid Example
+
+```js
+{
+  bidder: 'theads',
+  params: {
+    tagId: '12345',
+    kvTargeting: {
+      example: 'test'
+    }
+  }
+}
+```

From d4a4272afadb5ff0c7873e011aa65e011bce3b36 Mon Sep 17 00:00:00 2001
From: Pat Diggins <89027546+PBDMSFT@users.noreply.github.com>
Date: Wed, 23 Jul 2025 16:10:33 -0400
Subject: [PATCH 254/665] AppNexus Prebid Cache Deprecation (#6170)

* apn-cache-deprecation

* corrected-fenced-code-language

* removed-blank-line

* added-trailing-newline
---
 adops/setting-up-prebid-video-in-dfp.md       |  10 ++++----
 dev-docs/examples/instream-banner-mix.md      |   2 +-
 .../adServers.dfp.buildAdpodVideoUrl.md       |   2 +-
 dev-docs/publisher-api-reference/setConfig.md |   8 +++----
 dev-docs/show-long-form-video-with-gam.md     |   2 +-
 dev-docs/show-video-with-a-dfp-video-tag.md   |   2 +-
 prebid-mobile/docs/Prebid_Mobile_3_0_0.pdf    | Bin 678726 -> 797942 bytes
 prebid-server/features/pbs-caching.md         |  22 +++++++++++-------
 prebid-video/video-getting-started.md         |   2 +-
 prebid-video/video-integrating-solo.md        |   2 +-
 tools/line-item-manager.md                    |   2 +-
 11 files changed, 30 insertions(+), 24 deletions(-)

diff --git a/adops/setting-up-prebid-video-in-dfp.md b/adops/setting-up-prebid-video-in-dfp.md
index 17de3921bb..69da712394 100644
--- a/adops/setting-up-prebid-video-in-dfp.md
+++ b/adops/setting-up-prebid-video-in-dfp.md
@@ -29,7 +29,7 @@ For complete instructions on setting up Prebid line items in Google Ad Manager,
 {: .alert.alert-info :}
 For engineering setup instructions, see [Show Video Ads with a Google Ad Manager Video Tag](/dev-docs/show-video-with-a-dfp-video-tag.html).
 
-Each VAST creative contains a URL that points to the cached VAST XML. (This is because most video players can only work with a URL that returns VAST XML.) When setting up video creatives, it's important to understand where the VAST XML is stored for each of your bidders. The most common place to store VAST XML is the AppNexus cache, but some bidders (such as RubiconProject and SpotX) use their own cache services. To support such bidders, see [Multiple Cache Locations](#multiple-cache-locations) below.
+Each VAST creative contains a URL that points to the cached VAST XML. (This is because most video players can only work with a URL that returns VAST XML.) When setting up video creatives, it's important to understand where the VAST XML is stored for each of your bidders. Prebid.js supports server-side, client-side, and local caching as outlined in [pbjs.setConfig documentation](/dev-docs/publisher-api-reference/setConfig.html#client-side-caching-of-vast-xml). See [Multiple Cache Locations](#multiple-cache-locations) below for details on bidder-specific cache locations.
 
 ## Single Cache Location
 
@@ -55,7 +55,7 @@ Google Ad Manager will show you a warning stating that fetching VAST from the cr
 
 If you’re using a Send Top Price Bid configuration, then the VAST URL will be the same for each bidder:
 
-`https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid%%`
+`https://my-pbs.example.com/cache?uuid=%%PATTERN:hb_uuid%%`
 
 or
 
@@ -63,7 +63,7 @@ or
 
 If you’re using Send All Bids, the VAST URL will include the bidder-specific targeting variable. Be sure to replace `BIDDERCODE` with the actual bidder code for your bidders:
 
-`https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid_BIDDERCODE%%`
+`https://my-pbs.example.com/cache?uuid=%%PATTERN:hb_uuid_BIDDERCODE%%`
 
 or
 
@@ -73,11 +73,11 @@ or
 
 If your creative is for long-form (OTT) video, you must include a prefix in your VAST URL. For example (Send Top Price Bid):
 
-`https://prebid.adnxs.com/pbc/v1/cache?uuid=50.00_news_30s_%%PATTERN:hb_cache_id%%`
+`https://my-pbs.example.com/cache?uuid=50.00_news_30s_%%PATTERN:hb_cache_id%%`
 
 or (Send All Bids):
 
-`https://prebid.adnxs.com/pbc/v1/cache?uuid=50.00_news_30s_%%PATTERN:hb_cache_id_BIDDERCODE%%`
+`https://my-pbs.example.com/cache?uuid=50.00_news_30s_%%PATTERN:hb_cache_id_BIDDERCODE%%`
 
 In these examples, the `uuid` is set to the value of the `hb_pb_cat_dur` key you target in your line item. This value consists of the price bucket, label (for competitive exculsions), and video duration. In this example we've specified a price bucket of `50.00`, a label of `news`, and a duration of `30s`. See [GAM with Prebid Step by Step](/adops/step-by-step.html#targeting) for more information.
 
diff --git a/dev-docs/examples/instream-banner-mix.md b/dev-docs/examples/instream-banner-mix.md
index 3bdd997581..a099bc3f42 100644
--- a/dev-docs/examples/instream-banner-mix.md
+++ b/dev-docs/examples/instream-banner-mix.md
@@ -154,7 +154,7 @@ pbjs.que.push(function() {
     pbjs.setConfig({
         debug: true,
         cache: {
-            url: '<https://prebid.adnxs.com/pbc/v1/cache>'
+            url: '<https://my-pbs.example.com/cache>'
         }
     });
     pbjs.requestBids({
diff --git a/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md b/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md
index 02adfbb293..2622837b3c 100644
--- a/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md
+++ b/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md
@@ -30,7 +30,7 @@ pbjs.que.push(function(){
     pbjs.addAdUnits(videoAdUnit);
     pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://my-pbs.example.com/cache'
         },
         adpod: {
             brandCategoryExclusion: true
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 8c828a863a..193179df6a 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1082,7 +1082,7 @@ Here's an example of basic client-side caching. Substitute your Prebid Cache URL
 ```javascript
 pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://my-pbs.example.com/cache'
         }
 });
 ```
@@ -1127,7 +1127,7 @@ Optionally, `batchSize` and `batchTimeout` can be utlilized as illustrated with
 ```javascript
 pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache',
+            url: 'https://my-pbs.example.com/cache',
             batchSize: 4,
             batchTimeout: 50
         }
@@ -1151,7 +1151,7 @@ Consider the following Prebid configuration:
 ```javascript
 pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache',
+            url: 'https://my-pbs.example.com/cache',
             useLocal: true
         }
 });
@@ -1160,7 +1160,7 @@ pbjs.setConfig({
 When `useLocal` is set to true, the remote cache URL endpoint is never called. However, existing GAM creatives configured with a VAST ad tag URL, such as:
 
 ``
-https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:hb_uuid%%
+https://my-pbs.example.com/cache?uuid=%%PATTERN:hb_uuid%%
 ``
 
 will continue to function correctly. `hb_uuid` is set to locally assigned blob UUID. If the bid wins the GAM auction and it's `videoCacheKey` (`hb_uuid`) is included in a GAM wrapper VAST XML, Prebid will update the VAST ad tag URL with the locally cached blob URL after receiving a response from Google Ad Manager.
diff --git a/dev-docs/show-long-form-video-with-gam.md b/dev-docs/show-long-form-video-with-gam.md
index fd18bc87b7..573d25680d 100644
--- a/dev-docs/show-long-form-video-with-gam.md
+++ b/dev-docs/show-long-form-video-with-gam.md
@@ -184,7 +184,7 @@ pbjs.que.push(function(){
     pbjs.addAdUnits(videoAdUnit);
     pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://my-pbs.example.com/cache'
         },
         adpod: {
             brandCategoryExclusion: true
diff --git a/dev-docs/show-video-with-a-dfp-video-tag.md b/dev-docs/show-video-with-a-dfp-video-tag.md
index b14353a036..36f72fc8ae 100644
--- a/dev-docs/show-video-with-a-dfp-video-tag.md
+++ b/dev-docs/show-video-with-a-dfp-video-tag.md
@@ -100,7 +100,7 @@ pbjs.que.push(function() {
     pbjs.setConfig({
         /* Or whatever your preferred video cache URL is */
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://my-pbs.example.com/cache'
         }
     });
 
diff --git a/prebid-mobile/docs/Prebid_Mobile_3_0_0.pdf b/prebid-mobile/docs/Prebid_Mobile_3_0_0.pdf
index a476e0faa89edc230bb973c710dff006c5b9aa4e..a584c2cf8685c8fc107e090596c9cb0da62c71dc 100644
GIT binary patch
literal 797942
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%0Da3{$7}gCJNuLtY<;++Ra}tD%40dKrd%oP^!op
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
QMp@fffej2?v2Ngh10D1ibN~PV

literal 678726
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%0D=1XY5)RSZ
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

diff --git a/prebid-server/features/pbs-caching.md b/prebid-server/features/pbs-caching.md
index f52c897eb3..c3bcaf754b 100644
--- a/prebid-server/features/pbs-caching.md
+++ b/prebid-server/features/pbs-caching.md
@@ -49,26 +49,32 @@ You can watch the caching take place with your browser developer tools.
 From one of the [video instream examples](/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html):
 
 The VAST XML is stored into Prebid Cache from Prebid.js with this call:
-```
-POST https://prebid.adnxs.com/pbc/v1/cache
+
+```http
+POST https://my-pbs.example.com/cache
 <VAST XML BODY>
 ```
+
 And the response from the /cache call is:
-```
+
+```json
 {"responses":[{"uuid":"9b05c38c-709c-4fb5-8592-8fcacb1289f7"}]}
 ```
 
 And when the video player is ready to display the video ad, this
 call is seen go out:
+
+```http
+GET https://my-pbs.example.com/cache?uuid=9b05c38c-709c-4fb5-8592-8fcacb1289f7
 ```
-GET https://prebid.adnxs.com/pbc/v1/cache?uuid=9b05c38c-709c-4fb5-8592-8fcacb1289f7
-```
+
 And the response is the VAST XML.
 
 ### AMP
 
 Here's an example AMP response from Prebid Server:
-```
+
+```json
 {
     "targeting": {
         "hb_cache_id": "14b468d0-3c58-4a5d-ae5d-ab9a47b6152c",
@@ -84,7 +90,7 @@ Here's an example AMP response from Prebid Server:
 ```
 
 Then when the ad is chosen by the ad server, this fetch goes out from the browser:
-```
+
+```http
 https://prebid-server.example.com/cache?uuid=14b468d0-3c58-4a5d-ae5d-ab9a47b6152c
 ```
-
diff --git a/prebid-video/video-getting-started.md b/prebid-video/video-getting-started.md
index 09fd766830..805ff45123 100644
--- a/prebid-video/video-getting-started.md
+++ b/prebid-video/video-getting-started.md
@@ -41,7 +41,7 @@ If you’re using another ad server:
 Follow the instructions for your ad server to create line items for the in-player integration. The primary points to keep in mind as you set up your line items include:
 
 - Line items must target Prebid key-values.
-- The VAST creative URL must be in the format `https://prebid.adnxs.com/pbc/v1/cache?uuid={hb_cache_id}`, where `{hb_cache_id}` is the value passed to the ad server from Prebid.js.
+- The VAST creative URL must be in the format `https://my-pbs.example.com/cache?uuid={hb_cache_id}`, where `{hb_cache_id}` is the value passed to the ad server from Prebid.js.
 
 #### In-renderer Integration
 
diff --git a/prebid-video/video-integrating-solo.md b/prebid-video/video-integrating-solo.md
index 0f63b5c5fa..eb6095632f 100644
--- a/prebid-video/video-integrating-solo.md
+++ b/prebid-video/video-integrating-solo.md
@@ -75,7 +75,7 @@ Configuring the video cache is done with [`setConfig`](/dev-docs/publisher-api-r
 ```javascript
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://my-pbs.example.com/cache'
         /* Or whatever your preferred video cache URL is */
     }
 });
diff --git a/tools/line-item-manager.md b/tools/line-item-manager.md
index 9a911b9992..de88441b0b 100644
--- a/tools/line-item-manager.md
+++ b/tools/line-item-manager.md
@@ -67,7 +67,7 @@ creative: # at least one of the following types is required {video, banner}
         sizes: # list
             - height: 480
             width: 640
-        vast_xml_url: "https://prebid.adnxs.com/pbc/v1/cache?uuid=%%PATTERN:{{ hb_cache_id }}%%"
+        vast_xml_url: "https://my-pbs.example.com/cache?uuid=%%PATTERN:{{ hb_cache_id }}%%"
 ```
 
 #### Order setup

From 00c23fe28a700da5379fd8557e89d6586dc71626 Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.com>
Date: Thu, 24 Jul 2025 09:52:28 -0400
Subject: [PATCH 255/665] Update fwssp.md for skip params (#6169)

---
 dev-docs/bidders/fwssp.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index c483c11de5..170baebc6d 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -52,3 +52,6 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `sdkVersion` | optional | The AdManager sdk version to use for playback. This is only valid for "outstream" formats. Default: "7.10.0" | "7.11.0" | `string` |
 | `format` | optional | The format to use for displaying the ad. Default: outstream | "inbanner" | `string` |
 | `env` | optional | The AdManager build to use for ad playback. Valid values: "prd", "stg". Default: "prd" | "stg" | `string` |
+| `skip` | optional | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes | 1 | `number` |
+| `skipmin` | optional | Videos of total duration greater than this number of seconds can be skippable | 15 | `number` |
+| `skipafter` | optional | Number of seconds a video must play before skipping is enabled | 5 | `number` |

From b475de6ee27c43e219b9c63503f9900ab28a912f Mon Sep 17 00:00:00 2001
From: EwalksRumble <152418656+EwalksRumble@users.noreply.github.com>
Date: Thu, 24 Jul 2025 10:37:42 -0400
Subject: [PATCH 256/665] Add rumble bidder docs (#6139)

* Add rumble bidder docs

* Remove multi-line break

* Add additional metadata flags
---
 dev-docs/bidders/rumble.md | 41 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/rumble.md

diff --git a/dev-docs/bidders/rumble.md b/dev-docs/bidders/rumble.md
new file mode 100644
index 0000000000..8290d0ed9e
--- /dev/null
+++ b/dev-docs/bidders/rumble.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Rumble Advertising Center
+description: Prebid Rumble Bidder Adapter
+biddercode: rumble
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: true
+coppa_supported: false
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+media_types: video
+safeframes_ok: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+To use the Rumble Advertising Center bidder, you need to have an existing Rumble Advertising Center account. To create a 
+new account, see <https://ads.rumble.com>. For additional help, contact support or your account representative.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name        | Scope    | Description                                             | Example  | Type       |
+|-------------|----------|---------------------------------------------------------|----------|------------|
+| publisherId | required | Account publishing ID                                   | `1234`   | `number`   |  
+| siteId      | required | The site ID you want to send requests                   | `123`    | `number`   |
+| zoneId      | optional | An optional zone ID that you want to force requests to  | `12`     | `number`   |      
+| test        | optional | An optional boolean flag for sending test requests      | `true`   | `boolean`  | 

From 19e320a504c39b0e2b43b5fd8c44886406b17baa Mon Sep 17 00:00:00 2001
From: Pat Diggins <89027546+PBDMSFT@users.noreply.github.com>
Date: Thu, 24 Jul 2025 10:47:21 -0400
Subject: [PATCH 257/665] Appnexus cache deprecation GAM screenshot (#6173)

* apn-cache-deprecation

* corrected-fenced-code-language

* removed-blank-line

* added-trailing-newline

* replaced-gam-screenshot
---
 adops/setting-up-prebid-video-in-dfp.md        |   2 +-
 assets/images/ad-ops/gam-sbs/gam-tag-setup.png | Bin 0 -> 52370 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 assets/images/ad-ops/gam-sbs/gam-tag-setup.png

diff --git a/adops/setting-up-prebid-video-in-dfp.md b/adops/setting-up-prebid-video-in-dfp.md
index 69da712394..c1507fc21c 100644
--- a/adops/setting-up-prebid-video-in-dfp.md
+++ b/adops/setting-up-prebid-video-in-dfp.md
@@ -86,7 +86,7 @@ In these examples, the `uuid` is set to the value of the `hb_pb_cat_dur` key you
 
 The resulting creative should look something like the following:
 
-![GAM Video Creative Setup](/assets/images/ad-ops/gam-sbs/appnexus_vast_tag.png)
+![GAM Video Creative Setup](assets/images/ad-ops/gam-sbs/gam-tag-setup.png)!
 
 {:start="7"}
 7. If you're using jsdelivr, set your **Associated ad technology provider**:
diff --git a/assets/images/ad-ops/gam-sbs/gam-tag-setup.png b/assets/images/ad-ops/gam-sbs/gam-tag-setup.png
new file mode 100644
index 0000000000000000000000000000000000000000..5567fe74b81b00fe9f02cf0ed22f11f808a5b718
GIT binary patch
literal 52370
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
QgMxgd#TCTLMf3yy4;i9<5&!@I

literal 0
HcmV?d00001


From a6c117d65aba355f944ac02734a8424856c88f4a Mon Sep 17 00:00:00 2001
From: Tjorven <t.beckedorf@emetriq.com>
Date: Fri, 25 Jul 2025 09:08:44 +0200
Subject: [PATCH 258/665] T Advertising Solutions Bid Adapter: initial release
 (#6134)

* T Advertising Bid Adapter: create bid adapter

-

Squashed commit of the following:

commit ce5db1375cad408b8c0dccfba2e36e2772e8e233
Merge: dad87f59 f4c4a5ad
Author: Tjorven Beckedorf <t.beckedorf@emetriq.com>
Date:   Fri Jul 4 13:27:11 2025 +0200

    Merge remote-tracking branch 'github/master' into feature/OAD-1345-integrate-adapter-with-prebid.org

commit dad87f59e15f12a531ca77a7c4287eaff4f127ba
Author: Tjorven Beckedorf <t.beckedorf@emetriq.com>
Date:   Fri Jul 4 12:59:33 2025 +0200

    OAD-1345: add documentation for video adunits support

commit 0244516bfe361097413087e55899cde2454d0216
Author: Tjorven Beckedorf <t.beckedorf@emetriq.com>
Date:   Thu Jun 26 14:22:36 2025 +0200

    OAD-1345: add first version of tadvertising bidder docs

* T Advertising Bid Adapter: add feedback to the documentation

-

Squashed commit of the following:

commit 0741c2b7883f93c5c34e84bafe4f9a6236c4151d
Author: Tjorven Beckedorf <t.beckedorf@emetriq.com>
Date:   Mon Jul 14 09:29:39 2025 +0200

    OAD-1345: add feedback from github pull request in the documentation

* T Advertising Bid Adapter: add feedback to the documentation

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/tadvertising.md | 106 +++++++++++++++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 dev-docs/bidders/tadvertising.md

diff --git a/dev-docs/bidders/tadvertising.md b/dev-docs/bidders/tadvertising.md
new file mode 100644
index 0000000000..6fa8098985
--- /dev/null
+++ b/dev-docs/bidders/tadvertising.md
@@ -0,0 +1,106 @@
+---
+layout: bidder
+title: T-Advertising Solutions
+description: T-Advertising Solutions Prebid Bidder Adapter
+biddercode: tadvertising
+tcfeu_supported: true
+gvl_id: 213
+usp_supported: false
+coppa_supported: false
+gpp_supported: false
+schain_supported: true
+dchain_supported: false
+userIds: unifiedId
+media_types: banner, video
+floors_supported: true
+pbjs: true
+pbs: false
+prebid_member: no
+sidebarType: 1
+pbs_app_supported: false
+deals_supported: false
+multiformat_supported: will-not-bid
+ortb_blocking_supported: true
+gpp_sids: false
+fpd_supported: false
+---
+
+### Disclosure
+
+{: .alert.alert-danger :}
+Note: The T-Advertising Solutions Bidding adapter requires setup and approval from the T-Advertising Solutions service team. Please reach out to your account manager for more information to start using it.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+Name | Scope | Description | Example | Type
+--- | --- | --- | --- | ----
+`publisherId` | required | The publisher ID | `'1427ab10f2e448057ed3b422'` | `String`
+`placementId` | required | the GPID value should be passed in this field. | `'5e9f2c8b7d31a45620fa8d3c'` | `String`
+`bidfloor` | optional | Sets a bid floor price | `0.95` | `Float`
+
+### Banner Ad Unit Example
+
+The T-Advertising Solutions adapter for banner uses certain parameters in the AdUnit's
+[mediaTypes.banner](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.banner) definition.
+
+Here's a banner ad unit example:
+
+```javascript
+var bannerAdUnit = {
+    code: 'myBannerAdUnit',
+    mediaTypes: {
+        banner: {
+            sizes: [400, 600],
+        }
+    },
+    bids: [
+        {
+            bidder: 'tadvertising',
+            params: {
+                publisherId: '1427ab10f2e448057ed3b422',
+                placementId: 'sidebar_1',
+                bidfloor: 0.95 // Optional - default is 0
+            }
+        }
+    ]
+}
+```
+
+### Video Ad Unit Example
+
+The T-Advertising Solutions adapter for video requires certain parameters in the AdUnit's
+[mediaTypes.video](/dev-docs/adunit-reference.html#adUnit.mediaTypes.video) definition.
+
+Here's a video ad unit example:
+
+```javascript
+var videoAdUnit = {
+    code: 'myVideoAdUnit',
+    mediaTypes: {
+        video: {
+            mimes: ['video/mp4'],
+            minduration: 1,
+            maxduration: 60,
+            api: [1, 3],
+            placement: 3,
+            protocols: [2,3,5,6]
+        }
+    },
+    bids: [
+        {
+            bidder: "tadvertising",
+            params: {
+                publisherId: '1427ab10f2e448057ed3b422',
+                placementId: 'sidebar_1',
+                bidfloor: 0.95 // Optional - default is 0
+            }
+        }
+    ]
+}
+```
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).

From b754944cfdc88de78ca7c94bf8ad4ed5fd1091b1 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Sun, 27 Jul 2025 13:27:39 +0200
Subject: [PATCH 259/665] Fix #6154 Recommend typescript as adapter language
 (#6157)

* Recommend typescript as adapter language

* add back .ts extension

* add back

* Update dev-docs/bidder-adaptor.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Patrick McCann <patmmccann@gmail.com>
---
 dev-docs/bidder-adaptor.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 9038bab88a..e6f682b11f 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -28,6 +28,7 @@ This page has instructions for writing your own bidder adapter.  The instruction
 * [Required Files](#bidder-adaptor-Required-Files)
 * [Designing your Bid Params](#bidder-adaptor-Designing-your-Bid-Params)
 * [HTTP Simple Requests](#bidder-adaptor-HTTP-simple-requests)
+* We recommend submitting your adapter written in TypeScript, but you can opt-out and use JavaScript
 
 <a name="bidder-adaptor-Required-Adapter-Conventions"></a>
 
@@ -50,7 +51,7 @@ The above list is **not** the full list of requirements. Failure to follow any o
 
 With each adapter submission, there are two files required to be in the pull request:
 
-* `modules/exampleBidAdapter.js`: the file containing the code for the adapter
+* `modules/exampleBidAdapter.ts`: the file containing the code for the adapter
 * `modules/exampleBidAdapter.md`: a markdown file containing key information about the adapter:
   * The contact email of the adapter's maintainer.
   * A test ad unit that will consistently return test creatives. This helps us to ensure future Prebid.js updates do not break your adapter.  Note that if your adapter supports video (instream and/or outstream context) or native, you must also provide example parameters for each type.
@@ -196,7 +197,7 @@ If your adapter interfaces with an ORTB backend, you may take advantage of Prebi
 
 ### Overview
 
-The new code will reside under the `modules` directory with the name of the bidder suffixed by 'BidAdapter', e.g., `exampleBidAdapter.js`.
+The new code will reside under the `modules` directory with the name of the bidder suffixed by 'BidAdapter', e.g., `exampleBidAdapter.ts`.
 
 Here are some guidelines for choosing a bidder code:
 
@@ -220,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.js';
+import {BANNER, VIDEO, NATIVE} from 'src/mediaTypes.ts';
 const BIDDER_CODE = 'example';
 export const spec = {
     code: BIDDER_CODE,
@@ -1138,7 +1139,7 @@ If `image` is a string, `hb_native_image` will be populated with that string (a
 
 For some time, Prebid engineers will try to ensure that legacy-style request definitions will continue to work. However, Prebid.JS is internally converting everything to OpenRTB. So, OpenRTB is the way to go if you want to ensure your native adapter will continue to work for the long run.
 
-We assume that in the first times all adapters will only understand legacy-style native, so we expose two functions in `native.js`:
+We assume that in the first times all adapters will only understand legacy-style native, so we expose two functions in `native.ts`:
 
 * `convertOrtbRequestToProprietaryNative(bidRequests)` - this function will convert OpenRTB-style native requests to legacy format. Actually, we've already added this conversion to all adapters so they will not fail when an OpenRTB definition is used by publisher.
 
@@ -1161,7 +1162,7 @@ For example tests, see [the existing adapter test suites](https://github.com/pre
 import * as utils from 'src/utils';
 import {config} from 'src/config';
 import {registerBidder} from 'src/adapters/bidderFactory';
-import {BANNER, VIDEO, NATIVE} from 'src/mediaTypes.js';
+import {BANNER, VIDEO, NATIVE} from 'src/mediaTypes.ts';
 const BIDDER_CODE = 'example';
 export const spec = {
         code: BIDDER_CODE,
@@ -1316,7 +1317,7 @@ registerBidder(spec);
   * Fork the repo
   * Copy a file in [dev-docs/bidders](https://github.com/prebid/prebid.github.io/tree/master/dev-docs/bidders) and name it to exactly the same as your biddercode. Add the following metadata to the header of your .md file:
     * Add 'biddercode' and set it to the code that publishers should be using to reference your bidder in an AdUnit. _This needs to be the same name as the docs file!_
-    * Add 'aliasCode' if your biddercode is not the same name as your PBJS implementation file. e.g. if your biddercode is "ex", but the file in the PBJS repo is exampleBidAdapter.js, this value needs to be "example".
+    * Add 'aliasCode' if your biddercode is not the same name as your PBJS implementation file. e.g. if your biddercode is "ex", but the file in the PBJS repo is exampleBidAdapter.ts, this value needs to be "example".
     * Add `pbjs: true`. If you also have a [Prebid Server bid adapter](/prebid-server/developers/add-new-bidder-go.html), add `pbs: true`. Default is false for both.
     * If you're on the IAB Global Vendor List (including just [Canada](https://vendor-list.consensu.org/v2/ca/vendor-list.json)), add your ID number in `gvl_id`.
     * If you support the IAB's TCF-EU consent string format and have a GVL ID, you may add `tcfeu_supported: true`. Default is false.

From d61c2dae38d01cc68fb45f4ef3bcc724d300c9d0 Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.com>
Date: Mon, 28 Jul 2025 05:41:59 -0400
Subject: [PATCH 260/665] Update fwssp.md remove skip from Bid Params (#6175)

---
 dev-docs/bidders/fwssp.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index 170baebc6d..c483c11de5 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -52,6 +52,3 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `sdkVersion` | optional | The AdManager sdk version to use for playback. This is only valid for "outstream" formats. Default: "7.10.0" | "7.11.0" | `string` |
 | `format` | optional | The format to use for displaying the ad. Default: outstream | "inbanner" | `string` |
 | `env` | optional | The AdManager build to use for ad playback. Valid values: "prd", "stg". Default: "prd" | "stg" | `string` |
-| `skip` | optional | Indicates if the player will allow the video to be skipped, where 0 = no, 1 = yes | 1 | `number` |
-| `skipmin` | optional | Videos of total duration greater than this number of seconds can be skippable | 15 | `number` |
-| `skipafter` | optional | Number of seconds a video must play before skipping is enabled | 5 | `number` |

From a008bed4ea29656cdfd3f9ce549bdec95520189a Mon Sep 17 00:00:00 2001
From: Viktor Dreiling <34981284+3link@users.noreply.github.com>
Date: Tue, 29 Jul 2025 16:32:47 +0200
Subject: [PATCH 261/665] Document nexxen (#6161)

---
 dev-docs/modules/userid-submodules/liveintent.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/liveintent.md b/dev-docs/modules/userid-submodules/liveintent.md
index 16696bd312..b0b024120e 100644
--- a/dev-docs/modules/userid-submodules/liveintent.md
+++ b/dev-docs/modules/userid-submodules/liveintent.md
@@ -101,7 +101,7 @@ pbjs.setConfig({
 
 ### Multiple user IDs
 
-The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk`, `sharethrough`, `sonobi`, `vidazoo`, `zetassp`, `triplelift` and `fpid` are treated specially by LiveIntent's user ID sub-module. Each of these attributes will result in a separate ID returned by the sub-module. Note: `thetradedesk` will be exposed as `tdid` because of historical reasons.
+The attributes `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk`, `sharethrough`, `sonobi`, `vidazoo`, `zetassp`, `triplelift`, `nexxen` and `fpid` are treated specially by LiveIntent's user ID sub-module. Each of these attributes will result in a separate ID returned by the sub-module. Note: `thetradedesk` will be exposed as `tdid` because of historical reasons.
 
 #### Note
 
@@ -124,9 +124,9 @@ For example, in case `uid2` is configured to be requested in addition to the `no
 }
 ```
 
-NOTE: `uid2` is exposed as part of `lipb` as well as separately as `uid2`. `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (as `tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift` and `fpid` behave the same way.
+NOTE: `uid2` is exposed as part of `lipb` as well as separately as `uid2`. `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (as `tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift`, `nexxen` and `fpid` behave the same way.
 
-For the attributes `lipbid` (nonID), `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift` and `fpid` there is also support for their conversion into OpenRTB EIDS format. Please refer to [User ID Module](../userId.md) documentation for more information on conversion, and [Example of eids array generated by UserId Module](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md) for output format examples.
+For the attributes `lipbid` (nonID), `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift`, `nexxen` and `fpid` there is also support for their conversion into OpenRTB EIDS format. Please refer to [User ID Module](../userId.md) documentation for more information on conversion, and [Example of eids array generated by UserId Module](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md) for output format examples.
 
 ### FPID
 
@@ -206,7 +206,7 @@ pbjs.setConfig({
 | params.ajaxTimeout |Optional| Number |This configuration parameter defines the maximum duration of a call to the `IdentityResolution` endpoint. By default, 5000 milliseconds.|`5000`|
 | params.partner | Optional| String |The name of the partner whose data will be returned in the response.|`prebid`|
 | params.identifiersToResolve |Optional| Array[String] |Used to send additional identifiers in the request for LiveIntent to resolve against the LiveIntent ID and additional attributes.|`['my-id']`|
-| params.requestedAttributesOverrides | Optional | Object | Object containing booleans used to override the default resolution. Attributes set to `true` will be added to the resolved list, while attributes set to `false` will be removed. Valid attributes are `nonId`, `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift`, `segments` and `fpid`. | `{'uid2': true}` |
+| params.requestedAttributesOverrides | Optional | Object | Object containing booleans used to override the default resolution. Attributes set to `true` will be added to the resolved list, while attributes set to `false` will be removed. Valid attributes are `nonId`, `uid2`, `medianet`, `magnite`, `bidswitch`, `pubmatic`, `openx`, `sovrn`, `index`, `thetradedesk` (`tdid`), `sharethrough`, `vidazoo`, `zetassp`, `triplelift`, `segments`, `nexxen` and `fpid`. | `{'uid2': true}` |
 | params.emailHash |Optional| String |The hashed email address of a user. We can accept the hashes, which use the following hashing algorithms: md5, sha1, sha2.|`1a79a4d60de6718e8e5b326e338ae533`|
 | params.ipv4 |Optional| String |The IPv4 address of a user. |`1.2.3.4`|
 | params.ipv6 |Optional| String |The IPv6 address of a user. |`2001:db8:3333:4444:5555:6666:7777:8888`|

From 19d5cdefc296b9fed762394d617cc4cf59c606ca Mon Sep 17 00:00:00 2001
From: f-cali <f.cali@onetag.com>
Date: Tue, 29 Jul 2025 16:40:56 +0200
Subject: [PATCH 262/665] Updated Multi Format Support field (#6180)

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

diff --git a/dev-docs/bidders/onetag.md b/dev-docs/bidders/onetag.md
index c230166438..2815d3787c 100644
--- a/dev-docs/bidders/onetag.md
+++ b/dev-docs/bidders/onetag.md
@@ -17,7 +17,7 @@ floors_supported: true
 sidebarType: 1
 coppa_supported: true
 privacy_sandbox: topics
-multiformat_supported: will-bid-on-one
+multiformat_supported: will-bid-on-any
 ---
 
 

From ba949669059ba1c5d3396d084a3cd4835cc2e2d2 Mon Sep 17 00:00:00 2001
From: Vincent <vincent.r06@gmail.com>
Date: Tue, 29 Jul 2025 20:01:47 +0200
Subject: [PATCH 263/665] Criteo bid adapter - Update prebid server
 documentation (#6179)

Co-authored-by: v.raybaud <v.raybaud@criteo.com>
---
 dev-docs/bidders/criteo.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/criteo.md b/dev-docs/bidders/criteo.md
index 0e05e685ca..1888c957b2 100644
--- a/dev-docs/bidders/criteo.md
+++ b/dev-docs/bidders/criteo.md
@@ -27,7 +27,7 @@ gpp_supported: true
 This bidder adapter automatically includes the Criteo User ID module and performs iFrame syncs.
 
 {: .alert.alert-warning :}
-Prebid-Server support is on alpha test and is currently a non-finished product. Activation requires setup and approval before beginning. Please reach out to your account manager or <publishers@criteo.com> for more details.
+Prebid-Server activation requires business approval before beginning. Please reach out to your account manager for more details.
 
 ### Bid Params
 

From 083e24853762c4e64f49ad688ed63a6aeaa2f397 Mon Sep 17 00:00:00 2001
From: newdreamglobal <63518883+newdreamglobal@users.noreply.github.com>
Date: Wed, 30 Jul 2025 02:06:49 -0300
Subject: [PATCH 264/665] New adapter: newdream (#6176)

* Add new appnexus alias newdream

* Add new appnexus alias newdream

* remove gpp

* Add new appnexus alias newdream

* remove gpp

---------

Co-authored-by: Damian <dares@gtsur.com>
---
 dev-docs/bidders/newdream.md | 178 +++++++++++++++++++++++++++++++++++
 1 file changed, 178 insertions(+)
 create mode 100644 dev-docs/bidders/newdream.md

diff --git a/dev-docs/bidders/newdream.md b/dev-docs/bidders/newdream.md
new file mode 100644
index 0000000000..9f21671e65
--- /dev/null
+++ b/dev-docs/bidders/newdream.md
@@ -0,0 +1,178 @@
+---
+layout: bidder
+title: Newdream
+description: Prebid Newdream Bidder Adapter
+biddercode: newdream
+aliasCode : appnexus
+media_types: video,banner,native
+tcfeu_supported: true
+dsa_supported: true
+prebid_member: true
+userIds: all (with commercial activation)
+schain_supported: true
+coppa_supported: true
+usp_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+gvl_id: 32
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description | Example | Type     |
+|---------------|----------|-------------|---------|----------|
+| `placementId` | required |             |         | `string` |
+| `randomKey`   | optional |             |         | `string` |
+| `invCode`     | optional |             |         | `string` |
+| `member`      | optional |             |         | `string` |
+
+Newdream is an aliased bidder for AppNexus
+
+### Prebid Server Note
+
+{% include dev-docs/pbjs-adapter-required-for-pbs.md %}
+
+#### Prebid Server Test Request
+
+The following test parameters can be used to verify that Prebid Server is working properly with the server-side Newdream adapter. This example includes an Newdream test placement ID and sizes that would match with the test creative.
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'newdream',
+         params: {
+           placementId: 13144370
+         }
+       }]
+   },
+   // Native adUnit
+   {
+      code: 'native-div',
+      sizes: [[1, 1]],
+      mediaTypes: {
+        native: {
+          title: {
+            required: true
+          },
+          body: {
+            required: true
+          },
+          image: {
+            required: true
+          },
+          sponsoredBy: {
+            required: true
+          },
+          icon: {
+            required: false
+          }
+        }
+      },
+      bids: [{
+        bidder: 'newdream',
+        params: {
+          placementId: 13232354,
+          allowSmallerSizes: true
+        }
+      }]
+   },
+   // Video instream adUnit
+   {
+      code: 'video-instream',
+      sizes: [[640, 480]],
+      mediaTypes: {
+        video: {
+          playerSize: [[640, 480]],
+          context: 'instream'
+        },
+      },
+      bids: [{
+        bidder: 'newdream',
+        params: {
+          placementId: 13232361,
+          video: {
+            skippable: true,
+            playback_methods: ['auto_play_sound_off']
+          }
+        }
+      }]
+   },
+   // Video outstream adUnit
+   {
+     code: 'video-outstream',
+     sizes: [[300, 250]],
+     mediaTypes: {
+       video: {
+         playerSize: [[300, 250]],
+         context: 'outstream',
+         // Certain ORTB 2.5 video values can be read from the mediatypes object; below are examples of supported params.
+         // To note - mediafuse supports additional values for our system that are not part of the ORTB spec.  If you want
+         // to use these values, they will have to be declared in the bids[].params.video object instead using the mediafuse syntax.
+         // Between the corresponding values of the mediaTypes.video and params.video objects, the properties in params.video will 
+         // take precedence if declared; eg in the example below, the `skippable: true` setting will be used instead of the `skip: 0`.
+         minduration: 1,
+         maxduration: 60,
+         skip: 0,   // 1 - true, 0 - false
+         skipafter: 5,
+         playbackmethod: [2], // note - we only support options 1-4 at this time
+         api: [1,2,3]   // note - option 6 is not supported at this time
+       }
+     },
+     bids: [
+       {
+         bidder: 'newdream',
+         params: {
+           placementId: 13232385,
+           video: {
+             skippable: true,
+             playback_method: 'auto_play_sound_off'
+           }
+         }
+       }
+     ]
+   },
+   // Banner adUnit in a App Webview
+   // Only use this for situations where prebid.js is in a webview of an App
+   // See Prebid Mobile for displaying ads via an SDK
+   {
+     code: 'banner-div',
+     mediaTypes: {
+       banner: {
+         sizes: [[300, 250], [300,600]]
+       }
+     }
+     bids: [{
+       bidder: 'newdream',
+       params: {
+         placementId: 13144370,
+         app: {
+           id: "B1O2W3M4AN.com.prebid.webview",
+           geo: {
+             lat: 40.0964439,
+             lng: -75.3009142
+           },
+           device_id: {
+             idfa: "4D12078D-3246-4DA4-AD5E-7610481E7AE", // Apple advertising identifier
+             aaid: "38400000-8cf0-11bd-b23e-10b96e40000d", // Android advertising identifier
+             md5udid: "5756ae9022b2ea1e47d84fead75220c8", // MD5 hash of the ANDROID_ID
+             sha1udid: "4DFAA92388699AC6539885AEF1719293879985BF", // SHA1 hash of the ANDROID_ID
+             windowsadid: "750c6be243f1c4b5c9912b95a5742fc5" // Windows advertising identifier
+           }
+         }
+       }
+     }]
+   }
+];
+```

From ab2d09b565940569e2fb0109590c4528df28f1e7 Mon Sep 17 00:00:00 2001
From: ysfbsf <youssef.bsf@gmail.com>
Date: Wed, 30 Jul 2025 06:07:27 +0100
Subject: [PATCH 265/665] Docs/update missena params (#6136)

* New Prebid Server Adapter: Missena

* set prebid_member to true

* Add pbs: true to the metadata

* Update Missena bidder docs with formats and settings parameters

* Enhance Missena bidder documentation with available placement values
---
 dev-docs/bidders/missena.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/dev-docs/bidders/missena.md b/dev-docs/bidders/missena.md
index 9d6c7c2e8a..44c17d4a79 100644
--- a/dev-docs/bidders/missena.md
+++ b/dev-docs/bidders/missena.md
@@ -25,3 +25,13 @@ The Missena Bidding adapter requires setup before beginning. Please contact us a
 | `placement`   | optional | Placement Type, default: 'sticky' | `'sticky'` | `string` |
 | `formats`  | optional | An array of formats to request (banner, native, or video) | `['banner', 'video']` | `array` |
 | `settings` | optional | An object containing extra settings for the Missena adapter | `{ settingName: 'value' }` | `object` |
+
+#### Available Placement Values
+
+The `placement` parameter accepts the following values:
+
+- `sticky` - Default sticky placement
+- `header` - Header placement
+- `footer` - Static footer placement
+- `prestitial` - Full-screen ad before content loads
+- `postitial` - Full-screen ad after content loads

From 69b06a07f946b20063f76ea61dd0f7a7a10a905f Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Thu, 31 Jul 2025 16:09:03 +0200
Subject: [PATCH 266/665] Update assets url in
 setting-up-prebid-video-in-dfp.md (#6186)

* Update assets url in setting-up-prebid-video-in-dfp.md

* Apply suggestion from @muuki88
---
 adops/setting-up-prebid-video-in-dfp.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/adops/setting-up-prebid-video-in-dfp.md b/adops/setting-up-prebid-video-in-dfp.md
index c1507fc21c..a4a1ca87ac 100644
--- a/adops/setting-up-prebid-video-in-dfp.md
+++ b/adops/setting-up-prebid-video-in-dfp.md
@@ -86,7 +86,7 @@ In these examples, the `uuid` is set to the value of the `hb_pb_cat_dur` key you
 
 The resulting creative should look something like the following:
 
-![GAM Video Creative Setup](assets/images/ad-ops/gam-sbs/gam-tag-setup.png)!
+![GAM Video Creative Setup](/assets/images/ad-ops/gam-sbs/gam-tag-setup.png)!
 
 {:start="7"}
 7. If you're using jsdelivr, set your **Associated ad technology provider**:

From e07a05b7164d199a269849350624e053e17b04f5 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 31 Jul 2025 16:31:22 -0400
Subject: [PATCH 267/665] Add Chrome AI RTD Provider documentation (#6174)

* Add Chrome AI RTD Provider documentation

* Update dev-docs/modules/chromeAiRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/modules/chromeAiRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/modules/chromeAiRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/modules/chromeAiRtdProvider.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update chromeAiRtdProvider.md

* Update chromeAiRtdProvider.md

* Update chromeAiRtdProvider.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/chromeAiRtdProvider.md | 219 ++++++++++++++++++++++++
 1 file changed, 219 insertions(+)
 create mode 100644 dev-docs/modules/chromeAiRtdProvider.md

diff --git a/dev-docs/modules/chromeAiRtdProvider.md b/dev-docs/modules/chromeAiRtdProvider.md
new file mode 100644
index 0000000000..e4c78a238e
--- /dev/null
+++ b/dev-docs/modules/chromeAiRtdProvider.md
@@ -0,0 +1,219 @@
+---
+layout: page_v2
+title: Chrome AI RTD Provider
+display_name: Chrome AI RTD Provider
+description: Use Chrome AI APIs for language detection and summarization.
+page_type: module
+module_type: rtd
+module_code : chromeAiRtdProvider
+enable_download : true
+sidebarType : 1
+---
+
+# Chrome AI RTD Provider
+
+## Overview
+
+The Chrome AI RTD Provider is a Prebid.js Real-Time Data (RTD) module that enhances bidding by leveraging Chrome's built-in AI capabilities. It can automatically detect page language using the [Chrome AI Language Detection API](https://developer.chrome.com/docs/ai/language-detection) and generate page summaries or keywords using the [Chrome AI Summarizer API](https://developer.chrome.com/docs/ai/summarizer-api). This information is added to the OpenRTB bid request objects, allowing bid adapters to optimize bids based on content language and context.
+
+## Features
+
+- Automatic language detection using the Chrome AI Language Detection API.
+- Automatic page summarization or keyword generation using the Chrome AI Summarizer API.
+- Caching of detected language and summaries/keywords in localStorage to reduce redundant API calls (configurable for summarizer).
+- Configurable options for both language detection (e.g., confidence threshold) and summarization (e.g., type, format, length).
+- Flexible ORTB2 path configuration for placing detected data.
+- Ability to enable/disable each feature independently.
+- Compatible with the Prebid.js RTD framework.
+
+## Integration
+
+### Build Setup
+
+To include the Chrome AI RTD Provider in your Prebid.js build, use the following command:
+
+```bash
+gulp build --modules=rtdModule,chromeAiRtdProvider
+```
+
+### Basic Integration
+
+Add the Chrome AI RTD Provider to your Prebid.js configuration:
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      waitForIt: true  // Optional: delays the auction until language detection completes
+    }]
+  }
+});
+```
+
+### Advanced Configuration
+
+Configure language detection and summarization with additional options:
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      waitForIt: true, // Set to true if auction should wait for both enabled features
+      params: {
+        languageDetector: {
+          enabled: true,       // Set to false to disable language detection
+          confidence: 0.9,     // Set minimum confidence threshold (0.0 - 1.0)
+          ortb2Path: 'site.content.language' // Default path for language
+        },
+        summarizer: {
+          enabled: false,      // Set to true to enable summarization/keyword generation
+          type: 'headline',    // 'headline','key-points', 'tldr' or 'teaser'
+          format: 'markdown', // 'plain-text' or 'markdown'
+          length: 'short',     // 'short', 'medium', or 'long'
+          ortb2Path: 'site.content.keywords', // Path for summary/keywords
+          cacheInLocalStorage: true // Whether to cache generated summary/keywords
+        }
+      }
+    }]
+  }
+});
+```
+
+## Configuration Options
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Default |
+|-----------|-------|------|-------------|---------|
+| `waitForIt` | Optional | Boolean | Whether to delay auction for data retrieval | `false` |
+| `languageDetector.enabled` | Optional | Boolean | Enable or disable language detection | `true` |
+| `languageDetector.confidence` | Optional | Number | Minimum confidence threshold for detected language (0.0 - 1.0) | `0.8` |
+| `languageDetector.ortb2Path` | Optional | String | Path in ORTB2 to store the detected language | `'site.content.language'` |
+| `summarizer.enabled` | Optional | Boolean | Enable or disable summarization/keyword generation | `false` |
+| `summarizer.type` | Optional | String | Type of summary: `'headline'`, `'key-points'`, `'tldr'`, or `'teaser'` | `'headline'` |
+| `summarizer.format` | Optional | String | Format of the summary: `'plain-text'` or `'markdown'` | `'mark-down'` |
+| `summarizer.length` | Optional | String | Length of the summary: `'short'`, `'medium'`, or `'long'` | `'short'` |
+| `summarizer.ortb2Path` | Optional | String | Path in ORTB2 to store the generated summary/keywords | `'site.content.keywords'` |
+| `summarizer.cacheInLocalStorage` | Optional | Boolean | Whether to cache the generated summary/keywords in localStorage | `true` |
+
+## How It Works
+
+The module initializes configured features (language detection, summarization) asynchronously.
+
+### Language Detection (`languageDetector`)
+
+1. **Data Prioritization**: On initialization or when `getBidRequestData` is called, the module first checks for existing language information in this order:
+   - Auction-specific ORTB2 data (from `reqBidsConfigObj` passed to `getBidRequestData`).
+   - Data cached in localStorage for the current page URL (from a previous detection).
+2. **API Call**: If no language is found and the feature is enabled, it attempts to detect the language of the visible page content using the Chrome AI Language Detection API.
+   - The API's `availability()` method is checked. If 'unavailable', detection is skipped. If 'after-download', the module may proceed if the model downloads.
+3. **Data Handling**: The detected language (if it meets the confidence threshold) is:
+   - Stored in localStorage for future page loads on the same URL.
+   - Added to the OpenRTB bid requests at the configured `languageDetector.ortb2Path` (default: `site.content.language`).
+
+### Summarization / Keyword Generation (`summarizer`)
+
+1. **Data Prioritization**: Similar to language detection, it checks for existing summary/keywords:
+   - Auction-specific ORTB2 data.
+   - Data cached in localStorage (if `cacheInLocalStorage: true`).
+2. **API Call**: If no data is found and the feature is enabled, it attempts to generate a summary/keywords from the page content using the Chrome AI Summarizer API.
+   - The API's `availability()` method is checked. If 'unavailable', summarization is skipped. If 'after-download', the module may proceed.
+3. **Data Handling**: The generated summary/keywords are:
+   - Stored in localStorage (if `cacheInLocalStorage: true`).
+   - Added to the OpenRTB bid requests at the configured `summarizer.ortb2Path` (default: `site.content.keywords`).
+
+If `waitForIt: true` is set in the RTD config, the auction will be delayed until all enabled and available Chrome AI features complete their processing.
+
+## Browser Compatibility
+
+- The browser must support the Chrome AI APIs being used (Language Detection, Summarizer).
+- The specific Chrome AI models (e.g., for language detection or summarization) must be 'available' or become 'available-after-download'. The module handles these states.
+- Sufficient text content must be available on the page (minimum 20 characters for language detection and summarization).
+- If using the `waitForIt: true` option, consider the potential impact on auction latency.
+
+## Limitations
+
+- Relies on browser support for Chrome AI APIs.
+- Requires sufficient and meaningful visible text content on the page for accurate results.
+- Language detection may not be accurate for pages with multiple languages mixed together.
+- Summarization quality depends on the page content and the capabilities of the underlying Chrome AI model.
+
+## Browser Compatibility
+
+[Language Detector API Support](https://caniuse.com/mdn-api_languagedetector)
+## Example Use Cases
+
+### Standard Implementation
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      waitForIt: true
+    }]
+  }
+});
+```
+
+### Disable Language Detection for Specific Sites
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      params: {
+        languageDetector: {
+          enabled: false
+        }
+      }
+    }]
+  }
+});
+```
+
+### Higher Confidence Requirement for Language Detection
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      waitForIt: true,
+      params: {
+        languageDetector: {
+          enabled: true,
+          confidence: 0.95  // Only use high-confidence detections
+        }
+      }
+    }]
+  }
+});
+```
+
+### Enable Summarizer with Custom Settings
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'chromeAi',
+      waitForIt: true,
+      params: {
+        languageDetector: {
+          enabled: false // Example: only using summarizer
+        },
+        summarizer: {
+          enabled: true,
+          type: 'teaser',
+          format: 'markdown', // In markdown format
+          length: 'medium',
+          ortb2Path: 'site.ext.data.summary', // Custom ORTB2 path
+        }
+      }
+    }]
+  }
+});
+```

From 13972c0f962ae06cede4db9f04c1775d5d3dc0cc Mon Sep 17 00:00:00 2001
From: Ivan-Z-Oprx <izivkovic@optimizerx.com>
Date: Thu, 31 Jul 2025 22:31:40 +0200
Subject: [PATCH 268/665] oprx bidder adapter documentation (#6164)

* added documentation for oprx bidder adapter

* removed gpp_sids

* fixed lats newline char

* setting pbs to false for now

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/oprx.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 dev-docs/bidders/oprx.md

diff --git a/dev-docs/bidders/oprx.md b/dev-docs/bidders/oprx.md
new file mode 100644
index 0000000000..3aa40d163a
--- /dev/null
+++ b/dev-docs/bidders/oprx.md
@@ -0,0 +1,38 @@
+---
+layout: bidder
+title: OptimizeRx
+description: Prebid OptimizeRx Bidder Adapter
+biddercode: oprx
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+userId: none
+media_types: banner
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: true
+prebid_member: false
+multiformat_supported: will-not-bid
+ortb_blocking_supported: false
+privacy_sandbox: no
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description            | Example    | Type      |
+|---------------|----------|------------------------|------------|-----------|
+| `placementId` | required | Placement ID           | `11111`    | `integer` |
+| `key`         | required | Key                    | `'abc123'` | `string`  |
+| `width`       | optional | Banner Width           | `123`      | `integer` |
+| `height`      | optional | Banner Height          | `456`      | `integer` |
+| `bid_floor`   | optional | Bidding Price Floor    | `123.45`   | `number`  |
+| `npi`         | optional | NPI                    | `'22222'`  | `string`  |
+| `ndc`         | optional | NDC                    | `'33333'`  | `string`  |
+| `type`        | required | Type of Bid/Impression | `'banner'` | `string`  |

From d6a63b7a79ffaf825506bd3b87ec513e1d9b1e9c Mon Sep 17 00:00:00 2001
From: Kevin Siow <k.siow@passerelle.co>
Date: Fri, 1 Aug 2025 17:11:34 +0200
Subject: [PATCH 269/665] Dailymotion bid adapter: update contact email (#6185)

Co-authored-by: Kevin Siow <kevin.siow@dailymotion.com>
---
 dev-docs/bidders/dailymotion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/dailymotion.md b/dev-docs/bidders/dailymotion.md
index ff6a709018..a0743ff8d4 100644
--- a/dev-docs/bidders/dailymotion.md
+++ b/dev-docs/bidders/dailymotion.md
@@ -20,7 +20,7 @@ ortb_blocking_supported: false
 
 ### Registration
 
-To use the adapter with any non-test request, you first need to ask an API key from Dailymotion. Please contact us through <DailymotionPrebid.js@dailymotion.com> .
+To use the adapter with any non-test request, you first need to ask an API key from Dailymotion. Please contact us through <publishers@dailymotion.com> .
 
 This API key will ensure proper identification of your inventory and allow you to get real bids.
 

From c873b53d3acd521564976fda31067f3c7ba3e405 Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Fri, 1 Aug 2025 17:37:54 +0200
Subject: [PATCH 270/665] add banner support for showheroes (#6184)

* add banner support for showheroes

* fix lint issue
---
 dev-docs/bidders/showheroes-bs.md | 34 ++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes-bs.md
index 198ea27242..b1e0d47d70 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes-bs.md
@@ -4,7 +4,7 @@ title: ShowHeroes
 description: Prebid ShowHeroes Bidder Adapter
 pbjs: true
 biddercode: showheroes-bs
-media_types: video
+media_types: video, banner
 gvl_id: 111
 tcfeu_supported: true
 usp_supported: true
@@ -141,3 +141,35 @@ pbjs.que.push(function(){
 ```
 
 You could use this example and place it in the `test/pages/instream.html` example page inside the Prebid.js repository.
+
+#### banner
+
+Example of adunit configuration for banner ads:
+
+```javascript
+var pbjs = pbjs || {};
+pbjs.que = pbjs.que || [];
+var adUnits = [
+    {
+      code: 'div-gpt-ad-1460505748561-0',
+      mediaTypes: {
+          banner: {
+              sizes: [[300, 250]],
+          }
+        },
+        bids: [{
+            bidder: "showheroes-bs",
+            params: {
+                unitId: "1234abcd-5678efgh",
+            }
+        }],
+    }
+];
+pbjs.que.push(function () {
+    pbjs.setConfig({...});
+    pbjs.addAdUnits(adUnits);
+    pbjs.requestBids({ bidsBackHandler: sendAdServerRequest });
+})
+```
+
+You can use this example and place in the `hello_world` gpt integration test page

From 6253b627a7ecb8c493e62c13acae9842df5bd5ee Mon Sep 17 00:00:00 2001
From: Victor <103455651+victorlassomarketing@users.noreply.github.com>
Date: Fri, 1 Aug 2025 11:55:41 -0700
Subject: [PATCH 271/665] Update lasso adapter documentation aimonly (#6162)

* Lasso bid adapter

* Lasso adapter documentation update

* Lasso adapter documentation update

* Lasso prebid adapter

* fix for usp / ccpa

* fix ccpa and remove old value

* Update Lasso documentation

---------

Co-authored-by: Victor Romasenco <vic@Victors-Air.home>
Co-authored-by: Victor <vic@Victors-MacBook-Pro.local>
---
 dev-docs/bidders/lasso.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/lasso.md b/dev-docs/bidders/lasso.md
index 3c296a5d90..57fb1927aa 100644
--- a/dev-docs/bidders/lasso.md
+++ b/dev-docs/bidders/lasso.md
@@ -16,6 +16,7 @@ floors_supported: false
 fpd_supported: false
 multiformat_supported: will-not-bid
 sidebarType: 1
+gpp_sids: usnat, usstate_all, usp
 ---
 
 ### Note
@@ -25,6 +26,8 @@ The Lasso Bidding adapter requires setup before beginning. Please contact us at
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                      | Example                              | Type     |
+| Name | Scope | Description | Example | Type |
 |-------------|----------|----------------------------------|--------------------------------------|----------|
-| `adUnitId`      | required | Unique adUnitId from Lasso         | `'12345'`    | `string` |
+| `adUnitId` | required | Unique adUnitId from Lasso | `'12345'` | `string` |
+| `npi` | optional | | | `string` |
+| `aimOnly` | optional | | | `boolean` |

From da68a42bb7d0e333e0df4b64248b9b9fb868e0fa Mon Sep 17 00:00:00 2001
From: Pavlo Kavulych <72217414+Chucky-choo@users.noreply.github.com>
Date: Sat, 2 Aug 2025 10:47:38 +0300
Subject: [PATCH 272/665] Adipolo Bid Adapter: update tcfeu support (#6172)

* update tcfeu support

* add gvl_id
---
 dev-docs/bidders/adipolo.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/adipolo.md b/dev-docs/bidders/adipolo.md
index c5534ad67f..69fc4818c8 100644
--- a/dev-docs/bidders/adipolo.md
+++ b/dev-docs/bidders/adipolo.md
@@ -5,7 +5,8 @@ description: Adipolo Bidder Adapter
 biddercode: adipolo
 media_types: banner, video
 coppa_supported: true
-tcfeu_supported: false
+tcfeu_supported: true
+gvl_id: 1456
 usp_supported: true
 prebid_member: false
 pbjs: true

From d3036ae5bb463b5c15d2b9d06a48fda362f59762 Mon Sep 17 00:00:00 2001
From: khang-vu-ttd <109103626+khang-vu-ttd@users.noreply.github.com>
Date: Mon, 4 Aug 2025 02:47:12 -0700
Subject: [PATCH 273/665] custom endpoint doc update (#6151)

---
 dev-docs/bidders/ttd.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/ttd.md b/dev-docs/bidders/ttd.md
index 5c29b31048..b109cf5629 100644
--- a/dev-docs/bidders/ttd.md
+++ b/dev-docs/bidders/ttd.md
@@ -43,6 +43,7 @@ Name | Scope | Description | Example | Type
 `placementId` | optional | This field is optional if GPID is passed through the GPT module <https://docs.prebid.org/dev-docs/modules/gpt-pre-auction.html>. If that module isn't used, the GPID value should be passed in this field. | `'/1111/home#header'` | `String`
 `banner` | optional | Display banner targeting parameters. See the banner section below. | `{}` | `object`
 `bidfloor` | optional | Sets a bid floor price | `0.95` | `Float`
+`customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://customBidderEndpoint/bid/bidder/` | `String`
 
 ### Banner Object
 

From 9fb0dc7685220c509cce48297a28ab0615803bbf Mon Sep 17 00:00:00 2001
From: pm-tanishka-vishwakarma
 <54441656+pm-tanishka-vishwakarma@users.noreply.github.com>
Date: Tue, 5 Aug 2025 16:30:23 +0530
Subject: [PATCH 274/665] [Pubmatic]Document changes for formatting table of
 bid params and removing the item that is not required (#6182)

* removing the content which is not required

* Fixing css changes for the pubmatic bidders page

* changes for bid params table formatting and content formatting

* changes for bid params table formatting and content formatting

* fixing lint errors

* fixing lint errors

* do not use html directl

---------

Co-authored-by: Tanishka Vishwakarma <tanishkavishwakarma@L1837.local>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/pubmatic.md | 39 ++++++++++++++++--------------------
 1 file changed, 17 insertions(+), 22 deletions(-)

diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 1f7d27767e..e560c2057b 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -25,31 +25,26 @@ sidebarType: 1
 endpoint_compression: true
 ---
 
-### Prebid Server Note
-
-{% include dev-docs/pbjs-adapter-required-for-pbs.md %}
-
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-
-| Name          | Scope    | Description        | Example                      | Type     |
-|---------------|----------|--------------------|------------------------------|----------|
-| `publisherId` | required | Publisher ID       | `'32572'`                    | `string` |
-| `adSlot`      | optional | Ad Slot Name (see below)| `'38519891'`            | `string` |
-| `pmzoneid`    | optional | Zone ID            | `'zone1,zone2'`              | `string` |
-| `lat`         | optional | Latitude <br/> (Supported until Prebid version 7.54.4 and starting from Prebid version 8.11.0 we have option to configure this using ortb2.(device OR user))             | `'40.712775'`             | `string` |
-| `lon`         | optional | Longitude <br/> (Supported until Prebid version 7.54.4 and starting from Prebid version 8.11.0 we have option to configure this using ortb2.(device OR user))            | `'-74.005973'`            | `string` |
-| `yob`         | optional | Year of Birth      | `'1982'`                     | `string` |
-| `gender`      | optional | Gender             | `'M'`                        | `string` |
-| `kadpageurl`  | optional | Overrides Page URL |  `'http://www.yahoo.com/'`   | `string` |
-| `kadfloor`    | optional | Bid Floor          | `'1.75'`                     | `string` |
-| `currency`    | optional | Bid currency       | `'AUD'` (Value configured only in the 1st adunit will be passed on. <br/> Values if present in subsequent adunits, will be ignored.)                | `string` |
-| `dctr`        | optional | Deal Custom Targeting <br/> (Value configured in each adunit will be passed on inside adunit configs i.e. imp.ext), `'key1=123|key2=345'`                                | `string` |
-| `acat`        | optional | Allowed categories  <br/> (List of allowed categories for a given auction to be sent in either using ortb2 config (request.ext.prebid.bidderparams.pubmatic.acat) or using slot level params. If categories sent using both then priority will be given to ortb2 over slot level params.) | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]` | `array of strings` |
-| `bcat`        | optional | Blocked IAB Categories  <br/> (Values from all slots will be combined and only unique values will be passed. An array of strings only. Each category should be a string of a length of more than 3 characters.) | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]`     | `array of strings` |
-| `deals`       | optional | PMP deals  <br/> (Values from each slot will be passed per slot. An array of strings only. Each deal-id should be a string of a length of more than 3 characters.)       | `[ 'deal-id-5', 'deal-id-6', 'deal-id-7' ]`     | `array of strings` |
-| `outstreamAU` | optional | Oustream AdUnit described in Blue BillyWig UI. This field is mandatory if mimeType is described as video and context is outstream (i.e., for outstream videos)           | `'renderer_test_pubmatic'`           | `string` |
+| Name            | Scope    | Description                                                                                                                                                                                                                                                                       | Example                                                   | Type               |
+|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------|--------------------|
+| `publisherId`   | required | Publisher ID                                                                                                                                                                                                                                                                      | `'32572'`                                                 | `string`           |
+| `adSlot`        | optional | Ad Slot Name (see below)                                                                                                                                                                                                                                                           | `'38519891'`                                              | `string`           |
+| `pmzoneid`      | optional | Zone ID                                                                                                                                                                                                                                                                            | `'zone1,zone2'`                                           | `string`           |
+| `lat`           | optional | Latitude<br>Supported until Prebid version 7.54.4 and starting from version 8.11.0, can be configured using ortb2.device or ortb2.user                                                                                                                               | `'40.712775'`                                             | `string`           |
+| `lon`           | optional | Longitude<br>Supported until Prebid version 7.54.4 and starting from version 8.11.0, can be configured using ortb2.device or ortb2.user                                                                                                                             | `'-74.005973'`                                            | `string`           |
+| `yob`           | optional | Year of Birth                                                                                                                                                                                                                                                                     | `'1982'`                                                  | `string`           |
+| `gender`        | optional | Gender                                                                                                                                                                                                                                                                            | `'M'`                                                     | `string`           |
+| `kadpageurl`    | optional | Overrides Page URL                                                                                                                                                                                                                                                                | `'http://www.yahoo.com/'`                                 | `string`           |
+| `kadfloor`      | optional | Bid Floor                                                                                                                                                                                                                                                                         | `'1.75'`                                                  | `string`           |
+| `currency`      | optional | Bid currency<br><i>(Value configured only in the 1st adunit will be passed on. Values if present in subsequent adunits, will be ignored.)</i> | `'AUD'` | `string` |
+| `dctr`          | optional | Deal Custom Targeting<br><i>(Value configured in each adunit will be passed inside adunit configs i.e., imp.ext)</i>                                                                                                                                                             | `'key1=123\|key2=345'`                                     | `string`           |
+| `acat`          | optional | Allowed categories<br><i>(Can be sent via ortb2 or slot-level params. If both are present, ortb2 takes priority.)</i>                                                                                                                                                            | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]`                         | `array of strings` |
+| `bcat`          | optional | Blocked IAB Categories<br><i>(Combined across all slots, unique values only. Each must be a string with more than 3 characters.)</i>                                                                                                                                                      | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]`                         | `array of strings` |
+| `deals`         | optional | PMP deals<br><i>(Passed per slot. Each deal-id should be a string with more than 3 characters.)</i>                                                                                                                                                                                         | `[ 'deal-id-5', 'deal-id-6', 'deal-id-7' ]`               | `array of strings` |
+| `outstreamAU`   | optional | Outstream AdUnit described in Blue BillyWig UI *(Required if mimeType is video and context is outstream)*                                                                                                                                                                 | `'renderer_test_pubmatic'`                                | `string`           |
 
 ### Configuration
 

From 063cb5843d51e1705b521bc91a10405c1e74ec43 Mon Sep 17 00:00:00 2001
From: "Adserver.Online" <61009237+adserver-online@users.noreply.github.com>
Date: Tue, 5 Aug 2025 14:52:20 +0300
Subject: [PATCH 275/665] Add Adklip adapter (#6189)

Co-authored-by: dev <dev@adsrv.org>
---
 dev-docs/bidders/adklip.md | 44 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 dev-docs/bidders/adklip.md

diff --git a/dev-docs/bidders/adklip.md b/dev-docs/bidders/adklip.md
new file mode 100644
index 0000000000..f0b5acf235
--- /dev/null
+++ b/dev-docs/bidders/adklip.md
@@ -0,0 +1,44 @@
+---
+layout: bidder
+title: Adklip
+description: Adklip Bid Adapter
+biddercode: adklip
+tcfeu_supported: false
+usp_supported: true
+media_types: video, native
+safeframes_ok: true
+pbjs: true
+pbs: true
+pbs_app_supported: true
+floors_supported: true
+schain_supported: true
+fpd_supported: true
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+userIds: all
+sidebarType: 1
+aliasCode: aso
+---
+### Note
+
+The Adklip adapter requires approval and setup. Please reach out to <george@adklip.com> or visit us at [adklip.com](https://adklip.com) for more details.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description      | Example                     | Type      |
+|---------------|----------|------------------|-----------------------------|-----------|
+| `server`      | required | Server endpoint  | `https://srv.adklip.net`    | `String`  |
+| `zone`        | required | Zone ID          | `73815`                     | `Integer` |
+
+#### Video Caching
+
+Note that the Adklip adapter expects a client-side Prebid Cache to be enabled for video bidding.
+
+```js
+pbjs.setConfig({
+    cache: {
+        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+    }
+});
+```

From 7ed006eba0cb9df7b5fa44c035c0d2e2d31cdbca Mon Sep 17 00:00:00 2001
From: tomaskoutny-blis <60094686+tomaskoutny-blis@users.noreply.github.com>
Date: Wed, 6 Aug 2025 21:58:52 +0200
Subject: [PATCH 276/665] New Adapter: Blis (#5994)

* Blis: Add adapter documentation

* Blis: Add adapter documentation

* Blis: Update adapter documentation - gpp_sids

* Blis: Update adapter documentation - userId

---------

Co-authored-by: Tomas Koutny <tomas@blis.com>
---
 dev-docs/bidders/blis.md | 41 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/blis.md

diff --git a/dev-docs/bidders/blis.md b/dev-docs/bidders/blis.md
new file mode 100644
index 0000000000..0555f34539
--- /dev/null
+++ b/dev-docs/bidders/blis.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: blis
+description: Prebid Blis Bidder Adapter
+biddercode: blis
+tcfeu_supported: true
+gvl_id: 94
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usnat, usp
+schain_supported: true
+dchain_supported: false
+userId: adserver, liveramp, sharedid, pubcid, id5-sync, criteo, quantcast
+media_types: banner, video, native
+safeframes_ok: false
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: false
+pbs: true
+pbs_app_supported: true
+prebid_member: true
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: partial
+privacy_sandbox: no
+---
+
+### Registration
+
+Blis adapter requires setup before beginning. Please contact us at <supply@blis.com>.
+
+### ORTB Blocking
+
+Blis bidder supports bcat, badv and battr.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                               | Example   | Type     |
+|---------------|----------|-------------------------------------------|-----------|----------|
+| `spid`        | required | Unique supply partner ID provided by Blis | `'999'` | `string` |

From 0d8e28b4dfa521fe9370129c08ab403e779336ad Mon Sep 17 00:00:00 2001
From: Pat Diggins <89027546+PBDMSFT@users.noreply.github.com>
Date: Tue, 12 Aug 2025 16:07:17 -0400
Subject: [PATCH 277/665] cache-reference-cleanup (#6200)

---
 _includes/video/pb-is-jw01.html                        |  2 +-
 _includes/video/pb-is-jw02.html                        |  2 +-
 _includes/video/pb-is-vjs.html                         |  2 +-
 _includes/video/pb-lf-fw.html                          |  2 +-
 adops/setting-up-prebid-video-in-freewheel.md          |  6 +++---
 assets/js/video/pb-ve-jwplayer-platform-h.js           |  2 +-
 dev-docs/bidders/adklip.md                             |  2 +-
 dev-docs/bidders/aso.md                                |  2 +-
 dev-docs/bidders/bcmint.md                             |  2 +-
 dev-docs/bidders/bidgency.md                           |  2 +-
 dev-docs/bidders/consumable-server.md                  |  2 +-
 dev-docs/bidders/consumable.md                         |  2 +-
 dev-docs/bidders/cordless.md                           |  2 +-
 dev-docs/bidders/epsilon.md                            |  2 +-
 dev-docs/bidders/kuantyx.md                            |  2 +-
 dev-docs/bidders/pubmatic.md                           |  2 +-
 dev-docs/bidders/showheroes-bs.md                      |  2 +-
 dev-docs/bidders/visx.md                               |  2 +-
 dev-docs/plugins/bc/bc-prebid-plugin-api.md            |  2 +-
 .../plugins/bc/bc-prebid-plugin-integration-studio.md  |  4 ++--
 .../plugins/bc/bc-prebid-plugin-multiad-options.md     | 10 +++++-----
 ...-plugin-sample-studio-integration-general-method.md |  2 +-
 .../video/instream/jwplayer/pb-ve-jwplayer-hosted.html |  2 +-
 .../instream/jwplayer/pb-ve-jwplayer-platform.html     |  2 +-
 .../videoModule/videojs/video-module-videojs.html      |  4 ++--
 examples/video/instream/videojs/pb-ve-videojs.html     |  2 +-
 .../long-form/long-form-video-with-freewheel.html      |  2 +-
 27 files changed, 35 insertions(+), 35 deletions(-)

diff --git a/_includes/video/pb-is-jw01.html b/_includes/video/pb-is-jw01.html
index f5c3c3bf94..a96915d12d 100644
--- a/_includes/video/pb-is-jw01.html
+++ b/_includes/video/pb-is-jw01.html
@@ -44,7 +44,7 @@
         pbjs.setConfig({
           debug: true,
           cache: {
-            url: "https://prebid.adnxs.com/pbc/v1/cache",
+            url: "https://prebid.example.com/pbc/v1/cache",
           },
         });
 
diff --git a/_includes/video/pb-is-jw02.html b/_includes/video/pb-is-jw02.html
index 0db58fb5a5..8162a69928 100644
--- a/_includes/video/pb-is-jw02.html
+++ b/_includes/video/pb-is-jw02.html
@@ -48,7 +48,7 @@
         pbjs.setConfig({
           debug: true,
           cache: {
-            url: "https://prebid.adnxs.com/pbc/v1/cache",
+            url: "https://prebid.example.com/pbc/v1/cache",
           },
         });
 
diff --git a/_includes/video/pb-is-vjs.html b/_includes/video/pb-is-vjs.html
index fe351b8694..bdedf89b65 100644
--- a/_includes/video/pb-is-vjs.html
+++ b/_includes/video/pb-is-vjs.html
@@ -65,7 +65,7 @@
         pbjs.setConfig({
           debug: true,
           cache: {
-            url: "https://prebid.adnxs.com/pbc/v1/cache",
+            url: "https://prebid.example.com/pbc/v1/cache",
           },
         });
 
diff --git a/_includes/video/pb-lf-fw.html b/_includes/video/pb-lf-fw.html
index 8b51be86bc..b40c5d204d 100644
--- a/_includes/video/pb-lf-fw.html
+++ b/_includes/video/pb-lf-fw.html
@@ -95,7 +95,7 @@
         pbjs.setConfig({
           debug: true,
           cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://prebid.example.com/pbc/v1/cache'
           },
           adpod: {
             brandCategoryExclusion: true
diff --git a/adops/setting-up-prebid-video-in-freewheel.md b/adops/setting-up-prebid-video-in-freewheel.md
index af72d98d43..a0a9ade18e 100644
--- a/adops/setting-up-prebid-video-in-freewheel.md
+++ b/adops/setting-up-prebid-video-in-freewheel.md
@@ -136,7 +136,7 @@ The scheme, host, and path should point to your Prebid Server cache. For instanc
 utilize Xandr's AppNexus cache:
 
 ```text
-https://prebid.adnxs.com/pbc/v1/cache
+https://prebid.example.com/pbc/v1/cache
 ```
 
 The query should have one key-value items:
@@ -152,13 +152,13 @@ The second macro, `#{request.keyValue(“hb_cache_id”)`, formats the unique Pr
 In real-time, when the dynamic URL is formatted it will appear like:
 
 ```text
-https://prebid.adnxs.com/pbc/v1/cache?uuid=12.00_391_30s_6c422e51-46cf-4b0a-ae41-64c61c1ca125
+https://prebid.example.com/pbc/v1/cache?uuid=12.00_391_30s_6c422e51-46cf-4b0a-ae41-64c61c1ca125
 ```
 
 In order for the above URL to format correctly ensure that the URL in the text box appears as:  
 
 ```text
-https://prebid.adnxs.com/pbc/v1/cache?uuid=#{ad.placement.name}_#{request.keyValue("hb_cache_id")}
+https://prebid.example.com/pbc/v1/cache?uuid=#{ad.placement.name}_#{request.keyValue("hb_cache_id")}
 ```
 
 Your ad ops should now be completed and set up for premium long-form video.
diff --git a/assets/js/video/pb-ve-jwplayer-platform-h.js b/assets/js/video/pb-ve-jwplayer-platform-h.js
index 5c66b7ef33..eed52dd020 100644
--- a/assets/js/video/pb-ve-jwplayer-platform-h.js
+++ b/assets/js/video/pb-ve-jwplayer-platform-h.js
@@ -35,7 +35,7 @@ function loadVideoData() {
         pbjs.setConfig({
             debug: true,
             cache: {
-                url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                url: 'https://prebid.example.com/pbc/v1/cache'
             }
         });
 
diff --git a/dev-docs/bidders/adklip.md b/dev-docs/bidders/adklip.md
index f0b5acf235..08e2f660ce 100644
--- a/dev-docs/bidders/adklip.md
+++ b/dev-docs/bidders/adklip.md
@@ -38,7 +38,7 @@ Note that the Adklip adapter expects a client-side Prebid Cache to be enabled fo
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/aso.md b/dev-docs/bidders/aso.md
index 3f87d72d84..cdd6ff6bf4 100644
--- a/dev-docs/bidders/aso.md
+++ b/dev-docs/bidders/aso.md
@@ -58,7 +58,7 @@ Note that the Adserver.Online adapter expects a client-side Prebid Cache to be e
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/bcmint.md b/dev-docs/bidders/bcmint.md
index 2fd3001dac..b5126cc3ab 100644
--- a/dev-docs/bidders/bcmint.md
+++ b/dev-docs/bidders/bcmint.md
@@ -38,7 +38,7 @@ Note that the BCM International adapter expects a client-side Prebid Cache to be
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/bidgency.md b/dev-docs/bidders/bidgency.md
index 541557fc33..e5617a3c7e 100644
--- a/dev-docs/bidders/bidgency.md
+++ b/dev-docs/bidders/bidgency.md
@@ -38,7 +38,7 @@ Note that the Bidgency Group adapter expects a client-side Prebid Cache to be en
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/consumable-server.md b/dev-docs/bidders/consumable-server.md
index cca8613e45..9643324237 100644
--- a/dev-docs/bidders/consumable-server.md
+++ b/dev-docs/bidders/consumable-server.md
@@ -125,7 +125,7 @@ To call Consumable from a web browser using Prebid Server, you must first config
    ```javascript
     pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://prebid.example.com/pbc/v1/cache'
         }
     });
    ```
diff --git a/dev-docs/bidders/consumable.md b/dev-docs/bidders/consumable.md
index 3737f7f9a0..99097d9c80 100644
--- a/dev-docs/bidders/consumable.md
+++ b/dev-docs/bidders/consumable.md
@@ -125,7 +125,7 @@ In this configuration, Prebid.js makes a call to Prebid Server and then Prebid S
    ```javascript
     pbjs.setConfig({
         cache: {
-                url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                url: 'https://prebid.example.com/pbc/v1/cache'
             }
     });
     ```
diff --git a/dev-docs/bidders/cordless.md b/dev-docs/bidders/cordless.md
index d62f5623e2..ecf23ae02f 100644
--- a/dev-docs/bidders/cordless.md
+++ b/dev-docs/bidders/cordless.md
@@ -38,7 +38,7 @@ Note that the Cordless.co adapter expects a client-side Prebid Cache to be enabl
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/epsilon.md b/dev-docs/bidders/epsilon.md
index aca745d176..28f2b72162 100644
--- a/dev-docs/bidders/epsilon.md
+++ b/dev-docs/bidders/epsilon.md
@@ -89,7 +89,7 @@ Example first party data configuration that is available to all adUnits
 pbjs.setConfig({
     debug: true,
     cache: {
-    url: 'https://prebid.adnxs.com/pbc/v1/cache'
+    url: 'https://prebid.example.com/pbc/v1/cache'
     },
     ortb2: { 
         site: { 
diff --git a/dev-docs/bidders/kuantyx.md b/dev-docs/bidders/kuantyx.md
index 29855cc2a9..0ef34cd903 100644
--- a/dev-docs/bidders/kuantyx.md
+++ b/dev-docs/bidders/kuantyx.md
@@ -38,7 +38,7 @@ Note that the Kuantyx adapter expects a client-side Prebid Cache to be enabled f
 ```js
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index e560c2057b..873b0d36b6 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -178,7 +178,7 @@ For Video ads, prebid cache needs to be enabled for PubMatic adapter.
 ```javascript
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+        url: 'https://prebid.example.com/pbc/v1/cache'
     }
 });
 ```
diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes-bs.md
index b1e0d47d70..9a07f39efa 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes-bs.md
@@ -126,7 +126,7 @@ pbjs.que.push(function(){
     pbjs.addAdUnits(videoAdUnit);
     pbjs.setConfig({
                 cache: {
-                    url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                    url: 'https://prebid.example.com/pbc/v1/cache'
                 },
                 ...,
             });
diff --git a/dev-docs/bidders/visx.md b/dev-docs/bidders/visx.md
index 6f10388ad8..27f1fe2189 100644
--- a/dev-docs/bidders/visx.md
+++ b/dev-docs/bidders/visx.md
@@ -87,7 +87,7 @@ The YOC VIS.X Prebid.js adapter responds with VAST XML (in the `vastXml` field)
 ```javascript
 pbjs.setConfig({
         cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://prebid.example.com/pbc/v1/cache'
         }
 });
 ```
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-api.md b/dev-docs/plugins/bc/bc-prebid-plugin-api.md
index 1225dab7a0..d9be241b21 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-api.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-api.md
@@ -130,7 +130,7 @@ If the results of the prebid process is being determined outside of the plugin,
         }]
     },
     "prebidConfigOptions": {
-        "cache": {"url": "https://prebid.adnxs.com/pbc/v1/cache"},
+        "cache": {"url": "https://prebid.example.com/pbc/v1/cache"},
     "   enableSendAllBids": true
     },
     "prebidTimeout": 700,
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md b/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
index 1dd031a918..d7f53f6e03 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
@@ -150,7 +150,7 @@ var adOptions =
         }]
     },
     "prebidConfigOptions": {
-        "cache": {"url": "https://prebid.adnxs.com/pbc/v1/cache"},
+        "cache": {"url": "https://prebid.example.com/pbc/v1/cache"},
         "enableSendAllBids": true
     },
     "prebidTimeout": 700,
@@ -353,7 +353,7 @@ None
     },
     "prebidConfigOptions": {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids": true
     },
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md b/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
index f4ea87f6aa..7edbfcf383 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
@@ -109,7 +109,7 @@ The following is a sample JSON definition of the plugin configuration defining c
     },
     "prebidConfigOptions" : {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids" : true
     },
@@ -204,7 +204,7 @@ The following is a sample JSON definition of the plugin configuration defining c
     },
     "prebidConfigOptions" : {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids" : true
     },
@@ -310,7 +310,7 @@ The following is a sample JSON definition of the plugin configuration defining c
     },
     "prebidConfigOptions" : {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids" : true
     },
@@ -406,7 +406,7 @@ The following is a sample JSON definition of the plugin configuration defining c
     },
     "prebidConfigOptions" : {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids" : true
     },
@@ -502,7 +502,7 @@ The following is a sample JSON definition of the plugin configuration defining c
     },
     "prebidConfigOptions" : {
         "cache": {
-            "url": "https://prebid.adnxs.com/pbc/v1/cache"
+            "url": "https://prebid.example.com/pbc/v1/cache"
         },
         "enableSendAllBids" : true
     },
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md b/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
index 38f81618fd..6f6ca02132 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
@@ -72,7 +72,7 @@ This page presents a sample publisher page using the General Integration Method
             }]
         },
         "prebidConfigOptions": {
-         "cache": {"url": "https://prebid.adnxs.com/pbc/v1/cache"},
+         "cache": {"url": "https://prebid.example.com/pbc/v1/cache"},
         "enableSendAllBids": true
         },
         "prebidTimeout": 700,
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
index ee2caebd3a..67ab3e318d 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
@@ -86,7 +86,7 @@ <h4>Place this code in the page header.</h4>
         pbjs.setConfig({
             debug: true,
             cache: {
-                url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                url: 'https://prebid.example.com/pbc/v1/cache'
             }
         });
 
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
index 693aea6b2f..64f06968ec 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
@@ -88,7 +88,7 @@ <h4>Place this code in the page header.</h4>
           pbjs.setConfig({
               debug: true,
               cache: {
-                  url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                  url: 'https://prebid.example.com/pbc/v1/cache'
               }
           });
 
diff --git a/examples/video/instream/videoModule/videojs/video-module-videojs.html b/examples/video/instream/videoModule/videojs/video-module-videojs.html
index 739c783568..bcfd598fc0 100644
--- a/examples/video/instream/videoModule/videojs/video-module-videojs.html
+++ b/examples/video/instream/videoModule/videojs/video-module-videojs.html
@@ -114,7 +114,7 @@ <h4>Place this code in the page header.</h4>
                         },]
                     },
                     cache: {
-                        url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                        url: 'https://prebid.example.com/pbc/v1/cache'
                     },
                     targetingControls: {
                         allowTargetingKeys: ['BIDDER', 'AD_ID', 'PRICE_BUCKET', 'SIZE', 'DEAL', 'SOURCE', 'FORMAT', 'UUID', 'CACHE_ID', 'CACHE_HOST', 'ADOMAIN']
@@ -227,7 +227,7 @@ <h4>Place this code in the page body.</h4>
         ],
       },
       cache: {
-        url: "https://prebid.adnxs.com/pbc/v1/cache",
+        url: "https://prebid.example.com/pbc/v1/cache",
       },
       targetingControls: {
         allowTargetingKeys: [
diff --git a/examples/video/instream/videojs/pb-ve-videojs.html b/examples/video/instream/videojs/pb-ve-videojs.html
index 9d9daa2c4e..24ded8fe3b 100644
--- a/examples/video/instream/videojs/pb-ve-videojs.html
+++ b/examples/video/instream/videojs/pb-ve-videojs.html
@@ -97,7 +97,7 @@ <h4>Place this code in the page header.</h4>
           pbjs.setConfig({
               debug: true,
               cache: {
-                  url: 'https://prebid.adnxs.com/pbc/v1/cache'
+                  url: 'https://prebid.example.com/pbc/v1/cache'
               }
           });
 
diff --git a/examples/video/long-form/long-form-video-with-freewheel.html b/examples/video/long-form/long-form-video-with-freewheel.html
index 5d9324187d..28f5e06c6b 100644
--- a/examples/video/long-form/long-form-video-with-freewheel.html
+++ b/examples/video/long-form/long-form-video-with-freewheel.html
@@ -81,7 +81,7 @@
         pbjs.setConfig({
           debug: true,
           cache: {
-            url: 'https://prebid.adnxs.com/pbc/v1/cache'
+            url: 'https://prebid.example.com/pbc/v1/cache'
           },
           adpod: {
             brandCategoryExclusion: true

From 756978f46b2562c3ee1679df34e3a43de9b1bfc0 Mon Sep 17 00:00:00 2001
From: Eugene Dorfman <eugene.dorfman@gmail.com>
Date: Tue, 12 Aug 2025 22:07:51 +0200
Subject: [PATCH 278/665] fix optable module code to optableRtdProvider (#6206)

otherwise if selected on the Download Prebid.js page - it tries to include a non-existant module `optable` and fails the build
---
 dev-docs/modules/optableRtdProvider.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/optableRtdProvider.md b/dev-docs/modules/optableRtdProvider.md
index f65daa1809..79c42fb4ba 100644
--- a/dev-docs/modules/optableRtdProvider.md
+++ b/dev-docs/modules/optableRtdProvider.md
@@ -5,7 +5,7 @@ display_name: Optable RTD Module
 description: Optable Real Time Data Module
 page_type: module
 module_type: rtd
-module_code : optable
+module_code : optableRtdProvider
 enable_download : true
 vendor_specific: true
 sidebarType : 1

From a744f0fd4160c515bf76a1fc58fbcd2d4055d63f Mon Sep 17 00:00:00 2001
From: Rafael Taveira <103446145+rafataveira@users.noreply.github.com>
Date: Tue, 12 Aug 2025 15:08:21 -0500
Subject: [PATCH 279/665] Nativo: Fixing typo (#6205)

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

diff --git a/dev-docs/bidders/nativo.md b/dev-docs/bidders/nativo.md
index 5e39ab73fa..faf18bf1f2 100644
--- a/dev-docs/bidders/nativo.md
+++ b/dev-docs/bidders/nativo.md
@@ -30,7 +30,7 @@ Prebid Server primarily relies on the OpenRTB specification for its field defini
 | Name                         | Scope                               | Description                                                                                                                | Example                                             | Type      |
 |------------------------------|-------------------------------------|----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|-----------|
 | `imp.tagid`                  | required - preferred                | Represents the Ad Slot Tag ID, which is the primary identifier linked to a specific placement ID within the Nativo platform.  Read more about [tagid in the oRTB 2.6 docs](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#324---object-imp-) |  `placement_tagid_example`                          | `string`  |
-| `imp.ext.nativo.placementid` | required if no tagID                | Refers to the unique Placement ID assigned by the Nativo platform.                                                         |  `12345678`                                         | `integer` |
+| `imp.ext.nativo.placementId` | required if no tagID                | Refers to the unique Placement ID assigned by the Nativo platform.                                                         |  `12345678`                                         | `integer` |
 | `imp.ext.gpid`               | required if no other ID is provided | Represents the Ad Slot GP ID. It is another layer of identification tied to a placement ID within the Nativo platform. Read more about [gpid in the prebid docs](/features/pbAdSlot.html#the-gpid)       |  `/22888152279/publication/placement/gpid_example`  | `string`  |
 
 #### Prebid JS

From c82df8e6648d77aa0a110cdfb26204df1e9095fc Mon Sep 17 00:00:00 2001
From: Jeff Mahoney <jeff.t.mahoney@gmail.com>
Date: Tue, 12 Aug 2025 16:16:48 -0400
Subject: [PATCH 280/665] Sharethrough Bid Adapter: add documentation for new
 bidder param (#6199)

---
 dev-docs/bidders/sharethrough.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/sharethrough.md b/dev-docs/bidders/sharethrough.md
index a66a08b91e..637817d201 100644
--- a/dev-docs/bidders/sharethrough.md
+++ b/dev-docs/bidders/sharethrough.md
@@ -28,11 +28,12 @@ The Sharethrough bidder adapter requires additional setup and approval from the
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                                                | Example                      | Type                 |
-|-------------|----------|------------------------------------------------------------|------------------------------|----------------------|
-| `pkey`      | required | The placement key                                          | `'DfFKxpkRGPMS7A9f71CquBgZ'` | `string`             |
-| `bcat`      | optional | (deprecated) Array of blocked IAB Categories               | `['IAB1-2', 'IAB1-3']`       | `string[]`           |
-| `badv`      | optional | (deprecated) Array of blocked Advertisers by their domains | `['ford.com', 'pepsi.com']`  | `string[]`           |
+| Name            | Scope    | Description                                                                   | Example                      | Type                 |
+|-----------------|----------|-------------------------------------------------------------------------------|------------------------------|----------------------|
+| `pkey`          | required | The placement key                                                             | `'DfFKxpkRGPMS7A9f71CquBgZ'` | `string`             |
+| `bcat`          | optional | (deprecated) Array of blocked IAB Categories                                  | `['IAB1-2', 'IAB1-3']`       | `string[]`           |
+| `badv`          | optional | (deprecated) Array of blocked Advertisers by their domains                    | `['ford.com', 'pepsi.com']`  | `string[]`           |
+| `eqtvNetworkId` | optional | Optional parameter to have bid requests directed to the Equativ exchange      | `4004`                       | `integer`            |
 
 **Note**: Providing `bcat` and `badv` via Bid Params is deprecated, the First Party Data method should be preferred (see below).
 When both methods are provided (i.e. when `badv` and `bcat` are specified both as bid params and through the first party ortb2 method), first party data values will be used and bid param values will be ignored.

From 6b7d9b74bfd283ee7520ee9df07e4d0887d4b824 Mon Sep 17 00:00:00 2001
From: vivekyadav15 <vivek.yada@media.net>
Date: Wed, 13 Aug 2025 01:48:22 +0530
Subject: [PATCH 281/665] Modify medianet doc (#6197)

* MODIFY medianet bidder doc with latest supported features

* UPDATE userIds feature for medianet
---
 dev-docs/bidders/medianet.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/medianet.md b/dev-docs/bidders/medianet.md
index bac0729c69..383d449526 100644
--- a/dev-docs/bidders/medianet.md
+++ b/dev-docs/bidders/medianet.md
@@ -7,8 +7,7 @@ tcfeu_supported: true
 media_types: banner,native,video
 usp_supported: true
 coppa_supported: true
-gpp_supported: true
-userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
+userIds: all
 prebid_member: true
 pbjs: true
 gvl_id: 142
@@ -16,6 +15,16 @@ schain_supported: true
 floors_supported: true
 pbs: true
 sidebarType: 1
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+safeframes_ok: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+dsa_supported: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: true
+privacy_sandbox: paapi, topics
+endpoint_compression: false
 ---
 
 ### Bid Params

From 28a378d3bb48eef9278b2553f164c28b2643de9a Mon Sep 17 00:00:00 2001
From: ksieg-equativ <ksieg@smartadserver.com>
Date: Tue, 12 Aug 2025 22:18:41 +0200
Subject: [PATCH 282/665] Update documentation URL (#6196)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* SADR-6590: initial documentation for Equativ JS bid adapter

* SADR-6590: doc refinements

* Update equativ.md

SADR-6590: adjustments to doc from review feedback.

* SADR-6590: fix linting issues

* SADR-6590: another linting issue

* update app.publisher.id

* SADR-6590: providing link to Equativ OpenRTB API documentation

* SADR-6590: providing additional required fields for documentation

* SADR-6590: adding peer answers to questions

* SADR-6590: remove FPD section for now

* Equativ: updating documentation on bid adapter parameter requirements

* SADR-6882: expanding documentation with additional examples

* update features

* added info about first party data

* add examples

* Update documentation URL

---------

Co-authored-by: Jeff Mahoney <jeff.t.mahoney@gmail.com>
Co-authored-by: Krzysztof Sokół <ksokol@smartadserver.com>
Co-authored-by: Krzysztof Sokół <88041828+krzysztofequativ@users.noreply.github.com>
---
 dev-docs/bidders/equativ.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index c6f5b27625..9afd1433d0 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -569,4 +569,4 @@ Publishers should use the `ortb2` method of setting [First Party Data](https://d
 
 ### Additional Resources
 
-Information about how Equativ supports the oRTB specification, along with additional examples, can be found [on our OpenRTB API support site](https://help.smartadserver.com/s/article/OpenRTB-API-for-suppliers-Bid-request-specification-Part-1).
+Information about how Equativ supports the oRTB specification, along with additional examples, can be found [on our OpenRTB API support site](https://help.equativ.com/open-rtb-api-integration-bid-request-specification-1).

From 520f906b4d9648f10eca3587a3b9fcd17bfedf82 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Tue, 12 Aug 2025 22:19:04 +0200
Subject: [PATCH 283/665] Typo in floors.md (#6195)

---
 dev-docs/modules/floors.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index 0302c07c51..0bc7b02a33 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -1434,7 +1434,7 @@ Below is a chart explaining the behavior of currency conversion, if necessary, w
 | bid.currency | bid.originalCurrency | floor.currency | result |
 |---+---+---+---+---|
 | USD | USD | USD | Bid.cpm is compared to floor. If bid meets or exceeds the floor, bid.originalCpm is sent to the ad server. |
-| USD | USD | EUR | Bid.cpm is converted to EUR then compared with floor. If bid meets or exceeds the floor, bid.originaCpm is sent to the ad server. |
+| USD | USD | EUR | Bid.cpm is converted to EUR then compared with floor. If bid meets or exceeds the floor, bid.originalCpm is sent to the ad server. |
 | USD | EUR | EUR | bid.originalCpm is compared to floor. If bid meets or exceeds the floor, bid.Cpm is sent to the ad server. |
 | USD | JPY | EUR | Bid.cpm is converted to EUR then compared with floor.  If bid meets or exceeds the floor, bid.Cpm is sent to the ad server. |
 | EUR | USD | EUR | Bid.cpm is compared to floor. If bid meets or exceeds the floor, bid.Cpm is sent to the ad server. |

From d5efa3fc0e1d37a5fbec658ec832a05cb7b36061 Mon Sep 17 00:00:00 2001
From: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Date: Tue, 12 Aug 2025 23:19:51 +0300
Subject: [PATCH 284/665] AGT-659: partnerClientId documentation (#15) (#6194)

* AGT-659: ppid doc

* AGT-659: Fix doc

Co-authored-by: dmytro-po <dmytro.po@intentiq.com>
---
 dev-docs/modules/userid-submodules/intentiq.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index adc47a0ebd..6d3edae966 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -39,7 +39,8 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | name                           | Required | String   | The name of this module: "intentIqId"                                                                                                                                                                                                                                                                                                     | `"intentIqId"`                                |
 | params                         | Required | Object   | Details for IntentIqId initialization.                                                                                                                                                                                                                                                                                                    |                                               |
 | params.partner                 | Required | Number   | This is the partner ID value obtained from registering with IntentIQ.                                                                                                                                                                                                                                                                     | `1177538`                                     |
-| params.pcid                    | Optional | String   | This is the partner cookie ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                                             | `"g3hC52b"`                                   |
+| params.partnerClientId | Optional | String | A specific user identifier that should be dynamically initialized by the partner. | `"client-id"` |
+| params.partnerClientIdType | Optional | Number | Specifies the type of the partnerClientId. Possible values: `0` – 3rd-party cookie, `1` – IDFV (Identifier for Vendor on iOS), `3` – First-party ID, `4` – MAID / AAID (Mobile Advertising ID for Android/iOS) | `0` |
 | params.pai                     | Optional | String   | This is the partner customer ID / advertiser ID, it is a dynamic value attached to the request.                                                                                                                                                                                                                                           | `"advertiser1"`                               |
 | params.callback                | Optional | Function | This is a callback which is triggered with data                                                                                                                                                                                                                                                                               | `(data) => console.log({ data })` |
 | params.timeoutInMillis         | Optional | Number   | This is the timeout in milliseconds, which defines the maximum duration before the callback is triggered. The default value is 500.                                                                                                                                                                                                       | `450`                                         |

From 4ba7146d66b1c3ba4158ff681de0135910ea50a9 Mon Sep 17 00:00:00 2001
From: hamper <hamper.nhs@gmail.com>
Date: Tue, 12 Aug 2025 23:20:42 +0300
Subject: [PATCH 285/665] add digitalcaramel adapter (#6193)

---
 dev-docs/bidders/digitalcaramel.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 dev-docs/bidders/digitalcaramel.md

diff --git a/dev-docs/bidders/digitalcaramel.md b/dev-docs/bidders/digitalcaramel.md
new file mode 100644
index 0000000000..797a1b1d9a
--- /dev/null
+++ b/dev-docs/bidders/digitalcaramel.md
@@ -0,0 +1,27 @@
+---
+layout: bidder
+title: Digitalcaramel
+description: digitalcaramel bid adapter
+pbjs: true
+biddercode: digitalcaramel
+media_types: banner, video
+safeframes_ok: true
+tcfeu_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
+multiformat_supported: will-bid-on-one
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description   | Example                  | Type     |
+|---------------|----------|---------------|--------------------------|----------|
+| `siteId`      | required | Site id       | `'d1d83nbdi0fs73874a0g'` | `string` |
+| `placementId` | required | Placement id  | `'d1d8493di0fs73874a10'` | `string` |

From 33983d179b8ee2dff23030383a26f9c54c577402 Mon Sep 17 00:00:00 2001
From: pritishmd-talentica
 <159415077+pritishmd-talentica@users.noreply.github.com>
Date: Sun, 17 Aug 2025 11:49:05 +0530
Subject: [PATCH 286/665] RiseMediaTech Bidder Documentation : New Bidder
 Adapter (#6150)

* RM-880 : Wrote a dev documentation for new bidder adapter for risemedia

* Modified the docs

* Minor changes

* Minor modifications

* Minor changes

* resolved linting errors

* set false to user_sync for now
---
 dev-docs/bidders/risemediatech.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 dev-docs/bidders/risemediatech.md

diff --git a/dev-docs/bidders/risemediatech.md b/dev-docs/bidders/risemediatech.md
new file mode 100644
index 0000000000..02c31de8d0
--- /dev/null
+++ b/dev-docs/bidders/risemediatech.md
@@ -0,0 +1,28 @@
+---
+layout: bidder
+title: RiseMediaTech
+description: Prebid.js bidder adapter for RiseMediaTech
+biddercode: risemediatech
+media_types:
+  - banner
+  - video
+gdpr_supported: true
+usp_supported: true
+gpp_supported: true
+user_sync: false
+schain_supported: true
+pbjs: true
+pbs: true
+---
+
+# Overview
+
+RiseMediaTech is a digital advertising platform that supports banner and video ads through its Prebid.js adapter. The adapter uses OpenRTB standards for request and response formatting.
+
+# Bid Params
+
+| Name         | Scope              | Type             | Description                                | Example                 |
+|--------------|--------------------|------------------|--------------------------------------------|-------------------------|     
+| `bidFloor`   | optional           | string           | Bid Floor                                  | `'0.01'`|
+| `testMode`   | optional           | string           | Parameter to indicate prebid test mode                                  | `'1'`|
+

From c9f9239770f9f0eaa5fd65add94387c6f6098cd8 Mon Sep 17 00:00:00 2001
From: Moshe Moses <moshe.moses@gmail.com>
Date: Sun, 17 Aug 2025 17:23:44 +0300
Subject: [PATCH 287/665] Updated CleanMediaNet reference to the gamoshi
 adaptor code, update documentations. (#6192)

* - Updated Gamoshi Adapter documentation
- Added aliases for cleanmedianet and gambid adapters
- Removed 9MediaOnline adapter (no longer valid)

* added newline to the end

* Update dev-docs/bidders/cleanmedianet.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/gambid.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/gambid.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/gamoshi.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/gamoshi.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* fixing markdown liniting errors

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/9MediaOnline.md  |  23 -----
 dev-docs/bidders/cleanmedianet.md | 159 ++++++++++++++++++++++++++----
 dev-docs/bidders/gambid.md        | 151 ++++++++++++++++++++++++++--
 dev-docs/bidders/gamoshi.md       | 139 ++++++++++++++++++++++++--
 4 files changed, 414 insertions(+), 58 deletions(-)
 delete mode 100644 dev-docs/bidders/9MediaOnline.md

diff --git a/dev-docs/bidders/9MediaOnline.md b/dev-docs/bidders/9MediaOnline.md
deleted file mode 100644
index 3e337a1da8..0000000000
--- a/dev-docs/bidders/9MediaOnline.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-layout: bidder
-title: 9 Media Online
-description: Prebid 9 Media Online Bidder Adaptor
-biddercode: 9MediaOnline
-pbjs: true
-media_types: banner, video
-gvl_id: 644
-tcfeu_supported: true
-tcf2_supported: true
-schain_supported: true
-usp_supported: true
-userIds: id5Id, unifiedId
-aliasCode: gamoshi
-sidebarType: 1
----
-
-### Bid params
-
-{: .table .table-bordered .table-striped }
-| Name              | Scope    | Description                                                   | Example              | Type     |
-|-------------------|----------|---------------------------------------------------------------|----------------------|----------|
-| `supplyPartnerId` | required | ID of the supply partner | `'12345'`            | `string` |
diff --git a/dev-docs/bidders/cleanmedianet.md b/dev-docs/bidders/cleanmedianet.md
index 2035fd58e0..920038d7c7 100644
--- a/dev-docs/bidders/cleanmedianet.md
+++ b/dev-docs/bidders/cleanmedianet.md
@@ -4,30 +4,151 @@ title: Clean Media Net
 description: Clean Media Bidder Adapter
 biddercode: cleanmedianet
 pbjs: true
+pbs: true
 media_types: banner, video
-tcfeu_supported: false
-usp_supported: true
-coppa_supported: false
+userIds: all
+gvl_id: 644
+tcfeu_supported: true
+tcf2_supported: true
 schain_supported: true
-floors_supported: true
-userIds:
-prebid_member: false
-safeframes_ok: true
-deals_supported: false
-pbs_app_supported: false
-fpd_supported: false
-ortb_blocking_supported: false
-gvl_id:
-multiformat_supported: will-bid-on-any
+usp_supported: true
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+sidebarType: 1
+aliasCode: gamoshi
 ---
 
-### Disclosure
-
-Note: This bidder appears to only consider gdprApplies if a consent string is available. This may result in some incorrect GDPR processing, such as when the consent string is not yet available but the publisher has decided GDPR always applies. See <https://github.com/prebid/Prebid.js/issues/7775>
-
 ### Bid params
 
 {: .table .table-bordered .table-striped }
 | Name | Scope | Description | Example | Type |
-|-------------------+----------+--------------------------------------------------------+-------------------------+---------|
-| `supplyPartnerId` | required | The supply account's ID in your Clean Media dashboard. | `"1253"`, `"1254"`, etc | string |
+|-------------------|----------|---------------------------------------------------------------|----------------------|----------|
+| `supplyPartnerId` or `inventory_id` or `supply_partner_id` | required | ID of the supply partner. This parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred |  `12345`  | `integer` |
+| `bidfloor`        | optional | Minimum acceptable bid price. Must be a positive number. | `0.5` | `number` |
+| `instl`           | optional | Interstitial flag (1 for interstitial, 0 for non-interstitial). | `1` | `integer` |
+| `pos`             | optional | Ad position on the page. | `1` | `integer` |
+| `video`           | optional | Object containing video targeting parameters. See [Video Object](#video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` |
+
+This adapter only requires you to provide your Inventory Id (Supply partner id), and optionally your RTB endpoint.
+
+#### Video Object
+
+For details on how these video params work with the params set in the adUnit.mediaTypes.video object.
+
+{: .table .table-bordered .table-striped }
+| Name              | Description                                                                                                                                                                                                                                  | Type             |
+|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
+| `minduration` | Integer that defines the minimum video ad duration in seconds. | `integer` |
+| `maxduration` | Integer that defines the maximum video ad duration in seconds. | `integer` |
+| `protocols`   | Array of integers listing the supported video protocols (VAST versions). | `Array<integer>` |
+| `mimes`       | Array of strings listing the supported MIME types for the video creative. | `Array<string>` |
+| `pos`         | Ad position on the screen. | `integer` |
+| `api`         | Array of integers listing the supported API frameworks. | `Array<integer>` |
+| `skip`        | Indicates if the player will allow the video to be skipped (0 = no, 1 = yes). | `integer` |
+| `plcmt`       | Video placement type. | `integer` |
+| `placement`   | Placement type for the impression. | `integer` |
+| `playbackmethod` | Array of integers listing the playback methods. | `Array<integer>` |
+| `startdelay`  | Indicates the offset of the ad placement from the start of the video content. | `integer` |
+| `context`     | Content context (e.g., 'instream', 'outstream'). | `string` |
+
+### Example Ad Unit Configurations
+
+#### Banner Ad Unit
+
+```javascript
+var adUnits = [
+    {
+        code: 'banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [728, 90]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'cleanmedianet',
+                params: {
+                    supplyPartnerId: 12345,
+                    bidfloor: 0.5,
+                    pos: 1
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Instream)
+
+```javascript
+var adUnits = [
+    {
+        code: 'video-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'instream',
+                mimes: ['video/mp4', 'video/webm'],
+                protocols: [2, 3, 5, 6],
+                maxduration: 30,
+                api: [1, 2]
+            }
+        },
+        bids: [
+            {
+                bidder: 'cleanmedianet',
+                params: {
+                    supplyPartnerId: 12345,
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        skip: 1,
+                        startdelay: 0,
+                        api: [1, 2],
+                        plcmt: 1
+                    }
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Outstream)
+
+```javascript
+var adUnits = [
+    {
+        code: 'outstream-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'outstream',
+                mimes: ['video/mp4', 'video/webm']
+            }
+        },
+        bids: [
+            {
+                bidder: 'cleanmedianet',
+                params: {
+                    supplyPartnerId: 12345,
+                    rendererUrl: 'https://example.com/outstream-renderer.js',
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        placement: 3,
+                        plcmt: 3,
+                        context: 'outstream'
+                    }
+                }
+            }
+        ]
+    }
+];
+```
diff --git a/dev-docs/bidders/gambid.md b/dev-docs/bidders/gambid.md
index 1e2eada831..33ab5e4031 100644
--- a/dev-docs/bidders/gambid.md
+++ b/dev-docs/bidders/gambid.md
@@ -1,22 +1,153 @@
 ---
 layout: bidder
 title: Gambid
-description: Prebid Gambid Bidder Adaptor
-
-top_nav_section: dev_docs
-nav_section: reference
-
+description: Prebid Gambid Bidder Adapter
+biddercode: gambid
 pbjs: true
+pbs: true
 media_types: banner, video
-biddercode: gambid
-aliasCode: gamoshi
-userIds: id5Id, unifiedId
+userIds: all
+gvl_id: 644
+tcfeu_supported: true
+schain_supported: true
+usp_supported: true
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
 sidebarType: 1
+aliasCode: gamoshi
 ---
 
 ### Bid params
 
 {: .table .table-bordered .table-striped }
-| Name              | Scope    | Description                                                   | Example              | Type     |
+| Name | Scope | Description | Example | Type |
 |-------------------|----------|---------------------------------------------------------------|----------------------|----------|
-| `supplyPartnerId` | required | ID of the supply partner | `'12345'`            | `string` |
+| `supplyPartnerId` or `inventory_id` or `supply_partner_id` | required | ID of the supply partner. This parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred |  `12345`  | `integer` |
+| `bidfloor`        | optional | Minimum acceptable bid price. Must be a positive number. | `0.5` | `number` |
+| `instl`           | optional | Interstitial flag (1 for interstitial, 0 for non-interstitial). | `1` | `integer` |
+| `pos`             | optional | Ad position on the page. | `1` | `integer` |
+| `video`           | optional | Object containing video targeting parameters. See [Video Object](#video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` |
+
+This adapter only requires you to provide your Inventory Id (Supply partner id), and optionally your RTB endpoint.
+
+#### Video Object
+
+For details on how these video params work with the params set in the adUnit.mediaTypes.video object.
+
+{: .table .table-bordered .table-striped }
+| Name | Description | Type |
+|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
+| `minduration` | Integer that defines the minimum video ad duration in seconds. | `integer` |
+| `maxduration` | Integer that defines the maximum video ad duration in seconds. | `integer` |
+| `protocols`   | Array of integers listing the supported video protocols (VAST versions). | `Array<integer>` |
+| `mimes`       | Array of strings listing the supported MIME types for the video creative. | `Array<string>` |
+| `pos`         | Ad position on the screen. | `integer` |
+| `api`         | Array of integers listing the supported API frameworks. | `Array<integer>` |
+| `skip`        | Indicates if the player will allow the video to be skipped (0 = no, 1 = yes). | `integer` |
+| `plcmt`       | Video placement type. | `integer` |
+| `placement`   | Placement type for the impression. | `integer` |
+| `playbackmethod` | Array of integers listing the playback methods. | `Array<integer>` |
+| `startdelay`  | Indicates the offset of the ad placement from the start of the video content. | `integer` |
+| `context`     | Content context (e.g., 'instream', 'outstream'). | `string` |
+
+### Example Ad Unit Configurations
+
+#### Banner Ad Unit
+
+```javascript
+var adUnits = [
+    {
+        code: 'banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [728, 90]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'gambid',
+                params: {
+                    supplyPartnerId: 12345,
+                    bidfloor: 0.5,
+                    pos: 1
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Instream)
+
+```javascript
+var adUnits = [
+    {
+        code: 'video-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'instream',
+                mimes: ['video/mp4', 'video/webm'],
+                protocols: [2, 3, 5, 6],
+                maxduration: 30,
+                api: [1, 2]
+            }
+        },
+        bids: [
+            {
+                bidder: 'gambid',
+                params: {
+                    supplyPartnerId: 12345,
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        skip: 1,
+                        startdelay: 0,
+                        api: [1, 2],
+                        plcmt: 1
+                    }
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Outstream)
+
+```javascript
+var adUnits = [
+    {
+        code: 'outstream-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'outstream',
+                mimes: ['video/mp4', 'video/webm']
+            }
+        },
+        bids: [
+            {
+                bidder: 'gambid',
+                params: {
+                    supplyPartnerId: 12345,
+                    rendererUrl: 'https://example.com/outstream-renderer.js',
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        placement: 3,
+                        plcmt: 3,
+                        context: 'outstream'
+                    }
+                }
+            }
+        ]
+    }
+];
+```
diff --git a/dev-docs/bidders/gamoshi.md b/dev-docs/bidders/gamoshi.md
index 2b1a874644..354c6e7110 100644
--- a/dev-docs/bidders/gamoshi.md
+++ b/dev-docs/bidders/gamoshi.md
@@ -6,12 +6,13 @@ biddercode: gamoshi
 pbjs: true
 pbs: true
 media_types: banner, video
+userIds: all
+gvl_id: 644
 tcfeu_supported: true
-tcf2_supported: true
 schain_supported: true
 usp_supported: true
-userIds: id5Id, unifiedId
-gvl_id: 644
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
 sidebarType: 1
 ---
 
@@ -20,8 +21,134 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name              | Scope    | Description                                                   | Example              | Type     |
 |-------------------|----------|---------------------------------------------------------------|----------------------|----------|
-| `supplyPartnerId` | required | ID of the supply partner you created in the Gamoshi dashboard. | `'12345'`            | `string` |
+| `supplyPartnerId` or `inventory_id` or `supply_partner_id` | required | ID of the supply partner you created in the Gamoshi dashboard. This parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred |  `12345`  | `integer` |
 | `rtbEndpoint`     | optional | If you have a whitelabel account on Gamoshi, specify it here. | `'rtb.mybidder.com'` | `string` |
+| `bidfloor`        | optional | Minimum acceptable bid price. Must be a positive number. | `0.5` | `number` |
+| `instl`           | optional | Interstitial flag (1 for interstitial, 0 for non-interstitial). | `1` | `integer` |
+| `pos`             | optional | Ad position on the page. | `1` | `integer` |
+| `rendererUrl`     | optional | Custom renderer URL for outstream video. | `'https://example.com/renderer.js'` | `string` |
+| `video`           | optional | Object containing video targeting parameters. See [Video Object](#video-object) for details. | `video: { playback_method: ['auto_play_sound_off'] }` | `object` |
+
+This adapter only requires you to provide your Inventory Id (Supply partner id), and optionally your RTB endpoint.
+
+#### Video Object
+
+For details on how these video params work with the params set in the adUnit.mediaTypes.video object.
+
+{: .table .table-bordered .table-striped }
+| Name              | Description                                                                                                                                                                                                                                  | Type             |
+|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
+| `minduration` | Integer that defines the minimum video ad duration in seconds. | `integer` |
+| `maxduration` | Integer that defines the maximum video ad duration in seconds. | `integer` |
+| `protocols`   | Array of integers listing the supported video protocols (VAST versions). | `Array<integer>` |
+| `mimes`       | Array of strings listing the supported MIME types for the video creative. | `Array<string>` |
+| `pos`         | Ad position on the screen. | `integer` |
+| `api`         | Array of integers listing the supported API frameworks. | `Array<integer>` |
+| `skip`        | Indicates if the player will allow the video to be skipped (0 = no, 1 = yes). | `integer` |
+| `plcmt`       | Video placement type. | `integer` |
+| `placement`   | Placement type for the impression. | `integer` |
+| `playbackmethod` | Array of integers listing the playback methods. | `Array<integer>` |
+| `startdelay`  | Indicates the offset of the ad placement from the start of the video content. | `integer` |
+| `context`     | Content context (e.g., 'instream', 'outstream'). | `string` |
+
+### Example Ad Unit Configurations
+
+#### Banner Ad Unit
+
+```javascript
+var adUnits = [
+    {
+        code: 'banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [728, 90]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'gamoshi',
+                params: {
+                    supplyPartnerId: 12345,
+                    bidfloor: 0.5,
+                    pos: 1
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Instream)
+
+```javascript
+var adUnits = [
+    {
+        code: 'video-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'instream',
+                mimes: ['video/mp4', 'video/webm'],
+                protocols: [2, 3, 5, 6],
+                maxduration: 30,
+                api: [1, 2]
+            }
+        },
+        bids: [
+            {
+                bidder: 'gamoshi',
+                params: {
+                    supplyPartnerId: 12345,
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        skip: 1,
+                        startdelay: 0,
+                        api: [1, 2],
+                        plcmt: 1
+                    }
+                }
+            }
+        ]
+    }
+];
+```
+
+#### Video Ad Unit (Outstream)
 
-This adapter only requires you to provide your supply partner ID, and optionally your RTB endpoint, in order to request
-bids from your Gamoshi account.
+```javascript
+var adUnits = [
+    {
+        code: 'outstream-div',
+        mediaTypes: {
+            video: {
+                playerSize: [[640, 480]],
+                context: 'outstream',
+                mimes: ['video/mp4', 'video/webm']
+            }
+        },
+        bids: [
+            {
+                bidder: 'gamoshi',
+                params: {
+                    supplyPartnerId: 12345,
+                    rendererUrl: 'https://example.com/outstream-renderer.js',
+                    video: {
+                        minduration: 5,
+                        maxduration: 30,
+                        protocols: [2, 3, 5, 6],
+                        mimes: ['video/mp4', 'video/webm'],
+                        playbackmethod: [2],
+                        placement: 3,
+                        plcmt: 3,
+                        context: 'outstream'
+                    }
+                }
+            }
+        ]
+    }
+];
+```

From 3180a824946347d1c46bd969fb07e6b36808b21c Mon Sep 17 00:00:00 2001
From: Shane Lacey <shanel262@hotmail.com>
Date: Mon, 18 Aug 2025 19:12:23 +0100
Subject: [PATCH 288/665] Add Kargo email to codepath notification workflow
 (#4) (#6208)

---
 .github/workflows/scripts/codepath-notification | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/scripts/codepath-notification b/.github/workflows/scripts/codepath-notification
index dd8b369c26..f3857c7a79 100644
--- a/.github/workflows/scripts/codepath-notification
+++ b/.github/workflows/scripts/codepath-notification
@@ -15,3 +15,4 @@
 /dev-docs/bidders/pubmatic : header-bidding@pubmatic.com
 /dev-docs/bidders/openx : prebid@openx.com
 /dev-docs/bidders/teads : tech-ssp-video@teads.tv
+/dev-docs/bidders/kargo : kraken@kargo.com

From 7e02fd6e9e0091740c016d1c066d8f8d7b5d6095 Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Mon, 18 Aug 2025 21:13:50 +0300
Subject: [PATCH 289/665] =?UTF-8?q?including=20prebid=20server=20configura?=
 =?UTF-8?q?tion=20after=20Omnidex=20server=20approval:=20=E2=80=A6=20(#621?=
 =?UTF-8?q?1)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* including prebid server configuration after Omnidex server approval: https://github.com/prebid/prebid-server/pull/4441

* removing spaces
---
 dev-docs/bidders/omnidex.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/omnidex.md b/dev-docs/bidders/omnidex.md
index 719547c393..6a880c22fc 100644
--- a/dev-docs/bidders/omnidex.md
+++ b/dev-docs/bidders/omnidex.md
@@ -20,11 +20,11 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+### Bid Params for Prebid.js
 
 {: .table .table-bordered .table-striped }
 
@@ -34,6 +34,14 @@ sidebarType: 1
 | `pId`      | required | The publisher ID from Omnidex (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. omnidex will not respond with bids lower than this value. | `0.90`                       | `float`  |
 
+#### Bid Params for Prebid Server
+
+{: .table .table-bordered .table-striped }
+
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from Omnidex.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+
 ### Example
 
   ```javascript

From 8f7614be89cca66f42b789c1c665a4d3764ff447 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 18 Aug 2025 11:26:45 -0700
Subject: [PATCH 290/665] Add notes on schain and prebid 10 (#6210)

---
 dev-docs/modules/schain.md | 3 ++-
 dev-docs/pb10-notes.md     | 7 +++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/schain.md b/dev-docs/modules/schain.md
index 777cd2d3e1..b394d20b48 100644
--- a/dev-docs/modules/schain.md
+++ b/dev-docs/modules/schain.md
@@ -28,7 +28,8 @@ Two modes are supported:
 ## How to Use the Module
 
 {: .alert.alert-warning :}
-**Prebid 10 :** You don't need to add the schain module explicitly starting from Prebid 10.
+Since Prebid 10, schain is treated as first party data: this module just copies `schain.config` into `ortb2.source.ext.schain`. You may provide it (or `ortb2.source.schain`) directly, removing the need for this module.
+Note that bidder-specific first party data is merged with global first party data, while up until Prebid 9 bidder-specific schains override the global schain. The simplest way to upgrade to 10 is to avoid using both.   
 
 First, build the schain module into your Prebid.js package:
 
diff --git a/dev-docs/pb10-notes.md b/dev-docs/pb10-notes.md
index c1026b2447..20fa95ba27 100644
--- a/dev-docs/pb10-notes.md
+++ b/dev-docs/pb10-notes.md
@@ -92,6 +92,13 @@ The following modules have been removed from Prebid.js as part of the 10.0 relea
 * Tests now target Chrome 109 as the minimum version. `not dead` was added to the babel target.
 * **The `pbYield` helper was added and greedy rendering is disabled by default.**
 
+## `Schain` is now first party data
+
+* Publishers should provide schain as first party data in `ortb2.source.schain` or `ortb2.source.ext.schain`.
+* The schain module is no longer necessary and has been updated to simply copy `schain` configuration into first party data; it will be removed in the future.
+* Adapters should look for schain in `ortb2.source.ext.schain`.
+* Like all first party data, **bidder-specific schains are now merged with the global schain**, where previously they would replace it. Publishers setting both global and bidder-specific schains will need to make changes; the simplest way to address this is to use only bidder-specific schains.            
+
 ## API Changes
 
 * The `ADPOD` mediatype has received a deprecation warning.

From 240d4bef311f8d603546c97dbd693fa08080b539 Mon Sep 17 00:00:00 2001
From: Mikhail Malkov <mhlmlkv@gmail.com>
Date: Mon, 18 Aug 2025 23:44:37 +0300
Subject: [PATCH 291/665] nextMillenniumBidAdapter: Added support new
 parameters (#6190)

* updated option safeframe_ok in documentation

* nextMillennium - changed descriptions
---
 dev-docs/bidders/nextMillennium.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/nextMillennium.md b/dev-docs/bidders/nextMillennium.md
index d218b1d02b..4a8026a4ad 100644
--- a/dev-docs/bidders/nextMillennium.md
+++ b/dev-docs/bidders/nextMillennium.md
@@ -24,10 +24,12 @@ sidebarType: 1
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name           | Scope | Description                              | Example   | Type    |
-|----------------+-------+-----------------------------------+-----------+---------|
-| `placement_id` | optional | Placement ID, provided by nextMillennium | `'12345'` | String  |
-| `group_id`     | optional | Group ID, provided by nextMillennium     | `'12345'` | String  |
+| Name           | Scope    | Description                              | Example         | Type            |
+|----------------+----------+------------------------------------------+-----------------+-----------------|
+| `placement_id` | optional | Placement ID, provided by nextMillennium | `'12345'`       | String          |
+| `group_id`     | optional | Group ID, provided by nextMillennium     | `'12345'`       | String          |
+| `adSlots`      | optional | `adSlot` is a specific location or container on a webpage where an advertisement is displayed. | `["stickytop"]` | Array of String |
+| `allowedAds`   | optional | `allowedAds` is a list of ad types or formats that are permitted to be shown in a specific ad slot. | `["skin"]`      | Array of String |
 
 Required one of the two parameters placement_id or group_id.
 

From 14d2e49df452cc151931dba83a654aa594308c6b Mon Sep 17 00:00:00 2001
From: Chris Huie <phoenixtechnerd@gmail.com>
Date: Tue, 19 Aug 2025 06:26:34 -0600
Subject: [PATCH 292/665] This Copper6 no longer in master (#6219)

---
 dev-docs/bidders/copper6.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/copper6.md b/dev-docs/bidders/copper6.md
index 71cde51bc5..53994b620c 100644
--- a/dev-docs/bidders/copper6.md
+++ b/dev-docs/bidders/copper6.md
@@ -17,6 +17,7 @@ prebid_member: false
 pbjs: true
 pbs: true
 deals_supported: false
+enable_download: false
 sidebarType: 1
 ---
 

From 6010b2ba42a512400f348857f3c21306ecc8bc27 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Krzysztof=20Sok=C3=B3=C5=82?=
 <88041828+krzysztofequativ@users.noreply.github.com>
Date: Tue, 19 Aug 2025 15:53:29 +0200
Subject: [PATCH 293/665] Equativ Bid Adapter: adding information about keyword
 targeting (#6218)

* SADR-6590: initial documentation for Equativ JS bid adapter

* SADR-6590: doc refinements

* Update equativ.md

SADR-6590: adjustments to doc from review feedback.

* SADR-6590: fix linting issues

* SADR-6590: another linting issue

* update app.publisher.id

* SADR-6590: providing link to Equativ OpenRTB API documentation

* SADR-6590: providing additional required fields for documentation

* SADR-6590: adding peer answers to questions

* SADR-6590: remove FPD section for now

* Equativ: updating documentation on bid adapter parameter requirements

* SADR-6882: expanding documentation with additional examples

* update features

* added info about first party data

* add examples

* Update documentation URL

* keyword targeting

---------

Co-authored-by: Jeff Mahoney <jeff.t.mahoney@gmail.com>
Co-authored-by: Krzysztof SIEG <ksieg@smartadserver.com>
---
 dev-docs/bidders/equativ.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md
index 9afd1433d0..09678ae08e 100644
--- a/dev-docs/bidders/equativ.md
+++ b/dev-docs/bidders/equativ.md
@@ -567,6 +567,20 @@ var adUnits = [
 
 Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
 
+#### Keywords
+
+Keyword targeting capabilities are supported. To pass keywords, the following fields can be used: `ortb2.site.keywords`, `ortb2.app.keywords`, or `ortb2.dooh.keywords`.
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      keywords: 'kw_1,kw_2'
+    }
+  }
+});
+```
+
 ### Additional Resources
 
 Information about how Equativ supports the oRTB specification, along with additional examples, can be found [on our OpenRTB API support site](https://help.equativ.com/open-rtb-api-integration-bid-request-specification-1).

From 8e57b7eb60346220d88c78f75581d220f3ba14ff Mon Sep 17 00:00:00 2001
From: Yuriy Velichko <yuriy.velichko@postindustria.com>
Date: Tue, 19 Aug 2025 17:03:04 +0300
Subject: [PATCH 294/665] Mobile: UI/UX policy (#6204)

* doc: prepare the page

* doc: changes for mobile UI/UX policy

* docs: corrections for UI/UX policy

* docs: add info for Rewarded ads

* doc: updates for rewarded ad unit

* doc: corrections

* doc: fix linter errors

* doc: rename page and section, format code

* doc: format text in the table

* doc: reslove PR comments

* Update prebid-mobile/modules/rendering/combined-ui-ux-policy.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update prebid-mobile/modules/rendering/combined-ui-ux-policy.md

* Apply suggestion from @muuki88

* Apply suggestion from @muuki88

* Apply suggestion from @muuki88

* Apply suggestion from @muuki88

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 _data/sidebar.yml                             | 16 ++++
 .../rendering/combined-ui-ux-policy.md        | 79 +++++++++++++++++++
 2 files changed, 95 insertions(+)
 create mode 100644 prebid-mobile/modules/rendering/combined-ui-ux-policy.md

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index cd87d273dc..b06ea827e5 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -815,6 +815,14 @@
   sectionTitle:
   subgroup: 2
 
+- sbSecId: 2
+  title: Ad Experience Specification
+  link: /prebid-mobile/modules/rendering/combined-ui-ux-policy.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 2
+  
 - sbSecId: 2
   title: Ad Experience Controls
   link: /prebid-mobile/modules/rendering/combined-ad-experience-controls.html
@@ -919,6 +927,14 @@
   isSectionHeader: 0
   sectionTitle:
   subgroup: 3
+  
+- sbSecId: 2
+  title: Ad Experience Specification
+  link: /prebid-mobile/modules/rendering/combined-ui-ux-policy.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 3
 
 - sbSecId: 2
   title: Ad Experience Controls
diff --git a/prebid-mobile/modules/rendering/combined-ui-ux-policy.md b/prebid-mobile/modules/rendering/combined-ui-ux-policy.md
new file mode 100644
index 0000000000..9d0b857e87
--- /dev/null
+++ b/prebid-mobile/modules/rendering/combined-ui-ux-policy.md
@@ -0,0 +1,79 @@
+---
+
+layout: page_v2
+title: Ad Experience Specification
+description: Ad Experience Specification
+sidebarType: 2
+
+---
+
+# Prebid SDK Ad Experience
+{:.no_toc}
+
+If you use the Prebid SDK to render the winning bid, be aware of how the SDK implements ad experiences and how you can modify them.
+
+This specification does not apply to the Bidding-Only API, where the Google Mobile Ads SDK or any other rendering engine performs rendering. In such integration scenarios, the ad experience is defined by the third-party SDK, and the Prebid SDK is not able to influence this. 
+
+* TOC
+{:toc}
+
+## Banner
+
+Prebid SDK renders the banner ad in the OS-specific WebView. The publisher is responsible for integrating `BannerAdView` into the application layout and providing the screen space according to the supported ad sizes. 
+
+The following table describes the ad experience properties of the banner ad and how they can be changed.
+
+ {: .table .table-bordered .table-striped }
+| Policy | Behavior | Customization | 
+|--------|-----------|---------------|
+|`Autorefresh`| **Prebid SDK** refreshes the banner ad every **60 seconds**. SDK makes the bid request and changes the current creative in the ad slot if the refresh has a bid. If there is no bid, the SDK will remove the current creative from the internal ad slot and notify the publisher using the respective delegate methods. <br><br> **Publisher** is responsible for removing or collapsing the ad slot in the application layout. |**iOS**: you can change the refresh interval using [refreshInterval](/prebid-mobile-ios/Classes/BannerView.html#/c:@M@PrebidMobile@objc(cs)BannerView(py)refreshInterval) property. <br><br> **Android**: you can change the refresh interval using the [setAutoRefreshDelay](/prebid-mobile-android/org/prebid/mobile/api/rendering/BannerView.html#setAutoRefreshDelay(int)) property.|
+|`Content Resizing`|**Prebid SDK** changes the size of WebView according to the size of the creative received in the bid response. <br><br> **Publisher** is responsible for adopting the application layout for different ad sizes.|To support multisize ads, publishers should implement a dynamic layout for the banner ad place. Prebid SDK will change the size of the `BannerAdView` according to the content. However, the publisher is responsible for adapting the application layout for different ad sizes. <br><br>Currently, the SDK doesn't notify publishers about the change in banner size. Open an issue or PR to add this functionality.|
+|`Clickthrough`|**Prebid SDK**: Opens the click URL in the default browser of the device. The SDK calls the respective ad delegate and listeners' methods to notify the publisher that the application is being left. <br><br> **Publisher** is responsible for processing SDK events and managing the application state, respectively.  |Currently, customization is not available. Open an issue or PR for the alternative approach. |
+
+## Outstream Video (in-banner)
+
+Prebid SDK renders the outstream video ad in the OS-specific video player. The publisher is responsible for integrating the `BannerAdView` into the application layout and providing the needed space according to the supported ad sizes. 
+
+ {: .table .table-bordered .table-striped }
+| Policy | Behavior | Customization | 
+|--------|-----------|---------------|
+|`Autoplay`| **Prebid SDK** starts playback only when the ad appears on the app screen. Once the ad is removed or scrolled off the screen, the playback will be stopped. <br> <br> **Publisher** is responsible for removing or collapsing the ad slot in the application layout. |Currently, there is no public API to customize this behavior. Open an issue or PR for the alternative approach.|
+|`Sound`| **Prebid SDK** Prebid SDK plays out-stream video with sound enabled. | Currently, there is no way to mute the outstream video. Open an issue or PR for the alternative approach.| 
+
+## Interstitial Video
+
+The Prebid SDK renders the interstitial video ad in the OS-specific video player, within the special full-screen controller. The publisher is responsible for integrating the `Interstitial` controller into the application flow and managing the app's behavior in response to ad signals. 
+
+ {: .table .table-bordered .table-striped }
+| Policy | Behavior | Customization | 
+|--------|-----------|---------------|
+| `Fullscreen` | **Prebid SDK** opens the interstitial ad in the fullscreen controller that overlaps all other application content. The iOS SDK support the SKOverlay format to show the interstitial ad for the bid with respective [configuration](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/skadnetwork.md#bid-request). <br><br> **Publisher** is responsible for implementing the callbacks for interstitial ads and managing the app state according to the ad behavior. | Currently, there is no way to customize the appearance of the interstitial ads. Open an issue or PR for the alternative approach. |
+| `Rotation` | **Prebid SDK** allows the rotation of the screen for the interstitial ads. The ad content is rotated according to the screen position. SDK changes the layout of the ad control elements according to the screen orientation. <br><br> **Publisher** has nothing to do in this operation, SDK doesn't provide any events to subscribe. | Currently, there is no way to customize the rotation behavior of the interstitial ads. Open an issue or PR for the alternative approach.|
+| `Close Button` | **Prebid SDK** adds a close button to the interstitial ad, providing a way for users to dismiss the fullscreen ad. Depending on the ad format, the button can appear from the very beginning of the ad or with some delay. <br><br>  **Publisher** is responsible for subscribing to the ad flow events and managing the app flow, accordingly.   | **Publisher** can customize the default SDK behavior using the [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html) feature.|
+| `Learn More Button` | **Prebid SDK** adds a close button to the interstitial ad, providing a way for users to dismiss the fullscreen ad. Depending on the ad format, the button can appear from the very beginning of the ad or with some delay. <br><br>  **Publisher** is responsible for subscribing to the ad flow events and managing the app flow, accordingly. |**Publisher** can customize the default SDK behavior using [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html)|
+| `Tap` | **Prebid SDK** processes the clicks, actually taps, in different ways, respectively, depending on the type of the ad. <br> **The publisher** is responsible for handling [interstitialDidClickAd](/prebid-mobile-ios/Protocols/InterstitialAdUnitDelegate.html#/c:@M@PrebidMobile@objc(pl)InterstitialAdUnitDelegate(im)interstitialDidClickAd:) delegate method on iOS or [onAdClicked](/prebid-mobile-android/org/prebid/mobile/api/rendering/listeners/InterstitialAdUnitListener.html#onAdClicked(org.prebid.mobile.api.rendering.InterstitialAdUnit)) listener method on Android. |Currently, there is no way to customize the way of processing the taps on the ad. Open an issue or PR for the alternative approach.|
+| `Clickthrough` | **Prebid SDK** opens a click URL in the external browser on the platform. Typically, it is the default browser for a particular user's device. <br> **Publisher** is responsible for processing SDK events and managing the application state, respectively.  |Currently, customization is not available. Open an issue or PR for the alternative approach.|
+| `Learn More Button` | **Prebid SDK** adds a close button to the interstitial ad, providing a way for users to dismiss the fullscreen ad. Depending on the ad format, the button can appear from the very beginning of the ad or with some delay. <br><br>  **Publisher** is responsible for subscribing to the ad flow events and managing the app flow, accordingly. |**Publisher** can customize the default SDK behavior using [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html)|
+| `Tap` | **Prebid SDK** processes the clicks, actually taps, in different ways, respectively, depending on the type of the ad. <br> **The publisher** is responsible for handling [interstitialDidClickAd](/prebid-mobile-ios/Protocols/InterstitialAdUnitDelegate.html#/c:@M@PrebidMobile@objc(pl)InterstitialAdUnitDelegate(im)interstitialDidClickAd:) delegate method on iOS or [onAdClicked](/prebid-mobile-android/org/prebid/mobile/api/rendering/listeners/InterstitialAdUnitListener.html#onAdClicked(org.prebid.mobile.api.rendering.InterstitialAdUnit)) listener method on Android. |Currently, there is no way to customize the way of processing the taps on the ad. Open an issue or PR for the alternative approach.|
+| `Clickthrough` | **Prebid SDK** opens a click URL in the external browser on the platform. Typically, it is the default browser for a particular user's device. <br> **Publisher** is responsible for processing SDK events and managing the application state, respectively.  |Currently, customization is not available. Open an issue or PR for the alternative approach.|
+|`Playback`| **Prebid SDK** starts playback only when the ad appears on the app screen. Once the ad is removed or scrolled off the screen, the playback will be stopped. <br> <br> **Publisher** is responsible for removing or collapsing the ad slot in the application layout. |Currently, there is no public API to customize this behavior. Open an issue or PR for the alternative approach.|
+|`Sound`| **Prebid SDK** Prebid SDK plays instream video with sound enabled. | **Publisher** can customize the default SDK behavior using [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html) |
+
+## Rewarded Ad 
+
+**Prebid SDK** implements a special ad unit for Rewarded ads, maintaining the OS-specific video player, WebView, and rewarding engine under the hood. The publisher should integrate the `RewardedAdUnit` into the application flow and manage app behavior in response to ad signals. 
+
+The following table, based on the `RewardedAdUnit` [specification](https://github.com/prebid/prebid-mobile-ios/issues/1056), describes how publishers can change their behavior: 
+
+ {: .table .table-bordered .table-striped }
+| Policy | Behavior | Customization | 
+|--------|-----------|---------------|
+|`Reward`|**Prebid SDK** can signal the publisher about the type and quantity of reward coins.<br><br> If the `rwdd` or `reward` object is absent in the response, by **default,** SDK will send an empty object into the respective delegate method. |**Publisher** can set the type and number of coins in the `rwdd.reward` object.|
+|`Completion`|**Prebid SDK** will inform the application once the reward time has come.<br><br> If the `rwdd` or `reward` object is absent in the response, by **default,** <br><br>- **banner:** SDK triggers the completion of the banner rewarded ad after **120 seconds** on the screen.<br><br>- **video:** SDK triggers the completion of the rewarded ad once the video playback is completed. But only if the ad doesn’t have an end card. | **Publisher** can set the rule when the SDK should inform the app about the reward time. Depending on the ad format, the publisher can set different rules using `rwdd.completion.banner` and `rwdd.completion.video` objects respectively.|
+|`Close`|**Prebid SDK** will close the interstitial controller with rewarded ad according to the configuration passed in the response.<br><br> If the `rwdd` or `reward` object is absent in the response, by **default,** SDK will display the **close button** on the interstitial once the completion criteria are met.| **Publisher** can set the rule on how the SDK should behave once the user earns the reward, and the interstitial ad can be dismissed from the app screen. <br><br>The `rwdd.close.postrewardtime` describes how much time the SDK should wait until performing the `action`. <br><br>The action itself is described in `rwdd.close.action` object. Currently, two actions are supported:<br><br>- `autoclose` means that the ad will be dismissed without user interaction.<br><br>- `closebutton` means that the SDK will display the close button on top of the ad, and the user will have to tap on it to dismiss the ad.|
+
+Note: [Ad Experience Controls](/prebid-mobile/modules/rendering/combined-ad-experience-controls.html) of the rewarded ad can be configured in the same way as for the interstitial ad. 
+
+## Native Ads
+
+The Prebid SDK supplies the content for native ad assets such as titles, images, and custom data, but does not control how these assets are presented within the application. Publishers are responsible for designing the ad layout and integrating it into their app’s user interface. Consequently, the overall user experience of native ads depends on the publisher’s implementation.

From 0d13f23170398e145ef82ed0efc2af4852e955dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petric=C4=83=20Nanc=C4=83?= <petrica_nanca@yahoo.com>
Date: Tue, 19 Aug 2025 17:04:41 +0300
Subject: [PATCH 295/665] Create sevio.md (#6137)

* Create sevio.md

* Update dev-docs/bidders/sevio.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update sevio.md after review

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/sevio.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 dev-docs/bidders/sevio.md

diff --git a/dev-docs/bidders/sevio.md b/dev-docs/bidders/sevio.md
new file mode 100644
index 0000000000..1436e08047
--- /dev/null
+++ b/dev-docs/bidders/sevio.md
@@ -0,0 +1,27 @@
+---
+layout: bidder
+title: Sevio
+description: Prebid Sevio Bidder Adaptor
+pbjs: true
+pbs: false
+biddercode: sevio
+sidebarType: 1
+tcfeu_supported: true
+usp_supported: true
+gvl_id: 1393
+media_types: native
+safeframes_ok: false
+deals_supported: false
+fpd_supported: false
+prebid_member: false
+ortb_blocking_supported: false
+---
+
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description      | Example | Type     |
+|---------------|----------|------------------|---------|----------|
+| `zone`        | required | Zone Id          |         | `string` |

From f8df2c2e2b948b468ca7bbd82ca66bc87855827e Mon Sep 17 00:00:00 2001
From: Andrii Rudyk <96918101+And-Rud@users.noreply.github.com>
Date: Tue, 19 Aug 2025 17:05:05 +0300
Subject: [PATCH 296/665] Update: bwx.md (#6212)

* BoldwinX Prebid Server Adapter: Add gvl_id parameter

* set tcfeu_supported to true

---------

Co-authored-by: And-Rud <andrii@xe.works>
---
 dev-docs/bidders/bwx.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/bwx.md b/dev-docs/bidders/bwx.md
index fd3b2e9cac..d21e097742 100644
--- a/dev-docs/bidders/bwx.md
+++ b/dev-docs/bidders/bwx.md
@@ -5,7 +5,7 @@ description: BoldwinX Bidder Adapter
 biddercode: bwx
 media_types: banner, video, native
 coppa_supported: true
-tcfeu_supported: false
+tcfeu_supported: true
 usp_supported: true
 prebid_member: false
 pbjs: false
@@ -15,6 +15,7 @@ floors_supported: true
 multiformat_supported: will-bid-on-any
 sidebarType: 1
 safeframes_ok: true
+gvl_id: 1151
 ---
 
 ### Prebid Server Bid Params

From ed17b3260edf066fa46ba3ae903f8f52df98e12b Mon Sep 17 00:00:00 2001
From: Andrii Rudyk <96918101+And-Rud@users.noreply.github.com>
Date: Tue, 19 Aug 2025 17:07:06 +0300
Subject: [PATCH 297/665] Update xe.md (#6213)

* XeWorks Prebid Adapter: Add gvl_id parameter

* set tcfeu_supported to true

---------

Co-authored-by: And-Rud <andrii@xe.works>
---
 dev-docs/bidders/xe.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/xe.md b/dev-docs/bidders/xe.md
index 061df3aa74..ef515d7d98 100644
--- a/dev-docs/bidders/xe.md
+++ b/dev-docs/bidders/xe.md
@@ -5,7 +5,7 @@ description: Prebid Xe.works Bidder Adaptor
 biddercode: xe
 media_types: banner, video
 coppa_supported: true
-tcfeu_supported: false
+tcfeu_supported: true
 usp_supported: true
 prebid_member: true
 pbjs: true
@@ -14,6 +14,7 @@ schain_supported: true
 floors_supported: true
 multiformat_supported: will-bid-on-any
 sidebarType: 1
+gvl_id: 1383
 ---
 
 ### Note

From 0571c8634af1293d9b944f0ab82c3a290fbf1e95 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Tue, 19 Aug 2025 16:07:50 +0200
Subject: [PATCH 298/665] New Adapter: smootai (#6215)

* .

* .

---------

Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/smootai.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/smootai.md

diff --git a/dev-docs/bidders/smootai.md b/dev-docs/bidders/smootai.md
new file mode 100644
index 0000000000..e16a60e4d9
--- /dev/null
+++ b/dev-docs/bidders/smootai.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: SmootAI
+description: SmootAI Bidder Adaptor
+biddercode: smootai
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                   | Example             | Type      |
+|:--------------|:---------|:--------------------------------------------------------------|:--------------------|:----------|
+| `host`        | required | Ad network's RTB host                                         | `'ads-smoot.com'`   | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on <Public title name> Platform. | `42`                | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                       | `'banner'`          | `string`  |
+| `publisherId` | required | Publisher ID                                                  | `'12345'`           | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                      | `'custom1'`         | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                      | `'custom2'`         | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                      | `'custom3'`         | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                      | `'custom4'`         | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                      | `'custom5'`         | `string`  |

From d1ee4877c3a05b6ce664a6ad967d914beda9b2a8 Mon Sep 17 00:00:00 2001
From: LyricWulf <lyricwulf@gmail.com>
Date: Tue, 19 Aug 2025 07:08:36 -0700
Subject: [PATCH 299/665] fix: example showing pbjs.addAdUnits as variadic
 (#6216)

---
 features/pbAdSlot.md | 47 +++++++++++++++++++++++---------------------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/features/pbAdSlot.md b/features/pbAdSlot.md
index 51f36be49f..fe244c8626 100644
--- a/features/pbAdSlot.md
+++ b/features/pbAdSlot.md
@@ -113,31 +113,34 @@ In this example, the publisher utilizes the same 'slotname' in the page for mult
 - defineSlot('/1111/homepage', [[728,90]], 'div-j98s9u9usj987665da');
 
 ```javascript
-pbjs.addAdUnits({
-    code: 'div-293rj893p9wje9we9fj',
-    ortb2Imp: {
-        ext: {
-            gpid: "/1111/homepage#300x250",
-            data: {
-                pbadslot: "/1111/homepage#300x250"
+pbjs.addAdUnits([
+    {
+        code: 'div-293rj893p9wje9we9fj',
+        ortb2Imp: {
+            ext: {
+                gpid: "/1111/homepage#300x250",
+                data: {
+                    pbadslot: "/1111/homepage#300x250"
+                }
             }
-        }
+        },
+        mediaTypes: ...
+        bids: ...
     },
-    mediaTypes: ...
-    bids: ...
-},{
-    code: 'div-j98s9u9usj987665da',
-    ortb2Imp: {
-        ext: {
-            gpid: "/1111/homepage#728x90",
-            data: {
-                pbadslot: "/1111/homepage#728x90"
+    {
+        code: 'div-j98s9u9usj987665da',
+        ortb2Imp: {
+            ext: {
+                gpid: "/1111/homepage#728x90",
+                data: {
+                    pbadslot: "/1111/homepage#728x90"
+                }
             }
-        }
-    },
-    mediaTypes: ...
-    bids: ...
-});
+        },
+        mediaTypes: ...
+        bids: ...
+    }
+]);
 ```
 
 ## Prebid Server

From 399d330f374bbf4f7c3aa2e11ed16f0032e67da6 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Tue, 19 Aug 2025 17:08:30 +0200
Subject: [PATCH 300/665] Remove duplicated bidder copper6 (#6222)

---
 dev-docs/bidders/copper6.md | 111 ------------------------------------
 1 file changed, 111 deletions(-)
 delete mode 100644 dev-docs/bidders/copper6.md

diff --git a/dev-docs/bidders/copper6.md b/dev-docs/bidders/copper6.md
deleted file mode 100644
index 53994b620c..0000000000
--- a/dev-docs/bidders/copper6.md
+++ /dev/null
@@ -1,111 +0,0 @@
----
-layout: bidder
-title: SSP Copper6
-description: SSP Copper6 Bidder Adapter
-biddercode: copper6
-aliasCode: adtelligent
-media_types: video,banner
-gvl_id: 410 (adtelligent)
-tcfeu_supported: true
-gpp_supported: true
-userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
-schain_supported: true
-coppa_supported: true
-usp_supported: true
-safeframes_ok: true
-prebid_member: false
-pbjs: true
-pbs: true
-deals_supported: false
-enable_download: false
-sidebarType: 1
----
-
-### Bid params
-
-{: .table .table-bordered .table-striped }
-| Name  | Scope    | Description                     | Example  | Type      |
-|-------|----------|---------------------------------|----------|-----------|
-| `aid` | required | The source ID from Copper6 Media.   | `12412` | `integer` |
-
-### Description
-
-Please don't use this adapter. To connect with Copper6 demand, please use the Copper6SSP. You can find details here: <https://docs.prebid.org/dev-docs/bidders/copper6ssp.html>
-___
-Copper6 Media header bidding adapter connects with Copper6 Media demand sources in order to fetch bids.
-This adapter provides a solution for accessing Video demand and display demand.
-
-### Test Parameters
-
-``` javascript
-    var adUnits = [
-
-      // Video instream adUnit
-      {
-        code: 'test-div',
-        mediaTypes: {
-          video: {
-            context: 'instream',
-            playerSize: [640, 480]
-          }
-        },
-        bids: [{
-          bidder: 'copper6',
-          params: {
-            aid: 472386
-          }
-        }]
-      },
-
-      // Video outstream adUnit
-      {
-        code: 'test-div',
-        mediaTypes: {
-          video: {
-            context: 'outstream',
-            playerSize: [640, 480]
-          }
-        },
-        bids: [{
-          bidder: 'copper6',
-          params: {
-            aid: 472386
-          }
-        }]
-      },
-
-       // Video ADPOD adUnit
-      {
-        code: 'test-div',
-        sizes: [[640, 480]],
-        mediaTypes: {
-          video: {
-            context: 'adpod',
-            playerSize: [640, 480]            
-          }
-        },
-        bids: [{
-          bidder: 'copper6',
-          params: {
-            aid: 472386
-          }
-        }]
-      },
-
-      // Banner adUnit
-      {
-        code: 'test-div',
-        mediaTypes:{
-            banner:{
-                sizes: [[300, 250]]
-            }
-        }
-        bids: [{
-          bidder: 'copper6',
-          params: {
-            aid: 529814
-          }
-        }]
-      }
-    ];
-```

From 502097bef5d90d1ebf21a2fff51383d6523cc01b Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Tue, 19 Aug 2025 17:57:11 +0200
Subject: [PATCH 301/665] pbs added (#6171)

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/1accord.md   | 1 +
 dev-docs/bidders/easybid.md   | 1 +
 dev-docs/bidders/nexx360.md   | 1 +
 dev-docs/bidders/prismassp.md | 1 +
 4 files changed, 4 insertions(+)

diff --git a/dev-docs/bidders/1accord.md b/dev-docs/bidders/1accord.md
index 680f299fc0..bb45cd8f96 100644
--- a/dev-docs/bidders/1accord.md
+++ b/dev-docs/bidders/1accord.md
@@ -3,6 +3,7 @@ layout: bidder
 title: 1Accord
 description: Prebid 1Accord Bidder Adapter
 pbjs: true
+pbs: true
 biddercode: 1accord
 aliasCode : nexx360
 gvl_id: 965 (nexx360)
diff --git a/dev-docs/bidders/easybid.md b/dev-docs/bidders/easybid.md
index 478aea2043..6e71dbbd87 100644
--- a/dev-docs/bidders/easybid.md
+++ b/dev-docs/bidders/easybid.md
@@ -3,6 +3,7 @@ layout: bidder
 title: Easybid
 description: Prebid Easybid Bidder Adapter
 pbjs: true
+pbs: true
 biddercode: easybid
 gvl_id: 1068
 tcfeu_supported: true
diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index 9eeca65cee..87bc576966 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -3,6 +3,7 @@ layout: bidder
 title: Nexx360
 description: Prebid Nexx360 Bidder Adapter
 pbjs: true
+pbs: true
 biddercode: nexx360
 gvl_id: 965
 tcfeu_supported: true
diff --git a/dev-docs/bidders/prismassp.md b/dev-docs/bidders/prismassp.md
index d257868412..91598ea5a2 100644
--- a/dev-docs/bidders/prismassp.md
+++ b/dev-docs/bidders/prismassp.md
@@ -3,6 +3,7 @@ layout: bidder
 title: Prismassp
 description: Prebid Prismassp Bidder Adapter
 pbjs: true
+pbs: true
 biddercode: prismassp
 gvl_id: 965
 tcfeu_supported: true

From 53c16135041019f60278a7e540b8e8822fd333dc Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Tue, 19 Aug 2025 12:07:32 -0700
Subject: [PATCH 302/665] Document targetingControls.lock (#6223)

---
 dev-docs/publisher-api-reference/setConfig.md | 29 +++++++++++++++++--
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 193179df6a..3b8efb71d6 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -703,12 +703,14 @@ The `targetingControls` object passed to `pbjs.setConfig` provides some options
 {: .table .table-bordered .table-striped }
 | Attribute        | Type    | Description             |
 |------------+---------+---------------------------------|
-| auctionKeyMaxChars | integer | Specifies the maximum number of characters the system can add to ad server targeting. |
-| alwaysIncludeDeals | boolean | If [enableSendAllBids](#setConfig-Send-All-Bids) is false, set this value to `true` to ensure that deals are sent along with the winning bid |
+| auctionKeyMaxChars | Integer | Specifies the maximum number of characters the system can add to ad server targeting. |
+| alwaysIncludeDeals | Boolean | If [enableSendAllBids](#setConfig-Send-All-Bids) is false, set this value to `true` to ensure that deals are sent along with the winning bid |
 | allowTargetingKeys | Array of Strings | Selects supported default targeting keys. |
 | addTargetingKeys   | Array of Strings | Selects targeting keys to be supported in addition to the default ones |
 | allowSendAllBidsTargetingKeys | Array of Strings | Selects supported default targeting keys. |
-| allBidsCustomTargeting | boolean | Set to true to prevent custom targeting values from being set for non-winning bids |
+| allBidsCustomTargeting | Boolean | Set to true to prevent custom targeting values from being set for non-winning bids |
+| lock               | Array of Strings | Targeting keys to lock |
+| lockTimeout        | Integer          | Lock timeout in milliseconds                                   |
 
 {: .alert.alert-info :}
 Note that this feature overlaps and can be used in conjunction with [sendBidsControl.bidLimit](#setConfig-Send-Bids-Control).
@@ -910,6 +912,27 @@ config.setConfig({
 
 By default, non winning bids will have custom tageting values concatenated to the winning bid's custom targeting for the same key.  The `allBidsCustomTargeting` setting is a boolean that, when set to `false`, prevents custom targeting values from being set for non-winning bids. This can be useful if you want to ensure that only the winning bid has custom targeting values set.  
 
+#### Details on the lock and lockTimeout settings
+{: .no_toc }
+
+When `lock` is set, targeting set through `setTargetingForGPTAsync` or `setTargetingForAst`
+will prevent bids with the same targeting on any of the given keys from being used again until rendering is complete or
+`lockTimeout` milliseconds have passed.
+
+For example, with the following:
+
+```javascript
+pbjs.setConfig({
+  targetingControls: {
+    lock: ['hb_adid'],
+    lockTimeout: 2000
+  }
+});
+```
+
+calling `pbjs.setTargetingForGPTAsync()` will "lock" the targeted `hb_adid` until its slot renders or 2 seconds have passed, preventing subsequent calls to `setTargetingForGPTAsync` from using bids with the same `hb_adid` in the meanwhile.
+If using standard targeting `hb_adid` is unique for each bid, so this would have the effect of preventing the same bid from being used for multiple slots at the same time.      
+
 <a name="setConfig-Configure-Responsive-Ads"></a>
 
 ### Configure Responsive Ads

From 819f7cd5a7c4f6c59b3d51aa3c5f291f987650e8 Mon Sep 17 00:00:00 2001
From: Antoine Niek <antoineniek@gmail.com>
Date: Fri, 22 Aug 2025 10:16:54 -0400
Subject: [PATCH 303/665] New PBS-Java module: optable-targeting (#5931)

* optable-targeing module draft doc

* optable-targeting: fix paths

* optable-targeting: update maintainer contacts

* optable-targeting: add timeout considerations and params info

* optable: add section on analytics tags

* optable: extend the doc on ID mapping

* otpable: cosmetics

* optable-targeting: enhance summary

* optable-targeting: enhance summary and table .lmt!=1 condition

* optable-targeting: update id-prefix-order configuration parameter description

* optable-targeting: fix lint issues

* optable-targeting: fix lint issues

* optable-targeting: fix typos: user.ext.data -> user.data, user.ext.eids -> user.eids (as server converts user.ext.eids to user.eids according to OpenRTB 2.6)

* optable-targeting: introduce host-level regional endpoint config, cache feature

* optable-targeting: lint warnings

* update ATags section

* optable-targeting: enclose macros in the double curly brace

---------

Co-authored-by: Eugene Dorfman <eugene.dorfman@gmail.com>
Co-authored-by: softcoder594 <softcoder594@gmail.com>
Co-authored-by: Bohdan V <25197509+BohdanVV@users.noreply.github.com>
---
 prebid-server/pbs-modules/index.md            |   1 +
 .../pbs-modules/optable-targeting.md          | 315 ++++++++++++++++++
 2 files changed, 316 insertions(+)
 create mode 100644 prebid-server/pbs-modules/optable-targeting.md

diff --git a/prebid-server/pbs-modules/index.md b/prebid-server/pbs-modules/index.md
index 95b2eae9b5..59360ea4f8 100644
--- a/prebid-server/pbs-modules/index.md
+++ b/prebid-server/pbs-modules/index.md
@@ -36,6 +36,7 @@ The full list of modules:
 | [**Greenbids Real Time Data**](/prebid-server/pbs-modules/greenbids-real-time-data.html) | Filters out bidders that are not expected to bid on this request, saving money and carbon. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Request Correction**](/prebid-server/pbs-modules/request-correction.html) | Apply optional corrections to bid requests. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Response Correction**](/prebid-server/pbs-modules/response-correction.html) | Apply optional corrections to bid responses. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| [**Optable Targeting**](/prebid-server/pbs-modules/optable-targeting.html) | Enrich `user.ext.eids`, `user.ext.data`. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 
 ## Installing a PBS General Module
 
diff --git a/prebid-server/pbs-modules/optable-targeting.md b/prebid-server/pbs-modules/optable-targeting.md
new file mode 100644
index 0000000000..e93e15c3a4
--- /dev/null
+++ b/prebid-server/pbs-modules/optable-targeting.md
@@ -0,0 +1,315 @@
+---
+layout: page_v2
+page_type: pbs-module
+title: Prebid Server Optable Targeting Module
+display_name : Optable Targeting Module
+sidebarType : 5
+---
+
+{: .alert.alert-warning :}
+Optable module operates using a DCN backend API. Please contact your account manager to get started.
+
+# Optable Targeting Module
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The optable-targeting module enriches an incoming OpenRTB request by adding to the `user.eids` and `user.data`
+objects. Under the hood the module extracts PPIDs (publisher provided IDs) from the incoming request's `user.ext.eids`,
+and also if present sha256-hashed email, sha256-hashed phone, zip or Optable Visitor ID provided correspondingly in the
+`user.ext.optable.email`, `.phone`, `.zip`, `.vid` fields (a full list of IDs is given in a table below). These IDs are
+sent as input to the Targeting API. The received response data is used to enrich the OpenRTB request and response.
+Targeting API endpoint is configurable per publisher.
+
+## Setup
+
+### Execution Plan
+
+This module runs at two stages:
+
+* Processed Auction Request: to enrich `user.eids` and `user.data`.
+* Auction Response: to inject ad server targeting.
+
+We recommend defining the execution plan in the account config so the module is only invoked for specific accounts. See
+below for an example.
+
+### Global Config
+
+In the host-level config you need to specify the regional endpoint that would be closest to the host:
+
+```yaml
+hooks:
+  optable-targeting:
+    enabled: true
+  modules:
+    optable-targeting:
+      api-endpoint: https://na.edge.optable.co/v2/targeting?t={{TENANT}}&o={ORIGIN}
+```
+
+To obtain the endpoints for your regions - please contact [prebid@optable.co](mailto:prebid@optable.co).
+
+Note the endpoint contains 2 macros: {{TENANT}} and {ORIGIN} - the values for which are provided in the account-level config as `tenant` and `origin` parameters correspondingly.
+
+### Account-Level Config
+
+To start using current module in PBS-Java you have to enable module and add
+`optable-targeting-processed-auction-request-hook` and `optable-targeting-auction-response-hook` into hooks execution
+plan inside your config file:
+Here's a general template for the account config used in PBS-Java:
+
+```yaml
+hooks:
+  optable-targeting:
+    api-key: key
+    tenant: optable
+    origin: web-sdk-demo
+    ppid-mapping: { "pubcid.org": "c" }
+    adserver-targeting: true
+    cache:
+      enabled: false
+      ttlseconds: 86400
+  host-execution-plan: >
+    {
+      "endpoints": {
+        "/openrtb2/auction": {
+          "stages": {
+            "processed-auction-request": {
+              "groups": [
+                {
+                  "timeout": 100,
+                  "hook-sequence": [
+                    {
+                      "module-code": "optable-targeting",
+                      "hook-impl-code": "optable-targeting-processed-auction-request-hook"
+                    }
+                  ]
+                }
+              ]
+            },
+            "auction-response": {
+              "groups": [
+                {
+                  "timeout": 10,
+                  "hook-sequence": [
+                    {
+                      "module-code": "optable-targeting",
+                      "hook-impl-code": "optable-targeting-auction-response-hook"
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      }
+    }
+```
+
+### Timeout considerations
+
+The timeout value specified in the execution plan for the `processed-auction-request` hook is very important to be
+picked such that the hook has enough time to make a roundtrip to Optable Targeting Edge API over HTTP.
+
+**Note:** Do not confuse hook timeout value with the module timeout parameter which is optional. The hook timeout value
+would depend on the cloud/region where the PBS instance is hosted and the latency to reach the Optable's servers. This
+will need to be verified experimentally upon deployment.
+
+The timeout value for the `auction-response` can be set to 10 ms - usually it will be sub-millisecond time as there are
+no HTTP calls made in this hook - Optable-specific keywords are cached on the `processed-auction-request` stage and
+retrieved from the module invocation context later.
+
+### Caching
+
+The module uses [Prebid Cache Storage](https://docs.prebid.org/prebid-server/features/pbs-pbc-storage.html) feature that relies on the existing Prebid Cache Server. By default it is disabled, but if enabled it caches Targeting API responses for ttlseconds (24 hours by default) which reduces the module processing time to milliseconds, rather than hundreds of milliseconds, for the cached Targeting API responses. 
+
+## Module Configuration Parameters for PBS-Java
+
+The parameter names are specified with full path using dot-notation. F.e. `section-name` .`sub-section` .`param-name`
+would result in this nesting in the JSON configuration:
+
+```json
+{
+  "section-name": {
+    "sub-section": {
+      "param-name": "param-value"
+    }
+  }
+}
+```
+
+{: .table .table-bordered .table-striped }
+
+| Param Name         | Required | Type    | Default  value | Description                                                                                                                                                                                                                                                                                                                                                                                                                |
+|:-------------------|:---------|:--------|:---------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| api-endpoint       | yes      | string  | none           | Host-Level. Optable Targeting Edge API endpoint URL. Note it must: include {{TENANT}} and {ORIGIN} macros that are substituted from account-level config values |
+| tenant            | yes       | string  | none           | Account-Level. Your Optable tenant aka account ID. |
+| origin            | yes       | string  | none           | Account-Level. Optable data `origin` aka `source`. |
+| api-key            | no       | string  | none           | Account-Level. If the API is protected with a key - this param needs to be specified to be sent in the auth header |
+| ppid-mapping       | no       | map     | none           | Account-Level. This specifies PPID source (`user.ext.eids[].source`) to a custom identifier prefix mapping, f.e. `{"example.com" : "c"}`. See the section on ID Mapping below for more detail. |
+| adserver-targeting | no       | boolean | false          | Account-Level. If set to true - will add the Optable-specific adserver targeting keywords into the PBS response for every `seatbid[].bid[].ext.prebid.targeting` |
+| timeout            | no       | integer | false          | Account-Level. A soft timeout (in ms) sent as a hint to the Targeting API endpoint to  limit the request times to Optable's external tokenizer services |
+| id-prefix-order    | no       | string  | none           | Account-Level. An optional string of comma separated id prefixes that prioritizes and specifies the order in which ids are provided to Targeting API in a query string. F.e. "c,c1,id5" will guarantee that Targeting API will see id=c:...,c1:...,id5:... if these ids are provided.  id-prefixes not mentioned in this list will be added in arbitrary order after the priority prefix ids. This affects Targeting API processing logic |
+| cache.enabled    | no       | string  | false           | Account-Level. Optionally use [Prebid Cache Storage](https://docs.prebid.org/prebid-server/features/pbs-pbc-storage.html) feature - this significantly reduces the processing time when the Targeting API response has been cached |
+| cache.ttlseconds    | no       | int  | 86400           | Account-Level. The TTL in seconds for the Targeting API response to live in cache - by default is equal to 24 hours |
+
+## ID Mapping
+
+Internally the module sends requests to Optable Targeting API. The output of Targeting API is used to enrich the request
+and response. The below table describes the parameters that the module automatically fetches from OpenRTB request and
+then sends to the Targeting API. The module will use a prefix as specified in the table to prepend the corresponding ID
+value when sending it to the Targeting API in the form `id=prefix:value`.
+
+See [Optable documentation](https://docs.optable.co/optable-documentation/dmp/reference/identifier-types#type-prefixes)
+on identifier types. Targeting API accepts multiple id parameters - and their order may affect the results, thus
+`id-prefix-order` specifies the order of the ids.
+
+{: .table .table-bordered .table-striped }
+
+| Identifier Type                                                                | OpenRTB field                                                         | ID Type Prefix                           |
+|--------------------------------------------------------------------------------|-----------------------------------------------------------------------|------------------------------------------|
+| Email Address                                                                  | `user.ext.optable.email`                                              | `e:`                                     |
+| Phone Number                                                                   | `user.ext.optable.phone`                                              | `p:`                                     |
+| Postal Code                                                                    | `user.ext.optable.zip`                                                | `z:`                                     |
+| IPv4 Address                                                                   | `device.ip`                                                           | ~~i4:~~ Sent as `X-Forwarded-For` header |
+| IPv6 Address                                                                   | `device.ipv6`                                                         | ~~i6:~~ Sent as `X-Forwarded-For` header |
+| Apple IDFA                                                                     | `device.ifa if lcase(device.os) contains 'ios' and device.lmt!=1`     | `a:`                                     |
+| Google GAID                                                                    | `device.ifa if lcase(device.os) contains 'android' and device.lmt!=1` | `g:`                                     |
+| Roku RIDA                                                                      | `device.ifa if lcase(device.os) contains 'roku' and device.lmt!=1`    | `r:`                                     |
+| Samsung TV TIFA                                                                | `device.ifa if lcase(device.os) contains 'tizen' and device.lmt!=1`   | `s:`                                     |
+| Amazon Fire AFAI                                                               | `device.ifa if lcase(device.os) contains 'fire' and device.lmt!=1`    | `f:`                                     |
+| [NetID](https://docs.prebid.org/dev-docs/modules/userid-submodules/netid.html) | `user.ext.eids[].uids[0] when user.ext.eids[].source="netid.de"`      | `n:`                                     |
+| [ID5](https://docs.prebid.org/dev-docs/modules/userid-submodules/id5.html)     | `user.ext.eids[].uids[0] when user.ext.eids[].source="id5-sync.com"`  | `id5:`                                   |
+| [Utiq](https://docs.prebid.org/dev-docs/modules/userid-submodules/utiq.html)   | `user.ext.eids[].uids[0] when user.ext.eids[].source="utiq.com"`      | `utiq:`                                  |
+| Optable VID                                                                    | `user.ext.optable.vid`                                                | `v:`                                     |
+
+### Optable input erasure
+
+**Note**: `user.ext.optable.email`, `.phone`, `.zip`, `.vid` fields will be removed by the module from the original
+OpenRTB request before being sent to bidders.
+
+### Publisher Provided IDs (PPID) Mapping
+
+Custom user IDs are sent in the OpenRTB request in the
+[`user.ext.eids[]`](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#3227---object-eid-).
+The `ppid-mapping` allows to specify the mapping of a source to one of the custom identifier type prefixes `c`-`c19` -
+see [documentation](https://docs.optable.co/optable-documentation/dmp/reference/identifier-types#type-prefixes), f.e.:
+
+```yaml
+ppid-mapping: {"example.com": "c2", "test.com": "c3"}
+```
+
+It is also possible to override any of the automatically retrieved `user.ext.eids[]` mentioned in the table above (s.a.
+id5, utiq) so they are mapped to a different prefix. f.e. `id5-sync.com` can be mapped to a prefix other than `id5:`,
+like:
+
+```yaml
+ppid-mapping: {"id5-sync.com": "c1"}
+```
+
+This will lead to id5 ID supplied as `id=c1:...` to the Targeting API.
+
+## Analytics Tags
+
+The following 2 activities are recorded by the module in the corresponding ATags on the corresponding stages: 
+
+* `optable-enrich-request`
+* `optable-enrich-response`
+
+The `status` is either `success` or `failure`.  Where it is `failure` a `results[0].value.reason` is provided.  
+For the `optable-enrich-request` activity the `execution-time` value is logged. 
+Example:
+
+```json
+{
+    "analytics":
+    {
+        "tags":
+        [
+            {
+                "stage": "processed-auction-request",
+                "module": "optable-targeting",
+                "analyticstags":
+                {
+                    "activities":
+                    [
+                        {
+                            "name": "optable-enrich-request",
+                            "status": "success",
+                            "results":
+                            [
+                                {
+                                    "values":
+                                    {
+                                        "execution-time": "42"
+                                    }
+                                }
+                            ]
+                        }
+                    ]
+                }
+            },
+            {
+                "stage": "auction-response",
+                "module": "optable-targeting",
+                "analyticstags":
+                {
+                    "activities":
+                    [
+                        {
+                            "name": "optable-enrich-response",
+                            "status": "success",
+                            "results":
+                            [
+                                {
+                                    "values":
+                                    {
+                                        "reason": "none"
+                                    }
+                                }
+                            ]
+                        }
+                    ]
+                }
+            }
+        ]
+    }
+}
+```
+
+If `adserver-targeting` was set to `false` in the config `optable-enrich-response` analytics tag is not written.
+
+## Running the demo (PBS-Java)
+
+{:start="1"}
+
+1. Build the server bundle JAR as described in [Build Project](https://github.com/prebid/prebid-server-java/blob/master/docs/build.md#build-project), e.g.
+
+```bash
+mvn clean package --file extra/pom.xml
+```
+
+{:start="2"}
+2. Start server bundle JAR as described in [Running project](https://github.com/prebid/prebid-server-java/blob/master/docs/run.md#running-project), e.g.
+
+```bash
+java -jar target/prebid-server-bundle.jar --spring.config.additional-location=sample/configs/prebid-config-with-optable.yaml
+```
+
+{:start="3"}
+3. Run sample request against the server as described in [the sample directory](https://github.com/prebid/prebid-server-java/tree/master/sample), e.g.
+
+```bash
+curl http://localhost:8080/openrtb2/auction --data @extra/modules/optable-targeting/sample-requests/data.json
+```
+
+{:start="4"}
+4. Observe the `user.eids` and `user.data` objects enriched.
+
+## Maintainer contacts
+
+Any suggestions or questions can be directed to [prebid@optable.co](mailto:prebid@optable.co).
+
+Alternatively please open a new [issue](https://github.com/prebid/prebid-server-java/issues/new) or [pull request](https://github.com/prebid/prebid-server-java/pulls) in this repository.

From 35d76e781782f00f308aed2a13e2e2dfc5b53d4a Mon Sep 17 00:00:00 2001
From: Mikhail Malkov <mhlmlkv@gmail.com>
Date: Thu, 28 Aug 2025 10:04:17 +0300
Subject: [PATCH 304/665] nextMillenium: Fixed typo. (#6224)

* updated option safeframe_ok in documentation

* fixed typo
---
 dev-docs/bidders/nextMillennium.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/nextMillennium.md b/dev-docs/bidders/nextMillennium.md
index 4a8026a4ad..aeb84b347a 100644
--- a/dev-docs/bidders/nextMillennium.md
+++ b/dev-docs/bidders/nextMillennium.md
@@ -28,7 +28,7 @@ sidebarType: 1
 |----------------+----------+------------------------------------------+-----------------+-----------------|
 | `placement_id` | optional | Placement ID, provided by nextMillennium | `'12345'`       | String          |
 | `group_id`     | optional | Group ID, provided by nextMillennium     | `'12345'`       | String          |
-| `adSlots`      | optional | `adSlot` is a specific location or container on a webpage where an advertisement is displayed. | `["stickytop"]` | Array of String |
+| `adSlots`      | optional | `adSlots` is a specific location or container on a webpage where an advertisement is displayed. | `["stickytop"]` | Array of String |
 | `allowedAds`   | optional | `allowedAds` is a list of ad types or formats that are permitted to be shown in a specific ad slot. | `["skin"]`      | Array of String |
 
 Required one of the two parameters placement_id or group_id.

From 797fa020cc60714e30f2815c9376e1c0f16f219b Mon Sep 17 00:00:00 2001
From: pm-asit-sahoo <102290803+pm-asit-sahoo@users.noreply.github.com>
Date: Fri, 29 Aug 2025 20:02:59 +0530
Subject: [PATCH 305/665] PubMatic Analytics & ID System: Refactored the
 publisher Id & ProfileId code (#6133)

* Updated doc for pubmatic analytics and id system

* Update pubmatic.md
---
 dev-docs/analytics/pubmatic.md                 | 6 +++---
 dev-docs/modules/userid-submodules/pubmatic.md | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/dev-docs/analytics/pubmatic.md b/dev-docs/analytics/pubmatic.md
index 40d252b8fa..843acae59c 100644
--- a/dev-docs/analytics/pubmatic.md
+++ b/dev-docs/analytics/pubmatic.md
@@ -17,15 +17,15 @@ PubMatic team. Please reach out to your account team for more information.
 {: .table .table-bordered .table-striped }
 | Name         | Scope              | Description                                                                                                                 | Example                                                                             | Type             |
 |-------------|---------|--------------------|-----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|------------------|
-| publisherId | required  | The PubMatic Publisher ID | 1001  | int |
+| publisherId | required  | The PubMatic Publisher ID | "1001"  | string |
 
 ### Example Configuration
 
-```
+```javascript
     pbjs.enableAnalytics({
         provider: 'pubmatic',
         options: {
-            "publisherId": 12345 // please contact PubMatic to get a publisherId for yourself
+            "publisherId": "12345" // please contact PubMatic to get a publisherId for yourself
         }
     });
 ```
diff --git a/dev-docs/modules/userid-submodules/pubmatic.md b/dev-docs/modules/userid-submodules/pubmatic.md
index eded7445e3..296fe7cc3e 100644
--- a/dev-docs/modules/userid-submodules/pubmatic.md
+++ b/dev-docs/modules/userid-submodules/pubmatic.md
@@ -25,7 +25,7 @@ The following configuration parameters are available:
 | --- | --- | --- | --- | --- |
 | name | Required | String | The name of this sub-module | `"pubmaticId"` |
 | params ||| Details for the sub-module initialization ||
-| params.publisherId | Required | Number | Publisher ID | `123456` |
+| params.publisherId | Required | String | Publisher ID | `"123456"` |
 | storage |||||
 | storage.name | Required | String | The name of the cookie or html5 local storage key | `"pubmaticId"` |
 | storage.type | Required | String | This is where the PubMatic user ID will be stored | `"cookie&html5"` (recommended) or `"html5"` or `"cookie"` |
@@ -40,7 +40,7 @@ pbjs.setConfig({
     userIds: [{
       name: "pubmaticId",
       params: {
-        publisherId: 123456 // Example ID
+        publisherId: "123456" // Example ID
       },
       storage: {
         name: "pubmaticId",

From 27763819b50cb433d77cfde960e90f6902896778 Mon Sep 17 00:00:00 2001
From: abazylewicz-id5 <106807984+abazylewicz-id5@users.noreply.github.com>
Date: Fri, 29 Aug 2025 16:36:06 +0200
Subject: [PATCH 306/665] ID5 UserId - added docs for gamTargetingPrefix
 (#6178)

* ID5 UserId - added docs for gamTargetingPrefix

* ID5 UserId - add examples of GAM targeting tags

* ID5 UserId - update documentation to use GPID

TrueLink publisher ID is no longer returned as a standalone eid, and is used to produce GPID

* ID5 UserId - fix lint
---
 dev-docs/modules/userid-submodules/id5.md | 33 +++++++++++++++++------
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/id5.md b/dev-docs/modules/userid-submodules/id5.md
index 2a056307d8..a5325134a0 100644
--- a/dev-docs/modules/userid-submodules/id5.md
+++ b/dev-docs/modules/userid-submodules/id5.md
@@ -42,6 +42,7 @@ The following configuration parameters are available:
 | params.disableExtensions | Optional | Boolean | Set this to `true` to force turn off extensions call. Default `false` | `true` or `false` |
 | params.canCookieSync | Optional | Boolean | Set this to `true` to enable cookie syncing with other ID5 partners. See [our documentation](https://wiki.id5.io/docs/initiate-cookie-sync-to-id5) for details. Default `false` | `true` or `false` |
 | params.provider | Optional | String | An identifier provided by ID5 to technology partners who manage API deployments on behalf of their clients. Reach out to ID5 if you have questions about this parameter. | `"providerName"` |
+| params.gamTargetingPrefix | Optional | String  | When this parameter is set the ID5 module will set appropriate GAM pubads targeting tags                                                                                                                                                                                            | `"id5"`                                               |
 
 {: .alert.alert-info :}
 **NOTE:** The ID5 ID that is delivered to Prebid will be encrypted by ID5 with a rotating key to avoid unauthorized usage and to enforce privacy requirements. Therefore, we strongly recommend setting `storage.refreshInSeconds` to `2` hours (`7200` seconds) or less to ensure all demand partners receive an ID that has been encrypted with the latest key, has up-to-date privacy signals, and allows them to transact against it.
@@ -52,6 +53,19 @@ Publishers may want to test the value of the ID5 ID with their downstream partne
 
 To turn on A/B Testing, simply edit the configuration (see above table) to enable it and set what percentage of users you would like to set for the control group. The control group is the set of user where an ID5 ID will not be exposed in to bid adapters or in the various user id functions available on the `pbjs` global. An additional value of `ext.abTestingControlGroup` will be set to `true` or `false` that can be used to inform reporting systems that the user was in the control group or not. It's important to note that the control group is user based, and not request based. In other words, from one page view to another, a user will always be in or out of the control group.
 
+Since [Prebid version 9.42.0](https://github.com/prebid/Prebid.js/releases/tag/9.42.0) an [Enrichment Lift module](https://docs.prebid.org/dev-docs/modules/enrichmentLiftMeasurement.html) is available which also supports A/B Testing. It should not be configured for ID5 UserId Module if the `params.abTesting.enabled` is set to `true`.
+
+### Tags set by GAM targeting
+
+The ID5 UserId module can set GAM targeting tags, if enabled by setting the `params.gamTargetingPrefix`. 
+The prefix used should be unique on the property - if more than one Prebid integration is used, the prefix should be different for each integration. 
+If the same prefix is used, the ID5 module will overwrite the existing GAM targeting tags.
+
+If `params.gamTargetingPrefix` is set to a non-empty value and an ID5 module has initialized, the ID5 module will set the following GAM targeting tags:
+
+- `{prefix}_id` - set to `y` if a valid id5id was present, otherwise tag is not set
+- `{prefix}_ab` - set if `abTesting` was enabled - `n` if in Normal group (with ID5 returned), `c` if in Control group (without ID5 returned)
+
 ### A Note on Using Multiple Wrappers
 If you or your monetization partners are deploying multiple Prebid wrappers on your websites, you should make sure you add the ID5 ID User ID module to *every* wrapper. Only the bidders configured in the Prebid wrapper where the ID5 ID User ID module is installed and configured will be able to pick up the ID5 ID. Bidders from other Prebid instances will not be able to pick up the ID5 ID.
 
@@ -72,7 +86,8 @@ pbjs.setConfig({
           enabled: true,         // false by default
           controlGroupPct: 0.1   // valid values are 0.0 - 1.0 (inclusive)
         },
-        canCookieSync: true      // optional, has effect only when externalModuleUrl is used 
+        canCookieSync: true,      // optional, has effect only when externalModuleUrl is used
+        gamTargetingPrefix: "id5" // optional, when set the ID5 module will set gam targeting paramaters with this prefix
       },
       storage: {
         type: 'html5',           // "html5" is the recommended storage type
@@ -108,10 +123,10 @@ The module provides following eids:
     ]
   },
   {
-    source: 'true-link-id5-sync.com',
+    source: 'gpid.id5-sync.com',
     uids: [
       {
-        id: 'some-publisher-true-link-id',
+        id: 'some-publisher-gp-id',
         atype: 1
       }
     ]
@@ -133,18 +148,20 @@ The module provides following eids:
 
 The id from `id5-sync.com` should be always present (though the id provided will be '0' in case of no consent or optout)
 
-The id from `true-link-id5-sync.com` will be available if the page is integrated with TrueLink (if you are an ID5 partner you can learn more at [ID5 wiki](https://wiki.id5.io/en/identitycloud/retrieve-id5-ids/true-link-integration))
+The id from `gpid.id5-sync.com` will be available if the publisher has enabled Guarded Publisher ID [ID5 wiki](https://wiki.id5.io/docs/guarded-publisher-id)
+
+The id from `uidapi.com` will be available if the partner used in ID5 user module has the EUID2 integration enabled (it has to be enabled on the ID5 side)
 
-The id from `uidapi.com` will be available if the partner that is used in ID5 user module has the EUID2 integration enabled (it has to be enabled on the ID5 side)
+Additional EIDS may be provided if the publisher has enabled bid enrichment with ID5. 
 
-### Providing TrueLinkId as a Google PPID
+### Providing Guarded Publisher ID as a Google PPID
 
-TrueLinkId can be provided as a PPID - to use, it the `true-link-id5-sync.com` needs to be provided as a ppid source in prebid userSync configuration:
+GPID can be provided as a PPID - to use, it the `gpid.id5-sync.com` needs to be provided as a ppid source in prebid userSync configuration:
 
 ```javascript
 pbjs.setConfig({
   userSync: {
-    ppid: 'true-link-id5-sync.com',
+    ppid: 'gpid.id5-sync.com',
     userIds: [],  //userIds modules should be configured here
   }
 });

From 0970b1afa3fd88a9f088685af921140693ba5984 Mon Sep 17 00:00:00 2001
From: Ivan-Z-Oprx <izivkovic@optimizerx.com>
Date: Fri, 29 Aug 2025 16:41:58 +0200
Subject: [PATCH 307/665] adunit format added (#6188)

* adunit format added

* removed tabs
---
 dev-docs/bidders/oprx.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/dev-docs/bidders/oprx.md b/dev-docs/bidders/oprx.md
index 3aa40d163a..6181d56634 100644
--- a/dev-docs/bidders/oprx.md
+++ b/dev-docs/bidders/oprx.md
@@ -36,3 +36,34 @@ privacy_sandbox: no
 | `npi`         | optional | NPI                    | `'22222'`  | `string`  |
 | `ndc`         | optional | NDC                    | `'33333'`  | `string`  |
 | `type`        | required | Type of Bid/Impression | `'banner'` | `string`  |
+
+### AdUnit Format
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[728, 90]]
+          }
+        },
+    bids: [
+      {
+        bidder: 'oprx',
+        params: {
+            placement_id: 1234567890,   // placement ID (required)
+            key: "123456abcd",          // key (required)
+            width: 728,                 // width
+            height: 90,                 // height
+            bid_floor: 0.5,             // bidding price floor
+            npi: "1234567890",          // NPI
+            ndc: "12345678901"          // NDC
+            type: "banner",             // media type (required)
+          },
+        }
+      }
+    ]
+  }
+];
+```

From 24737f567e48e4a846ef9c02666e7b66eb13788c Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 29 Aug 2025 16:56:57 +0200
Subject: [PATCH 308/665] Update medianet.md: video is optional and not
 required (#6232)

The `video` in the Bid Params is optional for video ad units and not required.

Reasons:

* The example further down in the docs "Example of Instream Video Ad-unit" doesn't contain a `video` in the bids params.
* The actual code in the bid adapter can deal with missing video. See https://github.com/prebid/Prebid.js/blob/fb3f801f4099798b1dd6e1aeb9e3dfc6e41982c9/modules/medianetBidAdapter.js#L215 :

```javascript
  const videoInMediaType = deepAccess(bidRequest, 'mediaTypes.video') || {};
  const videoInParams = deepAccess(bidRequest, 'params.video') || {};
  const videoCombinedObj = Object.assign({}, videoInParams, videoInMediaType);
```
---
 dev-docs/bidders/medianet.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/medianet.md b/dev-docs/bidders/medianet.md
index 383d449526..b51de7b4b6 100644
--- a/dev-docs/bidders/medianet.md
+++ b/dev-docs/bidders/medianet.md
@@ -36,7 +36,7 @@ endpoint_compression: false
 | `cid`      | required | The customer id provided by Media.net. | `'8CUX0H51C'` | `string` |
 | `crid`     | required | The placement id provided by Media.net | `'1234567'`   | `string` |
 | `bidfloor` | optional | Bidfloor for the impression          | `1.0`         | `float`  |
-| `video`    | required for video Ad units | Object containing video targeting parameters.  See [Video Object](#media.net-video-object) for details.|`video: { maxduration: 60 }`         | `object`  |
+| `video`    | optional for video Ad units | Object containing video targeting parameters.  See [Video Object](#media.net-video-object) for details.|`video: { maxduration: 60 }`         | `object`  |
 
 <a name="media.net-video-object"></a>
 

From 6ed51e4ad68ba2f6074b8e93a089d5d0b3788862 Mon Sep 17 00:00:00 2001
From: Chris Huie <phoenixtechnerd@gmail.com>
Date: Mon, 1 Sep 2025 13:54:58 -0600
Subject: [PATCH 309/665] Typo Fix in Js Getting Started for Developers (#6226)

---
 dev-docs/getting-started.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/getting-started.md b/dev-docs/getting-started.md
index 0990fa77b7..7a770f5d5b 100644
--- a/dev-docs/getting-started.md
+++ b/dev-docs/getting-started.md
@@ -15,7 +15,7 @@ sidebarType: 1
 
 ## Overview
 
-To run heading bidding on your site with Prebid.js you need to [download the Prebid.js package](/download.html), including your selected bidders and adapters, and add the code to your page. This code will gather bids from your selected demand sources (bidders) and pass the information on to your ad server. For full details on how Prebid.js works, see [What is Prebid.js?](/prebid/prebidjs.html).
+To run header bidding on your site with Prebid.js you need to [download the Prebid.js package](/download.html), including your selected bidders and adapters, and add the code to your page. This code will gather bids from your selected demand sources (bidders) and pass the information on to your ad server. For full details on how Prebid.js works, see [What is Prebid.js?](/prebid/prebidjs.html).
 
 Developers should work with their ad ops team to plan out your Prebid configuration. You'll need to add information to your code regarding things such as:
 

From d87b219abe553fa3a6f1c8b372696f139d9d9a72 Mon Sep 17 00:00:00 2001
From: prebid-startio <prebid@start.io>
Date: Mon, 1 Sep 2025 23:04:13 +0300
Subject: [PATCH 310/665] Update Start.io adapter documentation with additional
 features supported (#6110)

- coppa_supported
- floors_supported
- usp_supported
- ortb_blocking_supported
---
 dev-docs/bidders/startio.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/startio.md b/dev-docs/bidders/startio.md
index 72dd7fbd2a..a74aeb448b 100644
--- a/dev-docs/bidders/startio.md
+++ b/dev-docs/bidders/startio.md
@@ -4,21 +4,21 @@ title: Start.io
 biddercode: startio
 description: Prebid Start.io Adapter
 tcfeu_supported: true
-coppa_supported: false
+coppa_supported: true
 gpp_supported: false
-floors_supported: false
+floors_supported: true
 media_types: banner, video, native
 multiformat_supported: will-bid-on-any
 safeframes_ok: false
 schain_supported: false
 gvl_id: 1216
-usp_supported: false
+usp_supported: true
 pbjs: true
 pbs: true
 prebid_member: false
 fpd_supported: false
 privacy_sandbox: no
-ortb_blocking_supported: false
+ortb_blocking_supported: true
 sidebarType: 1
 ---
 

From a1829fa8c04d2a477f5b057d5b048ebd734e0ab2 Mon Sep 17 00:00:00 2001
From: tccdeniz <cansin.deniz@turkcell.com.tr>
Date: Mon, 1 Sep 2025 23:06:07 +0300
Subject: [PATCH 311/665] Added and updated AdPlus docs (#6114)

* Added and updated AdPlus docs

* Fixed linter issues
---
 dev-docs/analytics/adplus.md                 | 18 ++++++++
 dev-docs/bidders/adplus.md                   |  3 +-
 dev-docs/modules/userid-submodules/adplus.md | 43 ++++++++++++++++++++
 3 files changed, 63 insertions(+), 1 deletion(-)
 create mode 100644 dev-docs/analytics/adplus.md
 create mode 100644 dev-docs/modules/userid-submodules/adplus.md

diff --git a/dev-docs/analytics/adplus.md b/dev-docs/analytics/adplus.md
new file mode 100644
index 0000000000..4154d7973e
--- /dev/null
+++ b/dev-docs/analytics/adplus.md
@@ -0,0 +1,18 @@
+---
+layout: analytics
+title: AdPlus
+description: AdPlus Analytics Adapter
+modulecode: appier
+---
+
+#### About
+
+Analytics adapter for AdPlus platform. Contact [adplusdestek@turkcell.com.tr](adplusdestek@turkcell.com.tr) if you have any questions about integration.
+
+#### Example Configuration
+
+```javascript
+pbjs.enableAnalytics({
+    provider: 'adplus',
+});
+```
diff --git a/dev-docs/bidders/adplus.md b/dev-docs/bidders/adplus.md
index 58112efcb7..367c324b1b 100644
--- a/dev-docs/bidders/adplus.md
+++ b/dev-docs/bidders/adplus.md
@@ -4,13 +4,14 @@ title: AdPlus
 description: Prebid AdPlus Bidder Adapter
 biddercode: adplus
 media_types: banner
+userIds: all
 pbjs: true
 sidebarType: 1
 ---
 
 ### Note
 
-The AdPlus Bidding adapter requires setup before beginning. Please contact us at <adplusdestek@turkcell.com.tr>.
+The AdPlus Bidding adapter requires setup before beginning. Please contact us at <dijitalreklam@turkcell.com.tr>.
 
 ### Bid Params
 
diff --git a/dev-docs/modules/userid-submodules/adplus.md b/dev-docs/modules/userid-submodules/adplus.md
new file mode 100644
index 0000000000..fefbb4611c
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/adplus.md
@@ -0,0 +1,43 @@
+---
+layout: userid
+title: AdPlus ID
+description: AdPlus ID User ID sub-module
+useridmodule: adplusIdSystem
+bidRequestUserId: adplusId
+eidsource: ad-plus.com.tr
+example: '"1111"'
+---
+
+## AdPlus ID Configuration
+
+Please make sure to add the AdPlus user ID sub-module to your Prebid.js package with:
+
+```shell
+gulp build --modules=adplusIdSystem,userId
+```
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | The name of this module: `"adplusId"` | `"adplusId"` |
+| storage.expires | Optional | Number | How long (in days) the user ID information will be stored | `7` (recommended) |
+| storage.refreshInSeconds | Optional | Number | How many seconds until the ID is refreshed | `24 * 3600` (recommended) |
+
+## AdPlus ID Example
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [{
+            name: "adplusId",
+            storage: {
+                name: "adplusId",
+                type: "cookie&html5",
+                expires: 7,
+                refreshInSeconds: 24 * 3600
+            }
+        }]
+    }
+});
+```

From b28fa9954a9626f9d7c3d80b010ab1d703f9b48d Mon Sep 17 00:00:00 2001
From: Ritesh <ritesh.ghodrao@gmail.com>
Date: Tue, 2 Sep 2025 12:05:56 +0530
Subject: [PATCH 312/665] added inmobi mobile plugin renderer (#6234)

Co-authored-by: Ritesh Ghodrao <ritesh.ghodrao@inmobi.com>
---
 prebid-mobile/pbm-api/android/pbm-plugin-renderer.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/prebid-mobile/pbm-api/android/pbm-plugin-renderer.md b/prebid-mobile/pbm-api/android/pbm-plugin-renderer.md
index 626341cd65..d8233c6ca3 100755
--- a/prebid-mobile/pbm-api/android/pbm-plugin-renderer.md
+++ b/prebid-mobile/pbm-api/android/pbm-plugin-renderer.md
@@ -267,3 +267,4 @@ The following list contains documentation for known supported Plugin Renderer pr
 | Company | Documentation                                                                                 |
 |-------|-----------------------------------------------------------------------------------------------|
 | Teads | [Teads Plugin Renderer Docs](https://support.teads.tv/support/solutions/articles/36000459747) |
+| InMobi | [InMobi Plugin Renderer Docs](https://support.inmobi.com/monetize/integrating-inmobi-with-mediation/prebid-plugin-renderer) |

From 1e74b85e8a4600f2c67e9155a38fff3293d9575c Mon Sep 17 00:00:00 2001
From: Chris Huie <phoenixtechnerd@gmail.com>
Date: Tue, 2 Sep 2025 00:36:58 -0600
Subject: [PATCH 313/665] Update TIDs for pr that made them bidder specific
 (#6229)

* Update firstPartyData.md

* Update bidder-adaptor.md

* Update bidder-adaptor.md

* Update setConfig#enableTIDs

---------

Co-authored-by: Demetrio Girardi <dgirardi@prebid.org>
---
 dev-docs/bidder-adaptor.md                    |  3 ++-
 dev-docs/publisher-api-reference/setConfig.md |  4 +++-
 features/firstPartyData.md                    | 18 ------------------
 3 files changed, 5 insertions(+), 20 deletions(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index e6f682b11f..8aafc724bf 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -380,7 +380,8 @@ Some of the data in `ortb2` is also made available through other `bidderRequest`
 <a id="tid-warning"></a>
 
 {: .alert.alert-warning :}
-Since version 8, `auctionId` and `transactionId` are being migrated to `ortb2.source.tid` and `ortb2Imp.ext.tid` respectively; and are disabled by default, requiring [publisher opt-in](https://docs.prebid.org/dev-docs/pb8-notes.html#transaction-identifiers-are-now-reliable-and-opt-in).
+Since version 8, `auctionId` and `transactionId` are being migrated to `ortb2.source.tid` and `ortb2Imp.ext.tid` respectively. As of 10.9.0, these values are now generated to be unique for each bidder. They are also disabled by default, requiring [publisher opt-in](https://docs.prebid.org/dev-docs/pb8-notes.html#transaction-identifiers-are-now-reliable-and-opt-in). 
+
 When disabled, `auctionId`/`transactionId` are set to `null`; `ortb2.source.tid`/`ortb2Imp.ext.tid` are not populated. Your adapter should prefer the latter two, and be able to handle the case when they are undefined.
 
 <a name="std-param-location"></a>
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 3b8efb71d6..2a4eb21edb 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -78,13 +78,15 @@ For more information about the asynchronous event loop and `setTimeout`, see [Ho
 <a id="setConfig-enableTIDs"></a>
 
 ### Enable sharing of transaction IDs
-
 Prebid generates unique IDs for both auctions and ad units within auctions; these can be used by DSPs to correlate requests from different sources, which is useful for many applications but also a potential privacy concern. Since version 8 they are disabled by default (see [release notes](/dev-docs/pb8-notes.html)), and can be re-enabled with `enableTIDs`:
 
 ```javascript
 pbjs.setConfig({ enableTIDs: true });
 ```
 
+{: .alert.alert-warning :}
+Since version 10.9.0 transaction IDs are unique for each bidder and cannot be used to correlate requests from different sources, even when `enableTIDs` is set.  
+
 ### Max Requests Per Origin
 
 <a name="setConfig-Max-Requests-Per-Origin"></a>
diff --git a/features/firstPartyData.md b/features/firstPartyData.md
index c932919c14..e4eea093ee 100644
--- a/features/firstPartyData.md
+++ b/features/firstPartyData.md
@@ -272,24 +272,6 @@ pbjs.addAdUnits({
 });
 ```
 
-You may also specify adUnit-specific transaction IDs using `ortb2Imp.ext.tid`, and Prebid will use them instead of generating random new ones. This is useful if you are auctioning the same slots through multiple header bidding libraries. Note: you must take care to not re-use the same transaction IDs across different ad units or auctions. Here's a simplified example passing a tid through the [requestBids](/dev-docs/publisher-api-reference/requestBids.html) function:
-
-```javascript
-const tid = crypto.randomUUID();
-pbjs.requestBids({
-   adUnits: [{
-    code: 'test-div',
-    // ...
-    ortb2Imp: {
-        ext: {
-          tid: tid
-        }
-    }
-   }]
-});
-// reuse `tid` when auctioning `test-div` through some other header bidding wrapper   
-```
-
 {: .alert.alert-info :}
 Prebid does not support AdUnit-specific **user** data, nor does it support
 bidder-specific AdUnit First Party Data. You could implement either of

From 5d9b332ee9c93e7b2217b735a2d50ed9f5c86cf2 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Tue, 2 Sep 2025 08:38:05 +0200
Subject: [PATCH 314/665] new adapter stellorMediaRtb (#6209)

* new adapter stellorMediaRtb

* update doc

* update doc

---------

Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/stellorMediaRtb.md | 37 +++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/stellorMediaRtb.md

diff --git a/dev-docs/bidders/stellorMediaRtb.md b/dev-docs/bidders/stellorMediaRtb.md
new file mode 100644
index 0000000000..608c087082
--- /dev/null
+++ b/dev-docs/bidders/stellorMediaRtb.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Stellor Media Rtb
+description: Prebid Stellor Media Rtb Adaptor
+biddercode: stellorMediaRtb
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                  | Example                  | Type      |
+|:--------------|:---------|:-------------------------------------------------------------|:-------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                        | `'rtb-stellormedia.com'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Stellor Media Rtb Platform.  | `42`                     | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                      | `'banner'`               | `string`  |
+| `publisherId` | required | Publisher ID                                                 | `'12345'`                | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                     | `'custom1'`              | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                     | `'custom2'`              | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                     | `'custom3'`              | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                     | `'custom4'`              | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                     | `'custom5'`              | `string`  |

From 2caf56fe027ed8f28af1ecc76333a1a668192798 Mon Sep 17 00:00:00 2001
From: Chris Huie <phoenixtechnerd@gmail.com>
Date: Wed, 3 Sep 2025 07:46:27 -0600
Subject: [PATCH 315/665] Update dailymotion.md (#6239)

---
 dev-docs/bidders/dailymotion.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/dailymotion.md b/dev-docs/bidders/dailymotion.md
index a0743ff8d4..39d55b417a 100644
--- a/dev-docs/bidders/dailymotion.md
+++ b/dev-docs/bidders/dailymotion.md
@@ -2,6 +2,7 @@
 layout: bidder
 title: Dailymotion
 description: Dailymotion Prebid Bidder Adapter
+prebid_member: true
 pbjs: true
 pbs: false
 biddercode: dailymotion

From 58f2e75f9474864af0261020dcbaf5da9736f66c Mon Sep 17 00:00:00 2001
From: Leandro Marty <leandro.marty@rocketlab.ai>
Date: Thu, 4 Sep 2025 08:27:44 +0200
Subject: [PATCH 316/665] pbs set to true (#6105)

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

diff --git a/dev-docs/bidders/rocketlab.md b/dev-docs/bidders/rocketlab.md
index 333dd71d52..1c5e47cb7f 100644
--- a/dev-docs/bidders/rocketlab.md
+++ b/dev-docs/bidders/rocketlab.md
@@ -16,7 +16,7 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: false
 safeframes_ok: true
 sidebarType: 1

From e95f2a5c45fe527970e359b167c08a85bba5360a Mon Sep 17 00:00:00 2001
From: dev-adverxo <developer@adverxo.com>
Date: Thu, 4 Sep 2025 08:30:42 +0200
Subject: [PATCH 317/665] Remove mobupps adapter (#6009)

Co-authored-by: Adverxo <adverxo@adverxo.com>
---
 dev-docs/bidders/mobupps.md | 115 ------------------------------------
 1 file changed, 115 deletions(-)
 delete mode 100644 dev-docs/bidders/mobupps.md

diff --git a/dev-docs/bidders/mobupps.md b/dev-docs/bidders/mobupps.md
deleted file mode 100644
index f7c827efff..0000000000
--- a/dev-docs/bidders/mobupps.md
+++ /dev/null
@@ -1,115 +0,0 @@
----
-layout: bidder
-title: Mobupps
-description: Prebid Mobupps Bidder Adapter
-aliasCode: adverxo
-pbjs: true
-pbs: true
-pbs_app_supported: true
-biddercode: mobupps
-userIds:
-media_types: banner, native, video
-schain_supported: true
-dchain_supported: false
-ortb_blocking_supported: true
-floors_supported: true
-multiformat_supported: will-bid-on-any
-tcfeu_supported: false
-dsa_supported: false
-gvl_id: none
-usp_supported: false
-coppa_supported: false
-gpp_sids: none
-userId: no
-safeframes_ok: false
-deals_supported: true
-fpd_supported: true
-prebid_member: false
-privacy_sandbox: no
-sidebarType: 1
----
-
-### Note
-
-The Mobupps Bidding adapter requires setup and approval before beginning. Please reach out to <mobupps.prebid@adverxo.com> for
-more details.
-
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name | Scope | Description | Example | Type |
-|----------|----------|-----------------------|---------------------------|----------|
-| `adUnitId`   | required | Unique identifier for the ad unit in Mobupps platform. | `1` | `integer` |
-| `auth`       | required | Authentication token provided by Mobupps platform for the AdUnit. | `'61336e75e414c77c367eq5c47c2599ce80a8032b'` | `string` |
-
-### Setting First Party Data (FPD)
-
-Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
-
-- ortb2.site.\*
-- ortb2.app.\*
-- ortb2.user.\*
-
-Example first party data:
-
-```javascript
-pbjs.setConfig({
-    ortb2: {
-        site: {
-            keywords: "kw1,kw2",
-            content: {
-                title: "title1",
-                series: "series1"
-            }
-        },
-        user: {
-            keywords: "a,b",
-            gender: "M",
-            yob: 1984
-        }
-    }
-});
-```
-
-### ORTB Blocking
-
-Mobupps supports the next blocking parameters:
-
-- Blocked advertisers list (`badv`) is an array of domains as strings.
-- Blocked apps list (`bapp`) is an array of apps names as strings, for mobile apps in Google Play Store, these should be
-  bundle or package names (e.g. com.foo.mygame). For apps in Apple App Store, these should be a numeric ID.
-- Blocked categories list (`bcat`) is an array of IAB categories as strings.
-- Blocked attributes list (`battr`) is an array of integers. Refer to section 5.3 of the IAB specification for a list of
-  attributes.
-
-#### Globally defined ORTB Blocking
-
-```javascript
-pbjs.setConfig({
-    ortb2: {
-        badv: ["domain1.com", "domain2.com"],
-        bapp: ["com.foo.mygame", "284708449"],
-        bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
-    }
-});
-```
-
-#### ORTB Blocking specific only to the Mobupps bidder
-
-```javascript
-pbjs.setBidderConfig({
-    bidders: ['mobupps'], // Or alias
-    config: {
-        ortb2: {
-            badv: ["domain1.com", "domain2.com"],
-            bapp: ["com.foo.mygame"],
-            bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
-        }
-    }
-});
-```
-
-#### Media Type defined ORTB Blocking
-
-Additionally `battr` ORTB blocking param may be set on media types to specify blocked creative
-attributes. Refer to section 5.3 of the IAB specification for a list of attributes.

From bcb1483a4b8746e92d5f34fc0569c7e8a7defec5 Mon Sep 17 00:00:00 2001
From: patryk-grzegorczyk
 <131142828+patryk-grzegorczyk@users.noreply.github.com>
Date: Thu, 4 Sep 2025 10:15:52 +0200
Subject: [PATCH 318/665] Removed adocean adapter (#5991)

---
 dev-docs/bidders/adocean.md | 33 ---------------------------------
 1 file changed, 33 deletions(-)
 delete mode 100644 dev-docs/bidders/adocean.md

diff --git a/dev-docs/bidders/adocean.md b/dev-docs/bidders/adocean.md
deleted file mode 100644
index 689ea32ecf..0000000000
--- a/dev-docs/bidders/adocean.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: bidder
-title: AdOcean
-description: Prebid AdOcean Bidder Adaptor
-pbjs: true
-pbs: true
-biddercode: adocean
-tcfeu_supported: true
-gvl_id: 328
-sidebarType: 1
----
-
-### Note
-
-The AdOcean bid adapter may require an additional setup from the AdOcean team. Please contact with your local Technical Support team or by visiting [AdOcean website](https://adocean-global.com/en/contact/).
-
-### Prebid.JS Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name     | Scope    | Description       | Example                                            | Type     |
-|----------|----------|-------------------|----------------------------------------------------|----------|
-| slaveId  | required | slave ID          | `'adoceanmyaozpniqismex'`                          | `string` |
-| masterId | required | master ID         | `'tmYF.DMl7ZBq.Nqt2Bq4FutQTJfTpxCOmtNPZoQUDcL.G7'` | `string` |
-| emiter   | required | traffic source id | `'myao.adocean.pl'`                                | `string` |
-
-### Prebid Server Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                                           | Example                                            | Type     |
-|---------------|----------|-------------------------------------------------------|----------------------------------------------------|----------|
-| slaveId       | required | slave ID                                              | `'adoceanmyaozpniqismex'`                          | `string` |
-| masterId      | required | master ID                                             | `'tmYF.DMl7ZBq.Nqt2Bq4FutQTJfTpxCOmtNPZoQUDcL.G7'` | `string` |
-| emitterPrefix | required | AdOcean emitter prefix                                | `'myao'`                                           | `string` |

From 33098ddeaedbe4dd0fe57e8317c7fe941b07e504 Mon Sep 17 00:00:00 2001
From: Komal Kumari <169047654+pm-komal-kumari@users.noreply.github.com>
Date: Mon, 8 Sep 2025 12:30:50 +0530
Subject: [PATCH 319/665] Update documentation for PubMatic Bid Adapter (#6240)

* Update documentation for Pubmatic Bid Adapter

* Fix linter error for dctr row

* Fix linter error of ul for fpd section

---------

Co-authored-by: Komal Kumari <komalkumari@Komals-MacBook-Pro-L1834.local>
---
 dev-docs/bidders/pubmatic.md | 350 ++++++++++++++++++++++++-----------
 1 file changed, 243 insertions(+), 107 deletions(-)

diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 873b0d36b6..39991554a3 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -14,48 +14,71 @@ floors_supported: true
 userIds: all
 prebid_member: true
 safeframes_ok: true
+deals_supported: true
 pbjs: true
 pbs: true
 pbs_app_supported: true
 fpd_supported: true
 ortb_blocking_supported: true
 gvl_id: 76
-multiformat_supported: will-bid-on-one
+multiformat_supported: true
 sidebarType: 1
 endpoint_compression: true
 ---
 
+### Table of contents
+
+* [Introduction](#introduction)
+* [Bid Params](#bid-params)
+* [First Party Data](#first-party-data)
+* [UserSync](#usersync)
+* [adSlot](#adslot)
+* [Banner](#banner)
+* [Video](#video)
+* [Native](#native)
+* [Multi-format](#multi-format)
+* [Prebid Server](#prebid-server)
+* [Endpoint Compression](#endpoint-compression)
+
+### Introduction
+
+Publishers can use Prebid.js to call PubMatic in any of the following ways:
+
+* **Call through our client-side adapter**: Prebid.js calls PubMatic directly from the browser using our client-side adapter.
+* **Call through our server-side adapter**: Prebid.js makes a call to Prebid Server and then Prebid Server uses our server-side adapter to call PubMatic.
+
+We highly recommend adding the `gptPreAuction` module to populate GPID (Global Placement ID) values. See the [gptPreAuction module documentation](https://docs.prebid.org/dev-docs/modules/gptPreAuction.html) for implementation details.
+
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name            | Scope    | Description                                                                                                                                                                                                                                                                       | Example                                                   | Type               |
 |-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------|--------------------|
-| `publisherId`   | required | Publisher ID                                                                                                                                                                                                                                                                      | `'32572'`                                                 | `string`           |
-| `adSlot`        | optional | Ad Slot Name (see below)                                                                                                                                                                                                                                                           | `'38519891'`                                              | `string`           |
-| `pmzoneid`      | optional | Zone ID                                                                                                                                                                                                                                                                            | `'zone1,zone2'`                                           | `string`           |
-| `lat`           | optional | Latitude<br>Supported until Prebid version 7.54.4 and starting from version 8.11.0, can be configured using ortb2.device or ortb2.user                                                                                                                               | `'40.712775'`                                             | `string`           |
-| `lon`           | optional | Longitude<br>Supported until Prebid version 7.54.4 and starting from version 8.11.0, can be configured using ortb2.device or ortb2.user                                                                                                                             | `'-74.005973'`                                            | `string`           |
-| `yob`           | optional | Year of Birth                                                                                                                                                                                                                                                                     | `'1982'`                                                  | `string`           |
-| `gender`        | optional | Gender                                                                                                                                                                                                                                                                            | `'M'`                                                     | `string`           |
-| `kadpageurl`    | optional | Overrides Page URL                                                                                                                                                                                                                                                                | `'http://www.yahoo.com/'`                                 | `string`           |
-| `kadfloor`      | optional | Bid Floor                                                                                                                                                                                                                                                                         | `'1.75'`                                                  | `string`           |
-| `currency`      | optional | Bid currency<br><i>(Value configured only in the 1st adunit will be passed on. Values if present in subsequent adunits, will be ignored.)</i> | `'AUD'` | `string` |
-| `dctr`          | optional | Deal Custom Targeting<br><i>(Value configured in each adunit will be passed inside adunit configs i.e., imp.ext)</i>                                                                                                                                                             | `'key1=123\|key2=345'`                                     | `string`           |
-| `acat`          | optional | Allowed categories<br><i>(Can be sent via ortb2 or slot-level params. If both are present, ortb2 takes priority.)</i>                                                                                                                                                            | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]`                         | `array of strings` |
-| `bcat`          | optional | Blocked IAB Categories<br><i>(Combined across all slots, unique values only. Each must be a string with more than 3 characters.)</i>                                                                                                                                                      | `[ 'IAB1-5', 'IAB1-6', 'IAB1-7' ]`                         | `array of strings` |
-| `deals`         | optional | PMP deals<br><i>(Passed per slot. Each deal-id should be a string with more than 3 characters.)</i>                                                                                                                                                                                         | `[ 'deal-id-5', 'deal-id-6', 'deal-id-7' ]`               | `array of strings` |
-| `outstreamAU`   | optional | Outstream AdUnit described in Blue BillyWig UI *(Required if mimeType is video and context is outstream)*                                                                                                                                                                 | `'renderer_test_pubmatic'`                                | `string`           |
-
-### Configuration
-
-PubMatic recommends the UserSync configuration below.  Without it, the PubMatic adapter will not able to perform user syncs, which lowers match rate and reduces monetization.
+| `publisherId`   | required | PubMatic-specific identifier associated with your account                                                                                                                                                                                                                        | `'32572'`                                                 | `string`           |
+| `adSlot`        | optional | PubMatic-specific identifier associated with this ad unit. Refers to Ad Tags within PubMatic UI. We accept Ad Tag Name or Ad Tag ID, refer to example.                                                                                                                          | `'38519891'` or `'homepage_banner'`                      | `string`           |
+| `dctr`          | optional | Deal Custom Targeting<br><i>(Value configured in each adunit will be passed inside adunit configs i.e., imp.ext)</i>                                                                                                                                                             | `'key1:abc\|key2:123'`                                      | `string`           |
+| `deals`         | optional | PMP deals<br><i>(Passed per slot. Each deal-id should be a string with more than 3 characters.)</i>                                                                                                                                                                                         | `['deal-id-5', 'deal-id-6', 'deal-id-7']`               | `array of strings` |
+| `outstreamAU`   | optional | Renderer ID provided by your account representative. Required for outstream video bids unless the ad unit has a [supplied renderer](https://docs.prebid.org/dev-docs/show-outstream-video-ads.html#renderers).                                                                 | `'renderer_test_pubmatic'`                                | `string`           |
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
+
+* `ortb2.site.*`
+* `ortb2.user.*`
+
+AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
+
+### UserSync
+
+PubMatic recommends the UserSync configuration below. Without it, the PubMatic adapter will not be able to perform user syncs, which lowers match rate and reduces monetization.
 
 ```javascript
 pbjs.setConfig({
   userSync: {
     filterSettings: {
       iframe: {
-        bidders: '*',      // '*' represents all bidders
+        bidders: '*', // '*' represents all bidders
         filter: 'include'
       }
     }
@@ -63,130 +86,252 @@ pbjs.setConfig({
 });
 ```
 
-Note: Combine the above the configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only last call for a given attribute will take effect.
+**Note:** *Combine the above configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only the last call for a given attribute will take effect.*
+
+### adSlot
 
-### adSlot Specification and Multi-Size Ad Units
+The adSlot parameter is optional. If you choose to omit it, your PubMatic account must have default site and tag settings enabled. Contact your PubMatic Account Manager to learn more.
 
-The adSlot parameter supports two different formats:
+The adSlot parameter accepts either an Ad Tag Name or Ad Tag ID from PubMatic UI. We recommend using only one adSlot value per ad unit. See the [Banner](#banner) section for an example.
 
 {: .table .table-bordered .table-striped }
 
 | Format         | Example              |
 |----------------|----------------------|
-| Without Size   | `'38519891'`         |
-| With Size      | `'38519891@300x205'` |
+| Ad Tag ID   | `'38519891'`         |
+| Ad Tag Name      | `'unique-name-here'` |
 
-adSlot parameter is optional.  To omit the adSlot parameter, your publisher account must have default site and tag enabled.  Consult your account manager to find out if default site and tag is enabled on your account.  If used, both formats are supported.  Without Size is the recommended option.  Both options will send the ad request with all sizes specified in the Prebid ad unit configuration.
+### Banner
+
+```javascript
+var adUnits = [{
+    code: 'test-div',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [300, 600]
+            ]
+        }
+    },
+    bids: [{
+        bidder: 'pubmatic',
+        params: {
+            publisherId: '32572', // required
+            adSlot: '38519891' // optional - can be ID or name like 'homepage_banner'
+        }
+    }]
+}];
+```
 
-### video parameters
+### Video
 
-The PubMatic adapter supports video as of Prebid v1.16.0
+The following parameters are available for `mediaTypes.video` configuration:
 
 {: .table .table-bordered .table-striped }
 
 | Name                      | Scope    | Description                                              | Example |
 | :----------------------| :------- | :---------------------------------------------------------- | :------ |
-| `video.mimes`          | required | Video MIME types                                            | `['video/mp4','video/x-flv']` |
-| `video.skippable`      | optional | If 'true', user can skip ad                                 | `true` |
-| `video.minduration`    | optional | Minimum ad duration in seconds                              | `5` |
-| `video.maxduration`    | optional | Maximum ad duration in seconds                              | `30` |
-| `video.startdelay`     | optional | Start delay in seconds for pre-roll, mid-roll, or post-roll ad placements | `5` |
-| `video.playbackmethod` | optional | Defines whether inventory is user-initiated or autoplay sound on/off<br/>Values:<br/>`1`: Auto-play, sound on<br/>`2`: Auto-play, sound off<br/>`3`: Click-to-play<br/>`4`: mouse-over      | `1` |
-| `video.api`            | optional | API frameworks supported<br/>Values:<br/>`1`: VPAID 1.0<br/>`2`: VPAID 2.0<br/>`3`: MRAID-1<br/>`4`: ORMMA<br/>`5`: MRAID-2                                                                            | `[1, 2]` |
-| `video.protocols`      | optional |  Supported video bid response protocols<br/>Values<br/>`1`: VAST 1.0<br/>`2`: VAST 2.0<br/>`3`: VAST 3.0<br/> `4`: VAST 1.0 Wrapper<br/>`5`: VAST 2.0 Wrapper<br/>`6`: VAST 3.0 Wrapper            | `[5, 6]` |
-| `video.battr`          | optional | Blocked creative attributes, See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.3 for values             | `[3, 9]` |
-| `video.linearity`      | optional | Indicates if the impression is linear or nonlinear<br/>Values:<br/>`1`: Linear/In-Stream<br/>`2`: Non-Linear/Overlay.                                                                                | `1` |
-| `video.placement`      | optional | Video placement type.  See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.9 for Values                            | `1` |
-| `video.plcmt`          | optional | Video placement type. See [OpenRTB 2.6 specification - github](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/develop/2.6.md#327---object-video-), For values [plcmt subtypes](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo)                            | `1` |
-| `video.minbitrate`     | optional | Minimum bit rate in Kbps.                                   | 50 |
-| `video.maxbitrate`     | optional | Maximum bit rate in Kbps.                                   | 70 |
-
-### AdUnit Format for Video
+| `mimes`          | required | List of content MIME types supported by the player. See [OpenRTB 2.5](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for options | `['video/mp4']` |
+| `minduration`    | recommended | Minimum video ad duration in seconds | `5` |
+| `maxduration`    | recommended | Maximum video ad duration in seconds | `30` |
+| `startdelay`     | recommended | Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placements<br/>`>0`: Mid-Roll (value indicates start delay in seconds)<br/>`0`: Pre-Roll<br/>`-1`: Generic Mid-Roll<br/>`-2`: Generic Post-Roll | `0` |
+| `playbackmethod` | recommended | Playback methods that may be in use. Only one method is typically used in practice. See [OpenRTB 2.5 section 5.10](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for options<br/>`1`: Auto-play, sound on<br/>`2`: Auto-play, sound off<br/>`3`: Click-to-play<br/>`4`: Mouse-over | `[2]` |
+| `protocols`      | recommended | Supported video bid response protocol values<br/>`1`: VAST 1.0<br/>`2`: VAST 2.0<br/>`3`: VAST 3.0<br/>`4`: VAST 1.0 Wrapper<br/>`5`: VAST 2.0 Wrapper<br/>`6`: VAST 3.0 Wrapper<br/>`7`: VAST 4.0<br/>`8`: VAST 4.0 Wrapper | `[2, 3, 5, 6]` |
+| `linearity`      | recommended | OpenRTB2 linearity<br/>`1`: Linear/In-Stream<br/>`2`: Non-Linear/Overlay | `1` |
+| `placement`      | recommended | Placement type for the impression. See [OpenRTB 2.5 section 5.9](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for options | `1` |
+| `plcmt`          | recommended | Video placement type. See [OpenRTB 2.6 Plcmt Subtypes - Video](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo) | `1` |
+| `skippable`      | optional | Indicates if the player will allow the video to be skipped, where `true` = skippable | `true` |
+| `api`            | optional | Supported API framework values<br/>`1`: VPAID 1.0<br/>`2`: VPAID 2.0<br/>`3`: MRAID-1<br/>`4`: ORMMA<br/>`5`: MRAID-2 | `[1, 2]` |
+| `battr`          | optional | Blocked creative attributes. See [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.3 for values | `[3, 9]` |
+| `minbitrate`     | optional | Minimum bit rate in Kbps | `300` |
+| `maxbitrate`     | optional | Maximum bit rate in Kbps | `1500` |
+
+#### Instream Video
 
 ```javascript
-var videoAdUnits = [
-{
+var videoAdUnits = [{
     code: 'test-div-video',
     mediaTypes: {
         video: {
-            playerSize: [640, 480],           // required
-            context: 'instream',
-            mimes: ['video/mp4','video/x-flv'],   // required
-            skip: 1,                              // optional
-            minduration: 5,                       // optional
-            maxduration: 30,                      // optional
-            startdelay: 5,                        // optional
-            playbackmethod: [1,3],                // optional
-            api: [ 1, 2 ],                        // optional
-            protocols: [ 2, 3 ],                  // optional
-            battr: [ 13, 14 ],                    // optional
-            linearity: 1,                         // optional            
-            placement: 2,                         // optional
-            plcmt: 1,                             // optional
-            minbitrate: 10,                       // optional
-            maxbitrate: 10                        // optional
+            playerSize: [640, 480], // required
+            context: 'instream', // required
+            mimes: ['video/mp4'], // required
+            minduration: 5,
+            maxduration: 30,
+            startdelay: 0,
+            playbackmethod: [2],
+            protocols: [2, 3, 5, 6],
+            linearity: 1,
+            placement: 1,
+            plcmt: 1
         }
     },
     bids: [{
-      bidder: 'pubmatic',
-      params: {
-        publisherId: '32572',                     // required
-        adSlot: '38519891@300x250'                // required
-      }
+        bidder: 'pubmatic',
+        params: {
+            publisherId: '32572', // required
+            adSlot: '38519891' // optional - can be ID or name like 'video_preroll'
+        }
     }]
-}]
+}];
 ```
 
-### AdUnit Format for Native
+#### Outstream Video
 
 ```javascript
-var adUnits = [
-{
-    code: 'test-div',    
+var videoAdUnits = [{
+    code: 'test-div-video-outstream',
     mediaTypes: {
-       native: {
-            image: {
-                required: true,
-                sizes: [150, 50]
-            },
-            title: {
-                required: true,
-                len: 80
-            },
-            sponsoredBy: {
-                required: true
-            },
-            body: {
-                required: true
-            }
+        video: {
+            playerSize: [300, 250], // required
+            context: 'outstream', // required
+            mimes: ['video/mp4'], // required
+            minduration: 5,
+            maxduration: 30,
+            startdelay: 0,
+            playbackmethod: [2],
+            protocols: [2, 3, 5, 6],
+            linearity: 1,
+            placement: 3,
+            plcmt: 4
         }
     },
     bids: [{
-      bidder: 'pubmatic',
-      params: {
-        publisherId: '156295',               // required
-        adSlot: 'pubmatic_test2@1x1',       // required
-      }
+        bidder: 'pubmatic',
+        params: {
+            publisherId: '32572', // required
+            adSlot: '38519891', // optional - can be ID or name like 'outstream_article'
+            outstreamAU: 'renderer_test_pubmatic' // required for outstream video
+        }
     }]
 }];
 ```
 
-### Configuration for video
+**Note:** *As an alternative to using the `outstreamAU` parameter, you can supply your own renderer at the ad unit level. This gives you more control over the rendering process. For more information on configuring custom renderers, see the [Prebid.js Outstream Video documentation](https://docs.prebid.org/dev-docs/show-outstream-video-ads.html#renderers).*
 
-For Video ads, prebid cache needs to be enabled for PubMatic adapter.
+#### Configuration for Video
+
+For video ads, Prebid cache needs to be enabled for the PubMatic adapter.
 
 ```javascript
 pbjs.setConfig({
     cache: {
-        url: 'https://prebid.example.com/pbc/v1/cache'
+        url: 'https://my-pbs.example.com/cache'
     }
 });
 ```
 
-### Prebid Server Test Request
+### Native
+
+We recommend using the ORTB Native spec 1.2.
+
+```javascript
+var adUnits = [{
+    code: 'test-div-native',    
+    mediaTypes: {
+        native: {
+            ortb: {
+                assets: [{
+                    id: 1,
+                    required: 1,
+                    img: {
+                        type: 3,
+                        w: 150,
+                        h: 50
+                    }
+                },
+                {
+                    id: 2,
+                    required: 1,
+                    title: {
+                        len: 80
+                    }
+                },
+                {
+                    id: 3,
+                    required: 1,
+                    data: {
+                        type: 1
+                    }
+                },
+                {
+                    id: 4,
+                    required: 1,
+                    data: {
+                        type: 2
+                    }
+                }]
+            }
+        }
+    },
+    bids: [{
+        bidder: 'pubmatic',
+        params: {
+            publisherId: '32572', // required
+            adSlot: '38519891' // optional - can be ID or name like 'native_sidebar'
+        }
+    }]
+}];
+```
+
+### Multi-format
+
+PubMatic supports multi-format ad units, allowing a single ad unit to accept multiple media types (banner, video, and native). The adapter will prioritize formats based on the order they are defined in the `mediaTypes` object.
+
+```javascript
+var adUnits = [{
+    code: 'test-div-multi',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [300, 600]
+            ]
+        },
+        video: {
+            context: 'outstream',
+            playerSize: [300, 250],
+            mimes: ['video/mp4'],
+            protocols: [2, 3, 5, 6],
+            minduration: 5,
+            maxduration: 30
+        },
+        native: {
+            ortb: {
+                assets: [{
+                    id: 1,
+                    required: 1,
+                    img: {
+                        type: 3,
+                        w: 150,
+                        h: 50
+                    }
+                },
+                {
+                    id: 2,
+                    required: 1,
+                    title: {
+                        len: 80
+                    }
+                }]
+            }
+        }
+    },
+    bids: [{
+        bidder: 'pubmatic',
+        params: {
+            publisherId: '32572', // required
+            adSlot: '38519891' // optional - can be ID or name like 'multi_format_ad'
+        }
+    }]
+}];
+```
+
+### Prebid Server
 
 The following test parameters can be used to verify that Prebid Server is working properly with the
-PubMatic adapter. This example includes an `imp` object with an PubMatic test publisher ID, ad slot,
+PubMatic adapter. This example includes an `imp` object with a PubMatic test publisher ID, ad slot,
 and sizes that would match with the test creative.
 
 ```json
@@ -217,15 +362,6 @@ and sizes that would match with the test creative.
 }
 ```
 
-### First Party Data
-
-Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
-
-- `ortb2.site.*`
-- `ortb2.user.*`
-
-AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
-
 ### Endpoint Compression
 
 This adapter utilizes gzip compression support built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests)

From 443ef054bfaef8273b1f6255160cf83e07a241f9 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Mon, 8 Sep 2025 09:02:05 +0200
Subject: [PATCH 320/665] New adapter: Anzu Exchange (#6241)

* Remove required host from Limelight prebid server adapters

* new adapter Anzu Exchange

* revert changes

* revert changes2

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/anzuExchange.md | 37 ++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/anzuExchange.md

diff --git a/dev-docs/bidders/anzuExchange.md b/dev-docs/bidders/anzuExchange.md
new file mode 100644
index 0000000000..9126a13afb
--- /dev/null
+++ b/dev-docs/bidders/anzuExchange.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Anzu Exchange
+description: Prebid Anzu Exchange Bidder Adaptor
+biddercode: anzuExchange
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                               | Example                | Type      |
+|:--------------|:---------|:----------------------------------------------------------|:-----------------------|:----------|
+| `host`        | required | Ad network's RTB host                                     | `'marketplace-anzu.io'`| `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Anzu Exchange Platform.   | `42`                   | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                   | `'banner'`             | `string`  |
+| `publisherId` | required | Publisher ID                                              | `'12345'`              | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                  | `'custom1'`            | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                  | `'custom2'`            | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                  | `'custom3'`            | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                  | `'custom4'`            | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                  | `'custom5'`            | `string`  |

From 39070b29373b97b084de74c42ba8dff241425404 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Mon, 8 Sep 2025 09:03:41 +0200
Subject: [PATCH 321/665] New Adapter: Adnimation (#6242)

* Remove required host from Limelight prebid server adapters

* new adapter adnimation

* revert changes

* remove unnecessary data

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/adnimation.md | 37 ++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/adnimation.md

diff --git a/dev-docs/bidders/adnimation.md b/dev-docs/bidders/adnimation.md
new file mode 100644
index 0000000000..dd7eefa28c
--- /dev/null
+++ b/dev-docs/bidders/adnimation.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Adnimation
+description: Prebid Adnimation Bidder Adaptor
+biddercode: adnimation
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                            | Example                | Type      |
+|:--------------|:---------|:-------------------------------------------------------|:-----------------------|:----------|
+| `host`        | required | Ad network's RTB host                                  | `'adnimation.trading'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Adnimation Platform.   | `42`                   | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                | `'banner'`             | `string`  |
+| `publisherId` | required | Publisher ID                                           | `'12345'`              | `string`  |
+| `custom1`     | optional | Custom targeting field 1                               | `'custom1'`            | `string`  |
+| `custom2`     | optional | Custom targeting field 2                               | `'custom2'`            | `string`  |
+| `custom3`     | optional | Custom targeting field 3                               | `'custom3'`            | `string`  |
+| `custom4`     | optional | Custom targeting field 4                               | `'custom4'`            | `string`  |
+| `custom5`     | optional | Custom targeting field 5                               | `'custom5'`            | `string`  |

From 76d217551929ca3cdca72254e4c1757ec5900980 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Mon, 8 Sep 2025 09:04:56 +0200
Subject: [PATCH 322/665] New Adapter: Rtb Demand (#6243)

* Remove required host from Limelight prebid server adapters

* revert changes

* new adapter Rtb Demand

* revert changes

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/rtbdemand.md | 37 +++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/rtbdemand.md

diff --git a/dev-docs/bidders/rtbdemand.md b/dev-docs/bidders/rtbdemand.md
new file mode 100644
index 0000000000..e49f4fc50f
--- /dev/null
+++ b/dev-docs/bidders/rtbdemand.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Rtb Demand
+description: Prebid Rtb Demand Bidder Adaptor
+biddercode: rtbdemand
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                            | Example                 | Type      |
+|:--------------|:---------|:-------------------------------------------------------|:------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                  | `'ads-rtbdemand.com'`   | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Rtb Demand Platform.   | `42`                    | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                | `'banner'`              | `string`  |
+| `publisherId` | required | Publisher ID                                           | `'12345'`               | `string`  |
+| `custom1`     | optional | Custom targeting field 1                               | `'custom1'`             | `string`  |
+| `custom2`     | optional | Custom targeting field 2                               | `'custom2'`             | `string`  |
+| `custom3`     | optional | Custom targeting field 3                               | `'custom3'`             | `string`  |
+| `custom4`     | optional | Custom targeting field 4                               | `'custom4'`             | `string`  |
+| `custom5`     | optional | Custom targeting field 5                               | `'custom5'`             | `string`  |

From c2ffd3bcb098998a31c51a42fd30e5d6986a70b7 Mon Sep 17 00:00:00 2001
From: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Date: Mon, 8 Sep 2025 09:05:53 +0200
Subject: [PATCH 323/665] New Adapter: Altstar Media (#6244)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* new adapter altstar

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/altstar.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/altstar.md

diff --git a/dev-docs/bidders/altstar.md b/dev-docs/bidders/altstar.md
new file mode 100644
index 0000000000..4a637afc03
--- /dev/null
+++ b/dev-docs/bidders/altstar.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Altstar Media
+description: Prebid Altstar Media Bidder Adaptor
+biddercode: altstar
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                              | Example                  | Type      |
+|:--------------|:---------|:---------------------------------------------------------|:-------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                    | `'ads-altstarmedia.com'` | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Altstar Media Platform.  | `42`                     | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                  | `'banner'`               | `string`  |
+| `publisherId` | required | Publisher ID                                             | `'12345'`                | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                 | `'custom1'`              | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                 | `'custom2'`              | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                 | `'custom3'`              | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                 | `'custom4'`              | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                 | `'custom5'`              | `string`  |

From a56fbc08f789bb53270e4a2945420e06c8a26e98 Mon Sep 17 00:00:00 2001
From: natanavra <natan@provesrc.com>
Date: Mon, 8 Sep 2025 10:08:58 +0300
Subject: [PATCH 324/665] Valuad Bid Adapter: Update tcf support (#6236)

* Update gvlid and tcf status

* Fix typo
---
 dev-docs/bidders/valuad.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/valuad.md b/dev-docs/bidders/valuad.md
index fa1660cfcd..1512170680 100644
--- a/dev-docs/bidders/valuad.md
+++ b/dev-docs/bidders/valuad.md
@@ -8,7 +8,8 @@ pbs: false
 prebid_member: false
 userId: none
 gpp_sids: usstate_all
-tcfeu_supported: false
+tcfeu_supported: true
+gvl_id: 1478
 usp_supported: true
 coppa_supported: true
 schain_supported: true
@@ -31,4 +32,4 @@ Please reach out to your account manager or <hello@valuad.io> for more informati
 
 | Name          | Scope    | Description                    | Example    | Type      |
 |---------------|----------|--------------------------------|------------|-----------|
-| `placementId` | required | Placement ID provided by VAluad | `'10000'`  | `string`  |
+| `placementId` | required | Placement ID provided by Valuad | `'10000'`  | `string`  |

From b6eb610e02ea2c49be2c66db7bf410ce6b545541 Mon Sep 17 00:00:00 2001
From: Chris Huie <phoenixtechnerd@gmail.com>
Date: Thu, 11 Sep 2025 10:49:00 -0600
Subject: [PATCH 325/665] CTV : add requirements doc for comment (#6255)

* Update ctv.md

* fix lint
---
 formats/ctv.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/formats/ctv.md b/formats/ctv.md
index 2bf38be31a..9f6dc9dce7 100644
--- a/formats/ctv.md
+++ b/formats/ctv.md
@@ -20,6 +20,13 @@ Server side ad insertion dominates CTV ad serving ecosystem mainly due to the fo
  
 Prebid Server is the most commonly used methodology for accessing programmatic demand for the server side ad insertion use cases.
 
+{: .alert.alert-success :}
+Prebid has published our CTV GET and VAST unwrapping requirements, which are now open for public feedback until Friday, October 10th. The document can be [found here](https://docs.google.com/document/d/1KrEQk7gOZj0pUJHwVb7850awbQdiE8EfzciwlfvtSQQ).
+
+We encourage the community to review the draft and share feedback directly as comments in the Google Doc. The Prebid team will actively monitor and respond to comments throughout the feedback period to ensure that all perspectives are considered.
+
+Your input is critical in shaping these requirements, and our goal is to incorporate community insights before we begin development in Q4.
+
 ## Further Reading
 
 - [Ad Server Integration with Prebid Server Architecture and Interface Recommendation](/prebid-server/use-cases/pbs-lfv.html)

From ecfddd74db00a32c88e7947b626f0a54a45c6334 Mon Sep 17 00:00:00 2001
From: dmytro-po <dmytro.po@intentiq.com>
Date: Mon, 15 Sep 2025 20:14:40 +0300
Subject: [PATCH 326/665] IntentIq ID & Analytics Modules: Client Hints timeout
 documentation (#6246)

* AGT-659: partnerClientId documentation (#15)

* AGT-659: ppid doc

* AGT-659: Fix doc

* AGT-667: chTimeout parameter description
---
 dev-docs/modules/userid-submodules/intentiq.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 6d3edae966..bcbc1589e4 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -58,6 +58,7 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.reportMethod            | Optional | String   | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL.                                                                                             |`"GET"`                                        |
 | params.siloEnabled             | Optional | Boolean  | Determines if first-party data is stored in a siloed storage key. When set to `true`, first-party data is stored under a modified key that appends `_p_` plus the partner value rather than using the default storage key. The default value is `false`.                                                                          | `true`                                        |
 | params.groupChanged            | Optional | Function | A callback that is triggered every time the user’s A/B group is set or updated.                                                                                         |`(group) => console.log('Group changed:', group)` |
+| params.chTimeout | Optional | Number | Maximum time (in milliseconds) to wait for Client Hints from the browser before sending request. Default value is `10ms` | `30` |
 | params.additionalParameters | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
 | params.additionalParameters [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
 | params.additionalParameters [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
@@ -84,6 +85,7 @@ pbjs.setConfig({
                 sourceMetaData: "123.123.123.123", // Optional parameter
                 sourceMetaDataExternal: 123456, // Optional parameter
                 reportMethod: "GET", // Optional parameter
+                chTimeout: 10, // Optional parameter
                 additionalParameters: [ // Optional parameter
                     {
                       parameterName: "abc",

From a33398cb3df6464c7040650c742807dc430da99f Mon Sep 17 00:00:00 2001
From: zentotem <programmatic@zentotem.net>
Date: Mon, 15 Sep 2025 20:20:44 +0300
Subject: [PATCH 327/665] New bidder adapter: Zentotem (#5553)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* zentotem: add adapter
add adapter for zentotem

* zentotem: add adapter
add adapter for zentotem

* zentotem: add adapter
add adapter for zentotem

---------

Co-authored-by: Богатов Герман <bogatovgrmn@gmail.com>
---
 dev-docs/bidders/zentotem.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 dev-docs/bidders/zentotem.md

diff --git a/dev-docs/bidders/zentotem.md b/dev-docs/bidders/zentotem.md
new file mode 100644
index 0000000000..3d9d76c045
--- /dev/null
+++ b/dev-docs/bidders/zentotem.md
@@ -0,0 +1,33 @@
+---
+layout: bidder
+title: Zentotem
+description: Prebid Zentotem Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: zentotem
+tcfeu_supported: false
+dsa_supported: false
+schain_supported: false
+dchain_supported: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+prebid_member: false
+privacy_sandbox: none
+gpp_sids: none
+deals_supported: true
+floors_supported: true
+gvl_id: none
+media_types: banner, video, native
+
+sidebarType: 1
+---
+
+### Registration
+For assistance or setup instructions, please contact us at <support@zentotem.net>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name       | Scope    | Description            | Example | Type     |
+|------------|----------|------------------------|---------|----------|
+| (none)     | optional | no params required     | `''`    | n/a      |

From 67e0c3ef372fb1911e39c9e40d22556492e31406 Mon Sep 17 00:00:00 2001
From: Andrii Rudyk <96918101+And-Rud@users.noreply.github.com>
Date: Mon, 15 Sep 2025 20:31:06 +0300
Subject: [PATCH 328/665] Update adipolo docs (#6048)

Co-authored-by: And-Rud <andrii@xe.works>
---
 dev-docs/bidders/adipolo.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/adipolo.md b/dev-docs/bidders/adipolo.md
index 69fc4818c8..bb29679fff 100644
--- a/dev-docs/bidders/adipolo.md
+++ b/dev-docs/bidders/adipolo.md
@@ -10,7 +10,7 @@ gvl_id: 1456
 usp_supported: true
 prebid_member: false
 pbjs: true
-pbs: false
+pbs: true
 schain_supported: true
 floors_supported: true
 multiformat_supported: will-bid-on-any
@@ -31,3 +31,11 @@ privacy_sandbox: no
 | `pid`       | required | Placement ID                | `test-banner` | `string`  |
 | `env`       | optional | Environment name            | `adipolo`     | `string`  |
 | `ext`       | optional | Specific integration config | `{}`          | `object`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                   | Example                            | Type      |
+|-------------|----------|-------------------------------|------------------------------------|-----------|
+| `env`       | required | Environment name              | `adipolo-stage`                    | `string`  |
+| `pid`       | required | unique placement ID           | `aa8217e20131c095fe9dba67981040b0` | `string`  |

From 91cc159fb82dd3792d302fcecaeab7fa0f3e4467 Mon Sep 17 00:00:00 2001
From: prebidPinkLion <prebid@pinklion.io>
Date: Mon, 15 Sep 2025 20:38:25 +0300
Subject: [PATCH 329/665] New Adapter: PinkLion (#6087)

* init PinkLion adapters

* lowercase md

* change to match capitilization in adapter

---------

Co-authored-by: Chris Huie <phoenixtechnerd@gmail.com>
---
 dev-docs/bidders/pinkLion.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/pinkLion.md

diff --git a/dev-docs/bidders/pinkLion.md b/dev-docs/bidders/pinkLion.md
new file mode 100644
index 0000000000..42add05878
--- /dev/null
+++ b/dev-docs/bidders/pinkLion.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: PinkLion
+description: Prebid PinkLion Bidder Adapter
+biddercode: pinkLion
+gpp_sids: usstate_all
+gvl_id: none
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds:
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From df3d09f24e2871f13f855ba136346e8a9cf436eb Mon Sep 17 00:00:00 2001
From: Saar Amrani <saar120@gmail.com>
Date: Mon, 15 Sep 2025 20:43:31 +0300
Subject: [PATCH 330/665] Enable PBS support in tagoras.md (#6130)

---
 dev-docs/bidders/tagoras.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/tagoras.md b/dev-docs/bidders/tagoras.md
index a06892a229..27276ad288 100644
--- a/dev-docs/bidders/tagoras.md
+++ b/dev-docs/bidders/tagoras.md
@@ -20,6 +20,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
+pbs: true
 sidebarType: 1
 ---
 

From f00dad3541e7cc200f8fe97abbac6093597cba7e Mon Sep 17 00:00:00 2001
From: andy <49372179+arezitopedia@users.noreply.github.com>
Date: Mon, 15 Sep 2025 14:51:54 -0300
Subject: [PATCH 331/665] Documentation for 152media RTD module (#6135)

* add documentation for 152media RTD module

* fix linting errors in 152media RTD module documentation

* Update dev-docs/modules/oftmediaRtdProvider.md

Updat with disclaimer about external js file

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/modules/oftmediaRtdProvider.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/oftmediaRtdProvider.md | 86 +++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 dev-docs/modules/oftmediaRtdProvider.md

diff --git a/dev-docs/modules/oftmediaRtdProvider.md b/dev-docs/modules/oftmediaRtdProvider.md
new file mode 100644
index 0000000000..ababdb4866
--- /dev/null
+++ b/dev-docs/modules/oftmediaRtdProvider.md
@@ -0,0 +1,86 @@
+---
+layout: page_v2
+title: 152media RTD Module
+display_name: 152media
+description: Real-time data enrichment from 152media
+page_type: module
+module_type: rtd
+module_code : oftmediaRtdProvider
+enable_download : true
+sidebarType : 1
+---
+
+# 152media (Oftmedia) Real-time Data Submodule
+
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The 152media Real-time Data (RTD) module enhances programmatic advertising performance by providing contextual and audience-based data at runtime. Integrated into Prebid.js, it enables publishers to:
+
+* Improve bid relevance with enriched targeting data
+* Filter unqualified or low-value bid requests
+* Leverage AI-based deal optimization
+
+This module is maintained by [152media](mailto:hello@152media.com) and requires the global `rtdModule` to function.
+
+{% include dev-docs/loads-external-javascript.md %}
+
+## Usage
+
+### Build
+
+To include the 152media RTD module in your Prebid.js build:
+
+```bash
+gulp build --modules="rtdModule,oftmediaRtdProvider"
+````
+
+> **Note:** `rtdModule` is required as a dependency.
+
+## Configuration
+
+Use `pbjs.setConfig` to initialize the 152media RTD module with the following syntax:
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 500, // Recommended setting
+    dataProviders: [
+      {
+        name: "oftmedia",
+        waitForIt: true, // Ensures data is available before auction starts
+        params: {
+          publisherId: "0653b3fc-a645-4bcc-bfee-b8982974dd53", // Required: Get this ID from 152media
+          keywords: ["red", "blue", "white"], // Optional: Contextual keywords
+          bidderCode: "appnexus", // Required: Targeted bidder
+          enrichRequest: true // Optional: Adds additional targeting fields
+        }
+      }
+    ]
+  }
+});
+```
+
+## Parameters
+
+| Parameter              | Type             | Description                                                  | Default      |
+| ---------------------- | ---------------- | ------------------------------------------------------------ | ------------ |
+| `name`                 | String           | Always `"oftmedia"`                                          |              |
+| `waitForIt`            | Boolean          | Ensures auction is delayed until data is ready               | `false`      |
+| `params.publisherId`   | String           | Your unique Publisher ID provided by 152media                | **Required** |
+| `params.keywords`      | Array of Strings | Contextual keywords for enhancing relevance                  | `[]`         |
+| `params.bidderCode`    | String           | Bidder code that should receive the enriched data            | **Required** |
+| `params.enrichRequest` | Boolean          | Enriches the request object with extra targeting information | `false`      |
+| `params.timeout`       | Integer (ms)     | Timeout for data retrieval (optional)                        | `1000`       |
+
+## Output
+
+When active, the module appends targeting and/or deal data into the ad unit targeting objects and/or modifies the request payload, depending on the configuration and support by the selected bidder.
+
+## Support
+
+For questions, help, or to obtain a publisher ID, please contact [hello@152media.com](mailto:hello@152media.com).

From 854f390a6ba0ec0087d84648b0ad271655fd5f27 Mon Sep 17 00:00:00 2001
From: Appstock LTD <sdksupport@app-stock.com>
Date: Mon, 15 Sep 2025 20:57:02 +0300
Subject: [PATCH 332/665] init appstockSSP Bid Adapter (#6177)

* init appStockSSP Bid Adapter

* review upd

---------

Co-authored-by: Kanceliarenko <kostiantyn.k@teqblaze.com>
---
 dev-docs/bidders/appStockSSP.md | 37 +++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/appStockSSP.md

diff --git a/dev-docs/bidders/appStockSSP.md b/dev-docs/bidders/appStockSSP.md
new file mode 100644
index 0000000000..e49e3a424f
--- /dev/null
+++ b/dev-docs/bidders/appStockSSP.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: AppStockSSP
+description: Prebid AppStockSSP Bidder Adapter
+biddercode: appStockSSP
+gpp_sids: usstate_all
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-not-bid
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+gvl_id: 1223
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+| `region`      | optional | Region (for Prebid.js) | `'us-east'` (default) or `'eu'` or `'apac'` | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId.

From 4c7b994a21ecde5536b6609619e792b6f7d6c587 Mon Sep 17 00:00:00 2001
From: Marcin Muras <47107445+mmuras@users.noreply.github.com>
Date: Tue, 16 Sep 2025 16:11:59 +0200
Subject: [PATCH 333/665] Add Gemius ID submodule documentation. (#6191)

---
 dev-docs/modules/userid-submodules/gemius.md | 44 ++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/gemius.md

diff --git a/dev-docs/modules/userid-submodules/gemius.md b/dev-docs/modules/userid-submodules/gemius.md
new file mode 100644
index 0000000000..52ded75503
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/gemius.md
@@ -0,0 +1,44 @@
+---
+layout: userid
+title: Gemius ID
+description: Gemius ID User ID sub-module
+useridmodule: gemiusIdSystem
+bidRequestUserId: gemiusId
+eidsource: gemius.com
+example: '"1111"'
+---
+
+The Gemius ID submodule enables publishers to access the RUID identifier provided by gemius.com
+within the Prebid.js ecosystem.
+
+Add support for Gemius ID to your Prebid.js package using:
+
+```bash
+gulp build --modules=userId,gemiusIdSystem
+```
+
+## Gemius ID Registration
+
+This submodule requires a script provided by gemius.com. For more information, please contact us at: [https://gemius.com/contact/](https://gemius.com/contact/).
+
+## Gemius ID Configuration
+
+The Gemius ID module does not require any configuration parameters except `params.storage` as provided in example
+
+## Gemius ID Example
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [{
+            name: 'gemiusId',
+            storage: {
+                name: 'pbjs_gemiusId',
+                type: 'cookie',
+                expires: 30,
+                refreshInSeconds: 3600
+            }
+        }]
+    }
+});
+```

From bcd928968e1b084c3aed6240cfda5ec005659114 Mon Sep 17 00:00:00 2001
From: Komal Kumari <169047654+pm-komal-kumari@users.noreply.github.com>
Date: Wed, 17 Sep 2025 20:12:31 +0530
Subject: [PATCH 334/665] fix : gpt url link update in introduction (#6253)

* Update documentation for Pubmatic Bid Adapter

* Fix linter error for dctr row

* Fix linter error of ul for fpd section

* Fix : GPT correct url link

---------

Co-authored-by: Komal Kumari <komalkumari@Komals-MacBook-Pro-L1834.local>
---
 dev-docs/bidders/pubmatic.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/pubmatic.md b/dev-docs/bidders/pubmatic.md
index 39991554a3..c1ef6b3964 100644
--- a/dev-docs/bidders/pubmatic.md
+++ b/dev-docs/bidders/pubmatic.md
@@ -47,7 +47,7 @@ Publishers can use Prebid.js to call PubMatic in any of the following ways:
 * **Call through our client-side adapter**: Prebid.js calls PubMatic directly from the browser using our client-side adapter.
 * **Call through our server-side adapter**: Prebid.js makes a call to Prebid Server and then Prebid Server uses our server-side adapter to call PubMatic.
 
-We highly recommend adding the `gptPreAuction` module to populate GPID (Global Placement ID) values. See the [gptPreAuction module documentation](https://docs.prebid.org/dev-docs/modules/gptPreAuction.html) for implementation details.
+We highly recommend adding the `gptPreAuction` module to populate GPID (Global Placement ID) values. See the [gptPreAuction module documentation](https://docs.prebid.org/dev-docs/modules/gpt-pre-auction.html) for implementation details.
 
 ### Bid Params
 

From c6aaefafd4e5fc9089e0cdb9c8ea02316543286d Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Wed, 17 Sep 2025 16:48:34 +0200
Subject: [PATCH 335/665] Update userId.md (#6250)

---
 dev-docs/modules/userId.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/userId.md b/dev-docs/modules/userId.md
index a9e932bdfc..911cd4b2e7 100644
--- a/dev-docs/modules/userId.md
+++ b/dev-docs/modules/userId.md
@@ -102,7 +102,7 @@ The table below has the options that are common across ID systems. See the secti
 
 ## Permissions
 
-Publishers can control which user ids are shared with the bid adapters they choose to work with by using the bidders array.  The bidders array is part of the User id module config, publisher may choose to send an id to some bidders but not all, the default behavior is that each user id go to all bid adapters the publisher is working with.
+Publishers can control which user ids are shared with the bid adapters they choose to work with by using the bidders array.  The bidders array is part of the User id module config, publisher may choose to send an id to some bidders but not all, the default behavior is that each user id goes to all bid adapters the publisher is working with.
 
 Use the optional `bidders` parameter to define an array of bidder codes to which this user ID may be sent.
 

From 792572218223f7ae6351b3f5941034f6dadbd11c Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Wed, 17 Sep 2025 16:56:00 +0200
Subject: [PATCH 336/665] Update intentiq.md (#6249)

---
 dev-docs/modules/userid-submodules/intentiq.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index bcbc1589e4..2ae2bb46ea 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -17,7 +17,7 @@ By leveraging the Intent IQ identity graph, our module helps publishers, SSPs, a
 ## Registration
 
 Navigate to [our portal](https://www.intentiq.com/) and contact our team for partner ID.
-check our [documentation](https://pbmodule.documents.intentiq.com/) to get more information about our solution and how utilze it's full potential
+check our [documentation](https://pbmodule.documents.intentiq.com/) to get more information about our solution and how to utilze it's full potential
 
 ## Integration
 

From 874d81e155067842862ac5a4fbdbaad5dc307374 Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.com>
Date: Wed, 17 Sep 2025 11:10:21 -0400
Subject: [PATCH 337/665] Update fwssp.md after prebidjs-10.10.0 release
 (#6248)

---
 dev-docs/bidders/fwssp.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index c483c11de5..9bace4af4d 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -36,6 +36,8 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `profile` | required | Profile Name - The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "96749:global-js"   | `string`   |
 | `siteSectionId` | required | Custom Site Section tag or numeric Site Section ID | "ss_12345" | `string` |
 | `videoAssetId` | required | Custom content Video Asset ID | "pause_ad_video" | `string` |
+| `bidfloor` | optional | Bid floor price | 13.2118 | `number` |
+| `bidfloorcur` | optional | Bid floor currency | "USD" | `string` |
 | `flags` | optional | Optional flags to include in the ad request | '+play-uapl' | `string` |
 | `mode` | optional | Request mode. Valid values are: “on-demand", "live". Default: "on-demand" | "live" | `string` |
 | `adRequestKeyValues` | optional | An object of ad request key-value pairs. | { \_fw_player_width: '1920', \_fw_player_height: '1080' } | `object` |
@@ -43,11 +45,9 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `tpos` | optional | Slot time position in seconds. Default: 0 | 10 | `number` |
 | `slid` | optional | Slot custom ID. Any string with valid letters/digits/symbols. Default: "Preroll_1" | "CustomPreroll" | `string` |
 | `slau` | optional | Specify custom ad unit names for this slot. Multiple ad unit names can be put into this parameter, separated by "\|". Ad unit group names are also supported but you can only specify one ad unit group; multiple ad unit groups or mixed ad unit group and ad unit names are not supported. Default: "preroll" | "pre1\|pre2" | `string` |
-| `minD` | optional | The minimum duration of a slot, in seconds. | 30 | `number` |
-| `maxD` | optional | The maximum duration of a slot, in seconds. | 30 | `number` |
 | `listeners` | optional | An object of AdManager event listeners | { onSlotStarted: this.onSlotStarted, adEvent: this.onAdEvent, onSlotEnded: this.onSlotEnded } | `object` |
-| `isMuted` | optional | Constrols if ad playback should start with volume muted. Default: true | false | `boolean` |
-| `showMuteButton` | optional | Controls if a mute button should be shown during ad playback.  Default: false | true | `boolean` |
+| `isMuted` | optional | Controls if ad playback should start with volume muted. Default: true | false | `boolean` |
+| `showMuteButton` | optional | Controls if a mute button should be shown during ad playback. Default: false | true | `boolean` |
 | `playerParams` | optional | An object of AdManager player parameter values | { "renderer.video.startDetectTimeout": 5000 } | `object` |
 | `sdkVersion` | optional | The AdManager sdk version to use for playback. This is only valid for "outstream" formats. Default: "7.10.0" | "7.11.0" | `string` |
 | `format` | optional | The format to use for displaying the ad. Default: outstream | "inbanner" | `string` |

From 7770f812d9cb50763ab9089a0ddae730fc83ce7f Mon Sep 17 00:00:00 2001
From: hasanideepak <80700939+hasanideepak@users.noreply.github.com>
Date: Wed, 17 Sep 2025 22:50:02 +0530
Subject: [PATCH 338/665] added instructions for first party data (#6260)

---
 dev-docs/bidders/lane4.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/dev-docs/bidders/lane4.md b/dev-docs/bidders/lane4.md
index b2421b0f49..d9c0e0216d 100644
--- a/dev-docs/bidders/lane4.md
+++ b/dev-docs/bidders/lane4.md
@@ -90,3 +90,30 @@ var adUnits = [
             }
         ];
 ```
+
+#### First Party Data
+
+In release 4.30 and later, publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
+
+* ortb2.user.id
+* ortb2.user.buyeruid
+* ortb2.user.keywords
+* ortb2.user.ext.*
+
+Example first party data that's available to all bidders and all adunits:
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    user: {
+      id: 123456789,        // Unique pseudonymized ID for the user (e.g., NPI).
+      buyeruid: 987654321,  // DSP-assigned user ID for identity resolution.
+      keywords: "kw1,kw2",  // Interest or specialty tags (e.g., oncology, cardiology)
+      ext: {
+        key1: "values",    // Custom healthcare metadata (e.g., icd10), single or comma seperated.
+        key2: "values"     // Additional campaign context (e.g., ndc), single or comma seperated.
+      }
+    }
+  }
+});
+```

From 2921d208424b8605597dfe7795b14ee4c6b4abc9 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Fri, 19 Sep 2025 11:26:46 +0200
Subject: [PATCH 339/665] Update body-end.html (#6263)

* Update body-end.html

* Use Zach's search api key
---
 _includes/body-end.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/body-end.html b/_includes/body-end.html
index 417d319101..86bfd1bc1a 100644
--- a/_includes/body-end.html
+++ b/_includes/body-end.html
@@ -1,6 +1,6 @@
 <script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script>
 <script type="text/javascript"> docsearch({
-  apiKey: '6f0eda209a805cfa66b415043ab5fbfc',
+  apiKey: '7777b1f98e980527606d00e705ff3d6f',
   appId: 'FN26QH8JE9',
   indexName: 'prebid',
   container: '.pb-header .c-search',

From 0fbab18016611d14be0e0b0f31dd530dfd47508f Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Mon, 29 Sep 2025 12:26:01 +0200
Subject: [PATCH 340/665] PubxAi doc added + other fix (#6245)

* pubxai doc added

* lint fix

* gpp_sid added

* pubxai glvid update

---------

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/easybid.md |  29 ++-------
 dev-docs/bidders/nexx360.md |   3 +-
 dev-docs/bidders/pubxai.md  | 113 +++++++++++++++++++++++++++++++++++
 dev-docs/bidders/revnew.md  | 114 ++++++++++++++++++++++++++++++++++++
 4 files changed, 234 insertions(+), 25 deletions(-)
 create mode 100644 dev-docs/bidders/pubxai.md
 create mode 100644 dev-docs/bidders/revnew.md

diff --git a/dev-docs/bidders/easybid.md b/dev-docs/bidders/easybid.md
index 6e71dbbd87..617579c1eb 100644
--- a/dev-docs/bidders/easybid.md
+++ b/dev-docs/bidders/easybid.md
@@ -6,9 +6,8 @@ pbjs: true
 pbs: true
 biddercode: easybid
 gvl_id: 1068
-tcfeu_supported: true
 usp_supported: true
-gpp_supported: true
+gpp_sids: tcfeu
 schain_supported: true
 dchain_supported: false
 floors_supported: true
@@ -29,6 +28,10 @@ multiformat_supported: will-bid-on-any
 | Name          | Scope    | Description                | Example                                   | Type      |
 |---------------|----------|----------------------------|--------------------------------------     |-----------|
 | `tagId`       | required | tag ID                     | `"testeasy"`                              | `string`  |
+| `placement`   | required*| Placement                  | `"test.com_header_ad"`                    | `string`  |
+
+*You*must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
 
 ### First Party Data
 
@@ -97,26 +100,6 @@ var adUnits = [
                tagId: 'testeasy'
             }
         }]
-    },
-    // Multiformat Ad
-   {
-        code: 'multi1',
-        mediaTypes: {
-            video: {
-                playerSize: [640, 480],
-                context: 'instream'
-            },
-            banner: {
-              sizes: [[300, 250], [300,600]]
-            }
-        },
-        bids: [{
-            bidder: 'easybid',
-            params: {
-               tagId: 'testeasy',
-               videoTagId: 'testeasy'
-            }
-        }]
-    };
+    }
 ];
 ```
diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index 87bc576966..a1a073992b 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -6,9 +6,8 @@ pbjs: true
 pbs: true
 biddercode: nexx360
 gvl_id: 965
-tcfeu_supported: true
 usp_supported: true
-gpp_supported: true
+gpp_sids: tcfeu
 schain_supported: true
 dchain_supported: false
 floors_supported: true
diff --git a/dev-docs/bidders/pubxai.md b/dev-docs/bidders/pubxai.md
new file mode 100644
index 0000000000..084e9cbc3e
--- /dev/null
+++ b/dev-docs/bidders/pubxai.md
@@ -0,0 +1,113 @@
+---
+layout: bidder
+title: PubxAi
+description: Prebid PubxAi Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: pubxai
+gvl_id: 1485
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | PubxAi tag ID              | `"testnexx"`                              | `string`  |
+| `placement`   | required*| PubxAi placement           | `"test.com_header_ad"`                    | `string`  |
+
+*You*must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+### Bidder Config
+
+You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `pubxai`
+
+{% include dev-docs/storageAllowed.md %}
+
+```javascript
+pbjs.bidderSettings = {
+    pubxai: {
+        storageAllowed : true
+    }
+}
+```
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'pubxai',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'pubxai',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'pubxai',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    }
+];
+```
diff --git a/dev-docs/bidders/revnew.md b/dev-docs/bidders/revnew.md
new file mode 100644
index 0000000000..c0c32f61ef
--- /dev/null
+++ b/dev-docs/bidders/revnew.md
@@ -0,0 +1,114 @@
+---
+layout: bidder
+title: Revnew
+description: Prebid Revnew Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: revnew
+gvl_id: 1468
+tcfeu_supported: true
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required*| Revnew tag ID              | `"testnexx"`                              | `string`  |
+| `placement`   | required*| Revnew placement           | `"test.com_header_ad"`                    | `string`  |
+
+*You*must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+### Bidder Config
+
+You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `revnew`
+
+{% include dev-docs/storageAllowed.md %}
+
+```javascript
+pbjs.bidderSettings = {
+    revnew: {
+        storageAllowed : true
+    }
+}
+```
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'revnew',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'revnew',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'revnew',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    }
+];
+```

From 6b9d8c1e850b096b7d11464ecd70abff463573a1 Mon Sep 17 00:00:00 2001
From: mediayo <yehuda@mediayo.co>
Date: Wed, 1 Oct 2025 11:48:57 +0300
Subject: [PATCH 341/665] MediaYo: new adapter (#6102)

* init new adapter

* Update dev-docs/bidders/mediayo.md

format parameters as code

* markdown lint

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/mediayo.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/mediayo.md

diff --git a/dev-docs/bidders/mediayo.md b/dev-docs/bidders/mediayo.md
new file mode 100644
index 0000000000..7e7c8a5454
--- /dev/null
+++ b/dev-docs/bidders/mediayo.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: MediaYo
+description: Prebid MediaYo Bidder Adapter
+biddercode: mediayo
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: false
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server you only need to use one parameter: either `placementId` or `endpointId`

From 8ab0034b492cbcacd20d7f3f5be6fa9e510b02c8 Mon Sep 17 00:00:00 2001
From: hasanideepak <80700939+hasanideepak@users.noreply.github.com>
Date: Wed, 1 Oct 2025 21:49:33 +0530
Subject: [PATCH 342/665] added instructions for first party data (#6262)

---
 dev-docs/bidders/relevatehealth.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/dev-docs/bidders/relevatehealth.md b/dev-docs/bidders/relevatehealth.md
index 6fd7eecc08..481f8c76dc 100644
--- a/dev-docs/bidders/relevatehealth.md
+++ b/dev-docs/bidders/relevatehealth.md
@@ -54,3 +54,30 @@ var adUnits = [
             }
         ];
 ```
+
+#### First Party Data
+
+In release 4.30 and later, publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:
+
+* ortb2.user.id
+* ortb2.user.buyeruid
+* ortb2.user.keywords
+* ortb2.user.ext.*
+
+Example first party data that's available to all bidders and all adunits:
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    user: {
+      id: 123456789,        // Unique pseudonymized ID for the user (e.g., NPI).
+      buyeruid: 987654321,  // DSP-assigned user ID for identity resolution.
+      keywords: "kw1,kw2",  // Interest or specialty tags (e.g., oncology, cardiology)
+      ext: {
+        key1: "values",    // Custom healthcare metadata (e.g., icd10), single or comma seperated.
+        key2: "values"     // Additional campaign context (e.g., ndc), single or comma seperated.
+      }
+    }
+  }
+});
+```

From ee44c5c9032bdb8b78a26a3c36e882f5dab1bc88 Mon Sep 17 00:00:00 2001
From: Screencore Developer <connect@screencore.io>
Date: Thu, 2 Oct 2025 07:41:32 +0300
Subject: [PATCH 343/665] enable prebid.js for screencore (#6237)

---
 dev-docs/bidders/screencore.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/screencore.md b/dev-docs/bidders/screencore.md
index 2aef78ac89..0a978cf530 100644
--- a/dev-docs/bidders/screencore.md
+++ b/dev-docs/bidders/screencore.md
@@ -10,6 +10,7 @@ schain_supported: true
 media_types: banner, video, native
 safeframes_ok: true
 deals_supported: true
+pbjs: true
 pbs: true
 sidebarType: 1
 floors_supported: true

From f78b7dd3fd799aa5e2fa93c76e86b36a2904c6b3 Mon Sep 17 00:00:00 2001
From: Mikhail Malkov <mhlmlkv@gmail.com>
Date: Thu, 2 Oct 2025 12:08:39 +0300
Subject: [PATCH 344/665] NexMillennium: Added support for some openrtb
 parameters (#6265)

* updated option safeframe_ok in documentation

* fixed typo

* added support some new pameters for openrtb 2.6
---
 dev-docs/bidders/nextMillennium.md | 93 +++++++++++++++++++++++++++++-
 1 file changed, 90 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/nextMillennium.md b/dev-docs/bidders/nextMillennium.md
index aeb84b347a..d6aba1a174 100644
--- a/dev-docs/bidders/nextMillennium.md
+++ b/dev-docs/bidders/nextMillennium.md
@@ -67,21 +67,60 @@ pbjs.setConfig({
 });
 ```
 
-#### OpenRTB 2.5 supported parameters
+#### OpenRTB 2.6 supported parameters
 
 The adapter for Prebid.js supports the following options:
 
 * `site.pagecat`
+* `site.keywords`
+* `site.name`
+* `site.cattax`
+* `site.cat`
+* `site.sectioncat`
+* `site.search`
+* `site.mobile`
+* `site.privacypolicy`
+* `site.kwarray`
 * `site.content.cat`
 * `site.content.language`
-* `device.sua`
-* `site.keywords`
 * `site.content.keywords`
+* `site.publisher.id`
+* `site.publisher.name`
+* `site.publisher.cattax`
+* `site.publisher.cat`
+* `site.publisher.domain`
+* `device.sua`
+* `device.ip`
+* `device.ipv6`
+* `device.dnt`
+* `device.lmt`
+* `device.devicetype`
+* `device.make`
+* `device.model`
+* `device.os`
+* `device.osv`
+* `device.hwv`
+* `device.geo.lat`
+* `device.geo.lon`
+* `device.geo.type`
+* `device.geo.accuracy`
+* `device.geo.lastfix`
+* `device.geo.ipservice`
+* `device.geo.country`
+* `device.geo.region`
+* `device.geo.regionfips104`
+* `device.geo.metro`
+* `device.geo.city`
+* `device.geo.zip`
+* `device.geo.utcoffset`
+* `device.language`
+* `device.langb`
 * `user.keywords`
 * `bcat`
 * `badv`
 * `wlang`
 * `wlangb`
+* `cattax`
 
 You can set these parameters through the Prebid.js configuration setup functions: [pbjs.setConfig](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html) or [pbjs.setBidderConfig](https://docs.prebid.org/dev-docs/publisher-api-reference/setBidderConfig.html).
 An example of setting openrtb parameters for the entire prebid.js script.
@@ -118,3 +157,51 @@ pbjs.setBidderConfig({
   }
 });
 ```
+
+#### Support for OpenRTB 2.6 parameters at the Ad Units level
+
+* `displaymanager`
+* `displaymanagerver`
+* `instl`
+* `banner.btype`
+* `banner.battr`
+* `banner.mimes`
+* `banner.topframe`
+* `banner.expdir`
+* `banner.api`
+* `banner.format`
+* `video.rqddurs`
+* `video.battr`
+* `video.maxextended`
+* `video.minbitrate`
+* `video.maxbitrate`
+* `video.boxingallowed`
+* `video.api`
+* `video.companiontype`
+
+Example of setting OpenRTB parameters at the Ad Units level:
+
+```javascript
+pbjs.addAdUnits({
+  code: 'Some-Ad-Unit',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]],
+    },
+  },
+
+  ortb2Imp: {
+    mimes: ['image/jpeg', 'image/png'],
+  },
+
+  bids: [
+    {
+      bidder: 'nextMillennium',
+      params: {
+        placement_id: 13234567,
+      },
+    },
+  ],
+});
+
+```

From f8d410765825613783aa4fbfb36692dde208fc0d Mon Sep 17 00:00:00 2001
From: andreafassina <127768714+andreafassina@users.noreply.github.com>
Date: Thu, 2 Oct 2025 20:03:49 +0200
Subject: [PATCH 345/665] docs: enable pbs support (#6108)

---
 dev-docs/bidders/nativery.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/nativery.md b/dev-docs/bidders/nativery.md
index 4259ef49cf..007a3a0d19 100644
--- a/dev-docs/bidders/nativery.md
+++ b/dev-docs/bidders/nativery.md
@@ -17,8 +17,8 @@ deals_supported: false
 floors_supported: false
 fpd_supported: true
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 prebid_member: false
 multiformat_supported: will-bid-on-any
 ortb_blocking_supported: false

From 892908902c7c819d14339e45906dce475ef41429 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Fri, 3 Oct 2025 18:29:02 +0300
Subject: [PATCH 346/665] Adkernel: documenting SmartyExchange alias (#6261)

---
 dev-docs/bidders/smartyexchange.md | 41 ++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/smartyexchange.md

diff --git a/dev-docs/bidders/smartyexchange.md b/dev-docs/bidders/smartyexchange.md
new file mode 100644
index 0000000000..6ea3f86430
--- /dev/null
+++ b/dev-docs/bidders/smartyexchange.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: SmartyExchange
+description: SmartyExchange Adaptor
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The SmartyExchange bidding adaptor requires setup and approval before beginning. Please reach out to <ops@buddhavibestechnologies.com> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.arteabee.com'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From ca90443738c1d14047447f978c063893e1f86e6b Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Sat, 4 Oct 2025 13:40:46 +0300
Subject: [PATCH 347/665] Adkernel: documenting Infinety alias (#6280)

---
 dev-docs/bidders/infinety.md | 41 ++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/infinety.md

diff --git a/dev-docs/bidders/infinety.md b/dev-docs/bidders/infinety.md
new file mode 100644
index 0000000000..8da6b131c3
--- /dev/null
+++ b/dev-docs/bidders/infinety.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Infinety
+description: Infinety Adaptor
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The Infinety bidding adaptor requires setup and approval before beginning. Please reach out to <ssp@infinety.hu> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.infinety.hu'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From cd059c9660c497915a20c06a45fdc42d528424a3 Mon Sep 17 00:00:00 2001
From: Pete <petropo@playbuzz.com>
Date: Sat, 4 Oct 2025 13:42:58 +0300
Subject: [PATCH 348/665] Update exco bidder documentation (#6276)

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* feat(): EXCO Bid Adapter: Support of new publisherId, accountId and tagId parameters.

* Update exco bidder documentation

* fix(exco): typo

* Update exco bidder documentation
---
 dev-docs/bidders/exco.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/exco.md b/dev-docs/bidders/exco.md
index e0089d715c..379f071d10 100644
--- a/dev-docs/bidders/exco.md
+++ b/dev-docs/bidders/exco.md
@@ -13,7 +13,7 @@ schain_supported: true
 gpp_supported: true
 floors_supported: true
 media_types: banner, video
-prebid_member: false
+prebid_member: true
 safeframes_ok: false
 deals_supported: false
 pbs_app_supported: false
@@ -21,6 +21,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
+pbs: true
 sidebarType: 1
 ---
 
@@ -30,9 +31,6 @@ sidebarType: 1
 
 | Name          | Scope      | Description                                                                           | Example                      | Type     |
 |---------------|------------|---------------------------------------------------------------------------------------|------------------------------|----------|
-| `cId`         | deprecated | The connection ID from Exco.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
-| `pId`         | deprecated | The publisher ID from Exco.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
-| `bidFloor`    | deprecated | The minimum bid value desired. Exco will not respond with bids lower than this value. | `0.90`                       | `float`  |
 | `accountId`   | required   | A unique account identifier provided by EX.CO.                                        | `'1234567890'`               | `string` |
 | `publisherId` | required   | Publisher ID provided by EX.CO.                                                       | `'1234567890'`               | `string` |
 | `tagId`       | required   | A unique Tag ID (supply id) identifier provided by EX.CO.                             | `'1234567890'`               | `string` |

From f77616f9b5d24bce4c90c8e83771758fbea9671d Mon Sep 17 00:00:00 2001
From: SamuelAlejandroNT <samaldonado@nuevatel.com>
Date: Mon, 6 Oct 2025 04:53:35 -0400
Subject: [PATCH 349/665] Add Alva (alvads) bidder adapter documentation
 (#6231)

* Add Alva (alvads) bidder adapter documentation

* initial doc

* added bidfloor support

---------

Co-authored-by: Samuel Alejandro Maldonado Garcia <samaldonado@nuevatel.net>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 ADS - Acceso directo.lnk   | Bin 0 -> 885 bytes
 dev-docs/bidders/alvads.md | 152 +++++++++++++++++++++++++++++++++++++
 2 files changed, 152 insertions(+)
 create mode 100644 ADS - Acceso directo.lnk
 create mode 100644 dev-docs/bidders/alvads.md

diff --git a/ADS - Acceso directo.lnk b/ADS - Acceso directo.lnk
new file mode 100644
index 0000000000000000000000000000000000000000..192bf02077e7d432721f25569068a5ae8812c27b
GIT binary patch
literal 885
zcmah{Ur3Wt6hEJtxE^w=Wow$wLQ||Ut%o)mxVCbL;b5$yt=QZqF5SMlZ`FcI>7kGu
z1rfxckg{aaAA_PIEMKf1dRRSJ<{o;r43l1Z3HqJ8RC<W+$M2l;opbIvzkBa#Cn8B(
z1W7a@B<;OGrKE=4SMf~m&(26*tG=pQmzU0T&F#BXo|i-rajB5MBr~L?YS-tEoZ*Wl
zqQ3F5lp0N@YZfvNSl+&Tv~{L^_gF*!Z07tcTOIb+(fkVy_GT}dC!bGEOU}*PW^bbU
zq^6{81X@dN)Ff)_y}M#+vN_zelT=iUeS?QosY>s=P9x&B0cLL&nakqrcA0GCAU9lV
zfc-!vz?@m{0C;%-9k2pON6dLX_kl<(B%e^oZt;1Pa6<7ZfoPyNB*y|F+2;r=JxMw4
zV>+~wjQD&)`U_Qt4?^>bHOG=krE_sF-3dRfY0kRr=T80TKT>i!(>RuTv!(32=Kkfm
z;D-n6)BlUV26YwD@JZBea=YB$Oyi&IG}t=&Gq-j`>DqJ{{t!2=25Nylq)?C&6rm)^
zLd#^Jda{!Rls$+Zqre}(0*`{fDA0>CGR0uAZs3w)U4`VvriI!k^R0UIt%V~0(Dko(
zH^9G&Gq`avuz2t5V3z^Z!Xlce;9=s2;v|u+g|-V4aSDTG00cv@48j+rZje6?5(@IT
z+G;>lTN*|D_W{i7_R(Oy^~!tA<0+cxnAYX^X{!LysRnxa;9(s5-$(XgZo-K7h>MHk
uY8Fq#)e5u54Ih?A9rx04=cu#AIATo=ZA7e_6P!TFFY`FtL?)iCzt(R7=D}D1

literal 0
HcmV?d00001

diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md
new file mode 100644
index 0000000000..9f605579d4
--- /dev/null
+++ b/dev-docs/bidders/alvads.md
@@ -0,0 +1,152 @@
+---
+layout: bidder
+title: Alva
+description: Prebid Alva Bidder Adapter
+pbjs: true
+pbs_app_supported: false
+biddercode: alvads
+media_types: banner, video
+gdpr_supported: true
+usp_supported: true
+coppa_supported: false
+---
+
+# Overview
+
+**Module Name:** alvadsBidAdapter  
+**Module Type:** Bidder  
+**Maintainer:** [alvads@oyealva.com](mailto:alvads@oyealva.com)
+
+---
+
+# Description
+
+The **Alva Bid Adapter** allows publishers to connect their banner and video inventory with the Alva demand platform.
+
+- **Bidder Code:** `alvads`
+- **Supported Media Types:** `banner`, `video`
+- **Protocols:** OpenRTB 2.5 via `POST` (banner and video)
+- **Dynamic Endpoints:** The adapter uses a default endpoint, but can be overridden via `params.endpoint`.
+- **Price Floors:** Supported via `bid.getFloor()`. If configured, the adapter will send `bidfloor` and `bidfloorcur` per impression.
+
+---
+# Parameters
+
+| Parameter   | Required         | Description |
+|------------ |---------------- |------------ |
+| publisherId | Yes             | Publisher ID assigned by Alva |
+| tagid       | Banner only      | Required for banner impressions |
+| bidfloor    | No              | Optional; adapter supports floors module via `bid.getFloor()` |
+| userId      | No              | Optional; used for user identification |
+| endpoint    | No              | Optional; overrides default endpoint |
+
+---
+
+# Test Parameters
+
+### Banner Example
+
+```javascript
+var adUnits = [{
+  code: 'div-banner',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250], [320, 100]]
+    }
+  },
+  bids: [{
+    bidder: 'alvads',
+    params: {
+      publisherId: 'pub-123',    // required
+      tagid: 'tag-456',          // required for banner
+      bidfloor: 0.50,            // optional
+      userId: '+59165352182',    // optional
+      endpoint: 'https://custom-endpoint.com/openrtb' // optional, overrides default
+    }
+  }]
+}];
+```
+
+### Video Example
+
+```javascript
+var adUnits = [{
+  code: 'video-ad',
+  mediaTypes: {
+    video: {
+      context: 'instream',
+      playerSize: [[640, 360]]
+    }
+  },
+  bids: [{
+    bidder: 'alvads',
+    params: {
+      publisherId: 'pub-123',     // required
+      bidfloor: 0.5,              // optional
+      userId: '+59165352182',     // optional
+      endpoint: 'https://custom-endpoint.com/video' // optional, overrides default
+    }
+  }]
+}];
+```
+
+---
+
+# Request Information
+
+### Banner / Video
+- **Default Endpoint:**
+  ```
+  https://helios-ads-qa-core.ssidevops.com/decision/openrtb
+  ```
+- **Method:** `POST`
+- **Payload:** OpenRTB 2.5 request containing `site`, `device`, `user`, `regs`, and `imp`.
+- **Dynamic Endpoint:** Can be overridden via `bid.params.endpoint`.
+
+---
+
+# Response Information
+
+### Banner
+The response is standard OpenRTB with `seatbid`.
+
+```json
+{
+  "id": "response-id",
+  "seatbid": [{
+    "bid": [{
+      "impid": "imp-123",
+      "price": 0.50,
+      "adm": "<div>Creative</div>",
+      "crid": "creative-1",
+      "w": 320,
+      "h": 100,
+      "ext": {
+        "vast_url": "http://example.com/vast.xml"
+      },
+      "adomain": ["example.com"]
+    }]
+  }],
+  "cur": "USD"
+}
+```
+
+### Interpretation
+- If `adm` contains `<VAST>`, the adapter sets `mediaType: 'video'` and includes `vastXml` & `vastUrl`.
+- Otherwise, `mediaType: 'banner'` and the ad contains the HTML markup.
+
+---
+
+# Additional Details
+
+- **Defaults:**
+    - `netRevenue = true`
+    - `ttl = 300`
+    - Banner fallback size: `320x100`
+    - Video fallback size: `1280x720`
+
+- **Callbacks:**
+    - `onTimeout` → logs timeout events
+    - `onBidWon` → logs winning bids
+
+---

From 0d1ec998e819dae72a15197f811f97078f5029fb Mon Sep 17 00:00:00 2001
From: Brian O'Kelley <cokelley@alumni.princeton.edu>
Date: Mon, 6 Oct 2025 05:01:54 -0400
Subject: [PATCH 350/665] Add Scope3 RTD Provider documentation (#6217)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add documentation for Scope3 RTD Provider

- Complete configuration examples with basic and advanced setups
- Detailed parameter descriptions and response format
- GAM integration instructions with line item examples
- Data flow explanation and testing guidance
- Privacy considerations and support information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix markdown linting issues in Scope3 RTD Provider documentation

- Change all list bullets from dashes to asterisks for consistency
- Add proper blank lines around lists and tables
- Fix bare URL in endpoint parameter description
- Add language specification to fenced code block
- Add trailing newline to end of file

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Add Prebid Server Scope3 RTD module documentation

- Complete configuration examples for YAML and JSON
- Identity integration details (LiveRamp, encrypted envelopes)
- Performance optimization and caching strategy
- GAM integration examples
- Troubleshooting guide and monitoring instructions

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Fix markdown linting issues in PBS documentation

- Add blank lines around all lists per MD032
- Add language specifier to code block (text)
- Format email as inline code to avoid bare URL warning
- Add trailing newline at end of file

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/modules/scope3RtdProvider.md         | 215 ++++++++++++++
 .../pbs-modules/scope3-real-time-data.md      | 262 ++++++++++++++++++
 2 files changed, 477 insertions(+)
 create mode 100644 dev-docs/modules/scope3RtdProvider.md
 create mode 100644 prebid-server/pbs-modules/scope3-real-time-data.md

diff --git a/dev-docs/modules/scope3RtdProvider.md b/dev-docs/modules/scope3RtdProvider.md
new file mode 100644
index 0000000000..c2e433fadd
--- /dev/null
+++ b/dev-docs/modules/scope3RtdProvider.md
@@ -0,0 +1,215 @@
+---
+layout: page_v2
+title: Scope3 RTD Provider
+display_name: Scope3 RTD Provider
+description: Scope3 Real-Time Data Provider for Prebid.js
+page_type: module
+module_type: rtd
+module_code: scope3RtdProvider
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# Scope3 RTD Provider
+
+The Scope3 RTD (Real-Time Data) Provider enables publishers to leverage Scope3's Agentic Execution Engine (AEE) for real-time media buying optimization. This module sends complete OpenRTB requests to Scope3 and receives contextual signals that enhance auction targeting.
+
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The Scope3 RTD Provider:
+
+* Sends complete OpenRTB 2.x requests including extended UIDs, geo data, and device information
+* Receives AEE signals for include/exclude targeting and macros
+* Supports bidder-specific segments and deal IDs
+* Enables configurable GAM targeting keys
+* Works client-side without API keys
+
+## Usage
+
+### Basic Configuration
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 100,
+        dataProviders: [{
+            name: "scope3RtdProvider",
+            waitForIt: true,
+            params: {
+                orgId: "your-org-id"
+            }
+        }]
+    }
+});
+```
+
+### Full Configuration
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 200,
+        dataProviders: [{
+            name: "scope3RtdProvider",
+            waitForIt: true,
+            params: {
+                orgId: "your-org-id",
+                endpoint: "<https://prebid.scope3.com/prebid>",
+                timeout: 1500,
+                bidders: ["appnexus", "rubicon", "pubmatic"],
+                includeKey: "scope3_include",
+                excludeKey: "scope3_exclude", 
+                macroKey: "scope3_macro",
+                publisherTargeting: true,
+                advertiserTargeting: true,
+                cacheEnabled: true,
+                cacheTtl: 300000
+            }
+        }]
+    }
+});
+```
+
+## Configuration Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| orgId | String | Yes | Your Scope3 organization ID |
+| endpoint | String | No | API endpoint (default: `https://prebid.scope3.com/prebid`) |
+| timeout | Number | No | Request timeout in milliseconds (default: 1000) |
+| bidders | Array | No | List of bidders to target (default: all auction bidders) |
+| includeKey | String | No | GAM targeting key for include signals (default: "scope3_include") |
+| excludeKey | String | No | GAM targeting key for exclude signals (default: "scope3_exclude") |
+| macroKey | String | No | GAM targeting key for macro data (default: "scope3_macro") |
+| publisherTargeting | Boolean | No | Enable publisher-level targeting (default: true) |
+| advertiserTargeting | Boolean | No | Enable advertiser-level targeting (default: true) |
+| cacheEnabled | Boolean | No | Enable response caching (default: true) |
+| cacheTtl | Number | No | Cache TTL in milliseconds (default: 300000) |
+
+## Response Format
+
+The Scope3 AEE returns signals in this format:
+
+```json
+{
+  "aee_signals": {
+    "include": ["sports_fan", "auto_intender"],
+    "exclude": ["competitor_exposed"],
+    "macro": "eyJjb250ZXh0IjogImhpZ2hfdmFsdWUifQ==",
+    "bidders": {
+      "appnexus": {
+        "segments": ["seg1", "seg2"],
+        "deals": ["DEAL123"]
+      },
+      "rubicon": {
+        "segments": ["seg3"],
+        "deals": []
+      }
+    }
+  }
+}
+```
+
+## GAM Integration
+
+### Line Item Setup
+
+Create GAM line items with key-value targeting using the configured keys:
+
+**Include Targeting:**
+
+* Key: `scope3_include` (or your configured includeKey)
+* Values: `sports_fan`, `auto_intender`, etc.
+* Operator: "is any of"
+
+**Exclude Targeting:**
+
+* Key: `scope3_exclude` (or your configured excludeKey)
+* Values: `competitor_exposed`, etc.
+* Operator: "is none of"
+
+**Macro Targeting:**
+
+* Key: `scope3_macro` (or your configured macroKey)
+* Values: Base64-encoded contextual data
+
+### Example Line Item Configuration
+
+```text
+Creative: 300x250 Banner
+Targeting:
+  * scope3_include is any of "sports_fan", "auto_intender"
+  * scope3_exclude is none of "competitor_exposed"
+  * scope3_macro is "eyJjb250ZXh0IjogImhpZ2hfdmFsdWUifQ=="
+```
+
+## Data Flow
+
+1. **Request**: Module sends complete OpenRTB request to Scope3 including:
+   * All extended user IDs
+   * Geo and device data
+   * Ad unit configurations
+   * Bidder list
+
+2. **Processing**: Scope3's AEE analyzes the request context
+
+3. **Response**: AEE returns targeting signals:
+   * Global include/exclude segments
+   * Bidder-specific segments and deals
+   * Contextual macro data
+
+4. **Application**: Module applies signals to bid request:
+   * Global targeting in `ortb2Fragments.global.site.ext.data`
+   * Bidder segments in `ortb2Fragments.bidder[].user.data`
+   * Deal IDs in ad unit `ortb2Imp.ext`
+
+## Testing
+
+### Integration Testing
+
+Use the Hello World example to verify integration:
+
+1. Configure the module with your orgId
+2. Monitor network requests to confirm data is sent
+3. Check that targeting data appears in bid requests
+4. Verify GAM line items receive the targeting keys
+
+### Debug Mode
+
+Enable Prebid debug mode to see targeting data:
+
+```javascript
+pbjs.debug = true;
+```
+
+Check the browser console for RTD provider logs and bid request modifications.
+
+## Privacy Considerations
+
+The Scope3 RTD Provider:
+
+* Respects user consent choices
+* Only processes data necessary for contextual targeting
+* Does not store personal information
+* Complies with privacy regulations when properly configured
+
+## Support
+
+For questions about the Scope3 RTD Provider:
+
+* Technical issues: Open a GitHub issue in the Prebid.js repository
+* Integration support: Contact your Scope3 representative
+* Documentation: Submit PRs to improve this documentation
+
+## Related Modules
+
+* [Real-Time Data Module]({{site.baseurl}}/dev-docs/modules/realTimeData.html)
+* [RTD Sub-Module Development]({{site.baseurl}}/dev-docs/add-rtd-submodule.html)
diff --git a/prebid-server/pbs-modules/scope3-real-time-data.md b/prebid-server/pbs-modules/scope3-real-time-data.md
new file mode 100644
index 0000000000..df5f876dac
--- /dev/null
+++ b/prebid-server/pbs-modules/scope3-real-time-data.md
@@ -0,0 +1,262 @@
+---
+layout: page_v2
+title: Prebid Server Scope3 Real Time Data Module
+display_name: Scope3 Real Time Data Module
+description: Scope3 RTD module for Prebid Server
+sidebarType: 5
+---
+
+# Scope3 Real Time Data Module
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The Scope3 Real Time Data (RTD) module integrates Scope3's Agentic Execution Engine to provide real-time audience segments and contextual signals for programmatic advertising. This module enables publishers to leverage Scope3's AI-driven targeting capabilities directly within Prebid Server auctions.
+
+## Features
+
+* **Real-time Segmentation**: Fetches audience segments from Scope3's API in real-time
+* **Identity Integration**: Works with LiveRamp, publisher IDs, and encrypted identity envelopes  
+* **Intelligent Caching**: Thread-safe caching with configurable TTL to optimize performance
+* **Flexible Output**: Segments available in response for publisher control
+* **GAM Integration**: Optional direct targeting key population for Google Ad Manager
+* **Error Resilience**: Graceful degradation without blocking auctions
+
+## Installation
+
+To enable this module, compile Prebid Server with:
+
+```bash
+go build -tags scope3_rtd
+```
+
+Or include in your Docker build:
+
+```dockerfile
+RUN go build -tags scope3_rtd
+```
+
+## Configuration
+
+### Basic Configuration
+
+```yaml
+hooks:
+  enabled: true
+  modules:
+    scope3:
+      rtd:
+        enabled: true
+        auth_key: ${SCOPE3_API_KEY}
+        timeout_ms: 1000
+```
+
+### Full Configuration
+
+```yaml
+hooks:
+  enabled: true
+  modules:
+    scope3:
+      rtd:
+        enabled: true
+        auth_key: ${SCOPE3_API_KEY}
+        timeout_ms: 1000
+        cache_ttl_seconds: 60
+        add_to_targeting: false
+  host_execution_plan:
+    endpoints:
+      /openrtb2/auction:
+        stages:
+          entrypoint:
+            groups:
+              - timeout: 5
+                hook_sequence:
+                  - module_code: "scope3.rtd"
+                    hook_impl_code: "HandleEntrypointHook"
+          raw_auction_request:
+            groups:
+              - timeout: 2000
+                hook_sequence:
+                  - module_code: "scope3.rtd"
+                    hook_impl_code: "HandleRawAuctionHook"
+          auction_response:
+            groups:
+              - timeout: 5
+                hook_sequence:
+                  - module_code: "scope3.rtd"
+                    hook_impl_code: "HandleAuctionResponseHook"
+```
+
+### Configuration Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| enabled | boolean | Yes | - | Enable/disable the module |
+| auth_key | string | Yes | - | Scope3 API authentication key |
+| timeout_ms | int | No | 1000 | API request timeout in milliseconds |
+| cache_ttl_seconds | int | No | 60 | Cache duration in seconds |
+| add_to_targeting | boolean | No | false | Add segments as GAM targeting keys |
+
+## Identity Support
+
+The module automatically detects and forwards available user identifiers:
+
+### LiveRamp Identifiers
+
+* `user.ext.eids[]` with `source: "liveramp.com"`
+* `user.ext.rampid` field
+
+### Encrypted Identity Envelopes
+
+* `user.ext.liveramp_idl` - ATS envelope
+* `user.ext.ats_envelope` - Alternative envelope location
+* `user.ext.rampId_envelope` - Additional envelope location
+* `ext.liveramp_idl` - Request-level envelope
+
+### Standard Identifiers
+
+* `user.id` - Publisher user ID
+* `device.ifa` - Device advertising ID
+* Other OpenRTB standard identifiers
+
+## Response Format
+
+### Standard Response
+Segments are always available in the response extension:
+
+```json
+{
+  "ext": {
+    "scope3": {
+      "segments": ["gmp_eligible", "high_value_user", "sports_fan"]
+    }
+  }
+}
+```
+
+### With GAM Targeting (add_to_targeting: true)
+When enabled, segments are also added as targeting keys:
+
+```json
+{
+  "ext": {
+    "prebid": {
+      "targeting": {
+        "gmp_eligible": "true",
+        "high_value_user": "true",
+        "sports_fan": "true"
+      }
+    },
+    "scope3": {
+      "segments": ["gmp_eligible", "high_value_user", "sports_fan"]
+    }
+  }
+}
+```
+
+## Performance Optimization
+
+### Caching Strategy
+
+* **Cache Key**: Generated from user IDs, domain, and page URL
+* **Thread Safety**: Read-write mutexes for concurrent access
+* **Memory Efficiency**: Stores only segment arrays
+* **Frequency Caps**: 60-second default TTL ensures fresh data
+
+### HTTP Optimization
+
+* Connection pooling with keep-alive
+* HTTP/2 support when available
+* Gzip compression for responses
+* Configurable timeouts
+
+## Integration Examples
+
+### Google Ad Manager
+Publishers can use segments for GAM targeting:
+
+```javascript
+// Client-side code to read Scope3 segments
+pbjs.getBidResponses().forEach(response => {
+  const segments = response.ext?.scope3?.segments || [];
+  // Forward to GAM targeting
+});
+```
+
+### Custom Ad Servers
+Access segments from the auction response:
+
+```go
+// Server-side handling
+segments := response.Ext["scope3"]["segments"]
+// Forward to your ad server
+```
+
+## Monitoring
+
+The module logs important events at different levels:
+
+* **INFO**: Successful segment fetches and cache hits
+* **WARN**: API timeouts or non-critical errors
+* **ERROR**: Configuration issues or critical failures
+
+Example log entries:
+
+```text
+INFO: Scope3 RTD: Fetched 3 segments for user
+WARN: Scope3 RTD: API timeout after 1000ms
+INFO: Scope3 RTD: Cache hit for key abc123
+```
+
+## Troubleshooting
+
+### No Segments Returned
+
+1. Verify API key is correctly configured
+2. Check endpoint URL accessibility
+3. Ensure user identifiers are present in bid request
+4. Review server logs for API errors
+
+### Performance Issues
+
+1. Adjust `timeout_ms` based on network latency
+2. Increase `cache_ttl_seconds` for less frequent updates
+3. Monitor cache hit rates in logs
+4. Check API response times
+
+### Configuration Errors
+
+1. Validate YAML/JSON syntax
+2. Ensure environment variables are set
+3. Check module is compiled into PBS binary
+4. Verify hook execution plan is correct
+
+## Privacy Compliance
+
+The module respects privacy signals:
+
+* Honors GDPR consent strings
+* Respects US Privacy (CCPA) signals  
+* Does not process requests when consent is denied
+* Only forwards consented identifiers to Scope3
+
+## Support
+
+For technical support:
+
+* **Issues**: Open a GitHub issue in the Prebid Server repository
+* **Documentation**: Submit PRs to improve this documentation
+* **Integration Help**: Contact your Scope3 representative
+* **Email**: `bokelley@scope3.com`
+
+## Related Documentation
+
+* [Prebid Server Modules]({{site.baseurl}}/prebid-server/pbs-modules/)
+* [Module Development]({{site.baseurl}}/prebid-server/developers/add-a-module.html)
+* [Real-Time Data Overview]({{site.baseurl}}/prebid-server/features/pbs-rtd.html)

From 338fe5c9490c308c1e88c7b335c40c81ffd8fe69 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Mon, 6 Oct 2025 15:37:49 +0200
Subject: [PATCH 351/665] Revert "Add Alva (alvads) bidder adapter
 documentation (#6231)" (#6283)

This reverts commit f77616f9b5d24bce4c90c8e83771758fbea9671d.
---
 ADS - Acceso directo.lnk   | Bin 885 -> 0 bytes
 dev-docs/bidders/alvads.md | 152 -------------------------------------
 2 files changed, 152 deletions(-)
 delete mode 100644 ADS - Acceso directo.lnk
 delete mode 100644 dev-docs/bidders/alvads.md

diff --git a/ADS - Acceso directo.lnk b/ADS - Acceso directo.lnk
deleted file mode 100644
index 192bf02077e7d432721f25569068a5ae8812c27b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 885
zcmah{Ur3Wt6hEJtxE^w=Wow$wLQ||Ut%o)mxVCbL;b5$yt=QZqF5SMlZ`FcI>7kGu
z1rfxckg{aaAA_PIEMKf1dRRSJ<{o;r43l1Z3HqJ8RC<W+$M2l;opbIvzkBa#Cn8B(
z1W7a@B<;OGrKE=4SMf~m&(26*tG=pQmzU0T&F#BXo|i-rajB5MBr~L?YS-tEoZ*Wl
zqQ3F5lp0N@YZfvNSl+&Tv~{L^_gF*!Z07tcTOIb+(fkVy_GT}dC!bGEOU}*PW^bbU
zq^6{81X@dN)Ff)_y}M#+vN_zelT=iUeS?QosY>s=P9x&B0cLL&nakqrcA0GCAU9lV
zfc-!vz?@m{0C;%-9k2pON6dLX_kl<(B%e^oZt;1Pa6<7ZfoPyNB*y|F+2;r=JxMw4
zV>+~wjQD&)`U_Qt4?^>bHOG=krE_sF-3dRfY0kRr=T80TKT>i!(>RuTv!(32=Kkfm
z;D-n6)BlUV26YwD@JZBea=YB$Oyi&IG}t=&Gq-j`>DqJ{{t!2=25Nylq)?C&6rm)^
zLd#^Jda{!Rls$+Zqre}(0*`{fDA0>CGR0uAZs3w)U4`VvriI!k^R0UIt%V~0(Dko(
zH^9G&Gq`avuz2t5V3z^Z!Xlce;9=s2;v|u+g|-V4aSDTG00cv@48j+rZje6?5(@IT
z+G;>lTN*|D_W{i7_R(Oy^~!tA<0+cxnAYX^X{!LysRnxa;9(s5-$(XgZo-K7h>MHk
uY8Fq#)e5u54Ih?A9rx04=cu#AIATo=ZA7e_6P!TFFY`FtL?)iCzt(R7=D}D1

diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md
deleted file mode 100644
index 9f605579d4..0000000000
--- a/dev-docs/bidders/alvads.md
+++ /dev/null
@@ -1,152 +0,0 @@
----
-layout: bidder
-title: Alva
-description: Prebid Alva Bidder Adapter
-pbjs: true
-pbs_app_supported: false
-biddercode: alvads
-media_types: banner, video
-gdpr_supported: true
-usp_supported: true
-coppa_supported: false
----
-
-# Overview
-
-**Module Name:** alvadsBidAdapter  
-**Module Type:** Bidder  
-**Maintainer:** [alvads@oyealva.com](mailto:alvads@oyealva.com)
-
----
-
-# Description
-
-The **Alva Bid Adapter** allows publishers to connect their banner and video inventory with the Alva demand platform.
-
-- **Bidder Code:** `alvads`
-- **Supported Media Types:** `banner`, `video`
-- **Protocols:** OpenRTB 2.5 via `POST` (banner and video)
-- **Dynamic Endpoints:** The adapter uses a default endpoint, but can be overridden via `params.endpoint`.
-- **Price Floors:** Supported via `bid.getFloor()`. If configured, the adapter will send `bidfloor` and `bidfloorcur` per impression.
-
----
-# Parameters
-
-| Parameter   | Required         | Description |
-|------------ |---------------- |------------ |
-| publisherId | Yes             | Publisher ID assigned by Alva |
-| tagid       | Banner only      | Required for banner impressions |
-| bidfloor    | No              | Optional; adapter supports floors module via `bid.getFloor()` |
-| userId      | No              | Optional; used for user identification |
-| endpoint    | No              | Optional; overrides default endpoint |
-
----
-
-# Test Parameters
-
-### Banner Example
-
-```javascript
-var adUnits = [{
-  code: 'div-banner',
-  mediaTypes: {
-    banner: {
-      sizes: [[300, 250], [320, 100]]
-    }
-  },
-  bids: [{
-    bidder: 'alvads',
-    params: {
-      publisherId: 'pub-123',    // required
-      tagid: 'tag-456',          // required for banner
-      bidfloor: 0.50,            // optional
-      userId: '+59165352182',    // optional
-      endpoint: 'https://custom-endpoint.com/openrtb' // optional, overrides default
-    }
-  }]
-}];
-```
-
-### Video Example
-
-```javascript
-var adUnits = [{
-  code: 'video-ad',
-  mediaTypes: {
-    video: {
-      context: 'instream',
-      playerSize: [[640, 360]]
-    }
-  },
-  bids: [{
-    bidder: 'alvads',
-    params: {
-      publisherId: 'pub-123',     // required
-      bidfloor: 0.5,              // optional
-      userId: '+59165352182',     // optional
-      endpoint: 'https://custom-endpoint.com/video' // optional, overrides default
-    }
-  }]
-}];
-```
-
----
-
-# Request Information
-
-### Banner / Video
-- **Default Endpoint:**
-  ```
-  https://helios-ads-qa-core.ssidevops.com/decision/openrtb
-  ```
-- **Method:** `POST`
-- **Payload:** OpenRTB 2.5 request containing `site`, `device`, `user`, `regs`, and `imp`.
-- **Dynamic Endpoint:** Can be overridden via `bid.params.endpoint`.
-
----
-
-# Response Information
-
-### Banner
-The response is standard OpenRTB with `seatbid`.
-
-```json
-{
-  "id": "response-id",
-  "seatbid": [{
-    "bid": [{
-      "impid": "imp-123",
-      "price": 0.50,
-      "adm": "<div>Creative</div>",
-      "crid": "creative-1",
-      "w": 320,
-      "h": 100,
-      "ext": {
-        "vast_url": "http://example.com/vast.xml"
-      },
-      "adomain": ["example.com"]
-    }]
-  }],
-  "cur": "USD"
-}
-```
-
-### Interpretation
-- If `adm` contains `<VAST>`, the adapter sets `mediaType: 'video'` and includes `vastXml` & `vastUrl`.
-- Otherwise, `mediaType: 'banner'` and the ad contains the HTML markup.
-
----
-
-# Additional Details
-
-- **Defaults:**
-    - `netRevenue = true`
-    - `ttl = 300`
-    - Banner fallback size: `320x100`
-    - Video fallback size: `1280x720`
-
-- **Callbacks:**
-    - `onTimeout` → logs timeout events
-    - `onBidWon` → logs winning bids
-
----

From ad0a2a0198714c839ce968b38cacb7867dbdb6ca Mon Sep 17 00:00:00 2001
From: Afrontio <support@afront.io>
Date: Mon, 6 Oct 2025 16:46:19 +0300
Subject: [PATCH 352/665] feat: afront adapter doc (#6097)

* feat: afront adapter doc

* Update dev-docs/bidders/afront.md

ref: correct tcfeu support to false

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update afront.md

refactoring: corrected bid params spelling

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/afront.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/afront.md

diff --git a/dev-docs/bidders/afront.md b/dev-docs/bidders/afront.md
new file mode 100644
index 0000000000..bdadab477b
--- /dev/null
+++ b/dev-docs/bidders/afront.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: Afront
+description: Prebid Afront Bidder Adaptor
+biddercode: afront
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+pbs: true
+sidebarType: 1
+floors_supported: true
+prebid_member: false
+fpd_supported: false
+gvl_id: none
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: true
+userIds: all
+---
+
+### Note
+
+The Afront Bidding adapter requires setup before beginning. Please contact us at [support@afront.io](mailto:support@afront.io).
+Afront will bid on the first impression in request.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name              | Scope    | Description       | Example  | Type     |
+| ----------------- | -------- | ----------------- | -------- | -------- |
+| `accountId` | required | Client account id | `'id'`   | `string` |
+| `sourceId`    | required | Data source id    | `'hash'` | `string` |

From df81ce1b75b16c74b6648b232bf9538ea20dd515 Mon Sep 17 00:00:00 2001
From: pb360playvid <prebid@360playvid.com>
Date: Mon, 6 Oct 2025 16:46:44 +0300
Subject: [PATCH 353/665] New pbs adapter 360playvid (#6131)

* New adapter 360playvid

* Set pbs to 0 in the 360playvid adapter

* Update 360playvid.md

* Set pbs to true in the 360playvid adapter

---------

Co-authored-by: Bohdan Lashko <bohdan.lashko@teqblaze.com>
Co-authored-by: Chris Huie <phoenixtechnerd@gmail.com>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/360playvid.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/360playvid.md b/dev-docs/bidders/360playvid.md
index ccdd470759..3d7b36a545 100644
--- a/dev-docs/bidders/360playvid.md
+++ b/dev-docs/bidders/360playvid.md
@@ -17,7 +17,7 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1

From 0abf92d2354b205af8008d50535a801b89b16558 Mon Sep 17 00:00:00 2001
From: rbstdev <devgit204@gmail.com>
Date: Mon, 6 Oct 2025 16:48:27 +0300
Subject: [PATCH 354/665] New Adapter: RobustApps (#6142)

Co-authored-by: rbstdev <devgit204@xe.works>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/robustApps.md | 40 ++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 dev-docs/bidders/robustApps.md

diff --git a/dev-docs/bidders/robustApps.md b/dev-docs/bidders/robustApps.md
new file mode 100644
index 0000000000..f690f1d481
--- /dev/null
+++ b/dev-docs/bidders/robustApps.md
@@ -0,0 +1,40 @@
+---
+layout: bidder
+title: RobustApps
+description: RobustApps Bidder Adapter
+biddercode: robustApps
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: true
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `aa8217e20131c095fe9dba67981040b0` | `string`  |
+| `env`       | optional | Environment name            | `robustApps`                       | `string`  |
+| `ext`       | optional | Specific integration config | `{}`                               | `object`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `aa8217e20131c095fe9dba67981040b0` | `string`  |
+| `env`       | required | Environment name            | `robustApps`                       | `string`  |

From 4aba11b67c44b85ea57d85bd5c8ad406c9584bc7 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Tue, 7 Oct 2025 06:37:31 +0200
Subject: [PATCH 355/665] Local video cache: Mentioning getVastXml method
 (#6285)

* Local video cache: Mentioning getVastXml method

* lint fix

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 .../adServers.gam.getVastXml.md               | 75 +++++++++++++++++++
 dev-docs/publisher-api-reference/setConfig.md |  2 +
 2 files changed, 77 insertions(+)
 create mode 100644 dev-docs/publisher-api-reference/adServers.gam.getVastXml.md

diff --git a/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md b/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md
new file mode 100644
index 0000000000..9a45bd6d96
--- /dev/null
+++ b/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md
@@ -0,0 +1,75 @@
+---
+layout: api_prebidjs
+title: pbjs.adServers.gam.getVastXml(options)
+description: adServers.gam.getVastXml API
+sidebarType: 1
+---
+
+
+{: .alert.alert-info :}
+The Google Ad Manager implementation of this function requires including the dfpAdServerVideo module in your Prebid.js build.
+
+This method extends the behavior of `buildVideoUrl` by not only constructing the Google Ad Manager video ad tag URL, but also fetching and processing the resulting VAST wrapper returned by GAM.
+
+If the `cache.useLocal` flag is set to true, the function scans the received GAM VAST wrapper for the bid’s cached asset URL that corresponds to a locally stored blob in Prebid.js. When such a match is found, it replaces the contents of the GAM wrapper with the contents of the locally cached VAST XML blob, effectively inlining the ad markup instead of referencing it remotely.
+
+#### Argument Reference
+
+##### The `options` object
+
+{: .table .table-bordered .table-striped }
+| Field    | Type   | Description                                                                                                                                                                        |
+|----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `adUnit` | object | *Required*. The Prebid ad unit to which the returned URL will map.                                                                                                                 |
+| `params` | object | *Optional*. Querystring parameters that will be used to construct the Google Ad Manager video ad tag URL. Publisher-supplied values will override values set by Prebid.js. See below for fields. |
+| `url`    | string | *Optional*. The video ad server URL. When given alongside params, the parsed URL will be overwritten with any matching components of params.                                       |
+| `bid`    | object | *Optional*. The Prebid bid for which targeting will be set. If this is not defined, Prebid will use the bid with the highest CPM for the adUnit.                                   |
+
+{: .alert.alert-warning :}
+One or both of options.params and options.url is required. In other words, you may pass in one, the other, or both, but not neither.
+
+##### The `options.params` object
+
+{: .table .table-bordered .table-striped }
+| Field             | Type   | Description                                                                                                                 | Example                                         |
+|-------------------+--------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------|
+| `iu`              | string | *Required*. Google Ad Manager ad unit ID.                                                                                                 | `/19968336/prebid_cache_video_adunit`           |
+| `cust_params`     | object | *Optional*. Key-value pairs merged with Prebid's targeting values and sent to Google Ad Manager on the video ad tag URL.                  | `{section: "blog", anotherKey: "anotherValue"}` |
+| `description_url` | string | *Optional*. Describes the video. Required for Ad Exchange. Prebid.js will build this for you unless you pass it explicitly. | `https://www.example.com`                        |
+
+For more information on any of these params, see [the Google Ad Manager video tag documentation](https://support.google.com/admanager/answer/1068325).
+
+#### Example
+
+```javascript
+pbjs.requestBids({
+    bidsBackHandler: async function(bidResponses) {
+        const bidResponse = bidResponses['div-gpt-ad-51545-0'];
+        if (!bidResponse) {
+          return;
+        }
+        const bid = bidResponse.bids[0];
+        const vastXml = await pbjs.adServers.gam.getVastXml({
+          bid,
+          adUnit: 'div-gpt-ad-51545-0',
+          params: {
+            iu: '/41758329/localcache',
+            url: "https://pubads.g.doubleclick.net/gampad/ads?iu=/41758329/localcache&sz=640x480&gdfp_req=1&output=vast&env=vp",
+          }                
+        });
+        jwplayer("player").setup({
+          playlist: "https://cdn.jwplayer.com/v2/media/hWF9vG66",
+          autostart: "viewable",
+          advertising: {
+              client: "vast",
+              schedule: [
+                { 
+                  vastxml: vastXml,
+                  offset: 'pre'
+                }
+              ]
+          }
+        });
+    }
+});
+```
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 2a4eb21edb..92dd0fc889 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1190,6 +1190,8 @@ https://my-pbs.example.com/cache?uuid=%%PATTERN:hb_uuid%%
 
 will continue to function correctly. `hb_uuid` is set to locally assigned blob UUID. If the bid wins the GAM auction and it's `videoCacheKey` (`hb_uuid`) is included in a GAM wrapper VAST XML, Prebid will update the VAST ad tag URL with the locally cached blob URL after receiving a response from Google Ad Manager.
 
+When using the local cache feature without the video module, you’ll need to retrieve the VAST XML directly by calling [getVastXml](/dev-docs/publisher-api-reference/adServers.gam.getVastXml.html).
+
 ### Instream tracking
 
 {: .alert.alert-info :}

From d10495f63c32277ecc92f261eabaf381d92651b4 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Tue, 7 Oct 2025 07:38:22 +0300
Subject: [PATCH 356/665] Update infinety.md (#6282)

---
 dev-docs/bidders/infinety.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/infinety.md b/dev-docs/bidders/infinety.md
index 8da6b131c3..ecc2ed29fc 100644
--- a/dev-docs/bidders/infinety.md
+++ b/dev-docs/bidders/infinety.md
@@ -2,6 +2,7 @@
 layout: bidder
 title: Infinety
 description: Infinety Adaptor
+biddercode: infinety
 aliasCode: adkernel
 tcfeu_supported: true
 dsa_supported: false

From 53e8b944de58ece5d9e59b779b91fa63b6778d72 Mon Sep 17 00:00:00 2001
From: SamuelAlejandroNT <samaldonado@nuevatel.com>
Date: Tue, 7 Oct 2025 00:39:31 -0400
Subject: [PATCH 357/665] Alvads (#6284)

* Add Alva (alvads) bidder adapter documentation

* initial doc

* added bidfloor support

* Alvads

---------

Co-authored-by: Samuel Alejandro Maldonado Garcia <samaldonado@nuevatel.net>
Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 ADS - Acceso directo.lnk   | Bin 0 -> 885 bytes
 dev-docs/bidders/alvads.md |  33 +++++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 ADS - Acceso directo.lnk
 create mode 100644 dev-docs/bidders/alvads.md

diff --git a/ADS - Acceso directo.lnk b/ADS - Acceso directo.lnk
new file mode 100644
index 0000000000000000000000000000000000000000..192bf02077e7d432721f25569068a5ae8812c27b
GIT binary patch
literal 885
zcmah{Ur3Wt6hEJtxE^w=Wow$wLQ||Ut%o)mxVCbL;b5$yt=QZqF5SMlZ`FcI>7kGu
z1rfxckg{aaAA_PIEMKf1dRRSJ<{o;r43l1Z3HqJ8RC<W+$M2l;opbIvzkBa#Cn8B(
z1W7a@B<;OGrKE=4SMf~m&(26*tG=pQmzU0T&F#BXo|i-rajB5MBr~L?YS-tEoZ*Wl
zqQ3F5lp0N@YZfvNSl+&Tv~{L^_gF*!Z07tcTOIb+(fkVy_GT}dC!bGEOU}*PW^bbU
zq^6{81X@dN)Ff)_y}M#+vN_zelT=iUeS?QosY>s=P9x&B0cLL&nakqrcA0GCAU9lV
zfc-!vz?@m{0C;%-9k2pON6dLX_kl<(B%e^oZt;1Pa6<7ZfoPyNB*y|F+2;r=JxMw4
zV>+~wjQD&)`U_Qt4?^>bHOG=krE_sF-3dRfY0kRr=T80TKT>i!(>RuTv!(32=Kkfm
z;D-n6)BlUV26YwD@JZBea=YB$Oyi&IG}t=&Gq-j`>DqJ{{t!2=25Nylq)?C&6rm)^
zLd#^Jda{!Rls$+Zqre}(0*`{fDA0>CGR0uAZs3w)U4`VvriI!k^R0UIt%V~0(Dko(
zH^9G&Gq`avuz2t5V3z^Z!Xlce;9=s2;v|u+g|-V4aSDTG00cv@48j+rZje6?5(@IT
z+G;>lTN*|D_W{i7_R(Oy^~!tA<0+cxnAYX^X{!LysRnxa;9(s5-$(XgZo-K7h>MHk
uY8Fq#)e5u54Ih?A9rx04=cu#AIATo=ZA7e_6P!TFFY`FtL?)iCzt(R7=D}D1

literal 0
HcmV?d00001

diff --git a/dev-docs/bidders/alvads.md b/dev-docs/bidders/alvads.md
new file mode 100644
index 0000000000..8c6590608a
--- /dev/null
+++ b/dev-docs/bidders/alvads.md
@@ -0,0 +1,33 @@
+---
+layout: bidder
+title: Alvads
+description: Prebid Alva Bidder Adapter
+biddercode: alvads
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: true
+coppa_supported: true
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+media_types: banner, video
+safeframes_ok: false
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
+privacy_sandbox: no 
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description   | Example                                                                  | Type      |
+|---------------|----------|---------------|--------------------------------------------------------------------------|-----------|
+| `publisherUniqueId` | required | Publisher Unique ID  | `D7DACCE3-C23D-4AB9-8FE6-9FF41BF32F8F`                               | `string`  |

From 2f2058c813636d05416095f97a005c7db2f7de6b Mon Sep 17 00:00:00 2001
From: kazutoshi-uekawa-muneee
 <114455471+kazutoshi-uekawa-muneee@users.noreply.github.com>
Date: Tue, 7 Oct 2025 22:53:16 +0900
Subject: [PATCH 358/665] UNIQUEST Widget Bid Adapter: initial release  (#6266)

* add uniquestWidget.md

* chore: trigger Netlify redeploy
---
 dev-docs/bidders/uniquestWidget.md | 36 ++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/uniquestWidget.md

diff --git a/dev-docs/bidders/uniquestWidget.md b/dev-docs/bidders/uniquestWidget.md
new file mode 100644
index 0000000000..bdfd798484
--- /dev/null
+++ b/dev-docs/bidders/uniquestWidget.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: UNIQUEST Widget
+description: Prebid UNIQUEST Widget Bidder Adapter
+biddercode : uniquest_widget
+pbjs: true
+media_types: banner
+sidebarType: 1
+safeframes_ok: false
+pbs: false
+deals_supported: false
+tcfeu_supported: false
+usp_supported: false
+prebid_member: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+floors_supported: false
+ortb_blocking_supported: false
+gpp_sids: none
+gvl_id: none
+dsa_supported: false
+fpd_supported: false
+multiformat_supported: none
+privacy_sandbox: none
+---
+
+### Registration
+To use this bidder you will need with UNIQUEST Widget. For further information, Please contact us at <prebid_info@muneee.co.jp>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope    | Description | Example  | Type     |
+|-------|----------|---------------------------|----------|----------|
+| `wid` | required | The Ad ID from UNIQUEST Widget | `'WID00001'` | `string` |

From 5125ae4fa10913afeb08a5218b86985e764f5266 Mon Sep 17 00:00:00 2001
From: GodefroiRoussel <GodefroiRoussel@users.noreply.github.com>
Date: Mon, 13 Oct 2025 13:41:28 +0200
Subject: [PATCH 359/665] Adagio: Update Prebid Server Doc (#6247)

* Increase placement max length

Co-authored-by: Godefroi Roussel <groussel@adagio.io>
---
 dev-docs/bidders/adagio.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index a9b607ceb3..83146ef51a 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -75,7 +75,7 @@ pbjs.bidderSettings = {
 | ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- |
 | `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
 | `site`            | required           | Name of the site. Handed out by Adagio.<br><i>- max length: 50</i>                                                                                                                                                                                   | `'mysite-com'`                                               | `string` |
-| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 30</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
+| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 50</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
 | `adUnitElementId` | required           | Refers to the adunit html attribute id in a page.                                                                                                                                                                                                    | `'gpt-ban-atf'`                                              | `string` |
 | `pagetype`*       | highly recommended | Describes what kind of content will be present in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                       | `'article'`                                                  | `string` |
 | `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
@@ -113,7 +113,7 @@ Adagio supports different regions for the Prebid Server. Please deploy the prebi
 | Name              | Scope              | Description | Example | Type |
 |-------------------|--------------------|-------------|---------|------|
 | `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
-| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 30</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
+| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 50</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
 | `pagetype`*       | highly recommended | Describes what kind of content will be present in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                       | `'article'`                                                  | `string` |
 | `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
 

From e2d6f12dfeacda1f25a7412c94564d3489864309 Mon Sep 17 00:00:00 2001
From: Sebastien Boisvert <sebastien.boisvert@contxtful.com>
Date: Tue, 14 Oct 2025 16:23:11 -0400
Subject: [PATCH 360/665] Add bid parameters for Contxtful bid adapter and
 document Prebid Server support (#6181)

* Update contxtful.md to enable PBS support

* Add bid parameters section to Contxtful documentation

* Remove unnecessary blank line in Contxtful documentation

* Update Contxtful documentation to clarify required parameters

* chore: make customerId required

* docs: add config section

* docs: add section First Party Data

* docs: add AdUnit Format client side

* docs: add missing line break in First Party Data section of Contxtful documentation

* docs: update User Sync section in Contxtful documentation to clarify bidder filter settings

* docs: document "all"

* docs: remove redundant blank line in Contxtful documentation
---
 dev-docs/bidders/contxtful.md | 80 +++++++++++++++++++++++++++++++++--
 1 file changed, 77 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md
index a20bd83d9c..930b1f1d75 100644
--- a/dev-docs/bidders/contxtful.md
+++ b/dev-docs/bidders/contxtful.md
@@ -13,7 +13,7 @@ safeframes_ok: true
 floors_supported: true
 fpd_supported: true 
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: false
 prebid_member: true
 multiformar_supported: will-bid-on-any
@@ -24,8 +24,80 @@ ortb_blocking_supported: true
 
 The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtful.com](mailto:contact@contxtful.com)
 
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                                                | Example                      | Type                 |
+|-------------|----------|------------------------------------------------------------|------------------------------|----------------------|
+| `placementId`      | required | The placement identifier                                          | `'p12345678'` | `string`             |
+| `customerId`      | required | The customer identifier              | `'DEMO123456'`       | `string`           |
+
+### Configuration
+
+```javascript
+pbjs.setConfig({
+   "contxtful":{
+      "version":"v1",
+      "customer":"<<CUSTOMER_ID_HERE>>"
+   },
+   "realTimeData":{
+      "dataProviders":[
+         {
+            "name":"contxtful",
+            "waitForIt":true,
+            "params":{
+               "version":"v1",
+               "customer":"<<CUSTOMER_ID_HERE>>",
+               "bidders":[
+                  "contxtful"
+               ],
+               "adServerTargeting":true
+            }
+         }
+      ]
+   }
+}
+);
+```
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+
+- `ortb2.site.*`
+- `ortb2.user.*`
+- `ortb2.device.*`
+
+AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
+
+### AdUnit Format client side
+
+```javascript
+ var adUnitList = [
+  {
+    code: 'AD_UNIT_NAME_HERE',
+    mediaTypes: { /* "<< ENTER_FORMAT_HERE >> */ },
+    bids: [{
+      bidder: 'contxtful',
+      params: {
+        placementId: "<<PLACEMENT_ID_HERE>>",
+        customerId: "<<CUSTOMER_ID_HERE>>"
+      }
+    }],
+    ortb2Imp: {
+      ext: {
+        data: {
+          divId: "<<EACH_AD_UNIT_DIV_ID>>"
+        }
+      }
+    }
+  }
+]
+```
+
 ### User Sync
-Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization.
+
+Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig#setConfig-Configure-User-Syncing) to optimize match rate and monetization.
 
 {% include dev-docs/storageAllowed.md %}
 
@@ -35,7 +107,7 @@ pbjs.setConfig({
   userSync: {
     filterSettings: {
       iframe: {
-        bidders: ['contxtful'],
+        bidders: '*',   // '*' means all bidders
         filter: 'include'
       }
     }
@@ -49,3 +121,5 @@ pbjs.bidderSettings = {
   }
 }
 ```
+
+Note - the `userSync.filterSettings.all` field is mutually exclusive and cannot be combined with the `userSync.filterSettings.iframe`/`userSync.filterSettings.image` fields in the `userSync` config. If the fields are used together, this will be considered an invalid config and only image pixels will be permitted.

From 1d8dde6cfa321da8b2e5fd5ba8900f4ddaa39719 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Wed, 15 Oct 2025 11:45:38 +0200
Subject: [PATCH 361/665] Add audio mediaType (#6183)

* Add audio mediaType

* Update dev-docs/adunit-reference.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/adunit-reference.md

* Update dev-docs/adunit-reference.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* missing link

---------

Co-authored-by: Marcin Komorski <marcinkomorski@Marcins-MacBook-Pro.local>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 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..2ccd788cc5 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`, `video` or `audio` objects are required. | Object | Defines properties of a audio ad. For examples, see [`adUnit.mediaTypes.audio`](#adUnit.mediaTypes.audio). |
 
 <a name="adUnit.mediaTypes.banner"></a>
 
@@ -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. |
 
+<a name="adUnit.mediaTypes.audio"></a>
+
+#### 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`. 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]. |
+| `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 8aafc724bf..5256fe5c95 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 f7e6f4e447e58f16455d1082f6cbc3caf6d6b397 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 20 Oct 2025 18:21:24 +0300
Subject: [PATCH 362/665] Attekmi: add Anzu (#6273)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/anzu.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/anzu.md

diff --git a/dev-docs/bidders/anzu.md b/dev-docs/bidders/anzu.md
new file mode 100644
index 0000000000..874ffa8d0b
--- /dev/null
+++ b/dev-docs/bidders/anzu.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Anzu
+description: Anzu Bidder Adapter
+biddercode: anzu
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 11395e28b9ebdc2f6a186995a8705a589ca6a832 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Mon, 20 Oct 2025 10:28:45 -0500
Subject: [PATCH 363/665] Adding onIntervention, browserIntervention (#6275)

* Adding onIntervention, browserIntervention

* lint

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/bidder-adaptor.md                    | 15 +++++++++++++++
 dev-docs/publisher-api-reference/getEvents.md |  1 +
 2 files changed, 16 insertions(+)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 5256fe5c95..94a35f59bb 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -737,6 +737,21 @@ Sample data received by this function:
 }
 ```
 
+### Registering on Intervention
+
+The onIntervention function will be called when the browser reports an intervention affecting a rendered creative (e.g., Chrome Heavy Ad Intervention or similar reporting APIs).
+
+#### Signature
+
+```javascript
+function onIntervention({ bid, intervention }) { ... }
+```
+
+#### Parameters
+
+1. `bid` — the winning bid object for which the intervention was detected (same shape as in other render callbacks like `onAdRenderSucceeded`).
+2. `intervention` — a browser-provided object describing the intervention. In Chromium-based browsers this typically originates from the [ReportingObserver] API with type: 'intervention' and includes a body describing the intervention details.
+
 ### Adding adapter aliases
 
 Use aliases if you want to reuse your adapter using other name for your partner/client, or just a shortcut name.
diff --git a/dev-docs/publisher-api-reference/getEvents.md b/dev-docs/publisher-api-reference/getEvents.md
index f3751a21f2..1dd6744d91 100644
--- a/dev-docs/publisher-api-reference/getEvents.md
+++ b/dev-docs/publisher-api-reference/getEvents.md
@@ -47,6 +47,7 @@ The available events are:
 | bidderError    | A bidder responded with an error | Object with the XMLHttpRequest error and the bid request object `{ error, bidderRequest }` |
 | tcf2Enforcement | There was a TCF2 enforcement action taken | `{ storageBlocked: ['moduleA', 'moduleB'], biddersBlocked: ['moduleB'], analyticsBlocked: ['moduleC'] }` |
 | bidAccepted | A bid was accepted and is about to be added to auction | Bid response object |
+| browserIntervention | The browser reported an intervention affecting a rendered creative (e.g., heavy-ad unload). | `{ bid, adId, intervention }` |
 
 The example below shows how these events can be used.
 

From 99a01914be643497d80c902148c38199a2c5d356 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=96mer=20=C3=96zg=C3=BCn=20I=C5=9F=C4=B1kman?=
 <omer@nokta.com>
Date: Mon, 20 Oct 2025 18:43:33 +0300
Subject: [PATCH 364/665] New Adapter: Empower (#6271)

* New Adapter: Empower

* Explicitly filled all fields

* fillled one forgotten field

* fixes for feedbacks

* fx

* endpoint compression added  and privacy corrected

* privacy_sandbox changed to false
---
 dev-docs/bidders/empower.md | 93 +++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 dev-docs/bidders/empower.md

diff --git a/dev-docs/bidders/empower.md b/dev-docs/bidders/empower.md
new file mode 100644
index 0000000000..f47d334712
--- /dev/null
+++ b/dev-docs/bidders/empower.md
@@ -0,0 +1,93 @@
+---
+layout: bidder
+title: Empower
+description: Prebid Empower Bidder Adapter
+pbjs: true
+biddercode: empower
+gvl_id: 1248
+tcfeu_supported: true
+dsa_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+dchain_supported: false
+userIds: all
+tcf2_supported: true
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: true
+media_types: banner, video
+privacy_sandbox: no
+endpoint_compression: false
+
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `zone`        | required | provided zone ID from Empower                    | `12456`                              | `int`  |
+| `site`  | optional | provided Site Code from Empower    | `"empower_net"`                              | `string`  |
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'empower',
+         params: {
+            tagId: 123456
+         }
+       }]
+   },
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'empower',
+            params: {
+               tagId: 123456
+            }
+        }]
+    },
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            }
+        },
+        bids: [{
+            bidder: 'empower',
+            params: {
+               tagId: 123456
+            }
+        }]
+    };
+]
+```

From 9ab274211e3a8bc32bb659d4e358a4f481f60d5a Mon Sep 17 00:00:00 2001
From: Invis <invisbox@gmail.com>
Date: Mon, 20 Oct 2025 18:06:21 +0200
Subject: [PATCH 365/665] Update SmartyTech adapter documentation with userId,
 consents, and chunks (#6259)

* Update SmartyTech adapter documentation with userId, consents, and chunks support

- Add support for all Prebid.js User ID modules (userIds: all)
- Add comprehensive privacy framework support:
  * GDPR (TCF EU) consent strings
  * CCPA/USP compliance
  * GPP (Global Privacy Platform)
  * COPPA compliance
- Add chunks configuration documentation with examples
- Update front matter with new supported features flags
- Fix markdownlint issues and improve code block formatting

This documentation update supports the upcoming SmartyTech adapter enhancements
that will include userId transmission, consent handling, and request chunking.

* Remove tcfeu and gpp
---
 dev-docs/bidders/smartytech.md | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/smartytech.md b/dev-docs/bidders/smartytech.md
index 012851cbe4..8c66f616be 100644
--- a/dev-docs/bidders/smartytech.md
+++ b/dev-docs/bidders/smartytech.md
@@ -6,19 +6,23 @@ pbjs: true
 biddercode: smartytech
 media_types: banner, video
 multiformat_supported: will-bid-on-one
+usp_supported: true
+coppa_supported: true
+userIds: all
 sidebarType: 1
 ---
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name         | Scope    | Description  | Example | Type      |
 |--------------|----------|--------------|---------|-----------|
 | `endpointId` | required | Endpoint ID. | `14`    | `integer` |
 
 ### Sample Banner Ad Unit Example
 
-```
+```javascript
 var adUnits = [{
     code: '/123123123/prebidjs-banner',
     mediaTypes: {
@@ -40,7 +44,7 @@ var adUnits = [{
 
 ### Sample Video Ad Unit Example
 
-```
+```javascript
 var videoAdUnit = {
     code: '/123123123/video-vast-banner',
     mediaTypes: {
@@ -58,3 +62,21 @@ var videoAdUnit = {
     }]
 };
 ```
+
+### User ID Support
+
+SmartyTech adapter supports all Prebid.js User ID modules. User IDs are automatically included in bid requests when available.
+
+### Additional Configuration
+
+It is possible to configure requests to be split into chunks so as to have fewer bid requests in a single http request (default value is 10).
+
+```javascript
+pbjs.setBidderConfig({
+    config: {              
+        smartytech: {
+            chunkSize: 5   // makes 1 http request per 5 ad units configured
+        }
+    }
+});
+```

From 767918fad82f798f92cdad7773fa440039013497 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Mon, 20 Oct 2025 19:39:00 +0300
Subject: [PATCH 366/665] Create xapads.md (#6257)

---
 dev-docs/bidders/xapads.md | 40 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 dev-docs/bidders/xapads.md

diff --git a/dev-docs/bidders/xapads.md b/dev-docs/bidders/xapads.md
new file mode 100644
index 0000000000..aeae9c9719
--- /dev/null
+++ b/dev-docs/bidders/xapads.md
@@ -0,0 +1,40 @@
+---
+layout: bidder
+title: Xapads
+description: Prebid Xapads Bidder Adaptor
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 1320
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: false
+pbs: true
+pbs_app_supported: true
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The Xapads Bidding adaptor requires setup and approval before beginning. Please reach out to <support@xapads.com> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From 6a64a49f1ee09ec3eba01e74d45c643ebe793d18 Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Mon, 20 Oct 2025 20:47:45 +0300
Subject: [PATCH 367/665] align: docs with code changes (#6228)

* align: docs with code changes

* adding ending line

* fix names
---
 dev-docs/bidders/programmaticX.md | 65 ++++++++++++++++++++++++-------
 1 file changed, 51 insertions(+), 14 deletions(-)

diff --git a/dev-docs/bidders/programmaticX.md b/dev-docs/bidders/programmaticX.md
index ce4c993f72..8b702d1519 100644
--- a/dev-docs/bidders/programmaticX.md
+++ b/dev-docs/bidders/programmaticX.md
@@ -3,34 +3,71 @@ layout: bidder
 title: ProgrammaticX
 description: Prebid ProgrammaticX Bidder Adapter
 biddercode: ProgrammaticX
-gpp_sids: usstate_all
-gvl_id: 1344
+filename: programmaticXBidAdapter
+userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 tcfeu_supported: true
 usp_supported: true
-coppa_supported: true
+coppa_supported: false
 schain_supported: true
-deals_supported: false
+gpp_supported: true
 floors_supported: true
+media_types: banner, video
+prebid_member: false
+safeframes_ok: false
+deals_supported: false
+pbs_app_supported: false
 fpd_supported: false
 ortb_blocking_supported: false
-media_types: banner, video, native
 multiformat_supported: will-bid-on-one
-userIds: all
 pbjs: true
 pbs: false
-pbs_app_supported: true
-safeframes_ok: true
 sidebarType: 1
+gvl_id: 1344
 ---
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description  | Example                         | Type       |
-|---------------|----------|--------------|---------------------------------|------------|
-| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
-| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
 
-### Note
+| Name       | Scope    | Description                                                                               | Example                      | Type     |
+|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from ProgrammaticX.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`      | required | The publisher ID from ProgrammaticX.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. ProgrammaticX will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+### Example
+
+  ```javascript
+var adUnits = [{
+        code: 'banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [
+                    [300, 250],
+                    [728, 90]
+                ]
+            }
+        },
+        bids: [{
+            bidder: 'programmaticX',
+            params: {
+                cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
+                pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
+                bidFloor: 1.23                   // Optional
+            }
+        }]
+    }
+];
 
-For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId
+// configure pbjs to enable user syncing
+pbjs.setConfig({
+    userSync: {
+      filterSettings: {
+        iframe: {
+          bidders: 'programmaticX',
+          filter: 'include'
+        }
+      }
+    }
+});
+```

From 4fcbcbb3c0c5ef947fd6d41e71d7e946463a6542 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 20 Oct 2025 14:02:31 -0400
Subject: [PATCH 368/665] Recommend hb_ver over @latest for PUC (#6288)

---
 _includes/mobile/gam-native-adops.html        |  2 +-
 adops/adops-general-sbs.md                    |  5 +++-
 adops/creative-considerations.md              |  6 ++---
 adops/gam-creative-banner-sbs.md              | 18 ++++++++++---
 adops/gam-native.md                           |  2 +-
 ...g-up-prebid-with-the-appnexus-ad-server.md |  2 +-
 dev-docs/publisher-api-reference/setConfig.md | 26 +++++++++++++++++++
 overview/prebid-universal-creative.md         |  4 ++-
 prebid/native-implementation-legacy.md        |  6 ++---
 prebid/native-implementation.md               |  6 ++---
 10 files changed, 59 insertions(+), 18 deletions(-)

diff --git a/_includes/mobile/gam-native-adops.html b/_includes/mobile/gam-native-adops.html
index 07bba2763c..896a280030 100644
--- a/_includes/mobile/gam-native-adops.html
+++ b/_includes/mobile/gam-native-adops.html
@@ -20,7 +20,7 @@ <h1><a target="_blank" href="hb_native_linkurl" class="pb-click">hb_native_title
 		      <div class="attribution">hb_native_brand</div>
 		    </div>
 		  </div>
-		  <script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native-trk.js"></script>
+		  <script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/native-trk.js"></script>
 		  <script>
 		    var pbNativeTagData = {};
 		    pbNativeTagData.uuid = "%%PATTERN:hb_cache_id%%";
diff --git a/adops/adops-general-sbs.md b/adops/adops-general-sbs.md
index ae8a64eff6..369b71de20 100644
--- a/adops/adops-general-sbs.md
+++ b/adops/adops-general-sbs.md
@@ -116,6 +116,8 @@ If your ad server supports targeting creatives within the line item, it could co
 
 You’ve now added all fields required for targeting Prebid line items. You can add any other line item options you would normally use, such as additional targeting for geography. When you’ve filled in all the appropriate fields, save your line item.
 
+<a id="create-creatives" ></a>
+
 ## Create Your Creatives
 
 The process of creating your creatives will differ based on the type of creative.
@@ -131,7 +133,7 @@ We recommend using the [Prebid Universal Creative](/overview/prebid-universal-cr
 If you’re working with banner or in-renderer creatives, the HTML you’ll enter in the creatives will be similar to the following (utilizing whatever macro format is supported by your ad server):
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";
@@ -157,6 +159,7 @@ If you’re working with banner or in-renderer creatives, the HTML you’ll ente
 * Replace `%%MACRO%%` with the appropriate macro for your ad server. (Refer to your ad server’s documentation or consult with a representative for specific details regarding the proper macros and how to use them.)
 * Replace BIDDERCODE with the appropriate code for the bidder your line item is targeting. For example, if you’re targeting BidderA, the macro variable for adId might look like `ucTagData.adId = "%%PATTERN:hb_adid_BidderA%%";`.
 * If you're hosting your own Prebid Universal Creative, make sure it's version 1.15 or later, or replace `%%PATTERN:hb_format%%.js` with `creative.js`.
+* The `hb_ver` targeting key, used above to construct the Prebid Universal Creative CDN URL, requires Prebid.js 10.11.0 or later. If that's not available, substitute `%%PATTERN:hb_ver%%` with a particular PUC version.   
 
 The example above uses the jsdelvr CDN as the domain from which the creative will serve. However, you may obtain the creative from a managed service or host it yourself. You might need to edit the creative and make adjustments to your creative settings depending on the CDN you're using.
 
diff --git a/adops/creative-considerations.md b/adops/creative-considerations.md
index 510dad5bcc..de5d2ecfea 100644
--- a/adops/creative-considerations.md
+++ b/adops/creative-considerations.md
@@ -66,8 +66,8 @@ the actual PUC.
 
 If you choose to use the Prebid Universal Creative, you'll need to decide where to load it from:
 
-1. Prebid hosts an always-up-to-date copy of the PUC code at `https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/*`. The upside of this location is that it's automatically updated so it contains new features automatically. The potential downside is that Prebid controls when it's upgrades.
-1. You can host the PUC at your own location. The upside of this option is that you can control when upgrades happen.
+1. Prebid hosts each PUC version at `https://cdn.jsdelivr.net/npm/prebid-universal-creative@${VERSION}/dist/*` - substitute `${VERSION}` with a version number. Using Prebid.js 10.11.0 or later, you may also use the `hb_ver` targeting key; see [create your creatives](/adops/adops-general-sbs.html#create-your-creatives).
+1. You can host the PUC at your own location. The upside of this option is more control over when upgrades happen.
 1. You can copy the body of the PUC into your ad server creative directly. This eliminates a browser fetch, but could make upgrades more difficult.
 
 ### Prebid.js 'dynamic creatives'
@@ -115,7 +115,7 @@ VAST URL required. See the [GAM Prebid Mobile Rendering Ad Ops](/adops/mobile-re
 {: .table .table-bordered }
 | :memo: Use Cases          |
 |:---------------------------|
-| - Prbeid.js Native |
+| - Prebid.js Native |
 
 Native ads require close collaboration between web designers, engineering, and ad ops. The primary decision to be made that affects ad ops is where to store the rendering template. The options are:
 
diff --git a/adops/gam-creative-banner-sbs.md b/adops/gam-creative-banner-sbs.md
index ab8e732a7a..abbd716c17 100644
--- a/adops/gam-creative-banner-sbs.md
+++ b/adops/gam-creative-banner-sbs.md
@@ -56,13 +56,18 @@ These instructions assume you're using the Prebid Universal Creative (PUC) after
 {: .alert.alert-warning :}
 Be sure to replace BIDDERCODE with the appropriate bidder. For example, if the bidder code is `PBbidder`, the `adid` would be `%%PATTERN:hb_adid_PBbidder%%`.
 
-Also, replace "PUCFILE" with:
+Replace "PUCFILE" with:
 
 - Prebid.js: "%%PATTERN:hb_format%%.js"
 - Prebid Mobile: "creative.js"
 
+Replace "VERSION" with:
+
+- Prebid.js 10.11.0 or later: "%%PATTERN:hb_ver%%"
+- Otherwise, a specific PUC version.
+
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/PUCFILE"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@VERSION/dist/PUCFILE"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";
@@ -99,13 +104,18 @@ Warning: Be sure none of the attribute names are longer than 20 characters. See
 
 In top-price mode, you can make use of the GAM `TARGETINGMAP` feature instead of listing out each attribute.
 
-Be sure to replace "PUCFILE" with:
+Replace "PUCFILE" with:
 
 - Prebid.js: "%%PATTERN:hb_format%%.js"
 - Prebid Mobile: "creative.js"
 
+Replace "VERSION" with:
+
+- Prebid.js 10.11.0 or later: "%%PATTERN:hb_ver%%"
+- Otherwise, a specific PUC version.
+
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/PUCFILE"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@VERSION/dist/PUCFILE"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = "";
diff --git a/adops/gam-native.md b/adops/gam-native.md
index e9e8b17610..e331b85f91 100644
--- a/adops/gam-native.md
+++ b/adops/gam-native.md
@@ -104,7 +104,7 @@ Example creative HTML:
     <div class="attribution">##hb_native_brand##</div>
   </div>
 </div>
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";
diff --git a/adops/setting-up-prebid-with-the-appnexus-ad-server.md b/adops/setting-up-prebid-with-the-appnexus-ad-server.md
index 43aa5ca4c1..cfff8b85d0 100644
--- a/adops/setting-up-prebid-with-the-appnexus-ad-server.md
+++ b/adops/setting-up-prebid-with-the-appnexus-ad-server.md
@@ -80,7 +80,7 @@ Follow the banner creative setup instructions in [Add Creatives](https://docs.xa
 * Self-Audit the creative and confirm compliance.
 
 ```html
-<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/#{HB_FORMAT}.js"></script>
+<script src = "https://cdn.jsdelivr.net/npm/prebid-universal-creative@#{HB_VER}/dist/#{HB_FORMAT}.js"></script>
 <script>
   var ucTagData = {};
   ucTagData.adServerDomain = window.location.host;
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 92dd0fc889..8241f46906 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -713,6 +713,7 @@ The `targetingControls` object passed to `pbjs.setConfig` provides some options
 | allBidsCustomTargeting | Boolean | Set to true to prevent custom targeting values from being set for non-winning bids |
 | lock               | Array of Strings | Targeting keys to lock |
 | lockTimeout        | Integer          | Lock timeout in milliseconds                                   |
+| version            | String           | Value to set in the `hb_ver` targeting key |
 
 {: .alert.alert-info :}
 Note that this feature overlaps and can be used in conjunction with [sendBidsControl.bidLimit](#setConfig-Send-Bids-Control).
@@ -937,6 +938,31 @@ If using standard targeting `hb_adid` is unique for each bid, so this would have
 
 <a name="setConfig-Configure-Responsive-Ads"></a>
 
+#### Details on the version setting
+{: .no_toc }
+
+Since version 10.11.0, Prebid populates the `hb_ver` targeting key with a recommended version of Prebid Universal Creative. This should be used in ad server creatives to fetch that particular version of PUC (see for example [general prebid ad server setup](/adops/adops-general-sbs.html#create-creatives)).
+
+You may set a different value for `hb_ver` using `version`:
+
+```javascript
+pbjs.setConfig({
+   targetingControls: {
+     version: '1.17.2'
+   }
+})
+```
+
+Or disable it by setting `false`: {
+
+```javascript
+pbjs.setConfig({
+  targetingControls: {
+    version: false
+  }
+})
+```
+
 ### Configure Responsive Ads
 
 See the [size mapping](/dev-docs/modules/sizeMapping.html) or [advanced size mapping](/dev-docs/modules/sizeMappingV2.html) modules.
diff --git a/overview/prebid-universal-creative.md b/overview/prebid-universal-creative.md
index e691b8fcc4..9a1c5c8e7f 100644
--- a/overview/prebid-universal-creative.md
+++ b/overview/prebid-universal-creative.md
@@ -36,8 +36,10 @@ Note that as of PUC v1.15, the recommended way of loading the creative
 in the ad server involves using the `hb_format` ad server key-value. Before 1.15, the ad server needed to load creative.js which covered banner and in-renderer video, or native-render.js for native. 1.15 simplifies this
 by allowing the ad server creative to load banner.js, video.js, or native.js, which can be done programmatically using ad server macros. e.g.
 
+Since version 10.11.0, Prebid.js populates the `hb_ver` ad server key-value which is recommended for selecting a specific PUC version.
+
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 ```
 
 This loads the PUC from the Prebid-maintained location. Your managed
diff --git a/prebid/native-implementation-legacy.md b/prebid/native-implementation-legacy.md
index 6ae5c5808c..77d5ff08ad 100644
--- a/prebid/native-implementation-legacy.md
+++ b/prebid/native-implementation-legacy.md
@@ -221,7 +221,7 @@ Example creative HTML:
     <div class="attribution">##hb_native_brand##</div>
   </div>
 </div>
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native-render.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/native-render.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";     // GAM specific
@@ -335,7 +335,7 @@ Even though the body of the native creative is defined in the AdUnit, an AdServe
 Example Creative HTML
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native-render.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/native-render.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";     // GAM specific
@@ -399,7 +399,7 @@ Even though the body of the native creative is defined in the external JavaScrip
 Example creative HTML:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/native-render.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/native-render.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";    // GAM specific
diff --git a/prebid/native-implementation.md b/prebid/native-implementation.md
index 7a036a873b..6e43a8891e 100644
--- a/prebid/native-implementation.md
+++ b/prebid/native-implementation.md
@@ -292,7 +292,7 @@ Example creative HTML:
     <div class="attribution">##hb_native_asset_id_3##</div>
   </div>
 </div>
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist/%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist/%%PATTERN:hb_format%%.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";     // GAM specific
@@ -436,7 +436,7 @@ Even though the body of the native creative is defined in the AdUnit, an AdServe
 Example Creative HTML
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist//%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist//%%PATTERN:hb_format%%.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";     // GAM specific
@@ -526,7 +526,7 @@ Even though the body of the native creative is defined in the external JavaScrip
 Example creative HTML:
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@latest/dist//%%PATTERN:hb_format%%.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist//%%PATTERN:hb_format%%.js"></script>
 <script>
     var pbNativeTagData = {};
     pbNativeTagData.pubUrl = "%%PATTERN:url%%";    // GAM specific

From e3ab8ccad5910734709259551d016df37ce41499 Mon Sep 17 00:00:00 2001
From: jsnellbaker <31102355+jsnellbaker@users.noreply.github.com>
Date: Mon, 20 Oct 2025 14:40:47 -0400
Subject: [PATCH 369/665] new bidder page for the Microsoft bid adapter (#6289)

* new bidder page for the Microsoft bid adapter

* trying to fix md errors

* new section and link fixes

* updates based on feedback
---
 dev-docs/bidders/msft.md | 157 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 157 insertions(+)
 create mode 100644 dev-docs/bidders/msft.md

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
new file mode 100644
index 0000000000..7874007f8c
--- /dev/null
+++ b/dev-docs/bidders/msft.md
@@ -0,0 +1,157 @@
+---
+layout: bidder
+title: Microsoft
+description: Prebid Microsoft Bidder Adaptor
+biddercode: msft
+media_types: banner, video, native
+tcfeu_supported: true
+dsa_supported: true
+prebid_member: true
+userIds: all (with commercial activation)
+schain_supported: true
+coppa_supported: true
+usp_supported: true
+gpp_supported: true
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbjs_version_notes: initial release for testing purposes; not intended to immediately replace the appnexus adapter until performance is validated
+pbs: true
+gvl_id: 32
+sidebarType: 1
+---
+
+### Table of Contents
+
+- [Table of Contents](#table-of-contents)
+  - [Bid Params](#bid-params)
+  - [Migrating from the AppNexus Bid Adapter & Bid Params](#migration-from-appnexus-bid-params)
+  - [Migrating from the AppNexus Bid Adapter & Ad Server Targeting](#migration-from-appnexus-adserver-targeting)
+  - [Migrating from the AppNexus Bid Adapter & Native](#migration-from-appnexus-native)
+  - [Migrating from the AppNexus Bid Adapter & Auction Level Keywords](#migration-from-appnexus-auction-level-keywords)
+  - [First Party Data](#first-party-data)
+  - [Debug Auction](#debug-auction)
+
+<a name="bid-params"></a>
+
+{: .alert.alert-danger :}
+All Microsoft (formerly AppNexus/Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher.  If placements from two different publishers are included in the call, the Microsoft bidder will not return any demand for those placements. <br />
+*Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the Microsoft adapter.*
+
+#### Bid Params
+
+**NOTE** Either `placement_id` OR both `member` and `inv_code` are required.  Please don't specify all three together, it may impact delivery.
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+|------|-------|-------------|---------|------|
+| `placement_id` | required (see note above) | The placement ID from Microsoft Monetize.  You may identify a placement using the `inv_code` and `member` instead of a placement ID. | `11223344` | `integer` |
+| `member` | required (see note above) | The member ID from Microsoft Monetize.  Must be used with `inv_code`. | `1234` | `integer` |
+| `inv_code` | required (see note above) | The inventory code from Microsoft Monetize.  Must be used with `member`. | `'abc123'` | `string` |
+| `allow_smaller_sizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` |
+| `use_pmt_rule` | optional | If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` |
+| `keywords` | optional | A comma-delimited string of key-value pairs (or terms) applied to this sepcific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.  | `pet=dog,food,brand=oldroy` | `string` |
+| `traffic_source_code` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` |
+| `pubclick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly. | `'http://click.adserver.com/'` | `string` |
+| `ext_inv_code` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` |
+| `ext_imp_id` | optional | Specifies the unique identifier of an externally generated auction. | `'bacbab02626452b097f6030b3c89ac05'` | `string` |
+| `banner_frameworks` | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `[1,2]` | `array of integers` |
+
+<a name="migration-from-appnexus-bid-params"></a>
+
+#### Migrating from the AppNexus Bid Adapter & Bid Params
+
+If you are migrating from the AppNexus bid adapter, a number of the previously available AppNexus bid parameters have been deprecated as available options for the Microsoft bid parameters. These deprecated bid parameters are still available however, they're just read from other standarized locations offered within Prebid.js. This change was implemented to help us align better to the publisher-aligned features (such as First Party Data) to use a single setup for many bidders.
+
+The following table shows how the bid parameters have changed between the two adapters:
+
+{: .table .table-bordered .table-striped }
+
+| AppNexus Parameter | Microsoft Parameter | Description |
+|-------------------|-------------------|-------------|
+| `params.placementId` | `params.placement_id` | Placement ID (**only** the underscore case is now supported in the name, value **only** accepts integers) |
+| `params.member` | `params.member` | Member ID (value **only** accepts integers) |
+| `params.inv_code` | `params.inv_code` | Inventory code (unchanged) |
+| `params.publisher_id` | Use `ortb2.publisher.id` | Publisher ID (moved to ortb2 config) |
+| `params.frameworks` | `params.banner_frameworks` | Banner API frameworks array (small name change to clarify banner only) |
+| `params.user` | Use `ortb2.user` | User data (moved to ortb2 config) |
+| `params.allow_smaller_sizes` | `params.allow_smaller_sizes` | Allow smaller ad sizes (unchanged) |
+| `params.use_pmt_rule` | `params.use_pmt_rule` | Use payment rule (unchanged) |
+| `params.keywords` | `params.keywords` | Tag/Imp-level keywords (use ORTB format of comma-delimited string value; eg `'pet=cat,food,brand=fancyfeast'`) |
+| `params.video` | Use `mediaTypes.video` | Video parameters (moved to mediaTypes) |
+| `params.video.frameworks` | Use `mediaTypes.video.api` | Video API frameworks (moved to mediaTypes) |
+| `params.app` | Use `ortb2.app` | App data (moved to ortb2 config) |
+| `params.reserve` | Use bidfloor module | Reserve price (use bidfloor module) |
+| `params.position` | Use `mediaTypes.banner.pos` | Banner position (moved to mediaTypes) |
+| `params.traffic_source_code` | `params.traffic_source_code` | Traffic source code (unchanged) |
+| `params.supply_type` | Use `ortb2.site` or `ortb2.app` | Supply type (moved to ortb2 config) |
+| `params.pub_click` | `params.pubclick` | Publisher click URL (dropped underscore to align to endpoint) |
+| `params.ext_inv_code` | `params.ext_inv_code` | External inventory code (unchanged) |
+| `params.external_imp_id` | `params.ext_imp_id` | External impression ID (shortend to ext) |
+
+<a name="migration-from-appnexus-adserver-targeting"></a>
+
+#### Migrating from the AppNexus Bid Adapter & Ad Server Targeting
+
+If you are migrating from the AppNexus bid adapter and your Ad Server Line Items (or related entities) relied on bidder specific keyword targeting to the Prebid.js keys (eg hb_bidder=appnexus or hb_pb_appnexus=5.00), you will like need to adjust your setup.  Some adjustments could be creating additional line-items, updating the existing targeting, reomving targeting (if it's no longer needed), or some other variation to ensure the targeting includes the `msft` term in either the key-name or key-value.
+
+<a name="migration-from-appnexus-native"></a>
+
+#### Migrating from the AppNexus Bid Adapter & Native Ads
+
+If you are migrating from the AppNexus bid adapter, the setup for Native adUnits now require the use of the Prebid.js ORTB Native setup.  The Microsoft Bid Adapter **no longer offers support** to the legacy Prebid.js Native adUnit setup.  
+
+Requests using that legacy approach will **NOT** work and will need to be converted to the equivalent values in the adUnit.  This change is made to better align with Prebid.js and many other Bid Adapters that support Native in an ORTB context.
+
+Please refer to the [Prebid.js Native Implementation Guide](https://docs.prebid.org/prebid/native-implementation.html) if you need additional information to implement the Native ORTB setup.
+
+<a name="migration-from-appnexus-auction-level-keywords"></a>
+
+#### Migrating from the AppNexus Bid Adapter & Auction Level Keywords
+
+If you are migrating from the AppNexus bid adapter, the previously available `setConfig` option named `appnexusAuctionKeywords` is not supported within the Microsoft bid adapter.
+
+If you need to specify keyword-like data at the auction/request level, please instead specify that data within the appropriate area of the First Party Data section of your setup (eg `ortb2.site.keywords`).  If you wish to set bidder-specific First Party Data data, please refer to this [page](https://docs.prebid.org/features/firstPartyData.html#supplying-bidder-specific-data).  
+
+<a name="fpd"></a>
+
+#### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+
+PBS/PSP supports all first party data fields: site, user, segments, and imp-level first party data.
+
+<a name="debug-auction"></a>
+
+#### Debug Auction
+
+{: .alert.alert-danger :}
+Enabling the Microsoft Monetize Debug Auction feature should only be done for diagnosing the Monetize auction. Do **NOT** enable this feature in a production setting where it may impact users.  The debug output will take the place of the normal bid response, meaning the ad will **NOT** show even if the auction debug output indicated there was a winning bid.
+
+To understand what is happening behind the scenes during an auction, you can enable a debug auction by either adding an `apn_prebid_debug` cookie with a JSON string or add certain key-value pairs in the page URL's query string. 
+
+To use the cookie approach, the JSON payload for the cookie could look like:
+
+```javascript
+{ "enabled": true, "dongle": "QWERTY", "debug_timeout": 1000, "member_id": 958 }
+```
+
+**NOTE** If you use this approach, you may need to grant permission to the msft Bid Adapter in the your Prebid.js config storageAllowed settings, otherwise Prebid.js will block the adapter from attempting to find/read the cookie.
+
+To use the page URL query string approach, you can append the following set of `apn_debug_...` key-value pairs to the existing page URL's query string:
+`html
+https://my.site.com/page/stuff.html?normal=data_here&apn_debug_enabled=true&apn_debug_dongle=QWERTY&apn_debug_member_id=958&apn_debug_timeout=1000`
+
+To view the results of the debug auction, add the `pbjs_debug=true` query string parameter and open your browser's developer console.
+
+{: .table .table-bordered .table-striped }
+
+| Name              | Description                                                     | Example               | Type             |
+|-------------------|-----------------------------------------------------------------|-----------------------|------------------|
+| `enabled`         | Toggle the debug auction to occur                               | `true`                | `boolean`        |
+| `dongle`          | Your account's unique debug password.                           | `QWERTY`              | `string`         |
+| `member_id`       | The ID of the member running the debug auction                  | `958`                 | `integer`        |
+| `debug_timeout`   | The timeout for the debug auction results to be returned        | `3000`                | `integer`        |
+
+<a name="prebid-server-test-request"></a>

From 14b8c8a6bfda22e1727bbee7ac5b235956cfcb1b Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Mon, 20 Oct 2025 20:57:37 +0200
Subject: [PATCH 370/665] new adapter vaayamedia (#6292)

Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/vaayaMedia.md | 37 ++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/vaayaMedia.md

diff --git a/dev-docs/bidders/vaayaMedia.md b/dev-docs/bidders/vaayaMedia.md
new file mode 100644
index 0000000000..ceb9e42c18
--- /dev/null
+++ b/dev-docs/bidders/vaayaMedia.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Vaaya Media
+description: Prebid Vaaya Media Bidder Adaptor
+biddercode: vaayaMedia
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                             | Example                 | Type      |
+|:--------------|:---------|:--------------------------------------------------------|:------------------------|:----------|
+| `host`        | required | Ad network's RTB host                                   | `'ads-tinyorbit.com'`   | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Vaaya Media Platform.   | `42`                    | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                 | `'banner'`              | `string`  |
+| `publisherId` | required | Publisher ID                                            | `'12345'`               | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                | `'custom1'`             | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                | `'custom2'`             | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                | `'custom3'`             | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                | `'custom4'`             | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                | `'custom5'`             | `string`  |

From 4853a83287f37ba95a3b35c8e87498e1540d7450 Mon Sep 17 00:00:00 2001
From: Gabriel Gravel <gravelg@users.noreply.github.com>
Date: Mon, 20 Oct 2025 15:05:32 -0400
Subject: [PATCH 371/665] fix: update scope3 RTD module name (#6299)

---
 dev-docs/modules/scope3RtdProvider.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/scope3RtdProvider.md b/dev-docs/modules/scope3RtdProvider.md
index c2e433fadd..37ba682928 100644
--- a/dev-docs/modules/scope3RtdProvider.md
+++ b/dev-docs/modules/scope3RtdProvider.md
@@ -39,7 +39,7 @@ pbjs.setConfig({
     realTimeData: {
         auctionDelay: 100,
         dataProviders: [{
-            name: "scope3RtdProvider",
+            name: "scope3",
             waitForIt: true,
             params: {
                 orgId: "your-org-id"
@@ -56,7 +56,7 @@ pbjs.setConfig({
     realTimeData: {
         auctionDelay: 200,
         dataProviders: [{
-            name: "scope3RtdProvider",
+            name: "scope3",
             waitForIt: true,
             params: {
                 orgId: "your-org-id",
@@ -64,7 +64,7 @@ pbjs.setConfig({
                 timeout: 1500,
                 bidders: ["appnexus", "rubicon", "pubmatic"],
                 includeKey: "scope3_include",
-                excludeKey: "scope3_exclude", 
+                excludeKey: "scope3_exclude",
                 macroKey: "scope3_macro",
                 publisherTargeting: true,
                 advertiserTargeting: true,

From a5362e10afc70bec6119e9d248a08dc4febc0f06 Mon Sep 17 00:00:00 2001
From: gregneuwo <grzegorz.malisz@neuwo.ai>
Date: Mon, 20 Oct 2025 21:27:19 +0200
Subject: [PATCH 372/665] docs: Update Neuwo RTD module documentation to
 reflect new API support (#6294)

---
 dev-docs/modules/neuwoRtdProvider.md | 116 +++++++++++++++++++++------
 1 file changed, 90 insertions(+), 26 deletions(-)

diff --git a/dev-docs/modules/neuwoRtdProvider.md b/dev-docs/modules/neuwoRtdProvider.md
index 667f469371..3120f6b520 100644
--- a/dev-docs/modules/neuwoRtdProvider.md
+++ b/dev-docs/modules/neuwoRtdProvider.md
@@ -1,8 +1,8 @@
 ---
 layout: page_v2
-title: Neuwo Real-Time Data Module
-display_name: Neuwo Real-Time Data Module 
-description: Enrich bids using neuwo.ai
+title: Neuwo RTD Module
+display_name: Neuwo RTD Module 
+description: Enrich bids with contextual data from the Neuwo API.
 page_type: module
 module_type: rtd
 module_code : neuwoRtdProvider
@@ -10,48 +10,112 @@ enable_download : true
 sidebarType : 1
 ---
 
-# Neuwo Real-Time Data Module
+# Neuwo RTD Module
 
 ## Overview
 
-The Neuwo AI RTD module is an advanced AI solution for real-time data processing in the field of contextual targeting and advertising. With its cutting-edge algorithms, it allows advertisers to target their audiences with the highest level of precision based on context, while also delivering a seamless user experience.
+The Neuwo RTD provider fetches real-time contextual data from the Neuwo API. When installed, the module retrieves IAB content and audience categories relevant to the current page's content.
 
-The module provides advertisers with valuable insights and real-time contextual bidding capabilities. Whether you're a seasoned advertising professional or just starting out, Neuwo AI RTD module is the ultimate tool for contextual targeting and advertising.
+This data is then added to the bid request by populating the OpenRTB 2.x objects `ortb2.site.content.data` (for IAB Content Taxonomy) and `ortb2.user.data` (for IAB Audience Taxonomy). This enrichment allows bidders to leverage Neuwo's contextual analysis for more precise targeting and decision-making.
 
-The benefit of Neuwo AI RTD module is that it provides an alternative solution for advertisers to target their audiences and deliver relevant advertisements, as the widespread use of cookies for tracking and targeting is becoming increasingly limited.
+Here is an example scheme of the data injected into the `ortb2` object by our module:
 
-The RTD module uses cutting-edge algorithms to process real-time data, allowing advertisers to target their audiences based on contextual information, such as segments, IAB Tiers and brand safety. The RTD module is designed to be flexible and scalable, making it an ideal solution for advertisers looking to stay ahead of the curve in the post-cookie era.
+```javascript
+ortb2: {
+  site: {
+    content: {
+      // IAB Content Taxonomy data is injected here
+      data: [{
+        name: "www.neuwo.ai",
+        segment: [{
+            id: "274",
+            name: "Home & Garden",
+          },
+          {
+            id: "42",
+            name: "Books and Literature",
+          },
+          {
+            id: "210",
+            name: "Food & Drink",
+          },
+        ],
+        ext: {
+          segtax: 7,
+        },
+      }, ],
+    },
+  },
+  user: {
+    // IAB Audience Taxonomy data is injected here
+    data: [{
+      name: "www.neuwo.ai",
+      segment: [{
+          id: "49",
+          name: "Demographic | Gender | Female |",
+        },
+        {
+          id: "161",
+          name: "Demographic | Marital Status | Married |",
+        },
+        {
+          id: "6",
+          name: "Demographic | Age Range | 30-34 |",
+        },
+      ],
+      ext: {
+        segtax: 4,
+      },
+    }, ],
+  },
+}
+```
 
-Generate your token at: [neuwo.ai/generatetoken/]
+To get started, you can generate your API token at [https://neuwo.ai/generatetoken/](https://neuwo.ai/generatetoken/) or [contact us here](https://neuwo.ai/contact-us/).
 
 ## Configuration
 
-| Name       | Scope    | Description                            | Example       | Type     |
-|------------|----------|----------------------------------------|---------------|----------|
-| `name` | required | Handle of the module used in real-time data providers; for this, use 'NeuwoRTDModule' | 'NeuwoRTDModule' | static |
-| `params.publicToken` | required | Your neuwo.ai public token | `neu23-te45-idkf-44aa` (format example) | `string` |
-| `params.apiUrl` | required | Your neuwo.ai API url | `https://some-api-url.neuwo.ai/a/b/c` (format example) | `string` |
+> **Important:** You must add the domain (origin) where Prebid.js is running to the list of allowed origins in Neuwo Edge API configuration. If you have problems, [contact us here](https://neuwo.ai/contact-us/).
+
+This module is configured as part of the `realTimeData.dataProviders` object.
 
 ```javascript
-const neuwoDataProvider = {
-    name: 'NeuwoRTDModule',
-    params: {
-        publicToken: '<public token here>',
-        apiUrl: '<api url here>'
-    }
-}
-pbjs.setConfig({realTimeData: { dataProviders: [ neuwoDataProvider ]}})
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders: [{
+      name: 'NeuwoRTDModule',
+      params: {
+        neuwoApiUrl: '<Your Neuwo Edge API Endpoint URL>',
+        neuwoApiToken: '<Your Neuwo API Token>',
+        iabContentTaxonomyVersion: '3.0',
+      }
+    }]
+  }
+});
 ```
 
+**Parameters**
+
+| Name                               | Type   | Required | Default | Description                                                                                       |
+| :--------------------------------- | :----- | :------- | :------ | :------------------------------------------------------------------------------------------------ |
+| `name`                             | String | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                |
+| `params`                           | Object | Yes      |         | Container for module-specific parameters.                                                         |
+| `params.neuwoApiUrl`               | String | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                               |
+| `params.neuwoApiToken`             | String | Yes      |         | Your unique API token provided by Neuwo.                                                          |
+| `params.iabContentTaxonomyVersion` | String | No       | `'3.0'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'2.2'`, `'3.0'`. |
+
 ## Installation
 
 ### Step 1: Install Prebid.js
 
-- Option 1: Use Prebid [Download](/download.html) page to build the Prebid.js package
-  - Include Neuwo Real-Time Data Module
+#### Option 1
+
+Use Prebid [Download](https://docs.prebid.org/download.html) page to build the Prebid.js package and include Neuwo RTD Module
+
+#### Option 2
 
-- Option 2: Include `neuwoRtdProvider` in build: `gulp build --modules=rtdModule,neuwoRtdProvider,...`
+Include `neuwoRtdProvider` in build: `gulp build --modules=rtdModule,neuwoRtdProvider,...`
 
 ### Step 2: Set configuration
 
-Enable Neuwo Real-Time Data Module using `pbjs.setConfig` in a related Javascript context. Command example is provided in Configuration section.
+Enable Neuwo Real-Time Data Module using `pbjs.setConfig` in a related Javascript context. Command example is provided in [Configuration](#configuration) section.

From 4a45f9851c182627eff861661f62dc1ef459c79a Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Tue, 21 Oct 2025 15:04:46 +0200
Subject: [PATCH 373/665] New pbs adapter: Showheroes (#6256)

* add support for prebid server

* md style fix
---
 dev-docs/bidders/showheroes-bs.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes-bs.md
index 9a07f39efa..d8c298a88a 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes-bs.md
@@ -14,6 +14,7 @@ floors_supported: true
 fpd_supported: true
 multiformat_supported: will-bid-on-one
 sidebarType: 1
+pbs: true
 ---
 
 
@@ -55,6 +56,27 @@ Or, more easily you can mark the whole request as a test request by doing:
 pbjs.setConfig({ortb2: {test: 1}})
 ```
 
+#### Prebid Server Test Request
+
+To verify that the Prebid Server is working properly with the server-side `Showheroes` adapter a `test` property can be utilized.
+
+```json
+{
+  "imp": [{
+    "video": {},
+    "ext": {
+      "params": {
+          "unitId": "1234abcd-5678efgh"
+      }
+    }
+  }],
+  "site": {
+    "page": "{PAGE_URL}"
+  },
+  "test": 1
+}
+```
+
 #### Outstream
 
 Example of adunit configuration for the outstream unit:

From 33bba644fcadd22c5cdff7ec6f2bcde8d422ea6a Mon Sep 17 00:00:00 2001
From: Hiroaki Kubota <hiroaki.kubota@mail.crumb.jp>
Date: Tue, 21 Oct 2025 22:45:46 +0900
Subject: [PATCH 374/665] [craftBidder] Update feature (#6300)

---
 dev-docs/bidders/craft.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/craft.md b/dev-docs/bidders/craft.md
index 5df97f5875..28279ed507 100644
--- a/dev-docs/bidders/craft.md
+++ b/dev-docs/bidders/craft.md
@@ -7,8 +7,9 @@ media_types: banner
 tcfeu_supported: false
 coppa_supported: false
 usp_supported: false
-schain_supported: false
+schain_supported: true
 pbjs: true
+userIds: all
 sidebarType: 1
 ---
 

From 36654a83e8224acdc0b9bcd9213215189c99429b Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Wed, 22 Oct 2025 14:56:40 -0500
Subject: [PATCH 375/665] Adding bid limit on ad unit (#6296)

Co-authored-by: Marcin Komorski <marcinkomorski@Marcins-MacBook-Pro.local>
---
 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 2ccd788cc5..9346cca31e 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -42,6 +42,7 @@ See the table below for the list of properties on the ad unit. For example ad un
 | `renderer` | Optional | Object | Custom renderer, typically used for [outstream video](/dev-docs/show-outstream-video-ads.html) |
 | `video` | Optional | Object | Used to link an Ad Unit to the [Video Module][videoModule]. For allowed params see the [adUnit.video reference](#adunitvideo). |
 | `deferBilling` | Optional | Boolean | Used by a publisher to flag adUnits as being separately billable. This allows for a publisher to trigger billing manually for winning bids. See [pbjs.triggerBilling](/dev-docs/publisher-api-reference/triggerBilling.html) and [onBidBillable](/dev-docs/bidder-adaptor.html#registering-on-bid-billable) for more info. |
+| `bidLimit` | Optional | Number | Used by a publisher to set a bid limit for this ad unit |
 
 <a name="adUnit.bids"></a>
 

From f6fbfb46ff9dfecb349f494e221e1581db3bf220 Mon Sep 17 00:00:00 2001
From: jsnellbaker <31102355+jsnellbaker@users.noreply.github.com>
Date: Sun, 26 Oct 2025 07:48:55 -0400
Subject: [PATCH 376/665] MSFT bidder page - adjust notice meessage (#6309)

---
 dev-docs/bidders/msft.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index 7874007f8c..b79e6ee759 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -15,7 +15,7 @@ gpp_supported: true
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbjs_version_notes: initial release for testing purposes; not intended to immediately replace the appnexus adapter until performance is validated
+pbjs_version_notes: This adapter is new, and will ultimately replace the AppNexus adapter. We recommend careful monitoring of this replacement, and please communicate any questions or unexpected behavior.
 pbs: true
 gvl_id: 32
 sidebarType: 1
@@ -32,6 +32,9 @@ sidebarType: 1
   - [First Party Data](#first-party-data)
   - [Debug Auction](#debug-auction)
 
+{: .alert.alert-danger :}
+This adapter is new, and will ultimately replace the AppNexus adapter. We recommend careful monitoring of this replacement, and please communicate any questions or unexpected behavior.
+
 <a name="bid-params"></a>
 
 {: .alert.alert-danger :}

From c6c21e26470c92ae48f9ff38515b2d96c06c9374 Mon Sep 17 00:00:00 2001
From: Piotr Jaworski <109736938+piotrj-rtbh@users.noreply.github.com>
Date: Mon, 27 Oct 2025 08:08:58 +0100
Subject: [PATCH 377/665] RTB House Bid Adapter: add GPP support (#6303)

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

diff --git a/dev-docs/bidders/rtbhouse.md b/dev-docs/bidders/rtbhouse.md
index 0a0bbc2313..28ff641a45 100644
--- a/dev-docs/bidders/rtbhouse.md
+++ b/dev-docs/bidders/rtbhouse.md
@@ -6,7 +6,7 @@ gvl_id: 16
 tcfeu_supported: true
 usp_supported: false
 coppa_supported: false
-gpp_sids: none
+gpp_supported: true
 dsa_supported: true
 pbjs: true
 pbs: true

From 8c08a9184968a3a1b47b5b04ee06003de95ef290 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Thu, 30 Oct 2025 12:13:08 +0100
Subject: [PATCH 378/665] Update ttd.md to include the useHttp2 parameter
 (#6307)

---
 dev-docs/bidders/ttd.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/ttd.md b/dev-docs/bidders/ttd.md
index b109cf5629..5226d955a5 100644
--- a/dev-docs/bidders/ttd.md
+++ b/dev-docs/bidders/ttd.md
@@ -44,6 +44,7 @@ Name | Scope | Description | Example | Type
 `banner` | optional | Display banner targeting parameters. See the banner section below. | `{}` | `object`
 `bidfloor` | optional | Sets a bid floor price | `0.95` | `Float`
 `customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://customBidderEndpoint/bid/bidder/` | `String`
+`useHttp2` | optional | When true, the adapter will use an endpoint that supports HTTP2. | `true` | `boolean`
 
 ### Banner Object
 

From 1264d7b28d072ae72f52c193256c96a68fcc7b23 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Thu, 30 Oct 2025 13:14:49 +0200
Subject: [PATCH 379/665] Adkernel: documenting Qohere alias (#6308)

---
 dev-docs/bidders/qohere.md | 42 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/qohere.md

diff --git a/dev-docs/bidders/qohere.md b/dev-docs/bidders/qohere.md
new file mode 100644
index 0000000000..5e2b2094b5
--- /dev/null
+++ b/dev-docs/bidders/qohere.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: Qohere
+description: Qohere Adaptor
+biddercode: qohere
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The Qohere bidding adaptor requires setup and approval before beginning. Please reach out to <info@qohere.in> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.qohere.in'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From e735d5eb788c813054f575d187aab220202b1966 Mon Sep 17 00:00:00 2001
From: Alexander Shvetsov <ashvetsov@gmail.com>
Date: Thu, 30 Oct 2025 15:05:54 +0100
Subject: [PATCH 380/665] New Adapter: ADBRO (#6277)

* Added ADBRO Bid Adapter description for Developer Portal.

ADBRO-4287

Signed-off-by: Alexander Shvetsov <ashvetsov@adbro.me>

* Added newline at EOL to fix MD047 error.

Signed-off-by: Alexander Shvetsov <ashvetsov@adbro.me>

* Removed duplicated newline to fix MD012 error.

Signed-off-by: Alexander Shvetsov <ashvetsov@adbro.me>

---------

Signed-off-by: Alexander Shvetsov <ashvetsov@adbro.me>
---
 dev-docs/bidders/adbro.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 dev-docs/bidders/adbro.md

diff --git a/dev-docs/bidders/adbro.md b/dev-docs/bidders/adbro.md
new file mode 100644
index 0000000000..94e3e667d3
--- /dev/null
+++ b/dev-docs/bidders/adbro.md
@@ -0,0 +1,22 @@
+---
+layout: bidder
+title: ADBRO
+description: ADBRO Bid Adapter
+biddercode: adbro
+pbjs: true
+pbs: false
+gvl_id: 1316
+tcfeu_supported: true
+userIds: all
+media_types: banner
+schain_supported: true
+floors_supported: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name           | Scope    | Description           | Example   | Type      |
+|----------------|----------|-----------------------|-----------|-----------|
+| `placementId`  | required | Placement (Slot) ID   | `'1234'`  | `string`  |

From fc9664efd877b51da8ef00b994c98386e76bf3f1 Mon Sep 17 00:00:00 2001
From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com>
Date: Fri, 31 Oct 2025 13:04:02 -0600
Subject: [PATCH 381/665] TIDs Docs : consistent TIDs update (#6317)

* Update setConfig.md

* add example
---
 dev-docs/publisher-api-reference/setConfig.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 8241f46906..dfc0f2a5aa 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -85,7 +85,17 @@ pbjs.setConfig({ enableTIDs: true });
 ```
 
 {: .alert.alert-warning :}
-Since version 10.9.0 transaction IDs are unique for each bidder and cannot be used to correlate requests from different sources, even when `enableTIDs` is set.  
+From version 10.9.0 - 10.13.0 transaction IDs are unique for each bidder and cannot be used to correlate requests from different sources, even when `enableTIDs` is set.
+
+{: .alert.alert-warning :}
+From version 10.14.0+ when `enableTIDs` is set you can also pass `consistentTIDs` set to true to get transaction IDs behavior prior to version 10.9.0 (global vs bidder specific TIDs)
+
+```javascript
+pbjs.setConfig({
+  enableTIDs: true,
+  consistentTIDs : true
+});
+```
 
 ### Max Requests Per Origin
 

From 376873750e9453b3e3f3ff13e8e54f59e34f630b Mon Sep 17 00:00:00 2001
From: pm-nitin-shirsat <107102698+pm-nitin-shirsat@users.noreply.github.com>
Date: Sun, 2 Nov 2025 21:30:56 +0530
Subject: [PATCH 382/665] Consent Management : reset functionality to properly
 disable TCF/GPP modules (#6315)

* Consent Management reset

* Fix line lint issue
---
 dev-docs/modules/consentManagementGpp.md | 17 +++++++++++++++++
 dev-docs/modules/consentManagementTcf.md | 17 +++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/dev-docs/modules/consentManagementGpp.md b/dev-docs/modules/consentManagementGpp.md
index fe72296cdd..80c3bd77b8 100644
--- a/dev-docs/modules/consentManagementGpp.md
+++ b/dev-docs/modules/consentManagementGpp.md
@@ -58,6 +58,7 @@ Here are the parameters supported in the `consentManagement` object specific for
 | Param | Type | Description | Example |
 | --- | --- | --- | --- |
 | gpp | `Object` | | |
+| gpp.enabled | `boolean` | Enables or disables the GPP consent management module. When set to `false`, Prebid does not initialize the CMP integration, does not delay auctions for consent, removes any active CMP event listeners. Defaults to `true` if not specified. | `false` |
 | gpp.cmpApi | `string` | The CMP interface that is in use. Supported values are **'iab'** or **'static'**. Static allows integrations where IAB-formatted consent strings are provided in a non-standard way. Default is `'iab'`. | `'iab'` |
 | gpp.timeout | `integer` | Length of time (in milliseconds) to allow the CMP to obtain the GPP consent information. Default is `10000`. | `10000` |
 | gpp.actionTimeout | `integer` | Length of time (in milliseconds) to allow the user to take action to consent if they have not already done so. The actionTimer first waits for the CMP to load, then the actionTimeout begins for the specified duration. Default is `undefined`. | `10000` |
@@ -117,6 +118,22 @@ Example 2: Static CMP using custom data passing.
      });
 ```
 
+Example 3: Disabling the module. When disabled, Prebid.js will not fetch GPP data, will not wait for the CMP. Existing CMP listeners (if any were previously active) are cleaned up.
+
+```javascript
+    var pbjs = pbjs || {};
+    pbjs.que = pbjs.que || [];
+    pbjs.que.push(function() {
+      pbjs.setConfig({
+        consentManagement: {
+          gpp: {
+            enabled: false
+          }
+        }
+      });
+    });
+```
+
 ## Build the Package
 
 Follow the basic build instructions in the GitHub Prebid.js repo's main [README](https://github.com/prebid/Prebid.js/blob/master/README.md). To include the consent management module, an additional option must be added to the **gulp build** command:
diff --git a/dev-docs/modules/consentManagementTcf.md b/dev-docs/modules/consentManagementTcf.md
index e4963fd332..f766a94aa9 100644
--- a/dev-docs/modules/consentManagementTcf.md
+++ b/dev-docs/modules/consentManagementTcf.md
@@ -66,6 +66,7 @@ but we recommend migrating to the new config structure as soon as possible.
 | Param | Type | Description | Example |
 | --- | --- | --- | --- |
 | gdpr | `Object` | | |
+| gdpr.enabled | `boolean` | Enables or disables the TCF consent management module. When set to `false`, Prebid does not initialize the CMP integration, does not delay auctions for consent, removes any active CMP event listeners. Defaults to `true` if not specified. | `false` |
 | gdpr.cmpApi | `string` | The CMP interface that is in use. Supported values are **'iab'** or **'static'**. Static allows integrations where IAB-formatted consent strings are provided in a non-standard way. Default is `'iab'`. | `'iab'` |
 | gdpr.timeout | `integer` | Length of time (in milliseconds) to allow the CMP to obtain the GDPR consent string. Default is `10000`. | `10000` |
 | gdpr.actionTimeout | `integer` | Length of time (in milliseconds) to allow the user to take action to consent if they have not already done so. The actionTimer first waits for the CMP to load, then the actionTimeout begins for the specified duration. Default is `undefined`. | `10000` |
@@ -171,6 +172,22 @@ Example 3: Static CMP using custom data passing.
      });
 ```
 
+Example 4: Disabling the module. When disabled, Prebid.js will not fetch TCF data, will not wait for the CMP. Existing CMP listeners (if any were previously active) are cleaned up.
+
+```javascript
+    var pbjs = pbjs || {};
+    pbjs.que = pbjs.que || [];
+    pbjs.que.push(function() {
+      pbjs.setConfig({
+        consentManagement: {
+          gdpr: {
+            enabled: false
+          }
+        }
+      });
+    });
+```
+
 ## Build the Package
 
 Follow the basic build instructions in the GitHub Prebid.js repo's main [README](https://github.com/prebid/Prebid.js/blob/master/README.md). To include the consent management module, an additional option must be added to the **gulp build** command:

From 55faeada43c5f4ee2e3e25abb73552ce0991a038 Mon Sep 17 00:00:00 2001
From: Klaus <contact@klaussilveira.com>
Date: Fri, 7 Nov 2025 04:17:27 -0500
Subject: [PATCH 383/665] Fixed filename for freedomadnetwork.md (#6323)

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

diff --git a/dev-docs/bidders/freedomadnetwork.md b/dev-docs/bidders/freedomadnetwork.md
index f1e82c370d..f02e7b6814 100644
--- a/dev-docs/bidders/freedomadnetwork.md
+++ b/dev-docs/bidders/freedomadnetwork.md
@@ -3,7 +3,7 @@ layout: bidder
 title: Freedom Ad Network
 description: Freedom Ad Network Bidder Adapter
 biddercode: freedomadnetwork
-filename: fanAdapter
+filename: fanBidAdapter
 gvl_id: none
 coppa_supported: true
 media_types: banner, native

From 5a338ab8c2c67acdbd40d2b72dc97b6ec481472f Mon Sep 17 00:00:00 2001
From: amoskueez <147311247+amoskueez@users.noreply.github.com>
Date: Fri, 7 Nov 2025 11:23:04 +0200
Subject: [PATCH 384/665] Add pbs app support tagoras kueezrtb (#6318)

* Enable PBS app support for KueezRTB

* Enable PBS app support for Tagoras bidder
---
 dev-docs/bidders/kueezrtb.md | 2 +-
 dev-docs/bidders/tagoras.md  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/kueezrtb.md b/dev-docs/bidders/kueezrtb.md
index 273a308753..e05fb0f016 100644
--- a/dev-docs/bidders/kueezrtb.md
+++ b/dev-docs/bidders/kueezrtb.md
@@ -15,7 +15,7 @@ media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
diff --git a/dev-docs/bidders/tagoras.md b/dev-docs/bidders/tagoras.md
index 27276ad288..94b7cb9c03 100644
--- a/dev-docs/bidders/tagoras.md
+++ b/dev-docs/bidders/tagoras.md
@@ -15,7 +15,7 @@ media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one

From 6b06a1bc305fd87486828766d328f202ea5ab223 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Fri, 7 Nov 2025 11:26:17 +0200
Subject: [PATCH 385/665] Adkernel: documenting bluTonic alias (#6312)

Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/blutonic.md | 42 ++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/blutonic.md

diff --git a/dev-docs/bidders/blutonic.md b/dev-docs/bidders/blutonic.md
new file mode 100644
index 0000000000..7a6955d497
--- /dev/null
+++ b/dev-docs/bidders/blutonic.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: bluTonic
+description: bluTonic Adaptor
+biddercode: blutonic
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The bluTonic bidding adaptor requires setup and approval before beginning. Please reach out to <adops@blutonic.com> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.blutonic.net'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From 01e738beae8184cc2e801c544875ff4f9f20fc97 Mon Sep 17 00:00:00 2001
From: ss-toshihide-tajima
 <89903823+ss-toshihide-tajima@users.noreply.github.com>
Date: Fri, 7 Nov 2025 18:26:53 +0900
Subject: [PATCH 386/665] Align first-party data example with OpenRTB spec
 (#6310)

This commit updates the AdGeneration bidder documentation to align the first-party data example with the OpenRTB specification.
The OpenRTB specification requires the `id` field for objects within the `user.data[].segment` array. However, the code example in the AdGeneration bidder documentation was incorrectly using the `name` field.
This discrepancy causes valid first-party data to be filtered out by the `validationFpdModule`, as it correctly enforces the OpenRTB standard by rejecting segments that lack the required `id` field.
- In `dev-docs/bidders/adgeneration.md`, the `firstpartydata` example has been updated.
- The `name` key in the `segment` objects has been replaced with `id`.
This change ensures the documentation provides a correct, compliant example for publishers, preventing potential integration issues.
---
 dev-docs/bidders/adgeneration.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/adgeneration.md b/dev-docs/bidders/adgeneration.md
index 12e9914304..4d420d8d75 100644
--- a/dev-docs/bidders/adgeneration.md
+++ b/dev-docs/bidders/adgeneration.md
@@ -28,7 +28,7 @@ In release 1.6.4 and later, publishers should use the `ortb2` method of setting
 * ortb2.site.content.data[]
 
 If `ad-generation.jp` is specified for ortb2.site.content.data[].name and `546` is specified for ortb2.site.content.data[].ext.segtax,
-`ortb2.site.content.data[].segment[].name` and `ortb2.site.content.data[].segment[].value` can be any string value.
+`ortb2.site.content.data[].segment[].id` and `ortb2.site.content.data[].segment[].value` can be any string value.
 
 Example first party data that's available to all bidders and all adunits:
 
@@ -43,9 +43,10 @@ pbjs.setConfig({
                         segtax: 546
                     },
                     segment: [
-                        { name: "news_category", value: "Sports_Sumo" },// name and value must be string types
-                        { name: "local_gourmet", value: "sushi" },
-                        { name: "location", value: "tokyo" }
+                        { id: "news_category", value: "Sports_Sumo" },// id and value must be string types
+                        { id: "local_gourmet", value: "sushi" },
+                        { id: "location", value: "tokyo" },
+                        { id: "code", value: "1001"}
                     ]
                 }]
             }

From cd84d46e3039d05dd79d5a687a752038febf4770 Mon Sep 17 00:00:00 2001
From: dpapworth-qc <50959025+dpapworth-qc@users.noreply.github.com>
Date: Fri, 7 Nov 2025 09:28:29 +0000
Subject: [PATCH 387/665] Remove quantcastId (#6302)

* Remove quantcast.md.

* Remove references to quantcastId.
---
 dev-docs/bidders/blis.md                      |  2 +-
 dev-docs/bidders/openx.md                     |  2 +-
 dev-docs/bidders/teads.md                     |  2 +-
 .../modules/userid-submodules/quantcast.md    | 50 -------------------
 4 files changed, 3 insertions(+), 53 deletions(-)
 delete mode 100644 dev-docs/modules/userid-submodules/quantcast.md

diff --git a/dev-docs/bidders/blis.md b/dev-docs/bidders/blis.md
index 0555f34539..a585e99b21 100644
--- a/dev-docs/bidders/blis.md
+++ b/dev-docs/bidders/blis.md
@@ -10,7 +10,7 @@ coppa_supported: true
 gpp_sids: tcfeu, usnat, usp
 schain_supported: true
 dchain_supported: false
-userId: adserver, liveramp, sharedid, pubcid, id5-sync, criteo, quantcast
+userId: adserver, liveramp, sharedid, pubcid, id5-sync, criteo
 media_types: banner, video, native
 safeframes_ok: false
 deals_supported: true
diff --git a/dev-docs/bidders/openx.md b/dev-docs/bidders/openx.md
index 694e8e423c..ba96f20976 100644
--- a/dev-docs/bidders/openx.md
+++ b/dev-docs/bidders/openx.md
@@ -12,7 +12,7 @@ usp_supported: true
 coppa_supported: true
 gpp_supported: true
 floors_supported: true
-userIds: admixerId, adtelligentId, amxId, britepoolId, criteo, dapId, deepintentId, dmdId, fabrickId, hadronId, id5Id, identityLink, idxId, imuId, intentIqId, kinessoId, liveIntentId, lotamePanoramaId, merkleId, mwOpenLinkId, naveggId, netId, novatiq, parrableId, pubCommonId, publinkId, quantcastId, sharedId, tapadId, uid2, unifiedId, verizonMediaId, zeotapIdPlus
+userIds: admixerId, adtelligentId, amxId, britepoolId, criteo, dapId, deepintentId, dmdId, fabrickId, hadronId, id5Id, identityLink, idxId, imuId, intentIqId, kinessoId, liveIntentId, lotamePanoramaId, merkleId, mwOpenLinkId, naveggId, netId, novatiq, parrableId, pubCommonId, publinkId, sharedId, tapadId, uid2, unifiedId, verizonMediaId, zeotapIdPlus
 prebid_member: true
 fpd_supported: true
 gvl_id: 69
diff --git a/dev-docs/bidders/teads.md b/dev-docs/bidders/teads.md
index dac0e35448..f7eed42b27 100644
--- a/dev-docs/bidders/teads.md
+++ b/dev-docs/bidders/teads.md
@@ -12,7 +12,7 @@ tcfeu_supported: true
 dsa_supported: true
 usp_supported: true
 schain_supported: true
-userIds: uid2Id, identityLinkId, lotamePanoramaId, id5Id, criteoId, connectId, quantcastId, publinkId, sharedId, merkleId, kinessoId
+userIds: uid2Id, identityLinkId, lotamePanoramaId, id5Id, criteoId, connectId, publinkId, sharedId, merkleId, kinessoId
 media_types: banner, video
 gvl_id: 132
 deals_supported: true
diff --git a/dev-docs/modules/userid-submodules/quantcast.md b/dev-docs/modules/userid-submodules/quantcast.md
deleted file mode 100644
index 0b4b145dff..0000000000
--- a/dev-docs/modules/userid-submodules/quantcast.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-layout: userid
-title: Quantcast ID
-description: Quantcast ID User ID sub-module
-useridmodule: quantcastIdSystem
-bidRequestUserId: quantcastId
-eidsource: quantcast.com
-example: '"1111"'
----
-
-The Prebid Quantcast ID module stores a Quantcast ID in a first party cookie. The ID is then made available in the bid request. The ID from the cookie added in the bidstream allows Quantcast to more accurately bid on publisher inventories without third party cookies, which can result in better monetization across publisher sites from Quantcast. And, it’s free to use! For easier integration, you can work with one of our SSP partners, like PubMatic, who can facilitate the legal process as well as the software integration for you.
-
-Add it to your Prebid.js package with:
-
-```bash
-gulp build --modules=userId,quantcastIdSystem
-```
-
-Quantcast’s privacy policies for the services rendered can be found at
-         <https://www.quantcast.com/privacy/>
-
-Publishers deploying the module are responsible for ensuring legally required notices and choices for users.
-
-The Quantcast ID module will only perform any action and return an ID in situations where:
-
-1. the publisher has not set a ‘coppa'  flag on the prebid configuration on their site (see [pbjs.setConfig.coppa](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-coppa))
-2. there is not a IAB us-privacy string indicating the digital property has provided user notice and the user has made a choice to opt out of sale
-3. if GDPR applies, an IAB TCF v2 string exists indicating that Quantcast does not have consent for purpose 1 (cookies, device identifiers, or other information can be stored or accessed on your device for the purposes presented to you), or an established legal basis (by default legitimate interest) for purpose 10 (your data can be used to improve existing systems and software, and to develop new products).
-
-## Quantcast ID Configuration
-
-{: .table .table-bordered .table-striped }
-
-| Param under userSync.userIds[] | Scope | Type | Description | Example |
-| --- | --- | --- | --- | --- |
-| name | Required | String | `"quantcastId"` | `"quantcastId"` |
-| params | Optional | Object | Details for Quantcast initialization. | |
-| params.ClientID | Optional | String | Optional parameter for Quantcast prebid managed service partners. The parameter is not required for websites with Quantcast Measure tag. Reach out to Quantcast for ClientID if you are not an existing Quantcast prebid managed service partner: <quantcast-idsupport@quantcast.com>  | |
-
-## Quantcast ID Example
-
-```javascript
-pbjs.setConfig({
-    userSync: {
-        userIds: [{
-            name: "quantcastId"
-        }]
-    }
-});
-```

From 02478fee5523d494461a32b4d679ec1530489b17 Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Fri, 7 Nov 2025 11:29:18 +0200
Subject: [PATCH 388/665] Omnidex update details (#6298)

* adding pbs option to adapted docs: programmaticX: https://github.com/prebid/prebid-server/pull/4456; tagoras: https://github.com/prebid/prebid-server/pull/4329;

* adding pbs option to adapted docs: opamarketplace: https://github.com/prebid/prebid-server/pull/4526

* adding glvid to omnidex

* removing change from other pr
---
 dev-docs/bidders/omnidex.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/omnidex.md b/dev-docs/bidders/omnidex.md
index 6a880c22fc..09881834a1 100644
--- a/dev-docs/bidders/omnidex.md
+++ b/dev-docs/bidders/omnidex.md
@@ -7,6 +7,7 @@ filename: omnidexBidAdapter
 userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 tcfeu_supported: false
 usp_supported: true
+gvl_id: 1463
 coppa_supported: false
 schain_supported: true
 gpp_supported: true

From a615f464eee5d39b3f37ea3edb29ce3cdd9cdd7e Mon Sep 17 00:00:00 2001
From: nuba-io <github@nuba.io>
Date: Fri, 7 Nov 2025 11:32:08 +0200
Subject: [PATCH 389/665] Added Bid Adapter Nuba.io (#6295)

* feature/nuba-bidder

* Apply suggestion from @muuki88

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/nuba.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/nuba.md

diff --git a/dev-docs/bidders/nuba.md b/dev-docs/bidders/nuba.md
new file mode 100644
index 0000000000..0746492f19
--- /dev/null
+++ b/dev-docs/bidders/nuba.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: Nuba
+description: Prebid Nuba Bidder Adapter
+biddercode: nuba
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 7fe2216472d19a98cebdc9eaca261971523bfaa9 Mon Sep 17 00:00:00 2001
From: Invis <invisbox@gmail.com>
Date: Fri, 7 Nov 2025 10:32:44 +0100
Subject: [PATCH 390/665] Feature/smartytech add auid (#6287)

* Update SmartyTech adapter documentation with userId, consents, and chunks support

- Add support for all Prebid.js User ID modules (userIds: all)
- Add comprehensive privacy framework support:
  * GDPR (TCF EU) consent strings
  * CCPA/USP compliance
  * GPP (Global Privacy Platform)
  * COPPA compliance
- Add chunks configuration documentation with examples
- Update front matter with new supported features flags
- Fix markdownlint issues and improve code block formatting

This documentation update supports the upcoming SmartyTech adapter enhancements
that will include userId transmission, consent handling, and request chunking.

* Remove tcfeu and gpp

* Add Alias User ID (auId) documentation

- Document automatic auId generation and management
- Explain cookie storage mechanism (_smartytech_auid)
- Describe 5-year persistence on root domain
- Note privacy-respecting behavior (requires cookies enabled)
- Add details about automatic inclusion in bid requests
---
 dev-docs/bidders/smartytech.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/dev-docs/bidders/smartytech.md b/dev-docs/bidders/smartytech.md
index 8c66f616be..958f1f4807 100644
--- a/dev-docs/bidders/smartytech.md
+++ b/dev-docs/bidders/smartytech.md
@@ -67,6 +67,18 @@ var videoAdUnit = {
 
 SmartyTech adapter supports all Prebid.js User ID modules. User IDs are automatically included in bid requests when available.
 
+### Alias User ID (auId)
+
+The SmartyTech adapter automatically generates and manages an Alias User ID (auId) for user identification across sessions:
+
+- **Automatic Generation**: If no auId exists, a unique UUID is automatically generated
+- **Cookie Storage**: The auId is stored in a first-party cookie (`_smartytech_auid`)
+- **Persistence**: The cookie is valid for 5 years
+- **Domain**: Stored on the root domain for cross-subdomain availability
+- **Privacy**: Only generated if cookies are enabled; respects user privacy settings
+
+The auId is automatically included in all bid requests when available, providing consistent user identification without requiring additional configuration.
+
 ### Additional Configuration
 
 It is possible to configure requests to be split into chunks so as to have fewer bid requests in a single http request (default value is 10).

From 89122e468ebddc7b179a774a00dbebdcd6409e7a Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Fri, 7 Nov 2025 11:33:57 +0200
Subject: [PATCH 391/665] Add Gravite adapter (#6269)

Co-authored-by: Gravite <>
---
 dev-docs/bidders/gravite.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/gravite.md

diff --git a/dev-docs/bidders/gravite.md b/dev-docs/bidders/gravite.md
new file mode 100644
index 0000000000..892ec0abcb
--- /dev/null
+++ b/dev-docs/bidders/gravite.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: Gravite Marketplace
+description: Prebid Gravite Bidder Adapter
+biddercode: gravite
+gpp_sids: usstate_all
+gvl_id: 1344
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: false
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server you only need to use one parameter: either `placementId` or `endpointId`

From ca32e493b7dbb7ef999cfbd9801311be74333fec Mon Sep 17 00:00:00 2001
From: Carlos Felix <carlos.felix@33across.com>
Date: Fri, 7 Nov 2025 02:34:24 -0700
Subject: [PATCH 392/665] 33across Bid Adapter: zone id config option & app
 related info (#6254)

* 33across - rename siteId to zoneId

* 33across - Info about how to config app requests

* 33across - supported pbs app
---
 dev-docs/bidders/33across.md | 72 ++++++++++++++++++++++--------------
 1 file changed, 44 insertions(+), 28 deletions(-)

diff --git a/dev-docs/bidders/33across.md b/dev-docs/bidders/33across.md
index 46577309c7..57eaea62c2 100644
--- a/dev-docs/bidders/33across.md
+++ b/dev-docs/bidders/33across.md
@@ -4,6 +4,7 @@ title: 33Across
 description: Prebid 33Across Bidder Adapter
 pbjs: true
 pbs: true
+pbs_app_supported: true
 biddercode: 33across
 media_types: banner, video
 tcfeu_supported: true
@@ -26,10 +27,11 @@ sidebarType: 1
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
- 
+
 | Name        | Scope    | Description                                                                                                                    | Example    | Type     |
 |-------------|----------|--------------------------------------------------------------------------------------------------------------------------------|------------|----------|
-| `siteId`    | required | Publisher  GUID from 33Across                                                                                                  | `'examplePub123'` | `string` |
+| `zoneId`    | required | Publisher  GUID from 33Across                                                                                                  | `'examplePub123'` | `string` |
+| `siteId`    | required | (Deprecated) Publisher  GUID from 33Across                                                                                                  | `'examplePub123'` | `string` |
 | `productId` | required | 33Across Product ID that the Publisher has registered for (use `'siab'` for Banner or Outstream Video , `'inview'` for Adhesion, `'instream'` for Instream Video) | `'siab'`   | `string` |
 | `test` | optional | Set to `1` to enable test mode | `1` | `integer` |
 
@@ -38,19 +40,19 @@ sidebarType: 1
 ```javascript
 var adUnits = [
 {
-  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
+  code: '33across-hb-ad-123456-1', // ad slot HTML element ID
   mediaTypes: {
-    banner: {  
+    banner: {
       sizes: [
-          [300, 250], 
+          [300, 250],
           [728, 90]
       ]
-    }   
-  } 
+    }
+  }
   bids: [{
     bidder: '33across',
     params: {
-        siteId: 'examplePub123',    // required 
+        zoneId: 'examplePub123',    // required
         productId: 'siab|inview'    // required
         // optional: uncomment to enable test requests
         // test: 1
@@ -64,10 +66,10 @@ var adUnits = [
 ```javascript
 var adUnits = [
 {
-  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
+  code: '33across-hb-ad-123456-1', // ad slot HTML element ID
   mediaTypes: {
     video: {                                // We recommend setting the following video params
-                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
+                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation.
       playerSize: [300, 250],               // required
       context: 'outstream',                 // required
       mimes: ['video/mp4','video/x-flv'],   // required
@@ -82,13 +84,13 @@ var adUnits = [
       linearity: 1,                         // optional
       minbitrate: 10,                       // optional
       maxbitrate: 10                        // optional
-    }   
-  }, 
+    }
+  },
   bids: [{
     bidder: '33across',
     params: {
-        siteId: 'examplePub123',    // required     
-        productId: 'siab'           // required     
+        zoneId: 'examplePub123',    // required
+        productId: 'siab'           // required
     }
   }],
   ...
@@ -100,10 +102,10 @@ var adUnits = [
 ```javascript
 var adUnits = [
 {
-  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
+  code: '33across-hb-ad-123456-1', // ad slot HTML element ID
   mediaTypes: {
     video: {                                // We recommend setting the following video params
-                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
+                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation.
       playerSize: [300, 250],               // required
       context: 'instream',                  // required
       mimes: ['video/mp4','video/x-flv'],   // required
@@ -119,13 +121,13 @@ var adUnits = [
       linearity: 1,                         // optional
       minbitrate: 10,                       // optional
       maxbitrate: 10                        // optional
-    }   
-  }, 
+    }
+  },
   bids: [{
     bidder: '33across',
     params: {
-        siteId: 'examplePub123',    // required    
-        productId: 'instream'       // required     
+        zoneId: 'examplePub123',    // required
+        productId: 'instream'       // required
     }
   }],
   ...
@@ -137,16 +139,16 @@ var adUnits = [
 ```javascript
 var adUnits = [
 {
-  code: '33across-hb-ad-123456-1', // ad slot HTML element ID  
+  code: '33across-hb-ad-123456-1', // ad slot HTML element ID
   mediaTypes: {
-    banner: {  
+    banner: {
       sizes: [
-          [300, 250], 
+          [300, 250],
           [728, 90]
       ]
     },
     video: {                                // We recommend setting the following video params
-                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation. 
+                                            // in Ad Unit rather than bidder params as per Prebid 4.0 recommendation.
       playerSize: [300, 250],               // required
       context: 'outstream',                 // required
       mimes: ['video/mp4','video/x-flv'],   // required
@@ -161,19 +163,33 @@ var adUnits = [
       linearity: 1,                         // optional
       minbitrate: 10,                       // optional
       maxbitrate: 10                        // optional
-    }   
-  }, 
+    }
+  },
   bids: [{
     bidder: '33across',
     params: {
-        siteId: 'examplePub123',    // required     
-        productId: 'siab'           // required     
+        zoneId: 'examplePub123',    // required
+        productId: 'siab'           // required
     }
   }],
   ...
 }
 ```
 
+### App request config
+
+Use `pbjs.setConfig()` or `pbjs.setBidderConfig()` for scenarios where prebid.js is in an App Webview.
+
+``` javascript
+pbjs.setConfig({
+  ortb2: {
+    app: {
+      name: 'My APP'
+    }
+  }
+});
+```
+
 ### SRA Mode
 
 We recommend using SRA mode to optimize the bidding process as this allows our adapter to group together bid requests for Ad Units pertaining to the same product and site ID thereby minimizing the number of http requests made to our endpoint. To enable SRA set the following bidder specific config under 33Across

From a6c322ba0114f0b9c3a3af9248c6e27d3a177b8d Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Fri, 7 Nov 2025 11:35:58 +0200
Subject: [PATCH 393/665] Attekmi Add region (#6238)

* Attekmi Add region

* remove empty lines

* add empty line

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/attekmi.md                  |  1 +
 dev-docs/bidders/{jamojar.md => jambojar.md} |  1 +
 dev-docs/bidders/smarthub.md                 |  1 +
 dev-docs/bidders/vimayx.md                   | 39 --------------------
 4 files changed, 3 insertions(+), 39 deletions(-)
 rename dev-docs/bidders/{jamojar.md => jambojar.md} (94%)
 delete mode 100644 dev-docs/bidders/vimayx.md

diff --git a/dev-docs/bidders/attekmi.md b/dev-docs/bidders/attekmi.md
index f2c22d9b58..7d7be2512b 100644
--- a/dev-docs/bidders/attekmi.md
+++ b/dev-docs/bidders/attekmi.md
@@ -28,6 +28,7 @@ sidebarType: 1
 | `partnerName` | required | Unique partner name             | `'partnertest'`                     | `string`  |
 | `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
 | `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `region`      | optional | Region                          | `apac`                              | `string`  |
 | `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`    | `Array(String)`   |
 | `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
 | `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.    | `4`                                 | `number`  |
diff --git a/dev-docs/bidders/jamojar.md b/dev-docs/bidders/jambojar.md
similarity index 94%
rename from dev-docs/bidders/jamojar.md
rename to dev-docs/bidders/jambojar.md
index 572102a01c..b18d134667 100644
--- a/dev-docs/bidders/jamojar.md
+++ b/dev-docs/bidders/jambojar.md
@@ -26,6 +26,7 @@ multiformat_supported: will-bid-on-any
 |---------------|----------|---------------------------------|-------------------------------------|-----------|
 | `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
 | `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `region`      | optional | Region                          | `apac`                              | `string`  |
 | `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
 | `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
 | `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
diff --git a/dev-docs/bidders/smarthub.md b/dev-docs/bidders/smarthub.md
index 66ce57ba44..3b273f6928 100644
--- a/dev-docs/bidders/smarthub.md
+++ b/dev-docs/bidders/smarthub.md
@@ -25,6 +25,7 @@ Please note that SmartHub has been renamed to Attekmi.
 | `partnerName` | required | Unique partner name             | `'partnertest'`                     | `string`  |
 | `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
 | `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `region`      | optional | Region                          | `apac`                              | `string`  |
 | `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`    | `Array(String)`   |
 | `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
 | `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.    | `4`                                 | `number`  |
diff --git a/dev-docs/bidders/vimayx.md b/dev-docs/bidders/vimayx.md
deleted file mode 100644
index 41de6725f8..0000000000
--- a/dev-docs/bidders/vimayx.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-layout: bidder
-title: VimayX
-description: VimayX Bidder Adapter
-biddercode: vimayX
-aliasCode : smarthub
-usp_supported: true
-coppa_supported: true
-schain_supported: true
-dchain_supported: true
-media_types: banner, video, native
-safeframes_ok: true
-deals_supported: true
-floors_supported: true
-fpd_supported: false
-pbjs: true
-pbs: true
-pbs_app_supported: true
-multiformat_supported: will-bid-on-any
----
-
-### Prebid.js Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                     | Example                             | Type      |
-|---------------|----------|---------------------------------|-------------------------------------|-----------|
-| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
-| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
-| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
-| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
-| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
-
-### Prebid Server Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description         | Example                              | Type     |
-|---------------|----------|---------------------|--------------------------------------|----------|
-| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
-| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 43b9e7689cd12c2d159b55047f3ceee307f58864 Mon Sep 17 00:00:00 2001
From: bTimor <btimor.dev@gmail.com>
Date: Fri, 7 Nov 2025 11:37:59 +0200
Subject: [PATCH 394/665] Add Scalibur bidder adapter documentation (#6235)

* add scalibure md file to dev-docs

* move scalibure md to bidders folder

* add scalibur bidder adapter doc and tested

* Add Scalibur bidder adapter documentation

- Add complete bidder documentation with all required front matter
- Configure support for GDPR, CCPA, GPP, floors, and FPD
- Set GVLID to 1471 for proper GDPR compliance
- Enable integration with bidders list and search functionality

* fix scalibur md file

* revert package json to origin

* revert package json to origin

* fix annotations

* more annotation fixes

* more annotation fixes

* fix bid params rendering

* pr comments and other format issues fixed

---------

Co-authored-by: Timor Bibi <timor@Timors-MacBook-Pro-2.local>
---
 dev-docs/bidders/scalibur.md | 185 +++++++++++++++++++++++++++++++++++
 package-lock.json            |   2 +-
 package.json                 |   4 +-
 3 files changed, 187 insertions(+), 4 deletions(-)
 create mode 100644 dev-docs/bidders/scalibur.md

diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md
new file mode 100644
index 0000000000..f4127f654d
--- /dev/null
+++ b/dev-docs/bidders/scalibur.md
@@ -0,0 +1,185 @@
+---
+layout: bidder
+title: Scalibur
+description: Prebid Scalibur Bidder Adapter
+biddercode: scalibur
+gvl_id: 1471
+media_types: banner, video
+gpp_supported: true
+gpp_sids: tcfeu, usstate_all, usp
+coppa_supported: true
+schain_supported: true
+dchain_supported: false
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: false
+userIds: all
+pbs_app_supported: false
+---
+
+The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertising platform. It supports both banner and video ad formats through OpenRTB 2.x protocol and provides full compliance with privacy regulations.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Type | Description | Example |
+| ---- | ----- | ---- | ----------- | ------- |
+| `placementId` | required | String | Placement identifier provided by Scalibur | `'test-placement-123'` |
+
+### Test Parameters
+
+For testing purposes, you can use the following ad unit configurations:
+
+#### Banner Ad Unit
+
+```javascript
+var adUnits = [
+    {
+        code: 'test-banner-div',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [728, 90], [320, 50]]
+            }
+        },
+        bids: [
+            {
+                bidder: 'scalibur',
+                params: {
+                    placementId: 'test-scl-placement'
+                }
+            }
+        ]
+    }
+];
+```
+
+#### 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: 'scalibur',
+        params: {
+          placementId: 'test-scl-placement' // Required
+        }
+      }
+    ]
+  }
+];
+```
+
+#### Multi-format Ad Unit
+
+```javascript
+var adUnits = [
+    {
+        code: 'test-multiformat-div',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [728, 90]]
+            },
+            video: {
+                context: 'instream',
+                playerSize: [[300, 169]],
+                mimes: ['video/mp4'],
+                protocols: [2, 3, 5, 6],
+                minduration: 15,
+                maxduration: 30
+            }
+        },
+        bids: [
+            {
+                bidder: 'scalibur',
+                params: {
+                    placementId: 'test-scl-placement'
+                }
+            }
+        ]
+    }
+];
+```
+
+### First Party Data
+
+The adapter supports First Party Data (FPD) in multiple ways:
+
+- **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` data
+- **AdUnit FPD**: Includes ad unit specific `ortb2Imp` data
+- **Local Storage**: Generates and stores first-party identifiers for enhanced targeting
+
+### User Sync
+
+The Scalibur adapter supports user synchronization through:
+
+- **Iframe syncs**: For enhanced matching capabilities
+- **Image syncs**: For lightweight synchronization
+
+All privacy parameters are automatically included in sync requests.
+
+#### Configuration Example
+
+```javascript
+pbjs.que.push(function() {
+    pbjs.addAdUnits(adUnits);
+
+    pbjs.setConfig({
+        debug: true,
+        userSync: {
+            filterSettings: {
+                iframe: {
+                    bidders: ['scalibur'],
+                    filter: 'include'
+                },
+                image: {
+                    bidders: ['scalibur'],
+                    filter: 'include'
+                }
+            }
+        }
+    });
+
+    pbjs.requestBids({
+        timeout: 3000,
+        bidsBackHandler: function(bidResponses) {
+            // Handle bid responses
+        }
+    });
+});
+```
+
+### Support
+
+For technical support or integration assistance:
+
+- **Email**: [support@scalibur.io](mailto:support@scalibur.io)
+- **Documentation**: Contact Scalibur Support Team
+
+### Notes
+
+- Video ads support instream context with standard IAB video parameters
+- Banner ads support multiple sizes including standard IAB sizes
+- All requests are sent via secure HTTPS endpoints
+- The adapter automatically handles device detection and targeting
diff --git a/package-lock.json b/package-lock.json
index 4e95391780..931d670e2c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -11,7 +11,7 @@
       "license": "ISC",
       "dependencies": {
         "awesomplete": "^1.1.5",
-        "bootstrap": "^4.5.3",
+        "bootstrap": "^4.6.2",
         "bourbon": "^7.0.0",
         "include-media": "^1.4.9",
         "popper.js": "^1.16.1"
diff --git a/package.json b/package.json
index 0e5281ff3a..fb06b2e31b 100644
--- a/package.json
+++ b/package.json
@@ -23,11 +23,9 @@
     "url": "https://github.com/AtreNet/prebid.github.io/issues"
   },
   "homepage": "https://github.com/AtreNet/prebid.github.io#readme",
-  "devDependencies": {
-  },
   "dependencies": {
     "awesomplete": "^1.1.5",
-    "bootstrap": "^4.5.3",
+    "bootstrap": "^4.6.2",
     "bourbon": "^7.0.0",
     "include-media": "^1.4.9",
     "popper.js": "^1.16.1"

From 98e9290b417d873e66563cd22f21b5138b31302c Mon Sep 17 00:00:00 2001
From: dxtech-git <github@dxtech.ai>
Date: Fri, 7 Nov 2025 11:38:41 +0200
Subject: [PATCH 395/665] New adapter - DXTech (#6230)

* New adapter - DXTech

* remove bidfloor and cur

* Add more details, remove pbs support

---------

Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/dxtech.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 dev-docs/bidders/dxtech.md

diff --git a/dev-docs/bidders/dxtech.md b/dev-docs/bidders/dxtech.md
new file mode 100644
index 0000000000..2880b08e48
--- /dev/null
+++ b/dev-docs/bidders/dxtech.md
@@ -0,0 +1,33 @@
+---
+layout: bidder
+title: DXTech
+description: Prebid DXTech Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: dxtech
+media_types: banner, video
+tcfeu_supported: false
+gdpr_supported: true
+usp_supported: true
+schain_supported: true
+sidebarType: 1
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: partial
+---
+
+### Integration Note
+
+The DXTech Header Bidding adapter requires approval from the DXTech team. Please reach out to <support@dxtech.ai> for more information.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope    | Description        | Example     | Type      |
+|------|----------|--------------------|-------------|-----------|
+| `placementId` | required | Placement Id | `'1234abcd'` | `string`  |
+| `publisherId` | required | Publisher Id       | `'12345'`     | `string` |

From 76deacedffff45ca24f2db3a371c47a528fc874f Mon Sep 17 00:00:00 2001
From: Likhith Kumar <111145706+Likhith329@users.noreply.github.com>
Date: Fri, 7 Nov 2025 15:09:50 +0530
Subject: [PATCH 396/665] Datawrkz Analytics Adapter : initial release (#6225)

* add dev docs for Datawrkz Analytics

* docs: fix code block formatting in datawrkz analytics example

* docs: fix code block formatting in datawrkz analytics example

* docs(analytics): add publisherId and apiKey options for Datawrkz Analytics Adapter

* docs(analytics): wrap support email in mailto link to fix no-bare-urls lint error

---------

Co-authored-by: Likhith <likhith@datawrkz.com>
---
 dev-docs/analytics/datawrkz.md | 43 ++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 dev-docs/analytics/datawrkz.md

diff --git a/dev-docs/analytics/datawrkz.md b/dev-docs/analytics/datawrkz.md
new file mode 100644
index 0000000000..ec41022323
--- /dev/null
+++ b/dev-docs/analytics/datawrkz.md
@@ -0,0 +1,43 @@
+---
+layout: analytics
+title: Datawrkz
+description: Datawrkz Analytics Adapter
+modulecode: datawrkzanalytics
+prebid_member: false
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+gvl_id: none
+enable_download: true
+---
+
+#### Registration
+
+Using this adapter requires a **Publisher ID** and an **API Key**, issued by the Datawrkz team.  
+Please contact [pubops@datawrkz.com](mailto:pubops@datawrkz.com) to create your account and obtain credentials.
+
+#### About
+
+This analytics adapter captures auction and render data from Prebid events and sends it to the Datawrkz API endpoint. The analytics for the  collected data can be accessed at [yieldopt.highr.ai](https://yieldopt.highr.ai/).
+
+#### Integration
+
+To incorporate this module into your `prebid.js`, compile the module using the following command:
+
+```sh
+gulp build --modules=datawrkzAnalyticsAdapter,<other modules...>
+```
+
+#### Page Configuration
+
+```js
+pbjs.que.push(function () {
+  pbjs.enableAnalytics([{
+    provider: 'datawrkzanalytics',
+    options: {
+      publisherId: 'YOUR_PUBLISHER_ID',
+      apiKey: 'YOUR_API_KEY'
+    }
+  }]);
+});
+```

From b6d3f3e69aa04a0950bcb841f14f8bf25b1ddae6 Mon Sep 17 00:00:00 2001
From: Simon Aebli <simon.aebli@goldbach.com>
Date: Fri, 7 Nov 2025 10:42:03 +0100
Subject: [PATCH 397/665] add goldbach prebid server adapter (#6198)

---
 dev-docs/bidders/goldbach.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/goldbach.md b/dev-docs/bidders/goldbach.md
index 99aa9d3307..d98bbecebe 100644
--- a/dev-docs/bidders/goldbach.md
+++ b/dev-docs/bidders/goldbach.md
@@ -18,7 +18,7 @@ deals_supported: true
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbs: false
+pbs: true
 prebid_member: false
 multiformat_supported: will-bid-on-any
 ortb_blocking_supported: false
@@ -33,7 +33,8 @@ The Goldbach bidding adapter requires an individualized `'publisherId'` and appr
 
 {: .table .table-bordered .table-striped }
 
-| Name          | Scope    | Description              | Example                   | Type      |
-|---------------|----------|--------------------------|---------------------------|-----------|
-| `publisherId` | required | Publisher Environment ID | `example.com_de_ios`      | `string`  |
-| `slotId`      | required | Slot Id                  | `1234/slot/id/news`       | `string`  |
+| Name              | Scope    | Description                 | Example                                              | Type     |
+| ----------------- | -------- | --------------------------- | ---------------------------------------------------- | -------- |
+| `publisherId`     | required | Publisher Environment ID    | `example.com_de_ios`                                 | `string` |
+| `slotId`          | required | Slot Id                     | `1234/slot/id/news`                                  | `string` |
+| `customTargeting` | optional | Custom Targeting Parameters | `{"key_1": "value1", "key_2": ["value2", "value3"]}` | `object` |

From a4c0c3c01a6c05037c2008daa8fc9da7da2d41ab Mon Sep 17 00:00:00 2001
From: mkdefinemedia <m.klumpp@definemedia.de>
Date: Fri, 7 Nov 2025 10:42:33 +0100
Subject: [PATCH 398/665] Update definemedia.md (#6187)

* Update definemedia.md

we just made a pull request for our pbjs adapter. updated definemedia.md

* update definemedia adapter docs (#6187)

* Update dev-docs/bidders/definemedia.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 dev-docs/bidders/definemedia.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/dev-docs/bidders/definemedia.md b/dev-docs/bidders/definemedia.md
index ca38797ff8..57a8d1cb1d 100644
--- a/dev-docs/bidders/definemedia.md
+++ b/dev-docs/bidders/definemedia.md
@@ -5,21 +5,24 @@ description: Prebid DEFINE MEDIA Bidder Adapter
 biddercode: definemedia
 tcfeu_supported: true
 gvl_id: 440
-media_types: banner, native
-pbjs: false
+media_types: banner
+safeframes_ok: true
+deals_supported: false
+pbjs: true
 pbs: true
 pbs_app_supported: false
 prebid_member: false
+sidebarType: 1
 ---
 
 ### Registration
 
-Please reach out to our account management team to get started. Contact information is available under [a link](https://definemedia.de).
+Please reach out to our account management team to get started. Contact information is available under [definemedia.de](https://definemedia.de).
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description  | Example   | Type     |
-|---------------|----------|--------------|-----------|----------|
-| `mandantId` | required | Mandant ID   | `5`       | `integer`|
-| `adslotId`    | optional | Adslot ID    | `199`     | `integer`|
+| Name | Scope | Type    | Description                                                                                                                                                  | Example
+| ---- | ----- |---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| -------
+| `supplierDomainName` | required | String  | The domain name of the last supplier in the chain. Under this domain a sellers.json must be available under https://${supplierDomainName}/sellers.json       | definemedia.de
+| `devMode` | optional | boolean | This parameter enables our development endpoint instead of the production endpoint. All requests done with this parameter set to "true" are *NOT* billable | true

From 25b47c0fd53663c56a974a44acc8c3f83784c8fa Mon Sep 17 00:00:00 2001
From: AdsInteractive <marton.vargha@adsinteractive.hu>
Date: Fri, 7 Nov 2025 11:43:14 +0200
Subject: [PATCH 399/665] AdsInteractive Adapter: Make old adapter as alias for
 current, update params (#6076)

* add new adapter ads_interactive

* fix name + upd

* upd

* make adsinteractive alias of ads_interactive adapter, update ads_interactive params

* Add alias code

---------

Co-authored-by: AdsInteractive <>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/ads_interactive.md |  9 ++---
 dev-docs/bidders/adsinteractive.md  | 53 +++++++++++++++--------------
 2 files changed, 33 insertions(+), 29 deletions(-)

diff --git a/dev-docs/bidders/ads_interactive.md b/dev-docs/bidders/ads_interactive.md
index 9f2d5b137e..4733144512 100644
--- a/dev-docs/bidders/ads_interactive.md
+++ b/dev-docs/bidders/ads_interactive.md
@@ -27,10 +27,11 @@ sidebarType: 1
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description  | Example                         | Type       |
-|---------------|----------|--------------|---------------------------------|------------|
-| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
-| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+| Name          | Scope    | Description         | Example                      | Type       |
+|---------------|----------|---------------------|------------------------------|------------|
+| `placementId` | optional | Placement Id        | `'0'`                        | `'string'` |
+| `endpointId`  | optional | Endpoint Id         | `'0'`                        | `'string'` |
+| `adUnit`      | optional | (deprecated) adUnit | `'example_adunit_1'`         | `'string'`   |
 
 ### Note
 
diff --git a/dev-docs/bidders/adsinteractive.md b/dev-docs/bidders/adsinteractive.md
index 55c4844d84..d2deff6b33 100644
--- a/dev-docs/bidders/adsinteractive.md
+++ b/dev-docs/bidders/adsinteractive.md
@@ -1,36 +1,39 @@
 ---
 layout: bidder
-title: AdsInteractive
-description: Prebid AdsInteractive Bidder Adapter
+title: Ads Interactive
+description: Prebid Ads Interactive Bidder Adapter
+aliasCode: ads_interactive
 biddercode: adsinteractive
-media_types: banner
-pbjs: true
-pbs: true
-deals_supported: false
-gpp_supported: true
-tcfeu_supported: true
+gpp_sids: usstate_all
 gvl_id: 1212
-usp_supported: false
-coppa_supported: false
-userIds: all
-schain_supported: false
-dchain_supported: false
-safeframes_ok: false
-floors_supported: false
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
 fpd_supported: false
-pbs_app_supported: false
-prebid_member: true
-multiformat_supported: will-not-bid
 ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+prebid_member: true
+sidebarType: 1
 ---
 
-### Registration
-
-The AdsInteractive adapter requires setup and approval. Please reach out to <it@adsinteractive.com> to setup your account.
-
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description  | Example   | Type     |
-|---------------|----------|--------------|-----------|----------|
-| `adUnit` | required | adUnit tag name | `'example_adunit_1'` | `string` |
+| Name          | Scope    | Description         | Example                      | Type       |
+|---------------|----------|---------------------|------------------------------|------------|
+| `placementId` | optional | Placement Id        | `'0'`                        | `'string'` |
+| `endpointId`  | optional | Endpoint Id         | `'0'`                        | `'string'` |
+| `adUnit`      | optional | (deprecated) adUnit | `'example_adunit_1'`         | `'string'`   |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId.

From b2bdfabd850814efa523dc33dc46f8dd8bc757a0 Mon Sep 17 00:00:00 2001
From: bidfuse <github@bidfuse.com>
Date: Fri, 7 Nov 2025 11:43:30 +0200
Subject: [PATCH 400/665] init new adapter Bidfuse (#6221)

* init new adapter Bidfuse

* tiny update

* changed biddername w/o prefix

* param update in md

* add pbs support

* Set pbs flag to false

* Add empty line in the end

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/bidfuse.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/bidfuse.md

diff --git a/dev-docs/bidders/bidfuse.md b/dev-docs/bidders/bidfuse.md
new file mode 100644
index 0000000000..578ccb3e55
--- /dev/null
+++ b/dev-docs/bidders/bidfuse.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: Bidfuse
+description: Prebid Bidfuse Bidder Adapter
+biddercode: bidfuse
+gpp_sids: usstate_all
+gvl_id: 1466
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId.

From 8ecca7df4489a62304464ae91b7be5a77bf9daba Mon Sep 17 00:00:00 2001
From: bTimor <btimor.dev@gmail.com>
Date: Mon, 10 Nov 2025 11:13:19 +0200
Subject: [PATCH 401/665] remove gpp suported flag (#6331)

Co-authored-by: Timor Bibi <timor@Timors-MacBook-Pro-2.local>
---
 dev-docs/bidders/scalibur.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md
index f4127f654d..85623a597d 100644
--- a/dev-docs/bidders/scalibur.md
+++ b/dev-docs/bidders/scalibur.md
@@ -5,7 +5,6 @@ description: Prebid Scalibur Bidder Adapter
 biddercode: scalibur
 gvl_id: 1471
 media_types: banner, video
-gpp_supported: true
 gpp_sids: tcfeu, usstate_all, usp
 coppa_supported: true
 schain_supported: true

From f66c4bf87349bab7b19c27bf536628030faf2eed Mon Sep 17 00:00:00 2001
From: Scott Kolb <scott.kolb@gmail.com>
Date: Mon, 10 Nov 2025 11:39:17 -0500
Subject: [PATCH 402/665] fix typo on setConfig docs (#6332)

---
 dev-docs/publisher-api-reference/setConfig.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index dfc0f2a5aa..2e9c9916eb 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -803,8 +803,7 @@ The targeting key names and the associated prefix value filtered by `allowTarget
 | CACHE_ID | `hb_cache_id` | yes | Network cache ID for AMP or Mobile |
 | CACHE_HOST | `hb_cache_host` | yes | |
 | ADOMAIN | `hb_adomain` | no | Set to bid.meta.advertiserDomains[0]. Use cases: report on VAST errors, set floors on certain buyers, monitor volume from a buyer, track down bad creatives. |
-| ACAT | `hb_acat` | no | Set to bid.meta.primaryCatId. Optional category targeting key that can be sent to ad servers that stores the value of the Primary IAB category ID if present. Use cases: category exclusion with an ad server order or programmatic direct deal on another ad slot (good for contextual targeting and/or brand
-safety/suitability). |
+| ACAT | `hb_acat` | no | Set to bid.meta.primaryCatId. Optional category targeting key that can be sent to ad servers that stores the value of the Primary IAB category ID if present. Use cases: category exclusion with an ad server order or programmatic direct deal on another ad slot (good for contextual targeting and/or brand safety/suitability). |
 | CRID | `hb_crid` | no | Set to bid.creativeId. Use cases: report on VAST errors, track down bad creatives. |
 | DSP | `hb_dsp` | no | Set to bid.meta.networkName, falling back to bid.meta.networkId. Optional targeting key identifying the DSP or seat |
 | title | `hb_native_title` | yes | |

From 6177d48cd14adbae424c19f7c760a8cc387ad682 Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.tv>
Date: Mon, 10 Nov 2025 11:39:37 -0500
Subject: [PATCH 403/665] Fwssp:update key value description  (#6297)

* Fwssp:update kv doc

* fix markdown lint error

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/fwssp.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index 9bace4af4d..7b3f2aa0c9 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -40,7 +40,7 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `bidfloorcur` | optional | Bid floor currency | "USD" | `string` |
 | `flags` | optional | Optional flags to include in the ad request | '+play-uapl' | `string` |
 | `mode` | optional | Request mode. Valid values are: “on-demand", "live". Default: "on-demand" | "live" | `string` |
-| `adRequestKeyValues` | optional | An object of ad request key-value pairs. | { \_fw_player_width: '1920', \_fw_player_height: '1080' } | `object` |
+| `adRequestKeyValues` | optional | An object of ad request key-value pairs. For a full list of supported key value pairs , please refer to [https://hub.freewheel.tv/display/MUG/HTTP+GET+Ad+Request+-+Key+Values] | { \_fw_player_width: '1920', \_fw_player_height: '1080' } | `object` |
 | `gdpr_consented_providers` | optional | List of Consented Providers. A comma-separated list of ids. | "216,229,80,359,479" | `string` |
 | `tpos` | optional | Slot time position in seconds. Default: 0 | 10 | `number` |
 | `slid` | optional | Slot custom ID. Any string with valid letters/digits/symbols. Default: "Preroll_1" | "CustomPreroll" | `string` |

From 16bda94aa72ad9a71f6d7d35d40304f231f853de Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Mon, 10 Nov 2025 17:41:31 +0100
Subject: [PATCH 404/665] bidResponseFilter: extend with mediaTypes (#6330)

* bidResponseFilter: extend with mediaTypes

* lint

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/bidResponseFilter.md | 40 +++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/dev-docs/modules/bidResponseFilter.md b/dev-docs/modules/bidResponseFilter.md
index 85f753c272..2330ead05a 100644
--- a/dev-docs/modules/bidResponseFilter.md
+++ b/dev-docs/modules/bidResponseFilter.md
@@ -23,6 +23,7 @@ Fields that can be configured:
 - `cat` - Banned categories ids
 - `adv` - Banned advertiser domains
 - `attr` - Banned attributes
+- `mediaTypes` - Banned bids of mediaTypes not present on adUnit
 
 ### Field configuration object 
 
@@ -46,7 +47,46 @@ Fields that can be configured:
             attr: { 
                enforce: false, 
                blockUnknown: false
+            },
+            mediaTypes: {
+                enforce: true,
+                blockUnknown: true
             }
         }
     });
 ```
+
+### Media types configuration
+
+The new `mediaTypes` parameter allows you to block bids whose mediaType does not match any of the media types declared at the ad unit level.
+
+### Disabling In-Banner video
+
+To block bids containing In-Banner Video creatives [IAB Creative Attributes 6 and 7, as defined in the AdCOM 1.0 specification](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list_creativeattributes), configure the Bid Response Filter module to reject these responses.
+
+Restrict the ad unit to banner only and declare disallowed creative attributes (battr) directly in the ad unit definition:
+
+```javascript
+const adUnit = {
+  code: 'banner-adunit',
+  mediaTypes: {
+    banner: {
+      battr: [6, 7] // Block In-Banner Video creative attributes
+    }
+  },
+  bids: [ /* bidder configs */ ]
+};
+```
+
+Enable both the attr and mediaTypes filters in the bidResponseFilter configuration:
+
+```javascript
+pbjs.setConfig({
+  bidResponseFilter: {
+    attr: { enforce: true },
+    mediaTypes: {
+      banner: { enforce: true }
+    }
+  }
+});
+```

From 531f481f95db828548d01fc1c837f3c4e2aac817 Mon Sep 17 00:00:00 2001
From: patryk-grzegorczyk
 <131142828+patryk-grzegorczyk@users.noreply.github.com>
Date: Thu, 13 Nov 2025 11:21:56 +0100
Subject: [PATCH 405/665] New adapter: AdOcean (#6286)

* [ADO-981] AdOcean docs

* [ADO-981] Added more information to the documentation

* [ADO-981] Documentation fix

* [ADO-981] User ids
---
 dev-docs/bidders/adocean.md | 41 +++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/adocean.md

diff --git a/dev-docs/bidders/adocean.md b/dev-docs/bidders/adocean.md
new file mode 100644
index 0000000000..483520cb8b
--- /dev/null
+++ b/dev-docs/bidders/adocean.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: AdOcean
+description: Prebid AdOcean Bidder Adaptor
+biddercode: adocean
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 328
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+userId: gemiusId
+userIds: gemiusId
+media_types: banner, video
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+If you have any issues with setting up the AdOcean bidder, please contact with your local Technical Support team or by visiting [AdOcean website](https://adocean-global.com/en/contact/).
+
+### Prebid.JS Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description       | Example                                            | Type     |
+|----------|----------|-------------------|----------------------------------------------------|----------|
+| slaveId  | required | slave ID          | `'adoceanmyaotcpiltmmnj'`                          | `string` |
+| masterId | required | master ID         | `'ek1AWtSWh3BOa_x2P1vlMQ_uXXJpJcbhsHAY5PFQjWD.D7'` | `string` |
+| emitter  | required | traffic source id | `'myao.adocean.pl'`                                | `string` |

From a140195c261d209b49ed3db89a33604b5e9420bc Mon Sep 17 00:00:00 2001
From: pratik-chavan-advertising-dot-com <pchavan@advertising.com>
Date: Thu, 13 Nov 2025 05:22:44 -0500
Subject: [PATCH 406/665] Add a note for advertising.com adapter to avoid
 v10.7.0 to v10.11.0 since the adapter is broken in these versions due to a
 core change to bidId (#6334)

---
 dev-docs/bidders/advertising.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/advertising.md b/dev-docs/bidders/advertising.md
index 4cd85c2b47..f704afaa9c 100644
--- a/dev-docs/bidders/advertising.md
+++ b/dev-docs/bidders/advertising.md
@@ -23,6 +23,7 @@ multiformat_supported: will-bid-on-any
 prebid_member: false
 gvl_id: none
 sidebarType: 1
+pbjs_version_notes: please avoid using versions from 10.7.0 to 10.11.0
 ---
 
 ### Note

From 259169161ba290ad91551d2b052e7c5fe6b88078 Mon Sep 17 00:00:00 2001
From: Olivier <osazos@adagio.io>
Date: Thu, 13 Nov 2025 11:25:30 +0100
Subject: [PATCH 407/665] Adagio: bid adapter supports endpoint_compression
 (#6328)

---
 dev-docs/bidders/adagio.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index 83146ef51a..6cb68379ea 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -23,6 +23,7 @@ safeframes_ok: true
 dchain_supported: false
 deals_supported: false
 ortb_blocking_supported: false
+endpoint_compression: true
 sidebarType: 1
 ---
 

From 24ebb2012c69883e4e60fe9f371ad3b2a4eef11e Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Fri, 14 Nov 2025 03:39:49 -0500
Subject: [PATCH 408/665] Document analytics labels for enrichment module
 (#6337)

---
 ...integrate-with-the-prebid-analytics-api.md | 22 +++++++++++++++++++
 dev-docs/modules/enrichmentLiftMeasurement.md | 13 ++++++++++-
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/dev-docs/integrate-with-the-prebid-analytics-api.md b/dev-docs/integrate-with-the-prebid-analytics-api.md
index b073000889..8ffd290317 100644
--- a/dev-docs/integrate-with-the-prebid-analytics-api.md
+++ b/dev-docs/integrate-with-the-prebid-analytics-api.md
@@ -37,6 +37,28 @@ For instructions on integrating an analytics provider, see the next section.
 
 ![Prebid Analytics Architecture Diagram]({{ site.baseurl }}/assets/images/prebid-analytics-architecture.png){: .pb-md-img :}
 
+## Analytics Labels
+
+Prebid events can carry an object of **analytics labels** that annotate the payload with experiment, rollout, or troubleshooting context. Labels are available to every analytics adapter in two places:
+
+* as a top-level `labels` object that combines every active label
+* as `args.analyticsLabels` inside the event payload so adapters that only inspect the args can still read them
+
+Publishers can declare their own labels with standard configuration:
+
+```javascript
+pbjs.setConfig({
+  analyticsLabels: {
+    experiment_1: 'group_a',
+    releaseTrain: 'B'
+  }
+});
+```
+
+Modules can also contribute labels by calling `setLabels` from `AnalyticsAdapter`. One example is the [Enrichment Lift Measurement Module](/dev-docs/modules/enrichmentLiftMeasurement.html), which attaches the active A/B test configuration so analytics adapters can report on each test run. All labels defined by publishers or modules are merged together before being delivered to analytics adapters.
+
+Analytics adapters that want to use this metadata simply read either `event.labels` or `event.args.analyticsLabels` in their `track` implementation.
+
 ## Creating an Analytics Module
 
 Working with any Prebid project requires using Github. In general, we recommend the same basic workflow for any project:
diff --git a/dev-docs/modules/enrichmentLiftMeasurement.md b/dev-docs/modules/enrichmentLiftMeasurement.md
index f43df57495..f41e9f3828 100644
--- a/dev-docs/modules/enrichmentLiftMeasurement.md
+++ b/dev-docs/modules/enrichmentLiftMeasurement.md
@@ -56,7 +56,7 @@ pbjs.setConfig({
 });
 ```
 
-The following object will be attached to analytics labels based on the configuration above:
+The following object will be attached to [analytics labels](/dev-docs/integrate-with-the-prebid-analytics-api.html#analytics-labels) based on the configuration above:
 
 ```javascript
 {
@@ -65,3 +65,14 @@ The following object will be attached to analytics labels based on the configura
     { name: '33acrossIdSystem', percentage: 0.5, enabled: false } // May be true or false depending on random selection
   ]
 }
+```
+
+### Analytics Labels
+
+The module adds one analytics label whose key matches the configured `testRun` value. The value is an array that lists every User ID submodule participating in the experiment along with its configured percentage and whether it was enabled for the current page view. Analytics adapters can use that label to segment reporting by experiment group.
+
+- `name`: The User ID submodule name.
+- `percentage`: The configured rollout percentage, which is useful for validating traffic splits.
+- `enabled`: Indicates whether the submodule ran for the current user; this is the randomized value that identifies the treatment/control groups.
+
+See the [Analytics labels](/dev-docs/integrate-with-the-prebid-analytics-api.html#analytics-labels) section for guidance on how analytics adapters consume this metadata.

From 33bef66de1be8dd9e087e34dc4558d47dd54fec8 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 14 Nov 2025 16:17:18 -0500
Subject: [PATCH 409/665] Fix download page not removing modules it says it's
 removing (#6340)

---
 assets/js/download.js | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/assets/js/download.js b/assets/js/download.js
index 86e9175532..effccb0051 100644
--- a/assets/js/download.js
+++ b/assets/js/download.js
@@ -86,6 +86,8 @@
         $('#download-button').html('<i class="glyphicon glyphicon-send"></i> Sending Request...').addClass('disabled');
 
         var form_data = get_form_data();
+        const removedModules = form_data.removedModules;
+        delete form_data.removedModules;
         $.ajax({
             type: "POST",
             url: "https://js-download.prebid.org/download",
@@ -112,12 +114,12 @@
             triggerDownload(jsBlob, filename);
             triggerDownload(new Blob([configData], { type: "application/json" }), "prebid-config.json");
 
-            if (form_data["removedModules"].length > 0) {
+            if (removedModules.length > 0) {
                 alert(
                     "The following modules were removed from your download because they aren't present in Prebid.js version " +
                     form_data["version"] +
                     ": " +
-                    JSON.stringify(form_data["removedModules"])
+                    JSON.stringify(removedModules)
                 );
             }
         })
@@ -179,7 +181,7 @@
             });
 
         return {
-            modules: renameModules(version, modules),
+            modules: renameModules(version, modules).filter(mod => !removedModules.includes(mod)),
             version,
             removedModules,
         };

From 7177d236be215ab5b0e7ac7c8b15db4abd33f5c3 Mon Sep 17 00:00:00 2001
From: sebastienrufiange <131205907+sebastienrufiange@users.noreply.github.com>
Date: Tue, 18 Nov 2025 11:24:52 -0500
Subject: [PATCH 410/665] Contxtful: Documentation update (#6313)

* doc: update contxtful

* doc: revised

* fix: multiformat

* fix: rtd html links

* Apply suggestions from code review

Relative links

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: rufiange <sebastien@rufiange.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/contxtful.md | 55 +++++++++++++++++++++++++++++------
 1 file changed, 46 insertions(+), 9 deletions(-)

diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md
index 930b1f1d75..550cdb02f6 100644
--- a/dev-docs/bidders/contxtful.md
+++ b/dev-docs/bidders/contxtful.md
@@ -16,7 +16,7 @@ pbjs: true
 pbs: true
 pbs_app_supported: false
 prebid_member: true
-multiformar_supported: will-bid-on-any
+multiformat_supported: will-bid-on-any
 ortb_blocking_supported: true
 ---
 
@@ -32,13 +32,50 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf
 | `placementId`      | required | The placement identifier                                          | `'p12345678'` | `string`             |
 | `customerId`      | required | The customer identifier              | `'DEMO123456'`       | `string`           |
 
-### Configuration
+### Configuration - Prebid.js Adapter
+
+n.b. It is strongly recommended that you use the bid adapter in conjunction with the contxtful RTD provider module.
+
+see: [contxtfulRtdProvider](/dev-docs/modules/contxtfulRtdProvider)
 
 ```javascript
 pbjs.setConfig({
    "contxtful":{
       "version":"v1",
-      "customer":"<<CUSTOMER_ID_HERE>>"
+      "customer":"<CUSTOMER_ID_HERE>"
+   },
+   "realTimeData":{
+      "dataProviders":[
+         {
+            "name":"contxtful",
+            "waitForIt":true,
+            "params":{
+               "version":"v1",
+               "customer":"<CUSTOMER_ID_HERE>",
+               "bidders":[
+                  "contxtful",
+                  "<ALL_BIDDER_CODES>"
+               ],
+               "adServerTargeting":true
+            }
+         }
+      ]
+   }
+}
+);
+```
+
+### Configuration - Prebid Server Adapter
+
+n.b. It is strongly recommended that you use the bid adapter in conjunction with the contxtful RTD provider module.
+
+see: [contxtfulRtdProvider](/dev-docs/modules/contxtfulRtdProvider)
+
+```javascript
+pbjs.setConfig({
+   "s2sConfig":{
+      "bidders": ["contxtful", "<ALL_S2S_BIDDERS>"],
+      "<ALL_OTHER_STANDARD_KEY_VALUES>"
    },
    "realTimeData":{
       "dataProviders":[
@@ -47,9 +84,9 @@ pbjs.setConfig({
             "waitForIt":true,
             "params":{
                "version":"v1",
-               "customer":"<<CUSTOMER_ID_HERE>>",
+               "customer":"<CUSTOMER_ID_HERE>",
                "bidders":[
-                  "contxtful"
+                  "<ALL_PAGE_BIDDER_CODES_INCLUDING_S2S>"
                ],
                "adServerTargeting":true
             }
@@ -76,18 +113,18 @@ AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*`
  var adUnitList = [
   {
     code: 'AD_UNIT_NAME_HERE',
-    mediaTypes: { /* "<< ENTER_FORMAT_HERE >> */ },
+    mediaTypes: { /* "<ENTER_FORMAT_HERE> */ },
     bids: [{
       bidder: 'contxtful',
       params: {
-        placementId: "<<PLACEMENT_ID_HERE>>",
-        customerId: "<<CUSTOMER_ID_HERE>>"
+        placementId: "<PLACEMENT_ID_HERE>",
+        customerId: "<CUSTOMER_ID_HERE>"
       }
     }],
     ortb2Imp: {
       ext: {
         data: {
-          divId: "<<EACH_AD_UNIT_DIV_ID>>"
+          divId: "<EACH_AD_UNIT_DIV_ID>"
         }
       }
     }

From 0fd5da3115afadcd21b2411cc2356345a94e2d5c Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Tue, 25 Nov 2025 13:35:17 +0200
Subject: [PATCH 411/665] Attekmi: add Amcom alias (#6342)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/amcom.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/amcom.md

diff --git a/dev-docs/bidders/amcom.md b/dev-docs/bidders/amcom.md
new file mode 100644
index 0000000000..5db785a20f
--- /dev/null
+++ b/dev-docs/bidders/amcom.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Amcom
+description: Amcom Bidder Adapter
+biddercode: amcom
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From d7e3c69b6199a4a604f35511aa92e4314f73028e Mon Sep 17 00:00:00 2001
From: Maksym Danylov <146753616+mdanylov-sigma@users.noreply.github.com>
Date: Tue, 25 Nov 2025 16:26:18 +0200
Subject: [PATCH 412/665] Location precision details. (#6351)

---
 .../pbm-api/android/pbm-targeting-android.md  | 19 +++++++++++++++++++
 .../pbm-api/ios/pbm-targeting-ios.md          |  1 +
 2 files changed, 20 insertions(+)

diff --git a/prebid-mobile/pbm-api/android/pbm-targeting-android.md b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
index 3aec4b66fb..e37ef44c9c 100755
--- a/prebid-mobile/pbm-api/android/pbm-targeting-android.md
+++ b/prebid-mobile/pbm-api/android/pbm-targeting-android.md
@@ -795,6 +795,25 @@ Parameters:
 | latitude | required | double | The device latitude. | 40.71 |
 | longitude | required | double | The device longitude. | 74.01 |
 
+### setLocationDecimalPrecision()
+
+Sets the decimal precision for location coordinates (latitude/longitude) in geo-targeting. This helps control the precision of location data sent in ad requests for privacy purposes.
+
+Signature:
+
+```kotlin
+void setLocationDecimalPrecision(Int? precision)
+```
+
+Parameters:
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| precision | optional | integer | Number of decimal places to keep, or null for no limit. Values outside the 0-6 range will be clamped to valid range. Default is `null`| 2 |
+
+Related function: getLocationDecimalPrecision().
+
 ---
 
 ## Arbitrary OpenRTB
diff --git a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
index d7d73fdfe6..451267fa11 100644
--- a/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
+++ b/prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
@@ -541,6 +541,7 @@ Note that several of the properties noted here are also mentioned above for othe
 | subjectToGDPR | discouraged | boolean | ? | Defines whether this request is in-scope for European privacy regulations. See [above](/prebid-mobile/pbm-api/ios/pbm-targeting-ios#gdpr--tcf-eu) for more information. | `true` |
 | gdprConsentString | discouraged | string | both | See the [GDPR settings](/prebid-mobile/pbm-api/ios/pbm-targeting-ios#gdpr--tcf-eu) section above. | |
 | purposeConsents | discouraged | string | both | See the [GDPR settings](/prebid-mobile/pbm-api/ios/pbm-targeting-ios#gdpr--tcf-eu) section above. | |
+| locationPrecision | optional | NSNumber | both | Number of decimal places to use when rounding latitude/longitude for device geolocation. Default is nil. (full precision) | `NSNumber(value: 2)` |
 
 ### Targeting Class Methods
 

From 52251289eed09d86a91c56ca9a20c9f55389169c Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.tv>
Date: Tue, 25 Nov 2025 12:07:55 -0500
Subject: [PATCH 413/665] FreeWheelVIS-VideoAssetId update videoAssetId to
 default to 0 (#6339)

Co-authored-by: Josh Kraskin <jkraskin@freewheel.com>
---
 dev-docs/bidders/fwssp.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/fwssp.md b/dev-docs/bidders/fwssp.md
index 7b3f2aa0c9..d9ce9ac033 100644
--- a/dev-docs/bidders/fwssp.md
+++ b/dev-docs/bidders/fwssp.md
@@ -35,7 +35,7 @@ The following bid params are for use with the Prebid.js bid adapter:
 | `networkId` | required | Network ID | "96749" | `string` |
 | `profile` | required | Profile Name - The value should contain a profile name. and NOT a numeric profile ID. This can either include the network ID prefix or with the profile name alone | "96749:global-js"   | `string`   |
 | `siteSectionId` | required | Custom Site Section tag or numeric Site Section ID | "ss_12345" | `string` |
-| `videoAssetId` | required | Custom content Video Asset ID | "pause_ad_video" | `string` |
+| `videoAssetId` | optional | Custom content Video Asset ID. Default: 0 | "pause_ad_video" | `string` or `number` |
 | `bidfloor` | optional | Bid floor price | 13.2118 | `number` |
 | `bidfloorcur` | optional | Bid floor currency | "USD" | `string` |
 | `flags` | optional | Optional flags to include in the ad request | '+play-uapl' | `string` |

From e46c0444e579f0c899ab2f8b2b6472a989ad41ae Mon Sep 17 00:00:00 2001
From: Screencore Developer <connect@screencore.io>
Date: Tue, 25 Nov 2025 19:11:46 +0200
Subject: [PATCH 414/665] Update screencore.md (#6348)

* enable prebid.js for screencore

* Update screencore.md

Changed placementId from required to optional
Replaced accountId parameter with endpointId

---------

Co-authored-by: Kostiantyn Karchevsky <kostiantyn.karchevsky@teqblaze.com>
---
 dev-docs/bidders/screencore.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/screencore.md b/dev-docs/bidders/screencore.md
index 0a978cf530..4800e35837 100644
--- a/dev-docs/bidders/screencore.md
+++ b/dev-docs/bidders/screencore.md
@@ -32,5 +32,5 @@ Screencore will bid on first impression in request.
 {: .table .table-bordered .table-striped }
 | Name | Scope | Description | Example | Type |
 |---------------|----------|-----------------------|-----------|-----------|
-| `placementId` | required | placement id | `'hash'` | `string` |
-| `accountId` | required | account id | `'id'` | `string` |
+| `placementId` | optional | placement id | `'hash'` | `string` |
+| `endpointId` | optional | endpoint id | `'id'` | `string` |

From ecb172cbc85c991de39ea61c629687f883fc31ca Mon Sep 17 00:00:00 2001
From: ym-aaron <89419575+ym-aaron@users.noreply.github.com>
Date: Thu, 27 Nov 2025 14:15:36 -0800
Subject: [PATCH 415/665]  update documentation (#6354)

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

diff --git a/dev-docs/bidders/yieldmo.md b/dev-docs/bidders/yieldmo.md
index 3b11512b36..e25981c4d5 100644
--- a/dev-docs/bidders/yieldmo.md
+++ b/dev-docs/bidders/yieldmo.md
@@ -40,7 +40,7 @@ The Yieldmo adapter supports in-stream video as of Prebid v4.18. Out-stream will
 | `maxduration`     | required | Maximum ad duration in seconds                         | `20`            | `integer` |
 | `minduration`     | optional | Minimum ad duration in seconds                         | `5`             | `integer` |
 | `pos`             | optional | Ad position on screen; see [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.4 for more details | `1`  | `integer` |
-| `startdelay`      | required for in-stream | Duration offset (in second) from the start of the content for showing the video ad before the start of the Video. Pre-roll: `0` (default); Mid-roll: `>0`; Default mid-roll: `-1`; Post-roll: `-2`; <br/><br/> For out-stream is' always `0`| `5`  | `integer` |
+| `startdelay`      | optional | Start delay of the video ad in seconds. Values follow OpenRTB 2.5 §5.12: `0` = Pre-Roll; `>0` = Mid-Roll (value is the start delay); `-1` = Generic Mid-Roll; `-2` = Generic Post-Roll. | `5`  | `integer` |
 | `protocols`       | required | Supported video bid response protocols. VAST 1.0: `1`; VAST 2.0: `2`; VAST 3.0: `3`; VAST 1.0 Wrapper: `4`; VAST 2.0 Wrapper: `5`; VAST 3.0 Wrapper: `6`; | `[2, 3]`        | `Array<integer>` |
 | `api`             | required | API frameworks supported. VPAID 1.0: `1`; VPAID 2.0: `2`; MRAID-1: `3`; ORMMA: `4`; MRAID-2: `5`; MRAID-3: `6`;                                         | `[1, 2]`        | `Array<integer>` |
 | `playbackmethod`  | required | Playback methods that may be in use; see [OpenRTB 2.5 specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf), List 5.10 for more details. Out-stream is only always `2` | `[2,6]`  | `Array<integer>` |

From 3cf1a0d71ae35abeade46e78d4fd2fff9aa152b7 Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:08:14 +0100
Subject: [PATCH 416/665] New adapter: Performist (#5968)

* new adapter performist.md

* add empty line and false for pbjs

* Update performist.md

fix

* Update performist.md

Modify required fields

* Update performist.md

fix host

* Update performist.md

Host to Optional

* Update performist.md

---------

Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: Alexander Pykhteyev <alex.pykhteyev@gmail.com>
---
 dev-docs/bidders/performist.md | 37 ++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/performist.md

diff --git a/dev-docs/bidders/performist.md b/dev-docs/bidders/performist.md
new file mode 100644
index 0000000000..c15d752b1c
--- /dev/null
+++ b/dev-docs/bidders/performist.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Performist
+description: Prebid Performist Bidder Adaptor
+biddercode: performist
+pbjs: false
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                   | Example                | Type      |
+|:--------------|:---------|:--------------------------------------------------------------|:-----------------------|:----------|
+| `publisherId` | required | Publisher ID                                                  | `'12345'`              | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                      | `'custom1'`            | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                      | `'custom2'`            | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                      | `'custom3'`            | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                      | `'custom4'`            | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                      | `'custom5'`            | `string`  |
+
+Performist server-side Prebid Server adapter requires only `publisherId` and `host` parameters.
+Performist server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.

From f6590113f59d3b3fdbb1e30db47c7b966fe5eb00 Mon Sep 17 00:00:00 2001
From: aaronkoss <aaron.koss@gmail.com>
Date: Thu, 4 Dec 2025 10:12:13 -0600
Subject: [PATCH 417/665] Public Good - new adapter (#6258)

* Public Good new adapter

* add some additional data
---
 dev-docs/bidders/publicgood.md | 36 ++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/publicgood.md

diff --git a/dev-docs/bidders/publicgood.md b/dev-docs/bidders/publicgood.md
new file mode 100644
index 0000000000..d9d5ccf547
--- /dev/null
+++ b/dev-docs/bidders/publicgood.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: Public Good
+description: Public Gppd Bid Adapter
+biddercode: publicgood
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+userId: none
+media_types: banner
+safeframes_ok: true
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+
+| Name        | Scope    | Description                                                                                                  | Example                       | Type          |
+|-------------|----------|--------------------------------------------------------------------------------------------------------------|-------------------------------|---------------|
+| `partnerId` | required | Publisher ID                                                                                                 | `'prebid-test'`               | `string`      |
+| `slotId`    | required | Slot ID = 'all' unless negotiated otherwise                                                                  | `'all'`                       | `string`      |

From 51a15e99146189e6f9cf11be442c9549642db0fa Mon Sep 17 00:00:00 2001
From: softcoder594 <malicvictor5008@gmail.com>
Date: Thu, 4 Dec 2025 17:16:27 +0100
Subject: [PATCH 418/665] optable: Update server-side module configuration
 instructions to reflect the latest changes (#6272)

* optable: Update server-side module configuration instructions to reflect the latest changes

* optable: Update server-side module configuration instructions to reflect the latest changes

---------

Co-authored-by: softcoder594 <softcoder594@gmail.com>
---
 prebid-server/pbs-modules/optable-targeting.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/prebid-server/pbs-modules/optable-targeting.md b/prebid-server/pbs-modules/optable-targeting.md
index e93e15c3a4..7b66e91077 100644
--- a/prebid-server/pbs-modules/optable-targeting.md
+++ b/prebid-server/pbs-modules/optable-targeting.md
@@ -154,6 +154,9 @@ would result in this nesting in the JSON configuration:
 | id-prefix-order    | no       | string  | none           | Account-Level. An optional string of comma separated id prefixes that prioritizes and specifies the order in which ids are provided to Targeting API in a query string. F.e. "c,c1,id5" will guarantee that Targeting API will see id=c:...,c1:...,id5:... if these ids are provided.  id-prefixes not mentioned in this list will be added in arbitrary order after the priority prefix ids. This affects Targeting API processing logic |
 | cache.enabled    | no       | string  | false           | Account-Level. Optionally use [Prebid Cache Storage](https://docs.prebid.org/prebid-server/features/pbs-pbc-storage.html) feature - this significantly reduces the processing time when the Targeting API response has been cached |
 | cache.ttlseconds    | no       | int  | 86400           | Account-Level. The TTL in seconds for the Targeting API response to live in cache - by default is equal to 24 hours |
+| optable-inserter-eids-merge   | no       | array of strings | none  | Account-Level. List of EID source names for which the module should **merge** the incoming server-side EIDs with those returned by the Targeting API. |
+| optable-inserter-eids-replace | no       | array of strings | none  | Account-Level. List of EID source names for which the module should **replace** the incoming EID entirely with the one from the Targeting API. |
+| optable-inserter-eids-ignore | no       | array of strings | none  | Account-Level. List of EID source names for which the module should **remove** the EID entirely. |
 
 ## ID Mapping
 

From 38a6c71dd9bf425af908f6bdb6864faac0b15812 Mon Sep 17 00:00:00 2001
From: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Date: Thu, 4 Dec 2025 18:20:15 +0200
Subject: [PATCH 419/665] IntentIq ID Module: Add new param (#6278)

* fix spelling

* add one more param

* extend GAM prediction documentation, fix param name

* move analytics related parameters to analytics adapter
---
 dev-docs/analytics/intentiq.md                | 36 +++++++++----------
 .../modules/userid-submodules/intentiq.md     | 17 +++------
 2 files changed, 22 insertions(+), 31 deletions(-)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index c44c28ca73..b5ba04fc86 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -17,13 +17,28 @@ No registration for this module is required.
 
 **IMPORTANT**: only effective when Intent IQ Universal ID module be installed and configured. [(How-To)](https://docs.prebid.org/dev-docs/modules/userid-submodules/intentiq.html)
 
-No additional configuration for this module is required. We will use the configuration provided for Intent IQ Universal IQ module.
+### Analytics Options
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| options.manualWinReportEnabled | Optional | Boolean | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `false` |
+| options.reportMethod | Optional | String | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL. | `"GET"` |
+| options.reportingServerAddress | Optional | String | The base URL for the IntentIQ reporting server. If parameter is provided in `configParams`, it will be used. | `"https://domain.com"` |
+| options.adUnitConfig | Optional | Number |  Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId. | `1` |
+| options.gamPredictReporting | Optional | Boolean |  This variable controls whether the GAM prediction logic is enabled or disabled. The main purpose of this logic is to extract information from a rendered GAM slot when no Prebid bidWon event is available. In that case, we take the highest CPM from the current auction and add 0.01 to that value. | `false` |
 
 #### Example Configuration
 
 ```js
 pbjs.enableAnalytics({
-    provider: 'iiqAnalytics'
+    provider: 'iiqAnalytics',
+    options: {
+        manualWinReportEnabled: false,
+        reportMethod: "GET",
+        adUnitConfig: 1,
+        gamPredictReporting: false
+    }
 });
 ```
 
@@ -33,23 +48,6 @@ The reportExternalWin function allows for manual reporting, meaning that reports
 
 To enable this manual reporting functionality, you must set the manualWinReportEnabled parameter in Intent IQ Unified ID module configuration is true. Once enabled, reports can be manually triggered using the reportExternalWin function.
 
-```js
-pbjs.setConfig({
-    userSync: {
-        userIds: [{
-            name: "intentIqId",
-            params: {
-                partner: 123456,     // valid partner id
-                browserBlackList: "chrome",
-                manualWinReportEnabled: true
-            }
-        }]
-    }
-});
-```
-
-You can find more information and configuration examples in the [Intent IQ Universal ID module](https://docs.prebid.org/dev-docs/modules/userid-submodules/intentiq.html#configuration)
-
 ### Calling the reportExternalWin Function
 
 To call the reportExternalWin function, you need to pass the partner_id parameter as shown in the example below:
diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 2ae2bb46ea..8d46ee99f4 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -45,24 +45,20 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.callback                | Optional | Function | This is a callback which is triggered with data                                                                                                                                                                                                                                                                               | `(data) => console.log({ data })` |
 | params.timeoutInMillis         | Optional | Number   | This is the timeout in milliseconds, which defines the maximum duration before the callback is triggered. The default value is 500.                                                                                                                                                                                                       | `450`                                         |
 | params.browserBlackList        | Optional | String   | This is the name of a browser that can be added to a blacklist.                                                                                                                                                                                                                                                                           | `"chrome"`                                    |
-| params.manualWinReportEnabled  | Optional | Boolean  | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `true`                                        |
 | params.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.                     | `"currentDomain.com"`                         |
 | params.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.                                                                                                                                                            | `googletag`                                   |
 | params.gamParameterName        | Optional | String   | The name of the targeting parameter that will be used to pass the group. If not specified, the default value is `intent_iq_group`.                                                                                                                                                                                                        | `"intent_iq_group"`                           |
-| params.adUnitConfig            | Optional | Number   | Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId                                                                                                                                             | `1`                                           |
 | params.sourceMetaData          | Optional | String   | This metadata can be provided by the partner and will be included in the requests URL as a query parameter                                                                                                                                                                                                                                | `"123.123.123.123"`                           |
 | params.sourceMetaDataExternal  | Optional | Number   | This metadata can be provided by the partner and will be included in the requests URL as a query parameter                                                                                                                                                                                                                                | `123456`                                      |
 | params.iiqServerAddress        | Optional | String   | The base URL for the IntentIQ API server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                                    | `"https://domain.com"`                        |
 | params.iiqPixelServerAddress   | Optional | String   | The base URL for the IntentIQ pixel synchronization server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                  | `"https://domain.com"`                        |
-| params.reportingServerAddress  | Optional | String   | The base URL for the IntentIQ reporting server. If parameter is provided in `configParams`, it will be used.                                                                                                                                                                                                                              | `"https://domain.com"`                        |
-| params.reportMethod            | Optional | String   | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL.                                                                                             |`"GET"`                                        |
 | params.siloEnabled             | Optional | Boolean  | Determines if first-party data is stored in a siloed storage key. When set to `true`, first-party data is stored under a modified key that appends `_p_` plus the partner value rather than using the default storage key. The default value is `false`.                                                                          | `true`                                        |
 | params.groupChanged            | Optional | Function | A callback that is triggered every time the user’s A/B group is set or updated.                                                                                         |`(group) => console.log('Group changed:', group)` |
 | params.chTimeout | Optional | Number | Maximum time (in milliseconds) to wait for Client Hints from the browser before sending request. Default value is `10ms` | `30` |
-| params.additionalParameters | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
-| params.additionalParameters [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
-| params.additionalParameters [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
-| params.additionalParameters [0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
+| params.additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
+| params.additionalParams [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
+| params.additionalParams [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
+| params.additionalParams [0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
 
 ### Configuration example
 
@@ -77,16 +73,13 @@ pbjs.setConfig({
                 browserBlackList: "chrome",
                 callback: (data) => {...}, // your logic here
                 groupChanged: (group) => console.log('Group is', group),
-                manualWinReportEnabled: true, // Optional parameter
                 domainName: "currentDomain.com",
                 gamObjectReference: googletag, // Optional parameter
                 gamParameterName: "intent_iq_group", // Optional parameter
-                adUnitConfig: 1, // Extracting placementId strategy (adUnitCode or placementId order of priorities)
                 sourceMetaData: "123.123.123.123", // Optional parameter
                 sourceMetaDataExternal: 123456, // Optional parameter
-                reportMethod: "GET", // Optional parameter
                 chTimeout: 10, // Optional parameter
-                additionalParameters: [ // Optional parameter
+                additionalParams: [ // Optional parameter
                     {
                       parameterName: "abc",
                       parameterValue: 123,

From 6c2e1f355b0c70d3fb6c619bce1dfba33febb46e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bendeg=C3=BAz=20=C3=81cs?=
 <30595431+acsbendi@users.noreply.github.com>
Date: Thu, 4 Dec 2025 17:42:39 +0100
Subject: [PATCH 420/665] Docs for page view ID-related changes. (#6305)

---
 dev-docs/bidder-adaptor.md                    |  4 +++
 dev-docs/modules/pubCommonId.md               |  1 +
 .../refreshPageViewId.md                      | 30 +++++++++++++++++++
 prebid-server/developers/add-new-bidder-go.md |  1 +
 4 files changed, 36 insertions(+)
 create mode 100644 dev-docs/publisher-api-reference/refreshPageViewId.md

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 94a35f59bb..006a2019cb 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -301,6 +301,7 @@ Here is a sample array entry for `validBidRequests[]`:
   bidId: "22c4871113f461",
   bidder: "rubicon",
   bidderRequestId: "15246a574e859f",
+  pageViewId: 'de48e8d1-25e1-487c-96c6-41fcef84b41b',
   bidRequestsCount: 1,
   bidderRequestsCount: 1,
   auctionsCount: 1,
@@ -322,6 +323,7 @@ Other notes:
 * **Bid ID** is unique across ad units and bidders.
 * **auctionId** (see [note](#tid-warning)) is unique per call to `requestBids()`, but is the same across ad units and bidders.
 * **Transaction ID** (see [note](#tid-warning)) is unique for each ad unit within a call to `requestBids()`, but same across bidders. This is the ID that enables DSPs to recognize the same impression coming in from different supply sources.
+* **Page view ID** is unique for a page view (one load of Prebid); can also be refreshed programmatically. Shared across all requests and responses within the page view, for the same bidder. Different bidders see a different page view ID.
 * **Bid Request Count** is the number of times `requestBids()` has been called for this ad unit.
 * **Bidder Request Count** is the number of times `requestBids()` has been called for this ad unit and bidder.
 * **Auctions Count** is the number of times `requestBids()` has been called for this ad unit excluding the duplicates generated by twin adUnits.
@@ -340,6 +342,7 @@ Here is a sample bidderRequest object:
   auctionStart: 1579746300522,
   bidderCode: "myBidderCode",
   bidderRequestId: "15246a574e859f",
+  pageViewId: 'de48e8d1-25e1-487c-96c6-41fcef84b41b',
   bids: [{...}],
   gdprConsent: {consentString: "BOtmiBKOtmiBKABABAENAFAAAAACeAAA", vendorData: {...}, gdprApplies: true},
   ortb2: {...},
@@ -720,6 +723,7 @@ Sample data received by this function:
             auctionStart: 1579746300522,
             bidderCode: "myBidderCode",
             bidderRequestId: "15246a574e859f",
+            pageViewId: 'de48e8d1-25e1-487c-96c6-41fcef84b41b',
             bids: [{...}],
             gdprConsent: {consentString: "BOtmiBKOtmiBKABABAENAFAAAAACeAAA", vendorData: {...}, gdprApplies: true},
             refererInfo: {
diff --git a/dev-docs/modules/pubCommonId.md b/dev-docs/modules/pubCommonId.md
index 461580f3ef..50322e12c0 100644
--- a/dev-docs/modules/pubCommonId.md
+++ b/dev-docs/modules/pubCommonId.md
@@ -83,6 +83,7 @@ Adapters should look for `bid.crumbs.pubcid` in buildRequests() method.
       "sizes":[[300, 250], [300,600]],
       "bidId":"222187f1ef97e6",
       "bidderRequestId":"12088b9bd86f26",
+      "pageViewId": "861a2d06-e70a-4db9-8620-47d3d1f4f301",
       "auctionId":"a1a98ab2-97c9-4f42-970e-6e03040559f2"
    }
 ]
diff --git a/dev-docs/publisher-api-reference/refreshPageViewId.md b/dev-docs/publisher-api-reference/refreshPageViewId.md
new file mode 100644
index 0000000000..a0abf5fdfe
--- /dev/null
+++ b/dev-docs/publisher-api-reference/refreshPageViewId.md
@@ -0,0 +1,30 @@
+---
+layout: api_prebidjs
+title: pbjs.refreshPageViewId
+description:
+sidebarType: 1
+---
+
+Refreshes the previously generated page view ID. Can be used to instruct bidders that use page view ID to consider future auctions as part of a new page load.
+
+```javascript
+// Function to call when the URL changes
+function onUrlChange() {
+    pbjs.refreshPageViewId();
+}
+
+// Function to initialize the URL change listener
+function initUrlChangeListener() {
+    // Listen for changes to the history state
+    window.addEventListener('popstate', onUrlChange);
+
+    // Optionally, you might want to handle the initial load as well
+    onUrlChange();
+}
+
+// Call the function to set up the listener
+initUrlChangeListener();
+
+```
+
+<hr class="full-rule" />
diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md
index b4c708d370..b9593b57ce 100644
--- a/prebid-server/developers/add-new-bidder-go.md
+++ b/prebid-server/developers/add-new-bidder-go.md
@@ -778,6 +778,7 @@ The second argument, `requestInfo`, is for extra information and helper methods
 - `requestInfo.PbsEntryPoint` to access the entry point of the bid request, commonly used to determine if the request is for AMP or for a [Long Form Video Ad Pod](/dev-docs/modules/adpod.html).
 - `requestInfo.GlobalPrivacyControlHeader` to read the value of the `Sec-GPC` Global Privacy Control (GPC) header of the bid request.
 - `requestInfo.ConvertCurrency` a method to perform currency conversions.
+- `requestInfo.PageViewId` is the unique identifier for the page view (one load of Prebid.js); can also be refreshed programmatically. Shared across all requests and responses within the page view, for the same bidder. Different bidders see a different page view ID.
 
 The `MakeRequests` method is expected to return a slice (similar to a C# `List` or a Java `ArrayList`) of `adapters.RequestData` objects representing the HTTP calls to be sent to your bidding server and a slice of type `error` for any issues encountered creating them. If there are no HTTP calls or if there are no errors, please return `nil` for both return values. Please do not add `nil` items in the slices.
 

From a6a60c9a49d08eb96b1b5fb9353388cfec3e7b17 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Thu, 4 Dec 2025 18:24:22 +0100
Subject: [PATCH 421/665] WURFL RTD: zero-latency version update (#6336)

See: https://github.com/prebid/Prebid.js/pull/14115
---
 dev-docs/modules/wurflRtdProvider.md | 204 ++++++++++++++++++++-------
 1 file changed, 156 insertions(+), 48 deletions(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 8668ac5438..b7ea884de6 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -22,87 +22,136 @@ This module loads a dynamically generated JavaScript from prebid.wurflcloud.com
 
 ## Description
 
-The WURFL RTD module enriches the Prebid.js bid request's OpenRTB 2.0 device data with [WURFL device data](https://www.scientiamobile.com/wurfl-js-business-edition-at-the-intersection-of-javascript-and-enterprise/). The module populates the `device` and `device.ext.wurfl` with WURFL device capabilities, ensuring that all bidder adapters have access to enriched device data. At a minimum, three WURFL capabilities are made available to all adapters: `is_mobile`, `complete_device_name` and `form_factor`.
+The WURFL RTD module enriches Prebid.js bid requests with comprehensive device detection data, helping publishers maximize ad revenue through better device targeting. Publishers typically see improved CPM performance, particularly for mobile traffic where device signals provide valuable bidding context.
 
-SSPs and other demand partners subscribed to this service with ScientiaMobile will also receive an expanded set of device properties, including more detailed detection for iOS devices (e.g., specific iPhone and iPad model information). For a comprehensive list of available device capabilities, please refer to the [WURFL device capabilities](https://www.scientiamobile.com/capabilities/?products%5B%5D=wurfl-js) documentation.
+The WURFL RTD module relies on localStorage caching and local client-side detection, providing instant device enrichment on every page load.
 
-## A Note About User-Agent Client Hints
+The module enriches `ortb2.device` with complete device information and adds extended WURFL capabilities to `device.ext.wurfl`, ensuring all bidder adapters have immediate access to enriched device data.
 
-WURFL.js is fully compatible with Chromium's User-Agent Client Hints (UA-CH) device identification mechanisms. If the User-Agent string is generic and Client Hints are not available in the HTTP request, the service will automatically request and obtain [high entropy client hint values](https://wicg.github.io/ua-client-hints/#getHighEntropyValues) from the client.
+### Key Features
 
-However, it is still recommended to explicitly opt-in and declare support for User-Agent Client Hints on the publisher's website. Doing so improves performance and contributes to a faster user experience. For detailed instructions on implementing User-Agent Client Hint support, refer to the [relevant documentation here](https://docs.scientiamobile.com/guides/implementing-useragent-clienthints).
+* **Instant Device Enrichment**: Device data is available immediately without auction delays
+  * First-time visitors: Instant basic device detection using Local Client-side Enrichment (LCE)
+  * Returning visitors: Full WURFL data from localStorage cache
+  * WURFL.js loads asynchronously in the background to refresh cache for future page loads
 
-## Integration Notes
+* **Comprehensive Device Detection**: Enriches `ortb2.device` with complete device information including:
+  * Standard OpenRTB 2.0 device fields: `make`, `model`, `devicetype`, `os`, `osv`, `ppi`, `pxratio`
+  * Full iPhone and iPad model recognition in `ortb2.device.hwv` (e.g., "iPhone 16 Pro", "iPad Pro 12.9-inch")
 
-While the WURFL RTD module enriches the OpenRTB 2.0 payload, it is the responsibility of the SSP's adapter to access and pass the information to the auction endpoint. The auction endpoint must then use the new data to support its business logic.
+* **Bot Detection**: Provides `is_robot` capability in `device.ext.wurfl` for easy bot filtering
+  * Additional `robot_family` capability available in paid tiers to identify specific bot types (Googlebot, Bingbot, etc.)
 
-The following scenarios are possible:
+* **Free Tier Available**: Full WURFL device enrichment for publishers. High-traffic sites and SSPs should contact ScientiaMobile to enable more properties and unlock volume.
 
-{: .table .table-bordered .table-striped }
+### Extended Capability Set
+
+At a minimum, all adapters receive these WURFL capabilities:
+
+* `brand_name`
+* `model_name`
+* `is_ott`
+* `physical_form_factor`
+* `is_console`
+* `resolution_height`
+* `resolution_width`
+* `density_class`
+* `is_full_desktop`
+* `device_os`
+* `device_os_version`
+* `form_factor`
+* `advertised_device_os`
+* `advertised_device_os_version`
+* `pixel_density`
+* `is_robot`
+* `complete_device_name`
+* `is_mobile`
+* `advertised_browser`
+* `advertised_browser_version`
+
+Publishers, SSPs and demand partners with a commercial license can receive up to 500+ additional [WURFL device capabilities](https://www.scientiamobile.com/capabilities/?products%5B%5D=wurfl-js) based on their licensing agreement, including:
+
+* Detailed iOS device models (specific iPhone/iPad variants)
+* Physical device dimensions and screen properties
+* Device pricing and release information
+* Browser and OS version details
+* Bot family identification (paid tier)
+
+### User-Agent Client Hints Support
+
+WURFL.js is fully compatible with Chromium's User-Agent Client Hints (UA-CH). If the User-Agent string is generic and Client Hints are not available, the service automatically requests and obtains [high entropy client hint values](https://wicg.github.io/ua-client-hints/#getHighEntropyValues) from the client.
+
+For optimal performance, publishers should explicitly opt-in and declare User-Agent Client Hints support on their website. See the [UA-CH implementation documentation](https://docs.scientiamobile.com/guides/implementing-useragent-clienthints) for details.
+
+## SSP/DSP Integration (IMPORTANT)
+
+While the WURFL RTD module enriches the OpenRTB 2.0 payload, SSP adapters must access and pass this information to their auction endpoints. The endpoint must then utilize the enriched device data in its bidding logic.
 
-|                           | SSP Adapter   | SSP Server Side End-Point                                        |
-| :------------------------ | :------------ | :--------------------------------------------------------------- |
-| SSP adapter is already passing the ORTB2 device to the server (auction endpoint). | No changes required. | Update backend logic to utilize the device data. |
-| SSP adapter is not currently passing the data to server. | Update adapter to read `device` and/or `device.ext.wurfl` data and pass it to the endpoint. | Update backend logic to utilize the device data. |
-| SSP doesn't have a Bidder Adapter. | Implement PreBid.js adapter and read `device` and/or `device.ext.wurfl` data and pass it to the endpoint. | Update end-point to read and utilize the data. |
+### Integration Scenarios
 
-## Usage
+| SSP Adapter Status | Required Adapter Changes | Required Server Changes |
+|-------------------|--------------------------|-------------------------|
+| Already passing ORTB2 device to server | No changes required | Update backend logic to utilize device data |
+| Not currently passing device data | Update adapter to read `device` and/or `device.ext.wurfl` and pass to endpoint | Update backend logic to utilize device data |
+| No Bidder Adapter exists | Implement Prebid.js adapter to read and pass `device` and/or `device.ext.wurfl` | Implement endpoint logic to read and utilize data |
 
-### Build
+## Building the Module
 
-To build the WURFL RTD module with Prebid.js, use the following command:
+To build the WURFL RTD module with Prebid.js:
 
 ```bash
-gulp build --modules="wurflRtdProvider,appnexusBidAdapter,..."  
+gulp build --modules="wurflRtdProvider,appnexusBidAdapter,..."
 ```
 
-### Configuration
+## Configuration
 
-To initialize the WURFL RTD module in Prebid.js, use the `setConfig` function as shown below. 
-The module is configured within `realTimeData.dataProviders`. 
-Ensure `waitForIt` is set to `true`. We recommend setting `auctionDelay` to `500 ms` initially, 
-though lower values may be suitable with fine-tuning.
+The module is configured within `realTimeData.dataProviders`.
+
+### Basic Configuration
 
 ```javascript
 pbjs.setConfig({
-    realTimeData: {
-        auctionDelay: 500,
-        dataProviders: [{
-            name: 'wurfl',
-            waitForIt: true,
-            params: {
-                debug: false
-            }
-        }]
-    }
+  realTimeData: {
+    dataProviders: [{
+      name: 'wurfl'
+    }]
+  }
 });
 ```
 
-### Parameters
+### Configuration Parameters
 
 {: .table .table-bordered .table-striped }
 
-| Name                      | Type          | Description                                                      | Default               |
-| :------------------------ | :------------ | :--------------------------------------------------------------- |:----------------------|
-| name                      | String        | Real time data module name                                       | Always set to 'wurfl' |
-| waitForIt                 | Boolean       | Set to `true` if an `auctionDelay` is defined (required)         | `false`               |
-| params                    | Object        | Configuration parameters for the WURFL RTD module.               |                       |
-| params.altHost            | String        | Alternate host for connecting to WURFL.js                        |                       |
-| params.debug              | Boolean       | Enable debug mode.                                               | `false`               |
+| Name | Type | Description | Default |
+|------|------|-------------|---------|
+| `name` | String | Real time data module name | Always 'wurfl' |
+| `waitForIt` | Boolean | Should be set to true for proper initialization | `false` |
+| `params` | Object | Configuration parameters for WURFL RTD | |
+| `params.altHost` | String | Alternate host for connecting to WURFL.js | |
+| `params.debug` | Boolean | Enable debug mode for troubleshooting | `false` |
+| `params.abTest` | Object | A/B testing configuration (optional) | |
+| `params.abTest.enabled` | Boolean | Enable A/B testing | `false` |
+| `params.abTest.testName` | String | Name identifier for the test | |
+| `params.abTest.splitRatio` | Number | Ratio for treatment group (0.0-1.0) | `0.5` |
 
-## Testing 
+## Testing
 
-To test how the WURFL RTD module works, run the following command:
+To test the WURFL RTD module locally:
 
-`gulp serve --modules=wurflRtdProvider,appnexusBidAdapter`
+```bash
+gulp serve --modules=wurflRtdProvider,appnexusBidAdapter
+```
 
-Then, point your browser to:
+Then navigate to:
 
-`http://localhost:9999/integrationExamples/gpt/wurflRtdProvider_example.html`
+```sh
+http://localhost:9999/integrationExamples/gpt/wurflRtdProvider_example.html
+```
 
-## Expected Behavior
+## Example Enriched Bid Request
 
-WURFL RTD adds device information to the bidderRequest's `ortb2.device.ext.wurfl` object (enabled SSPs have access to an extended capability set).
+WURFL RTD adds comprehensive device information to the bid request. The `ortb2.device` object is enriched with standard OpenRTB fields, and `device.ext.wurfl` contains extended WURFL capabilities:
 
 ```json
 {
@@ -164,3 +213,62 @@ WURFL RTD adds device information to the bidderRequest's `ortb2.device.ext.wurfl
   }
 }
 ```
+
+### Extended Capabilities in `device.ext.wurfl`
+
+Licensed SSPs can receive up to 500+ additional capabilities based on their subscription, including:
+
+**Device Identification:**
+
+* `wurfl_id`: Unique WURFL device identifier
+* `complete_device_name`: Full commercial device name
+* `brand_name`: Device brand
+* `model_name`: Device model
+* `marketing_name`: Commercial marketing name
+
+**Form Factor Detection:**
+
+* `form_factor`: Device category (Smartphone, Tablet, Desktop, etc.)
+* `is_mobile`, `is_smartphone`, `is_tablet`: Boolean form factor flags
+* `is_full_desktop`, `is_connected_tv`, `is_smarttv`: Additional form factors
+
+**Bot Detection:**
+
+* `is_robot` (Boolean): Available to all publishers - simple true/false bot identification
+* `robot_family` (Categorical): Paid tier feature - identifies specific bot types (Spider, Previewer, Fetcher, Health-Checker, Adbot, Headless Browser) for granular filtering and analytics
+
+**Browser & OS:**
+
+* `advertised_browser`, `advertised_browser_version`
+* `advertised_device_os`, `advertised_device_os_version`
+
+**Physical Properties:**
+
+* `physical_screen_height`, `physical_screen_width`: Physical dimensions in mm
+* `resolution_height`, `resolution_width`: Screen resolution in pixels
+* `pixel_density`: Pixels per inch
+* `pointing_method`: Input method (touchscreen, stylus, mouse, etc.)
+
+For a complete list of available capabilities, see [WURFL Capabilities Documentation](https://www.scientiamobile.com/capabilities/?products%5B%5D=wurfl-js).
+
+## A/B Testing with ScientiaMobile
+
+The WURFL RTD module includes built-in A/B testing capabilities to help publishers measure the impact of device enrichment on their revenue. When enabled, the module randomly assigns users to treatment (enriched) or control (not enriched) groups.
+
+ScientiaMobile can assist with setting up and analyzing A/B tests to quantify the value of WURFL enrichment for your specific inventory. Contact [ScientiaMobile](https://www.scientiamobile.com/contact/) to discuss A/B testing collaboration.
+
+## Getting Started
+
+1. **Build** Prebid.js with the WURFL RTD module
+2. **Configure** the module in your Prebid.js setup
+3. **Test** locally to verify enrichment
+
+## Privacy & Compliance
+
+The WURFL RTD module processes minimal personal data under legitimate interest for technical service delivery:
+
+* Device detection uses only HTTP headers (User-Agent, Client Hints)
+* No user tracking or cross-site identification
+* IP addresses processed transiently for service delivery only
+
+For questions or support, visit [ScientiaMobile Support](https://support.scientiamobile.com).

From 8e4be5e4d5b45b8b1e8f5d5e68b51c62a6167078 Mon Sep 17 00:00:00 2001
From: topOnFens <118327552+topOnFens@users.noreply.github.com>
Date: Fri, 5 Dec 2025 03:16:35 +0800
Subject: [PATCH 422/665] Add TopOn adapter (#6311)

---
 dev-docs/bidders/topon.md | 72 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 dev-docs/bidders/topon.md

diff --git a/dev-docs/bidders/topon.md b/dev-docs/bidders/topon.md
new file mode 100644
index 0000000000..82a0b0f269
--- /dev/null
+++ b/dev-docs/bidders/topon.md
@@ -0,0 +1,72 @@
+---
+layout: bidder
+title: TopOn
+description: Prebid TopOn Bidder Adaptor
+biddercode: topon
+media_types: banner
+tcfeu_supported: false
+usp_supported: check with bidder
+coppa_supported: true
+gpp_supported: check with bidder
+schain_supported: true
+dchain_supported: false
+floors_supported: check with bidder
+userIds: false
+prebid_member: false
+safeframes_ok: false
+deals_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
+gvl_id: 1305
+multiformat_supported: false
+sidebarType: 1
+endpoint_compression: check with bidder
+---
+
+### Table of contents
+
+- [Introduction](#introduction)
+- [Bid Params](#bid-params)
+- [Banner](#banner)
+
+### Introduction
+
+Publishers can use Prebid.js to call TopOn in any of the following ways:
+
+- **Call through our client-side adapter**: Prebid.js calls TopOn directly from the browser using our client-side adapter.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|-----------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------|--------------------|
+| `pubid` | required | TopOn-specific identifier associated with your account | `'e005f4d49dd3'` | `string` |
+
+### Banner
+
+```javascript
+var adUnits = [
+  {
+    code: "test-div",
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250],
+          [300, 600],
+        ],
+      },
+    },
+    bids: [
+      {
+        bidder: "topon",
+        params: {
+          pubid: "e005f4d49dd3", // required
+        },
+      },
+    ],
+  },
+];
+```

From 2aa3fcf0dbd4cd503163609fe46deae7c883c3d5 Mon Sep 17 00:00:00 2001
From: gregneuwo <grzegorz.malisz@neuwo.ai>
Date: Fri, 5 Dec 2025 13:57:25 +0100
Subject: [PATCH 423/665] docs: Update Neuwo RTD module documentation with url
 cleaning information (#6319)

* docs: update documentation for url cleaning

Update module documentation to include:
- URL cleaning configuration options and examples
- Parameter table with stripAllQueryParams, stripQueryParamsForDomains, stripQueryParams, stripFragments
- Update contact information

* Neuwo RTD Module docs: add caching documentation

---------

Co-authored-by: grzgm <125459798+grzgm@users.noreply.github.com>
---
 dev-docs/modules/neuwoRtdProvider.md | 97 +++++++++++++++++++++-------
 1 file changed, 74 insertions(+), 23 deletions(-)

diff --git a/dev-docs/modules/neuwoRtdProvider.md b/dev-docs/modules/neuwoRtdProvider.md
index 3120f6b520..1148c09e20 100644
--- a/dev-docs/modules/neuwoRtdProvider.md
+++ b/dev-docs/modules/neuwoRtdProvider.md
@@ -1,13 +1,13 @@
 ---
 layout: page_v2
 title: Neuwo RTD Module
-display_name: Neuwo RTD Module 
+display_name: Neuwo RTD Module
 description: Enrich bids with contextual data from the Neuwo API.
 page_type: module
 module_type: rtd
-module_code : neuwoRtdProvider
-enable_download : true
-sidebarType : 1
+module_code: neuwoRtdProvider
+enable_download: true
+sidebarType: 1
 ---
 
 # Neuwo RTD Module
@@ -71,38 +71,89 @@ ortb2: {
 }
 ```
 
-To get started, you can generate your API token at [https://neuwo.ai/generatetoken/](https://neuwo.ai/generatetoken/) or [contact us here](https://neuwo.ai/contact-us/).
+To get started, you can generate your API token at [https://neuwo.ai/generatetoken/](https://neuwo.ai/generatetoken/), send us an email to [neuwo-helpdesk@neuwo.ai](mailto:neuwo-helpdesk@neuwo.ai) or [contact us here](https://neuwo.ai/contact-us/).
 
 ## Configuration
 
-> **Important:** You must add the domain (origin) where Prebid.js is running to the list of allowed origins in Neuwo Edge API configuration. If you have problems, [contact us here](https://neuwo.ai/contact-us/).
+> **Important:** You must add the domain (origin) where Prebid.js is running to the list of allowed origins in Neuwo Edge API configuration. If you have problems, send us an email to [neuwo-helpdesk@neuwo.ai](mailto:neuwo-helpdesk@neuwo.ai) or [contact us here](https://neuwo.ai/contact-us/).
 
 This module is configured as part of the `realTimeData.dataProviders` object.
 
 ```javascript
 pbjs.setConfig({
-  realTimeData: {
-    dataProviders: [{
-      name: 'NeuwoRTDModule',
-      params: {
-        neuwoApiUrl: '<Your Neuwo Edge API Endpoint URL>',
-        neuwoApiToken: '<Your Neuwo API Token>',
-        iabContentTaxonomyVersion: '3.0',
-      }
-    }]
-  }
+    realTimeData: {
+        auctionDelay: 500, // Value can be adjusted based on the needs
+        dataProviders: [
+            {
+                name: "NeuwoRTDModule",
+                waitForIt: true,
+                params: {
+                    neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+                    neuwoApiToken: "<Your Neuwo API Token>",
+                    iabContentTaxonomyVersion: "3.0",
+                    enableCache: true, // Default: true. Caches API responses to avoid redundant requests
+                },
+            },
+        ],
+    },
 });
 ```
 
 **Parameters**
 
-| Name                               | Type   | Required | Default | Description                                                                                       |
-| :--------------------------------- | :----- | :------- | :------ | :------------------------------------------------------------------------------------------------ |
-| `name`                             | String | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                |
-| `params`                           | Object | Yes      |         | Container for module-specific parameters.                                                         |
-| `params.neuwoApiUrl`               | String | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                               |
-| `params.neuwoApiToken`             | String | Yes      |         | Your unique API token provided by Neuwo.                                                          |
-| `params.iabContentTaxonomyVersion` | String | No       | `'3.0'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'2.2'`, `'3.0'`. |
+| Name                                | Type     | Required | Default | Description                                                                                                                                                                                                                                                                                                                |
+| :---------------------------------- | :------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`                              | String   | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                                                                                                                                                                                                                                         |
+| `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                  |
+| `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                   |
+| `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                   |
+| `params.iabContentTaxonomyVersion`  | String   | No       | `'3.0'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'2.2'`, `'3.0'`.                                                                                                                                                                                                                          |
+| `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                        |
+| `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                        |
+| `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
+| `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                 |
+| `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                     |
+
+### API Response Caching
+
+By default, the module caches API responses during the page session to optimise performance and reduce redundant API calls. This behaviour can be disabled by setting `enableCache: false` if needed for dynamic content scenarios.
+
+### URL Cleaning Options
+
+The module provides optional URL cleaning capabilities to strip query parameters and/or fragments from the analysed URL before sending it to the Neuwo API. This can be useful for privacy, caching, or analytics purposes.
+
+**Example with URL cleaning:**
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 500, // Value can be adjusted based on the needs
+        dataProviders: [
+            {
+                name: "NeuwoRTDModule",
+                waitForIt: true,
+                params: {
+                    neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+                    neuwoApiToken: "<Your Neuwo API Token>",
+                    iabContentTaxonomyVersion: "3.0",
+
+                    // Option 1: Strip all query parameters from the URL
+                    stripAllQueryParams: true,
+
+                    // Option 2: Strip all query parameters only for specific domains
+                    // stripQueryParamsForDomains: ['example.com', 'another-domain.com'],
+
+                    // Option 3: Strip specific query parameters by name
+                    // stripQueryParams: ['utm_source', 'utm_campaign', 'fbclid'],
+
+                    // Optional: Strip URL fragments (hash)
+                    stripFragments: true,
+                },
+            },
+        ],
+    },
+});
+```
 
 ## Installation
 

From 41fdfe3a8c544a141db412d80d9bd0f61d541dc5 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 5 Dec 2025 08:04:07 -0500
Subject: [PATCH 424/665] Document flex ad mediaType / bidResponse options
 (#6324)

* Document flex ad mediaType / bidResponse options

* Update Flex banner example with documentation link

Added a reference to Google request object documentation for Flex banner example.

---------

Co-authored-by: Patrick McCann <patmmccann@gmail.com>
---
 dev-docs/adunit-reference.md | 38 +++++++++++++++++++++++++++++++++++-
 dev-docs/bidder-adaptor.md   | 12 +++++++-----
 2 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md
index 9346cca31e..df0e002046 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -84,7 +84,8 @@ See the table below for the list of properties in the `mediaTypes` object of the
 {: .table .table-bordered .table-striped }
 | Name | Scope | Type | Description |
 |---------+----------+---------------------------------------+-----------------------------------------------------------------------------------------|
-| `sizes` | Required | Array[Number] or Array[Array[Number]] | All sizes this ad unit can accept. Examples: `[400, 600]`, `[[300, 250], [300, 600]]`. Prebid recommends that the sizes auctioned by Prebid should be the same auctioned by AdX and GAM OpenBidding, which means AdUnit sizes should match the GPT sizes. |
+| `sizes` | Required if `format` is not provided | Array[Number] or Array[Array[Number]] | All sizes this ad unit can accept. Examples: `[400, 600]`, `[[300, 250], [300, 600]]`. Prebid recommends that the sizes auctioned by Prebid should be the same auctioned by AdX and GAM OpenBidding, which means AdUnit sizes should match the GPT sizes. |
+| `format` | Required if `sizes` is not provided | Array of ORTB [Format](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md#objectformat) objects | Alternative to `sizes`, and takes precedence over it. Allows for more options, such as . | 
 | `pos` | Optional | Integer | OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
 | `name` | Optional | String | Name for this banner ad unit. Can be used for testing and debugging. |
 
@@ -222,6 +223,41 @@ pbjs.addAdUnits({
 });
 ```
 
+#### Flex banner example
+
+See the [Google request object documentation](https://developers.google.com/authorized-buyers/rtb/openrtb-guide#flexslot-object) for additional details. These fields were removed from OpenRTB 2.6 but remain popular. 
+
+```javascript
+pbjs.addAdUnits({
+   code: slot.code,
+   mediaTypes: {
+     banner: {
+       expdir: [1, 2, 3, 4],
+       format: [{w: 250, h: 250}],
+       wmin: 250,
+       wmax: 375,
+       hmin: 250,
+       hmax: 250,
+     },
+   },
+   ortb2Imp: {
+     banner: {
+       ext: {
+         flexslot: {
+           wmin: 250,
+           wmax: 375,
+           hmin: 250,
+           hmax: 250
+         }
+       }
+     }
+   },
+   bids: [
+     // ...
+   ]
+})
+```
+
 <a name="adUnit-video-example"></a>
 
 ### Video
diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 006a2019cb..6836a1506f 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -514,11 +514,13 @@ The parameters of the `bidResponse` object are:
 
 | Key          | Scope                                       | Description                                                                                                                                   | Example                              |
 |--------------+---------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------|
-| `requestId`  | Required                                    | The bid ID that was sent to `spec.buildRequests` as `bidRequests[].bidId`. Used to tie this bid back to the request.                          | 12345                                |
-| `cpm`        | Required                                    | The bid price. We recommend the most granular price a bidder can provide                                                                      | 3.5764                               |
-| `currency`   | Required                                    | 3-letter ISO 4217 code defining the currency of the bid.                                                                                      | `"EUR"`                              |
-| `width`      | Required                                    | The width of the returned creative. For video, this is the player width.                                                                      | 300                                  |
-| `height`     | Required                                    | The height of the returned creative. For video, this is the player height.                                                                    | 250                                  |
+| `requestId`  | Required                                       | The bid ID that was sent to `spec.buildRequests` as `bidRequests[].bidId`. Used to tie this bid back to the request.                          | 12345                                |
+| `cpm`        | Required                                       | The bid price. We recommend the most granular price a bidder can provide                                                                      | 3.5764                               |
+| `currency`   | Required                                       | 3-letter ISO 4217 code defining the currency of the bid.                                                                                      | `"EUR"`                              |
+| `width`      | Required except when using `wratio` / `hratio` | The width of the returned creative. For video, this is the player width.                                                                      | 300                                  |
+| `height`     | Required except when using `wratio` / `hratio` | The height of the returned creative. For video, this is the player height.                                                                    | 250                                  |
+| `wratio`     | Required for flex ads                          | For flexible banner only, the relative width of the creative                                                                                 | 6                                    |
+| `hratio`     | Required for flex ads                          | For flexible banner only, the relative height of the creative                                                                                | 5                                    |
 | `ad`         | Required                                    | The creative payload of the returned bid.                                                                                                     | `"<html><h3>I am an ad</h3></html>"` |
 | `ttl`        | Required                                    | Time-to-Live - how long (in seconds) Prebid can use this bid. See the [FAQ entry](/dev-docs/faq.html#does-prebidjs-cache-bids) for more info.   | 360                                  |
 | `creativeId` | Required                                    | A bidder-specific unique code that supports tracing the ad creative back to the source.                                                       | `"123abc"`                           |

From 30da2a856dc261f3470c751d5d4240458efc090c Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Fri, 5 Dec 2025 15:03:21 +0100
Subject: [PATCH 425/665] Nexx360 BidAdapter: placement added (#6349)

* placement added

* Fix formatting of ID field requirement note

---------

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/nexx360.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/dev-docs/bidders/nexx360.md b/dev-docs/bidders/nexx360.md
index a1a073992b..7bd8a27f21 100644
--- a/dev-docs/bidders/nexx360.md
+++ b/dev-docs/bidders/nexx360.md
@@ -34,6 +34,10 @@ multiformat_supported: will-bid-on-any
 | `divId`       | optional | divId linked to adUnit     | `"div-1"`                                 | `string`  |
 | `adUnitName`  | optional | A code to identify adUnit  | `"header-ad"`                             | `string`  |
 | `adUnitPath`  | optional | A reference to adUnit Path | `"/12345/nexx360/Homepage/HP/Header-Ad"`  | `string`  |
+| `placement`   | optional | Nexx360 placement          | `"TEST_PLACEMENT"`                        | `string`  |
+
+You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
 
 ### Bidder Config
 

From c7723b24585013980ed69cea77b0ba76cb463274 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Fri, 5 Dec 2025 22:51:03 +0100
Subject: [PATCH 426/665] Loading modules separately (#6353)

* Loading modules separately

* lint

* storage control usage

---------

Co-authored-by: Marcin Komorski <marcinkomorski@Marcins-MacBook-Pro.local>
---
 _data/sidebar.yml         |  8 ++++++++
 dev-docs/modules/index.md | 43 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index b06ea827e5..e3aacd894b 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -531,6 +531,14 @@
   sectionTitle:
   subgroup: 5
 
+- sbSecId: 1
+  title: Loading modules separately
+  link: /dev-docs/modules/index.html#loading-modules-separately
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 5
+
 - sbSecId: 1
   title: External Interfaces
   link:
diff --git a/dev-docs/modules/index.md b/dev-docs/modules/index.md
index 41788113b3..019f43c34c 100644
--- a/dev-docs/modules/index.md
+++ b/dev-docs/modules/index.md
@@ -115,6 +115,49 @@ results. See [the userSync setConfig](/dev-docs/publisher-api-reference/setConfi
 </tbody>
 </table>
 
+## Loading modules separately
+
+There are situations where a publisher uses different modules depending on various factors, such as specific pages or locations. This creates the inconvenience of having to load a Prebid build that is larger than what a particular page actually needs. While it’s possible to work around this by creating separate Prebid builds for different pages, that approach doesn’t scale well. Since a Prebid build is composed of concatenated chunks, it’s possible to load modules separately, allowing you to have a main Prebid file that contains only the modules shared across all pages.
+
+### Example
+
+This is the example of loading modules separately for the self-hosted (e.g. CDN) Prebid build.
+Instructions for importing modules when using the npm package can be found in the [Readme file](https://github.com/prebid/Prebid.js/blob/master/README.md)
+
+1. Perform full Prebid build `gulp build`
+1. Generate the main `prebid.js` file containing only the modules required across all pages: `gulp bundle --modules=<...>`
+1. Host `build/dist` folder content on your server or CDN
+1. Check the dependencies of the modules you plan to load dynamically on the current page [Dependency tree](https://cdn.jsdelivr.net/npm/prebid.js@latest/dist/chunks/dependencies.json)
+1. Load the required modules, their dependencies using script tags:
+
+```html
+<html>
+<head>
+    <title>Page 1</title>>
+    <script src="https://<your-cdn>/prebid/ortbConverter.js"></script> <!-- Depedency of openxBidAdapter !-->
+    <script src="https://<your-cdn>/prebid/openxBidAdapter.js"></script> <!-- Bid adapter module !-->
+    <script src="https://<your-cdn>/prebid/id5IdSystem.js"></script> <!-- Another module (doesn't require any additional dependencies) !-->
+    <script src="https://<your-cdn>/prebid/prebid.js"></script> <!-- Load prebid.js last !-->
+</head>
+```
+
+### Storage control usage
+
+When working with the `storageControl` module you will need to explicitly import disclosure metadata. To do this, pair each module import with its corresponding metadata file `<module>.metadata.js`
+
+```html
+<html>
+<head>
+    <title>Page 1</title>>
+    <script src="https://<your-cdn>/prebid/ortbConverter.js"></script> <!-- Depedency of openxBidAdapter !-->
+    <script src="https://<your-cdn>/prebid/openxBidAdapter.js"></script> <!-- Bid adapter module !-->
+    <script src="https://<your-cdn>/prebid/openxBidAdapter.metadata.js"></script> <!-- Bid adapter module's metadata !-->
+    <script src="https://<your-cdn>/prebid/id5IdSystem.js"></script> <!-- Another module (doesn't require any additional dependencies) !-->
+    <script src="https://<your-cdn>/prebid/id5IdSystem.metadata.js"></script> <!-- Another module's metadata !-->
+    <script src="https://<your-cdn>/prebid/prebid.js"></script> <!-- Load prebid.js last !-->
+</head>
+```
+
 ## Further Reading
 
 - [Source code of all modules](https://github.com/prebid/Prebid.js/tree/master/modules)

From 5c0df25d018e0691f61e2a2606a1fbbcc49d3155 Mon Sep 17 00:00:00 2001
From: Philip Watson <philip.watson@adscale.co.nz>
Date: Thu, 11 Dec 2025 21:11:38 +1300
Subject: [PATCH 427/665] Fix the default value for includebidderkeys and
 includewinners targeting params (#6365)

---
 .../endpoints/openrtb2/pbs-endpoint-auction.md       | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index ee304bea86..ff592862e8 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -589,8 +589,8 @@ to set these params on the response at `response.seatbid[i].bid[j].ext.prebid.ta
 | mediatypepricegranularity.native | no | Defines how PBS quantizes bid prices into buckets for native. | (see below) | object |
 | mediatypepricegranularity.TYPE.precision | no | How many decimal places are there in price buckets. | Defaults to 2 | integer |
 | mediatypepricegranularity.TYPE.ranges | no | Same as pricegranularity.ranges | (see below) | array of objects |
-| includewinners | no | Whether to include targeting for the winning bids in response.seatbid[].bid[]. ext.prebid.targeting. Defaults to false. | true | boolean |
-| includebidderkeys | no | Whether to include targeting for the best bid from each bidder in response.seatbid[].bid[]. ext.prebid.targeting. Defaults to false. | true | boolean |
+| includewinners | no | Whether to include targeting for the winning bids in response.seatbid[].bid[]. ext.prebid.targeting. Defaults to true. | true | boolean |
+| includebidderkeys | no | Whether to include targeting for the best bid from each bidder in response.seatbid[].bid[]. ext.prebid.targeting. Defaults to true. | true | boolean |
 | includeformat | no | Whether to include the "hb_format" targeting key. Defaults to false. | false | boolean |
 | preferdeals | no | If targeting is returned and this is true, PBS will choose the highest value deal before choosing the highest value non-deal. Defaults to false. | true | boolean |
 | alwaysincludedeals | no | If true, generate hb_ATTR_BIDDER values for all bids that have a dealid | true | boolean |
@@ -611,10 +611,10 @@ to set these params on the response at `response.seatbid[i].bid[j].ext.prebid.ta
                               // "pricegranularity": "medium"
           }]
         },
-        "includewinners": true,     // Optional param defaulting to false
-        "includebidderkeys": false, // Optional param defaulting to false
+        "includewinners": true,     // Optional param defaulting to true
+        "includebidderkeys": false, // Optional param defaulting to true
         "includeformat": false,     // Optional param defaulting to false
-        "preferdeals": true         // Optional param defaulting to false
+        "preferdeals": true,        // Optional param defaulting to false
         "alwaysincludedeals": true  // Optional param defaulting to false
       }
     }
@@ -626,7 +626,7 @@ The list of price granularity ranges must be given in order of increasing `max`
 
 For backwards compatibility the following strings will also be allowed as price granularity definitions. There is no guarantee that these will be honored in the future. "One of ['low', 'med', 'high', 'auto', 'dense']" See [price granularity definitions](/adops/price-granularity.html).
 
-One of "includewinners" or "includebidderkeys" should be true if you want targeting - both default to false if unset. If both are false, then no targeting keys will be set, which is better configured by omitting targeting altogether.
+One of "includewinners" or "includebidderkeys" should be true if you want targeting - both default to true if unset. If both are true, then all the targeting keys will be set, which is better configured by omitting targeting altogether.
 
 The parameter "includeformat" indicates the type of the bid (banner, video, etc) for multiformat requests. It will add the key `hb_format` and/or `hb_format_{bidderName}` as per "includewinners" and "includebidderkeys" above.
 

From 0e8f0c2bcf8d3a4a7d71c0d4b020b8101a7020cb Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 12 Dec 2025 19:00:12 +0100
Subject: [PATCH 428/665] Update getBidResponses.md (#6369)

* Update getBidResponses.md

The creativeId is a string and not a number

* Adjusted the creativeId in the example from a number to a string
---
 dev-docs/publisher-api-reference/getBidResponses.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/getBidResponses.md b/dev-docs/publisher-api-reference/getBidResponses.md
index 44ae1d92d0..0a01d9f02a 100644
--- a/dev-docs/publisher-api-reference/getBidResponses.md
+++ b/dev-docs/publisher-api-reference/getBidResponses.md
@@ -30,7 +30,7 @@ This function returns the bid responses at the given moment.
 | `responseTimestamp` | Integer | The time stamp when the bid response is received in milliseconds                                                               |                                             1444844944185 |
 | `timeToRespond`     | Integer | The amount of time for the bidder to respond with the bid                                                                       |                                                        79 |
 | `adUnitCode`        | String  | adUnitCode to get the bid responses for                                                                                         |                               "/9968336/header-bid-tag-0" |
-| `creativeId`     | Integer  | Bidder-specific creative ID | 12345678 |
+| `creativeId`     | String  | Bidder-specific creative ID | `"12345678"` |
 | `mediaType`  | String  | One of: banner, native, video | `banner` |
 | `dealId`            | String  | (Optional) If the bid is [associated with a Deal]({{site.baseurl}}/adops/deals.html), this field contains the deal ID.          |                                                 "ABC_123" |
 | `adserverTargeting`  | Object  | Contains all the adserver targeting parameters | `{ "hb_bidder": "appnexus", "hb_adid": "7a53a9d3" }` |
@@ -195,7 +195,7 @@ This function returns the bid responses at the given moment.
             "pbLg" : "5.00",
             "width" : 0,
             "requestTimestamp" : 1516315716062,
-            "creativeId" : 81589325,
+            "creativeId" : "81589325",
             "pbCg" : "",
             "adUnitCode" : "div-banner-outstream-native",
             "size" : "0x0",

From c724ef656d33b7806e5d8729ef5943b230452d9f Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 19 Dec 2025 16:12:06 +0100
Subject: [PATCH 429/665] Update msft.md (#6370)

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

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index b79e6ee759..81d0e124f9 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -54,7 +54,7 @@ All Microsoft (formerly AppNexus/Xandr) placements included in a single call to
 | `inv_code` | required (see note above) | The inventory code from Microsoft Monetize.  Must be used with `member`. | `'abc123'` | `string` |
 | `allow_smaller_sizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` |
 | `use_pmt_rule` | optional | If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` |
-| `keywords` | optional | A comma-delimited string of key-value pairs (or terms) applied to this sepcific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.  | `pet=dog,food,brand=oldroy` | `string` |
+| `keywords` | optional | A comma-delimited string of key-value pairs (or terms) applied to this specific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.  | `pet=dog,food,brand=oldroy` | `string` |
 | `traffic_source_code` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` |
 | `pubclick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly. | `'http://click.adserver.com/'` | `string` |
 | `ext_inv_code` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` |

From 4b72cbd47d193a7bafc01d7feebed152c9a86c16 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Mon, 22 Dec 2025 16:44:52 +0100
Subject: [PATCH 430/665] Update getUserIdsAsEids.md (#6373)

Typo
---
 dev-docs/publisher-api-reference/getUserIdsAsEids.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/getUserIdsAsEids.md b/dev-docs/publisher-api-reference/getUserIdsAsEids.md
index 2aa58a6965..1689535bf4 100644
--- a/dev-docs/publisher-api-reference/getUserIdsAsEids.md
+++ b/dev-docs/publisher-api-reference/getUserIdsAsEids.md
@@ -9,7 +9,7 @@ sidebarType: 1
 {: .alert.alert-info :}
 To use this function, include the [UserId module](/dev-docs/modules/userId.html) in your Prebid.js build.
 
-If you need to export the user IDs stored by Prebid User ID module in ORTB Eids frormat, then the `getUserIdsAsEids()` function will return an array formatted as per [ORTB Eids](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md).
+If you need to export the user IDs stored by Prebid User ID module in ORTB Eids format, then the `getUserIdsAsEids()` function will return an array formatted as per [ORTB Eids](https://github.com/prebid/Prebid.js/blob/master/modules/userId/eids.md).
 
 ```javascript
 pbjs.getUserIdsAsEids() // returns userIds in ORTB Eids format. e.g.

From 935e29ddfec7ecff4d89b5b692c19b90abc995c1 Mon Sep 17 00:00:00 2001
From: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Date: Mon, 22 Dec 2025 17:51:24 +0200
Subject: [PATCH 431/665] IntentIq ID:  add new parameter `abPercentage`
 (#6361)

* fix spelling

* AGT-705: abPercentage parameter (#16)

* add group parameters

* remove extra line

* add more params to analytical adapter (#17)

---------

Co-authored-by: dmytro-po <dmytro.po@intentiq.com>
---
 dev-docs/analytics/intentiq.md                 | 13 +++++++++++++
 dev-docs/modules/userid-submodules/intentiq.md |  4 ++++
 2 files changed, 17 insertions(+)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index b5ba04fc86..8ef946a293 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -22,11 +22,22 @@ No registration for this module is required.
 {: .table .table-bordered .table-striped }
 | Parameter | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
+| options.partner| Required | Number   | This is the partner ID value obtained from registering with IntentIQ.   | `1177538` |
 | options.manualWinReportEnabled | Optional | Boolean | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `false` |
 | options.reportMethod | Optional | String | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL. | `"GET"` |
 | options.reportingServerAddress | Optional | String | The base URL for the IntentIQ reporting server. If parameter is provided in `configParams`, it will be used. | `"https://domain.com"` |
 | options.adUnitConfig | Optional | Number |  Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId. | `1` |
 | options.gamPredictReporting | Optional | Boolean |  This variable controls whether the GAM prediction logic is enabled or disabled. The main purpose of this logic is to extract information from a rendered GAM slot when no Prebid bidWon event is available. In that case, we take the highest CPM from the current auction and add 0.01 to that value. | `false` |
+| options. ABTestingConfigurationSource | Optional | String | Determines how AB group will be defined. Possible values: `"IIQServer"` – group defined by IIQ server, `"percentage"` – generated group based on abPercentage, `"group"` – define group based on value provided by partner. | `IIQServer` |
+| options.abPercentage | Optional | Number | Percentage for A/B testing group. Default value is `95` | `95` |
+| options.group | Optional | String | Define group provided by partner, possible values: `"A"`, `"B"` | `"A"` |
+| options.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.| `googletag`|
+| options.browserBlackList        | Optional | String   | This is the name of a browser that can be added to a blacklist.| `"chrome"`|
+| options.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.| `"currentDomain.com"`|
+| options. additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
+| options. additionalParams[0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
+| options. additionalParams[0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
+| options. additionalParams[0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
 
 #### Example Configuration
 
@@ -34,9 +45,11 @@ No registration for this module is required.
 pbjs.enableAnalytics({
     provider: 'iiqAnalytics',
     options: {
+        partner: 1177538,
         manualWinReportEnabled: false,
         reportMethod: "GET",
         adUnitConfig: 1,
+        domainName: "currentDomain.com",
         gamPredictReporting: false
     }
 });
diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 8d46ee99f4..8c734a863d 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -55,6 +55,9 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.siloEnabled             | Optional | Boolean  | Determines if first-party data is stored in a siloed storage key. When set to `true`, first-party data is stored under a modified key that appends `_p_` plus the partner value rather than using the default storage key. The default value is `false`.                                                                          | `true`                                        |
 | params.groupChanged            | Optional | Function | A callback that is triggered every time the user’s A/B group is set or updated.                                                                                         |`(group) => console.log('Group changed:', group)` |
 | params.chTimeout | Optional | Number | Maximum time (in milliseconds) to wait for Client Hints from the browser before sending request. Default value is `10ms` | `30` |
+| params. ABTestingConfigurationSource| Optional | String | Determines how AB group will be defined. Possible values: `"IIQServer"` – group defined by IIQ server, `"percentage"` – generated group based on abPercentage, `"group"` – define group based on value provided by partner. | `IIQServer` |
+| params.abPercentage | Optional | Number | Percentage for A/B testing group. Default value is `95` | `95` |
+| params.group | Optional | String | Define group provided by partner, possible values: `"A"`, `"B"` | `"A"` |
 | params.additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
 | params.additionalParams [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
 | params.additionalParams [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
@@ -79,6 +82,7 @@ pbjs.setConfig({
                 sourceMetaData: "123.123.123.123", // Optional parameter
                 sourceMetaDataExternal: 123456, // Optional parameter
                 chTimeout: 10, // Optional parameter
+                abPercentage: 95, // Optional parameter
                 additionalParams: [ // Optional parameter
                     {
                       parameterName: "abc",

From fa0c49bcd3ec3fca0c1a1bece4ba74a073025a7e Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Mon, 22 Dec 2025 16:52:58 +0100
Subject: [PATCH 432/665] Ybidder & Netads adapter added (#6360)

* ybidder adapter added

* netads adapter added

---------

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/netads.md  | 105 ++++++++++++++++++++++++++++++++++++
 dev-docs/bidders/ybidder.md | 105 ++++++++++++++++++++++++++++++++++++
 2 files changed, 210 insertions(+)
 create mode 100644 dev-docs/bidders/netads.md
 create mode 100644 dev-docs/bidders/ybidder.md

diff --git a/dev-docs/bidders/netads.md b/dev-docs/bidders/netads.md
new file mode 100644
index 0000000000..694a6a1438
--- /dev/null
+++ b/dev-docs/bidders/netads.md
@@ -0,0 +1,105 @@
+---
+layout: bidder
+title: Netads
+description: Prebid Netads Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: netads
+gvl_id: 965
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                              | Type      |
+|---------------|----------|----------------------------|--------------------------------------|-----------|
+| `tagId`       | required | tag ID                     | `"testnexx"`                         | `string`  |
+| `placement`   | required*| Placement                  | `"TEST_PLACEMENT"`                   | `string`  |
+
+You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'netads',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'netads',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'netads',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    }
+];
+```
diff --git a/dev-docs/bidders/ybidder.md b/dev-docs/bidders/ybidder.md
new file mode 100644
index 0000000000..68f1eb690b
--- /dev/null
+++ b/dev-docs/bidders/ybidder.md
@@ -0,0 +1,105 @@
+---
+layout: bidder
+title: Ybidder
+description: Prebid Ybidder Bidder Adapter
+pbjs: true
+pbs: true
+biddercode: ybidder
+gvl_id: 1253
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                              | Type      |
+|---------------|----------|----------------------------|--------------------------------------|-----------|
+| `tagId`       | required | tag ID                     | `"testnexx"`                         | `string`  |
+| `placement`   | required*| Placement                  | `"TEST_PLACEMENT"`                   | `string`  |
+
+You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+The following fields are supported:
+
+* ortb2.site.ext.data.*
+* ortb2.site.content.data[]
+* ortb2.user.ext.data.*
+* ortb2.user.data[]
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'ybidder',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'ybidder',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes:
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'ybidder',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    }
+];
+```

From c6e7fdf5ec874234b08f26a8fe6f2cd51d49ed48 Mon Sep 17 00:00:00 2001
From: Olivier <osazos@adagio.io>
Date: Mon, 22 Dec 2025 17:11:41 +0100
Subject: [PATCH 433/665] Adagio: update bidder adapter documentation (#6327)

* Adagio: update bid adapter doc

* Adagio: fix metadata fields
---
 dev-docs/bidders/adagio.md | 190 ++++++++++++++++++++++++-------------
 1 file changed, 125 insertions(+), 65 deletions(-)

diff --git a/dev-docs/bidders/adagio.md b/dev-docs/bidders/adagio.md
index 6cb68379ea..c4c3812f95 100644
--- a/dev-docs/bidders/adagio.md
+++ b/dev-docs/bidders/adagio.md
@@ -13,8 +13,8 @@ floors_supported: true
 tcfeu_supported: true
 dsa_supported: true
 usp_supported: true
-gpp_supported: true
 coppa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true
 gvl_id: 617
 prebid_member: true
@@ -24,98 +24,158 @@ dchain_supported: false
 deals_supported: false
 ortb_blocking_supported: false
 endpoint_compression: true
+privacy_sandbox: 'no'
 sidebarType: 1
 ---
 
-### Note
+### Table of contents
+
+* [Table of contents](#table-of-contents)
+* [Introduction](#introduction)
+* [Bid params](#bid-params)
+  * [Setting params: AdUnit Level vs First Party Data](#setting-params-adunit-level-vs-first-party-data)
+* [Prebid Server](#prebid-server-adapter)
+* [Additional informations](#additional-informations)
+  * [User Sync](#user-sync)
+  * [Recommended placement param values](#recommended-placement-param-values)
+  * [Video outstream](#video-outstream)
+
+### Introduction
 
 The Adagio bidder adapter requires setup and approval from the Adagio team. Please reach out to [contact@adagio.io](mailto:contact@adagio.io) for more information.
 
-### Configuration for Prebid.js
+We strongly recommend using it alongside the [Adagio RTD Provider](/dev-docs/modules/adagioRtdProvider.md), which leverages viewability and attention predictions to enhance inventory quality and maximize performance.
 
-#### User Sync
+We also strongly suggest enabling the gptPreAuction module, which automatically populates the GPID (Global Placement ID) values. The GPID helps improve monetization by providing more accurate identification of each ad placement. For setup details, see the [gptPreAuction module documentation](/dev-docs/modules/gpt-pre-auction.md).
 
-Adagio strongly recommends enabling user syncing through iFrames. This functionality improves DSP user match rates and increases the bid rate and bid price. Make sure to call `pbjs.setConfig()` only once. This configuration is optional in Prebid, but required by Adagio.
+### Bid params
 
-```js
-// https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing
-pbjs.setConfig({
-  userSync: {
-    filterSettings: {
-      iframe: {
-        bidders: ['adagio'],
-        filter: 'include'
-      }
-    }
-  }
-});
-```
+{: .table .table-bordered .table-striped .table-responsive }
 
-#### Bidder Settings
+| Name              | Scope              | Description                                                                                                                                                                                                                                          | Example                                                      | Type     |
+| ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- |
+| `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
+| `site`            | required / optional (in-app)            | Name of the site. Handed out by Adagio.<br><span style="display:inline-block; margin-top: 0.6em; line-height:1.5; font-size:14px; font-style:italic;">- max length: 50</span>                                                                                                                                                                                   | `'mysite-com'`                                               | `string` |
+| `placement`     | required           | Refers to the placement of an adunit in a page. See [recommended values](#recommended-placement-param-values).<br><span style="display:inline-block; margin-top: 0.6em; line-height:1.5; font-size:14px; font-style:italic;">- max length: 50<br>- max distinctives values: 10</span>                                                                     | `'banner_top'`                                                  | `string` |
+| `pagetype`      | highly recommended | Describes what kind of content will be present in the page.<br><span style="display:inline-block; margin-top: 0.6em; line-height:1.5; font-size:14px; font-style:italic;">- max length: 30<br>- max distinctives values: 50</span><br><span style="display:inline-block; line-height:1.5; font-size:14px;">Can be set at adUnit level or via FPD ([see below](#setting-params-adunit-level-vs-first-party-data))</span>                                    | `'article'`                                                  | `string` |
+| `category`      | recommended        | Category of the content displayed in the page.<br><span style="display:inline-block; margin-top: 0.6em; line-height:1.5; font-size:14px; font-style:italic;">- max length: 30<br>- max distinctives values: 50</span><br><span style="display:inline-block; line-height:1.5; font-size:14px;">Can be set at adUnit level or via FPD ([see below](#setting-params-adunit-level-vs-first-party-data))</span>                                               | `'sport'`                                                    | `string` |
+
+#### Setting params: AdUnit Level vs First Party Data
 
-The Adagio bid adapter uses browser local storage. Since Prebid.js 7.x, the access to it must be explicitly set.
+You can set `pagetype` and `category` parameters in two ways:
 
-{% include dev-docs/storageAllowed.md %}
+**1. At the adUnit level** (individual ad slots):
 
 ```js
-// https://docs.prebid.org/dev-docs/publisher-api-reference/bidderSettings.html
-pbjs.bidderSettings = {
-  adagio: {
-    storageAllowed: true
-  }
+{
+  code: 'div-gpt-ad-1234567890',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]]
+    }
+  },
+  bids: [{
+    bidder: 'adagio',
+    params: {
+      organizationId: '1010',
+      site: 'mysite-com',
+      placement: 'banner_top',
+      pagetype: 'article',
+      category: 'sport'
+    }
+  }]
 }
 ```
 
-#### Bid Params for Prebid.js
-
-**Important**: Adagio needs to collect attention data about the ads displayed on a page and must listen to some specifics ad-server events. Please refer to the [Adagio user guide](https://adagioio.notion.site/Adagio-Account-Setup-Guide-fbcd940649224cdfa10393d2f008792e) for details.
-
-{: .table .table-bordered .table-striped }
+**2. Globally via First Party Data** (applies to all adUnits on the page):
 
-| Name              | Scope              | Description                                                                                                                                                                                                                                          | Example                                                      | Type     |
-| ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------- |
-| `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
-| `site`            | required           | Name of the site. Handed out by Adagio.<br><i>- max length: 50</i>                                                                                                                                                                                   | `'mysite-com'`                                               | `string` |
-| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 50</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
-| `adUnitElementId` | required           | Refers to the adunit html attribute id in a page.                                                                                                                                                                                                    | `'gpt-ban-atf'`                                              | `string` |
-| `pagetype`*       | highly recommended | Describes what kind of content will be present in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                       | `'article'`                                                  | `string` |
-| `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
-| `video`           | optional           | OpenRTB 2.5 video options object. All options will override ones defined in mediaTypes video.<br>Mandatory: <br>- api <small><i>(your video player must at least support the value 2)</i></small><br> Highly recommended: <br> - playbackmethod <br> Not supported: <br>`protocol`, `companionad`, `companiontype`, `ext` options| `{api: [2], playbackmethod: [6], skip: 1, startdelay: 0}` | `object` |
-| `native`          | optional           | Partial OpenRTB Native 1.2 request object. Supported fields are:<br>- context<br>- plcmttype                                                                                                                                                         | `{context: 1, plcmttype: 2}`                                 | `object` |
-| `splitKeyword`     | optional          | Keyword that can later be used in a split rule targeting to trigger the rule (especially for Direct Seats AB testing) |  `'splitrule-one'` | `string` |
-| `dataLayer`        | optional          | A set of arbitrary key-value pairs. This can be used to configure mappings. The keys and values must be strings. | `{placement: 'my-placement', siteid: 'my-siteid'}` | `object` |
-
-<i>*These parameters will have their accentuated characters converted to their non-accentuated version:&nbsp;`é`&nbsp;=>&nbsp;`e`</i>
+```js
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      ext: {
+        data: {
+          pagetype: 'article',
+          category: 'sport'
+        }
+      }
+    }
+  }
+});
+```
 
-#### First Party Data
+* First Party Data takes precedence over AdUnit-level parameters.
+* If the FPD value is an array, the first value will be used.
+
+<a id="prebid-server-adapter"></a>
+### Prebid Server
+
+If you are hosting a Prebid Server, you must configure the Adagio Prebid Server adapter by changing the [`static/bidder-info/adagio.yaml` file](https://github.com/prebid/prebid-server/blob/master/static/bidder-info/adagio.yaml) in order to:
+
+1. enable the adapter by deleting the `disabled: true` entry _(or set it to `false`)_
+2. replace the endpoints containing the `REGION` by one of the value below:
+    * **AMER:**
+      * Auction: `https://mp-las.4dex.io/pbserver`
+      * Usersync: `https://u-las.4dex.io/pbserver/usync.html`
+    * **EMEA:**
+      * Auction: `https://mp-ams.4dex.io/pbserver`
+      * Usersync: `https://u-ams.4dex.io/pbserver/usync.html`
+    * **APAC:**
+      * Auction: `https://mp-tyo.4dex.io/pbserver`
+      * Usersync: `https://u-tyo.4dex.io/pbserver/usync.html`
+
+**Example for EMEA**
+
+{% raw %}
+
+```yaml
+endpoint: "https://mp-ams.4dex.io/pbserver"
+userSync:
+  iframe:
+    url: "https://u-ams.4dex.io/pbserver/usync.html?gdpr={{.GDPR}}&gdpr_consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&gpp={{.GPP}}&&gpp_sid={{.GPPSID}}&r={{.RedirectURL}}"
+    userMacro: "{UID}"
+disabled: false
+# …
+```
 
-Adagio will use FPD data as fallback for the params below:
+{% endraw %}
 
-- pagetype
-- category
+### Additional informations
 
-If the FPD value is an array, the 1st value of this array will be used.
+#### User Sync
 
-#### Video outstream
+Enable user sync via iframe to improve DSP user match rates, leading to higher bid rates and bid prices. While this configuration is optional in Prebid, it is required by Adagio. Ensure that `pbjs.setConfig()` is called only once.
 
-The AdagioBidAdapter includes a default video player powered by [Blue Billywig](https://www.bluebillywig.com). This default player is used when no renderer is configured for the adUnit.
+```js
+// https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      iframe: {
+        bidders: ['adagio'],
+        filter: 'include'
+      }
+    }
+  }
+});
+```
 
-### Configuration for Prebid Server
+#### Recommended placement param values
 
-{: .alert.alert-warning :}
-Adagio Prebid Server adapter is currently **available for apps**. Website support is coming soon. Activation requires setup and approval before beginning. Please reach out to your account manager or <contact@adagio.io> for more details.
+Setting a meaningful value for the `placement` parameter is essential for our adapter to optimize ad delivery and performance, as it defines the specific location and context of your ad unit within the page. To streamline your implementation and ensure consistent naming conventions across your inventory, we provide these standardized values that eliminate guesswork and ensure your ad units are properly categorized for maximum yield.
 
-Adagio supports different regions for the Prebid Server. Please deploy the prebid config in each of your datacenters with the appropriate regional subdomain.
+{: .table .table-bordered :}
 
-#### Bid Params for Prebid Server
+| Format              | recommended values    |
+| --------------------| --------------------- |
+| Banner              | `banner_top`,<br>`banner_middle`,<br>`banner_bottom`,<br>`banner_left`,<br>`banner_right`,<br>`banner_sticky_top`,<br>`banner_sticky_bottom` |
+| Interstitial        | `interstitial_page_load`,<br>`interstitial_exit`,<br>`interstitial_pause` |
+| Video               | `video_instream`,<br>`video_outstream`,<br>`video_rewarded`,<br>`video_midroll` |
+| Native              | `native_feed`,<br>`native_article`,<br>`native_recommendation` |
+| Special             | `sticky_footer`,<br>`sticky_header`,<br>`companion_banner`,<br>`overlay_ad` |
 
-{: .table .table-bordered .table-striped }
+#### Video outstream
 
-| Name              | Scope              | Description | Example | Type |
-|-------------------|--------------------|-------------|---------|------|
-| `organizationId`  | required           | Id of the Organization. Handed out by Adagio.                                                                                                                                                                                                        | `'1010'`                                                     | `string` |
-| `placement`*      | required           | Refers to the placement of an adunit in a page.<br>Must not contain any information about the type of device.<br><i>- max length: 50</i><br><i>- max distinctives values: 10</i>                                                                     | `'ban_atf'`                                                  | `string` |
-| `pagetype`*       | highly recommended | Describes what kind of content will be present in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                       | `'article'`                                                  | `string` |
-| `category`*       | recommended        | Category of the content displayed in the page.<br><i>- max length: 30</i><br><i>- max distinctives values: 50</i>                                                                                                                                    | `'sport'`                                                    | `string` |
+The Adagio bidder adapter (Prebid.js only) includes a default video player powered by [Blue Billywig](https://www.bluebillywig.com). This default player is used when no renderer is configured for the adUnit.
 
-<i>*These parameters will have their accentuated characters converted to their non-accentuated version:&nbsp;`é`&nbsp;=>&nbsp;`e`</i>
+---

From ec3cec5cd169aa8cf405583def4af85e4d529e30 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Tue, 13 Jan 2026 09:24:37 +0200
Subject: [PATCH 434/665] Attekmi: add RadiantFusion alias (#6356)

* Attekmi: add RadiantFusion alias

* prebid-server param switch to true

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/radiantfusion.md | 39 +++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/radiantfusion.md

diff --git a/dev-docs/bidders/radiantfusion.md b/dev-docs/bidders/radiantfusion.md
new file mode 100644
index 0000000000..0bffdcc5ea
--- /dev/null
+++ b/dev-docs/bidders/radiantfusion.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: RadiantFusion
+description: RadiantFusion Bidder Adapter
+biddercode: radiantfusion
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From bed52845c5636409a7f4da4e0101e3ee0446e891 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Tue, 13 Jan 2026 10:02:10 +0200
Subject: [PATCH 435/665] Attekmi: add region to Markapp (#6366)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/markapp.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/bidders/markapp.md b/dev-docs/bidders/markapp.md
index 3e427f8119..7793677efb 100644
--- a/dev-docs/bidders/markapp.md
+++ b/dev-docs/bidders/markapp.md
@@ -26,6 +26,7 @@ multiformat_supported: will-bid-on-any
 |---------------|----------|---------------------------------|-------------------------------------|-----------|
 | `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
 | `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `region`      | optional | Region                          | `apac`                              | `string`  |
 | `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
 | `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
 | `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |

From 4f26b498835e7f851819cc31b18c31e232f2f4cc Mon Sep 17 00:00:00 2001
From: Eugene Dorfman <eugene.dorfman@gmail.com>
Date: Tue, 13 Jan 2026 09:04:44 +0100
Subject: [PATCH 436/665] 51degrees: add ThirdPartyCookiesEnabled support
 (#6368)

* 51degrees: add ThirdPartyCookiesEnabled support

* 51degrees: rename ext to fod
---
 dev-docs/modules/51DegreesRtdProvider.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/dev-docs/modules/51DegreesRtdProvider.md b/dev-docs/modules/51DegreesRtdProvider.md
index 1fbf70bdf9..f84a5690e7 100644
--- a/dev-docs/modules/51DegreesRtdProvider.md
+++ b/dev-docs/modules/51DegreesRtdProvider.md
@@ -27,11 +27,15 @@ The Cloud API is **free** to integrate and use. To increase limits please check
 
 51Degrees module enriches an OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/index.html).
 
-51Degrees module sets the following fields of the device object: `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio` - interested bidder adapters may use these fields as needed. In addition the module sets `device.ext.fiftyonedegrees_deviceId` to a permanent device ID which can be rapidly looked up in on premise data exposing over 250 properties including the device age, chip set, codec support, and price, operating system and app/browser versions, age, and embedded features.
+51Degrees module sets the following fields of the device object: `devicetype`, `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio`. Interested bidder adapters may use these fields as needed. 
+
+The module also adds a `device.ext.fod` extension object (fod == fifty one degrees) and sets `device.ext.fod.deviceId` to a permanent device ID, which can be rapidly looked up in on-premise data, exposing over 250 properties, including device age, chipset, codec support, price, operating system and app/browser versions, age, and embedded features. 
+
+It also sets `device.ext.fod.tpc` key to a binary value to indicate whether third-party cookies are enabled in the browser (1 if enabled, 0 if disabled).
 
 The module supports on premise and cloud device detection services with free options for both. 
 
-A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
+A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
 
 An interface compatible self hosted service can be used with .NET, Java, Node, PHP, and Python.  See [51Degrees examples](https://51degrees.com/documentation/_examples__device_detection__getting_started__web__on_premise.html).
 
@@ -53,14 +57,14 @@ gulp build --modules="rtdModule,51DegreesRtdProvider,appnexusBidAdapter,..."
 
 #### Resource Key
 
-In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
+In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
 
 * DeviceId
 * DeviceType
 * HardwareVendor
 * HardwareName
 * HardwareModel
-* PlatformName 
+* PlatformName
 * PlatformVersion
 * ScreenPixelsHeight
 * ScreenPixelsWidth
@@ -69,6 +73,7 @@ In order to use the module please first obtain a Resource Key using the [Configu
 * ScreenInchesHeight
 * ScreenInchesWidth
 * PixelRatio
+* ThirdPartyCookiesEnabled
 
 The Cloud API is **free** to integrate and use. To increase limits please check [51Degrees pricing](https://51degrees.com/pricing).
 
@@ -123,7 +128,7 @@ pbjs.setConfig({
                 waitForIt: true, // should be true, otherwise the auctionDelay will be ignored
                 params: {
                     resourceKey: '<YOUR_RESOURCE_KEY>',
-                    // Get your resource key from https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation
+                    // Get your resource key from https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation
                     // alternatively, you can use the on-premise version of the 51Degrees service and connect to your chosen end point
                     // onPremiseJSUrl: 'https://localhost/51Degrees.core.js'
                 },

From dd872b4b65ce25e937ecb67924073e9fd5bd5093 Mon Sep 17 00:00:00 2001
From: m-figurski-allegro <mateusz.figurski@allegro.com>
Date: Tue, 13 Jan 2026 09:06:21 +0100
Subject: [PATCH 437/665] New adapter: allegro (#6329)

* Allegro bidder adapter documentation

* fix linter

* extend meta info

* fix request header info
---
 dev-docs/bidders/allegro.md | 67 +++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 dev-docs/bidders/allegro.md

diff --git a/dev-docs/bidders/allegro.md b/dev-docs/bidders/allegro.md
new file mode 100644
index 0000000000..bd3c62e1d9
--- /dev/null
+++ b/dev-docs/bidders/allegro.md
@@ -0,0 +1,67 @@
+---
+layout: bidder
+title: Allegro
+description: Allegro Prebid Bidder Adapter
+gvl_id: 1493
+biddercode: allegro
+media_types: banner, video, native
+pbjs: true
+pbs: false
+gpp_sids: tcfeu
+tcfeu_supported: true
+usp_supported: false
+coppa_supported: false
+dsa_supported: false
+schain_supported: true
+dchain_supported: false
+safeframes_ok: false
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+prebid_member: false
+sidebarType: 1
+privacy_sandbox: no
+---
+
+### Overview
+
+Allegro adapter: banner-only, OpenRTB 2.5, default endpoint `https://dsp.allegro.pl/prebid`, TTL 360s, net revenue true.
+
+### Quick Use
+
+Minimal ad unit:
+
+```javascript
+var adUnits = [{
+    code: 'slot-1',
+    mediaTypes: {banner: {sizes: [[300, 250]]}},
+    bids: [{bidder: 'allegro'}]
+}];
+```
+
+Request bids as usual with `pbjs.addAdUnits` and `pbjs.requestBids`.
+
+### Optional Config
+
+```javascript
+pbjs.setConfig({
+    allegro: {
+        bidderUrl: 'https://prebid.rtb.allegrogroup.com/v1/rtb/prebid/bid', // override if needed
+        convertExtensionFields: true,              // map ext -> [com.google.doubleclick.*]
+        triggerImpressionPixel: false              // fire win pixel if true
+    }
+});
+```
+
+### What It Does
+
+1. Builds standard OpenRTB banner requests.
+2. (Optional) Renames common `ext` objects to DoubleClick-style extension proto fields for downstream systems.
+3. Converts numeric flags (`dnt`, `sua.mobile`, `test`, etc.) to booleans.
+4. On bid win (if enabled) fires `burl`.
+
+### Contact
+
+For onboarding or support: <the-bidders@allegro.com>

From 74c7006942b24bf098ce670e2a2cd0365c022591 Mon Sep 17 00:00:00 2001
From: dev-adverxo <developer@adverxo.com>
Date: Tue, 13 Jan 2026 09:06:56 +0100
Subject: [PATCH 438/665] Add new Adverxo Bidder alias: harrenmedia (#6322)

* Add new adverxo alias: harrenmedia

* Set pbs as false temporarily

---------

Co-authored-by: Adverxo <adverxo@adverxo.com>
---
 dev-docs/bidders/harrenmedia.md | 115 ++++++++++++++++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 dev-docs/bidders/harrenmedia.md

diff --git a/dev-docs/bidders/harrenmedia.md b/dev-docs/bidders/harrenmedia.md
new file mode 100644
index 0000000000..96915c1d7a
--- /dev/null
+++ b/dev-docs/bidders/harrenmedia.md
@@ -0,0 +1,115 @@
+---
+layout: bidder
+title: Harrenmedia
+description: Prebid Harrenmedia Bidder Adapter
+aliasCode: adverxo
+pbjs: true
+pbs: false
+pbs_app_supported: false
+biddercode: harrenmedia
+userIds:
+media_types: banner, native, video
+schain_supported: true
+dchain_supported: false
+ortb_blocking_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+userId: no
+safeframes_ok: false
+deals_supported: true
+fpd_supported: true
+prebid_member: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+The Harrenmedia Bidding adapter requires setup and approval before beginning. Please reach out to <prebid@harrenmedia.com> for
+more details.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|----------|----------|-----------------------|---------------------------|----------|
+| `adUnitId`   | required | Unique identifier for the ad unit in Harrenmedia platform. | `1` | `integer` |
+| `auth`       | required | Authentication token provided by Harrenmedia platform for the AdUnit. |`'61336e75e414c77c367eq5c47c2599ce80a8032b'` | `string` |
+
+### Setting First Party Data (FPD)
+
+Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+
+- ortb2.site.\*
+- ortb2.app.\*
+- ortb2.user.\*
+
+Example first party data:
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        site: {
+            keywords: "kw1,kw2",
+            content: {
+                title: "title1",
+                series: "series1"
+            }
+        },
+        user: {
+            keywords: "a,b",
+            gender: "M",
+            yob: 1984
+        }
+    }
+});
+```
+
+### ORTB Blocking
+
+Harrenmedia supports the next blocking parameters:
+
+- Blocked advertisers list (`badv`) is an array of domains as strings.
+- Blocked apps list (`bapp`) is an array of apps names as strings, for mobile apps in Google Play Store, these should be
+  bundle or package names (e.g. com.foo.mygame). For apps in Apple App Store, these should be a numeric ID.
+- Blocked categories list (`bcat`) is an array of IAB categories as strings.
+- Blocked attributes list (`battr`) is an array of integers. Refer to section 5.3 of the IAB specification for a list of
+  attributes.
+
+#### Globally defined ORTB Blocking
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        badv: ["domain1.com", "domain2.com"],
+        bapp: ["com.foo.mygame", "284708449"],
+        bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+    }
+});
+```
+
+#### ORTB Blocking specific only to the Harrenmedia bidder
+
+```javascript
+pbjs.setBidderConfig({
+    bidders: ['harrenmedia'],
+    config: {
+        ortb2: {
+            badv: ["domain1.com", "domain2.com"],
+            bapp: ["com.foo.mygame"],
+            bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+        }
+    }
+});
+```
+
+#### Media Type defined ORTB Blocking
+
+Additionally `battr` ORTB blocking param may be set on media types to specify blocked creative
+attributes. Refer to section 5.3 of the IAB specification for a list of attributes.

From eb4b0a565ca5a884be5c2434c53c10101487a40c Mon Sep 17 00:00:00 2001
From: ProgrammaticX <pxteam@programmaticx.ai>
Date: Tue, 13 Jan 2026 10:08:16 +0200
Subject: [PATCH 439/665] New Adapter ProgX (#6281)

* init new adapter

* Turn prebid-server support to false

* Add ProgX adapter

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/progx.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/progx.md

diff --git a/dev-docs/bidders/progx.md b/dev-docs/bidders/progx.md
new file mode 100644
index 0000000000..d053a6d6cb
--- /dev/null
+++ b/dev-docs/bidders/progx.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: ProgX
+description: Prebid ProgX Bidder Adapter
+biddercode: progX
+gpp_sids: usstate_all
+gvl_id: 1344
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: false
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From aca17f31c8977dec5f03d7eac9b4afb4ab3bbd15 Mon Sep 17 00:00:00 2001
From: cto-clydo <cto@clydo.io>
Date: Tue, 13 Jan 2026 10:11:26 +0200
Subject: [PATCH 440/665] New adapter: Clydo (#6268)

* New Adapter: Clydo

* clydo adapter prebid.js
---
 dev-docs/bidders/clydo.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 dev-docs/bidders/clydo.md

diff --git a/dev-docs/bidders/clydo.md b/dev-docs/bidders/clydo.md
new file mode 100644
index 0000000000..fd9261b57f
--- /dev/null
+++ b/dev-docs/bidders/clydo.md
@@ -0,0 +1,38 @@
+---
+layout: bidder
+title: Clydo
+description: Prebid Clydo Bidder Adapter
+biddercode: clydo
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: false
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `partnerId` | required | Partner Id | `'adpartnerid'`                           | `'string'` |
+| `region` | required | Region | `'us'`                           | `'string'` |
+
+### Note
+
+partnerId is required parameter for both prebid server and prebid.js.
+Allowed values for region field are: [us, usw, eu, apac]. 
+If the region is not passed when using the prebid server, the default value "us" will be set.
\ No newline at end of file

From b208f87435cd1892e59ce00ed2fcfb7edb56d768 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Tue, 13 Jan 2026 14:49:34 +0100
Subject: [PATCH 441/665] docs: document WURFL Device Detection Module for
 Prebid Server (#6279)

* docs: document WURFL Device Detection Module for Prebid Server

This commit adds documentation for the WURFL Device Module in Prebid
Server (Go and Java).

* docs: document WURFL module requires non-open source dependencies

This commit adds documentation for the WURFL Device Module in Prebid
Server (Go and Java).

* docs: document WURFL module requires non-open source dependencies

This commit adds documentation for the WURFL Device Module in Prebid
Server (Go and Java).
---
 prebid-server/pbs-modules/index.md            |   1 +
 .../pbs-modules/wurfl-device-detection.md     | 327 ++++++++++++++++++
 2 files changed, 328 insertions(+)
 create mode 100644 prebid-server/pbs-modules/wurfl-device-detection.md

diff --git a/prebid-server/pbs-modules/index.md b/prebid-server/pbs-modules/index.md
index 59360ea4f8..16044e10a7 100644
--- a/prebid-server/pbs-modules/index.md
+++ b/prebid-server/pbs-modules/index.md
@@ -37,6 +37,7 @@ The full list of modules:
 | [**Request Correction**](/prebid-server/pbs-modules/request-correction.html) | Apply optional corrections to bid requests. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Response Correction**](/prebid-server/pbs-modules/response-correction.html) | Apply optional corrections to bid responses. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Optable Targeting**](/prebid-server/pbs-modules/optable-targeting.html) | Enrich `user.ext.eids`, `user.ext.data`. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| [**WURFL Device Detection**](/prebid-server/pbs-modules/wurfl-device-detection.html) | Enriches an incoming OpenRTB request with WURFL Device Data | <span style="color: green">✓</span> | <span style="color: green">✓</span> |
 
 ## Installing a PBS General Module
 
diff --git a/prebid-server/pbs-modules/wurfl-device-detection.md b/prebid-server/pbs-modules/wurfl-device-detection.md
new file mode 100644
index 0000000000..4cd20e5656
--- /dev/null
+++ b/prebid-server/pbs-modules/wurfl-device-detection.md
@@ -0,0 +1,327 @@
+---
+layout: page_v2
+page_type: pbs-module
+title: WURFL Device Detection Module
+display_name : WURFL Device Detection
+sidebarType : 5
+---
+
+# WURFL Device Detection Module
+{: .no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The WURFL Device Detection Module for Prebid Server enriches an incoming OpenRTB request with comprehensive device detection data powered by [ScientiaMobile's WURFL device detection framework](https://www.scientiamobile.com/wurfl-overview/). The module provides accurate and comprehensive device-related information, enabling bidders to make better-informed targeting and optimization decisions.
+
+The module operates using WURFL's on-premise device detection. For PBS-Java, it uses the WURFL OnSite Java API, while PBS-Go uses the WURFL Infuze API. The module operates fully autonomously and does not make any requests to any cloud services in real time to do device detection.
+
+## Key Features
+
+### Device Field Enrichment
+
+The WURFL module populates **missing or empty fields** in `ortb2.device` with the following data:
+
+* `make`: Manufacturer of the device (e.g., "Apple", "Samsung")
+* `model`: Device model (e.g., "iPhone 14", "Galaxy S22")
+* `os`: Operating system (e.g., "iOS", "Android")
+* `osv`: Operating system version (e.g., "16.0", "12.0")
+* `h`: Screen height in pixels
+* `w`: Screen width in pixels
+* `ppi`: Screen pixels per inch (PPI)
+* `pxratio`: Screen pixel density ratio
+* `devicetype`: Device type (e.g., mobile, tablet, desktop)
+* `js`: Support for JavaScript (0 = no, 1 = yes)
+
+{: .alert.alert-info :}
+**Note**: If these fields are already populated in the bid request, the module will not overwrite them.
+
+### Publisher-Specific Enrichment
+
+Device enrichment is selectively enabled for publishers based on their account ID. The module identifies publishers through the following fields:
+
+* `site.publisher.id` (for web environments)
+* `app.publisher.id` (for mobile app environments)  
+* `dooh.publisher.id` (for digital out-of-home environments)
+
+### Extended Capabilities
+
+When `ext_caps` is enabled, the module adds the WURFL device ID and all licensed capabilities to `device.ext.wurfl`.
+
+## Planning
+
+This module supports running at two stages:
+
+1. **entrypoint**: Called for all requests before they're validated
+2. **raw_auction_request**: Called for all valid requests before they're sent to bid adapters
+
+We recommend defining the execution plan right in the account config so the module is only invoked for specific accounts.
+
+## Setup
+
+### Prerequisites
+
+{: .alert.alert-info :}
+This module requires non-open source dependencies
+
+* **PBS-Java**: [WURFL OnSite Java API](https://docs.scientiamobile.com/documentation/onsite/onsite-java-api) - A commercial Java library for on-premise device detection
+* **PBS-Go**: [WURFL Infuze (libwurfl)](https://docs.scientiamobile.com/documentation/infuze/infuze-c-api-user-guide) - A commercial C library for on-premise device detection
+
+Both libraries require a license from ScientiaMobile for production use. Evaluation versions are available for testing purposes.
+
+#### PBS-Java Prerequisites
+
+In order to compile the WURFL module in the PBS Java server bundle using a licensed WURFL API, you must follow these steps:
+
+1. Change the URL in the `<repository>` tag in the module's `pom.xml` file to the ScientiaMobile Maven repository URL:
+   `https://maven.scientiamobile.com/repository/wurfl-onsite/`
+   
+   The repository is private and requires authentication: to set it up please check the paragraph "Configuring your Builds to work with ScientiaMobile's Private Maven Repository" [on this page](https://docs.scientiamobile.com/documentation/onsite/onsite-java-api).
+
+1. Change the `artifactId` value in the module's `pom.xml` from `wurfl-mock` to `wurfl`
+
+1. Update the `wurfl.version` property value to the latest WURFL Onsite Java API version available.
+
+When the `pom.xml` references the mock API artifact, the module will compile a demo version that returns sample data, allowing basic testing without a WURFL Onsite Java API license.
+
+1. Build the Prebid Server Java bundle with the WURFL module:
+
+   ```bash
+   mvn clean package --file extra/pom.xml
+   ```
+
+#### PBS-Go Prerequisites
+
+To build the WURFL module for PBS-Go, you need to install the WURFL Infuze from ScientiaMobile.
+For more details, visit: [ScientiaMobile WURFL Infuze](https://docs.scientiamobile.com/documentation/infuze/infuze-c-api-user-guide).
+
+{: .alert.alert-warning :}
+**Note**: The WURFL module requires CGO at compile time to link against the WURFL Infuze library.
+
+To enable the WURFL module, the `wurfl` build tag must be specified:
+
+```bash
+go build -tags wurfl .
+```
+
+### WURFL Data File
+
+A valid WURFL license must include all the required capabilities for device enrichment.
+
+The WURFL module requires a WURFL data file. Commercial licensees of WURFL are granted access to "The Customer Vault", a personal virtual space containing purchased software licenses and weekly updated versions of the WURFL repository.
+
+For evaluation purposes, you can use the sample `wurfl.zip` file included with the WURFL Infuze package (for PBS-Go) or the WURFL OnSite Java API package (for PBS-Java).
+
+For more details, visit: [ScientiaMobile WURFL](https://docs.scientiamobile.com/documentation/).
+
+## Configuration
+
+### Host Company
+
+There is no host-company level config for this module except the execution plan may optionally be at the host level.
+
+### Account
+
+#### PBS-Java Configuration
+
+Here's a general template for the account config:
+
+```yaml
+hooks:
+  wurfl-devicedetection:
+    enabled: true
+  host-execution-plan: >
+    {
+      "endpoints": {
+        "/openrtb2/auction": {
+          "stages": {
+            "entrypoint": {
+              "groups": [
+                {
+                  "timeout": 10,
+                  "hook-sequence": [
+                    {
+                      "module-code": "wurfl-devicedetection",
+                      "hook-impl-code": "wurfl-devicedetection-entrypoint-hook"
+                    }
+                  ]
+                }
+              ]
+            },
+            "raw-auction-request": {
+              "groups": [
+                {
+                  "timeout": 10,
+                  "hook-sequence": [
+                    {
+                      "module-code": "wurfl-devicedetection",
+                      "hook-impl-code": "wurfl-devicedetection-raw-auction-request"
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      }
+    }
+  modules:
+    wurfl-devicedetection:
+      file-dir-path: /path/to/wurfl_snapshot_dir
+      file-snapshot-url: https://data.scientiamobile.com/<your_wurfl_snapshot_url>/wurfl.zip
+      cache-size: 200000
+      update-frequency-in-hours: 24
+      allowed-publisher-ids: ["1", "3"]
+      ext-caps: false
+```
+
+#### PBS-Go Configuration
+
+Here's the Go version in YAML format:
+
+```yaml
+hooks:
+  enabled: true
+  modules:
+    scientiamobile:
+      wurfl_devicedetection:
+        enabled: true
+        wurfl_file_path: "/path/to/wurfl.zip"
+        wurfl_snapshot_url: "<wurfl_snapshot_url>"
+        wurfl_cache_size: 200000
+        allowed_publisher_ids:
+          - "1"
+          - "3"
+        ext_caps: true
+  host_execution_plan:
+    endpoints:
+      /openrtb2/auction:
+        stages:
+          entrypoint:
+            groups:
+              - timeout: 10
+                hook_sequence:
+                  - module_code: "scientiamobile.wurfl_devicedetection"
+                    hook_impl_code: "scientiamobile-wurfl_devicedetection-entrypoint-hook"
+          raw_auction_request:
+            groups:
+              - timeout: 10
+                hook_sequence:
+                  - module_code: "scientiamobile.wurfl_devicedetection"
+                    hook_impl_code: "scientiamobile-wurfl_devicedetection-raw-auction-request-hook"
+```
+
+### Configuration Parameters
+
+#### PBS-Java Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Parameter | Required | Type | Default | Description |
+|-----------|----------|------|---------|-------------|
+| `file-dir-path` | Yes | string | - | Path to the directory where the WURFL file is downloaded. Directory must exist and be writable. |
+| `file-snapshot-url` | Yes | string | - | URL of the licensed WURFL snapshot file to be downloaded when PBS starts. |
+| `cache-size` | No | integer | WURFL default | Maximum number of devices stored in the WURFL cache. |
+| `ext-caps` | No | boolean | false | If `true`, adds all licensed capabilities to `device.ext`. |
+| `update-frequency-in-hours` | No | integer | 24 | Check interval (hours) for downloading updated WURFL file if modified. |
+| `allowed-publisher-ids` | No | array | All publishers | List of publisher IDs permitted to use the module. |
+
+#### PBS-Go Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Parameter | Required | Type | Default | Description |
+|-----------|----------|------|---------|-------------|
+| `wurfl_file_path` | Yes | string | - | Path to the WURFL file (e.g. /path/to/wurfl.zip). |
+| `wurfl_snapshot_url` | No | string | - | URL of the licensed WURFL snapshot. If set, periodically updates the WURFL file. |
+| `wurfl_cache_size` | No | integer | WURFL default | Maximum number of devices stored in the WURFL cache. |
+| `ext_caps` | No | boolean | false | If `true`, adds all licensed capabilities to `device.ext`. |
+| `allowed_publisher_ids` | No | array | All publishers | List of publisher IDs permitted to use the module. |
+
+## Running Prebid Server
+
+### PBS-Java
+
+After configuring the module and successfully building the Prebid Server bundle:
+
+```bash
+java -jar target/prebid-server-bundle.jar --spring.config.additional-location=sample/configs/prebid-config-with-wurfl.yaml
+```
+
+When the server starts, it downloads the WURFL file from the `file-snapshot-url` and loads it into the module.
+
+### PBS-Go
+
+1. Download dependencies:
+
+   ```bash
+   go mod download
+   ```
+
+2. Copy the WURFL file to the configured `wurfl_file_path` location
+
+3. Start the server:
+
+   ```bash
+   go run -tags wurfl .
+   ```
+
+When the server starts, it loads the WURFL file from `wurfl_file_path` into the module. To enable automatic updates, ensure that `wurfl_snapshot_url` is correctly configured.
+
+#### Demo Mode (PBS-Go)
+
+To test the WURFL module without an Infuze license:
+
+```bash
+go run .
+```
+
+## Sample Response
+
+Using sample request data when the module is configured with `ext_caps` set to `false`:
+
+```json
+"device": {
+  "ua": "Mozilla/5.0 (Linux; Android 15; Pixel 9 Pro XL Build/AP3A.241005.015;) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36 EdgA/124.0.2478.64",
+  "devicetype": 1,
+  "make": "Google",
+  "model": "Pixel 9 Pro XL",
+  "os": "Android",
+  "osv": "15",
+  "h": 2992,
+  "w": 1344,
+  "ppi": 481,
+  "pxratio": 2.55,
+  "js": 1,
+  "ext": {
+    "wurfl": {
+      "wurfl_id": "google_pixel_9_pro_xl_ver1_suban150"
+    }
+  }
+}
+```
+
+When `ext_caps` is set to `true`, the response will include all licensed capabilities in `device.ext.wurfl`, such as:
+
+* Device form factor information
+* Browser details  
+* Hardware specifications
+* OS and app version details
+* Network capabilities
+* And many more device properties
+
+## Analytics Tags
+
+This module does not currently produce any analytics tags.
+
+## Maintainer
+
+For questions or support regarding the WURFL Device Detection module, please contact:
+[prebid@scientiamobile.com](mailto:prebid@scientiamobile.com)
+
+## Further Reading
+
+* [WURFL by ScientiaMobile](https://www.scientiamobile.com/)
+* [Prebid Server Module List](/prebid-server/pbs-modules/index.html)

From 6f210eb3fb4bb9ed82df335b0882c11733b75656 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Wed, 14 Jan 2026 19:18:06 +0100
Subject: [PATCH 442/665] fix: standardize WURFL module table formatting
 (#6393)

---
 prebid-server/pbs-modules/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prebid-server/pbs-modules/index.md b/prebid-server/pbs-modules/index.md
index 16044e10a7..a4040fb96e 100644
--- a/prebid-server/pbs-modules/index.md
+++ b/prebid-server/pbs-modules/index.md
@@ -37,7 +37,7 @@ The full list of modules:
 | [**Request Correction**](/prebid-server/pbs-modules/request-correction.html) | Apply optional corrections to bid requests. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Response Correction**](/prebid-server/pbs-modules/response-correction.html) | Apply optional corrections to bid responses. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 | [**Optable Targeting**](/prebid-server/pbs-modules/optable-targeting.html) | Enrich `user.ext.eids`, `user.ext.data`. | general | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
-| [**WURFL Device Detection**](/prebid-server/pbs-modules/wurfl-device-detection.html) | Enriches an incoming OpenRTB request with WURFL Device Data | <span style="color: green">✓</span> | <span style="color: green">✓</span> |
+| [**WURFL Device Detection**](/prebid-server/pbs-modules/wurfl-device-detection.html) | Enriches an incoming OpenRTB request with WURFL Device Data | general | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
 
 ## Installing a PBS General Module
 

From 8865949b0cc430e55edacdad55a543f20986ebb9 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Wed, 14 Jan 2026 23:04:47 +0100
Subject: [PATCH 443/665] Adding missing closing ) (#6387)

---
 dev-docs/publisher-api-reference/setConfig.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 2e9c9916eb..28d78f8fe8 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1022,7 +1022,7 @@ The `ortb2` JSON structure reflects the OpenRTB standard:
 
 **Scenario 2** - Auction (cross-adunit) First Party Data open to all bidders
 
-If a page needs to specify multiple different sets of top-level data (`site`, `user`, or `app`), use the `ortb2` parameter of [`requestBids`](/dev-docs/publisher-api-reference/setConfig.html) ([example](/features/firstPartyData.html#supplying-auction-specific-data)  
+If a page needs to specify multiple different sets of top-level data (`site`, `user`, or `app`), use the `ortb2` parameter of [`requestBids`](/dev-docs/publisher-api-reference/setConfig.html) ([example](/features/firstPartyData.html#supplying-auction-specific-data)).  
 
 **Scenario 3** - Global (cross-adunit) First Party Data open only to a subset of bidders
 

From adc4af1425c3433c81ee85560519cab0f7d17887 Mon Sep 17 00:00:00 2001
From: Brett Oberg <bjoberg@amazon.com>
Date: Sat, 17 Jan 2026 00:29:08 -0800
Subject: [PATCH 444/665] APS Bid Adapter Initial Release (#6363)

**Overview**
------------
APS (Amazon Publisher Services) bid adapter initial open source release.

**Changes**
-----------
- (docs) Integration guide
---
 dev-docs/aps.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 dev-docs/aps.md

diff --git a/dev-docs/aps.md b/dev-docs/aps.md
new file mode 100644
index 0000000000..d9ed601f49
--- /dev/null
+++ b/dev-docs/aps.md
@@ -0,0 +1,58 @@
+---
+layout: bidder
+title: APS
+description: Prebid APS Bidder Adapter
+biddercode: aps
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 793
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: display, video
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+ortb_blocking_supported: true
+pbjs: true
+pbs: false
+prebid_member: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+### Bidder Config Params
+
+{: .table .table-bordered .table-striped }
+
+| Name               | Scope    | Description                              | Example                           | Type      |
+| ------------------ | -------- | ---------------------------------------- | --------------------------------- | --------- |
+| `aps.accountID`    | required | APS-provided ID                          | `1234`                            | `string`  |
+| `aps.debugURL`     | optional | Bid endpoint                             | `https://example.com/bid`         | `string`  |
+| `aps.debug`        | optional | Toggle to enable / disable debug mode    | `true`                            | `boolean` |
+| `aps.renderMethod` | optional | Debug mode render method                 | `fif`                             | `string`  |
+| `aps.creativeURL`  | optional | Creative rendering URL                   | `https://example.com/creative.js` | `string`  |
+| `aps.telemetry`    | optional | Toggle to enable / disable APS telemetry | `true`                            | `boolean` |
+
+### Bid Params
+
+None.
+
+## User Syncs
+
+If you'd like to activate user syncs through APS, you must activate iframe syncing.
+
+```javascript
+window.pbjs.que.push(function () {
+  window.pbjs.setConfig({
+    userSync: {
+      filterSettings: {
+        iframe: {
+          bidders: ['aps'],
+          filter: 'include',
+        },
+      },
+    },
+  });
+});
+```

From 4e4a35a5f6174175d80d80d9bc271ecfb1961d97 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Sun, 18 Jan 2026 17:44:36 +0100
Subject: [PATCH 445/665] alwaysHasCapacity flag (#6395)

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/bidder-adaptor.md                    | 4 +++-
 dev-docs/modules/prebidServer.md              | 1 +
 dev-docs/publisher-api-reference/setConfig.md | 8 ++++++++
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 6836a1506f..2926915754 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -238,7 +238,8 @@ export const spec = {
     onSetTargeting: function(bid) {},
     onBidderError: function({ error, bidderRequest }) {},
     onAdRenderSucceeded: function(bid) {},
-    supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO]
+    supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO],
+    alwaysHasCapacity: true // When true, this bidder will be omitted in checking if origin has http capacity
 }
 registerBidder(spec);
 
@@ -1190,6 +1191,7 @@ export const spec = {
         code: BIDDER_CODE,
     gvlid: 0000000000,
     supportedMediaTypes: [BANNER, VIDEO, NATIVE],
+    alwaysHasCapacity: true,
         aliases: [{code: "myAlias", gvlid: 99999999999} ],
         /**
          * Determines whether or not the given bid request is valid.
diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index 627a94a890..50bfac23b0 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -99,6 +99,7 @@ There are many configuration options for s2sConfig:
 | `customHeaders` | Optional | Object | These custom headers will be included in the XHR call to the bidder's endpoint. This will allow you to send data specific to your use case. The format consists of an object where the keys represent the header names and the values correspond to the respective header values. Here is an example how a customHeader object might look like - `{"Header1": "Value1", "Header2": "Value2"}`|
 | `endpointCompression` | Optional | Boolean | Gzip compress the auction request payload when supported and debug mode is off. Adds `gzip=1` to the request URL. |
 | `filterBidderlessCalls` | Optional | Boolean | When `true`, ad units that have no bidders defined are excluded from Prebid Server requests. Defaults to `false`. | `true` |
+| `alwaysHasCapacity` | Optional | Boolean | When `true`, this prebid server instance will be omitted in checking if origin has http capacity, defaults to `false` |
 
 If `endpoint` and `syncEndpoint` are objects, these are the supported properties:
 
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 28d78f8fe8..0268466fa6 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -115,6 +115,14 @@ pbjs.setConfig({ maxRequestsPerOrigin: 6 });
 pbjs.setConfig({ maxRequestsPerOrigin: 1 });
 ```
 
+Note: Prebid adapters or Prebid Server instances can be omitted from this capacity check if they declare `alwaysHasCapacity: true`. See [bidder adapter configuration](/dev-docs/bidder-adaptor.html) and [Prebid Server configuration](/dev-docs/modules/prebidServer.html) for more details.
+
+Although, `maxRequestsPerOrigin` can still be forced by the publisher using:
+
+```javascript
+pbjs.setConfig({ maxRequestsPerOrigin: 1, forceMaxRequestsPerOrigin: true });
+```
+
 ### Disable Ajax Timeout
 
 <a name="setConfig-Disable-Ajax-Timeout"></a>

From 675ec84bcc636a239e8c35ad33a81ee92eb2316d Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Sun, 18 Jan 2026 17:45:48 +0100
Subject: [PATCH 446/665] deferS2Sbidders (#6377)

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/modules/tcfControl.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/modules/tcfControl.md b/dev-docs/modules/tcfControl.md
index c3d385eeaa..df8e64a7cd 100644
--- a/dev-docs/modules/tcfControl.md
+++ b/dev-docs/modules/tcfControl.md
@@ -79,6 +79,7 @@ The following fields related to anonymizing aspects of the auction are supported
 | gdpr.rules[].softVendorExceptions | `Array of Strings` | Defines a list of biddercodes or module names that are exempt from the checking vendor signals for this purpose. Unlike with `vendorExceptions`, Purpose consent is still checked. **Note:** Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor. | ["bidderA", "userID-module-B"] |
 | gdpr.rules[].eidsRequireP4Consent | `Boolean` | Only relevant on the personalizedAds `purpose`. If true, user IDs and EIDs will not be shared without evidence of consent for TCF Purpose 4. If false, evidence of consent for any of Purposes 2-10 is sufficient for sharing user IDs and EIDs. Defaults to false. See [note](#note-transmitEids) | true |
 | strictStorageEnforcement | `Boolean` | If false (the default), allows some use of storage regardless of purpose 1 consent - see [note](#strictStorageEnforcement) below | true |
+| gdpr.rules[].deferS2Sbidders | `Boolean` | If true, allows s2s bidders to bypass vendor consent check and delegate it to server. Applies only to `basicAds` rule. Defaults to true | true |
 
 Notes:
 

From abcf9a9656d8406cf37bd95ff0677b9af10d114c Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Sun, 18 Jan 2026 18:46:45 +0200
Subject: [PATCH 447/665] Adkernel: documenting AppMonsta alias (#6380)

---
 dev-docs/bidders/appmonsta.md | 42 +++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/appmonsta.md

diff --git a/dev-docs/bidders/appmonsta.md b/dev-docs/bidders/appmonsta.md
new file mode 100644
index 0000000000..2a46266b15
--- /dev/null
+++ b/dev-docs/bidders/appmonsta.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: AppMonsta
+description: AppMonsta Adaptor
+biddercode: appmonsta
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 1283
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The AppMonsta bidding adaptor requires setup and approval before beginning. Please reach out to <media.support@appmonsta.ai> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.appmonsta.ai'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From d40d29585cb9ea0f18a88d1b5d5a61129c7e6613 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Artur=20Szyd=C5=82o?= <artur.szydlo@ringieraxelspringer.pl>
Date: Sun, 18 Jan 2026 17:50:49 +0100
Subject: [PATCH 448/665] DAS Bid Adapter: (#6326)

- added documentation
---
 dev-docs/bidders/das.md | 44 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 dev-docs/bidders/das.md

diff --git a/dev-docs/bidders/das.md b/dev-docs/bidders/das.md
new file mode 100644
index 0000000000..176ac3b7ae
--- /dev/null
+++ b/dev-docs/bidders/das.md
@@ -0,0 +1,44 @@
+---
+layout: bidder
+title: DAS
+description: Prebid DAS Bidder Adapter
+biddercode: das
+media_types: banner, native
+pbjs: true
+pbs: false
+prebid_member: false
+gvl_id: 1021
+tcfeu_supported: true
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+sidebarType: 1
+multiformat_supported: will-bid-on-one
+dsa_supported: true
+privacy_sandbox: paapi
+ortb_blocking_supported: false
+schain_supported: false
+dchain_supported: false
+gpp_sids: None
+coppa_supported: false
+usp_supported: false
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name             | Scope    | Description                                                                                          | Example                                     | Type     |
+|------------------|----------|------------------------------------------------------------------------------------------------------|---------------------------------------------|----------|
+| `network`        | required | Specific identifier provided by RAS                                                                  | `'4178463'`                                   | `string` |
+| `site`           | required | Specific identifier name (case-insensitive) that is associated with this ad unit. Represents the website/domain in the ad unit hierarchy | `'example_com'`                             | `string` |
+| `area`           | required | Ad unit category name; only case-insensitive alphanumeric with underscores and hyphens are allowed. Represents the content section or category     | `'sport'`                                   | `string` |
+| `slot`           | required | Ad unit placement name (case-insensitive) provided by RAS                                            | `'slot'`                                    | `string` |
+| `pageContext`    | optional | Web page context data                                                                                | `{}`                                        | `object` |
+| `pageContext.dr` | optional | Document referrer URL address                                                                        | `'https://example.com/'`                    | `string` |
+| `pageContext.du` | optional | Document URL address                                                                                 | `'https://example.com/sport/football/article.html?id=932016a5-02fc-4d5c-b643-fafc2f270f06'` | `string` |
+| `pageContext.dv` | optional | Document virtual address as slash-separated path that may consist of any number of parts (case-insensitive alphanumeric with underscores and hyphens); first part should be the same as `site` value and second as `area` value; next parts may reflect website navigation | `'example_com/sport/football'`              | `string` |
+| `pageContext.keyWords` | optional | List of keywords associated with this ad unit; only case-insensitive alphanumeric with underscores and hyphens are allowed | `['euro', 'lewandowski']` | `string[]` |
+| `pageContext.keyValues` | optional | Key-values associated with this ad unit (case-insensitive); following characters are not allowed in the values: `" ' = ! + # * ~ ; ^ ( ) < > ] [ & @` | `{}`                    | `object` |
+| `pageContext.keyValues.ci`    | optional | Content unique identifier                                                                | `'932016a5-02fc-4d5c-b643-fafc2f270f06'`                                        | `object` |
+| `pageContext.keyValues.adunit` | optional | Ad unit name                                                                           | `'example_com/sport'`                    | `string` |

From 2dbe2980a20d6491bfad70063b2ec32c3f20d779 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Sun, 18 Jan 2026 08:52:20 -0800
Subject: [PATCH 449/665] Document new requestBids event argument (#6378)

---
 dev-docs/publisher-api-reference/getEvents.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/getEvents.md b/dev-docs/publisher-api-reference/getEvents.md
index 1dd6744d91..6462ad9eb1 100644
--- a/dev-docs/publisher-api-reference/getEvents.md
+++ b/dev-docs/publisher-api-reference/getEvents.md
@@ -23,7 +23,7 @@ The `getEvents` method returns a copy of all emitted events since the page loade
 The available events are:
 
 {: .table .table-bordered .table-striped }
-| Event         | Description                             | Callback Arguments |
+| Event         | Description                             | Event argument |
 | --- | --- | --- |
 | auctionInit   | The auction has started                 | Object containing auction details |
 | auctionEnd    | The auction has ended                   | Object containing auction details |
@@ -38,7 +38,7 @@ The available events are:
 | bidWon        | A bid has won                           | Bid response object |
 | bidTimeout    | A bid timed out                         | Array of objects with timed out bids |
 | setTargeting  | Targeting has been set                  | Hash of targeting values |
-| requestBids   | Bids have been requested from adapters (i.e. pbjs.requestBids() was called) | None |
+| requestBids   | Bids have been requested from adapters (i.e. pbjs.requestBids() was called) | The argument passed to [`requestBids`](https://docs.prebid.org/dev-docs/publisher-api-reference/requestBids.html), except that `adUnits` and `adUnitCodes` are always set and reflect the ad units involved in the auction. Event handlers may not modify `adUnitCodes`. |
 | addAdUnits    | Ad units have been added to the auction | None |
 | adRenderFailed| Ad rendering failed | Object containing 'reason' and 'message' |
 | adRenderSucceeded | Ad rendering succeeded| Object containing 'doc', 'bid', and 'adId'. 'doc' is the DOM root containing the ad and may be `null` if it was rendered in a cross-origin iframe. This event indicates that the render function did not generate an error, it does not guarantee that tracking for this event has occurred yet.|

From 26b04f9e2f4762fc2438c2cb7436b85e4a11ef01 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Sun, 18 Jan 2026 17:56:26 +0100
Subject: [PATCH 450/665] mocking bids in examples (#6396)

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/examples/in-renderer-integration.md     | 16 ++++++++++++++++
 ...-ve-outstream-no-server-specify-renderer.html | 16 ++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/dev-docs/examples/in-renderer-integration.md b/dev-docs/examples/in-renderer-integration.md
index 4810f8633a..bb2986d50e 100644
--- a/dev-docs/examples/in-renderer-integration.md
+++ b/dev-docs/examples/in-renderer-integration.md
@@ -53,6 +53,22 @@ var adUnit = {
 };
 
 pbjs.que.push(function() {
+  pbjs.setConfig({
+    debugging: {
+      enabled: true,
+      intercept: [
+        {
+          when: {
+            bidder: 'michao',
+          },
+          then: {
+            cpm: 10,
+            mediaType: "video",
+          }
+        }
+      ]
+    }
+  });
   pbjs.addAdUnits(adUnit);
   pbjs.requestBids({
     timeout: 5000,
diff --git a/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html b/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
index 8321849a81..eb53b2dd88 100644
--- a/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
+++ b/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
@@ -143,6 +143,22 @@ <h4>Place this code in the page header.</h4>
       }];
 
       pbjs.que.push(function() {
+          pbjs.setConfig({
+            debugging: {
+              enabled: true,
+              intercept: [
+                {
+                  when: {
+                    bidder: 'appnexus',
+                  },
+                  then: {
+                    cpm: 10,
+                    mediaType: "video",
+                  }
+                }
+              ]
+            }
+          });
           pbjs.addAdUnits(adUnits);
           pbjs.requestBids({
               timeout: 1000,

From bfc822f50a99bc95e80d481f74a0144fb87cba5f Mon Sep 17 00:00:00 2001
From: videoheroes <104137322+videoheroes@users.noreply.github.com>
Date: Tue, 20 Jan 2026 08:32:16 +0200
Subject: [PATCH 451/665] Update videoheroes.md (#6400)

Updated dev-docs bidder document by adding GVL id and TCF EU support
---
 dev-docs/bidders/videoheroes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/bidders/videoheroes.md b/dev-docs/bidders/videoheroes.md
index 637d9326ed..85f1c4103a 100644
--- a/dev-docs/bidders/videoheroes.md
+++ b/dev-docs/bidders/videoheroes.md
@@ -15,6 +15,8 @@ pbs: true
 floors_supported: true
 pbs_app_supported: true
 sidebarType: 1
+gvl_id: 1083
+tcfeu_supported: true
 ---
 
 ### Note

From 44dde6ea7e9f15fb3797ab2f5f06ec1eb7d4b3e9 Mon Sep 17 00:00:00 2001
From: Prebid-Team <prebid-team@vertoz.com>
Date: Tue, 20 Jan 2026 18:43:08 +0530
Subject: [PATCH 452/665] Update filename incrementxBidAdapter in incrementx.md
 (#6382)

* Change the filename incrxBidAdapter to incrementxBidAdapter in incrementx.md

* Remove filename override

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/incrementx.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/dev-docs/bidders/incrementx.md b/dev-docs/bidders/incrementx.md
index d33fcda5a3..ba1ea70bae 100644
--- a/dev-docs/bidders/incrementx.md
+++ b/dev-docs/bidders/incrementx.md
@@ -7,7 +7,6 @@ biddercode: incrementx
 media_types: banner, video
 tcfeu_supported: false
 multiformat_supported: will-bid-on-one
-filename: incrxBidAdapter
 sidebarType: 1
 ---
 

From b34ac6babddc5c170723c0cd1ba5096cca28104d Mon Sep 17 00:00:00 2001
From: trustXops <prebid@trustx.org>
Date: Fri, 23 Jan 2026 18:32:52 +0100
Subject: [PATCH 453/665] Trustx bidder adapter (#6355)

* TrustX Adapter: Update documentation

Update TrustX adapter documentation to reflect standalone adapter:
- Remove grid alias and GDPR fields
- Add secid, currency, and test parameters
- Update FPD supported fields

* Update required fields/notes

* Update uid/secid notes

* Define uid/secid as integer

* update adapter documentation

- Remove localStorage/Bidder Config section
- Remove keywords parameter and examples and references to ext.keywords
- Update First Party Data field descriptions

* Remove legacy trustxstandalone bidder documentation
---
 dev-docs/bidders/trustx.md           | 86 ++++++----------------------
 dev-docs/bidders/trustxstandalone.md | 51 -----------------
 2 files changed, 18 insertions(+), 119 deletions(-)
 delete mode 100644 dev-docs/bidders/trustxstandalone.md

diff --git a/dev-docs/bidders/trustx.md b/dev-docs/bidders/trustx.md
index 05ac4e2976..dd89ded096 100644
--- a/dev-docs/bidders/trustx.md
+++ b/dev-docs/bidders/trustx.md
@@ -1,23 +1,18 @@
 ---
 layout: bidder
-title: TrustX
-description: Prebid TrustX Bidder Adaptor
+title: TRUSTX
+description: Prebid TRUSTX Bidder Adapter
 pbjs: true
 pbs: true
 biddercode: trustx
-aliasCode: grid
 media_types: banner, video
 multiformat_supported: will-bid-on-any
-gvl_id: 686 (grid)
-tcfeu_supported: true
 usp_supported: true
 schain_supported: true
 floors_supported: true
 userIds: all
-tcf2_supported: true
 coppa_supported: true
 fpd_supported: true
-pbjs_version_notes: 7.0 and after
 sidebarType: 1
 ---
 
@@ -25,73 +20,22 @@ sidebarType: 1
 
 - [Table of Contents](#table-of-contents)
 - [Bid Params](#bid-params)
-- [Bidder Config](#bidder-config)
 - [First Party Data](#first-party-data)
 
-<a name="trustx-bid-params"></a>
-
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name           | Scope     | Description                                                                                              | Example                                   | Type      |
 |----------------|-----------|----------------------------------------------------------------------------------------------------------|-------------------------------------------|-----------|
-| `uid`          | required  | Represents the TrustX bidder system Ad Slot ID associated with the respective div id from the site page. | `42`                                      | `integer` |
-| `keywords`     | optional  | A set of key-value pairs applied to all ad slots on the page. Values can be empty.                       | `keywords: { topic: ['stress', 'fear'] }` | `object`  |
+| `uid`          | required* | Represents the TRUSTX bidder system Ad Slot ID. Alternative to `secid`.                                 | `42`                                      | `integer` |
+| `secid`        | required* | Alternative to `uid`. Represents the TRUSTX bidder system Ad Slot ID.                                     | `42`                                      | `integer` |
 | `bidFloor`     | optional  | Floor of the impression opportunity. If present in the request overrides XML info.                       | `0.8`                                     | `float`   |
+| `currency`     | optional  | Currency for bid floor. Defaults to `USD`.                                                               | `USD`                                     | `string`  |
+| `test`         | optional  | Enable test mode to receive test creatives without real Ad Slots.                                     | `true`                                    | `boolean` |
 
-Parameter `keywords` must have following format:
-
-```javascript
-{
-   "site":{
-      "publisher1":[
-         {
-            "name":"SomeKeywordsBlockName",
-            "segment1Name":[
-               "segment2Value"
-            ],
-            "segment2Name":[
-               "segment2Value1",
-               "segment2Value2",
-               ...
-            ],
-            ...
-         }
-      ],
-      ...
-   }
-}
-```
-
-<a name="trustx-bidder-config"></a>
-
-### Bidder Config
-
-You can allow writing in localStorage `pbjs.setBidderConfig` for the bidder `trustx`
-
-```javascript
-pbjs.setBidderConfig({
-    bidders: ["trustx"],
-    config: {
-        localStorageWriteAllowed: true
-    }
-})
-```
-
-If it will be "true" this allow TheMediaGrid Bid Adapter to write userId in first party localStorage
-
-If you want to make alias on TrustX Bid Adapter, you must set `forceBidderName` in bidderConfig as `"trustx"`.
-
-```javascript
-pbjs.setBidderConfig({
-    bidders: ["aliasName"],
-    config: {
-        forceBidderName: 'trustx'
-    }
-})
-```
+\* Either `uid` or `secid` is required (one of them must be provided).
 
-<a name="trustx-first-party"></a>
+**Note:** The adapter also supports Prebid's Floor Module via `getFloor()` function.
 
 ### First Party Data
 
@@ -101,11 +45,17 @@ Global site or user data using `setConfig()`, or Bidder-specific using `setBidde
 
 - `ortb2.user.data[]`: Standard IAB segment taxonomy user data
 - `ortb2.user.ext.device`: Non standard arbitrary user device
-- `ortb2.user.keywords`: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2
-- `ortb2.site.keywords`: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2
-- `ortb2.site.cat[]`: Standard IAB OpenRTB 2.5 site.cat field. It will be sent as part of site.cat array
-- `ortb2.site.pagecat[]`: Standard IAB OpenRTB 2.5 site.pagecat field. It will be sent as part of site.cat array
+- `ortb2.user.keywords`: Standard IAB OpenRTB 2.5 user.keywords field
+- `ortb2.site.keywords`: Standard IAB OpenRTB 2.5 site.keywords field
+- `ortb2.site.cat[]`: Standard IAB OpenRTB 2.5 site.cat field
+- `ortb2.site.pagecat[]`: Standard IAB OpenRTB 2.5 site.pagecat field
 - `ortb2.site.content.genre`: Standard IAB OpenRTB 2.5 site.content.genre field
+- `ortb2.site.content.data[]`: Standard IAB OpenRTB 2.5 site.content.data field
+- `ortb2.site.content.id`: Standard IAB OpenRTB 2.5 site.content.id field
+- `ortb2.site.content.title`: Standard IAB OpenRTB 2.5 site.content.title field
+- `ortb2.source.tid`: Transaction ID from source
+- `ortb2.source.ext.schain`: Supply chain object
+- `ortb2.regs.ext.dsa`: Digital Services Act (DSA) data
 
 AdUnit-specific data using `AdUnit.ortb2Imp` supports following fields:
 
diff --git a/dev-docs/bidders/trustxstandalone.md b/dev-docs/bidders/trustxstandalone.md
deleted file mode 100644
index df9726bff2..0000000000
--- a/dev-docs/bidders/trustxstandalone.md
+++ /dev/null
@@ -1,51 +0,0 @@
----
-layout: bidder
-title: TrustX (standalone)
-description: Prebid TrustX Bidder Adaptor
-pbjs: true
-biddercode: trustx
-media_types: banner, video
-multiformat_supported: will-bid-on-any
-tcfeu_supported: false
-usp_supported: true
-fpd_supported: true
-pbjs_version_notes: 6.x and before
-sidebarType: 1
----
-
-#### Is relevant for versions 6.X and before
-
-### Table of Contents
-
-- [Table of Contents](#table-of-contents)
-- [Bid Params](#bid-params)
-- [First Party Data](#first-party-data)
-
-<a name="trustx-bid-params"></a>
-
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name           | Scope                | Description                                                                                                                                                                                                         | Example                                   | Type      |
-|----------------|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|-----------|
-| `uid`          | required             | Represents the TrustX bidder system Ad Slot ID associated with the respective div id from the site page.                                                                                                            | `42`                                      | `integer` |
-| `priceType`    | optional (pbjs only) | Can take the values `gross` or `net`, default value is `net`. Net represents the header bid price with the TrustX header bidder margin already extracted. Gross price does contain the TrustX bidder margin within. | `'gross'`                                 | `string`  |
-| `keywords`     | optional (pbjs only) | A set of key-value pairs applied to all ad slots on the page. Values can be empty.                                                                                                                                  | `keywords: { topic: ['stress', 'fear'] }` | `object`  |
-| `useNewFormat` | optional (pbjs only) | Indicates to use the new ad request format.                                                                                                                                                                         | `true`                                    | `boolean` |
-
-<a name="trustx-first-party"></a>
-
-### First Party Data
-
-Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
-
-Global site or user data using `setConfig()`, or Bidder-specific using `setBidderConfig()` supports following fields:
-
-- `ortb2.user.data[]`: Standard IAB segment taxonomy user data
-- `ortb2.user.keywords`: Standard IAB OpenRTB 2.5 user.keywords field. It will be included in ext.keywords.user.ortb2
-- `ortb2.site.keywords`: Standard IAB OpenRTB 2.5 site.keywords field. It will be included in ext.keywords.site.ortb2
-
-AdUnit-specific data using `AdUnit.ortb2Imp` supports following fields:
-
-- `ortb2.imp[].ext.data.*`
-- `ortb2.imp[].instl`

From 2e047d1a186d6b3fdc96b19f6417f36fa53d6182 Mon Sep 17 00:00:00 2001
From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com>
Date: Fri, 30 Jan 2026 06:12:28 -0700
Subject: [PATCH 454/665] Add Prebid Agent Section and Salesagent PAge (#6416)

* add salesagent and agent nav

* fix typo

* fix linting and naming
---
 _data/sidebar.yml    |  29 +++++++++++
 agents/salesagent.md | 116 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 145 insertions(+)
 create mode 100644 agents/salesagent.md

diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index e3aacd894b..4b5d6df225 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -2042,3 +2042,32 @@
   isSectionHeader: 0
   sectionTitle:
   subgroup: 0
+
+#-------------- Prebid Agents --------------|
+
+- sbSecId: 10
+  title:
+  link:
+  isHeader: 0
+  isSectionHeader: 1
+  sectionTitle: Prebid Agents
+  sectionId: prebid-agents
+  subgroup: 1000
+  sbCollapseId: prebid-agents
+
+- sbSecId: 10
+  title: General
+  link:
+  isHeader: 1
+  headerId: agents-general
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 0
+
+- sbSecId: 10
+  title: Salesagent
+  link: /agents/salesagent.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 0
diff --git a/agents/salesagent.md b/agents/salesagent.md
new file mode 100644
index 0000000000..f849b35bf9
--- /dev/null
+++ b/agents/salesagent.md
@@ -0,0 +1,116 @@
+---
+layout: page_v2
+title: Salesagent
+description: A media sales agent that implements the AdCP Media Buy protocol
+sidebarType: 10
+---
+
+# Prebid Sales Agent
+
+The **Prebid Sales Agent** is a server that exposes advertising inventory to AI agents via the **Model Context Protocol (MCP)** and **Agent-to-Agent (A2A)** protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.
+
+<div class="alert alert-info" role="alert">
+  For the full source code and latest updates, visit the <a href="https://github.com/prebid/salesagent">prebid/salesagent repository</a>.
+</div>
+
+## Key Features
+
+### For AI Agents
+
+- **Product Discovery**: Natural language search for advertising products.
+- **Campaign Creation**: Automated media buying with targeting capabilities.
+- **Creative Management**: Streamlined upload and approval workflows.
+- **Performance Monitoring**: Real-time access to campaign metrics.
+
+### For Publishers
+
+- **Multi-Tenant System**: Isolates data per publisher for security and organization.
+- **Adapter Pattern**: Supports multiple ad servers (e.g., Google Ad Manager).
+- **Real-time Dashboard**: Live activity feed powered by Server-Sent Events (SSE).
+- **Workflow Management**: Unified system for human-in-the-loop approvals.
+- **Admin Interface**: Web UI with Google OAuth for easy management.
+
+### For Developers
+
+- **MCP Protocol**: Standard interface for AI agents.
+- **A2A Protocol**: Agent-to-Agent communication via JSON-RPC 2.0.
+- **REST API**: Programmatic tenant management.
+- **Docker Deployment**: Easy setup for both local and production environments.
+
+## Getting Started
+
+### Quick Start (Evaluation)
+
+You can try the sales agent locally using Docker:
+
+```bash
+# Clone and start
+git clone https://github.com/prebid/salesagent.git
+cd salesagent
+docker compose up -d
+
+# Test the MCP interface
+uvx adcp http://localhost:8000/mcp/ --auth test-token list_tools
+```
+
+Access services at [http://localhost:8000](http://localhost:8000):
+
+- **Admin UI**: `/admin` (Test credentials: `test123`)
+- **MCP Server**: `/mcp/`
+- **A2A Server**: `/a2a`
+
+### Production Deployment
+
+For production, publishers can deploy their own sales agent instance. The repository provides guides for various deployment methods, including Docker and cloud platforms.
+
+## The AdContext Protocol (AdCP)
+
+The Sales Agent is built on the **AdContext Protocol (AdCP)**, an open standard designed to standardize how AI agents interact with advertising platforms.
+
+<div class="alert alert-info" role="alert">
+  For comprehensive documentation, visit <a href="https://docs.adcontextprotocol.org/docs/intro">docs.adcontextprotocol.org</a>.
+</div>
+
+### Protocol Architecture
+
+AdCP operates as a layer on top of standard AI interaction protocols:
+
+- **MCP (Model Context Protocol)**: Facilitates direct integration with AI assistants (e.g., Claude Desktop).
+- **A2A (Agent-to-Agent Protocol)**: Enables complex, autonomous workflows and collaboration between agents using JSON-RPC 2.0.
+
+### Core Concepts
+
+AdCP abstracts complex advertising operations into standardized domains:
+
+1. **Inventory Discovery** (`get_products`): Agents can search for ad products using natural language criteria (e.g., "video ads in North America") rather than specific line item IDs.
+2. **Media Buying** (`create_media_buy`): A normalized workflow for proposal, negotiation, and booking that works consistently across different ad servers.
+3. **Creative Management** (`build_creative`): Standardized handling of creative assets, allowing agents to generate or upload assets that match publisher specifications.
+4. **Signal Activation** (`get_signals`, `activate_signal`): Mechanisms for passing context and identity signals to improve targeting and campaign performance.
+
+### Workflow Example
+
+A typical AI-driven campaign flow using AdCP might look like this:
+
+1. **Discovery**: Expected outcome is a list of available "Products" matching the agent's intent.
+2. **Planning**: The agent uses `create_media_buy` to submit a proposal.
+3. **Review**: The Sales Agent (and potentially a human publisher) reviews the proposal.
+4. **Execution**: Once approved, the Sales Agent pushes the orders to the underlying ad server (e.g., GAM).
+
+## Architecture
+
+The project follows a clean structure isolating core MCP components, business logic services, and ad server adapters.
+
+```text
+salesagent/
+├── src/
+│   ├── core/           # Core MCP server components
+│   ├── services/       # Business logic services
+│   ├── adapters/       # Ad server integrations (e.g., GAM)
+│   └── admin/          # Admin UI (Flask)
+├── scripts/            # Utility and deployment scripts
+└── tests/              # Comprehensive test suite
+```
+
+## Contributing
+
+Contributions are welcome! Please refer to the [Development Guide](https://github.com/prebid/salesagent/blob/main/docs/development/README.md) in the repository for details on setting up your environment and creating pull requests.

From 3759a84c51987fd6538f5ca645d04720e4ea87a6 Mon Sep 17 00:00:00 2001
From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com>
Date: Fri, 30 Jan 2026 07:04:23 -0700
Subject: [PATCH 455/665] fix bolding (#6417)

---
 agents/salesagent.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/agents/salesagent.md b/agents/salesagent.md
index f849b35bf9..4d8d3646f9 100644
--- a/agents/salesagent.md
+++ b/agents/salesagent.md
@@ -7,7 +7,7 @@ sidebarType: 10
 
 # Prebid Sales Agent
 
-The **Prebid Sales Agent** is a server that exposes advertising inventory to AI agents via the **Model Context Protocol (MCP)** and **Agent-to-Agent (A2A)** protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.
+The Prebid Sales Agent is a server that exposes advertising inventory to AI agents via the Model Context Protocol (MCP) and Agent-to-Agent (A2A) protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.
 
 <div class="alert alert-info" role="alert">
   For the full source code and latest updates, visit the <a href="https://github.com/prebid/salesagent">prebid/salesagent repository</a>.

From 0457b1e79fcadfd8c34a7a8afe211d9beb858cb6 Mon Sep 17 00:00:00 2001
From: yndxcdn <shvabenland@yango.com>
Date: Mon, 2 Feb 2026 15:16:39 +0300
Subject: [PATCH 456/665] Update yandex.md in dev-docs (#6415)

1. Fixed the Prebid Client text
2. Added contact info
3. Removed unnecessary information
---
 dev-docs/bidders/yandex.md | 89 ++------------------------------------
 1 file changed, 4 insertions(+), 85 deletions(-)

diff --git a/dev-docs/bidders/yandex.md b/dev-docs/bidders/yandex.md
index 1fbe3fc53c..f59cb15cf2 100644
--- a/dev-docs/bidders/yandex.md
+++ b/dev-docs/bidders/yandex.md
@@ -3,16 +3,15 @@ layout: bidder
 title: Yandex
 description: Prebid Yandex Bidder Adapter
 pbjs: true
-pbs: true
 biddercode: yandex
-media_types: banner, native
+media_types: banner
 sidebarType: 1
 privacy_sandbox: topics
 ---
 
 ### Prebid Client
 
-This Adapter integrates with Yandex's ad services.
+This Adapter integrates with Yandex's ad services. Please reach out to <prebid@yandex-team.com> for the integration guide and more details.
 
 {: .alert.alert-info :}
 For detailed auction analytics, check out our [Analytics Adapter](/dev-docs/analytics/yandex.html).
@@ -35,10 +34,10 @@ To improve the personalization of ads for publishers’ users, check out our [Us
 ```js
 // Simple banner
 const adUnits = [{
-  code: 'banner-1',
+  code: 'adunit-1',
   mediaTypes: {
     banner: {
-      sizes: [[240, 400]],
+      sizes: [[300, 250]],
     }
   },
   bids: [
@@ -51,50 +50,6 @@ const adUnits = [{
     }
   ]
 }];
-
-// Native
-const adUnits = [{
-  code: 'native-1',
-  mediaTypes: {
-    native: {
-      ortb: {
-        assets: [{
-            id: 1,
-            required: 1,
-            img: {
-              type: 3,
-              w: 300,
-              h: 300,
-            }
-          },
-          {
-            id: 2,
-            required: 1,
-            title: {
-              len: 80
-            }
-          },
-          {
-            id: 3,
-            required: 1,
-            data: {
-              type: 1
-            }
-          }
-        ]
-      }
-    }
-  },
-  bids: [
-    {
-      bidder: 'yandex',
-      params: {
-        placementId: 'R-A-346580-140',  // native adunit ID
-        cur: 'USD' // EUR, TRY, etc.
-      },
-    }
-  ]
-}];
 ```
 
 #### Topics Iframe Configuration
@@ -115,39 +70,3 @@ pbjs.setConfig({
   }
 })
 ```
-
-### Prebid Server
-
-{: .alert.alert-info :}
-We maintain both **PBS Java** and **PBS Go** adapters, but **PBS Go** is recommended for integration and will receive updates first
-
-#### Server Bid Params
-
-These params are basically the same that you'd use for 
-
-{: .table .table-bordered .table-striped }
-| Name           | Scope                                               | Description                        | Example         | Type      | Supported in     |
-| -------------- | --------------------------------------------------- | ---------------------------------- | --------------- | --------- | ---------------- |
-| `placement_id` | required                                            | Ad unit ID. Prebid versions > 7.30 | `R-A-1234567-1` | `String`  | PBS Go           |
-| `page_id`      | optional, **deprecated** in favor of `placement_id` | Page ID                            | `123`           | `Integer` | PBS Go, PBS Java |
-| `imp_id`       | optional, **deprecated** in favor of `placement_id` | Imp ID                             | `1`             | `Integer` | PBS Go, PBS Java |
-
-#### Prebid Server Test Request
-
-The following test parameters can be used to verify that Prebid Server is working properly with the
-server-side adapter.
-
-```json
-"imp": [{
-  "id": "imp_id",
-  "banner": {
-    "w": 300,
-    "h": 600
-  },
-  "ext": {
-    "bidder": {
-      "placement_id": "R-A-1234567-1"
-    }
-  }
-}]
-```

From 5729a13c4cf0c692f69675066d6007d6c328c2a1 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Mon, 2 Feb 2026 14:22:21 +0200
Subject: [PATCH 457/665] Adkernel: documenting Intellectscoop alias (#6412)

---
 dev-docs/bidders/intlscoop.md | 42 +++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/intlscoop.md

diff --git a/dev-docs/bidders/intlscoop.md b/dev-docs/bidders/intlscoop.md
new file mode 100644
index 0000000000..2826d335c1
--- /dev/null
+++ b/dev-docs/bidders/intlscoop.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: Intellectscoop
+description: Intellectscoop Adaptor
+biddercode: intlscoop
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+### Note
+
+The Intellectscoop bidding adaptor requires setup and approval before beginning. Please reach out to <apoorv@intellectscoop.com> for more details
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description           | Example                   | Type     |
+|----------|----------|-----------------------|---------------------------|----------|
+| `host`   | required | RTB host | `'cpm.intellectscoop.com'` | `string` |
+| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |

From a517ac42bacdbea7a374c2affe0ac50ce4c0da3f Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 2 Feb 2026 04:24:21 -0800
Subject: [PATCH 458/665] PBJS: document yield, legacyRender options (#6411)

---
 dev-docs/publisher-api-reference/setConfig.md | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 0268466fa6..f52b9863cc 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -163,7 +163,18 @@ Alternatively you may delay execution of the entire command queue (not just auct
 pbjs.delayPrerendering = true;
 ```
 
-Note that `delayPrerendering` is a property of the `pbjs` global and not a normal setting; this is because it takes effect before (and delays) any call to `setConfig`.  
+Note that `delayPrerendering` is a property of the `pbjs` global and not a normal setting; this is because it takes effect before (and delays) any call to `setConfig`.y  
+
+### Change yielding behavior
+
+Since version 10, Prebid yields the main browser thread while processing its command queue (`pbjs.que` / `pbjs.cmd`). This makes the browser more responsive (faster [interaction to next paint](https://web.dev/articles/inp)), but can cause issues if your code expects to run synchronously.
+
+You can disable yielding by setting `pbjs.yield = false` before loading Prebid (or - for NPM consumers - before running `processQueue`):
+
+```javascript
+pbjs = pbjs || {};
+pbjs.yield = false;
+```
 
 ### Send All Bids
 
@@ -1298,6 +1309,7 @@ The `auctionOptions` object controls aspects related to auctions.
 | `secondaryBidders` | Optional | Array of Strings | Specifies bidders that the Prebid auction will no longer wait for before determining the auction has completed. This may be helpful if you find there are a number of low performing and/or high timeout bidders in your page's rotation. |
 | `suppressStaleRender` | Optional | Boolean | When true, prevents `banner` bids from being rendered more than once. It should only be enabled after auto-refreshing is implemented correctly.  Default is false. |
 | `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false.
+| `legacyRender`     | Optional  | Boolean | When true, uses "legacy" rendering logic  (see [note](#note-legacyRender))                               |
 
 #### Examples
 {: .no_toc}
@@ -1356,6 +1368,15 @@ PBJS performs the following actions when expired rendering is detected.
 
 Expired winning bids will continue to be rendered unless `suppressExpiredRender` is set to true.  Events including `STALE_RENDER` and `BID_WON` are unaffected by this option.
 
+<a id="note-legacyRender"></a>
+
+#### More on `legacyRender`
+{: .no_toc}
+
+Since Prebid 10.12, `pbjs.renderAd` wraps creatives in an additional iframe. This can cause problems for some creatives
+that try to reach the top window and do not expect to find the extra iframe. You may set `legacyRender: true` to revert
+to pre-10.12 rendering logic.
+
 <a name="setConfig-maxNestedIframes"></a>
 
 ### maxNestedIframes

From 00ff5413a9b5680f2984aa434fc645d80093a5ef Mon Sep 17 00:00:00 2001
From: Gabriel Gravel <gravelg@users.noreply.github.com>
Date: Mon, 2 Feb 2026 07:27:44 -0500
Subject: [PATCH 459/665] s3rtd: doc update (#6409)

---
 dev-docs/modules/scope3RtdProvider.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/dev-docs/modules/scope3RtdProvider.md b/dev-docs/modules/scope3RtdProvider.md
index 37ba682928..bac3d92a13 100644
--- a/dev-docs/modules/scope3RtdProvider.md
+++ b/dev-docs/modules/scope3RtdProvider.md
@@ -63,9 +63,9 @@ pbjs.setConfig({
                 endpoint: "<https://prebid.scope3.com/prebid>",
                 timeout: 1500,
                 bidders: ["appnexus", "rubicon", "pubmatic"],
-                includeKey: "scope3_include",
-                excludeKey: "scope3_exclude",
-                macroKey: "scope3_macro",
+                includeKey: "axei",
+                excludeKey: "axex",
+                macroKey: "axem",
                 publisherTargeting: true,
                 advertiserTargeting: true,
                 cacheEnabled: true,
@@ -86,9 +86,9 @@ pbjs.setConfig({
 | endpoint | String | No | API endpoint (default: `https://prebid.scope3.com/prebid`) |
 | timeout | Number | No | Request timeout in milliseconds (default: 1000) |
 | bidders | Array | No | List of bidders to target (default: all auction bidders) |
-| includeKey | String | No | GAM targeting key for include signals (default: "scope3_include") |
-| excludeKey | String | No | GAM targeting key for exclude signals (default: "scope3_exclude") |
-| macroKey | String | No | GAM targeting key for macro data (default: "scope3_macro") |
+| includeKey | String | No | GAM targeting key for include signals (default: "axei") |
+| excludeKey | String | No | GAM targeting key for exclude signals (default: "axex") |
+| macroKey | String | No | GAM targeting key for macro data (default: "axem") |
 | publisherTargeting | Boolean | No | Enable publisher-level targeting (default: true) |
 | advertiserTargeting | Boolean | No | Enable advertiser-level targeting (default: true) |
 | cacheEnabled | Boolean | No | Enable response caching (default: true) |
@@ -126,19 +126,19 @@ Create GAM line items with key-value targeting using the configured keys:
 
 **Include Targeting:**
 
-* Key: `scope3_include` (or your configured includeKey)
+* Key: `axei` (or your configured includeKey)
 * Values: `sports_fan`, `auto_intender`, etc.
 * Operator: "is any of"
 
 **Exclude Targeting:**
 
-* Key: `scope3_exclude` (or your configured excludeKey)
+* Key: `axex` (or your configured excludeKey)
 * Values: `competitor_exposed`, etc.
 * Operator: "is none of"
 
 **Macro Targeting:**
 
-* Key: `scope3_macro` (or your configured macroKey)
+* Key: `axem` (or your configured macroKey)
 * Values: Base64-encoded contextual data
 
 ### Example Line Item Configuration
@@ -146,9 +146,9 @@ Create GAM line items with key-value targeting using the configured keys:
 ```text
 Creative: 300x250 Banner
 Targeting:
-  * scope3_include is any of "sports_fan", "auto_intender"
-  * scope3_exclude is none of "competitor_exposed"
-  * scope3_macro is "eyJjb250ZXh0IjogImhpZ2hfdmFsdWUifQ=="
+  * axei is any of "sports_fan", "auto_intender"
+  * axex is none of "competitor_exposed"
+  * acem is "eyJjb250ZXh0IjogImhpZ2hfdmFsdWUifQ=="
 ```
 
 ## Data Flow

From 1c5d91ab557a2402c5de2786b899593a290ba49c Mon Sep 17 00:00:00 2001
From: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
Date: Mon, 2 Feb 2026 14:28:21 +0200
Subject: [PATCH 460/665] AGT-721: Doc for size, pos, region (#18) (#6408)

* AGT-721: Doc for size, pos, region

* Afix analytics example

Co-authored-by: dmytro-po <dmytro.po@intentiq.com>
---
 dev-docs/analytics/intentiq.md                 | 11 ++++++-----
 dev-docs/modules/userid-submodules/intentiq.md |  2 ++
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index 8ef946a293..32e2b03c24 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -46,11 +46,8 @@ pbjs.enableAnalytics({
     provider: 'iiqAnalytics',
     options: {
         partner: 1177538,
-        manualWinReportEnabled: false,
-        reportMethod: "GET",
-        adUnitConfig: 1,
+        ABTestingConfigurationSource: 'IIQServer',
         domainName: "currentDomain.com",
-        gamPredictReporting: false
     }
 });
 ```
@@ -91,7 +88,9 @@ originalCpm: 1.5, // Original CPM value.
 originalCurrency: 'USD', // Original currency.
 status: 'rendered', // Auction status, e.g., 'rendered'.
 placementId: 'div-1' // ID of the ad placement.
-adType: 'banner' // Specifies the type of ad served
+adType: 'banner', // Specifies the type of ad served
+size: '320x250', // Size of adUnit item,
+pos: 0 // The following values are defined in the ORTB 2.5 spec
 }
 ```
 
@@ -109,6 +108,8 @@ adType: 'banner' // Specifies the type of ad served
 | status              | String    | Status of the impression. Leave empty or undefined if Prebid is not the bidding platform                                                          | rendered                      | No        |
 | placementId         | String    | Unique identifier of the ad unit on the webpage that showed this ad                                                                               | div-1                         | No        |
 | adType              | String    | Specifies the type of ad served. Possible values: “banner“, “video“, “native“, “audio“.                                                           | banner                        | No        |
+| size              | String    | Size of adUnit item                                                           | 320x250                       | No        |
+| pos              | number    | The pos field specifies the position of the adUnit on the page according to the OpenRTB 2.5 specification                                                           | 0                        | No        |
 
 To report the auction win, call the function as follows:
 
diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 8c734a863d..9f13c60ff3 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -58,6 +58,7 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params. ABTestingConfigurationSource| Optional | String | Determines how AB group will be defined. Possible values: `"IIQServer"` – group defined by IIQ server, `"percentage"` – generated group based on abPercentage, `"group"` – define group based on value provided by partner. | `IIQServer` |
 | params.abPercentage | Optional | Number | Percentage for A/B testing group. Default value is `95` | `95` |
 | params.group | Optional | String | Define group provided by partner, possible values: `"A"`, `"B"` | `"A"` |
+| params.region  | Optional | String | Optional region identifier used to automatically build server endpoints. When specified, region-specific endpoints will be used. (`gdpr`,`emea`, `apac`) | `"gdpr"` |
 | params.additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
 | params.additionalParams [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
 | params.additionalParams [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
@@ -83,6 +84,7 @@ pbjs.setConfig({
                 sourceMetaDataExternal: 123456, // Optional parameter
                 chTimeout: 10, // Optional parameter
                 abPercentage: 95, // Optional parameter
+                region: "gdpr", // Optional parameter
                 additionalParams: [ // Optional parameter
                     {
                       parameterName: "abc",

From b77931b5c03bcaf1b433b22b06d47368ee0a50ec Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Mon, 2 Feb 2026 13:29:16 +0100
Subject: [PATCH 461/665] ybdidder details added (#6405)

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/ybidder.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/ybidder.md b/dev-docs/bidders/ybidder.md
index 68f1eb690b..a09649a68d 100644
--- a/dev-docs/bidders/ybidder.md
+++ b/dev-docs/bidders/ybidder.md
@@ -27,12 +27,14 @@ multiformat_supported: will-bid-on-any
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description                | Example                              | Type      |
 |---------------|----------|----------------------------|--------------------------------------|-----------|
-| `tagId`       | required | tag ID                     | `"testnexx"`                         | `string`  |
+| `tagId`       | required | tag ID                     | `"testybid"`                         | `string`  |
 | `placement`   | required*| Placement                  | `"TEST_PLACEMENT"`                   | `string`  |
 
 You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
 The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
 
+Note: The Ybidder bidder adapter requires setup and approval from the Yieldbird team. Please reach out to [team@yieldbird.com](mailto:team@yieldbird.com) for more information.
+
 ### First Party Data
 
 Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
@@ -58,7 +60,7 @@ var adUnits = [
       bids: [{
          bidder: 'ybidder',
          params: {
-            tagId: 'testnexx'
+            tagId: 'testybid'
          }
        }]
    },
@@ -74,7 +76,7 @@ var adUnits = [
         bids: [{
             bidder: 'ybidder',
             params: {
-               tagId: 'testnexx'
+               tagId: 'testybid'
             }
         }]
     },
@@ -97,7 +99,7 @@ var adUnits = [
         bids: [{
             bidder: 'ybidder',
             params: {
-               tagId: 'testnexx'
+               tagId: 'testybid'
             }
         }]
     }

From 5345e8b0b93031ef9ea7601b977c9374fad1a8a0 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lu.corbo@gmail.com>
Date: Mon, 2 Feb 2026 13:29:40 +0100
Subject: [PATCH 462/665] WURFL RTD: update configuration parameters (#6404)

* WURFL RTD: update configuration parameters

* WURFL RTD: update configuration parameters
---
 dev-docs/modules/wurflRtdProvider.md | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index b7ea884de6..5ccea54724 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -126,14 +126,11 @@ pbjs.setConfig({
 | Name | Type | Description | Default |
 |------|------|-------------|---------|
 | `name` | String | Real time data module name | Always 'wurfl' |
-| `waitForIt` | Boolean | Should be set to true for proper initialization | `false` |
-| `params` | Object | Configuration parameters for WURFL RTD | |
-| `params.altHost` | String | Alternate host for connecting to WURFL.js | |
-| `params.debug` | Boolean | Enable debug mode for troubleshooting | `false` |
-| `params.abTest` | Object | A/B testing configuration (optional) | |
-| `params.abTest.enabled` | Boolean | Enable A/B testing | `false` |
-| `params.abTest.testName` | String | Name identifier for the test | |
-| `params.abTest.splitRatio` | Number | Ratio for treatment group (0.0-1.0) | `0.5` |
+| `params` | Object | Configuration parameters | |
+| `params.altHost` | String | Alternate host to connect to WURFL.js | |
+| `params.abTest` | Boolean | Enable A/B testing mode | `false` |
+| `params.abName` | String | A/B test name identifier | `'unknown'` |
+| `params.abSplit` | Number | Fraction of users in treatment group (0-1) | `0.8` |
 
 ## Testing
 

From eb6d294c178ad0aec94d9d12bf4f0990b05b16aa Mon Sep 17 00:00:00 2001
From: dev-adverxo <developer@adverxo.com>
Date: Mon, 2 Feb 2026 13:32:05 +0100
Subject: [PATCH 463/665] Add new adverxo Bidder alias: alchemyx (#6398)

* Add new adverxo alias: alchemyx

* Update dev-docs/bidders/alchemyx.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/alchemyx.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/alchemyx.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Abraham <abraham@kimiagroup.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/alchemyx.md | 113 +++++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 dev-docs/bidders/alchemyx.md

diff --git a/dev-docs/bidders/alchemyx.md b/dev-docs/bidders/alchemyx.md
new file mode 100644
index 0000000000..2fab5a6d33
--- /dev/null
+++ b/dev-docs/bidders/alchemyx.md
@@ -0,0 +1,113 @@
+---
+layout: bidder
+title: AlchemyX
+description: Prebid AlchemyX Bidder Adapter
+aliasCode: adverxo
+pbjs: true
+pbs: false
+pbs_app_supported: false
+biddercode: alchemyx
+media_types: banner, native, video
+schain_supported: true
+dchain_supported: false
+ortb_blocking_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+userId: none
+safeframes_ok: false
+deals_supported: true
+fpd_supported: true
+prebid_member: false
+sidebarType: 1
+---
+
+### Note
+
+The AlchemyX Bidding adapter requires setup and approval before beginning. Please reach out to <prebid@alchemyx.io> for
+more details.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|----------|----------|-----------------------|---------------------------|----------|
+| `adUnitId`   | required | Unique identifier for the ad unit in AlchemyX platform. | `1` | `integer` |
+| `auth`       | required | Authentication token provided by AlchemyX platform for the AdUnit. |`'61336e75e414c77c367eq5c47c2599ce80a8032b'` | `string` |
+
+### Setting First Party Data (FPD)
+
+Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+
+- ortb2.site.\*
+- ortb2.app.\*
+- ortb2.user.\*
+
+Example first party data:
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        site: {
+            keywords: "kw1,kw2",
+            content: {
+                title: "title1",
+                series: "series1"
+            }
+        },
+        user: {
+            keywords: "a,b",
+            gender: "M",
+            yob: 1984
+        }
+    }
+});
+```
+
+### ORTB Blocking
+
+AlchemyX supports the next blocking parameters:
+
+- Blocked advertisers list (`badv`) is an array of domains as strings.
+- Blocked apps list (`bapp`) is an array of apps names as strings, for mobile apps in Google Play Store, these should be
+  bundle or package names (e.g. com.foo.mygame). For apps in Apple App Store, these should be a numeric ID.
+- Blocked categories list (`bcat`) is an array of IAB categories as strings.
+- Blocked attributes list (`battr`) is an array of integers. Refer to section 5.3 of the IAB specification for a list of
+  attributes.
+
+#### Globally defined ORTB Blocking
+
+```javascript
+pbjs.setConfig({
+    ortb2: {
+        badv: ["domain1.com", "domain2.com"],
+        bapp: ["com.foo.mygame", "284708449"],
+        bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+    }
+});
+```
+
+#### ORTB Blocking specific only to the AlchemyX bidder
+
+```javascript
+pbjs.setBidderConfig({
+    bidders: ['alchemyx'],
+    config: {
+        ortb2: {
+            badv: ["domain1.com", "domain2.com"],
+            bapp: ["com.foo.mygame"],
+            bcat: ["IAB23-1", "IAB23-5", "IAB25-3", "IAB25-2"]
+        }
+    }
+});
+```
+
+#### Media Type defined ORTB Blocking
+
+Additionally `battr` ORTB blocking param may be set on media types to specify blocked creative
+attributes. Refer to section 5.3 of the IAB specification for a list of attributes.

From 10005518ab0c8e5a9cba6fcc4e43ff9080a2c85e Mon Sep 17 00:00:00 2001
From: PanxoDev <jfaura0@gmail.com>
Date: Tue, 3 Feb 2026 20:27:19 +0100
Subject: [PATCH 464/665] Add Panxo bidder adapter documentation (#6419)

Adding documentation for the Panxo bid adapter which was merged
in Prebid.js release 10.23.0 (PR #14351).

Panxo is a specialized SSP for AI-referred traffic monetization.

Features documented:
- TCF/GDPR support (GVL ID: 1527)
- USP/CCPA support
- GPP support
- COPPA support
- Supply Chain (schain) support
- Price Floors support
- First Party Data support
- Deals support

Co-authored-by: Joan Faura <joanfaura@MacBook-Pro.local>
---
 dev-docs/bidders/panxo.md | 96 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 dev-docs/bidders/panxo.md

diff --git a/dev-docs/bidders/panxo.md b/dev-docs/bidders/panxo.md
new file mode 100644
index 0000000000..0d9e121d39
--- /dev/null
+++ b/dev-docs/bidders/panxo.md
@@ -0,0 +1,96 @@
+---
+layout: bidder
+title: Panxo
+description: Prebid Panxo Bidder Adapter
+biddercode: panxo
+tcfeu_supported: true
+gvl_id: 1527
+usp_supported: true
+coppa_supported: true
+gpp_supported: true
+schain_supported: true
+floors_supported: true
+fpd_supported: true
+media_types: banner
+safeframes_ok: true
+bidder_supports_deals: true
+pbjs: true
+pbs: false
+prebid_member: true
+multiformat_supported: will-not-bid
+ortb_blocking_supported: false
+sidebarType: 1
+---
+
+### Before You Begin
+
+The Panxo adapter requires the Panxo Signal script to be installed on your page before Prebid.js loads. Please register at [app.panxo.ai](https://app.panxo.ai) to obtain your property key and Signal script endpoint.
+
+**Important**: Without the Signal script setting the `panxo_uid` in localStorage, the adapter will not participate in the auction.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|---------------|----------|--------------------------------------------------|----------------------|----------|
+| `propertyKey` | required | Property identifier from Panxo dashboard | `'abc123def456'` | `string` |
+| `floor` | optional | Minimum CPM floor price in USD | `0.50` | `number` |
+
+### Setup Example
+
+```html
+<!-- Step 1: Panxo Signal Script (MUST load before Prebid) -->
+<script async src="https://cdn.panxo-sys.com/o/YOUR_ENDPOINT_KEY"></script>
+
+<!-- Step 2: Prebid.js -->
+<script async src="prebid.js"></script>
+```
+
+```javascript
+var adUnits = [{
+    code: 'banner-ad',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250], [728, 90]]
+        }
+    },
+    bids: [{
+        bidder: 'panxo',
+        params: {
+            propertyKey: 'your-property-key'
+        }
+    }]
+}];
+```
+
+### First Party Data
+
+This adapter supports First Party Data via `ortb2`:
+
+- `ortb2.site.*` (name, cat, content, keywords, etc.)
+- `ortb2.user.*` (data, ext)
+
+### User Sync
+
+Panxo supports pixel-based user sync:
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        filterSettings: {
+            pixel: {
+                bidders: ['panxo'],
+                filter: 'include'
+            }
+        }
+    }
+});
+```
+
+### Additional Notes
+
+- **Net Revenue**: Bids are returned as net revenue.
+- **TTL**: 300 seconds (5 minutes)
+- **Currency**: USD
+- **Safeframes**: Supported
+- **Advertiser Domains**: Available in bid responses at `meta.advertiserDomains`

From 92c455be2ba2e0df0b5db491fba93ab72a611201 Mon Sep 17 00:00:00 2001
From: Aleksandar Crepuljarevic <a.crepuljarevic@gmail.com>
Date: Fri, 6 Feb 2026 22:06:13 +0100
Subject: [PATCH 465/665] Ogury: update prebid doc - allow inventory mapping
 for in-app. (#6371)

---
 dev-docs/bidders/ogury.md | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/ogury.md b/dev-docs/bidders/ogury.md
index c6407a2a4b..141be4a1c4 100644
--- a/dev-docs/bidders/ogury.md
+++ b/dev-docs/bidders/ogury.md
@@ -82,12 +82,13 @@ Use this example configuration for enabling Ogury ad server integration on a spe
 
 #### Inventory mapping
 
-_"Inventory mapping" is only available for request coming from **web**. For **in-app** request use the "bid param" integration method._
-
 _Note: If you choose inventory mapping, you can skip specifying assetKey and adUnitId per ad unit._
 
-With inventory mapping you don't need to setup `assetKey/adUnitId` for every ad unit that you want to integrate. You use a single `id` and provide Ogury with list of sites and `ad_unit_code`s that you want to integrate and the mapping will be done on our side.
-The example configuration for this type of integration looks like this:
+With inventory mapping you don't need to setup `assetKey/adUnitId` for every ad unit that you want to integrate. You use a single `id` and provide Ogury with list of sites or bundles and `ad_unit_code`s that you want to integrate and the mapping will be done on our side.
+
+The example configuration for this type of integration looks like bellow.
+
+Web example:
 
 ```javascript
 pbjs.que.push(function () {
@@ -107,6 +108,26 @@ pbjs.que.push(function () {
 })
 ````
 
+In-app example:
+
+```javascript
+pbjs.que.push(function () {
+            // setup publisherId for ogury
+            pbjs.setBidderConfig({
+                bidders: ['ogury'],
+                config: {
+                    ortb2: {
+                        app: {
+                            publisher: {
+                                id: '$OGURY_PUBLISHER_ID',
+                            },
+                        }
+                    }
+                }
+            })
+})
+````
+
 `$OGURY_PUBLISHER_ID` is a Ogury provided id. 
 
 ### Optional bid Params

From 8e39b1491032da98a0ed9c6953aff91a724d0439 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 6 Feb 2026 13:12:03 -0800
Subject: [PATCH 466/665] JS: documentation for FPD keywords configuration
 options (#6364)

* JS: documentation for FPD keywords configuration options

* lint

* add note on FPD set by modules
---
 features/firstPartyData.md | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/features/firstPartyData.md b/features/firstPartyData.md
index e4eea093ee..0bd0694670 100644
--- a/features/firstPartyData.md
+++ b/features/firstPartyData.md
@@ -55,7 +55,7 @@ If not specified through any of the methods above, Prebid.js attempts to automat
 | `site.page` | Site URL, from `pageUrl` falling back to `location.href` | [`pageUrl` config](/dev-docs/publisher-api-reference/setConfig.html#setConfig-Page-URL) |
 | `site.ref` | `document.referrer` | |
 | `site.domain` | Domain portion of `site.page` | |
-| `site.keywords` | Contents of `<meta name="keywords">`, if such a tag is present on the page | |
+| `site.keywords` | Contents of `<meta name="keywords">` and `<script type="application/json+ld">`, if those tags are present on the page | See [configuration options](#config) |
 | `site.publisher.domain` | Second level domain portion of `site.domain` | The second-level domain portion of `sub.example.publisher.com` is `publisher.com`|
 | `device.w` | Width of the screen in pixels |
 | `device.h` | Height of the screen in pixels |
@@ -70,21 +70,36 @@ If not specified through any of the methods above, Prebid.js attempts to automat
 | `regs.coppa` | COPPA Regulation flag | [COPPA config](/dev-docs/publisher-api-reference/setConfig.html#setConfig-coppa)
 | `regs.ext.gpc` | Global Privacy Control setting | [Navigator.globalPrivacyControl](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/globalPrivacyControl) |
 
-Publisher-provided first party data always takes precedence for all fields; you can also set `null` to disable them. For example, the following discards the automatically collected `device.keywords`:  
+Publisher-provided first party data generally takes precedence for all fields; you can also set `null` to disable them. For example, the following discards the automatically collected `site.keywords`:  
 
 ```javascript
 pbjs.setConfig({
     ortb2: {
-        device: {
+        site: {
             keywords: null
         }
     }
 })
 ```
 
+Note however that this typically not the case for fields populated by optional modules: `consentManagementTcf` will override `regs.gdpr` and `user.consent`, `geolocationRtdProvider` will override `device.geo`, and so on.    
+
+<a id="config"></a>
+
+## Configuration
+
+{: .table .table-bordered .table-striped }
+| Param | Type | Description |
+| --- | --- | --- | --- |
+| `firstPartyData` |  Object | First party data automatic collection options |
+| `firstPartyData.uaHints`  |   Array of strings | High entropy user agent hints to collect for `device.sua` (see below) |
+| `firstPartyData.keywords` | Object | `site.kewyords` automatic collection options | 
+| `firstPartyData.keywords.meta` |  Boolean | If true (the default), collect keywords from `<meta name="keyword">` tags found on the page |
+| `firstPartyData.keywords.json` |  Boolean | If true (the default), collect keywords from `<script type="application/json+ld">` tags found on the page |
+
 <a id="uaHints"></a>
 
-#### User Agent client hints
+### User Agent client hints
 
 `device.sua` is populated with UA client hints retrieved from [`navigator.userAgentData`](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/userAgentData). You can specify the list of hints using the `uaHints` option with [any available high entropy hint](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData#returning_high_entropy_values):
 

From 3e340fb857468ccd1261f834289f590cf2f44717 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Fri, 6 Feb 2026 22:26:39 +0100
Subject: [PATCH 467/665] Shaping rules module (#6359)

* Shaping rules module

* lint

* lint

* description

* update with new functionalities

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/modules/shapingRulesModule.md | 273 +++++++++++++++++++++++++
 1 file changed, 273 insertions(+)
 create mode 100644 dev-docs/modules/shapingRulesModule.md

diff --git a/dev-docs/modules/shapingRulesModule.md b/dev-docs/modules/shapingRulesModule.md
new file mode 100644
index 0000000000..f793003a94
--- /dev/null
+++ b/dev-docs/modules/shapingRulesModule.md
@@ -0,0 +1,273 @@
+---
+layout: page_v2
+page_type: module
+title: Module - Shaping rules module
+description: Including or excluding bidders in an auction depending on fetched conditions
+module_code : shapingRules
+display_name : Shaping rules module
+enable_download : true
+sidebarType : 1
+
+---
+
+# Shaping rules module
+
+## Overview
+
+This module was created to enable, based on a floors-syntax configuration and its conditions related to first-party data, ad-unit data, and other criteria, the inclusion or exclusion of specific bidders from participating in an auction. Its purpose is to reduce unnecessary network traffic and lower costs for both the publisher and the bidders when participation is unlikely to happen.
+
+This module makes it possible, among other things, to:
+
+1. skip calling certain bidders for users in specific geographies,
+1. exclude bidders when no EID or FPD is available,
+1. run A/B tests for experimenting with individual new bidders,
+1. run A/B tests for experimenting with sets of bidders.
+
+This functionality is also relevant to the Prebid Sustainability Taskforce, as reducing the number of requests helps save money and reduce carbon emissions.
+
+## How it works
+
+The Prebid.js Shaping Rules module processes JSON data in the floors-syntax format, which it fetches from the endpoint specified in the module’s configuration. It parses the JSON configuration, evaluates the conditions used to determine model groups, and assigns the user to the appropriate group. Within that model group, it then evaluates the conditions defined in the schema functions and, when those conditions are met, applies the corresponding `includeBidders` or `excludeBidders` rule using the Activity Controls mechanism.
+
+## Rules engine JSON
+
+### Example
+
+This example shows the scenario when `bidderA` and `bidderD` are excluded from auction
+in Japan. It can be provided either statically or by fetching it from external endpoint
+
+```javascript
+{
+  "enabled": true,
+  "generateRulesFromBidderConfig": true,
+  "timestamp": "20250131 00:00:00",
+  "ruleSets": [
+    {
+      "stage": "processed-auction-request",
+      "name": "exclude-in-jpn",
+      "version": "1234",
+      "modelGroups": [
+        {
+          "weight": 98,
+          "analyticsKey": "experiment-name",
+          "version": "4567",
+          "schema": [
+            { "function": "deviceCountryIn", "args": [["JPN"]] }
+          ],
+          "default": [],
+          "rules": [
+            {
+              "conditions": ["true"],
+              "results": [
+                {
+                  "function": "excludeBidders",
+                  "args": [
+                    { "bidders": ["bidderA", "bidderD"], "analyticsValue": "rmjpn" },
+                  ]
+                }
+              ]
+            },
+            {
+              "conditions": [],
+              "results": []
+            }
+          ]
+        },
+        {
+          "weight": 2,
+          "default": []
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Rules engine JSON fields
+
+{: .table .table-bordered .table-striped }
+{: .table .table-bordered .table-striped }
+| Field                                                   | Description                                                                                                                                | Default |
+| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
+| `enabled`                                               | Enables or disables the module.                                                                                                            | `true`  |
+| `generateRulesFromBidderConfig`                         | Automatically generates rules based on bidder YAML files, using the `geoscope` section to exclude bidders in unsupported geos.             | `true`  |
+| `ruleSets[]`                                            | One or more independent sets of rules.                                                                                                     | —       |
+| `ruleSets[].enabled`                                    | Indicates whether this ruleset is active; useful for troubleshooting.                                                                      | —       |
+| `ruleSets[].timestamp`                                  | Optional timestamp of the last update (ISO 8601 format: `YYYY-MM-DDThh:mm:ss[.sss][Z or ±hh:mm]`).                                         | —       |
+| `ruleSets[].stage`                                      | Indicates which module stage the ruleset applies to. Can be either `processed-auction-request` or `processed-auction`                                                                                       | —       |
+| `ruleSets[].name`                                       | Human-readable name of the ruleset.                                                                                                        | —       |
+| `ruleSets[].modelGroups[]`                              | Allows A/B testing with different rule configurations.                                                                                     | —       |
+| `ruleSets[].modelGroups[].weight`                       | Determines selection probability; only one object within the group is chosen.                                                              | —       |
+| `ruleSets[].modelGroups[].version`                      | Version identifier for analytics.                                                                                                          | —       |
+| `ruleSets[].modelGroups[].default[]`                    | Default results object used if errors occur or when no schema or rules are defined. Exists outside the rules array for structural clarity. | —       |
+| `ruleSets[].modelGroups[].schema[]`                     | Optional array of functions used to compute values. Without it, only the default rule is applied.                                          | —       |
+| `ruleSets[].modelGroups[].schema[].function`            | Function name inside the schema.                                                                                                           | —       |
+| `ruleSets[].modelGroups[].schema[].args`                | Arguments for the schema function.                                                                                                         | —       |
+| `ruleSets[].modelGroups[].analyticsKey`                 | Optional key used to produce aTags, identifying experiments or optimization targets.                                                       | —       |
+| `ruleSets[].modelGroups[].rules[]`                      | Optional rule array; if absent, only the default rule is used.                                                                             | —       |
+| `ruleSets[].modelGroups[].rules[].conditions[]`         | Conditions that must be met for the rule to apply.                                                                                         | —       |
+| `ruleSets[].modelGroups[].rules[].results[]`            | Resulting actions triggered when conditions are met.                                                                                       | —       |
+| `ruleSets[].modelGroups[].rules[].results[].function`   | Function defining the result action.                                                                                                       | —       |
+| `ruleSets[].modelGroups[].rules[].results[].args`       | Arguments for the result function.                                                                                                         | —       |
+
+### Schema functions
+
+| Function         | Args                             | Value                                                                                                                                                                                                                           |
+|------------------|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `deviceCountry`   | null                            | Return device.geo.country.                                                                                                                                                                                                      |
+| `deviceCountryIn` | array of strings (country codes)| Check if device.geo.country is in the array (case sensitive). Empty array = treat as null.                                                                                                                                    |
+| `channel`         | null                            | Returns ext.prebid.channel (web/amp/app). Return "" if none. Return "pbjs" as "web".                                                                                                                                           |
+| `eidAvailable`    | null                            | true if user.eids exists and is non-empty. Otherwise false.                                                                                                                                                                     |
+| `userFpdAvailable`| null                            | true if user.ext.data or user.data exists and not empty.                                                                                                                                                                        |
+| `fpdAvailable`    | null                            | true if any of: user.ext.data, user.data, site.ext.data, site.content.data, app.ext.data, app.content.data exists with data.                                                                                                    |
+| `gppSidAvailable` | null                            | true if any regs.gpp_sid values > 0.                                                                                                                                                                                           |
+| `gppSidIn`        | array of ints                   | true if intersection between regs.gpp_sid and array is non-empty.                                                                                                                                                               |
+| `tcfInScope`      | null                            | true if regs.gdpr == "1".                                                                                                                                                                                                      |
+| `percent`         | int                             | true if random int 0–100 < pct. Default 5 if null. Min 0, max 100.                                                                                                                                                              |
+| `domain`          | null                            | Return publisher.domain or domain from {site, app, dooh}.                                                                                                                                                                       |
+| `domainIn`        | array of strings                | true if any supplied domain matches publisher.domain or domain.                                                                                                                                                                 |
+| `bundleIn`        | array of strings                | true if any supplied value matches app.bundle.                                                                                                                                                                                  |
+| `bundle`        | null               | return app.bundle                                                                                                                                                                                  |
+| `mediaTypeIn`     | array of strings                | true if any supplied mediaType is present in imp.                                                                                                                                                                               |
+| `adUnitCode`      | null                            | Return first of: imp.ext.gpid, imp.tagid, imp.ext.data.pbadslot, imp.ext.prebid.storedrequest.id.                                                                                                                             |
+| `adUnitCodeIn`    | array of strings                | true if any supplied string matches imp.ext.gpid, imp.tagid, imp.ext.data.pbadslot, imp.ext.prebid.storedrequest.id, imp.id.                                                                                                    |
+| `deviceTypeIn`    | array of integers               | true if any supplied integer matches device.devicetype.                                                                                                                                                                         |
+| `bidPrice`        | [operator, value, currency]     | Compare bid response price with operator/value in currency. Example: gt 5 EUR.                                                                                                                                                  |
+
+### Result functions
+
+In this stage of the generic rules engine, only three result functions are supported:
+
+- `excludeBidders`
+- `includeBidders`
+- `logAtag`
+
+#### excludeBidders and includeBidders
+
+Both functions behave almost identically.
+
+The function argument is an array of objects, each of which may include the following attributes:
+
+| Arg            | Value Type        | Required? | Meaning                         | Default |
+|----------------|--------------------|-----------|----------------------------------|---------|
+| bidders        | array of strings   | yes       | The bidders to include/exclude   | none    |
+| analyticsValue | string             | no        | Value sent to the aTag           | none    |
+
+## Module configuration
+
+### Configuration
+
+You can provide an external endpoint that returns a JSON object containing the rules. In this case, you should also specify the `auctionDelay` parameter, which delays the auction to allow time for the rules to be fetched.
+
+```javascript
+  pbjs.setConfig({
+    shapingRules: {
+        auctionDelay: 2000, // maximum time (in ms) the auction may wait for the rules endpoint to respond
+        endpoint: {
+            url: 'http://rules-config-endpoint.com/shaping-rules',
+            method: 'GET'
+        }
+    }
+  })
+```
+
+Alternatively, you can define the rules statically by providing the configuration inline using the `rules` field:
+
+```javascript
+pbjs.setConfig({
+  shapingRules: {
+    rules: {
+      enabled: true,
+      rulesets: [
+        {
+          stage: "processed-auction-request",
+          name: "exclude-in-jpn",
+          version: "1234",
+          modelGroups: [
+            {
+              weight: 98,
+              analyticsKey: "experiment-name",
+              version: "4567",
+              schema: [
+                {
+                  function: "deviceCountryIn",
+                  args: [["JPN"]],
+                },
+              ],
+              rules: [
+                {
+                  conditions: ["true"],
+                  results: [
+                    {
+                      function: "excludeBidders",
+                      args: [
+                        {
+                          bidders: ["testBidder"],
+                          analyticsValue: "rmjpn",
+                        },
+                      ],
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    },
+  },
+});
+```
+
+The configuration also allows you to define custom schema evaluators using the `extraSchemaEvaluators` field.
+
+```javascript
+pbjs.setConfig({
+  shapingRules: {
+    extraSchemaEvaluators: {
+      browser: (args, context) => {
+        if (navigator.userAgent.includes("Chrome")) {
+          return "Chrome";
+        }
+      },
+    },
+    rules: {
+      enabled: true,
+      rulesets: [
+        {
+          stage: "processed-auction-request",
+          name: "exclude-in-jpn",
+          version: "1234",
+          modelGroups: [
+            {
+              weight: 98,
+              analyticsKey: "experiment-name",
+              version: "4567",
+              schema: [
+                {
+                  function: "browser",
+                },
+              ],
+              rules: [
+                {
+                  conditions: ["Chrome"],
+                  results: [
+                    {
+                      function: "excludeBidders",
+                      args: [
+                        {
+                          bidders: ["testBidder"],
+                        },
+                      ],
+                    },
+                  ],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    },
+  },
+});
+```

From d5bd356be542a8c7261777f83fd7cbebb8fb4e6c Mon Sep 17 00:00:00 2001
From: PanxoDev <tech@panxo.ai>
Date: Thu, 12 Feb 2026 22:23:07 +0100
Subject: [PATCH 468/665] Add Panxo RTD Provider module documentation (#6424)

---
 dev-docs/modules/panxoRtdProvider.md | 81 ++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 dev-docs/modules/panxoRtdProvider.md

diff --git a/dev-docs/modules/panxoRtdProvider.md b/dev-docs/modules/panxoRtdProvider.md
new file mode 100644
index 0000000000..c07a1d2abf
--- /dev/null
+++ b/dev-docs/modules/panxoRtdProvider.md
@@ -0,0 +1,81 @@
+---
+layout: page_v2
+title: Panxo RTD Provider Module
+display_name: Panxo RTD Module
+description: Real-time AI traffic classification for enriched OpenRTB bid requests.
+page_type: module
+module_type: rtd
+module_code : panxoRtdProvider
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+# Panxo RTD Provider Module
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Overview
+
+The Panxo RTD module enriches OpenRTB bid requests with real-time AI traffic classification signals. It detects visits originating from AI assistants and provides contextual data through `device.ext.panxo` and `site.ext.data.panxo`, enabling the Panxo Bid Adapter and other demand partners to apply differentiated bidding on AI-referred inventory.
+
+To use this module, contact [publishers@panxo.ai](mailto:publishers@panxo.ai) or sign up at [app.panxo.com](https://app.panxo.com) to receive your property identifier.
+
+{% include dev-docs/loads-external-javascript.md %}
+
+## Configuration
+
+This module is configured as part of the `realTimeData.dataProviders` object.
+
+{: .table .table-bordered .table-striped }
+| Name             | Scope    | Description                                            | Example              | Type      |
+|------------------|----------|--------------------------------------------------------|----------------------|-----------|
+| `name`           | required | Real time data module name                             | `'panxo'`            | `string`  |
+| `params`         | required |                                                        |                      | `Object`  |
+| `params.siteId`  | required | 16-character hex property identifier provided by Panxo | `'a1b2c3d4e5f67890'` | `string`  |
+| `params.verbose` | optional | Enable verbose logging for troubleshooting             | `true`               | `boolean` |
+
+### Basic Example
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 300,
+        dataProviders: [{
+            name: 'panxo',
+            waitForIt: true,
+            params: {
+                siteId: 'a1b2c3d4e5f67890'
+            }
+        }]
+    }
+});
+```
+
+## ORTB2 Data
+
+The module adds the following fields to the OpenRTB bid request:
+
+{: .table .table-bordered .table-striped }
+| Path                     | Description                              |
+|--------------------------|------------------------------------------|
+| `device.ext.panxo`      | Session signal token for traffic verification |
+| `site.ext.data.panxo`   | Contextual AI traffic classification data     |
+
+## Integration
+
+To install the module, follow these instructions:
+
+### Step 1: Build Prebid.js with the module
+
+* Option 1: Use the Prebid [Download](/download.html) page to build the prebid package. Ensure that you check *Panxo RTD Module* under Vendor-Specific Modules.
+
+* Option 2: From the command line, run `gulp build --modules=rtdModule,panxoRtdProvider,...`
+
+> Note that the Panxo RTD module requires the global real-time data module, `rtdModule`.
+
+### Step 2: Set configuration
+
+Enable the Panxo RTD module using `pbjs.setConfig` as shown in the example above.

From 5fedfe212d5c5ffb8322c3e45daf55a4425a8fda Mon Sep 17 00:00:00 2001
From: MaksymTeqBlaze <maksym.pavliv@teqblaze.com>
Date: Wed, 18 Feb 2026 10:45:04 +0200
Subject: [PATCH 469/665] Added Bid Adapter TeqBlazeSalesAgent (#6422)

---
 dev-docs/bidders/teqBlazeSalesAgent.md | 30 ++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 dev-docs/bidders/teqBlazeSalesAgent.md

diff --git a/dev-docs/bidders/teqBlazeSalesAgent.md b/dev-docs/bidders/teqBlazeSalesAgent.md
new file mode 100644
index 0000000000..87de7608da
--- /dev/null
+++ b/dev-docs/bidders/teqBlazeSalesAgent.md
@@ -0,0 +1,30 @@
+---
+layout: bidder
+title: TeqBlazeSalesAgent
+description: Prebid TeqBlaze Sales Agent Bidder Adapter
+biddercode: teqBlazeSalesAgent
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | required | Placement Id | `'0'`                           | `'string'` |

From 3c460f922cc36f61cd51fd9c087e2a39c85c0f08 Mon Sep 17 00:00:00 2001
From: abazylewicz-id5 <106807984+abazylewicz-id5@users.noreply.github.com>
Date: Wed, 18 Feb 2026 09:47:52 +0100
Subject: [PATCH 470/665] ID5 UserId - Added terms of service mention to the
 docs (#6425)

* ID5 UserId - Added terms of service mention to the docs

* ID5 UserId - Lint fix
---
 dev-docs/modules/userid-submodules/id5.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/dev-docs/modules/userid-submodules/id5.md b/dev-docs/modules/userid-submodules/id5.md
index a5325134a0..1ae8328b22 100644
--- a/dev-docs/modules/userid-submodules/id5.md
+++ b/dev-docs/modules/userid-submodules/id5.md
@@ -71,6 +71,14 @@ If you or your monetization partners are deploying multiple Prebid wrappers on y
 
 ## ID5 ID Examples
 
+> ### NOTICE: TERMS OF SERVICE & BINDING AGREEMENT
+> ID5 provides this software and the ID5 ID Service free of charge, subject to strict data usage and privacy rules.
+>
+> By copying, installing, or initializing the ID5 API (or any ID5 Code Snippet), you and the legal entity you represent AGREE TO BE BOUND by the ID5 ID Agreement.
+>
+> - If you do not agree to the ID5 ID Agreement, you are NOT AUTHORIZED to use this code or the ID5 Service.
+> - Commercial Use: If you are a Platform, Intermediary, or intend to use ID5 Data for commercial purposes beyond the standard publisher integration, you must contact [contact@id5.io](contact@id5.io) to execute a commercial license.
+
 Publisher wants to retrieve the ID5 ID through Prebid.js
 
 ```javascript

From 34aa3b2175f676259bb28aaf9c73c8eb9b87ce04 Mon Sep 17 00:00:00 2001
From: Alexandr Kim <47887567+alexandr-kim-vl@users.noreply.github.com>
Date: Wed, 18 Feb 2026 13:55:18 +0500
Subject: [PATCH 471/665] Yaleo Bid Adapter: initial release (#6429)

---
 dev-docs/bidders/yaleo.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 dev-docs/bidders/yaleo.md

diff --git a/dev-docs/bidders/yaleo.md b/dev-docs/bidders/yaleo.md
new file mode 100644
index 0000000000..cd45bbb8e7
--- /dev/null
+++ b/dev-docs/bidders/yaleo.md
@@ -0,0 +1,28 @@
+---
+layout: bidder
+title: Yaleo
+description: Prebid Bidder Adapter for Yaleo
+biddercode: yaleo
+media_types: banner
+tcfeu_supported: true
+safeframes_ok: false
+floors_supported: true
+gvl_id: 783
+pbjs: true
+pbs: false
+sidebarType: 1
+---
+
+### Note
+
+The Yaleo Bidding adapter requires setup before beginning. Please contact us at [hola@yaleo.com](mailto:hola@yaleo.com).
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                                          | Example                              | Type   |
+| ------------- | -------- | ------------------------------------------------------------------------------------ | ------------------------------------ | ------ |
+| `placementId` | required | Yaleo placement identifier.                                                          |`460a301d-a9f7-4104-b55f-2a3d4674a973`|`string`|
+| `memberId`    | optional | Member identifier.                                                                   |`12345`.                              |`number`|
+| `maxCpm`      | optional | Maximum CPM value. Bids with a CPM higher than the specified value will be rejected. |`2.5`                                 |`number`|

From f3a26863cfded32da4923f61277f30b82831c321 Mon Sep 17 00:00:00 2001
From: PanxoDev <tech@panxo.ai>
Date: Wed, 18 Feb 2026 19:51:43 +0100
Subject: [PATCH 472/665] Update Panxo bidder docs: require RTD module instead
 of Signal script (#6431)

Replace standalone Signal script requirement with the now-approved
Panxo RTD Module (panxoRtdProvider) as the required integration method.
---
 dev-docs/bidders/panxo.md | 33 ++++++++++++++++++++++++++-------
 1 file changed, 26 insertions(+), 7 deletions(-)

diff --git a/dev-docs/bidders/panxo.md b/dev-docs/bidders/panxo.md
index 0d9e121d39..461be70d48 100644
--- a/dev-docs/bidders/panxo.md
+++ b/dev-docs/bidders/panxo.md
@@ -24,9 +24,11 @@ sidebarType: 1
 
 ### Before You Begin
 
-The Panxo adapter requires the Panxo Signal script to be installed on your page before Prebid.js loads. Please register at [app.panxo.ai](https://app.panxo.ai) to obtain your property key and Signal script endpoint.
+The Panxo adapter requires the [Panxo RTD Module](/dev-docs/modules/panxoRtdProvider.html) to be included in your Prebid.js build. The RTD module detects AI-referred traffic and enriches bid requests with classification signals that the adapter needs to participate in the auction.
 
-**Important**: Without the Signal script setting the `panxo_uid` in localStorage, the adapter will not participate in the auction.
+Please register at [app.panxo.com](https://app.panxo.com) to obtain your `siteId` (for the RTD module) and `propertyKey` (for the bid adapter).
+
+**Important**: Without the Panxo RTD module configured, the adapter will not participate in the auction.
 
 ### Bid Params
 
@@ -38,15 +40,32 @@ The Panxo adapter requires the Panxo Signal script to be installed on your page
 
 ### Setup Example
 
-```html
-<!-- Step 1: Panxo Signal Script (MUST load before Prebid) -->
-<script async src="https://cdn.panxo-sys.com/o/YOUR_ENDPOINT_KEY"></script>
+#### Step 1: Build Prebid.js with required modules
+
+Include both `panxoRtdProvider` and `panxoBidAdapter` in your Prebid.js build:
 
-<!-- Step 2: Prebid.js -->
-<script async src="prebid.js"></script>
+```bash
+gulp build --modules=rtdModule,panxoRtdProvider,panxoBidAdapter,...
 ```
 
+Or select both **Panxo RTD Module** and **Panxo** on the Prebid [Download](/download.html) page.
+
+#### Step 2: Configure RTD module and ad units
+
 ```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 300,
+        dataProviders: [{
+            name: 'panxo',
+            waitForIt: true,
+            params: {
+                siteId: 'your-site-id'
+            }
+        }]
+    }
+});
+
 var adUnits = [{
     code: 'banner-ad',
     mediaTypes: {

From 603864ef99ffeff48ecd27326b9b5e8bc6ce470f Mon Sep 17 00:00:00 2001
From: ysfbsf <youssef.bsf@gmail.com>
Date: Thu, 19 Feb 2026 14:58:58 +0000
Subject: [PATCH 473/665] Fix Missena GVL ID from 867 to 687 (#6439)

* Add gpp_sids field to Missena bidder documentation

* Fix Missena GVL ID from 867 to 687

The Global Vendor List ID for Missena was incorrectly set to 867.
The correct GVL ID is 687.
---
 dev-docs/bidders/missena.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/missena.md b/dev-docs/bidders/missena.md
index 44c17d4a79..912407454b 100644
--- a/dev-docs/bidders/missena.md
+++ b/dev-docs/bidders/missena.md
@@ -3,9 +3,10 @@ layout: bidder
 title: Missena
 description: Prebid Missena Bidder Adapter
 biddercode: missena
-gvl_id: 867
+gvl_id: 687
 pbjs: true
 pbs: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 safeframes_ok: false
 sidebarType: 1
 pbs_app_supported: true

From 18a26edba81760b424bf4ad09e35eea0caad3c1e Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sat, 21 Feb 2026 10:36:19 -0500
Subject: [PATCH 474/665] Add Prebid Sales Agent cards to homepage product row
 and GitHub banner (#6423)

* Add Prebid Sales Agent card to homepage

* Update home.html

* Move sections into two columns

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 _layouts/home.html | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/_layouts/home.html b/_layouts/home.html
index e9df870893..4300227a8e 100644
--- a/_layouts/home.html
+++ b/_layouts/home.html
@@ -43,12 +43,23 @@ <h1>Prebid Documentation</h1>
           <p class="mt-4"><a href="/prebid-mobile/prebid-mobile-download.html">Download Mobile SDK</a></p>
         </div>
       </div>
+    </div>
+
+    <div class="card-deck--md card-deck--products mt-4">
       <div class="card text-center">
         <div class="card-body">
-          <div class="card-media"><img src="/assets/images/user-identity.png" width=100 alt="Prebid User Identity Icon"></div>
+          <div class="card-media"><img src="/assets/images/user-identity.png" width="100" alt="Prebid User Identity Icon"></div>
           <div class="card-title"><h3>Prebid User Identity</h3></div>
           <p class="mb-4">Supporting the open web while respecting user privacy.</p>
-          <a href="/identity/prebid-identity.html" class="btn btn-outline-brand">View Docs</a>
+          <a class="btn btn-outline-brand" href="/identity/prebid-identity">View Docs</a>
+        </div>
+      </div>
+      <div class="card text-center">
+        <div class="card-body">
+          <div class="card-media"><img src="/assets/images/icon__product--prebid-server.svg" alt="Prebid Sales Agent Icon"></div>
+          <div class="card-title"><h3>Prebid Sales Agent</h3></div>
+          <p class="mb-4">Expose inventory to AI agents with AdCP-ready workflows.</p>
+          <a href="https://github.com/prebid/prebid-server" class="btn btn-outline-brand">Setup Prebid Sales Agent</a>
         </div>
       </div>
     </div>
@@ -133,6 +144,12 @@ <h2 class="text-white my-4">Prebid is Completely Open Source! Join our Community
             <div class="card-title"><h3><a href="https://github.com/prebid/prebid.github.io" class="stretched-link">Prebid Docs</a></h3></div>
           </div>
         </div>
+        <div class="card">
+          <div class="card-body">
+            <div class="card-media"><img src="/assets/images/icon__source--prebid-docs.svg" alt="Prebid Sales Agent"></div>
+            <div class="card-title"><h3><a href="https://github.com/prebid/salesagent" class="stretched-link">Prebid Sales Agent</a></h3></div>
+          </div>
+        </div>
       </div>
     </div>
   </div>

From f6bf4229db409b14a418021d9f3672b4d872d87f Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Sun, 22 Feb 2026 14:08:02 -0500
Subject: [PATCH 475/665] Floors module: enforce by bidder (#6437)

* docs(floors): document bidder-scoped JS floor enforcement

* Update floors.md

* Update floors.md
---
 dev-docs/modules/floors.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md
index 0bc7b02a33..803b372b39 100644
--- a/dev-docs/modules/floors.md
+++ b/dev-docs/modules/floors.md
@@ -360,6 +360,7 @@ You **cannot** set the `floorMin` parameter without specifying a `data` object.
 | enforcement | object | Controls the enforcement behavior within the Price Floors Module.| - |
 | skipRate | integer | skipRate is a random function whose input value is any integer 0 through 100 to determine when to skip all floor logic, where 0 is always use floor data and 100 is always skip floor data. The use case is for publishers or floor providers to learn bid behavior when floors are applied or skipped. Analytics adapters will  have access to model version (if defined) when skipped is true to signal the Price Floors Module is in floors mode. If skipRate is supplied in both the root level of the floors object and within the data object, the skipRate configuration within the data object shall prevail. | 0 |
 | enforcement.enforceJS | boolean | If set to true, the Price Floors Module will provide floors to bid adapters for bid request matched rules and suppress any bids not exceeding a matching floor. If set to false, the Price Floors Module will still provide floors for bid adapters, there will be no floor enforcement.| true |
+| enforcement.enforceBidders | array of strings | Controls which bidders should have JavaScript floor enforcement applied when `enforcement.enforceJS` is `true`. Use bidder codes or `"*"` for all bidders. | `["*"]` |
 | enforcement.enforcePBS | boolean | If set to true, the Price Floors Module will signal to Prebid Server to pass floors to it’s bid adapters and enforce floors. If set to false, the pbjs should still pass matched bid request floor data to PBS, however no enforcement will take place. | true |
 | enforcement.floorDeals | boolean | Enforce floors for deal bid requests. | false |
 | enforcement.bidAdjustment | boolean | If true, the Price Floors Module will use the bidAdjustment function to adjust the floor per bidder. If false (or no bidAdjustment function is provided), floors will not be adjusted. Note: Setting this parameter to false may have unexpected results, such as signaling a gross floor when expecting net or vice versa. | true |
@@ -424,6 +425,7 @@ You **cannot** set the `floorMin` parameter without specifying a `data` object.
 | location | string | Prebid Server only: this is a read-only field set by the Prebid-Server floors feature to let analytics adapters know where the floors data came from. Possible values are: 'request', 'fetch' or 'noData'. | n/a |
 | enforcement | object | Controls the enforcement behavior within the module.| - |
 | enforcement.enforceJS | boolean | If set to true, the module will provide floors to bid adapters for bid request matched rules and suppress any bids not exceeding a matching floor. If set to false, the module will still provide floors for bid adapters, but there will be no floor enforcement.| true |
+| enforcement.enforceBidders | array of strings | Controls which bidders should have JavaScript floor enforcement applied when `enforcement.enforceJS` is `true`. Use bidder codes or `"*"` for all bidders. | `["*"]` |
 | enforcement.enforcePBS | boolean | If set to true, the module will signal to Prebid Server to pass floors to it’s bid adapters and enforce floors. If set to false, Prebid.js should still pass matched bid request floor data to Prebid Server, however no enforcement will take place. | true |
 | enforcement.floorDeals | boolean | Enforce floors for deal bid requests. | false |
 | enforcement.bidAdjustment | boolean | If true, the module will use the bidAdjustment function to adjust the floor per bidder. If false (or no bidAdjustment function is provided), floors will not be adjusted. Note: Setting this parameter to false may have unexpected results, such as signaling a gross floor when expecting net or vice versa. | true |

From 8e7a939f4d605c3c72b5a55d61f38ea96be6b132 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 23 Feb 2026 13:10:41 -0500
Subject: [PATCH 476/665] Docs: add setConfig guidance for
 disableFingerprintingApis (#6445)

* Document disableFingerprintingApis setConfig option

* Update description for disableFingerprintingApis control

Clarified the explanation of the 'disableFingerprintingApis' privacy control by adding a reference to DuckDuckGo tracker radar.
---
 dev-docs/publisher-api-reference/setConfig.md | 34 +++++++++++++++----
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index f52b9863cc..801b453c6b 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -59,6 +59,26 @@ This can be useful in GDPR, CCPA, COPPA or other privacy scenarios where a publi
 
 Note that bid adapters are normally denied access to device storage even when `deviceAccess` is `true`; see the [`storageAllowed` bidder setting](/dev-docs/publisher-api-reference/bidderSettings.html#deviceAccess).
 
+<a id="setConfig-disableFingerprintingApis"></a>
+
+### Disable fingerprinting APIs
+
+Prebid provides a privacy control named `disableFingerprintingApis` that lets publishers disable specific browser APIs commonly used for fingerprinting according to DuckDuckGo tracker radar.
+
+When one of these APIs is disabled, Prebid returns a safe default value instead of reading the browser value:
+
+* `devicepixelratio`: returns `1`
+* `webdriver`: returns `false`
+* `resolvedoptions`: returns an empty timezone string `''`
+
+```javascript
+pbjs.setConfig({
+  disableFingerprintingApis: ['devicepixelratio', 'webdriver', 'resolvedoptions']
+});
+```
+
+Values are matched case-insensitively.
+
 <a name="setConfig-Bidder-Timeouts"></a>
 
 ### Bidder Timeouts
@@ -1063,7 +1083,7 @@ To register a video player with Prebid, you must use `setConfig` to set a `video
 {: .table .table-bordered .table-striped }
 
 | Field | Required? | Type | Description |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | video.providers[] | yes | array of objects | List of Provider configurations. You must define a provider configuration for each player instance that you would like integrate with. |
 | video.providers[] .vendorCode | yes | number | The identifier of the Video Provider vendor (i.e. 1 for JW Player, 2 for videojs, etc). Allows Prebid to know which submodule to instantiate. |
 | video.providers[].divId | yes | string | The HTML element id of the player or its placeholder div. All analytics events for that player will reference this ID. Additionally, used to indicate which HTLM element must contain the Video Player instance when instantiated. |
@@ -1427,7 +1447,7 @@ The controls publishers have over the RTD modules:
 {: .table .table-bordered .table-striped }
 
 | Field | Required? | Type | Description |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | realTimeData.auctionDelay | no | integer | Defines the maximum amount of time, in milliseconds, the header bidding auction will be delayed while waiting for a response from the RTD modules as a whole group. The default is 0 ms delay, which means that RTD modules need to obtain their data when the page initializes. |
 | realTimeData.dataProviders[].waitForIt | no | boolean | Setting this value to true flags this RTD module as "important" enough to wait the full auction delay period. Once all such RTD modules have returned, the auction will proceed even if there are other RTD modules that have not yet responded. The default is `false`. |
 
@@ -1481,12 +1501,12 @@ pbjs.setConfig({
 {: .table .table-bordered .table-striped }
 
 | Field | Required? | Type | Description |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | topics.maxTopicCaller | no | integer | Defines the maximum numbers of Bidders Iframe which needs to be loaded on the publisher page. Default is 1 which is hardcoded in Module. Eg: topics.maxTopicCaller is set to 3. If there are 10 bidders configured along with their iframe URLS, random 3 bidders iframe URL is loaded which will call TOPICS API. If topics.maxTopicCaller is set to 0, it will load random 1(default) bidder iframe atleast. |
-| topics.bidders | no | Array of objects  | Array of topics callers with the iframe locations and other necessary informations like bidder(Bidder code) and expiry. Default Array of topics in the module itself.|
-| topics.bidders[].bidder | yes | string  | Bidder Code of the bidder(SSP).  |
-| topics.bidders[].iframeURL | yes | string  | URL which is hosted on bidder/SSP/third-party domains which will call Topics API.  |
-| topics.bidders[].expiry | no | integer  | Max number of days where Topics data will be persist. If Data is stored for more than mentioned expiry day, it will be deleted from storage. Default is 21 days which is hardcoded in Module. |
+| topics.bidders | no | Array of objects | Array of topics callers with the iframe locations and other necessary informations like bidder(Bidder code) and expiry. Default Array of topics in the module itself. |
+| topics.bidders[].bidder | yes | string | Bidder Code of the bidder(SSP). |
+| topics.bidders[].iframeURL | yes | string | URL which is hosted on bidder/SSP/third-party domains which will call Topics API. |
+| topics.bidders[].expiry | no | integer | Max number of days where Topics data will be persist. If Data is stored for more than mentioned expiry day, it will be deleted from storage. Default is 21 days which is hardcoded in Module. |
 
 <a id="setConfig-performanceMetrics"></a>
 

From 7f01a83093dbf11806fec23dde72c5f4aac8b486 Mon Sep 17 00:00:00 2001
From: verben-gh <ezequiel.espino@verben.com>
Date: Mon, 23 Feb 2026 20:19:04 +0200
Subject: [PATCH 477/665] New adapter: Verben (#6442)

* New adapter: Verben

* Apply suggestion from @muuki88

---------

Co-authored-by: Verben <support_trading@verben.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/verben.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/verben.md

diff --git a/dev-docs/bidders/verben.md b/dev-docs/bidders/verben.md
new file mode 100644
index 0000000000..4875e430ec
--- /dev/null
+++ b/dev-docs/bidders/verben.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: Verben
+description: Prebid Verben Bidder Adapter
+biddercode: verben
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 7e4989433c8a937e8d96ee6b2447a19123a17623 Mon Sep 17 00:00:00 2001
From: johnclc <johnclc@users.noreply.github.com>
Date: Mon, 23 Feb 2026 18:21:53 +0000
Subject: [PATCH 478/665] Teal bid adapter: updated with additional feature
 support (#6441)

* Teal bid adapter: updated supported media types

* Teal bid adapter: pbs and compression are supported
---
 dev-docs/bidders/teal.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/teal.md b/dev-docs/bidders/teal.md
index 0b15c7ca95..f41b672c79 100644
--- a/dev-docs/bidders/teal.md
+++ b/dev-docs/bidders/teal.md
@@ -18,13 +18,14 @@ gpp_supported: true
 gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 userIds: all
 safeframes_ok: true
-media_types: banner
+media_types: banner, native, video
 pbjs: true
-pbs: false
+pbs: true
 multiformat_supported: will-bid-on-any
 ortb_blocking_supported: true
 privacy_sandbox: no
 sidebarType: 1
+endpoint_compression: true
 ---
 
 ### Bid Params

From 41b227dc1c138ce497fb85d901d238ceba5794bc Mon Sep 17 00:00:00 2001
From: mpimentel-nexxen <mpimentel@nexxen.com>
Date: Mon, 23 Feb 2026 10:22:28 -0800
Subject: [PATCH 479/665] SBE-2291 Remove protected audience related info from
 Unruly adapter documentation (#6402)

---
 dev-docs/bidders/unruly.md | 26 --------------------------
 1 file changed, 26 deletions(-)

diff --git a/dev-docs/bidders/unruly.md b/dev-docs/bidders/unruly.md
index 644f9ea86b..0124c88676 100644
--- a/dev-docs/bidders/unruly.md
+++ b/dev-docs/bidders/unruly.md
@@ -30,32 +30,6 @@ sidebarType: 1
 | `siteid`           | deprecated     | The site ID from Unruly. This will be provided to you by your Unruly account manager, this is backward compability.          | `123456`                                         | `integer` |
 | `featureOverrides` | optional       | This param is a generic object for configuring Unruly outstream demand. To run UNmissable, set ‘canRunUnmissable’ to true.   | `"featureOverrides": {"canRunUnmissable": true}` | `object`  |
 
-### Protected Audience API (PAAPI) support
-
-There’s an option to receive demand for Protected Audience API (FLEDGE/PAAPI)
-ads using Unruly's (Nexxen) bid adapter.
-Prebid’s [paapiForGpt](https://docs.prebid.org/dev-docs/modules/paapiForGpt.html)
-module and Google Ad Manager is currently required.
-
-The following steps should be taken to setup Protected Audience for Unruly(Nexxen):
-
-1. Reach out to your account manager to coordinate set up:
-
-2. Build and enable PAAPI module as described in
-[paapiForGpt](https://docs.prebid.org/dev-docs/modules/paapiForGpt.html)
-module documentation.
-
-    Make sure to enable Unruly bidder to participate in PAAPI. If there are any other bidders to be allowed for that, add them to the **bidders** array:
-
-    ```javascript
-    pbjs.setConfig({
-       paapi: {
-         bidders: ["unruly"],
-         enabled: true
-       }    
-    })
-    ```
-
 ### First Party Data
 
 Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The following fields are supported:

From 440a110bcead88efd1e74e34f49c8e238876f76b Mon Sep 17 00:00:00 2001
From: Brian Weiss <brian@theproductcounsel.com>
Date: Mon, 23 Feb 2026 12:24:50 -0600
Subject: [PATCH 480/665] UserId Submodule: add LocID (locId) (#6406)

* UserId Submodule: add LocID (locId)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update LocID docs: atype 1, remove stable_cloc fallback, add connection_ip

- Changed EID atype from 3384 to 1 (device-based identifier per OpenRTB 2.6)
- Removed stable_cloc fallback language; module only uses tx_cloc for EID
- Updated endpoint spec to return connection_ip for IP-aware cache invalidation
- Clarified that stable_cloc is available for proxy operators, not transmitted client-side

* Fix MD032 and MD058 markdownlint errors

* LocID docs: add ipEndpoint param and IP change detection section

* Docs: remove LocID legacy 3384/GVL references and clarify atype 1

---------

Co-authored-by: Brian <bcweiss@gmail.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
---
 dev-docs/modules/userid-submodules/locid.md | 207 ++++++++++++++++++++
 1 file changed, 207 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/locid.md

diff --git a/dev-docs/modules/userid-submodules/locid.md b/dev-docs/modules/userid-submodules/locid.md
new file mode 100644
index 0000000000..bdff732a7f
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/locid.md
@@ -0,0 +1,207 @@
+---
+layout: userid
+title: LocID
+description: LocID User ID sub-module
+useridmodule: locIdSystem
+bidRequestUserId: locId
+eidsource: locid.com
+example: '"SYybozbTuRaZkgGqCD7L7EE0FncoNUcx-om4xTfhJt36TFIAES2tF1qPH"'
+---
+
+## Overview
+
+LocID is a geospatial identifier provided by Digital Envoy. The LocID User ID submodule retrieves a LocID from a publisher-controlled first-party endpoint, respects applicable privacy framework restrictions, and exposes the identifier to bidders via the standard EIDs interface.
+
+The endpoint is a first-party or on-premises service operated by the publisher, GrowthCode, or Digital Envoy. The module does not transmit IP addresses from the browser; instead, the server-side endpoint derives location information.
+
+## Registration
+
+No registration is required to use this module. Publishers must configure a first-party endpoint that proxies requests to the LocID encryption service.
+
+## Installation
+
+Build Prebid.js with the LocID module:
+
+```bash
+gulp build --modules=locIdSystem,userId
+```
+
+## Configuration
+
+### Default Mode
+
+By default, the module proceeds when no privacy framework signals are present (LI-based operation):
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: 'locId',
+      params: {
+        endpoint: 'https://id.example.com/locid',
+        ipEndpoint: 'https://id.example.com/ip'  // optional: lightweight IP-only check
+      },
+      storage: {
+        type: 'html5',
+        name: '_locid',
+        expires: 7
+      }
+    }]
+  }
+});
+```
+
+### Strict Mode
+
+To require privacy framework signals before proceeding, set `privacyMode: 'requireSignals'`:
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: 'locId',
+      params: {
+        endpoint: 'https://id.example.com/locid',
+        privacyMode: 'requireSignals'
+      },
+      storage: {
+        type: 'html5',
+        name: '_locid',
+        expires: 7
+      }
+    }]
+  }
+});
+```
+
+### Configuration with API Key and Alternative ID
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: 'locId',
+      params: {
+        endpoint: 'https://id.example.com/locid',
+        apiKey: 'your-api-key',
+        altId: 'publisher-user-id',
+        timeoutMs: 1000,
+        withCredentials: true
+      },
+      storage: {
+        type: 'html5',
+        name: '_locid',
+        expires: 7
+      }
+    }]
+  }
+});
+```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Param | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| name | Required | String | Module identifier. Must be `"locId"`. | `"locId"` |
+| params | Required | Object | Configuration parameters. | |
+| params.endpoint | Required | String | First-party LocID endpoint URL. See Endpoint Requirements below. | `"https://id.example.com/locid"` |
+| params.ipEndpoint | Optional | String | Separate lightweight endpoint returning only the connection IP. Used for IP change detection without a full tx_cloc fetch. | `"https://id.example.com/ip"` |
+| params.ipCacheTtlMs | Optional | Number | TTL for the IP cache entry in milliseconds. | `14400000` (4 hours, default) |
+| params.altId | Optional | String | Alternative identifier appended as `?alt_id=` query parameter. | `"user123"` |
+| params.timeoutMs | Optional | Number | Request timeout in milliseconds. | `800` (default) |
+| params.withCredentials | Optional | Boolean | Include credentials (cookies) on the request. | `false` (default) |
+| params.apiKey | Optional | String | API key passed via the `x-api-key` request header. | `"your-api-key"` |
+| params.privacyMode | Optional | String | Privacy mode: `"allowWithoutSignals"` (default) or `"requireSignals"`. | `"allowWithoutSignals"` |
+| params.requirePrivacySignals | Optional | Boolean | If `true`, requires privacy signals to be present. Equivalent to `privacyMode: 'requireSignals'`. | `false` (default) |
+| storage | Required | Object | Storage configuration for caching the ID. | |
+| storage.type | Required | String | Storage type. Use `"html5"` for localStorage. | `"html5"` |
+| storage.name | Required | String | Storage key name. | `"_locid"` |
+| storage.expires | Optional | Number | TTL in days. | `7` |
+
+## Endpoint Requirements
+
+The `endpoint` parameter must point to a first-party proxy or on-premises service, not the LocID Encrypt API directly.
+
+The LocID Encrypt API requires the client IP address as a parameter. Since browsers cannot determine their own public IP, a server-side proxy is required to:
+
+1. Receive the request from the browser
+2. Extract the client IP from the incoming connection
+3. Forward the request to the LocID Encrypt API with the IP injected
+4. Return the response (`tx_cloc`, `connection_ip`) to the browser
+
+If `altId` is configured, the module appends it as `?alt_id=<value>` to the endpoint URL.
+
+## Privacy Handling
+
+LocID operates under Legitimate Interest (LI). The module's privacy behavior depends on the configured privacy mode.
+
+### Default Behavior (allowWithoutSignals)
+
+- **No privacy signals present**: Module proceeds and fetches the ID
+- **Privacy signals present**: Enforcement rules apply
+
+### Strict Mode (requireSignals)
+
+- **No privacy signals present**: Module returns `undefined`
+- **Privacy signals present**: Enforcement rules apply
+
+### Privacy Signal Enforcement
+
+When privacy signals are present, the module does not fetch or return an ID if any of the following apply:
+
+- GDPR applies and vendorData is present, but consentString is missing or empty
+- US Privacy (CCPA) string indicates a processing restriction (third character is `Y`)
+- GPP signals indicate an applicable processing restriction
+
+When GDPR applies and consentString is present, the module proceeds unless a framework processing restriction is signaled.
+
+## Storage
+
+The module caches the LocID using Prebid's standard storage framework. Configure storage settings via the `storage` object.
+
+The endpoint response contains:
+
+- `tx_cloc`: Transactional LocID (used as the EID value)
+- `connection_ip`: The resolved client IP address (used for IP-aware cache invalidation)
+
+The module only uses `tx_cloc` for the EID. Any `stable_cloc` in the response is ignored client-side; it is available for proxy/endpoint operators to use in their own caching strategies.
+
+### IP Change Detection
+
+The module uses a two-tier cache to detect IP changes without churning the tx_cloc identifier:
+
+- **IP cache** (default 4-hour TTL): Tracks the current connection IP in a separate localStorage key.
+- **tx_cloc cache** (configured via `storage.expires`): Stores the LocID via Prebid's userId framework.
+
+When the IP cache expires, the module refreshes the IP. If `ipEndpoint` is configured, it makes a lightweight IP-only check first and only calls the main endpoint when the IP has changed. If the IP is unchanged and the tx_cloc cache is still valid, the existing tx_cloc is reused without calling the main endpoint.
+
+## EID Output
+
+When available, the LocID is included in the bid request as:
+
+```json
+{
+  "source": "locid.com",
+  "uids": [{
+    "id": "SYybozbTuRaZkgGqCD7L7EE0FncoNUcx-om4xTfhJt36TFIAES2tF1qPH",
+    "atype": 1
+  }]
+}
+```
+
+The `atype` value of `1` is the OpenRTB agent type for web environment; it is not an IAB GVL vendor ID.
+
+## Debugging
+
+```javascript
+// Check if LocID is available
+pbjs.getUserIds().locId
+
+// Force refresh
+pbjs.refreshUserIds()
+
+// Check stored value
+localStorage.getItem('_locid')
+```

From 1f91fdaf01a6a60c5ba61426d8dff50a9b2968d3 Mon Sep 17 00:00:00 2001
From: pgomulka-id5 <pgomulka@id5.io>
Date: Mon, 23 Feb 2026 19:28:26 +0100
Subject: [PATCH 481/665] Id5 - public doc for custom external targeting tags
 (#6388)

* Id5 - public doc for custom external targeting tags

* remove the comparsion to gam

* lint
---
 dev-docs/modules/userid-submodules/id5.md | 42 +++++++++++++++--------
 1 file changed, 28 insertions(+), 14 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/id5.md b/dev-docs/modules/userid-submodules/id5.md
index 1ae8328b22..6c0318b24e 100644
--- a/dev-docs/modules/userid-submodules/id5.md
+++ b/dev-docs/modules/userid-submodules/id5.md
@@ -29,20 +29,21 @@ The following configuration parameters are available:
 
 {: .table .table-bordered .table-striped }
 
-| Param under userSync.userIds[] | Scope | Type | Description | Example |
-| --- | --- | --- | --- | --- |
-| name | Required | String | The name of this module: `"id5Id"` | `"id5Id"` |
-| params | Required | Object | Details for the ID5 ID. | |
-| params.partner | Required | Number | This is the ID5 Partner Number obtained from registering with ID5. | `173` |
-| params.externalModuleUrl | Optional | String | URL to the external ID5 module. Highly recommended for the best integration possible. This is additional javascript unreviewed by the prebid.js community | `https://cdn.id5-sync.com/api/1.0/id5PrebidModule.js` |
-| params.pd | Optional | String | Partner-supplied data used for linking ID5 IDs across domains. See [our documentation](https://wiki.id5.io/en/identitycloud/retrieve-id5-ids/passing-partner-data-to-id5) for details on generating the string. Omit the parameter or leave as an empty string if no data to supply | `"MT1iNTBjY..."` |
-| params.abTesting | Optional | Object | Allows publishers to easily run an A/B Test. If enabled and the user is in the Control Group, the ID5 ID will NOT be exposed to bid adapters for that request | Disabled by default |
-| params.abTesting.enabled | Optional | Boolean | Set this to `true` to turn on this feature | `true` or `false` |
-| params.abTesting.controlGroupPct | Optional | Number | Must be a number between `0.0` and `1.0` (inclusive) and is used to determine the percentage of requests that fall into the control group (and thus not exposing the ID5 ID). For example, a value of `0.20` will result in 20% of requests without an ID5 ID and 80% with an ID. | `0.1` |
-| params.disableExtensions | Optional | Boolean | Set this to `true` to force turn off extensions call. Default `false` | `true` or `false` |
-| params.canCookieSync | Optional | Boolean | Set this to `true` to enable cookie syncing with other ID5 partners. See [our documentation](https://wiki.id5.io/docs/initiate-cookie-sync-to-id5) for details. Default `false` | `true` or `false` |
-| params.provider | Optional | String | An identifier provided by ID5 to technology partners who manage API deployments on behalf of their clients. Reach out to ID5 if you have questions about this parameter. | `"providerName"` |
+| Param under userSync.userIds[] | Scope | Type    | Description | Example                                               |
+| --- | --- |---------| --- |-------------------------------------------------------|
+| name | Required | String  | The name of this module: `"id5Id"` | `"id5Id"`                                             |
+| params | Required | Object  | Details for the ID5 ID. |                                                       |
+| params.partner | Required | Number  | This is the ID5 Partner Number obtained from registering with ID5. | `173`                                                 |
+| params.externalModuleUrl | Optional | String  | URL to the external ID5 module. Highly recommended for the best integration possible. This is additional javascript unreviewed by the prebid.js community | `https://cdn.id5-sync.com/api/1.0/id5PrebidModule.js` |
+| params.pd | Optional | String  | Partner-supplied data used for linking ID5 IDs across domains. See [our documentation](https://wiki.id5.io/en/identitycloud/retrieve-id5-ids/passing-partner-data-to-id5) for details on generating the string. Omit the parameter or leave as an empty string if no data to supply | `"MT1iNTBjY..."`                                      |
+| params.abTesting | Optional | Object  | Allows publishers to easily run an A/B Test. If enabled and the user is in the Control Group, the ID5 ID will NOT be exposed to bid adapters for that request | Disabled by default                                   |
+| params.abTesting.enabled | Optional | Boolean | Set this to `true` to turn on this feature | `true` or `false`                                     |
+| params.abTesting.controlGroupPct | Optional | Number  | Must be a number between `0.0` and `1.0` (inclusive) and is used to determine the percentage of requests that fall into the control group (and thus not exposing the ID5 ID). For example, a value of `0.20` will result in 20% of requests without an ID5 ID and 80% with an ID. | `0.1`                                                 |
+| params.disableExtensions | Optional | Boolean | Set this to `true` to force turn off extensions call. Default `false` | `true` or `false`                                     |
+| params.canCookieSync | Optional | Boolean | Set this to `true` to enable cookie syncing with other ID5 partners. See [our documentation](https://wiki.id5.io/docs/initiate-cookie-sync-to-id5) for details. Default `false` | `true` or `false`                                     |
+| params.provider | Optional | String  | An identifier provided by ID5 to technology partners who manage API deployments on behalf of their clients. Reach out to ID5 if you have questions about this parameter. | `"providerName"`                                      |
 | params.gamTargetingPrefix | Optional | String  | When this parameter is set the ID5 module will set appropriate GAM pubads targeting tags                                                                                                                                                                                            | `"id5"`                                               |
+| params.exposeTargeting | Optional | boolean | When this parameter is set the ID5 module will execute `window.id5tags.cmd` callbacks for custom targeting tags                                                                                                       | `false`                                               |
 
 {: .alert.alert-info :}
 **NOTE:** The ID5 ID that is delivered to Prebid will be encrypted by ID5 with a rotating key to avoid unauthorized usage and to enforce privacy requirements. Therefore, we strongly recommend setting `storage.refreshInSeconds` to `2` hours (`7200` seconds) or less to ensure all demand partners receive an ID that has been encrypted with the latest key, has up-to-date privacy signals, and allows them to transact against it.
@@ -66,6 +67,18 @@ If `params.gamTargetingPrefix` is set to a non-empty value and an ID5 module has
 - `{prefix}_id` - set to `y` if a valid id5id was present, otherwise tag is not set
 - `{prefix}_ab` - set if `abTesting` was enabled - `n` if in Normal group (with ID5 returned), `c` if in Control group (without ID5 returned)
 
+### Tags exposed via window.id5tags
+The ID5 UserId module can expose targeting tags through a global window.id5tags object, if enabled by setting params.exposeTargeting: true.
+If `params.exposeTargeting` is set to true and an ID5 module has initialized, the ID5 module will expose tags through a command queue pattern
+Publishers can queue callback functions to access tags:
+
+```javascript
+window.id5tags = window.id5tags || { cmd: [] };
+window.id5tags.cmd.push((tags) => {
+// Use for custom analytics, targeting, etc.
+});
+```
+
 ### A Note on Using Multiple Wrappers
 If you or your monetization partners are deploying multiple Prebid wrappers on your websites, you should make sure you add the ID5 ID User ID module to *every* wrapper. Only the bidders configured in the Prebid wrapper where the ID5 ID User ID module is installed and configured will be able to pick up the ID5 ID. Bidders from other Prebid instances will not be able to pick up the ID5 ID.
 
@@ -95,7 +108,8 @@ pbjs.setConfig({
           controlGroupPct: 0.1   // valid values are 0.0 - 1.0 (inclusive)
         },
         canCookieSync: true,      // optional, has effect only when externalModuleUrl is used
-        gamTargetingPrefix: "id5" // optional, when set the ID5 module will set gam targeting paramaters with this prefix
+        gamTargetingPrefix: "id5", // optional, when set the ID5 module will set gam targeting paramaters with this prefix
+          exposeTargeting: true // optional, when set the ID5 module will execute `window.id5tags.cmd` callbacks for custom targeting tags 
       },
       storage: {
         type: 'html5',           // "html5" is the recommended storage type

From 27067c1ac858753a805339a284d410b66bb21272 Mon Sep 17 00:00:00 2001
From: ysfbsf <youssef.bsf@gmail.com>
Date: Mon, 23 Feb 2026 18:29:20 +0000
Subject: [PATCH 482/665] Add gpp_sids field to Missena bidder documentation
 (#6428)


From 5739ab9a5659ea3980f7a7db30d5acd370d23b50 Mon Sep 17 00:00:00 2001
From: morock <98119227+mo4rock@users.noreply.github.com>
Date: Mon, 23 Feb 2026 20:29:59 +0200
Subject: [PATCH 483/665] New Adapter: leagueM (#6434)

---
 dev-docs/bidders/leagueM.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/leagueM.md

diff --git a/dev-docs/bidders/leagueM.md b/dev-docs/bidders/leagueM.md
new file mode 100644
index 0000000000..9d4e147721
--- /dev/null
+++ b/dev-docs/bidders/leagueM.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: LeagueM
+description: LeagueM Bidder Adapter
+biddercode: leagueM
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: false
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `0e232769e6f71d291ee7dbc9d157cf84` | `string`  |
+| `env`       | optional | Environment name            | `leagueM`                          | `string`  |
+| `ext`       | optional | Specific integration config | `{}`                               | `object`  |

From 82d47a1b10c7a612358c273837bb24ab8f32069d Mon Sep 17 00:00:00 2001
From: Fatih Kaya <fatih.kaya.84@gmail.com>
Date: Mon, 23 Feb 2026 21:31:47 +0300
Subject: [PATCH 484/665] AdMatic: documenting adrubi alias (#6444)

* added simple params

* update

* Update admatic.md

* update

* update

* Pixad Bid Adapter: added simple params

* AdMatic Adapter: Feature update

Pixad alias is included in the update.

* Update admatic.md

* Update pixad.md

* gvl_id add

* Update pixad.md

* admatic && pixad pbs support true

* Create monetixads.md

* new alias

* new alias

* Update adt.md

* Revert "Update adt.md"

This reverts commit c274c967792bb77e7c897501b70732df5acc6290.

* Revert "new alias"

This reverts commit cb15f2c27b28d937986d53ebaf3efeabfd5df9d3.

* Create adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* Update adt.md

* yobee

* Update yobee.md

* dev-doc update

* Update admaticde.md

* Create adrubi.mb

* Revert "Create adrubi.mb"

This reverts commit 9bf9224db372b92b5861bf23e6a7786c2dbf3084.

* Create adrubi.md
---
 dev-docs/bidders/adrubi.md | 91 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 dev-docs/bidders/adrubi.md

diff --git a/dev-docs/bidders/adrubi.md b/dev-docs/bidders/adrubi.md
new file mode 100644
index 0000000000..bbb5455f4e
--- /dev/null
+++ b/dev-docs/bidders/adrubi.md
@@ -0,0 +1,91 @@
+---
+layout: bidder
+title: AdRubi
+description: Prebid AdRubi Bidder Adapter.
+pbjs: true
+pbs: true
+biddercode: adrubi
+media_types: banner,video,native
+gvl_id: 779 (adt)
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+schain_supported: true
+dchain_supported: false
+userIds: all
+safeframes_ok: true
+floors_supported: true
+aliasCode: admatic
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+### Description
+
+AdRubi header bidding adapter connects with AdRubi demand sources to fetch bids for network ID. Please reach out to your account manager or <support@adrubi.com> for more information.
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                         | Example  | Type     |
+|-------------|----------|-------------------------------------|----------|----------|
+| `networkId` | required | The network ID from AdRubi | `12345` | `number` |
+| `host` | required | RTB Host | `adrubi.rtb.adrubi.com` | `string` |
+
+### Test Parameters
+
+300x250 banner test
+
+```javascript
+var adUnits = [{
+  code: 'your-slot_1-div',
+  mediaTypes: {
+    banner: { sizes: [[300, 250]] },
+  },
+  bids: [{
+      bidder: 'adrubi',
+      params: { 
+          networkId: 12345,
+          host: 'adrubi.rtb.adrubi.com'
+      }
+  }]
+},{
+  code: 'your-slot_2-div',
+  mediaTypes: {
+    native: { ... },
+  },
+  bids: [{
+      bidder: 'adrubi',
+      params: { 
+          networkId: 12345,
+          host: 'adrubi.rtb.adrubi.com'
+      }
+  }]
+},{
+  code: 'your-slot_3-div',
+  mediaTypes: {
+    video: { ... },
+  },
+  bids: [{
+      bidder: 'adrubi',
+      params: { 
+          networkId: 12345,
+          host: 'adrubi.rtb.adrubi.com'
+      }
+  }]
+}];
+```
+
+### UserSync example
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    iframeEnabled: true,
+    syncEnabled: true,
+    syncDelay: 1,
+    aliasSyncEnabled: true
+  }
+});
+```

From 115596bf090bf7468b25437f439e03ef1528f98c Mon Sep 17 00:00:00 2001
From: danijel-ristic <168181386+danijel-ristic@users.noreply.github.com>
Date: Tue, 24 Feb 2026 20:06:34 +0100
Subject: [PATCH 485/665] Update docs (#6418)

* Update docs

* Update docs metadata

* Update userIds docs

---------

Co-authored-by: dnrstc <danrstc@gmail.com>
---
 dev-docs/bidders/targetvideo.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/dev-docs/bidders/targetvideo.md b/dev-docs/bidders/targetvideo.md
index 61a73ace1c..25cf10ab24 100644
--- a/dev-docs/bidders/targetvideo.md
+++ b/dev-docs/bidders/targetvideo.md
@@ -8,7 +8,11 @@ gvl_id: 786
 tcfeu_supported: true
 schain_supported: true
 pbjs: true
+prebid_member: true
+userIds: all
+floors_supported: true
 sidebarType: 1
+multiformat_supported: will-bid-on-one
 ---
 
 #### Bid Params
@@ -17,3 +21,4 @@ sidebarType: 1
 | Name                | Scope    | Description                                                                                                                                                                   | Example                                               | Type             |
 |---------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|------------------|
 | `placementId`       | required | The placement ID from TargetVideo. You will get this value from your TargetVideo account manager. The placementID parameter should be a `string`.                                                    | `234234`                                            | `string`         |
+| `floor`       | optional           | Sets the global floor -- no bids will be made under this value.                                                             | `0.50`                                                                              | `float`          |

From aa43916c8e7fc28b68bf52c65bef882176fc7e11 Mon Sep 17 00:00:00 2001
From: Jose Climaco <josepereira@me.com>
Date: Tue, 24 Feb 2026 19:07:59 +0000
Subject: [PATCH 486/665] InsurAds Bid Adapter: Initial Implementation (#6430)

* Add Insurads Bidder Adapter

* Update dev-docs/bidders/insurads.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/insurads.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/insurads.md | 142 +++++++++++++++++++++++++++++++++++
 1 file changed, 142 insertions(+)
 create mode 100644 dev-docs/bidders/insurads.md

diff --git a/dev-docs/bidders/insurads.md b/dev-docs/bidders/insurads.md
new file mode 100644
index 0000000000..c4e5b61a32
--- /dev/null
+++ b/dev-docs/bidders/insurads.md
@@ -0,0 +1,142 @@
+---
+layout: bidder
+title: InsurAds
+description: Prebid InsurAds Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: insurads
+gvl_id: 596
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+tcfeu_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required | InsurAds tag ID            | `"testnexx"`                              | `string`  |
+| `videoTagId`  | optional | InsurAds Video tag ID      | `"testnexx"`                              | `string`  |
+| `nativeTagId` | optional | InsurAds Native tag ID     | `"testnexx"`                              | `string`  |
+| `allBids`     | optional | Return all bids            | `true`                                    | `boolean` |
+| `divId`       | optional | divId linked to adUnit     | `"div-1"`                                 | `string`  |
+| `adUnitName`  | optional | A code to identify adUnit  | `"header-ad"`                             | `string`  |
+| `adUnitPath`  | optional | A reference to adUnit Path | `"/12345/insurads/Homepage/HP/Header-Ad"` | `string`  |
+| `placement`   | optional | InsurAds placement         | `"TEST_PLACEMENT"`                        | `string`  |
+
+You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+### Bidder Config
+
+You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `insurads`
+
+{% include dev-docs/storageAllowed.md %}
+
+```javascript
+pbjs.bidderSettings = {
+    insurads: {
+        storageAllowed : true
+    }
+}
+```
+
+### First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html).
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'insurads',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'insurads',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes: {
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'insurads',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+    // Multiformat Ad
+   {
+        code: 'multi1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            },
+            banner: {
+              sizes: [[300, 250], [300,600]]
+            },
+            native: {
+
+            }
+        },
+        bids: [{
+            bidder: 'insurads',
+            params: {
+               tagId: 'testnexx',
+               videoTagId: 'testnexx'
+            }
+        }]
+    };
+];
+```

From 264ad032cb34afbea38be7aa0d2f2b8164bab077 Mon Sep 17 00:00:00 2001
From: Maksym Danylov <146753616+mdanylov-sigma@users.noreply.github.com>
Date: Thu, 26 Feb 2026 20:53:04 +0200
Subject: [PATCH 487/665] iOS code integration doc updates (#6433)

* iOS code integration doc updates.

* Update CocoaPods and Carthage deprecation timelines
---
 .../pbm-api/ios/code-integration-ios.md       | 27 ++++++++++++++-----
 1 file changed, 21 insertions(+), 6 deletions(-)

diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index a686b878af..0c61ddaf5e 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -32,6 +32,11 @@ end
 
 Now run `pod install` to add the Prebid SDK to project dependencies.
 
+{: .alert.alert-warning :}
+Support for CocoaPods will be discontinued in Q4 2026. As CocoaPods is transitioning to read-only mode, it will no longer be supported for future updates. For more details, please refer to the official [announcement](https://blog.cocoapods.org/CocoaPods-Specs-Repo/).
+
+We strongly recommend that publishers migrate to Swift Package Manager (SPM) to ensure ongoing compatibility and access to future releases. Please follow the [instructions](/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-package-manager-spm) to transition your integration.
+
 ### Carthage
 
 If you are not familiar with the Carthage package builder, please refer to the project [github page](https://github.com/Carthage/Carthage) for more details.
@@ -41,6 +46,11 @@ If you are not familiar with the Carthage package builder, please refer to the p
 3. Run `carthage update`.
 4. Drag `PrebidMobile.xcframework` from `Carthage/Build` to `General -> Linked Frameworks and Libraries`
 
+{: .alert.alert-warning :}
+Support for Carthage will be discontinued in Q4 2026.
+
+We strongly recommend that publishers migrate to Swift Package Manager (SPM) to ensure ongoing compatibility and access to future releases. Please follow the [instructions](/prebid-mobile/pbm-api/ios/code-integration-ios.html#swift-package-manager-spm) to transition your integration.
+
 ### XCFramework
 
 1. Clone the project and run script `scripts/buildPrebidMobile.sh`
@@ -54,18 +64,23 @@ Starting from version `3.1.0`, PrebidMobile supports the Swift Package Manager (
 To [add the Prebid Mobile SDK package dependency](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#Add-a-package-dependency) using SPM, follow these steps:
 
 1. In Xcode, install the Prebid Mobile SDK by navigating to File > Add Package Dependencies...
-2. In the prompt that appears, search for the Prebid Mobile SDK GitHub repository:
+2. In the prompt that appears, use the search field to find the appropriate package based on your integration needs. Search for `Prebid Mobile SDK` to install the core SDK, or `Prebid Mobile SDK Adapters` if you need mediation adapters (GAM, AdMob, MAX).
+
+    `Prebid Mobile SDK`
+    
+    ```bash
+    https://github.com/prebid/prebid-mobile-ios-sdk.git
+    ```
+
+    `Prebid Mobile SDK Adapters`
 
     ```bash
-    https://github.com/prebid/prebid-mobile-ios.git
+    https://github.com/prebid/prebid-mobile-ios-adapters.git
     ```
-    
+
 3. Select the version of the Prebid Mobile SDK you want to use. For new projects, we recommend using the `Up to Next Major Version`.
 4. In the package selection screen, make sure to check the modules you need for your integration and link it to your application target.
 
-{: .alert.alert-info :}
-The Swift Package Manager (SPM) integration is currently marked as beta. We are actively working on refining the project structure and modularization to improve clarity, performance, and ease of integration. During this period, some modules or dependencies may be reorganized. We welcome your feedback - if you encounter any issues or have suggestions, please don't hesitate to reach out and help us shape the future of the PrebidMobile SPM support.
-
 ### Build framework from source
 
 Build Prebid Mobile from source code. After [cloning the repo](https://github.com/prebid/prebid-mobile-ios), use Terminal or another command line tool, change to the root directory and run:

From 72d001b9455636bf6621b2180f4d139728ba73a8 Mon Sep 17 00:00:00 2001
From: Scott Sundahl <37344964+ssundahlTTD@users.noreply.github.com>
Date: Thu, 26 Feb 2026 11:59:15 -0700
Subject: [PATCH 488/665] Uid2 euid optout docs (#6443)

* added docs to explain optout response for uid2 and euid

* revert format change

* remove typo ticks

* too many new lines

* improper json formatting
---
 dev-docs/modules/userid-submodules/euid.md    | 19 +++++++++++++++++++
 .../modules/userid-submodules/unified2.md     | 19 +++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/dev-docs/modules/userid-submodules/euid.md b/dev-docs/modules/userid-submodules/euid.md
index 7f1321754e..aeedada2c7 100644
--- a/dev-docs/modules/userid-submodules/euid.md
+++ b/dev-docs/modules/userid-submodules/euid.md
@@ -48,6 +48,25 @@ The following sample is fictitious, but shows what the token response object loo
 
 When this full data structure is provided, the module automatically refreshes the token periodically, as long as the refresh token hasn't expired.
 
+The following example shows the response for a user that has opted out:
+
+```json
+{
+  "identity": "optout",
+  "status": "optout"
+}
+```
+
+The following example shows the decoded EUID userId object:
+
+```json
+{
+  "euid": {
+    "optout": true
+  }
+}
+```
+
 ## Client Refresh mode
 
 This is the recommended mode for most scenarios. In this mode, the full response body from the EUID Token Generate or Token Refresh endpoint must be provided to the module. As long as the refresh token remains valid, the module will refresh the advertising token as needed.
diff --git a/dev-docs/modules/userid-submodules/unified2.md b/dev-docs/modules/userid-submodules/unified2.md
index 74593d37df..0c2fc02cc3 100644
--- a/dev-docs/modules/userid-submodules/unified2.md
+++ b/dev-docs/modules/userid-submodules/unified2.md
@@ -49,6 +49,25 @@ The following sample is fictitious, but shows what the token response object loo
 
 When this full data structure is provided, the module automatically refreshes the token periodically, as long as the refresh token hasn't expired.
 
+The following example shows the response for a user that has opted out:
+
+```json
+{
+  "identity": "optout",
+  "status": "optout"
+}
+```
+
+The following example shows the decoded UID2 userId object:
+
+```json
+{
+  "uid2": {
+    "optout": true
+  }
+}
+```
+
 ## Unified ID 2.0 Server-Only Mode
 
 There is a server-only mode where the value of the advertising token can be provided either directly (see the `value` parameter in the [Unified ID 2.0 Configuration](#unified-id-20-configuration) section) or via a cookie. In this mode, no attempt is made to automatically refresh the token.

From c5f87b8c2cccdae8647842df9235e9bb89e084c9 Mon Sep 17 00:00:00 2001
From: DariaBoykoAdmixer <dboyko@admixer.com>
Date: Fri, 27 Feb 2026 10:45:59 +0200
Subject: [PATCH 489/665] Add additional name to FutureAds bidder: Mandeta
 (#6455)

* Add admixerwl alias for admixerBidAdapter.

* Specify multiformat_supported and safeframes_ok for admixerwl adapter.

* add Mandeta name to FutureAds bidder

---------

Co-authored-by: Yaroslav Masenko <intgr-user@admixer.ua>
Co-authored-by: AdmixerTech <35560933+AdmixerTech@users.noreply.github.com>
Co-authored-by: Daria Boyko <dariaboiko03@gmail.com>
---
 dev-docs/bidders/futureads.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/futureads.md b/dev-docs/bidders/futureads.md
index 6fe057af2f..968cba36c2 100644
--- a/dev-docs/bidders/futureads.md
+++ b/dev-docs/bidders/futureads.md
@@ -1,7 +1,7 @@
 ---
 layout: bidder
-title: FutureAds
-description: Prebid FutureAds Bidder Adaptor
+title: Mandeta (FutureAds)
+description: Prebid Mandeta (FutureAds) Bidder Adaptor
 pbjs: true
 pbs: true
 biddercode: futureads
@@ -21,5 +21,5 @@ sidebarType: 1
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description                                                                                                    | Example                                | Type     |
 |---------------|----------|----------------------------------------------------------------------------------------------------------------|----------------------------------------|----------|
-| `zone`        | required | The unique identifier of the ad placement. Could be obtained from the FutureAds UI or from your account manager. | "e5ff8e48-4bd0-4a2c-9236-55530ab8981d" | `string` |
+| `zone`        | required | The unique identifier of the ad placement. Could be obtained from the Mandeta (FutureAds) UI or from your account manager. | "e5ff8e48-4bd0-4a2c-9236-55530ab8981d" | `string` |
 | `kvTargeting` | optional | Key/Value - a pair of the unique values that will be used for the custom targeting option.                     | {key1: value2, key2: value2}           | `object` |

From 22f6128eef75ae1b73b8a7ff7b0df9cb87b4a447 Mon Sep 17 00:00:00 2001
From: Roger <104763658+rogerDyl@users.noreply.github.com>
Date: Fri, 27 Feb 2026 09:46:58 +0100
Subject: [PATCH 490/665] Shaping rules module typos (#6447)

* Fix typos in Shaping Rules module documentation

* Fix extraSchemaEvaluators example type

* Add missing required field version

* Revert changes of `conditions`
---
 dev-docs/modules/shapingRulesModule.md | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/dev-docs/modules/shapingRulesModule.md b/dev-docs/modules/shapingRulesModule.md
index f793003a94..3c6bd87a87 100644
--- a/dev-docs/modules/shapingRulesModule.md
+++ b/dev-docs/modules/shapingRulesModule.md
@@ -178,16 +178,17 @@ pbjs.setConfig({
   shapingRules: {
     rules: {
       enabled: true,
-      rulesets: [
+      version: "123",
+      ruleSets: [
         {
           stage: "processed-auction-request",
           name: "exclude-in-jpn",
-          version: "1234",
+          version: "456",
           modelGroups: [
             {
               weight: 98,
               analyticsKey: "experiment-name",
-              version: "4567",
+              version: "789",
               schema: [
                 {
                   function: "deviceCountryIn",
@@ -225,7 +226,7 @@ The configuration also allows you to define custom schema evaluators using the `
 pbjs.setConfig({
   shapingRules: {
     extraSchemaEvaluators: {
-      browser: (args, context) => {
+      browser: (args, context) => () => {
         if (navigator.userAgent.includes("Chrome")) {
           return "Chrome";
         }
@@ -233,16 +234,17 @@ pbjs.setConfig({
     },
     rules: {
       enabled: true,
-      rulesets: [
+      version: "123",
+      ruleSets: [
         {
           stage: "processed-auction-request",
           name: "exclude-in-jpn",
-          version: "1234",
+          version: "456",
           modelGroups: [
             {
               weight: 98,
               analyticsKey: "experiment-name",
-              version: "4567",
+              version: "789",
               schema: [
                 {
                   function: "browser",

From 3bc803c6cf6b19ff6074d7624c677b21e79757db Mon Sep 17 00:00:00 2001
From: FreeWheelVIS <vis@freewheel.tv>
Date: Sat, 28 Feb 2026 02:45:58 -0500
Subject: [PATCH 491/665] FreeWheelVIS: remove old docs related to
 SFX/sitckyads (#6346)

Co-authored-by: Josh Kraskin <jkraskin@freewheel.com>
---
 dev-docs/bidders/freewheelssp.md | 67 --------------------------------
 dev-docs/bidders/stickyadstv.md  | 12 ------
 2 files changed, 79 deletions(-)
 delete mode 100644 dev-docs/bidders/freewheelssp.md
 delete mode 100644 dev-docs/bidders/stickyadstv.md

diff --git a/dev-docs/bidders/freewheelssp.md b/dev-docs/bidders/freewheelssp.md
deleted file mode 100644
index 781c137295..0000000000
--- a/dev-docs/bidders/freewheelssp.md
+++ /dev/null
@@ -1,67 +0,0 @@
----
-layout: bidder
-title: FreeWheelssp
-description: Freewheel Bidder Adaptor
-pbjs: true
-pbs: true
-biddercode: freewheelssp
-aliasCode: freewheel-ssp
-gvl_id: 285
-tcfeu_supported: true
-usp_supported: true
-gpp_supported: true
-coppa_supported: true
-schain_supported: true
-media_types: video
-ortb_blocking_supported: partial
-sidebarType: 1
----
-
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name     | Scope    | Description | Example | Type     |
-|----------|----------|-------------------------|--------|----------|
-| `zoneId` | required | The zone ID for the ad. | "2003" | `string` |
-| `format` | optional | The format to use for displaying the ad. Can be one of the following:<br/>*screen-roll<br/>* intext-roll<br/>*sliderad<br/>* floorad<br/>*expand-banner<br/>* instream<br/>* inbanner<br/>Note: The screen-roll, intext-roll, sliderad and floorad formats are all FreeWheel outstream formats.<br>Default value: "instream" | "screen-roll" | `string` |
-| `bidfloor` | optional | Bid floor price. | 13.2118  | `float` |
-| `bidfloorcur` | optional | Bid floor currency. | "USD" | `string` |
-| `vastUrlParams` | optional | Add query parameters to the vast request. Should be a single item level JSON.<br>Works with formats: instream, inbanner | { protocolVersion:'3.0' } | `object` |
-
-When the following params are used with instream or inbanner formats, they should be included in the `vastUrlParams` object. For other formats, they should be included directly in the `params` object:
-
-{: .table .table-bordered .table-striped }
-| Name     | Scope    | Description | Example | Type     |
-|----------|----------|-------------------------|--------|----------|
-| `soundButton` | optional | If enabled, the sound will be off by default and the user will be able to turn it on/off by clicking on a button. (disabled on iOS devices)<br/>Default value: false | true | `boolean` |
-| `defaultMute` | optional | If "soundButton=true" is set, controls if the video will start with the sound muted.<br/>Default value: true | false | `boolean` |
-| `timeline` | optional | Display a progress bar to the bottom of the ad unit.<br/> Default value: false | true | `boolean` |
-| `protocolVersion` | optional | Specify the VAST version that will be used for the vastVersion parameter value on AdsSetup request.<br/>Default Value: 4.2 | 3 .0 | `float` |
-| `onOver` | optional | Allows to enable the sound only when the mouse is over the ad container.<br/> Works with formats: screen-roll, intext-roll, sliderad, floorad, expand-banner<br/>Default value: false | true | `boolean` |
-| `closeTimeout` | optional | The duration in milliseconds before displaying the close button.<br/>Works with formats: screen-roll, intext-roll, sliderad, floorad<br/>Default value: 5000 | 2000 | `integer` |
-| `animated` | optional | Enable an animation on opening and on closing of the video.<br/>Works with formats: intext-roll, sliderad<br/>Default value: true | false | `boolean` |
-| `animationSpeed` | optional | If the animated parameter is set to true, allows to choose the animation speed in milliseconds.<br/>Works with formats: intext-roll, sliderad<br/>Default value: 700 | 500 | `integer` |
-| `contentId` | optional | Displays the ad inside the content-id dom element (dom id). Requires an 'auto', 'p' or 'article' param.<br/>Works with format: intext-roll | "element-id" | `string` |
-| `auto` | optional | If value is set to "v2", position the intext-roll automatically. If contentId is set, the auto positioning will find a position inside the 'contentId' dom element.<br/>If contentId is not set, the auto positionaing will search the best position to display the ad based on the page semantic. It will select several possible position and show the intext-roll at the time one of them is made visible.<br/>Works with format: intext-roll<br/>Default value: null | "v2" | `string` |
-| `article` | optional | Set the location of the ad just after the given article tag in the page (0 is for the first article tag). If content-id is set, the article index is relative to articles inside the 'content-id' dom element | "element-id"<br/>Works with format: intext-roll | `string` |
-| `p` | optional | Set the location of the ad just after the given paragraph tag in the page (0 is for the first p tag). If content-id is set, the p index is relative to paragraphs inside the 'content-id' dom element.<br/>Works with format: intext-roll | "element-id" | `string` |
-| `iframeMode` | optional | Indicate to intext-roll that it is served in a friendly hidden iframe. Can be one of the following:<br/>*normal - place ad in friendly iframe<br/>* dfp - place ad in iframe on dfp platform<br/>Works with format: intext-roll | "normal" | `string` |
-| `inRead` | optional | When true, will keep the ad slot window on the page when the ad is done.<br/>Works with format: intext-roll<br/>Default value: false | true | `boolean` |
-| `lang` | optional | Text language. Can be one of: [fr,en,es,it,de,nl,pt]<br/>Works with format: intext-roll<br/>Default value: "fr" | "en" | `string` |
-| `openingTime` | optional | The time in milliseconds to display the opening animation.<br/>Works with format: intext-roll<br/>Default value: 0 | 100 | `integer` |
-| `pauseRatio` | optional | Specify the viewabilityratio where the ad is paused. This can be a float between 0 and 1, or "never" which means never paused. The default value will pause when the ad has less than 50% viewability.<br/>Works with formats: intext-roll, expand-banner<br/>Default value: 0.5 | 0.9 | `float` \| `string` |
-| `closeAction` | optional | Define what to do for the banner after all ads complete. Can be one of:<br/>*collapse - will set the target css display property to "none".<br/>* hide - will leave the target element in place, empty.<br/>Works with formats: intext-roll, expand-banner<br/>Default value: “collapse” | "hide" | `string` |
-| `domId` | optional | id of the dom element containing the text. If this targeted div is empty, be sure it has the needed width or a width of 0px will be used. Note that the script tag should be added in the page AFTER the targeted dom element so the target will be ready when the script runs.<br/>Works with formats: intext-roll, expand-banner | "element-id" | `string` |
-| `errorAction` | optional | Define what to do for the banner after an ad error. Can be one of:<br/>*collapse - will set the target css display property to "none".<br/>* hide - will leave the target element in place, empty.<br/>Works with formats: intext-roll, expand-banner<br/>Default value: “collapse” | "hide" | `string` |
-| `stickToTop` | optional | Controls if the ad will stick to the top of the browser window. Can be one of the following:<br/>*true - The ad will stick to the top of the browser window upon scroll. <br/>* "bottom" - The ad will stick to the top and will be hidden again when reaching the bottom of the page.<br/>* number - The ad will stick to the top for the given distance in pixels.<br/>Works with formats: intext-roll, expand-banner | 300 | `boolean \| string \| number` |
-| `blurDisplay` | optional | Allow to choose between too blur effects for the sides of the banner. Can be one of:<br/>*big - will show the blured video only once in the background.<br/>* duplicate - will show the blured video twice: once for each side.<br/>Works with format: expand-banner<br/>Default value: "big" | "duplicate" | `string` |
-| `expandDirection` | optional | Allows to force the expansion direction. Can be one of the following:<br/>*before - Expand to the left if the banner is vertical and to the top if the banner is horizontal.<br/>* after - Expand to the right if the banner is vertical and to the bottom if the banner is horizontal.<br/>*center - Expand to left and right if the banner is vertical. Expand to the top and bottom if the banner is horizontal.<br/>* auto - Expand based on the space available on the page. Expand to the left and/or right if the banner is vertical. and expand to the top and bottom if the banner is horizontal, depending on the space available.<br/>* none - Banner will not expand<br/>Works with format: expand-banner<br/>Default value: "auto" | "before" | `string` |
-| `zIndex` | optional | Force the z-index value on the ad container. The default value is around 4100 (see IAB guidelines). Use this parameter if it doesn't fit your needs.<br/>Works with format: expand-banner<br/>Default value: ~4100 | 1000 | `integer` |
-| `hAlign` | optional | Horizontal side where to display the video. Can be one of:<br/>*left - horizontal align to the left of the page.<br/>* middle - horizontal align to the middle of the page.<br/>* right - horizontal align to the right of the page.<br/>Works with format: sliderad<br/>Default value: "right" | "left" | `string` |
-| `hSpacing` | optional | Set a horizontal spacing between the hAlign side and the video.<br/>Works with format: sliderad<br/>Default value: 10 | 20 | `integer` |
-| `vAlign` | optional | Vertical side where to display the video. Can be one of:<br/>*top - vertical align to the top of the page.<br/>* middle - vertical align to the middle of the page.<br/>* bottom - vertical align to the bottom of the page.<br/>Works with format: sliderad<br/>Default value: "bottom" | "top" | `string` |
-| `vSpacing` | optional | Set a vertical spacing between the vAlign side and the video.<br/>Works with format: sliderad<br/>Default value: 10 | 20 | `integer` |
-| `mod` | optional | Ad trigger mode. Can be one of:<br/>*asap - play the ad asap<br/>* click - play the ad when the user clicks a link<br/>* scroll - play the ad when the user scrolls<br/>Works with format: screen-roll<br/>Default value: "asap" | "click" | `string` |
-| `opacity` | optional | Define the opacity of the background. This is a number between 0 (completely transparent) and 1 (totally black).<br/>Works with format: screen-roll<br/>Default value: 0.4 | .5 | `float` |
-| `smartPlay` | optional | Enable to use autoPlay on mobile devices.<br/>Works with format: screen-roll<br/>Default value: false | true | `boolean` |
-| `bannerHeight` | optional | The height in pixel of the bottom banner. The video ad takes this height when its not expanded.<br/>Works with format: floorad<br/>Default value: 250 | 500 | `integer` |
diff --git a/dev-docs/bidders/stickyadstv.md b/dev-docs/bidders/stickyadstv.md
deleted file mode 100644
index ead5d3181c..0000000000
--- a/dev-docs/bidders/stickyadstv.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-layout: bidder
-title: StickyAdsTv
-description: Prebid StickyAdsTv Bidder Adaptor
-top_nav_section: dev_docs
-nav_section: reference
-pbjs: true
-biddercode: stickyadstv
-media_types: native
-sidebarType: 1
-
----

From c0f5d11ffc11f0174b3e4c8ace1dbab26c02a103 Mon Sep 17 00:00:00 2001
From: Guillaume Polaert <gpolaert@pubstack.io>
Date: Mon, 2 Mar 2026 16:36:10 +0100
Subject: [PATCH 492/665] Add Pubstack bidder documentation (#1) (#6438)

* Add Pubstack bidder documentation (#1)

* Add Pubstack bidder documentation page

* Enhance Pubstack bidder adapter documentation

Updated Pubstack bidder documentation with new fields and types.

* Update Pubstack bidder documentation with new fields

* Update dev-docs/bidders/pubstack.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/pubstack.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/pubstack.md | 81 ++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)
 create mode 100644 dev-docs/bidders/pubstack.md

diff --git a/dev-docs/bidders/pubstack.md b/dev-docs/bidders/pubstack.md
new file mode 100644
index 0000000000..a05a0f6d94
--- /dev/null
+++ b/dev-docs/bidders/pubstack.md
@@ -0,0 +1,81 @@
+---
+layout: bidder
+title: Pubstack
+description: Prebid Pubstack Bidder Adapter
+biddercode: pubstack
+prebid_member: true
+pbjs: true
+pbs: true
+gvl_id: 1408
+media_types: banner, video, native
+multiformat_supported: will-bid-on-any
+tcfeu_supported: true
+usp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+coppa_supported: true
+userId: all
+schain_supported: true
+dchain_supported: true
+fpd_supported: true
+floors_supported: true
+deals_supported: true
+safeframes_ok: true
+privacy_sandbox: paapi, topics
+ortb_blocking_supported: true
+sidebarType: 1
+---
+
+### Integration Note
+
+The Pubstack bidding adapter requires setup and approval before use. Contact your Pubstack account team to enable production traffic.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `siteId` | required | Pubstack site identifier. | `'example-site-id'` | `string \| uuid` |
+| `adUnitName` | required | Pubstack ad unit name associated with the placement. | `'homepage-top-banner'` | `string` |
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-div-1',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]]
+      }
+    },
+    bids: [
+      {
+        bidder: 'pubstack',
+        params: {
+          siteId: 'example-site-id',
+          adUnitName: 'homepage-top-banner'
+        }
+      }
+    ]
+  },
+  {
+    code: 'test-video-div',
+    mediaTypes: {
+      video: {
+        playerSize: [[640, 360]],
+        context: 'outstream'
+      }
+    },
+    bids: [
+      {
+        bidder: 'pubstack',
+        params: {
+          siteId: 'example-site-id',
+          adUnitName: 'article-video-slot'
+        }
+      }
+    ]
+  }
+];
+```

From cc751c8a97ddb2525fa5fd299be938172812cf54 Mon Sep 17 00:00:00 2001
From: adclusterdev <dev@adcluster.com.tr>
Date: Tue, 3 Mar 2026 08:47:38 +0300
Subject: [PATCH 493/665] adcluster - new adapter (#6304)

---
 dev-docs/bidders/adcluster.md | 70 +++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 dev-docs/bidders/adcluster.md

diff --git a/dev-docs/bidders/adcluster.md b/dev-docs/bidders/adcluster.md
new file mode 100644
index 0000000000..a1c4db577f
--- /dev/null
+++ b/dev-docs/bidders/adcluster.md
@@ -0,0 +1,70 @@
+---
+layout: bidder
+title: Adcluster
+description: Prebid Adcluster Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: adcluster
+media_types: banner, video
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+prebid_member: false
+safeframes_ok: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+### Description
+
+The Adcluster bidding adapter requires setup & approval before usage. Please reach out to <dev@adcluster.com.tr> for more information.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name     | Scope    | Description       | Example                                | Type     |
+| -------- | -------- | ----------------- | -------------------------------------- | -------- |
+| `unitId` | required | Adcluster Unit ID | `10f4f9f3-cc3f-4f20-982d-5cbba92adfdc` | `string` |
+
+### Example
+
+```javascript
+const adUnits = [
+  {
+    code: "adcluster-banner",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]],
+      },
+    },
+    bids: [
+      {
+        bidder: "adcluster",
+        params: {
+          unitId: "42d1f525-5792-47a6-846d-1825e53c97d6",
+        },
+      },
+    ],
+  },
+  {
+    code: "adcluster-video",
+    mediaTypes: {
+      video: {
+        playerSize: [[640, 480]],
+      },
+    },
+    bids: [
+      {
+        bidder: "adcluster",
+        params: {
+          unitId: "37dd91b2-049d-4027-94b9-d63760fc10d3",
+        },
+      },
+    ],
+  },
+];
+```

From 3a628e0ec08d62bc383e41fdc74932359441abbc Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Tue, 3 Mar 2026 19:42:29 +0100
Subject: [PATCH 494/665] Limelight new adapters (#6383)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* new adapters

* fix checks

* fix checks2

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/altstar.md      |  5 +++-
 dev-docs/bidders/anzuExchange.md |  5 +++-
 dev-docs/bidders/oveeo.md        | 40 ++++++++++++++++++++++++++++++++
 dev-docs/bidders/performist.md   |  2 +-
 dev-docs/bidders/rtbdemand.md    |  5 +++-
 dev-docs/bidders/smootai.md      |  5 +++-
 6 files changed, 57 insertions(+), 5 deletions(-)
 create mode 100644 dev-docs/bidders/oveeo.md

diff --git a/dev-docs/bidders/altstar.md b/dev-docs/bidders/altstar.md
index 4a637afc03..be6678505e 100644
--- a/dev-docs/bidders/altstar.md
+++ b/dev-docs/bidders/altstar.md
@@ -4,7 +4,7 @@ title: Altstar Media
 description: Prebid Altstar Media Bidder Adaptor
 biddercode: altstar
 pbjs: true
-pbs: false
+pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
@@ -35,3 +35,6 @@ sidebarType: 1
 | `custom3`     | optional | Custom targeting field 3                                 | `'custom3'`              | `string`  |
 | `custom4`     | optional | Custom targeting field 4                                 | `'custom4'`              | `string`  |
 | `custom5`     | optional | Custom targeting field 5                                 | `'custom5'`              | `string`  |
+
+Prebid Altstar Media Bidder Adaptor server-side Prebid Server adapter requires only `publisherId` and `host` parameters.
+Prebid Altstar Media Bidder Adaptor server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.
diff --git a/dev-docs/bidders/anzuExchange.md b/dev-docs/bidders/anzuExchange.md
index 9126a13afb..13ab51109c 100644
--- a/dev-docs/bidders/anzuExchange.md
+++ b/dev-docs/bidders/anzuExchange.md
@@ -4,7 +4,7 @@ title: Anzu Exchange
 description: Prebid Anzu Exchange Bidder Adaptor
 biddercode: anzuExchange
 pbjs: true
-pbs: false
+pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
@@ -35,3 +35,6 @@ sidebarType: 1
 | `custom3`     | optional | Custom targeting field 3                                  | `'custom3'`            | `string`  |
 | `custom4`     | optional | Custom targeting field 4                                  | `'custom4'`            | `string`  |
 | `custom5`     | optional | Custom targeting field 5                                  | `'custom5'`            | `string`  |
+
+Prebid Anzu Exchange Bidder Adaptor server-side Prebid Server adapter requires only `publisherId` and `host` parameters.
+Prebid Anzu Exchange Bidder Adaptor server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.
diff --git a/dev-docs/bidders/oveeo.md b/dev-docs/bidders/oveeo.md
new file mode 100644
index 0000000000..f1bdf89b15
--- /dev/null
+++ b/dev-docs/bidders/oveeo.md
@@ -0,0 +1,40 @@
+---
+layout: bidder
+title: Oveeo
+description: Prebid Oveeo Bidder Adaptor
+biddercode: oveeo
+pbjs: true
+pbs: true
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                             | Example             | Type      |
+|:--------------|:---------|:----------------------------------------|:--------------------|:----------|
+| `adUnitId`    | required | Ad Unit Id will be generated on Oveeo.  | `42`                | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`) | `'banner'`          | `string`  |
+| `publisherId` | required | Publisher ID                            | `'12345'`           | `string`  |
+| `custom1`     | optional | Custom targeting field 1                | `'custom1'`         | `string`  |
+| `custom2`     | optional | Custom targeting field 2                | `'custom2'`         | `string`  |
+| `custom3`     | optional | Custom targeting field 3                | `'custom3'`         | `string`  |
+| `custom4`     | optional | Custom targeting field 4                | `'custom4'`         | `string`  |
+| `custom5`     | optional | Custom targeting field 5                | `'custom5'`         | `string`  |
+
+Oveeo server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Oveeo client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Oveeo server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Oveeo client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.
diff --git a/dev-docs/bidders/performist.md b/dev-docs/bidders/performist.md
index c15d752b1c..37c273e029 100644
--- a/dev-docs/bidders/performist.md
+++ b/dev-docs/bidders/performist.md
@@ -3,7 +3,7 @@ layout: bidder
 title: Performist
 description: Prebid Performist Bidder Adaptor
 biddercode: performist
-pbjs: false
+pbjs: true
 pbs: true
 media_types: video, banner
 userIds: all
diff --git a/dev-docs/bidders/rtbdemand.md b/dev-docs/bidders/rtbdemand.md
index e49f4fc50f..fe0784b7a8 100644
--- a/dev-docs/bidders/rtbdemand.md
+++ b/dev-docs/bidders/rtbdemand.md
@@ -4,7 +4,7 @@ title: Rtb Demand
 description: Prebid Rtb Demand Bidder Adaptor
 biddercode: rtbdemand
 pbjs: true
-pbs: false
+pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
@@ -35,3 +35,6 @@ sidebarType: 1
 | `custom3`     | optional | Custom targeting field 3                               | `'custom3'`             | `string`  |
 | `custom4`     | optional | Custom targeting field 4                               | `'custom4'`             | `string`  |
 | `custom5`     | optional | Custom targeting field 5                               | `'custom5'`             | `string`  |
+
+Prebid Rtb Demand Bidder Adaptor server-side Prebid Server adapter requires only `publisherId` and `host` parameters.
+Prebid Rtb Demand Bidder Adaptor server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.
diff --git a/dev-docs/bidders/smootai.md b/dev-docs/bidders/smootai.md
index e16a60e4d9..3b98a0a167 100644
--- a/dev-docs/bidders/smootai.md
+++ b/dev-docs/bidders/smootai.md
@@ -4,7 +4,7 @@ title: SmootAI
 description: SmootAI Bidder Adaptor
 biddercode: smootai
 pbjs: true
-pbs: false
+pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
@@ -35,3 +35,6 @@ sidebarType: 1
 | `custom3`     | optional | Custom targeting field 3                                      | `'custom3'`         | `string`  |
 | `custom4`     | optional | Custom targeting field 4                                      | `'custom4'`         | `string`  |
 | `custom5`     | optional | Custom targeting field 5                                      | `'custom5'`         | `string`  |
+
+SmootAI Bidder Adaptor server-side Prebid Server adapter requires only `publisherId` and `host` parameters.
+SmootAI Bidder Adaptor server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.

From 00064150561bab675a176dd719452540b0fd0114 Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Wed, 4 Mar 2026 16:07:56 +0200
Subject: [PATCH 495/665] Update docs (#6251)

* adding pbs option to adapted docs: programmaticX: https://github.com/prebid/prebid-server/pull/4456; tagoras: https://github.com/prebid/prebid-server/pull/4329;

* adding pbs option to adapted docs: opamarketplace: https://github.com/prebid/prebid-server/pull/4526

* making back the pbs true in programmatix adapter
---
 dev-docs/bidders/opamarketplace.md | 2 +-
 dev-docs/bidders/programmaticX.md  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/opamarketplace.md b/dev-docs/bidders/opamarketplace.md
index ae83a56adc..afecafc5de 100644
--- a/dev-docs/bidders/opamarketplace.md
+++ b/dev-docs/bidders/opamarketplace.md
@@ -20,7 +20,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
 ---
 
diff --git a/dev-docs/bidders/programmaticX.md b/dev-docs/bidders/programmaticX.md
index 8b702d1519..43147c95e4 100644
--- a/dev-docs/bidders/programmaticX.md
+++ b/dev-docs/bidders/programmaticX.md
@@ -20,7 +20,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
 gvl_id: 1344
 ---

From 51f6ebd31611782008b231f3e43d2195e95e653b Mon Sep 17 00:00:00 2001
From: Pavel Ptashyts <49400901+pavel-ptashyts@users.noreply.github.com>
Date: Wed, 4 Mar 2026 16:29:28 +0100
Subject: [PATCH 496/665] New Adapter: ElementalTv: (#6374)

* Update Adoppler/ElementaTv:

1)Adoppler adapter now has new name ElementalTv
2)Left support adoppler adapter name

* Update Adoppler/ElementaTv:

* Update Adoppler/ElementaTv:

* Update Adoppler/ElementaTv:

* Update Adoppler/ElementaTv:

* Update Adoppler/ElementaTv:

* Update Adoppler/ElementaTv

* Update Adoppler/ElementaTv

Added gpp_sids
---
 dev-docs/bidders/adoppler.md    | 24 +++++++++++++-------
 dev-docs/bidders/elementaltv.md | 40 +++++++++++++++++++++++++++++++++
 2 files changed, 56 insertions(+), 8 deletions(-)
 create mode 100644 dev-docs/bidders/elementaltv.md

diff --git a/dev-docs/bidders/adoppler.md b/dev-docs/bidders/adoppler.md
index 9a3e39ad5e..e6e1f3fd54 100644
--- a/dev-docs/bidders/adoppler.md
+++ b/dev-docs/bidders/adoppler.md
@@ -1,16 +1,24 @@
 ---
 layout: bidder
 title: Adoppler
-pbs: true
-media_types: video
+description: This bidder has been renamed to ElementalTV.
 biddercode: adoppler
+pbs: true
+pbjs: false
 sidebarType: 1
 ---
 
-### Bid Params
+### Deprecated
+
+The **Adoppler** bidder has been renamed to **ElementalTV**.
+
+Please use the **ElementalTV** bidder documentation and biddercode going forward:
+
+- **Docs:** `/dev-docs/bidders/elementaltv.html`
+- **Bidder code:** `elementaltv`
+
+### Notes
 
-{: .table .table-bordered .table-striped }
-| Name       | Scope    | Description            | Example | Type     |
-|------------|----------|------------------------|---------|----------|
-| adunit | required | AdUnit to bid against | 'test' | string |
-| client | optional | Client name | 'ads' | string |
+- `adoppler` is maintained as an alias for backward compatibility.
+- New integrations should use `elementaltv`.
+ 
\ No newline at end of file
diff --git a/dev-docs/bidders/elementaltv.md b/dev-docs/bidders/elementaltv.md
new file mode 100644
index 0000000000..e123d71b92
--- /dev/null
+++ b/dev-docs/bidders/elementaltv.md
@@ -0,0 +1,40 @@
+---
+layout: bidder
+title: ElementalTV
+description: Prebid ElementalTV Bidder Adapter
+biddercode: elementaltv
+pbs: true
+pbjs: false
+media_types: banner, video, native
+pbs_app_supported: true
+schain_supported: true
+coppa_supported: true
+deals_supported: true
+usp_supported: true
+gpp_supported: true
+gpp_sids: usnat, usstate_all, usp
+dsa_supported: false
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+### Registration
+
+The ElementalTV bidder adapter requires prior setup. Please contact us at <support@elementaltv.com>.
+
+### OpenRTB Version
+
+References to the OpenRTB specification in this document assume **OpenRTB 2.6**.
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name    | Scope    | Description                                  | Example      | Type     |
+|---------|----------|----------------------------------------------|--------------|----------|
+| `adunit`| required | Ad Unit ID or Supply Source reference to bid against | `'test'` or `'SSP:12345'` | `string` |
+
+### Notes
+
+- `adunit` can reference either:
+  - an **Ad Unit ID** (pass the ID as-is), or
+  - a **Supply Source reference** using the prefix format `SSP:<supply_source_id>` (e.g., `SSP:12345`).

From 6171fff56245951819350b235d1ff7b11a785206 Mon Sep 17 00:00:00 2001
From: v0idxyz <58184010+v0idxyz@users.noreply.github.com>
Date: Thu, 5 Mar 2026 17:02:00 +0100
Subject: [PATCH 497/665] Add Revantage Bidder Adapter documentation (#6414)

* Add Revantage Bidder Adapter documentation

Added documentation for the Revantage Bidder Adapter, including registration, bid parameters, configuration for banner and video ads, user syncing, privacy support, and price floors.

* Remove notes about bid requests and sync URLs

Removed notes section detailing bid requests and notifications.

* Update dev-docs/bidders/revantage.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/revantage.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Change tcfeu_supported to false for Revantage

* Update Revantage documentation with code examples

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/revantage.md | 257 ++++++++++++++++++++++++++++++++++
 1 file changed, 257 insertions(+)
 create mode 100644 dev-docs/bidders/revantage.md

diff --git a/dev-docs/bidders/revantage.md b/dev-docs/bidders/revantage.md
new file mode 100644
index 0000000000..3067a476ac
--- /dev/null
+++ b/dev-docs/bidders/revantage.md
@@ -0,0 +1,257 @@
+---
+layout: bidder
+title: Revantage
+description: Prebid Revantage Bidder Adapter
+biddercode: revantage
+tcfeu_supported: false
+gvl_id: none
+usp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+coppa_supported: false
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sideload_disabled: false
+---
+
+### Registration
+
+To use the Revantage adapter, you need to register for an account and obtain a Feed ID. Please contact [adops@revantage.io](mailto:adops@revantage.io) to get started.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                   | Example              | Type     |
+|---------------|----------|-----------------------------------------------|----------------------|----------|
+| `feedId`      | required | Unique identifier for your feed configuration | `'abc123xyz'`        | `string` |
+
+### Banner Configuration
+
+Revantage supports standard banner ad units. The adapter will automatically use the sizes defined in your ad unit configuration.
+
+```javascript
+var adUnits = [
+  {
+    code: 'banner-div',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250], [300, 600], [728, 90]]
+      }
+    },
+    bids: [
+      {
+        bidder: 'revantage',
+        params: {
+          feedId: 'your-feed-id'
+        }
+      }
+    ]
+  }
+];
+```
+
+### Video Configuration
+
+Revantage supports instream and outstream video. The following video parameters are supported:
+
+{: .table .table-bordered .table-striped }
+| Name             | Scope       | Description                                      | Example                  | Type            |
+|------------------|-------------|--------------------------------------------------|--------------------------|-----------------|
+| `playerSize`     | required    | Video player dimensions                          | `[[640, 480]]`           | `array`         |
+| `mimes`          | recommended | Supported video MIME types                       | `['video/mp4']`          | `array<string>` |
+| `protocols`      | recommended | Supported VAST protocols                         | `[2, 3, 5, 6]`           | `array<int>`    |
+| `api`            | optional    | Supported API frameworks                         | `[1, 2]`                 | `array<int>`    |
+| `placement`      | optional    | Video placement type (1=instream, 2=outstream)   | `1`                      | `int`           |
+| `minduration`    | optional    | Minimum video duration in seconds                | `5`                      | `int`           |
+| `maxduration`    | optional    | Maximum video duration in seconds                | `30`                     | `int`           |
+| `skip`           | optional    | Whether video is skippable (0=no, 1=yes)         | `1`                      | `int`           |
+| `skipmin`        | optional    | Minimum duration before skip is allowed          | `5`                      | `int`           |
+| `skipafter`      | optional    | Seconds until skip button appears                | `5`                      | `int`           |
+| `startdelay`     | optional    | Start delay (0=pre-roll, -1=mid-roll, -2=post)   | `0`                      | `int`           |
+| `playbackmethod` | optional    | Playback methods                                 | `[1, 2]`                 | `array<int>`    |
+| `linearity`      | optional    | Linearity (1=linear, 2=non-linear)               | `1`                      | `int`           |
+
+#### Video Example
+
+```javascript
+var adUnits = [
+  {
+    code: 'video-div',
+    mediaTypes: {
+      video: {
+        playerSize: [[640, 480]],
+        context: 'instream',
+        mimes: ['video/mp4', 'video/webm'],
+        protocols: [2, 3, 5, 6],
+        api: [1, 2],
+        placement: 1,
+        minduration: 5,
+        maxduration: 30,
+        skip: 1,
+        skipmin: 5,
+        skipafter: 5
+      }
+    },
+    bids: [
+      {
+        bidder: 'revantage',
+        params: {
+          feedId: 'your-feed-id'
+        }
+      }
+    ]
+  }
+];
+```
+
+### User Syncing
+
+Revantage supports both iframe and pixel-based user syncing. Enable user syncing in your Prebid.js configuration:
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      iframe: {
+        bidders: ['revantage'],
+        filter: 'include'
+      },
+      image: {
+        bidders: ['revantage'],
+        filter: 'include'
+      }
+    },
+    syncsPerBidder: 1,
+    syncDelay: 3000
+  }
+});
+```
+
+### Privacy Support
+
+Revantage fully supports the following privacy frameworks:
+
+- **GDPR (TCF 2.0)**: The adapter reads consent data from the `gdprConsent` object and passes it to the bidding endpoint.
+- **US Privacy (CCPA)**: The adapter reads the USP consent string and includes it in bid requests.
+- **GPP**: Global Privacy Platform consent strings and applicable sections are supported.
+
+### First Party Data
+
+Revantage supports First Party Data via the standard `ortb2` configuration:
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      name: 'Example Site',
+      domain: 'example.com',
+      cat: ['IAB1'],
+      content: {
+        language: 'en'
+      }
+    },
+    user: {
+      data: [
+        {
+          name: 'example.com',
+          ext: {
+            segtax: 600
+          },
+          segment: [
+            { id: '1' },
+            { id: '2' }
+          ]
+        }
+      ]
+    }
+  }
+});
+```
+
+### Price Floors
+
+Revantage supports the [Prebid.js Price Floors Module](/dev-docs/modules/floors.html). Configure floors as usual and the adapter will include floor data in bid requests.
+
+```javascript
+pbjs.setConfig({
+  floors: {
+    enforcement: {
+      floorDeals: true
+    },
+    data: {
+      currency: 'USD',
+      schema: {
+        fields: ['mediaType', 'size']
+      },
+      values: {
+        'banner|300x250': 0.50,
+        'banner|728x90': 0.75,
+        'video|640x480': 2.00
+      }
+    }
+  }
+});
+```
+
+### Supply Chain (schain)
+
+Revantage passes supply chain information to demand partners. Configure schain in your Prebid.js setup:
+
+```javascript
+pbjs.setConfig({
+  schain: {
+    validation: 'relaxed',
+    config: {
+      ver: '1.0',
+      complete: 1,
+      nodes: [
+        {
+          asi: 'yoursite.com',
+          sid: 'your-seller-id',
+          hp: 1
+        }
+      ]
+    }
+  }
+});
+```
+
+### User ID Modules
+
+Revantage supports all Prebid.js User ID modules. User IDs are automatically passed in the bid request when available.
+
+### Test Parameters
+
+Use these parameters to test the Revantage adapter:
+
+```javascript
+var adUnits = [
+  {
+    code: 'test-banner',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]]
+      }
+    },
+    bids: [
+      {
+        bidder: 'revantage',
+        params: {
+          feedId: 'test-feed-123'
+        }
+      }
+    ]
+  }
+];
+```

From 9fad4bfce2055b150acda0ede758d945b6aaeb07 Mon Sep 17 00:00:00 2001
From: bhasker-ddh <159261864+bhasker-ddh@users.noreply.github.com>
Date: Thu, 5 Mar 2026 22:15:15 +0530
Subject: [PATCH 498/665] Update colossus docs (#6252)

* Updated docs Colossusssp Adapter

* Update colossusssp.md

Add media types

* Update colossusssp.md

add usp consent support

* adding schain flag

* gdpr and user ids

* id5id support

* Prebid server info

* Remove PBS params

* Add colossus PBS docs

* Add short note for pbs adapter parametres

* Add note for pbjs parametres

* Fix

* remove duplicate string

* Update colossusssp.md

Ad biddflorr parameter

* add uid2

* fix

* fix

* add group_id

* add groupId

* docs(colossus): minor fixes to adapter docs

---------

Co-authored-by: Vladislav Isaiko <vladis@smartyads.com>
Co-authored-by: Bill Newman <huddled.masses1650@gmail.com>
Co-authored-by: bretg <bgorsline@gmail.com>
Co-authored-by: Aiholkin <artem.iholkin@smartyads.com>
---
 dev-docs/bidders/colossusssp.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/colossusssp.md b/dev-docs/bidders/colossusssp.md
index 57d78f1ab9..7ab4ad0c4f 100644
--- a/dev-docs/bidders/colossusssp.md
+++ b/dev-docs/bidders/colossusssp.md
@@ -6,11 +6,14 @@ biddercode: colossusssp
 usp_supported: true
 schain_supported: true
 media_types: banner, video, native
-userIds: britepoolid, identityLink, unifiedId, id5Id, uid2
+userIds: all
 gdpr: true
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
+coppa_supported: true
+floors_supported: true
+
 ---
 
 ### Prebid.JS Bid Params

From 7606d8caec8617d486c357ac8b66c3083d85844e Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Sun, 8 Mar 2026 11:28:51 -0700
Subject: [PATCH 499/665] JS add accessRequestCredentials activity control
 (#6466)

---
 dev-docs/activity-controls.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/activity-controls.md b/dev-docs/activity-controls.md
index 488254fda9..31b8bfe013 100644
--- a/dev-docs/activity-controls.md
+++ b/dev-docs/activity-controls.md
@@ -111,6 +111,7 @@ Here's the list of the 'potentially restricted activities' that Prebid.js core c
 | Name           | Description | Effect when denied | Additional parameters |
 |----------------|-------------|---------------------------|--------------------------------|
 | `accessDevice` | A component wants to use device storage  | Storage is disabled | [`storageType`](#params-accessDevice) |
+| `accessRequestCredentials` | A component wants to [include credentials](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#including_credentials) (notably, cookies) in a request. Available since version 10. | Credentials are excluded | None |  
 | `enrichEids` | A user ID or RTD submodule wants to add user IDs to outgoing requests | User IDs are discarded | None |
 | `enrichUfpd` | A Real-Time Data (RTD) submodule wants to add user first-party data to outgoing requests (`user.data` in ORTB) | User FPD is discarded | None |
 | `fetchBids`  | A bid adapter wants to participate in an auction | Bidder is removed from the auction | [`configName`](#params-fetchBids) |

From 02e32ead49325d4c6dd73dc6c75e4834fa5865ba Mon Sep 17 00:00:00 2001
From: Brett Oberg <bjoberg@amazon.com>
Date: Wed, 11 Mar 2026 12:11:01 -0500
Subject: [PATCH 500/665] APS Bid Adapter v2.1.0 Documentation (#6473)

Updated documentation for APS Bid Adapter v2.1.0
---
 dev-docs/aps.md | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/dev-docs/aps.md b/dev-docs/aps.md
index d9ed601f49..f2ce7e7983 100644
--- a/dev-docs/aps.md
+++ b/dev-docs/aps.md
@@ -25,14 +25,25 @@ sidebarType: 1
 
 {: .table .table-bordered .table-striped }
 
-| Name               | Scope    | Description                              | Example                           | Type      |
-| ------------------ | -------- | ---------------------------------------- | --------------------------------- | --------- |
-| `aps.accountID`    | required | APS-provided ID                          | `1234`                            | `string`  |
-| `aps.debugURL`     | optional | Bid endpoint                             | `https://example.com/bid`         | `string`  |
-| `aps.debug`        | optional | Toggle to enable / disable debug mode    | `true`                            | `boolean` |
-| `aps.renderMethod` | optional | Debug mode render method                 | `fif`                             | `string`  |
-| `aps.creativeURL`  | optional | Creative rendering URL                   | `https://example.com/creative.js` | `string`  |
-| `aps.telemetry`    | optional | Toggle to enable / disable APS telemetry | `true`                            | `boolean` |
+| Name                      | Scope    | Description                              | Example                           | Type      |
+| ------------------------- | -------- | ---------------------------------------- | --------------------------------- | --------- |
+| `aps.accountID`           | required | APS-provided ID                          | `1234`                            | `string`  |
+| `aps.debugURL`            | optional | Bid endpoint                             | `https://example.com/bid`         | `string`  |
+| `aps.debug`               | optional | Toggle to enable / disable debug mode    | `true`                            | `boolean` |
+| `aps.renderMethod`        | optional | Debug mode render method                 | `fif`                             | `string`  |
+| `aps.creativeURL`         | optional | Creative rendering URL                   | `https://example.com/creative.js` | `string`  |
+| `aps.telemetry`           | optional | Toggle to enable / disable APS telemetry | `true`                            | `boolean` |
+| `ortb2.regs.ext.agerange` | optional | US Age Law Compliance Value              | `3` (refer to the table below)    | `number`  |
+
+#### Agerange Values
+
+| Legally Defined Age Category | Simplified Category | Enumerated Value |
+| ---------------------------- | ------------------- | ---------------- |
+| Child (Under 13)             | Child               | 1                |
+| Young Teenager (13-15)       | Teen                | 2                |
+| Older Teenager (16-17)       | Teen                | 2                |
+| Adult (18+)                  | Adult               | 3                |
+| Unknown                      | Unknown             | 0                |
 
 ### Bid Params
 

From cc033b818368c572221212a60a2dd0cc3e332840 Mon Sep 17 00:00:00 2001
From: rishko00 <43280707+rishko00@users.noreply.github.com>
Date: Fri, 13 Mar 2026 00:44:17 +0200
Subject: [PATCH 501/665] aceexBidAdapter/docs (#6399)

Co-authored-by: vrishko <vasyl.rishko@smartyads.com>
---
 dev-docs/bidders/aceex.md | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/dev-docs/bidders/aceex.md b/dev-docs/bidders/aceex.md
index 68968333f1..a8044d8ba6 100644
--- a/dev-docs/bidders/aceex.md
+++ b/dev-docs/bidders/aceex.md
@@ -1,28 +1,32 @@
 ---
 layout: bidder
 title: Aceex
-description: Prebid Aceex Bidder Adaptor
+description: Prebid Aceex Bidder Adapter
 biddercode: aceex
+gvl_id: 1387
 tcfeu_supported: false
 usp_supported: true
 coppa_supported: true
 schain_supported: true
-userId: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 media_types: banner, video, native
 safeframes_ok: true
-deals_supported: true
-pbjs: false
+deals_supported: false
+pbjs: true
 pbs: true
+multiformat_supported: will-bid-on-one
 sidebarType: 1
 ---
 
 ### Note
 
-The Example Bidding adapter requires setup before beginning. Please contact us at <tech@aceex.com>
+The Example Bidding adapter requires setup before beginning. Please contact us at <tech@aceex.io>
 
-### Bid Params
+### Aceex Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description           | Example   | Type      |
 |---------------|----------|-----------------------|-----------|-----------|
-| `accountid`      | required | Endpoint id | `'hash'`    | `string` |
+| `bidfloor`    | required | General bids floor price                | `0.2`      | `number` |
+| `internalKey` | required | Internal hash of publisher | `'1nn3p089Fs87m21'` | `string` |
+| `publisherId` | required | Publisher ID               | `'2308'`   | `string` |
+| `trafficType` | required | Configures the mediaType that should be used. Values can be `'banner'`, `'native'` or `'video'` | `'banner'` | `string`|

From 208d42227649c2a5b693462344ef83a7345a2606 Mon Sep 17 00:00:00 2001
From: floxis-tech <andrius.nvilnia@gmail.com>
Date: Fri, 13 Mar 2026 15:01:01 +0200
Subject: [PATCH 502/665] Floxis Bid Adapter: initial release (#6267)

* Floxis Bid Adapter : initial release

* Improved documentation

* Simplified documentation
---
 dev-docs/bidders/floxis.md | 163 +++++++++++++++++++++++++++++++++++++
 1 file changed, 163 insertions(+)
 create mode 100644 dev-docs/bidders/floxis.md

diff --git a/dev-docs/bidders/floxis.md b/dev-docs/bidders/floxis.md
new file mode 100644
index 0000000000..e8c7b1f75b
--- /dev/null
+++ b/dev-docs/bidders/floxis.md
@@ -0,0 +1,163 @@
+---
+layout: bidder
+title: Floxis
+description: Prebid Floxis Bidder Adapter
+biddercode: floxis
+pbjs: true
+pbs: false
+media_types: banner, video, native
+safeframes_ok: true
+sidebarType: 1
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: none
+usp_supported: true
+coppa_supported: true
+gpp_supported: true
+schain_supported: true
+dchain_supported: false
+deals_supported: false
+floors_supported: yes
+fpd_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Note
+
+The Floxis bidder adapter enables integration with the Floxis programmatic advertising platform via Prebid.js. It supports banner, video, and native formats with OpenRTB 2.x compliance. Please contact Floxis to set up your partner account and obtain the required parameters.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+|------|-------|-------------|---------|------|
+| `seat` | required | Seat identifier provided by Floxis | `"testSeat"` | `string` |
+| `region` | required | Region identifier for routing | `"us-e"` | `string` |
+| `partner` | required | Partner identifier provided by Floxis | `"floxis"` | `string` |
+
+### Floors Support
+
+The Floxis adapter supports the Prebid.js [Floors Module](https://docs.prebid.org/dev-docs/modules/floors.html). Floor values are automatically included in the OpenRTB request as `imp.bidfloor` and `imp.bidfloorcur`.
+
+### Privacy Support
+
+Privacy fields (GDPR, USP, GPP, COPPA) are handled by Prebid.js core and automatically included in the OpenRTB request.
+
+### AdUnit Configuration for Banner
+
+```javascript
+var adUnits = [{
+    code: 'banner-ad-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250], [728, 90]]
+        }
+    },
+    bids: [{
+        bidder: 'floxis',
+        params: {
+            seat: 'testSeat',
+            region: 'us-e',
+            partner: 'floxis'
+        }
+    }]
+}];
+```
+
+### AdUnit Configuration for Video
+
+```javascript
+var adUnits = [{
+    code: 'video-ad-div',
+    mediaTypes: {
+        video: {
+            context: 'instream',
+            playerSize: [[640, 480]],
+            mimes: ['video/mp4'],
+            protocols: [2, 3, 5, 6],
+            minduration: 5,
+            maxduration: 30
+        }
+    },
+    bids: [{
+        bidder: 'floxis',
+        params: {
+            seat: 'testSeat',
+            region: 'us-e',
+            partner: 'floxis'
+        }
+    }]
+}];
+```
+
+### AdUnit Configuration for Native
+
+```javascript
+var adUnits = [{
+    code: 'native-ad-div',
+    mediaTypes: {
+        native: {
+            title: {
+                required: true,
+                len: 80
+            },
+            body: {
+                required: true
+            },
+            image: {
+                required: true,
+                sizes: [150, 50]
+            },
+            sponsoredBy: {
+                required: true
+            }
+        }
+    },
+    bids: [{
+        bidder: 'floxis',
+        params: {
+            seat: 'testSeat',
+            region: 'us-e',
+            partner: 'floxis'
+        }
+    }]
+}];
+```
+
+### Example
+
+```javascript
+var pbjs = pbjs || {};
+pbjs.que = pbjs.que || [];
+
+pbjs.que.push(function() {
+    pbjs.addAdUnits([{
+        code: 'div-gpt-ad-1234567890123-0',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [320, 50]]
+            }
+        },
+        bids: [{
+            bidder: 'floxis',
+            params: {
+                seat: 'testSeat',
+                region: 'us-e',
+                partner: 'floxis'
+            }
+        }]
+    }]);
+
+    pbjs.requestBids({
+        timeout: 3000,
+        bidsBackHandler: function(bidResponses) {
+            // Handle bid responses
+            pbjs.setTargetingForGPTAsync();
+        }
+    });
+});
+```

From f8f618a0b6c8ad58dfb6a8bd19f8c9ca912ef0b6 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 13 Mar 2026 06:18:58 -0700
Subject: [PATCH 503/665] prebid 11.0 release notes (#6482)

* prebid 11.0 release notes

* lint

* updates

* lint

* removal notes

* adapter summary

* grammar

* Update freeWheelAdserverVideo description

* fix .md into .html

Updated links in documentation for bidViewability and customMatchFunction to use the correct file extension.

* fix customGptSlotMatching name

* Add links to Prebid.js release notes

---------

Co-authored-by: Patrick McCann <patmmccann@gmail.com>
---
 dev-docs/modules/bidViewable.md               |  12 +-
 dev-docs/modules/bidViewableIO.md             |   4 +-
 dev-docs/modules/gpt-pre-auction.md           |   2 +-
 dev-docs/pb11-notes.md                        | 137 ++++++++++++++++++
 dev-docs/publisher-api-reference/getEvents.md |   8 +-
 dev-docs/publisher-api-reference/setConfig.md |  18 +++
 .../setTargetingForGPTAsync.md                |   2 +-
 dev-docs/release-notes.md                     |   1 +
 8 files changed, 168 insertions(+), 16 deletions(-)
 create mode 100644 dev-docs/pb11-notes.md

diff --git a/dev-docs/modules/bidViewable.md b/dev-docs/modules/bidViewable.md
index 78fcb4285c..ee6782afa3 100644
--- a/dev-docs/modules/bidViewable.md
+++ b/dev-docs/modules/bidViewable.md
@@ -2,7 +2,7 @@
 layout: page_v2
 page_type: module
 title: Module - Bid Viewability - GAM
-description: Triggers a BID_VIEWABLE event when a rendered bid is viewable according to Active View criteria
+description: Triggers a 'bidViewable' event when a rendered bid is viewable according to Active View criteria
 module_code : bidViewability
 display_name : Bid Viewability - GAM
 enable_download : true
@@ -18,7 +18,7 @@ sidebarType : 1
 
 ## Overview
 
-This optional module will trigger a BID_VIEWABLE event which can be consumed by Analytics adapters. In addition, the winning bidder can implement an `onBidViewable` method to capture this event.
+This optional module will trigger a `bidViewable` event which can be consumed by Analytics adapters. In addition, the winning bidder can implement an `onBidViewable` method to capture this event.
 
 Notes:
 
@@ -48,7 +48,7 @@ The default logic used to find a matching Prebid.js bid for a GPT slot is
 | `bidViewability` | Required | Object | Configuration object |
 | `bidViewability.enabled` | Required | Boolean | when set to true, the module will emit BID_VIEWABLE when applicable. Default: `false` |
 | `bidViewability.firePixels` | Optional | Boolean | when set to true, will fire the urls mentioned in `bid.vurls` which should be array of URLs. Default: `false` |
-| `bidViewability.customMatchFunction` | Optional | function(bid, slot) | this function will be used to find the matching winning bid for the GPT slot. See above for the default. |
+| `bidViewability.customMatchFunction` | Optional | function(bid, slot) | REMOVED in 11.0; use [customGptSlotMatching](/dev-docs/publisher-api-reference/setConfig.html#customGptSlotMatching) instead. This function will be used to find the matching winning bid for the GPT slot. See above for the default. |
 
 ## Example of setting module config
 
@@ -56,11 +56,7 @@ The default logic used to find a matching Prebid.js bid for a GPT slot is
     pbjs.setConfig({
         bidViewability: {
             enabled: true,
-            firePixels: true,
-            customMatchFunction: function(bid, slot){
-                console.log('using custom match function....');
-                return bid.adUnitCode === slot.getAdUnitPath();
-            }
+            firePixels: true
         }
     });
 ```
diff --git a/dev-docs/modules/bidViewableIO.md b/dev-docs/modules/bidViewableIO.md
index 0d7ecc1ea7..2fbf445662 100644
--- a/dev-docs/modules/bidViewableIO.md
+++ b/dev-docs/modules/bidViewableIO.md
@@ -2,7 +2,7 @@
 layout: page_v2
 page_type: module
 title: Module - Bid Viewability - Ad Server Independent
-description: Triggers a BID_VIEWABLE event when a rendered bid is viewable according to an approximation of IAB viewability criteria
+description: Triggers a `bidViewable` event when a rendered bid is viewable according to an approximation of IAB viewability criteria
 module_code : bidViewabilityIO
 display_name : Bid Viewability - Ad Server Independent
 enable_download : true
@@ -17,7 +17,7 @@ sidebarType : 1
 
 ## Overview
 
-This optional module will trigger a BID_VIEWABLE event which can be consumed by Analytics adapters. In addition, the winning bidder can implement an `onBidViewable` method to capture this event.
+This optional module will trigger a `bidViewable` event which can be consumed by Analytics adapters. In addition, the winning bidder can implement an `onBidViewable` method to capture this event.
 
 Notes:
 
diff --git a/dev-docs/modules/gpt-pre-auction.md b/dev-docs/modules/gpt-pre-auction.md
index cab3e3489b..e7eb1e4991 100644
--- a/dev-docs/modules/gpt-pre-auction.md
+++ b/dev-docs/modules/gpt-pre-auction.md
@@ -49,7 +49,7 @@ Optional initialization parameters:
 {: .table .table-bordered .table-striped }
 | Param | Required? | Type | Description | Example |
 | enabled | no | boolean | allows turning off of module. Default value is true | true |
-| customGptSlotMatching | no | function | GPT slot matching function should match the customSlotMatching function sent to [setTargetingForGptAsync](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html) | |
+| customGptSlotMatching | no | function | REMOVED in 11.0; use [customGptSlotMatching](/dev-docs/publisher-api-reference/setConfig.html#customGptSlotMatching) instead. GPT slot matching function should match the customSlotMatching function sent to [setTargetingForGptAsync](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html) | |
 | useDefaultPreAuction | no | boolean | (PBJS 6.5+) If true, use default behavior for determining GPID and PbAdSlot. Defaults to false. | true |
 | customPreAuction | no | function | (PBJS 6.5+) Custom function for defining the GPID and PbAdSlot. | |
 | customPbAdSlot | no | function | Custom PB AdSlot function. (Note, this function will be deprecated in the future.) | |
diff --git a/dev-docs/pb11-notes.md b/dev-docs/pb11-notes.md
new file mode 100644
index 0000000000..ddd26ee0b2
--- /dev/null
+++ b/dev-docs/pb11-notes.md
@@ -0,0 +1,137 @@
+---
+layout: page_v2
+title: Prebid.js 11.0 Release Notes & Publisher API Changes
+description: Description of the breaking changes included for Prebid.js 11.0
+sidebarType: 1
+---
+
+# Prebid.js 11.0 Adapter Interface and Publisher API Changes
+
+{:.no_toc}
+
+This document describes the changes included for Prebid.js version 11.0.
+
+* TOC
+  {:toc}
+
+## Publisher Summary
+
+1. A number of obsolete modules have been removed (see list below).
+2. Adpod is no longer supported.
+3. PAAPI is no longer supported.
+4. The `addAdUnits`, `bidAccepted`, and `seatNonBid` events have been removed.
+5. Bids whose `mediaType` does not match their request's `mediaTypes` are now rejected as invalid.
+6. The `storageControl` module now defaults to strict enforcement.
+7. [setTargetingForGPTAsync](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html) no longer takes a `customSlotMatching` argument; the configuration options `bidViewability.customMatchFunction` and `gptPreAuction.customGptSlotMatching` have been removed. The replacement is a single new configuration option `customGptSlotMatching`. 
+8. The way viewability is calculated and signaled has been overhauled.
+
+## Adapter summary
+
+1. A new utility function, `getAdUnitElement`, should be used to link an ad unit / bid request / bid response to its DOM element.
+2. DNT (`navigator.doNotTrack`) is no longer supported. The `getDNT()` utility function now always returns `false`.
+3. Typescript is now preferred over Javascript. New modules should provide types for their public interface. 
+
+<a id="removed-modules"></a>
+
+## Removed Modules
+
+The following modules have been removed from Prebid.js as part of the 11.0 release:
+
+{: .table .table-bordered .table-striped }
+
+| Module                          | Notes                          |
+|:--------------------------------|:-------------------------------|
+| `adpod`                         |                                |
+| `categoryTranslation`           | Adpod submodule                |
+| `dfpAdServerVideo`              | Use `gamAdServerVideo` instead |
+| `dfpAdpod`                      | Adpod submodule                |
+| `dmdIdSystem`                   |                                |
+| `express`                       |                                |
+| `freeWheelAdserverVideo`        | Adpod submodule                |
+| `gamAdpod`                      | Adpod submodule                |
+| `intersectionRtdProvider`       |                                |
+| `optableBidAdapter`             | No longer useful without PAAPI |
+| `paapi`                         |                                |
+| `paapiForGpt`                   |                                | 
+| `topLevelPaapi`                 |                                |
+| `quantcastBidAdapter`           |                                | 
+| `quantcastIdSystem`             |                                |
+| `ringieraxelspringerBidAdapter` |                                | 
+
+## Removed events
+
+The following events have been removed and will no longer trigger callbacks registered with [pbjs.onEvent](/dev-docs/publisher-api-reference/onEvent.html):
+
+* `addAdUnits`: this event carried no information besides the fact that `pbjs.addAdUnits` was called. `auctionInit` and `beforeRequestBids` contain the ad units involved in each auction.           
+* `bidAccepted`: use `bidResponse` instead.
+* `seatNonBid`: use `pbsAnalytics` instead.
+
+## Stricter mediaType enforcement
+
+Bids that declare a `mediaType` not present in their ad unit's `mediaTypes` are now rejected as invalid. This validation can be turned off by setting `auctionOptions.rejectInvalidMediaTypes` to `false`.
+
+Bids that do not declare any `mediaType` are assumed to be `'banner'`; you may require an explicit mediaType with `auctionOptions.rejectUnknownMediaTypes`. If enabled, bids that do not set `mediaType` will also be rejected as invalid. For example:
+
+```javascript
+pbjs.setConfig({
+  auctionOptions: {
+    rejectInvalidMediaTypes: false, // allow bids on the wrong format
+    rejectUnknownMediaTypes: true   // disallow bids that do not declare their format
+  }
+})
+```
+
+## Strict storageControl enforcement
+
+The [storageControl](/dev-docs/modules/storageControl.html) module now defaults to strict enforcement; including it will cause undisclosed storage use to fail instead of just logging a warning. You may revert to warning only with
+
+```javascript
+pbjs.setConfig({
+  storageControl: {
+    enforcement: 'off'
+  }
+})
+```
+
+## `customGptSlotMatching`
+
+A new configuration option `customGptSlotMatching` is replacing the following:
+
+* the second argument of [setTargetingForGPTAsync](/dev-docs/publisher-api-reference/setTargetingForGPTAsync.html);
+* the `customGptSlotMatching` configuration option of [gptPreAuction](/dev-docs/modules/gpt-pre-auction.html);
+* the `customMatchFunction` configuration option of [bidViewability](/dev-docs/modules/bidViewable.html).
+
+<a id="viewability-overhaul"><a>
+
+## Viewability overhaul
+
+A number of changes were aimed at standardizing two related problems: viewability of an ad unit at the time an auction starts; and viewability of an ad that was rendered on the page.
+
+### `adUnit.element` and `getAdUnitElement`
+
+Many adapters attempt to calculate the position of an ad unit on the page so that they can include that information in their bid request. To facilitate this, 11.0 adds a new `element` configuration option for ad units that can be used to specify the page element it corresponds to. For example:
+
+```javascript
+pbjs.requestBids({
+  adUnits: [{
+    code: 'myAdUnit',
+    element: document.querySelector('#ad-container')
+    // ...
+  }]
+})
+```
+
+Adapters can retrieve the element using the `getAdUnitElement` utility function. If `element` is not specified for an ad unit it defaults to `document.getElementById(adUnit.code)`.
+
+### Viewability after rendering
+
+To determine viewability of an ad rendered on the page, publishers can choose one of two optional modules:
+
+* [`bidViewability`](/dev-docs/modules/bidViewable.html) only works with GPT ad units, and relies on its `impressionViewable` events;
+* [`bidViewabilityIO`](/dev-docs/modules/bidViewableIO.html) approximates the same viewability criteria (IAB's MRC 50%) using [`IntersectionObserver`](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
+ 
+When a bid is deemed viewable, both modules now:
+
+* fire a `bidViewable` event
+* run the relevant adapter's `onBidViewable` method
+* trigger "viewable-mrc50" (`event: 2`) event trackers in the bid's `eventtracker` array.
diff --git a/dev-docs/publisher-api-reference/getEvents.md b/dev-docs/publisher-api-reference/getEvents.md
index 6462ad9eb1..a374315d74 100644
--- a/dev-docs/publisher-api-reference/getEvents.md
+++ b/dev-docs/publisher-api-reference/getEvents.md
@@ -30,23 +30,23 @@ The available events are:
 | beforeRequestBids | Bids are about to be requested from adapters (added in 3.x) | Array of adunits in the auction |
 | beforeBidderHttp | bidder network request is about be triggered | Array of Bid request objects |
 | bidRequested  | A bid was requested from a specific bidder | Bid request object |
-| bidResponse   | A bid response has arrived              | Bid response object |
+| bidResponse   | A bid response has been added to an auction             | Bid response object |
 | pbsAnalytics    | Prebid Server has returned extra information for analytics adapters. | { [seatnonbid](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#seat-non-bid), auctionId, [atag](/prebid-server/developers/module-atags.html) } |
-| seatNonBid    | DEPRECATED - use pbsAnalytics instead. Prebid Server has returned nonbid information. Must be enabled in s2sConfig.extPrebid | None |
+| seatNonBid    | Removed in 11.0 - use `pbsAnalytics` instead. Prebid Server has returned nonbid information. Must be enabled in s2sConfig.extPrebid | None |
 | bidRejected   | A bid was rejected                      | Bid response object |
 | bidAdjustment | A bid was adjusted                      | Bid response object |
 | bidWon        | A bid has won                           | Bid response object |
 | bidTimeout    | A bid timed out                         | Array of objects with timed out bids |
 | setTargeting  | Targeting has been set                  | Hash of targeting values |
 | requestBids   | Bids have been requested from adapters (i.e. pbjs.requestBids() was called) | The argument passed to [`requestBids`](https://docs.prebid.org/dev-docs/publisher-api-reference/requestBids.html), except that `adUnits` and `adUnitCodes` are always set and reflect the ad units involved in the auction. Event handlers may not modify `adUnitCodes`. |
-| addAdUnits    | Ad units have been added to the auction | None |
+| addAdUnits    | Removed in 11.0 - use `auctionInit` instead. Ad units have been added to the auction. Removed in 11.0. | None |
 | adRenderFailed| Ad rendering failed | Object containing 'reason' and 'message' |
 | adRenderSucceeded | Ad rendering succeeded| Object containing 'doc', 'bid', and 'adId'. 'doc' is the DOM root containing the ad and may be `null` if it was rendered in a cross-origin iframe. This event indicates that the render function did not generate an error, it does not guarantee that tracking for this event has occurred yet.|
 | auctionDebug  | An error was logged to the console | Object containing 'type' and 'arguments' |
 | bidderDone    | A bidder has signaled they are done responding | Bid request object |
 | bidderError    | A bidder responded with an error | Object with the XMLHttpRequest error and the bid request object `{ error, bidderRequest }` |
 | tcf2Enforcement | There was a TCF2 enforcement action taken | `{ storageBlocked: ['moduleA', 'moduleB'], biddersBlocked: ['moduleB'], analyticsBlocked: ['moduleC'] }` |
-| bidAccepted | A bid was accepted and is about to be added to auction | Bid response object |
+| bidAccepted | Removed in 11.0 - use `bidResponse` instead. A bid was accepted and is about to be added to auction | Bid response object |
 | browserIntervention | The browser reported an intervention affecting a rendered creative (e.g., heavy-ad unload). | `{ bid, adId, intervention }` |
 
 The example below shows how these events can be used.
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 801b453c6b..9198fc6979 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1317,6 +1317,24 @@ pbjs.setConfig({
 {: .alert.alert-warning :}
 In PBJS 4.29 and earlier, don't add the `ortb2` level here -- just `site` directly. Oh, and please upgrade. 4.29 was a long time ago.
 
+<a id="customGptSlotMatching"></a>
+
+### Custom GPT slot matching
+
+By default, Prebid matches ad units to GPT slots by code, i.e. a GPT `slot` corresponds to a Prebid `adUnit` if `slot.getAdUnitPath() === adUnit.code`. You can provide a custom matching function to override this, for example:
+
+```javascript
+pbjs.setConfig({
+  customGptSlotMatching: function(slot) {
+    return function(adUnitCode) {
+      return slot.getAdUnitPath() === adUnitCode
+    }
+  }
+})
+```
+
+`customGptSlotMatching` should be a function accepting a single GPT [Slot](https://developers.google.com/publisher-tag/reference#googletag.Slot). It should return another function accepting a single string representing an ad unit code. The inner function should return true if the givne slot matches the given ad unit code. 
+
 <a name="setConfig-auctionOptions"></a>
 
 ### Auction Options
diff --git a/dev-docs/publisher-api-reference/setTargetingForGPTAsync.md b/dev-docs/publisher-api-reference/setTargetingForGPTAsync.md
index 16d682dfe3..e5c1c8822a 100644
--- a/dev-docs/publisher-api-reference/setTargetingForGPTAsync.md
+++ b/dev-docs/publisher-api-reference/setTargetingForGPTAsync.md
@@ -14,7 +14,7 @@ Set query string targeting on GPT ad units after the auction.
 | Param | Scope | Type | Description |
 | --- | --- | --- | -- |
 | [codeArr] | Optional | `array` | an array of adUnitCodes to set targeting for. |
-| customSlotMatching | Optional | `function` | gets a GoogleTag slot and returns a filter function for adUnitCode. |
+| customSlotMatching | Optional | `function` | REMOVED in 11.0; use [customGptSlotMatching](/dev-docs/publisher-api-reference/setConfig.html#customGptSlotMatching) instead. Gets a GoogleTag slot and returns a filter function for adUnitCode. |
 
 This function matches AdUnits that have returned from the auction to a GPT ad slot and adds the `hb_`
 targeting attributes to the slot so they get sent to GAM.
diff --git a/dev-docs/release-notes.md b/dev-docs/release-notes.md
index 19e49c530f..e100083c1f 100644
--- a/dev-docs/release-notes.md
+++ b/dev-docs/release-notes.md
@@ -15,6 +15,7 @@ This page has links to release notes for each of the projects associated with Pr
 ## Prebid.js
 
 + [Release notes on GitHub](https://github.com/prebid/Prebid.js/releases)
++ [Prebid.js 11 Release Notes](/dev-docs/pb11-notes.html)
 + [Prebid.js 10 Release Notes](/dev-docs/pb10-notes.html)
 + [Prebid.js 9 Release Notes](/dev-docs/pb9-notes.html)
 + [Prebid.js 8 Release Notes](/dev-docs/pb8-notes.html)

From b8e4db03027b37866c6fec4fb9d13038af486ffc Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 13 Mar 2026 06:19:24 -0700
Subject: [PATCH 504/665] Prebid 11: document adUnit.element (#6481)

---
 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 df0e002046..2e3845022b 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -43,6 +43,7 @@ See the table below for the list of properties on the ad unit. For example ad un
 | `video` | Optional | Object | Used to link an Ad Unit to the [Video Module][videoModule]. For allowed params see the [adUnit.video reference](#adunitvideo). |
 | `deferBilling` | Optional | Boolean | Used by a publisher to flag adUnits as being separately billable. This allows for a publisher to trigger billing manually for winning bids. See [pbjs.triggerBilling](/dev-docs/publisher-api-reference/triggerBilling.html) and [onBidBillable](/dev-docs/bidder-adaptor.html#registering-on-bid-billable) for more info. |
 | `bidLimit` | Optional | Number | Used by a publisher to set a bid limit for this ad unit |
+| `element`  | Optional | HTMLElement | A DOM element corresponding to this ad unit, used for viewability measurements. Defaults to `document.getElementById(code)` |    
 
 <a name="adUnit.bids"></a>
 

From af9de18962d961e77d06a59c2a55681aedd3d7dc Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Fri, 13 Mar 2026 10:10:55 -0400
Subject: [PATCH 505/665] prebid 11 Update setConfig.md with new configuration
 options (#6478)

* Update setConfig.md with new configuration options

* Fix formatting of rejectInvalidMediaTypes description
---
 dev-docs/publisher-api-reference/setConfig.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 9198fc6979..798ca37aec 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1346,8 +1346,10 @@ The `auctionOptions` object controls aspects related to auctions.
 |----------+---------+--------+---------------------------------------------------------------------------------------|
 | `secondaryBidders` | Optional | Array of Strings | Specifies bidders that the Prebid auction will no longer wait for before determining the auction has completed. This may be helpful if you find there are a number of low performing and/or high timeout bidders in your page's rotation. |
 | `suppressStaleRender` | Optional | Boolean | When true, prevents `banner` bids from being rendered more than once. It should only be enabled after auto-refreshing is implemented correctly.  Default is false. |
-| `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false.
+| `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false. |
 | `legacyRender`     | Optional  | Boolean | When true, uses "legacy" rendering logic  (see [note](#note-legacyRender))                               |
+| `rejectUnknownMediaTypes` | Optional | Boolean | Since Pbjs 11, When true, reject bids when the adapter response omits `mediaType` for an ad unit that has explicit `mediaTypes` configured. Default is false. |
+| `rejectInvalidMediaTypes` | Optional | Boolean | Since Pbjs 11, When true, reject bids when response `mediaType` does not match one of the ad unit's configured `mediaTypes`. Default is true. |
 
 #### Examples
 {: .no_toc}

From 3dacbc45399915899322e7d7fb16bdee5b29147d Mon Sep 17 00:00:00 2001
From: Robert Ray Martinez III <rmartinez@magnite.com>
Date: Mon, 16 Mar 2026 11:50:48 -0700
Subject: [PATCH 506/665] New Adapter: Magnite Bid Adapter (#6436)

* magnite adapter

* add migration details

* lint
---
 dev-docs/bidders/magnite.md | 264 ++++++++++++++++++++++++++++++++++++
 1 file changed, 264 insertions(+)
 create mode 100644 dev-docs/bidders/magnite.md

diff --git a/dev-docs/bidders/magnite.md b/dev-docs/bidders/magnite.md
new file mode 100644
index 0000000000..2ab8ae168c
--- /dev/null
+++ b/dev-docs/bidders/magnite.md
@@ -0,0 +1,264 @@
+---
+layout: bidder
+title: Magnite
+description: Prebid Magnite Bidder Adapter
+biddercode: magnite
+tcfeu_supported: true
+dsa_supported: true
+gpp_sids: tcfeu, usnat, usstate_all, usp
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+floors_supported: true
+media_types: banner, video, native
+userIds: all
+prebid_member: true
+safeframes_ok: true
+deals_supported: true
+pbjs: true
+pbs: false
+fpd_supported: true
+ortb_blocking_supported: true
+gvl_id: 52
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+### Registration
+
+The Magnite adapter requires setup and approval from the Magnite team, even for existing accounts. Please reach out to your account manager or <header-bidding@magnite.com> for more information.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|------|-------|-------------|---------|------|
+| `accountId` | required | The publisher account ID | `14062` | `integer` |
+| `siteId` | required | A unique ID for your site | `70608` | `integer` |
+| `zoneId` | required | A unique ID for your site's ad placements | `498816` | `integer` |
+
+#### First Party Data
+
+Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported:
+
+- ortb2.site.ext.data.*
+- ortb2.site.keywords
+- ortb2.site.content.data[]
+- ortb2.user.ext.data.*
+- ortb2.user.data[]
+
+The Magnite exchange supports IAB standard taxonomies for contextual and audience segments.
+
+Example first party data available to all bidders and all ad units:
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      keywords: "kw1,kw2",
+      ext: {
+        data: {
+          prodtype: ["tech","mobile"]
+        }
+      }
+    },
+    user: {
+      ext: {
+        data: {
+          ucat: ["new"]
+        }
+      }
+    }
+  }
+});
+```
+
+Example of first party data available only to the Magnite bidder across all ad units:
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ["magnite"],
+  config: {
+    ortb2: {
+      site: {
+        keywords: "kw1,kw2",
+        ext: {
+          data: {
+            prodtype: ["tech","mobile"]
+          }
+        }
+      },
+      user: {
+        ext: {
+          data: {
+            ucat: ["new"]
+          }
+        }
+      }
+    }
+  }
+});
+```
+
+### Media Types
+
+#### Banner
+
+Banner ads are supported with standard IAB sizes.
+
+```javascript
+var bannerAdUnit = {
+    code: 'test-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250], [728, 90]]
+        }
+    },
+    bids: [{
+        bidder: 'magnite',
+        params: {
+            accountId: 14062,
+            siteId: 70608,
+            zoneId: 498816
+        }
+    }]
+};
+```
+
+#### Video
+
+The Magnite adapter supports standard OpenRTB video parameters for both instream and outstream contexts.
+
+```javascript
+var videoAdUnit = {
+    code: 'myVideoAdUnit',
+    mediaTypes: {
+        video: {
+            context: 'instream',
+            playerSize: [640, 480],
+            mimes: ['video/mp4', 'video/x-ms-wmv'],
+            protocols: [2, 5],
+            maxduration: 30,
+            linearity: 1,
+            api: [2]
+        }
+    },
+    bids: [{
+        bidder: 'magnite',
+        params: {
+            accountId: 14062,
+            siteId: 70608,
+            zoneId: 498816
+        }
+    }]
+};
+```
+
+Outstream video is also supported. We recommend discussing video demand with your Magnite account representative.
+
+#### Native
+
+The Magnite adapter supports native ads using the ORTB Native spec. We recommend version 1.2, but versions 1.0 and 1.1 are also supported.
+
+{: .table .table-bordered .table-striped }
+| Native Version | Required Fields |
+|---|---|
+| 1.0 and 1.1 | layout, adunit, assets |
+| 1.2 | context, plcmttype, assets, eventtrackers. privacy is a recommended field. |
+
+Here's an example using ORTB Native 1.2:
+
+```javascript
+var nativeAdUnit = {
+    code: 'myNativeAdUnit',
+    mediaTypes: {
+        native: {
+            ortb: {
+                ver: "1.2",
+                context: 2,
+                plcmttype: 11,
+                privacy: 1,
+                assets: [{
+                    id: 1,
+                    required: 1,
+                    img: {
+                        type: 3,
+                        w: 150,
+                        h: 50
+                    }
+                }],
+                eventtrackers: [{
+                    event: 1,
+                    methods: [1, 2]
+                }]
+            }
+        }
+    },
+    bids: [{
+        bidder: 'magnite',
+        params: {
+            accountId: 14062,
+            siteId: 70608,
+            zoneId: 498816
+        }
+    }]
+};
+```
+
+### Configuration
+
+#### User Sync
+
+Add the following code to enable user syncing. By default, Prebid.js turns off user syncing through iframes. Magnite recommends enabling iframe-based user syncing to improve match rates and bid performance.
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        iframeEnabled: true
+    }
+});
+```
+
+### Migration from Rubicon
+
+The Magnite adapter (`bidder: "magnite"`) is designed as the next-generation replacement for the Rubicon adapter (`bidder: "rubicon"`). It uses a modern OpenRTB integration that is simpler and easier to maintain.
+
+Key points for migrating:
+
+- The bid params (`accountId`, `siteId`, `zoneId`) remain the same.
+- The adapter accepts configuration from both `magnite` and `rubicon` config namespaces during the transition.
+- Update `bidder: "rubicon"` to `bidder: "magnite"` in your ad unit configurations.
+
+#### Preserving Existing GAM Line Items
+
+If you are migrating from the Rubicon adapter and your Google Ad Manager (GAM) line items rely on bidder-specific key-value targeting (e.g., `hb_bidder=rubicon` or `hb_pb_rubicon`), you can avoid updating your ad server setup by aliasing the Magnite adapter as `rubicon`. This causes bids from the Magnite adapter to be reported under the `rubicon` bidder code, preserving compatibility with your existing line items.
+
+```javascript
+pbjs.aliasBidder('magnite', 'rubicon');
+```
+
+Then use the alias in your ad unit configuration:
+
+```javascript
+var adUnit = {
+    code: 'test-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250]]
+        }
+    },
+    bids: [{
+        bidder: 'rubicon',
+        params: {
+            accountId: 14062,
+            siteId: 70608,
+            zoneId: 498816
+        }
+    }]
+};
+```
+
+With this approach, Prebid.js will use the Magnite adapter under the hood but send targeting keys as `hb_bidder=rubicon`, `hb_pb_rubicon`, etc., so your existing GAM line items continue to work without changes.
+
+{: .alert.alert-info :}
+The `rubicon` alias is **not** included as a default alias of the Magnite adapter by design. This allows publishers to include both the Magnite and Rubicon adapters in the same Prebid.js build for A/B testing during migration. However, for production use after migration, the recommended approach is to build Prebid.js with only the Magnite adapter (without the Rubicon adapter) and use `pbjs.aliasBidder('magnite', 'rubicon')` as shown above. This avoids potential conflicts between the two adapters.

From 81cfeb05a98e6cc2b201d612c6511a14fd887907 Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Tue, 17 Mar 2026 22:35:26 +0200
Subject: [PATCH 507/665] Added Bid Adapter MyCodeMedia (#6362)

* mycodemedia/prebid.github.io

* MyCodeMedia Adapter: disable pbs and pbs_app_supported

---------

Co-authored-by: MyCodeMedia <support-platform@mycodemedia.com>
Co-authored-by: mc-pacobernal <119521439+mc-pacobernal@users.noreply.github.com>
---
 dev-docs/bidders/mycodemedia.md | 35 +++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/mycodemedia.md

diff --git a/dev-docs/bidders/mycodemedia.md b/dev-docs/bidders/mycodemedia.md
new file mode 100644
index 0000000000..6ee7156e87
--- /dev/null
+++ b/dev-docs/bidders/mycodemedia.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: MyCodeMedia
+description: Prebid MyCodeMedia Bidder Adapter
+biddercode: mycodemedia
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 57dc3877fce02d6058a21feeffd27f0e163bb0b6 Mon Sep 17 00:00:00 2001
From: ronishefi <168074830+ronishefi9@users.noreply.github.com>
Date: Wed, 18 Mar 2026 00:20:19 +0200
Subject: [PATCH 508/665] added native to supported media types in the taboola
 adapter (#6483)

---
 dev-docs/bidders/taboola.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md
index cf763dc00f..7d0eb996d0 100644
--- a/dev-docs/bidders/taboola.md
+++ b/dev-docs/bidders/taboola.md
@@ -11,7 +11,7 @@ coppa_supported: true
 gpp_supported: true
 schain_supported: false
 dchain_supported: true
-media_types: banner
+media_types: banner, native
 gvl_id: 42
 prebid_member: true
 floors_supported: true
@@ -27,8 +27,7 @@ sidebarType: 1
 
 ### Note
 
-- Prebid.js Supports `display` format only.
-- Prebid Server Supports `native+display` formats.
+- Both Prebid.js and Prebid Server Support `native+display` formats.
 - Uses `OpenRTB` standard.
 
 ### Bidder Config

From 7335391cdb2eb402c884d922ae8609bf055ed96f Mon Sep 17 00:00:00 2001
From: BlastoSupport <support@blasto.ai>
Date: Wed, 18 Mar 2026 00:21:34 +0200
Subject: [PATCH 509/665] Update blasto.md (#6485)

---
 dev-docs/bidders/blasto.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/blasto.md b/dev-docs/bidders/blasto.md
index cda556c3a6..f52465b87c 100644
--- a/dev-docs/bidders/blasto.md
+++ b/dev-docs/bidders/blasto.md
@@ -3,7 +3,7 @@ layout: bidder
 title: Blasto
 description: Prebid Blasto Bidder Adaptor
 biddercode: blasto
-tcfeu_supported: false
+tcfeu_supported: true
 usp_supported: true
 coppa_supported: true
 schain_supported: true
@@ -17,10 +17,12 @@ sidebarType: 1
 floors_supported: true
 prebid_member: false
 fpd_supported: false
-gvl_id: none
+gvl_id: 1381
 multiformat_supported: will-bid-on-one
 ortb_blocking_supported: true
 userIds: all
+gpp_supported: true
+endpoint_compression: false
 ---
 
 ### Note

From fcc6813db9039d93e0f22c7108a83ed2a7e94973 Mon Sep 17 00:00:00 2001
From: Dave Nicolson <david.nicolson@gmail.com>
Date: Tue, 17 Mar 2026 23:25:51 +0100
Subject: [PATCH 510/665] Update link to AnalyticsAdapter.ts (#6477)

---
 dev-docs/integrate-with-the-prebid-analytics-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/integrate-with-the-prebid-analytics-api.md b/dev-docs/integrate-with-the-prebid-analytics-api.md
index 8ffd290317..36a21b318c 100644
--- a/dev-docs/integrate-with-the-prebid-analytics-api.md
+++ b/dev-docs/integrate-with-the-prebid-analytics-api.md
@@ -99,7 +99,7 @@ Analytics adapter for Example.com. Contact prebid@example.com for information.
 
 2. Create an analytics adapter to listen for [Prebid events](/dev-docs/publisher-api-reference/onEvent.html) and call the analytics library or server. See the existing *AnalyticsAdapter.js files in the repo under [modules](https://github.com/prebid/Prebid.js/tree/master/modules).
 
-3. There are two types of analytics adapters. The example here focuses on the 'endpoint' type. See [AnalyticsAdapter.js](https://github.com/prebid/Prebid.js/blob/master/libraries/analyticsAdapter/AnalyticsAdapter.js) for more info on the 'bundle' type.
+3. There are two types of analytics adapters. The example here focuses on the 'endpoint' type. See [AnalyticsAdapter.ts](https://github.com/prebid/Prebid.js/blob/master/libraries/analyticsAdapter/AnalyticsAdapter.ts) for more info on the 'bundle' type.
 
     1. endpoint - Calls the specified URL on analytics events. Doesn't require a global context.
     2. bundle - An advanced option expecting a global context.

From 8a1639d547cc6ea326def1ed2ef7670ef422c63d Mon Sep 17 00:00:00 2001
From: giathinhly <96400885+giathinhly@users.noreply.github.com>
Date: Wed, 18 Mar 2026 05:46:00 +0700
Subject: [PATCH 511/665] MediaEyes Bid Adapter: update support video type
 (#6471)

* MediaEyes Bid Adapter: initial release

* MediaEyes Bid Adapter: update support video type
---
 dev-docs/bidders/mediaeyes.md | 48 +++++++++++++++++++++++++----------
 1 file changed, 34 insertions(+), 14 deletions(-)

diff --git a/dev-docs/bidders/mediaeyes.md b/dev-docs/bidders/mediaeyes.md
index db910e83a6..adec3b4ca6 100644
--- a/dev-docs/bidders/mediaeyes.md
+++ b/dev-docs/bidders/mediaeyes.md
@@ -6,7 +6,7 @@ pbjs: true
 pbs: false
 gvl_id: none
 biddercode: mediaeyes
-media_types: banner
+media_types: video,banner
 gdpr_supported: false
 usp_supported: false
 coppa_supported: false
@@ -38,18 +38,38 @@ MediaEyes adapter prebid connect to MediaEyes Bidding System.
 300x250 banner test
 
 ```javascript
-var adUnits = [{
-  code: 'zone-ads',
-  mediaTypes: {
-    banner: {
-      sizes: [[300, 250]]
-    }
+var adUnits = [
+  // Banner
+  {
+    code: 'zone-ads',
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250]]
+      }
+    },
+    bids: [{
+      bidder: 'mediaeyes',
+      params : {
+        itemId : "4d27f3cc8bbd5bd153045e"
+      }
+    }]
   },
-  bids: [{
-    bidder: 'mediaeyes',
-    params : {
-      itemId : "4d27f3cc8bbd5bd153045e"
-    }
-  }]
-}];
+  // Video
+  {
+      code: 'video-instream',
+      sizes: [[640, 480]],
+      mediaTypes: {
+        video: {
+          playerSize: [[640, 480]],
+          context: 'instream'
+        },
+      },
+      bids: [{
+        bidder: 'mediaeyes',
+        params : {
+          itemId : "4d27f3cc8bbd5bd153045e"
+        }
+      }]
+   },
+];
 ```

From 56b55bde04a313410eed791b15357b4d60a57921 Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Tue, 17 Mar 2026 23:52:57 +0100
Subject: [PATCH 512/665] Limelight: enable pbjs embimedia (#6468)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* pbjs bidder embimedia

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/embimedia.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/embimedia.md b/dev-docs/bidders/embimedia.md
index 59ae7a0225..be3fd3dd02 100644
--- a/dev-docs/bidders/embimedia.md
+++ b/dev-docs/bidders/embimedia.md
@@ -3,7 +3,7 @@ layout: bidder
 title: Embi Media
 description: Prebid Embi Media Bidder Adaptor
 biddercode: embimedia
-pbjs: false
+pbjs: true
 pbs: true
 media_types: banner, video, audio, native
 userIds: all

From bb1a905f4b2effe1e8152f916763c2a456928cf2 Mon Sep 17 00:00:00 2001
From: dmytro-po <dmytro.po@intentiq.com>
Date: Wed, 18 Mar 2026 01:09:35 +0200
Subject: [PATCH 513/665] Intent IQ: Fix additional parameters doc (#6462)

* fix spelling

* AGT-705: abPercentage parameter (#16)

* add group parameters

* remove extra line

* add more params to analytical adapter

* AGT-790: Fix documentation (#19)

* update documentation

* refactoring

* add id sample

---------

Co-authored-by: DimaIntentIQ <dmytro.piskun@intentiq.com>
Co-authored-by: DimaIntentIQ <139111483+DimaIntentIQ@users.noreply.github.com>
---
 dev-docs/analytics/intentiq.md                 | 12 ++++++------
 dev-docs/modules/userid-submodules/intentiq.md |  6 +++---
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index 32e2b03c24..d535f578ad 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -35,9 +35,9 @@ No registration for this module is required.
 | options.browserBlackList        | Optional | String   | This is the name of a browser that can be added to a blacklist.| `"chrome"`|
 | options.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.| `"currentDomain.com"`|
 | options. additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
-| options. additionalParams[0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
-| options. additionalParams[0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
-| options. additionalParams[0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
+| options. additionalParams[0].parameterName | Optional | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
+| options. additionalParams[0].parameterValue | Optional | String / Number | Value to assign to the parameter. | `123` |
+| options. additionalParams[0].destination | Optional | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
 
 #### Example Configuration
 
@@ -95,12 +95,12 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
 ```
 
 {: .table .table-bordered .table-striped }
-| Field              | Data Type | Description                                                                                                                                      | Example                       | Mandatory |
+| Field | Data Type | Description | Example | Mandatory |
 |--------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|-----------|
 | biddingPlatformId   | Integer   | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1                             | Yes       |
 | partnerAuctionId    | String    | Use this when you are running multiple auction solutions across your assets and have a unified identifier for auctions                            | 3d44542d-xx-4662-xxxx-4xxxx3d8e | No        |
 | bidderCode          | String    | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms                                       | newAppnexus                   | Yes       |
-| prebidAuctionId     | String    | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform                                   |                               |         |
+| prebidAuctionId | String | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform | 3513ce01-de02-490b-9d87-bfc137697f82 | No |
 | cpm                 | Decimal   | Cost per mille of the impression as received from the demand-side auction (without modifications or reductions)                                   | 5.62                          | Yes       |
 | currency            | String    | Currency of the auction                                                                                                                          | USD                           | Yes       |
 | originalCpm         | Decimal   | Leave empty or undefined if Prebid is not the bidding platform                                                                                    | 5.5                           | No        |
@@ -114,5 +114,5 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
 To report the auction win, call the function as follows:
 
 ```js
-window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData)
+window.intentIqAnalyticsAdapter_[partner_id].reportExternalWin(reportData);
 ```
diff --git a/dev-docs/modules/userid-submodules/intentiq.md b/dev-docs/modules/userid-submodules/intentiq.md
index 9f13c60ff3..76125ed109 100644
--- a/dev-docs/modules/userid-submodules/intentiq.md
+++ b/dev-docs/modules/userid-submodules/intentiq.md
@@ -60,9 +60,9 @@ Please find below list of parameters that could be used in configuring Intent IQ
 | params.group | Optional | String | Define group provided by partner, possible values: `"A"`, `"B"` | `"A"` |
 | params.region  | Optional | String | Optional region identifier used to automatically build server endpoints. When specified, region-specific endpoints will be used. (`gdpr`,`emea`, `apac`) | `"gdpr"` |
 | params.additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
-| params.additionalParams [0].parameterName | Required | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
-| params.additionalParams [0].parameterValue | Required | String / Number | Value to assign to the parameter. | `123` |
-| params.additionalParams [0].destination | Required | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
+| params.additionalParams [0].parameterName | Optional | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
+| params.additionalParams [0].parameterValue | Optional | String / Number | Value to assign to the parameter. | `123` |
+| params.additionalParams [0].destination | Optional | Array | Array of numbers either `1` or `0`. Controls where this parameter is sent `[sendWithSync, sendWithVr, winreport]`. | `[1, 0, 0]` |
 
 ### Configuration example
 

From 3533bac7759857ffd04c30516fb5192e75a941bd Mon Sep 17 00:00:00 2001
From: Matt Fitzgerald <matthewfitz@gmail.com>
Date: Wed, 18 Mar 2026 01:49:49 -0500
Subject: [PATCH 514/665] Deprecate dmd userid provider (#6459)

Co-authored-by: mfitzgerald_dmd <mfitzgerald@dmdconnects.com>
---
 dev-docs/modules/userid-submodules/dmd.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/dev-docs/modules/userid-submodules/dmd.md b/dev-docs/modules/userid-submodules/dmd.md
index 95b86aea3f..cc4be158e4 100644
--- a/dev-docs/modules/userid-submodules/dmd.md
+++ b/dev-docs/modules/userid-submodules/dmd.md
@@ -6,8 +6,14 @@ useridmodule: dmdIdSystem
 bidRequestUserId: dmdId
 eidsource: hcn.health
 example: '"1111"'
+enable_download: false
 ---
 
+# NOTE: DMD HAS BEEN DEPRECATED
+
+# THIS MODULE NO LONGER FUNCTIONS AND WILL BE REMOVED FROM A
+
+# FUTURE VERSION OF PREBID
 
 DMD is the preeminent supplier of US-based healthcare professional (HCP) identity data to the pharmaceutical, health system and medical publishing industries. DMD is the only data provider that has acquired its deterministic identity data through a fully consented, first-party, opt-in process. DMD’s privacy policy that can be found at [Privacy Policy](https://hcn.health/privacy-policy).
 

From 09d55fe114e2690c8d94e6899956d13f83ba596e Mon Sep 17 00:00:00 2001
From: dalmenarDevST <116064809+dalmenarDevST@users.noreply.github.com>
Date: Wed, 18 Mar 2026 07:50:31 +0100
Subject: [PATCH 515/665] Seedtag: update params (#6449)

* Seedtag: update params

* lint
---
 dev-docs/bidders/seedtag.md | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/dev-docs/bidders/seedtag.md b/dev-docs/bidders/seedtag.md
index 33b8b0d37b..04ab9c9470 100644
--- a/dev-docs/bidders/seedtag.md
+++ b/dev-docs/bidders/seedtag.md
@@ -31,8 +31,9 @@ The publisher id 0000-0000-01 returns demo responses.
 | Name              | Scope               | Description                                                                    | Example               | Type     |
 |-------------------|---------------------|--------------------------------------------------------------------------------|-----------------------|----------|
 | `publisherId`     | required            | The publisher id.                                                              | 0000-0000-01          | `string` |
-| `adUnitId`        | required            | The adunit id.                                                                 | 00000                 | `string` |
-| `placement`       | required            | Adunit placement, posibles values: inScreen, inArticle                         | inScreen              | `string` |
+| `adUnitId`        | optional            | The adunit id.                                                                 | 00000                 | `string` |
+| `placement`       | optional            | Adunit placement, posibles values: inScreen, inArticle                         | inScreen              | `string` |
+| `integrationType` | optional            | IntegrationType. Posibles values: publisherToken, RonId                        | publisherToken        | `string` |
 
 ### Bid Params (pbs)
 
@@ -60,8 +61,9 @@ const adUnits = [
         bidder: 'seedtag',
         params: {
           publisherId: '0000-0000-01',      // required
-          adUnitId: '0000',                 // required
-          placement: 'inScreen',            // required
+          adUnitId: '0000',                 // optional
+          placement: 'inScreen',            // optional
+          integrationType: 'publisherToken' // optional
         }
       }
     ]
@@ -87,8 +89,9 @@ const adUnits = [
         bidder: 'seedtag',
         params: {
           publisherId: '0000-0000-01',      // required
-          adUnitId: '0000',                 // required
-          placement: 'inArticle',           // required
+          adUnitId: '0000',                 // optional
+          placement: 'inArticle',           // optional
+          integrationType: 'publisherToken' // optional
         }
       }
     ]
@@ -112,8 +115,9 @@ const adUnits = [
         bidder: 'seedtag',
         params: {
           publisherId: '0000-0000-01',      // required
-          adUnitId: '0000',                 // required
-          placement: 'inBanner',              // required
+          adUnitId: '0000',                 // optional
+          placement: 'inBanner',           // optional
+          integrationType: 'publisherToken' // optional
         }
       }
     ]
@@ -149,9 +153,10 @@ var adUnits = [{
     {
       bidder: 'seedtag',
       params: {
-        publisherId: '0000-0000-01',    // required
-        adUnitId: '0000',               // required
-        placement: 'inStream',          // required
+         publisherId: '0000-0000-01',      // required
+         adUnitId: '0000',                 // optional
+         placement: 'inStream',           // optional
+         integrationType: 'publisherToken' // optional
       }
     }
   ]

From 23b39ac057df4fc6a1485976c6f0461290fc8858 Mon Sep 17 00:00:00 2001
From: SebRobert <sebastien.robert@collectiveaudience.co>
Date: Wed, 18 Mar 2026 07:54:30 +0100
Subject: [PATCH 516/665] BeOp Adapter : Add Prebid Server in Doc (#6432)

* BeOp Adapter : Add Prebid Server in Doc

* Change beopid to caudid
---
 dev-docs/bidders/beop.md | 45 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 41 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/beop.md b/dev-docs/bidders/beop.md
index 00365c998e..4d05f425e0 100644
--- a/dev-docs/bidders/beop.md
+++ b/dev-docs/bidders/beop.md
@@ -3,7 +3,7 @@ layout: bidder
 title: BeOp
 description: BeOp Bidder Adaptor
 pbjs: true
-pbs: false
+pbs: true
 media_types: banner
 biddercode: beop
 tcfeu_supported: true
@@ -21,7 +21,7 @@ safeframes_ok: false
 deals_supported: false
 fpd_supported: true
 prebid_member: false
-multiformat_supported: will-bid-on-one
+multiformat_supported: will-bid-on-any
 ortb_blocking_supported: false
 privacy_sandbox: no
 ---
@@ -30,7 +30,9 @@ privacy_sandbox: no
 
 The BeOp bidder adapter requires an `accountId` or `networkId`, which you can retrieve from your BeOp platform dashboard (as a publisher, reseller, or media group). To activate BeOp demand on your account, please contact your account manager or reach out to <publishers@beop.io>.
 
-### Bid Params
+BeOp is available in both **Prebid.js** (client-side) and **Prebid Server** (server-side). You can use BeOp via Prebid Server when Prebid.js calls a Prebid Server host, or in server-to-server OpenRTB setups.
+
+### Bid Params (Prebid.js)
 
 {: .table .table-bordered .table-striped }
 | Name | Scope | Description | Example | Type |
@@ -40,6 +42,20 @@ The BeOp bidder adapter requires an `accountId` or `networkId`, which you can re
 | `currency` | optional | Preferred bidding currency (defaults to `'EUR'`) | `'EUR'` or `'USD'` | `string` |
 | `keywords` | optional | Contextual keywords string or array to help target your campaign | `'cars, racing'` or `['cars', 'racing']` | `string/array` |
 
+### Prebid Server
+
+The BeOp Prebid Server adapter supports the same account models as the Prebid.js adapter. Use either **publisher mode** (`pid`) or **network mode** (`nid` + `ntpnid`).
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|------|--------|-------------|---------|------|
+| `pid` | required (publisher) | BeOp publisher ID (same as `accountId` in Prebid.js) | `'5a8af500c9e77c00017e4cad'` | `string` |
+| `nid` | required (network) | BeOp network ID (same as `networkId` in Prebid.js). Use together with `ntpnid`. | `'5a8af500c9e77c00017e4cad'` | `string` |
+| `ntpnid` | required (network) | Network partner ID (same as `networkPartnerId` in Prebid.js). Use together with `nid`. | `'MY-WEBSITE-123'` | `string` |
+
+Either provide `pid` **or** the pair `nid` + `ntpnid`.
+
+If you host Prebid Server and need to enable the BeOp adapter, add BeOp to your bidders configuration. For endpoint or setup questions, contact <supply>.
+
 ### User Syncs
 
 BeOp supports iframe and pixel-based user syncs using the `getUserSyncs` method.
@@ -60,7 +76,7 @@ BeOp supports iframe and pixel-based user syncs using the `getUserSyncs` method.
 
 ### Cookie Usage
 
-BeOp sets a first-party cookie `beopid` for frequency capping and user session purposes. This ID is anonymized and used to improve campaign performance, capping logic, and personalization within publisher domains.
+BeOp sets a first-party cookie `caudid` (Collective Audience user ID) for frequency capping and user session purposes. The value is a 24-character hex string (ObjectID-style). This ID is anonymized and used to improve campaign performance, capping logic, and personalization within publisher domains.
 
 ### First-Party Data Support
 
@@ -75,6 +91,8 @@ Thanks to BeOp’s unique interactive formats, publishers benefit not only from
 
 ### Test Parameters
 
+**Prebid.js**
+
 ```js
 var adUnits = [
   {
@@ -100,3 +118,22 @@ var adUnits = [
   },
 ];
 ```
+
+**Prebid Server** - 
+
+```json
+"properties": {
+    "pid": {
+      "type": "string",
+      "description": "BeOp publisher ID"
+    },
+    "nid": {
+      "type": "string",
+      "description": "BeOp Network ID"
+    },
+    "ntpnid": {
+      "type": "string",
+      "description": "Network partner ID"
+    }
+  },
+```

From d1eb08ff617145aef95096d42934a57d2d5d6c0d Mon Sep 17 00:00:00 2001
From: Daniel Baud <52867769+danielbaud@users.noreply.github.com>
Date: Wed, 18 Mar 2026 09:26:54 +0100
Subject: [PATCH 517/665] added alliance gravity docs (prebidjs) (#6372)

---
 dev-docs/bidders/alliance_gravity.md | 29 ++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 dev-docs/bidders/alliance_gravity.md

diff --git a/dev-docs/bidders/alliance_gravity.md b/dev-docs/bidders/alliance_gravity.md
new file mode 100644
index 0000000000..6382a30957
--- /dev/null
+++ b/dev-docs/bidders/alliance_gravity.md
@@ -0,0 +1,29 @@
+---
+layout: bidder
+title: Alliance Gravity
+description: Prebid Alliance Gravity Bidder Adapter
+biddercode: alliance_gravity
+tcfeu_supported: true
+gvl_id: 501
+schain_supported: true
+userId: all
+media_types: banner, video, audio, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: true
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description       | Example   | Type     |
+|---------------|----------|-------------------|-----------|----------|
+| `srid`        | required | Stored Request ID | `'1234'` | `string` |

From 8c46619f7cef84bae38051271280193165a4fb00 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Wed, 18 Mar 2026 10:28:09 +0200
Subject: [PATCH 518/665] Attekmi: add Adastra alias (#6343)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/adastra.md | 39 +++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/adastra.md

diff --git a/dev-docs/bidders/adastra.md b/dev-docs/bidders/adastra.md
new file mode 100644
index 0000000000..9f13262327
--- /dev/null
+++ b/dev-docs/bidders/adastra.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Adastra Tech
+description: Adastra Tech Bidder Adapter
+biddercode: adastra
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+### Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example                             | Type      |
+|---------------|----------|---------------------------------|-------------------------------------|-----------|
+| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
+| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
+| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
+| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description         | Example                              | Type     |
+|---------------|----------|---------------------|--------------------------------------|----------|
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 06838a2a418bc8a4d44f3fd54500187263ce0997 Mon Sep 17 00:00:00 2001
From: driftpixelai <166716541+driftpixelai@users.noreply.github.com>
Date: Thu, 19 Mar 2026 09:40:05 +0200
Subject: [PATCH 519/665] New adapter DPAI (#6427)

* New adapter DPAI

* New adapter DPAI: Added end line

* New adapter dpai

* new DPA adapter: disable pbs and pbs_app_supported
---
 dev-docs/bidders/dpai.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/dpai.md

diff --git a/dev-docs/bidders/dpai.md b/dev-docs/bidders/dpai.md
new file mode 100644
index 0000000000..5ad9312893
--- /dev/null
+++ b/dev-docs/bidders/dpai.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: DPAI
+description: Prebid DPAI Bidder Adapter
+biddercode: dpai
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 65ef1d5e1351e2c64e9ca8c1e4b3c7445a73f023 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alexander=20=C3=96str=C3=B6m?=
 <146713650+seenthis-alex@users.noreply.github.com>
Date: Thu, 19 Mar 2026 12:58:09 +0100
Subject: [PATCH 520/665] New Module: SeenThis Brand Stories (#6274)

* add seenthis brand stories dev documentation

* update doc
---
 dev-docs/modules/seenthisBrandStories.md | 79 ++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 dev-docs/modules/seenthisBrandStories.md

diff --git a/dev-docs/modules/seenthisBrandStories.md b/dev-docs/modules/seenthisBrandStories.md
new file mode 100644
index 0000000000..88a2af4d42
--- /dev/null
+++ b/dev-docs/modules/seenthisBrandStories.md
@@ -0,0 +1,79 @@
+---
+layout: page_v2
+page_type: module
+title: Module - SeenThis Brand Stories
+description: Enable SeenThis Brand Stories ad format integration with fullscreen support
+module_code: seenthisBrandStories
+display_name: SeenthisBrandStories
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# SeenthisBrandStories Module
+
+{:.no_toc}
+
+- TOC
+  {:toc}
+
+## Overview
+
+The module enables publishers to integrate SeenThis Brand Stories ads within Prebid.js. This module provides communication between the publisher's page and Brand Stories ad iframes, handling dynamic resizing, fullscreen mode, and responsive design considerations.
+
+The module is bidder adapter agnostic and works with all Prebid.js adapters that serve Brand Stories creative content.
+
+## Configuration
+
+This module requires no configuration. Once included in your Prebid.js build, it automatically handles Brand Stories ads when they are served.
+
+## Implementation
+
+### Basic Setup
+
+1. Include the SeenThis Brand Stories module in your Prebid.js build
+2. Configure your ad units as normal - no special configuration needed
+3. The module will automatically detect Brand Stories creatives and manage their behavior
+
+## Technical Details
+
+### Message Event Management
+
+The module listens for specific message events from Brand Stories iframes and responds accordingly:
+
+- Iframe resizing requests
+- Fullscreen mode transitions
+- Style and class modifications
+- Margin calculations for responsive layout
+
+### CSS and Styling
+
+The module dynamically applies CSS modifications to ensure proper display:
+
+- Full-width responsive behavior
+- Auto-height adjustments
+- Dynamic margin calculations
+- Class-based style modifications
+
+## Testing
+
+A test page has been created to validate the integration:
+
+- **Test Page**: [https://cdn.staging.sitestream.co/libs/storylines/branch-prebid-test-page-b52cdb5a/examples/prebid.html](https://cdn.staging.sitestream.co/libs/storylines/branch-prebid-test-page-b52cdb5a/examples/prebid.html)
+
+### Local Testing
+
+For testing with your own Prebid.js build:
+
+1. Open the test page in Chrome
+2. Use the Network tab's "Override content" feature
+3. Replace the Prebid.js file with your custom build
+4. Verify that Brand Stories ads display and behave correctly
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Ads not resizing properly**: Ensure the module is included in your Prebid.js build
+2. **Fullscreen mode not working**: Check for conflicting CSS or JavaScript on the page
+3. **Multiple instances interfering**: The module handles this automatically, but ensure unique ad unit codes

From e3f315b2fdf2e9c7389f66957a50c14e1509f591 Mon Sep 17 00:00:00 2001
From: Shashank Pradeep <101392500+shashankatd@users.noreply.github.com>
Date: Sun, 22 Mar 2026 23:30:08 +0530
Subject: [PATCH 521/665] Mile Bidder Adapter: Initial Release (#6410)

* Mile Bidder Adapter: Initial Release

* fix: enable download for automatadAnalyticsAdapter

---------

Co-authored-by: Shashank <=>
---
 dev-docs/analytics/automatad.md |  2 +-
 dev-docs/bidders/mile.md        | 53 +++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+), 1 deletion(-)
 create mode 100644 dev-docs/bidders/mile.md

diff --git a/dev-docs/analytics/automatad.md b/dev-docs/analytics/automatad.md
index 83e13d5d7d..b63f394d84 100644
--- a/dev-docs/analytics/automatad.md
+++ b/dev-docs/analytics/automatad.md
@@ -7,7 +7,7 @@ tcfeu_supported: false
 usp_supported: false
 coppa_supported: false
 prebid_member: false
-enable_download: false
+enable_download: true
 ---
 
 #### Instructions for usage
diff --git a/dev-docs/bidders/mile.md b/dev-docs/bidders/mile.md
new file mode 100644
index 0000000000..103d8ae468
--- /dev/null
+++ b/dev-docs/bidders/mile.md
@@ -0,0 +1,53 @@
+---
+layout: bidder
+title: Mile
+description: Prebid Mile Bidder Adapter
+biddercode: mile
+tcfeu_supported: true
+gvl_id: 1464
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: banner
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                     | Example              | Type     |
+|---------------|----------|---------------------------------|----------------------|----------|
+| `publisherId` | required | The publisher ID from Mile      | `'1234'`             | `string` |
+| `placementId` | required | The placement ID from Mile      | `'1234'`             | `string` |
+| `siteId`      | required | The site ID from Mile           | `'1234'`             | `string` |
+
+### Configuration
+
+The Mile adapter requires `publisherId`, `placementId`, and `siteId` parameters to be provided. Contact your Mile account representative to obtain these values.
+
+### Example Ad Unit: Banner
+
+```javascript
+var adUnits = [{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250], [728, 90]]
+        }
+    },
+    bids: [{
+        bidder: 'mile',
+        params: {
+            publisherId: 'publisherId',
+            placementId: 'placementId',
+            siteId: 'siteId'
+        }
+    }]
+}];
+```

From bd28027bae1805d8d1c337dd30330b28b22eb531 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 23 Mar 2026 02:42:26 -0700
Subject: [PATCH 522/665] PBJS: documentation for yield and legacyRender flags
 (#6376)

* PBJS: documentation for yield and legacyRender flags

* Fix link

* Fix anchor link

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/publisher-api-reference/setConfig.md | 19 +++++++++++++------
 dev-docs/publisher-api-reference/yield.md     | 16 ++++++++++++++++
 2 files changed, 29 insertions(+), 6 deletions(-)
 create mode 100644 dev-docs/publisher-api-reference/yield.md

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 798ca37aec..bcfb87199f 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1347,7 +1347,7 @@ The `auctionOptions` object controls aspects related to auctions.
 | `secondaryBidders` | Optional | Array of Strings | Specifies bidders that the Prebid auction will no longer wait for before determining the auction has completed. This may be helpful if you find there are a number of low performing and/or high timeout bidders in your page's rotation. |
 | `suppressStaleRender` | Optional | Boolean | When true, prevents `banner` bids from being rendered more than once. It should only be enabled after auto-refreshing is implemented correctly.  Default is false. |
 | `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false. |
-| `legacyRender`     | Optional  | Boolean | When true, uses "legacy" rendering logic  (see [note](#note-legacyRender))                               |
+| `legacyRender`     | Optional  | Boolean | When true, uses "legacy" rendering logic  (see [note](#legacyRender))                               |
 | `rejectUnknownMediaTypes` | Optional | Boolean | Since Pbjs 11, When true, reject bids when the adapter response omits `mediaType` for an ad unit that has explicit `mediaTypes` configured. Default is false. |
 | `rejectInvalidMediaTypes` | Optional | Boolean | Since Pbjs 11, When true, reject bids when response `mediaType` does not match one of the ad unit's configured `mediaTypes`. Default is true. |
 
@@ -1408,14 +1408,21 @@ PBJS performs the following actions when expired rendering is detected.
 
 Expired winning bids will continue to be rendered unless `suppressExpiredRender` is set to true.  Events including `STALE_RENDER` and `BID_WON` are unaffected by this option.
 
-<a id="note-legacyRender"></a>
+<a id="legacyRender"></a>
 
-#### More on `legacyRender`
-{: .no_toc}
+#### More on Legacy Rendering
 
-Since Prebid 10.12, `pbjs.renderAd` wraps creatives in an additional iframe. This can cause problems for some creatives
+Since Prebid 10.12, [`renderAd`](/dev-docs/publisher-api-reference/renderAd.html) wraps creatives in an additional iframe. This can cause problems for some creatives
 that try to reach the top window and do not expect to find the extra iframe. You may set `legacyRender: true` to revert
-to pre-10.12 rendering logic.
+to pre-10.12 rendering logic:
+
+```javascript
+pbjs.setConfig({
+  auctionOptions: {
+    legacyRender: true
+  }
+});
+```
 
 <a name="setConfig-maxNestedIframes"></a>
 
diff --git a/dev-docs/publisher-api-reference/yield.md b/dev-docs/publisher-api-reference/yield.md
new file mode 100644
index 0000000000..169a50ef6c
--- /dev/null
+++ b/dev-docs/publisher-api-reference/yield.md
@@ -0,0 +1,16 @@
+---
+layout: api_prebidjs
+title: pbjs.yield
+description: yield setting
+sidebarType: 1
+---
+
+Since version 10, [pbjs.processQueue](/dev-docs/publisher-api-reference/processQueue.html) yields the main browser thread after executing each command in the queue, to improve UX (and some related metrics such as [interaction to next paint](https://web.dev/articles/inp)).
+
+You can disable yielding by setting `pbjs.yield` to `false`:
+
+```javascript
+pbjs.yield = false;
+
+pbjs.que.push(/* ... */)
+```

From b1cb6cf450abcaaaa4caf6753923986d16d7b35f Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Mon, 23 Mar 2026 11:18:05 +0100
Subject: [PATCH 523/665] Update github actions in ci.yml (#6497)

---
 .github/workflows/ci.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4b63e8ff72..781536638d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,15 +15,15 @@ jobs:
     name: run markdownlint
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-      - uses: tj-actions/changed-files@v46
+      - uses: tj-actions/changed-files@v47
         id: changed-files
         with:
           files: '**/*.md'
           separator: ","
-      - uses: DavidAnson/markdownlint-cli2-action@v16
+      - uses: DavidAnson/markdownlint-cli2-action@v22
         if: steps.changed-files.outputs.any_changed == 'true'
         with:
           globs: "${{ steps.changed-files.outputs.all_changed_files }},!_includes"

From 658de000ec9a448c63105b7b7f61551d95ed201a Mon Sep 17 00:00:00 2001
From: nuba-io <github@nuba.io>
Date: Mon, 23 Mar 2026 12:20:02 +0200
Subject: [PATCH 524/665] New adapter Nuba (#6495)

* feature/nuba-bidder

* Apply suggestion from @muuki88

* Nuba adapter: Enable pbs

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/nuba.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/nuba.md b/dev-docs/bidders/nuba.md
index 0746492f19..7fec3dbbaa 100644
--- a/dev-docs/bidders/nuba.md
+++ b/dev-docs/bidders/nuba.md
@@ -16,7 +16,7 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1

From f059dec5bf568b1ecaaaed6ff6d4ca6c5fadd300 Mon Sep 17 00:00:00 2001
From: Illia <Illia.milshtein@start.io>
Date: Mon, 23 Mar 2026 12:25:42 +0200
Subject: [PATCH 525/665] Start.io: documentation updated (#6492)

* Update Start.io bidder documentation: add GPP and user sync support, enhance examples

* Fix table formatting in Start.io bidder documentation for userSync parameters

* Update Start.io bidder docs: mark GPP as unsupported
---
 dev-docs/bidders/startio.md | 128 ++++++++++++++++++++++++++++++++----
 1 file changed, 116 insertions(+), 12 deletions(-)

diff --git a/dev-docs/bidders/startio.md b/dev-docs/bidders/startio.md
index a74aeb448b..bef59670f3 100644
--- a/dev-docs/bidders/startio.md
+++ b/dev-docs/bidders/startio.md
@@ -6,6 +6,7 @@ description: Prebid Start.io Adapter
 tcfeu_supported: true
 coppa_supported: true
 gpp_supported: false
+userIds: startioId
 floors_supported: true
 media_types: banner, video, native
 multiformat_supported: will-bid-on-any
@@ -15,7 +16,7 @@ gvl_id: 1216
 usp_supported: true
 pbjs: true
 pbs: true
-prebid_member: false
+prebid_member: true
 fpd_supported: false
 privacy_sandbox: no
 ortb_blocking_supported: true
@@ -29,41 +30,144 @@ The Start.io bidder adapter requires additional setup and approval from the Star
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                       | Example                | Type         |
-|---------------|----------|-----------------------------------|------------------------|--------------|
-| `publisherId` | required | Publisher ID                      | `'publisher-1234'`     | `string`     |
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `publisherId` | required | Publisher ID | `'publisher-1234'` | `string` |
+| `testAdsEnabled` | optional | Enable test ads during development | `true` | `boolean` |
 
 #### Configuration
 
-Sample banner setup:
+##### Banner
 
 ```js
 var adUnits = [
   {
-    code: "div-gpt-ad-12345-0",
+    code: 'test-div',
     mediaTypes: {
       banner: {
-        sizes: [[300, 250]]
+        sizes: [[300, 250], [728, 90]]
       }
     },
     bids: [
       {
-        bidder: "startio",
+        bidder: 'startio',
         params: {
-          publisherId: "publisher-12345"
+          publisherId: 'your-account-id',
+          testAdsEnabled: true
         }
       }
     ]
   }
-]
+];
+```
+
+##### Instream Video
 
-pbjs.que.push(function() {
-  pbjs.addAdUnits(adUnits);
+```js
+var videoAdUnits = [
+  {
+    code: 'test-div-video',
+    mediaTypes: {
+      video: {
+        context: 'instream',
+        placement: 1,
+        playerSize: [640, 360],
+        mimes: ['video/mp4'],
+        protocols: [2, 3, 5, 6],
+        api: [2],
+        maxduration: 30,
+        linearity: 1,
+        playbackmethod: [2]
+      }
+    },
+    bids: [
+      {
+        bidder: 'startio',
+        params: {
+          publisherId: 'your-account-id',
+          testAdsEnabled: true
+        }
+      }
+    ]
+  }
+];
+```
+
+##### Native
+
+```js
+var nativeAdUnits = [
+  {
+    code: 'test-div-native',
+    mediaTypes: {
+      native: {
+        title: { required: true, len: 80 },
+        body: { required: true },
+        image: { required: true, sizes: [150, 150] },
+        icon: { required: false, sizes: [50, 50] },
+        sponsoredBy: { required: true }
+      }
+    },
+    bids: [
+      {
+        bidder: 'startio',
+        params: {
+          publisherId: 'your-account-id',
+          testAdsEnabled: true
+        }
+      }
+    ]
+  }
+];
+```
+
+### User Sync and User ID Module
+
+The Start.io User ID submodule generates and persists a unique user identifier by fetching it from a Start.io-managed endpoint. The ID is stored in both cookies and local storage for subsequent page loads and is made available to other Prebid.js modules via the standard `eids` interface.
+
+To enable iframe-based user syncing and the Start.io User ID module, include the following configuration:
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [{
+            name: 'startioId',
+            storage: {
+                type: 'cookie&html5',
+                name: 'startioId',
+                expires: 90
+            }
+        }],
+        filterSettings: {
+            iframe: {
+                bidders: ['startio'],
+                filter: 'include'
+            }
+        }
+    }
 });
 ```
 
+For integration support, contact <prebid@start.io>.
+
+#### User ID Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| `name` | required | String | The name of this module. | `"startioId"` |
+| `storage` | required | Object | Storage configuration for the user ID. | |
+| `storage.type` | required | String | Type of storage: `"cookie"`, `"html5"`, or `"cookie&html5"`. | `"cookie&html5"` |
+| `storage.name` | required | String | The name used to store the user ID. | `"startioId"` |
+| `storage.expires` | optional | Number | Number of days before the stored ID expires. Defaults to `90`. | `90` |
+
 ### Additional Notes
 
 #### Request and Response Attributes
 
 - Bids are returned in **net** - that is, the bids returned reflect the bid amount with revenue sharing already taken into account. No adjustment is necessary.
+- The adapter processes requests via OpenRTB 2.5 standards.
+- Ensure that the `publisherId` parameter is set correctly for your integration.
+- Test ads can be enabled using `testAdsEnabled: true` during development.

From 41cf23fd4ebdb99420d7d07890a9bf71d66c83e6 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Mon, 23 Mar 2026 11:26:23 +0100
Subject: [PATCH 526/665] add allowVastXmlOnly (#6491)

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/publisher-api-reference/setConfig.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index bcfb87199f..cebebcc32d 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1153,10 +1153,11 @@ pbjs.setConfig({
 
 ### Client-side Caching of VAST XML
 
-When serving video ads, VAST XML creatives must be cached so the
+When serving video ads, VAST XML creatives are commonly cached so the
 video player can retrieve them when it's ready. Players don't obtain the VAST XML from
 the JavaScript DOM in Prebid.js, but rather expect to be given a URL where it can
-be retrieved. There are three different flows possible with Prebid.js around VAST XML caching:
+be retrieved. If your player can render VAST XML directly, you can set `cache.allowVastXmlOnly`
+to bypass the cache requirement. There are different flows possible with Prebid.js around VAST XML handling:
 
 * Server-side caching:  
   Some video bidders (e.g. Rubicon Project) always cache the VAST XML on their servers as part of the bid. They provide a 'videoCacheKey', which is used in conjunction with the VAST URL in the ad server to retrieve the correct VAST XML when needed. In this case, Prebid.js has nothing else to do. As of Prebid.js 4.28, a publisher may specify the `ignoreBidderCacheKey` flag to re-cache these bids somewhere else using a VAST wrapper.
@@ -1173,6 +1174,7 @@ be retrieved. There are three different flows possible with Prebid.js around VAS
 | cache.timeout | no | number | Timeout (in milliseconds) for network requests to the cache |
 | cache.vasttrack | no | boolean | Passes additional data to the url, used for additional event tracking data. Defaults to `false`. |
 | cache.ignoreBidderCacheKey | no | boolean | If the bidder supplied their own cache key, setting this value to true adds a VAST wrapper around that URL, stores it in the cache defined by the `url` parameter, and replaces the original video cache key with the new one. This can dramatically simplify ad server setup because it means all VAST creatives reside behind a single URL. The tradeoff: this approach requires the video player to unwrap one extra level of VAST. Defaults to `false`. |
+| cache.allowVastXmlOnly | no | boolean | When `true`, allows rendering VAST XML without requiring use of a cache. Useful for players that can consume VAST XML directly. Defaults to `false`. |
 | cache.batchSize | no | number | Enables video cache requests to be batched by a specified amount (defaults to 1) instead of making a single request per each video. |
 | cache.batchTimeout | no | number | Used in conjunction with `batchSize`, `batchTimeout` specifies how long to wait in milliseconds before sending a batch video cache request based on the value for `batchSize` (if present). A batch request will be made whether the `batchSize` amount was reached or the `batchTimeout` timer runs out. `batchTimeout` defaults to 0. |
 
@@ -1200,6 +1202,16 @@ pbjs.setConfig({
 });
 ```
 
+If your player can render raw VAST XML and you do not want to require caching, you can set:
+
+```javascript
+pbjs.setConfig({
+        cache: {
+            allowVastXmlOnly: true
+        }
+});
+```
+
 As of Prebid.js 2.36, you can track client-side cached VAST XML. This functionality is useful for publishers who want to allow their analytics provider to measure video impressions. The prerequisite to using this feature is the availability of a Prebid Server that supports:
 
 * the /vtrack endpoint

From 07c2429e9160a06b0213fb5ab83ae41547520f50 Mon Sep 17 00:00:00 2001
From: Eugene Dorfman <eugene.dorfman@gmail.com>
Date: Mon, 23 Mar 2026 11:29:47 +0100
Subject: [PATCH 527/665] 51d: update doc introduce hwv (#6484)

---
 dev-docs/modules/51DegreesRtdProvider.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/dev-docs/modules/51DegreesRtdProvider.md b/dev-docs/modules/51DegreesRtdProvider.md
index f84a5690e7..76b594ec84 100644
--- a/dev-docs/modules/51DegreesRtdProvider.md
+++ b/dev-docs/modules/51DegreesRtdProvider.md
@@ -27,7 +27,7 @@ The Cloud API is **free** to integrate and use. To increase limits please check
 
 51Degrees module enriches an OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/index.html).
 
-51Degrees module sets the following fields of the device object: `devicetype`, `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio`. Interested bidder adapters may use these fields as needed. 
+51Degrees module sets the following fields of the device object: `devicetype`, `make`, `model`, `hwv`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio`. Interested bidder adapters may use these fields as needed. 
 
 The module also adds a `device.ext.fod` extension object (fod == fifty one degrees) and sets `device.ext.fod.deviceId` to a permanent device ID, which can be rapidly looked up in on-premise data, exposing over 250 properties, including device age, chipset, codec support, price, operating system and app/browser versions, age, and embedded features. 
 
@@ -35,7 +35,7 @@ It also sets `device.ext.fod.tpc` key to a binary value to indicate whether thir
 
 The module supports on premise and cloud device detection services with free options for both. 
 
-A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
+A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
 
 An interface compatible self hosted service can be used with .NET, Java, Node, PHP, and Python.  See [51Degrees examples](https://51degrees.com/documentation/_examples__device_detection__getting_started__web__on_premise.html).
 
@@ -57,12 +57,14 @@ gulp build --modules="rtdModule,51DegreesRtdProvider,appnexusBidAdapter,..."
 
 #### Resource Key
 
-In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
+In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
 
 * DeviceId
 * DeviceType
 * HardwareVendor
 * HardwareName
+* HardwareNamePrefix
+* HardwareNameVersion
 * HardwareModel
 * PlatformName
 * PlatformVersion
@@ -128,7 +130,7 @@ pbjs.setConfig({
                 waitForIt: true, // should be true, otherwise the auctionDelay will be ignored
                 params: {
                     resourceKey: '<YOUR_RESOURCE_KEY>',
-                    // Get your resource key from https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation
+                    // Get your resource key from https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation
                     // alternatively, you can use the on-premise version of the 51Degrees service and connect to your chosen end point
                     // onPremiseJSUrl: 'https://localhost/51Degrees.core.js'
                 },

From 6857556dd7513b60666f34bb5fd1eb4503176351 Mon Sep 17 00:00:00 2001
From: adquery <89853721+adquery@users.noreply.github.com>
Date: Mon, 23 Mar 2026 13:49:37 +0100
Subject: [PATCH 528/665] adquery: update bidder documentation with expanded
 specs and examples (#6450)

* adquery: changes in specification

* adquery: changes in specification

* adquery: update bidder documentation with expanded specs and examples
---
 dev-docs/bidders/adquery.md | 109 ++++++++++++++++++++++++++++++++++--
 1 file changed, 104 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/adquery.md b/dev-docs/bidders/adquery.md
index c7099a031b..139ff8a20c 100644
--- a/dev-docs/bidders/adquery.md
+++ b/dev-docs/bidders/adquery.md
@@ -11,13 +11,112 @@ schain_supported: true
 gvl_id: 902
 userIds: adQuery QiD
 sidebarType: 1
+media_types: banner, video
 ---
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description   | Example                                                                  | Type      |
-|---------------|----------|---------------|--------------------------------------------------------------------------|-----------|
-| `placementId` | required | Placement ID  | `6d93f2a0e5f0fe2cc3a6e9e3ade964b43b07f897`                               | `string`  |
-| `type`        | required | Ad Type       | `banner`                                                                 | `string`  |
-| `sizes`       | required | Allowed sizes | `320x100,300x250,336x280,300x50,300x100,320x50,320x480,300x150,320x180`  | `string`  |
+| Name          | Scope    | Description                                                                 | Example                                                                  | Type      |
+|---------------|----------|-----------------------------------------------------------------------------|--------------------------------------------------------------------------|-----------|
+| `placementId` | required | Placement ID provided by Adquery (must match the type/format in dashboard)  | `d30f79cf7fef47bd7a5611719f936539bec0d2e9`                               | `string`  |
+| `type`        | required | Ad format/type – tells Adquery what kind of creative to return              | `banner`, `video`, `interstitial`, `anchorad`                            | `string`  |
+
+**Notes:**
+
+- `placementId` is always required and should correspond to a placement configured in the Adquery dashboard for the specific `type`.
+- `type` is mandatory in bidder params — it determines the creative format (banner, video, interstitial, anchorad).
+- For **banner** ads: Define sizes in `mediaTypes.banner.sizes`. The adapter automatically parses and sends them.
+- For **video** ( outstream ): Use `type: 'video'` + `mediaTypes.video.context: 'outstream'`. A renderer is required for rendering (e.g. InRenderer or similar). In-stream video is not currently supported by this adapter.
+- For **video** ( instream ): Use `type: 'video'` + `mediaTypes.video.context: 'instream'`. A renderer is required for rendering (e.g. InRenderer or similar). In-stream video is not currently supported by this adapter.
+- For special formats (`interstitial`, `anchorad`): A spetial size placeholder is reqired `[1x1]`.
+
+### Example 1: Standard Banner Ad
+
+```javascript
+{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250], [320, 50], [728, 90]]
+        }
+    },
+    bids: [{
+        bidder: 'adquery',
+        params: {
+            placementId: '9e0a916215d99196f44821dfc348c2843ee5b5a7',
+            type: 'banner'
+        }
+    }]
+}
+```
+
+### Example 2: Outstream Video Ad (with renderer)
+
+```javascript
+{
+    code: 'video-outstream-1',
+    mediaTypes: {
+        video: {
+            context: 'outstream',
+            playerSize: [[640, 360]],
+            mimes: ['video/mp4', 'video/webm'],
+            protocols: [2, 3, 5, 6, 7, 8],
+            api: [2],     
+            placement: 1,  
+            startdelay: 0,
+            skip: 1
+        }
+    },
+    renderer: {
+        url: 'https://cdn.jsdelivr.net/npm/in-renderer-js@1/dist/in-renderer.umd.min.js',
+        render: function(bid) {
+            var renderer = new window.InRenderer();
+            renderer.render('video-outstream-1', bid);
+        }
+    },
+    bids: [{
+        bidder: 'adquery',
+        params: {
+            placementId: 'd30f79cf7fef47bd7a5611719f936539bec0d2e9',
+            type: 'video'
+        }
+    }]
+}
+```
+
+### Example 3: Interstitial + Anchor Ad (no sizes)
+
+```javascript
+// Interstitial (full-page overlay)
+{
+    code: 'interstitial-div',
+    mediaTypes: {
+        banner: {
+            sizes: [[1, 1]]
+        }
+    },
+    bids: [{
+        bidder: 'adquery',
+        params: {
+            placementId: 'd30f79cf7fef47bd7a5611719f936539bec0d2e9',
+            type: 'interstitial'
+        }
+    }]
+},
+
+// Anchor / fixed bottom bar
+{
+    code: 'anchor-div',
+        banner: {
+        sizes: [[1, 1]]
+    },
+    bids: [{
+        bidder: 'adquery',
+        params: {
+            placementId: 'd30f79cf7fef47bd7a5611719f936539bec0d2e9',
+            type: 'anchorad'
+        }
+    }]
+}
+```

From 8fc5b0fc38ba365aff3fccf3745ae8ae16fd64cf Mon Sep 17 00:00:00 2001
From: Tjorven <t.beckedorf@emetriq.com>
Date: Mon, 23 Mar 2026 13:55:43 +0100
Subject: [PATCH 529/665] remove md file of no longer needed emetriq adapter
 (#6407)

Co-authored-by: Markus Klink <justjoheinz@gmail.com>
---
 dev-docs/bidders/emetriq.md | 31 -------------------------------
 1 file changed, 31 deletions(-)
 delete mode 100644 dev-docs/bidders/emetriq.md

diff --git a/dev-docs/bidders/emetriq.md b/dev-docs/bidders/emetriq.md
deleted file mode 100644
index 17b59ae32b..0000000000
--- a/dev-docs/bidders/emetriq.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-layout: bidder
-title: emetriq
-description: emetriq Bidder Adapter
-biddercode: emetriq
-aliasCode: appnexus
-tcfeu_supported: true
-gvl_id: 213
-schain_supported: true
-userId: all
-media_types: banner, video, native
-safeframes_ok: true
-deals_supported: true
-pbjs: true
-pbs: true
-prebid_member: false
-multiformat_supported: will-bid-on-any
-sidebarType: 1
----
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description           | Example   | Type      |
-|---------------|----------|-----------------------|-----------|-----------|
-| `placement_id` (PBS+PBJS) or `placementId` (PBJS) | required | Placement id          | `'32068254'` | `string`  |
-
-emetriq is an aliased bidder for AppNexus.
-
-### Note
-
-For setup with emetriq, please reach out to [admins@emetriq.com](mailto:admins@emetriq.com)

From 6593e3d13f03e81d2f8f1d7cbfbbb828933c0c1f Mon Sep 17 00:00:00 2001
From: dpapworth-qc <50959025+dpapworth-qc@users.noreply.github.com>
Date: Mon, 23 Mar 2026 12:56:38 +0000
Subject: [PATCH 530/665] Remove Quantcast bidder documentation. (#6306)

Co-authored-by: Loic Pagny <90603301+lpagnypubstack@users.noreply.github.com>
---
 dev-docs/bidders/quantcast.md | 22 ----------------------
 1 file changed, 22 deletions(-)
 delete mode 100644 dev-docs/bidders/quantcast.md

diff --git a/dev-docs/bidders/quantcast.md b/dev-docs/bidders/quantcast.md
deleted file mode 100644
index f8f1f285de..0000000000
--- a/dev-docs/bidders/quantcast.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-layout: bidder
-title: Quantcast
-description: Prebid Quantcast Bidder Adaptor
-pbjs: true
-biddercode: quantcast
-media_types: video
-gvl_id: 11
-tcfeu_supported: true
-usp_supported: true
-coppa_supported: true
-prebid_member: true
-sidebarType: 1
----
-
-### Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                                                       | Example        | Type             |
-|---------------|----------|-------------------------------------------------------------------|----------------|------------------|
-| `publisherId` | required | The publisher id provided by Quantcast                            | `'LCOf845vzU'` | `string`         |
-| `battr`       | optional | Array of Blocked creative attributes as per OpenRTB Spec List 5.3 | `[6,7]`        | `Array<integer>` |

From e2559b3ae8367f0a851736c18ee18965806e803a Mon Sep 17 00:00:00 2001
From: ClickioTech <163025633+ClickioTech@users.noreply.github.com>
Date: Tue, 24 Mar 2026 14:52:24 +0300
Subject: [PATCH 531/665] New adapter clickio (#6463)

* New adapter clickio

* Remove unnecessary blank line in Clickio adapter documentation

* Update Clickio adapter documentation to replace gpp_supported with gpp_sids field

* Remove gdpr_supported field from Clickio adapter documentation

* Lint errors fix
---
 dev-docs/bidders/clickio.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/clickio.md

diff --git a/dev-docs/bidders/clickio.md b/dev-docs/bidders/clickio.md
new file mode 100644
index 0000000000..56eb616ce6
--- /dev/null
+++ b/dev-docs/bidders/clickio.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: Clickio
+description: Clickio Bidder Adapter
+biddercode: clickio
+pbjs: true
+pbs: false
+gvl_id: 1500
+tcfeu_supported: true
+usp_supported: true
+gpp_sids: tcfeu, usnat
+coppa_supported: true
+schain_supported: true
+userId: all
+media_types: banner
+floors_supported: true
+safeframes_ok: true
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+prebid_member: false
+sidebarType: 1
+---
+
+## Note
+
+The Clickio bid adapter connects to Clickio's demand platform using OpenRTB 2.5 standard. This adapter supports banner advertising.
+
+The Clickio bidding adapter requires initial setup before use. Please contact us at [support@clickio.com](mailto:support@clickio.com).
+To get started, simply replace the ``said`` with the ID assigned to you.
+
+## Bid Params
+
+| Name   | Scope    | Description  | Example   | Type     |
+|--------|----------|--------------|-----------|----------|
+| `said` | required | Site Area ID | `'11111'` | `string` |

From 5d8e74c992573445aafdf910ccb6e0b4cbcc8afc Mon Sep 17 00:00:00 2001
From: Rob Hazan <robhazan@gmail.com>
Date: Thu, 2 Apr 2026 13:58:58 -0400
Subject: [PATCH 532/665] Fixing inaccuracy regarding TTD adapter and HTTP/2
 (#6499)

* Fixing inaccuracy

TTD fully supports HTTP/2

* Removing useHttp2 flag

All endpoints support HTTP/2. No need for a special flag.

* attempting to fix md linting issues

* Update ttd.md

* Add bid parameters section to TTD documentation

* Update ttd.md

---------

Co-authored-by: Rich <richard@assertive.ai>
Co-authored-by: Patrick McCann <pmccann@cafemedia.com>
---
 dev-docs/bidders/ttd.md | 43 ++++++++++++++++++++---------------------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/dev-docs/bidders/ttd.md b/dev-docs/bidders/ttd.md
index 5226d955a5..adc903af42 100644
--- a/dev-docs/bidders/ttd.md
+++ b/dev-docs/bidders/ttd.md
@@ -26,36 +26,35 @@ gpp_sids: false
 fpd_supported: false
 ---
 
-### Disclosure
-
-This adapter is known to use an HTTP 1 endpoint. Header bidding often generates multiple requests to the same host and bidders are encouraged to change to HTTP 2 or above to help improve publisher page performance via multiplexing.
+## Disclosure
 
 {: .alert.alert-danger :}
 Note: The Trade Desk Header Bidding adapter requires setup and approval before beginning. Please reach out to <OpenPathPublishers@thetradedesk.com> for more details.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-Name | Scope | Description | Example | Type
---- | --- | --- | --- | ----
-`supplySourceId` | required | The TTD-provided supply source name. | `'supplier'` | `String`
-`publisherId` | required | The publisher ID. If there is a sellers.json, this should be the same as the seller_id in the sellers.json for the site being trafficked. If there is no sellers.json, this should be hardcoded to "1". | `'1427ab10f2e448057ed3b422'` | `String`
-`placementId` | optional | This field is optional if GPID is passed through the GPT module <https://docs.prebid.org/dev-docs/modules/gpt-pre-auction.html>. If that module isn't used, the GPID value should be passed in this field. | `'/1111/home#header'` | `String`
-`banner` | optional | Display banner targeting parameters. See the banner section below. | `{}` | `object`
-`bidfloor` | optional | Sets a bid floor price | `0.95` | `Float`
-`customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://customBidderEndpoint/bid/bidder/` | `String`
-`useHttp2` | optional | When true, the adapter will use an endpoint that supports HTTP2. | `true` | `boolean`
-
-### Banner Object
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `supplySourceId` | required | The TTD-provided supply source name. | `'supplier'` | `String` |
+| `publisherId` | required | The publisher ID. If there is a sellers.json, this should be the same as the seller_id in the sellers.json for the site being trafficked. If there is no sellers.json, this should be hardcoded to "1". | `'1427ab10f2e448057ed3b422'` | `String` |
+| `placementId` | optional | This field is optional if GPID is passed through the GPT module <https://docs.prebid.org/dev-docs/modules/gpt-pre-auction.html>. If that module isn't used, the GPID value should be passed in this field. | `'/1111/home#header'` | `String` |
+| `banner` | optional | Display banner targeting parameters. See the banner section below. | `{}` | `object` |
+| `bidfloor` | optional | Sets a bid floor price | `0.95` | `Float` |
+| `customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://customBidderEndpoint/bid/bidder/` | `String` |
+
+## Banner Object
 
 The following banner parameters are supported:
 
 {: .table .table-bordered .table-striped }
-Name | Scope | Description | Example | Type
---- | --- | --- | --- | ----
-`expdir` | optional | Directions in which the banner may expand. See "Expandable Direction" in the [OpenRTB 2.5 docs](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for possible values. | `[1, 3]` | `Array[integer]`
 
-#### `mediaTypes.banner` Parameters
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `expdir` | optional | Directions in which the banner may expand. See "Expandable Direction" in the [OpenRTB 2.5 docs](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for possible values. | `[1, 3]` | `Array[integer]` |
+
+## `mediaTypes.banner` Parameters
 
 The TTD adapter for banner uses certain parameters in the AdUnit's
 [mediaTypes.banner](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.banner) definition. Specifically, `sizes` is required for banner ad units. `pos` is recommended.
@@ -89,9 +88,9 @@ var bannerAdUnit = {
 }
 ```
 
-### Video
+## Video
 
-#### `mediaTypes.video` Parameters
+## `mediaTypes.video` Parameters
 
 The TTD adapter for video requires certain parameters in the AdUnit's
 [mediaTypes.video](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.video) definition. Specifically, `maxduration`, `api`, `mimes`, `plcmt`, and `protocols` are all required for video ad units. `playerSize`, `startdelay`, `playbackmethod`, and `pos` are recommended. `minduration`, `minbitrate`, `maxbitrate`, `skip`, `skipmin`, and `skipafter` are optional.
@@ -192,7 +191,7 @@ Lists of `api`, `playbackmethod`, `protocols`, `pos`, and `expdir` potential val
 - `4` : Down
 - `5` : Full Screen
 
-### First Party Data (Supported starting prebid v7.49)
+## First Party Data (Supported starting prebid v7.49)
 
 Publishers should set [First Party Data](https://docs.prebid.org/features/firstPartyData.html) in the `ortb2` and `ortb2Imp` objects. These fields are supported:
 

From 52d6aed9361a3b531b60ef53d6c36746362694e6 Mon Sep 17 00:00:00 2001
From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com>
Date: Tue, 7 Apr 2026 09:15:42 -0600
Subject: [PATCH 533/665] Add link to AdCP schema tool (#6519)

Updated the link to the testing dashboard and clarified the repository reference.
---
 agents/salesagent.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/agents/salesagent.md b/agents/salesagent.md
index 4d8d3646f9..d36a2f69a7 100644
--- a/agents/salesagent.md
+++ b/agents/salesagent.md
@@ -10,7 +10,7 @@ sidebarType: 10
 The Prebid Sales Agent is a server that exposes advertising inventory to AI agents via the Model Context Protocol (MCP) and Agent-to-Agent (A2A) protocol. It is designed to integrate with ad servers like Google Ad Manager and provides tools for managing inventory and campaigns throughout their lifecycle.
 
 <div class="alert alert-info" role="alert">
-  For the full source code and latest updates, visit the <a href="https://github.com/prebid/salesagent">prebid/salesagent repository</a>.
+  Please see our Prebid Salesagent <a href="https://main.d1tyvbf1at6iao.amplifyapp.com">testing dashboard</a> for feature and schema testing coverage or visit the <a href="https://github.com/prebid/salesagent">salesagent repository</a>.
 </div>
 
 ## Key Features

From 2023e4134298a2f5a42d495b6390c7cbf46ad194 Mon Sep 17 00:00:00 2001
From: KushAdsolut <105729243+KushAdsolut@users.noreply.github.com>
Date: Fri, 10 Apr 2026 01:46:32 +0530
Subject: [PATCH 534/665] New adapter - Playstream (#6454)

* New adapter - Playstream

* update Playstream bidder documentation: add missing gvl_id and remove deprecated params

* add missing line break in Playstream bidder documentation

---------

Co-authored-by: Yash Chotaliya <yashc@adsolut.in>
---
 dev-docs/bidders/playstream.md | 137 +++++++++++++++++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100644 dev-docs/bidders/playstream.md

diff --git a/dev-docs/bidders/playstream.md b/dev-docs/bidders/playstream.md
new file mode 100644
index 0000000000..5523c651c9
--- /dev/null
+++ b/dev-docs/bidders/playstream.md
@@ -0,0 +1,137 @@
+---
+layout: bidder
+title: Playstream Media
+description: Prebid.js Playstream Media Bid Adapter
+biddercode: playstream
+pbjs: true
+media_types: video, banner
+multiformat_supported: will-bid-on-one
+userIds: all
+fpd_supported: true
+tcfeu_supported: true
+gvl_id: 1524
+usp_supported: some
+coppa_supported: some
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: some
+floors_supported: true
+sidebarType: 1
+---
+
+## Description
+
+**Playstream Media** Prebid.js adapter supports **banner** and **video** demand using an **OpenRTB 2.x** request/response flow.
+
+The adapter sends a **POST** request to:
+
+- `https://<host>/server/adserver/hb?adUnitId=<adUnitId>&publisherId=<publisherId>`
+
+> Note: `host` should be a hostname only (no protocol, no path). The adapter uses HTTPS.
+>
+> Note: `getUserSyncs()` currently returns an empty array (no user sync pixels are triggered by this adapter).
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name            | Scope    | Description                                                              | Example                        | Type     |
+|:----------------|:---------|:-------------------------------------------------------------------------|:-------------------------------|:---------|
+| `host`          | required | Playstream bidder host (hostname only; no protocol/path)                 | `'exchange.ortb.net'`          | `string` |
+| `adUnitId`      | required | adUnit ID from Playstream Platform                                       | `'697871ac0ec1c6100e1f9121'`   | `string` |
+| `publisherId`   | required | Publisher ID from Playstream Platform                                    | `'697871ac0ec1c6100e1f9122'`   | `string` |
+| `type`          | required | Type of request: `'video'` or `'banner'`                                 | `'banner'`                     | `string` |
+| `price`         | optional | Bid floor in `USD` only (defaults to Playstream dashboard configuration) | `0.5`                          | `number` |
+| `ip`            | optional | User IP (targeting)                                                      | `'192.168.1.1'`                | `string` |
+| `maxAdDuration` | optional | Max ad pod duration (seconds)                                            | `120`                          | `number` |
+| `maxSlotPerPod` | optional | Max ad slots per pod                                                     | `3`                            | `number` |
+
+## Required Params
+
+Playstream Media client-side Prebid.js adapter requires only:
+
+- `host`
+- `adUnitId`
+- `publisherId`
+- `type`
+
+## Supported Media Types
+
+This adapter supports only:
+
+- `banner`
+- `video`
+
+It does **not** support `native` or `audio`.
+
+## First Party Data and User IDs
+
+- **FPD (First Party Data):** When available, the adapter forwards `bidderRequest.ortb2` and impression-level `bidRequest.ortb2Imp` into the OpenRTB request (`site/app/user/device/regs/ext`).
+- **User IDs:** If your Prebid build includes User ID modules, their EIDs typically appear under `ortb2.user.ext.eids` and are forwarded in the OpenRTB request.
+
+## Privacy Support Notes
+
+- **TCF-EU (GDPR):** If Prebid populates consent into `ortb2.regs` / `ortb2.user.ext.consent`, the adapter forwards it.
+- **USP/CCPA & COPPA:** If these signals are present in `ortb2.regs` (or related fields), they will be forwarded as part of the OpenRTB request.
+
+## schain Support
+
+If the `schain` module is enabled in Prebid, the adapter forwards supply chain information in the OpenRTB request (typically `source.ext.schain`).
+
+## Sample Bids
+
+### Display
+
+Replace the values below with the Host / Ad Unit ID / Publisher ID shared by the Admin/Support team. Do not use the sample IDs in production.
+
+```javascript
+var adUnits = [
+    {
+        code: 'div-1',
+        mediaTypes: {
+            banner: { 
+                sizes: [[300, 250], [728, 90]]
+            }
+        },
+        sizes: [[300, 250], [728, 90]],
+        bids: [{
+            bidder: 'playstream',
+            params: {
+                host: 'asia-southeast.ortb.net',            // Provided by Admin/Support team
+                adUnitId: '697871ac0ec1c6100e1f9121',       // Provided by Admin/Support team
+                publisherId: '697871ac0ec1c6100e1f9122',    // Provided by Admin/Support team
+                type: 'banner',
+            }
+        }]
+    }
+];
+```
+
+### Video
+
+Replace the values below with the Host / Ad Unit ID / Publisher ID shared by the Admin/Support team. Do not use the sample IDs in production.
+
+```javascript
+var adUnits = [
+    {
+        code: 'div-2',
+        mediaTypes: {
+            video: {
+                context: 'instream',
+                playerSize: [640, 360]
+            }
+        },
+        sizes: [640, 360],
+        bids: [{
+            bidder: 'playstream',
+            params: {
+                host: 'asia-southeast.ortb.net',            // Provided by Admin/Support team
+                adUnitId: '697871ac0ec1c6100e1f9121',       // Provided by Admin/Support team
+                publisherId: '697871ac0ec1c6100e1f9122',    // Provided by Admin/Support team
+                type: 'video',
+                price: 0.4
+            }
+        }]
+    }
+];
+```

From 876b7fd6dbcaef75869d61acbcf10b4b553f91a8 Mon Sep 17 00:00:00 2001
From: Postindustria <oss@postindustria.com>
Date: Fri, 10 Apr 2026 03:19:16 +0300
Subject: [PATCH 535/665] Documentation for Next-Gen SDK support (#6510)

* Documentation for Next-Gen SDK support

- Add documentation for prebid-rendering integration
- Add documentation for original api integration

* Fix linter error

- Add trailing new line in android-sdk-integration-nextgen
- Fix tables

* Fix

Fix

* Comment tables to pass lint

* Disable MD058 lint check

* Update inner next-gen docs references
---
 .markdownlint.json                            |   3 +-
 _data/sidebar.yml                             |  16 +
 .../mobile/intro-nextgen-bidding-only.md      | 115 ++++++
 .../mobile/intro-nextgen-prebid-rendered.md   | 125 +++++++
 .../android-sdk-integration-nextgen.md        | 344 ++++++++++++++++++
 ...id-sdk-integration-nextgen-original-api.md |  66 ++++
 .../nextgen-bidding-only-html-banner.md       | 138 +++++++
 ...extgen-bidding-only-interstitial-banner.md |  88 +++++
 ...nextgen-bidding-only-interstitial-video.md | 116 ++++++
 ...n-bidding-only-multiformat-interstitial.md |  81 +++++
 .../nextgen-bidding-only-multiformat.md       | 267 ++++++++++++++
 .../nextgen-bidding-only-native-in-app.md     | 262 +++++++++++++
 .../nextgen-bidding-only-native-in-webview.md | 169 +++++++++
 .../nextgen-bidding-only-rewarded-video.md    | 101 +++++
 .../nextgen-bidding-only-video-outstream.md   | 121 ++++++
 15 files changed, 2011 insertions(+), 1 deletion(-)
 create mode 100644 _includes/mobile/intro-nextgen-bidding-only.md
 create mode 100644 _includes/mobile/intro-nextgen-prebid-rendered.md
 create mode 100644 prebid-mobile/modules/rendering/android-sdk-integration-nextgen.md
 create mode 100644 prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-html-banner.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-banner.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-video.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat-interstitial.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-app.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-webview.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-rewarded-video.md
 create mode 100644 prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-video-outstream.md

diff --git a/.markdownlint.json b/.markdownlint.json
index ef360a2bf6..2db5196efd 100644
--- a/.markdownlint.json
+++ b/.markdownlint.json
@@ -6,5 +6,6 @@
     "MD024": false,
     "MD025": false,
     "MD033": false,
-    "MD036": false
+    "MD036": false,
+    "MD058": false
 }
diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index 4b5d6df225..deaa1c05f1 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -912,6 +912,22 @@
   sectionTitle:
   subgroup: 3
 
+- sbSecId: 2
+  title: Google Next-Gen SDK Bidding-Only Integration
+  link: /prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 3
+
+- sbSecId: 2
+  title: Google Next-Gen SDK Prebid-Rendered Integration
+  link: /prebid-mobile/modules/rendering/android-sdk-integration-nextgen.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 3
+
 - sbSecId: 2
   title: AdMob
   link: /prebid-mobile/modules/rendering/android-sdk-integration-admob.html
diff --git a/_includes/mobile/intro-nextgen-bidding-only.md b/_includes/mobile/intro-nextgen-bidding-only.md
new file mode 100644
index 0000000000..6d1476f440
--- /dev/null
+++ b/_includes/mobile/intro-nextgen-bidding-only.md
@@ -0,0 +1,115 @@
+## Overview
+
+This how-to guide covers the original approach for integrating the Prebid SDK into your app with the Google Next-Gen Mobile Ads SDK. It utilizes:
+
+- **Prebid SDK** and **Prebid server** to handle the bidding and auction process.
+- **GAM** and the **Google Next-Gen Mobile Ads SDK** manage the ad inventory and select the winning ad to display.
+- **Prebid Universal Creative** renders display ads when a Prebid bid wins.
+- **Next-Gen SDK** renders banner and non-instream ads when a Prebid bid wins.
+
+If you do not have the Next-Gen Mobile Ads SDK in the app, refer to the [Google Integration Documentation](https://developers.google.com/admob/{{include.platform}}/next-gen/quick-start).
+
+### Alternative Approaches
+
+Another way to integrate Next-Gen SDK into your app is with the [Prebid-Rendered Integration](/prebid-mobile/modules/rendering/{{include.platform}}-sdk-integration-nextgen.html).
+
+Tradeoffs between these integration approaches:
+
+{: .table .table-bordered .table-striped }
+| Aspect | Bidding-Only Integration | Prebid-Rendered Integration |
+| --- |:---:|:---:|
+| App code has direct access to bids | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Support for MRAID 3.0 | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| Support for SKAdnetwork | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| Loads data from Prebid Cache | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Triggers billing and Notice URLs | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Supports Third Party Rendering libraries | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+
+**Notes:**
+
+- On one hand, using Prebid Cache reduces the amount of data that must be sent to the mobile device -- the body of the creative does not need to be transmitted for bids. On the other hand, though, when a bid wins in the ad server, the body of the creative must be retrieved from the cache.
+- It is possible to mix-and-match implementations within an app. e.g. you could implement instream video with the Bidding-Only approach and other adunits with Prebid-Rendered.
+
+### Prerequisites
+
+The Next-Gen SDK Bidding-Only Integration method assumes that you have the following components:
+
+- **Google Ad Manager Account** - A GAM account allows you to manage and serve ads within your mobile app. Within this account you'll need to configure your inventory and create orders for serving ads within your app. This involves defining ad units (spaces within your app where ads will be displayed) and setting up orders and line items to deliver ads to those units. See [Prebid's AdOps Guide](/adops/before-you-start.html) for more information.
+- **Google Next-Gen Mobile Ads SDK** - This refers to the software development kit provided by Google. You need to ensure that you have the latest version of the Next-Gen Mobile Ads SDK supported by Prebid SDK. This SDK integration is necessary to communicate with the ad server and display ads in your app.
+- **Prebid SDK** - You will need the latest version of the Prebid Mobile SDK for either [Android](/prebid-mobile/pbm-api/android/code-integration-android.html) or [iOS](/prebid-mobile/pbm-api/ios/code-integration-ios.html).
+- **Prebid Universal Creative** - This needs to be hosted on a CDN and loaded from the creative in GAM as detailed in the [AdOps GAM creative reference](/adops/gam-creative-banner-sbs.html#prebid-universal-creative).
+- **Prebid Server** - You will need a cluster of servers running [Prebid Server](/prebid-server/use-cases/pbs-sdk.html). You can set up your own Prebid Server or work with a [Prebid Server managed service](https://prebid.org/managed-services/). Prebid Server provides you with the following:
+  - Configuration storage - rather than hardcoding all the details of your current business arrangements in the app, Prebid Server stores which bidders you're currently working with, their inventory details, and other settings that can be changed without updating your app.
+  - Server-side auction - the server will make the connections to multiple auction bidding partners so the app doesn't have to.
+  - Creative caching - Prebid Cache stores the creatives until the app needs to render them, reducing the auction response bandwidth.
+  - Privacy regulation tools - the server can help your legal team meet different regulatory needs in different jurisdictions by configuring various protocols and anonyimization activities.
+
+## How it Works
+
+Here's how the ad bidding-auction-rendering process works in this integration scenario.
+
+![Next-Gen Bidding Only Integration Details](/assets/images/prebid-mobile/mobile-details-gam-bidding-only.png)
+
+1. Prebid SDK calls Prebid Server which supplies one or more bids.
+1. PBSDK adds targeting values to Next-Gen SDK.
+1. Next-Gen SDK calls GAM, which makes the ad decision.
+1. If a 3rd party HTML creative is chosen (banner or interstitial):
+    1. Next-Gen SDK writes the HTML to a webview, loading the Prebid Universal Creative (PUC).
+    1. The PUC loads the winning creative from Prebid Cache.
+    1. The PUC writes this creative into an iframe and hits all the tracking strings: Prebid win URL, billing url (burl), and notice url (nurl).
+        1. If MRAID is available, it is used to consider the view state before hitting the burl.
+1. If a video VastUrl creative is chosen:
+    1. The Next-Gen SDK uses the platform video player which loads the VAST from Prebid Cache.
+    1. It then starts playing the VAST, hitting the embedded Impression tags when appropriate.
+1. If an In-App Native format is chosen:
+    1. Next-Gen SDK delegates the rendering of native to the App and PBSDK when a special signal is specified.
+    1. The app code gets the native assets from PBSDK. The app is coded to render the ad.
+        1. PBSDK fires the eventtrackers when appropriate.
+        1. The PBS win event is fired.
+1. The Next-Gen SDK handles Open Measurement SDK interactions.
+
+## Major Integration Steps
+
+Assuming your app already has AdUnits integrated with the Next-Gen Mobile Ads SDK, the technical implementation of Prebid mobile into your app will involve these major steps:
+
+1. [Initialize the Prebid SDK](/prebid-mobile/pbm-api/{{include.platform}}/code-integration-{{include.platform}}.html) - create a connection to your Prebid Server.
+2. [Set Global Parameters](/prebid-mobile/pbm-api/{{include.platform}}/pbm-targeting-{{include.platform}}.html) - let bidders know important data about the page, privacy consent, and other settings.
+3. Work with your Prebid Server team to create the adunit configIds that will be used in the app.
+4. Set up GAM orders, line items, and creatives. See [AdOps guidance](#ad-operations-guidance)
+5. Link Prebid AdUnit code to your Next-Gen SDK AdUnits - for any adunits that your business team wants to connect to Prebid with the configIds generated in Step 3. See the [adunit-specific instructions](#adunit-specific-instructions) below.
+
+## Ad Operations Guidance
+
+The Ad Operations team will need to create line items in GAM. The creatives used depend on which media formats your adunits utilize.
+
+{: .table .table-bordered .table-striped }
+| AdUnit Format | Line Item Targeting | Creative Type | Prebid Cache? | Ad Ops Details |
+| --- | --- | --- | --- | --- |
+| HTML banner, interstitial banner | hb_pb<br/>hb_format=banner | 3rd party HTML that loads the [PUC](/overview/prebid-universal-creative.html) | yes | [link](/adops/gam-creative-banner-sbs.html) |
+| Video (instream, non-instream, interstitial) | hb_pb<br/>hb_format=video<br/>inventoryType in (instream, mobile app) | VastUrl pointing to Prebid Cache | yes | [link](/adops/setting-up-prebid-video-in-dfp.html) |
+| Rewarded Video | hb_pb<br/>hb_format=video<br/>inventoryType in (instream, mobile app)<br/>rewarded adunits | VastUrl pointing to Prebid Cache | yes | [link](/adops/setting-up-prebid-video-in-dfp.html) |
+| In-app native | hb_pb<br/>hb_format=native | GAM native | no | [link](/adops/gam-native.html#create-a-new-native-creative) |
+| In-Webview native | hb_pb<br/>hb_format=native | 3rd party HTML that loads the native-trk script. | yes | [link](/adops/gam-native.html) |
+
+Notes:
+
+- You may need up to 4 sets of line items to support Prebid Mobile depending on adunit types. If you also run Prebid.js or AMP, please see [line item considerations](/adops/line-item-creation.html) for more information.
+- Discuss the Prebid Cache column with the Prebid Server team. They can set up the "top-level stored request" for your account to cache or not cache requests as needed.
+
+### Rendering and Tracking
+
+This information may be useful when comparing data across various reporting systems:
+
+{: .table .table-bordered .table-striped }
+| Scenario | PUC | VastUrl Creative | GAM Native Creative |
+| --- | --- | --- | --- |
+| Rendering Method | PUC in iframe | Next-Gen SDK player | App code with data from PBSDK |
+| Fires Prebid win event | always | never | always |
+| Fires Prebid imp event | never | VAST impression tag | never |
+| Fires OpenRTB burl | when in view | n/a | never (1) |
+| Fires OpenRTB nurl | always |  n/a | always |
+| Fires OpenMeasurement events | Next-Gen SDK |  n/a | PB SDK |
+
+Notes:
+
+1. OpenRTB burl and nurl will be utilized in a future release.
diff --git a/_includes/mobile/intro-nextgen-prebid-rendered.md b/_includes/mobile/intro-nextgen-prebid-rendered.md
new file mode 100644
index 0000000000..e6e51190d7
--- /dev/null
+++ b/_includes/mobile/intro-nextgen-prebid-rendered.md
@@ -0,0 +1,125 @@
+## Overview
+
+This how-to guide covers the 'Prebid-Rendered' approach for integrating the Prebid SDK into your app with the Google Next-Gen Mobile Ads SDK. It utilizes:
+
+- **Prebid SDK** and **Prebid server** to handle the bidding and auction process.
+- **GAM** and the **Google Next-Gen Mobile Ads SDK** manage the ad inventory and select the winning ad to display.
+- **Prebid SDK** renders display ads when a Prebid bid wins.
+- **Next-Gen SDK** renders ads when a Prebid bid wins.
+
+If you do not have the Next-Gen Mobile Ads SDK in the app yet, refer to the [Google Integration Documentation](https://developers.google.com/admob/{{include.platform}}/next-gen/quick-start).
+
+### Alternative Approaches
+
+Another way to integrate Next-Gen SDK into your app is with the [Next-Gen SDK Bidding-Only integration](/prebid-mobile/pbm-api/{{include.platform}}/{{include.platform}}-sdk-integration-nextgen-original-api.html).
+
+Tradeoffs between these integration approaches:
+
+{: .table .table-bordered .table-striped }
+| Aspect | Bidding-Only Integration | Prebid-Rendered Integration |
+| --- |:---:|:---:|
+| App code has direct access to bids | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Support for MRAID 3.0 | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| Support for SKAdnetwork | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+| Loads data from Prebid Cache | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Triggers billing and Notice URLs | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> | |
+| Supports Third Party Rendering libraries | | <img alt="check" src="/assets/images/icons/icon-check-green.png" width="30"> |
+
+**Notes:**
+
+- On one hand, using Prebid Cache reduces the amount of data that must be sent to the mobile device -- the body of the creative does not need to be transmitted for bids. On the other hand, though, when a bid wins in the ad server, the body of the creative must be retrieved from the cache.
+- It is possible to mix-and-match implementations within an app. e.g. you could implement instream video with the Bidding-Only approach and other adunits with Prebid-Rendered.
+
+### Prerequisites
+
+The Next-Gen SDK Prebid-Rendered Integration method assumes that you have the following components:
+
+- **Google Ad Manager Account** - A GAM account allows you to manage and serve ads within your mobile app. Within this account you'll need to configure your inventory and create orders for serving ads within your app. This involves defining ad units (spaces within your app where ads will be displayed) and setting up orders and line items to deliver ads to those units. See [Prebid's AdOps Guide](/adops/before-you-start.html) for more information.
+- **Google Next-Gen Mobile Ads SDK** - This refers to the software development kit provided by Google. You need to ensure that you have the latest version of the Next-Gen Mobile Ads SDK supported by Prebid SDK. This SDK integration is necessary to communicate with the ad server and display ads in your app.
+- **Prebid SDK** - You will need the latest version of the Prebid Mobile SDK for either [Android](/prebid-mobile/pbm-api/android/code-integration-android.html) or [iOS](/prebid-mobile/pbm-api/ios/code-integration-ios.html).
+- **Prebid Server** - You will need a cluster of servers running [Prebid Server](/prebid-server/use-cases/pbs-sdk.html). You can set up your own Prebid Server or work with a [Prebid Server managed service](https://prebid.org/managed-services/). Prebid Server provides you with the following:
+  - Configuration storage - rather than hardcoding all the details of your current business arrangements in the app, Prebid Server stores which bidders you're currently working with, their inventory details, and other settings that can be changed without updating your app.
+  - Server-side auction - the server will make the connections to multiple auction bidding partners so the app doesn't have to.
+  - Privacy regulation tools - the server can help your legal team meet different regulatory needs in different jurisdictions by configuring various protocols and anonyimization activities.
+
+## How it Works
+
+Here's how the ad bidding-auction-rendering process works in this integration scenario.
+
+![Next-Gen Prebid-Rendered Integration Details](/assets/images/prebid-mobile/mobile-details-gam-prebid-rendered.png)
+
+1. Prebid SDK calls Prebid Server which supplies one or more bids.
+1. PBSDK adds targeting values to Next-Gen SDK.
+1. Next-Gen SDK calls GAM, which makes the ad decision.
+1. If a 3rd party HTML creative is chosen (banner, native, interstitial, non-instream video):
+    1. Next-Gen SDK writes HTML to a webview, loading google_mobile_app_ads.js.
+    1. This script triggers a "PrebidAppEvent".
+    1. Which in turn triggers PBSDK to handle the rendering of the creative:
+        1. PBSDK fires the Prebid Server win event.
+        1. If a 3rd party rendering SDK is in use, PBSDK calls it for rendering.
+        1. Otherwise, it writes the creative into an iframe into an internal WebView, replaceing the Next-Gen SDK's WebView.
+            1. Injects mraid.js into the webview to listen for events from MRAID: change size, etc.
+            1. Sends data to the creative (e.g. 'viewable') which may trigger impression tracking within the creative.
+            1. Starting from v3.0.0, the SDK hits the billing and notice urls (burl and nurl).
+1. If a video VastUrl creative is chosen (rewarded video only):
+    1. The Next-Gen SDK uses the platform video player which loads the special VAST file from the Prebid CDN.
+    1. Prebid SDK watches VAST events for "<AdTitle>PrebidAppEvent</AdTitle>". When it sees this, it takes over the rendering:
+        1. PBSDK fires the PBS win event. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
+        1. If the response indicates a 3rd party rendering SDK, PBSDK will call it.
+        1. Otherwise:
+            1. PDBSK renders with the platform-standard VAST player.
+            1. It uses the VAST from the bid response, not from Prebid Cache.
+            1. The player fires any Impression tags in the VAST.
+            1. PBSDK handles MRAID events.
+            1. The app is called to handle the reward.
+1. If an In-App Native format is chosen:
+    1. The Next-Gen SDK delegates the rendering of native to the App and PBSDK when a special signal is specified.
+    1. The app code gets the native assets from PBSDK. The app is coded to render the ad.
+        1. PBSDK fires the eventtrackers when appropriate.
+        1. The PBS win event is fired. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
+1. Open Measurement events are handled directly by the Prebid SDK.
+    1. If a 3rd party rendering SDK is used to render, then it will handle Open Measurement.
+
+## Major Integration Steps
+
+Assuming your app already has AdUnits integrated with the Next-Gen Mobile Ads SDK, the technical implementation of Prebid mobile into your app will involve these major steps:
+
+1. [Initialize the Prebid SDK](/prebid-mobile/pbm-api/{{include.platform}}/code-integration-{{include.platform}}.html) - create a connection to your Prebid Server.
+2. [Set Global Parameters](/prebid-mobile/pbm-api/{{include.platform}}/pbm-targeting-{{include.platform}}.html) - let bidders know important data about the page, privacy consent, and other settings.
+3. Work with your Prebid Server team to create the adunit configIds that will be used in the app.
+4. Set up GAM orders, line items, and creatives. See [AdOps guidance](#ad-operations-guidance)
+5. Link Prebid AdUnit code to your Next-Gen SDK AdUnits - for any adunits that your business team wants to connect to Prebid with the configIds generated in Step 3. See the [adunit-specific instructions](#adunit-specific-instructions) below.
+
+## Ad Operations Guidance
+
+The AdOps team will need to create line items in GAM. The creatives used depend on which media formats your adunits utilize:
+
+{: .table .table-bordered .table-striped }
+| AdUnit Format | Line Item Targeting | Creative Type | Prebid Cache? | Ad Ops Details |
+| --- | --- | --- | --- | --- |
+| HTML banner, interstitial banner or video, non-instream video | hb_pb<br/>hb_format=banner | 3rd party HTML that loads google_mobile_app_ads.js | no | [link](/adops/mobile-rendering-gam-line-item-setup.html#third-party-html) |
+| Rewarded Video | hb_pb<br/>hb_format=video<br/>inventoryType in (instream, mobile app)<br/>rewarded adunits | VastUrl pointing to prebid-mobile-rewarded-vast.xml | no | [link](/adops/mobile-rendering-gam-line-item-setup.html#rewarded-video) |
+| In-app native | hb_pb<br/>hb_format=native | GAM native | no | [link](/adops/gam-native.html#create-a-new-native-creative) |
+
+Notes:
+
+- You may need up to 4 sets of line items to support Prebid Mobile depending on adunit types. If you also run Prebid.js or AMP, please see [line item considerations](/adops/line-item-creation.html) for more information.
+- Discuss the Prebid Cache column with the Prebid Server team. They can set up the "top-level stored request" for your account to cache or not cache requests as needed.
+
+### Rendering and Tracking
+
+This information may be useful when comparing data across various reporting systems:
+
+{: .table .table-bordered .table-striped }
+| Scenario | 3pHTML Creative | VastUrl Creative | GAM Native Creative |
+| --- | --- | --- | --- |
+| Rendering Method | js in iframe fires an event | Next-Gen SDK player | App code with data from PBSDK |
+| Fires Prebid win event | always | never | always |
+| Fires Prebid imp event | always | VAST impression tag | never |
+| Fires OpenRTB burl | always (1) | n/a | never |
+| Fires OpenRTB nurl | always (1) |  n/a | never |
+| Fires OpenMeasurement events | PBSDK |  n/a | PBSDK |
+
+Notes:
+
+1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.
diff --git a/prebid-mobile/modules/rendering/android-sdk-integration-nextgen.md b/prebid-mobile/modules/rendering/android-sdk-integration-nextgen.md
new file mode 100644
index 0000000000..c39732f5c2
--- /dev/null
+++ b/prebid-mobile/modules/rendering/android-sdk-integration-nextgen.md
@@ -0,0 +1,344 @@
+---
+
+layout: page_v2
+title: Prebid Mobile Rendering Google Next-Gen SDK Integration
+description: Prebid Mobile Rendering Modules Google Next-Gen SDK integration
+sidebarType: 2
+
+---
+
+# Prebid SDK Android with the Google Next-Gen SDK Prebid-Rendered Integration Method
+{:.no_toc}
+
+- TOC
+{:toc}
+
+{% include mobile/intro-nextgen-prebid-rendered.md platform="android" %}
+
+## Event Handlers
+
+First, a little bit of setup is needed.
+
+### Integrate Event Handlers
+
+The Prebid SDK supplies a set of classes called the 'Next-Gen Event Handlers' that wrap the Next-Gen Ad Views and manage them in the In-App Bidding flow. These classes are provided in the form of a library that can be added to the app via Gradle:
+
+Root `build.gradle`:
+
+```text
+allprojects {
+    repositories {
+      ...
+      mavenCentral()
+      ...
+    }
+}
+```
+
+App module `build.gradle`:
+
+```text
+implementation('org.prebid:prebid-mobile-sdk-next-gen-event-handlers:x.x.x')
+```
+
+### Initialize the Google Next-Gen Mobile Ads SDK
+
+Initialize the Next-Gen SDK early in your app lifecycle (e.g., in `Application.onCreate()`):
+
+```kotlin
+val backgroundScope = CoroutineScope(Dispatchers.IO)
+backgroundScope.launch {
+    MobileAds.initialize(
+        context,
+        InitializationConfig.Builder("YOUR_APP_ID").build()
+    ) {
+        // Initialization complete
+    }
+}
+```
+
+## AdUnit-Specific Instructions
+
+This section covers integration details for different ad formats. In each scenario, you'll be asked for a `configId` - this is a key worked out with your Prebid Server provider. It's used at runtime to pull in the bidders and parameters specific to this adunit. Depending on your Prebid Server partner, it may be a UUID or constructed out of parts like an account number and adunit name.
+
+### Banners
+
+#### Display Banners
+
+To integrate the banner ad you need to implement three easy steps:
+
+```kotlin
+// 1. Create a banner custom event handler for the Next-Gen SDK.
+val eventHandler = NextGenBannerEventHandler(requireContext(), NEXT_GEN_AD_UNIT_ID, AdSize(WIDTH, HEIGHT))
+
+// 2. Create a bannerView instance and provide the Next-Gen event handler
+bannerView = BannerView(requireContext(), configId, eventHandler)
+// (Optional) set an event listener
+bannerView?.setBannerListener(this)
+
+// Add bannerView to your viewContainer
+viewContainer?.addView(bannerView)
+
+// 3. Execute the loadAd function.
+bannerView?.loadAd()
+```
+
+{% capture warning_note %}
+Pay attention that the `loadAd()` should be called on the main thread.
+{% endcapture %}
+{% include /alerts/alert_warning.html content=warning_note %}
+
+##### Step 1: Create Event Handler
+{:.no_toc}
+
+Prebid SDK's Next-Gen event handlers are special containers that wrap Next-Gen Ad Views and help to manage collaboration between the Next-Gen SDK and Prebid views.
+
+**Important:** you should create and use a unique event handler for each ad view.
+
+To create the event handler you should provide a Next-Gen Ad Unit Id and one or more `AdSize` instances for this ad unit.
+
+##### Step 2: Create Ad View
+{:.no_toc}
+
+**BannerView** - is the view that will display a particular ad. It should be added to the UI. To create it you should provide:
+
+- **configId** - an ID of a [Stored Impression](/prebid-server/features/pbs-storedreqs.html) on the Prebid server
+- **eventHandler** - the instance of the Next-Gen banner event handler
+
+Also, you should add the instance of `BannerView` to the UI.
+
+And assign the listeners for processing ad events.
+
+##### Step 3: Load the Ad
+{:.no_toc}
+
+Call the `loadAd()` method to make a bid request.
+
+#### Non-Instream Video
+{:.no_toc}
+
+For **Non-Instream Video** you also need to specify the video placement type of the expected ad:
+
+```kotlin
+bannerView.videoPlacementType = PlacementType.IN_BANNER // or any other available type
+```
+
+#### Migrating banners from a Bidding-Only integration
+
+Next-Gen SDK setup:
+
+1. Leave the original order and ad units as is. They are not relevant for the rendering approach but they will serve ads for released applications.
+2. Create new Next-Gen SDK ad unit.
+3. Setup new [GAM Order](/adops/mobile-rendering-gam-line-item-setup.html) for rendering approach.
+
+Integration:
+
+1. Replace the `AdView` with `BannerView` in the UI.
+2. Implement the interface `BannerViewListener`.
+3. Remove both `AdView` and `BannerAdRequest`.
+4. Remove the original `BannerAdUnit`.
+5. Follow the instructions to integrate [Banner API](#banners).
+
+### Interstitials
+
+To integrate an interstitial ad follow these steps:
+
+```kotlin
+// 1. Create an interstitial custom event handler for the Next-Gen SDK.
+val eventHandler = NextGenInterstitialEventHandler(requireContext(), nextGenAdUnitId)
+
+// 2. Create an interstitialAdUnit instance and provide the Next-Gen event handler
+interstitialAdUnit = InterstitialAdUnit(requireContext(), configId, eventHandler)
+// (Optional) for multiformat, specify the ad unit formats
+// interstitialAdUnit = InterstitialAdUnit(requireContext(), configId, EnumSet.of(AdUnitFormat.BANNER, AdUnitFormat.VIDEO), eventHandler)
+
+// (Optional) set an event listener
+interstitialAdUnit?.setInterstitialAdUnitListener(this)
+
+// 3. Execute the loadAd function.
+interstitialAdUnit?.loadAd()
+
+//....
+
+// 4. After the ad is loaded you can execute the `show` function to trigger ad display
+interstitialAdUnit?.show()
+```
+
+{% capture warning_note %}
+Pay attention that the `loadAd()` should be called on the main thread.
+{% endcapture %}
+{% include /alerts/alert_warning.html content=warning_note %}
+
+In order to make a `multiformat bid request`, set the respective values into the `adUnitFormats` parameter:
+
+```kotlin
+interstitialAdUnit = InterstitialAdUnit(
+                        requireContext(),
+                        configId,
+                        EnumSet.of(AdUnitFormat.BANNER, AdUnitFormat.VIDEO),
+                        eventHandler)
+```
+
+#### Step 1: Create Event Handler
+{:.no_toc}
+
+Next-Gen's event handlers are special containers that wrap the Next-Gen Ad Views and help to manage collaboration between the Next-Gen SDK and Prebid views.
+
+**Important:** you should create and use a unique event handler for each ad view.
+
+To create an event handler you should provide a Next-Gen Ad Unit ID.
+
+#### Step 2: Create Interstitial Ad Unit
+{:.no_toc}
+
+**InterstitialAdUnit** - is an object that will load and display a particular ad. To create it you should provide:
+
+- **configId** - an ID of a [Stored Impression](/prebid-server/features/pbs-storedreqs.html) on the Prebid server
+- **minSizePercentage** - specifies the minimum width and height percent an ad may occupy of a device’s screen.
+- **eventHandler** - the instance of the Next-Gen interstitial event handler
+
+Also, you can assign the listeners for processing ad events.
+
+> **NOTE:** minSizePercentage - plays an important role in a bidding process for display ads. If the provided space is too small demand partners won't respond with bids.
+
+#### Step 3: Load the Ad
+{:.no_toc}
+
+Call the `loadAd()` method to make a bid request. The ad unit will load an ad and will wait for explicit instructions to display the Interstitial Ad.
+
+#### Step 4: Show the Ad when it is ready
+{:.no_toc}
+
+The most convenient way to determine if the interstitial ad is ready for displaying is to listen to the listener method:
+
+```kotlin
+override fun onAdLoaded(interstitialAdUnit: InterstitialAdUnit) {
+    //Ad is ready for display
+    interstitialAdUnit.show()
+}
+```
+
+#### Migrating interstitials from a Bidding-Only integration
+
+Next-Gen SDK setup:
+
+1. Leave the original order and ad units as is. They are not relevant for the rendering approach but they will serve ads for released applications.
+2. Create a new Next-Gen SDK ad unit.
+3. Setup a new [GAM Order](/adops/mobile-rendering-gam-line-item-setup.html) for rendering approach.
+
+Integration:
+
+1. Replace the `InterstitialAd` with `InterstitialAdUnit`.
+2. Implement the interface for `InterstitialAdUnitListener`.
+3. Remove both `InterstitialAd` and `AdRequest`.
+4. Follow the instructions to integrate [Interstitial API](#interstitials).
+
+### Rewarded
+
+{% include mobile/rewarded-server-side-configuration.md %}
+
+#### Integration Example
+
+Displaying the **Rewarded Ad** is the same as displaying an Interstitial Ad, but it adds the ability to handle a reward. To display a Rewarded Ad follow these steps:
+
+```kotlin
+// 1. Create a rewarded custom event handler for the Next-Gen SDK.
+val eventHandler = NextGenRewardedEventHandler(requireActivity(), nextGenAdUnitId)
+
+// 2. Create a rewardedAdUnit instance and provide the Next-Gen event handler
+rewardedAdUnit = RewardedAdUnit(requireContext(), configId, eventHandler)
+
+// You can also set an event listener, this step is optional.
+rewardedAdUnit?.setRewardedAdUnitListener(this)
+
+// 3. Execute the loadAd function.
+rewardedAdUnit?.loadAd()
+
+//...
+
+// 4. After the ad is loaded you can execute the `show` function to display the ad.
+rewardedAdUnit?.show()
+```
+
+{% capture warning_note %}
+Pay attention that the `loadAd()` should be called on the main thread.
+{% endcapture %}
+{% include /alerts/alert_warning.html content=warning_note %}
+
+##### Step 1: Create Event Handler
+{:.no_toc}
+
+Next-Gen's event handlers are special containers that wrap the Next-Gen Ad Views and help to manage collaboration between the Next-Gen SDK and Prebid views.
+
+**Important:** you should create and use a unique event handler for each ad view.
+
+To create an event handler you should provide a Next-Gen Ad Unit ID.
+
+##### Step 2: Create Rewarded Ad Unit
+{:.no_toc}
+
+**RewardedAdUnit** - is an object that will load and display the particular ad. To create it you should provide:
+
+- **configId** - is an ID of a [Stored Impression](/prebid-server/features/pbs-storedreqs.html) on the Prebid server
+- **eventHandler** - is the instance of the Next-Gen rewarded event handler
+
+You can also assign the listener for processing ad events.
+
+##### Step 3: Load the Ad
+{:.no_toc}
+
+Call the `loadAd()` method to make a bid request. The ad unit will load an ad and will wait for explicit instructions to display the Rewarded Ad.
+
+##### Step 4: Display the Ad when it is ready
+{:.no_toc}
+
+The most convenient way to determine if the ad is ready for displaying is to listen for the listener method:
+
+```kotlin
+override fun onAdLoaded(rewardedAdUnit: RewardedAdUnit) {
+    //Ad is ready for display
+    rewardedAdUnit.show()
+}
+```
+
+##### Step 5: Handle a reward
+{:.no_toc}
+
+Handle earning the reward in the appropriate method. Important: a reward can be null.
+
+```kotlin
+override fun onUserEarnedReward(rewardedAdUnit: RewardedAdUnit?, reward: Reward?) {
+    if (reward != null) {
+        val rewardType = reward.type
+        val rewardCount = reward.count
+        val rewardExt = reward.ext
+        // Process the reward
+    }
+}
+```
+
+#### Migrating rewarded video from a Bidding-Only integration
+{:.no_toc}
+
+Next-Gen SDK setup:
+
+1. Leave the original order and ad units as is. They are not relevant for the rendering approach but they will serve ads for released applications.
+2. Create a new Next-Gen SDK ad unit.
+3. Setup a new [GAM Order](/adops/mobile-rendering-gam-line-item-setup.html) for rendering approach.
+
+Integration:
+
+1. Replace the `RewardedAd` with `RewardedAdUnit`.
+2. Implement the interface for `RewardedAdUnitListener`.
+3. Remove the original `RewardedVideoAdUnit`.
+4. Follow the instructions to integrate [Rewarded API](#rewarded).
+
+## Additional Ad Unit Configuration
+
+{% include mobile/rendering-adunit-config-android.md %}
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android Integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Android Global Parameters](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.md b/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.md
new file mode 100644
index 0000000000..bde7a768e4
--- /dev/null
+++ b/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.md
@@ -0,0 +1,66 @@
+---
+layout: page_v2
+title: Prebid Mobile - Next-Gen SDK Bidding-Only Integration - Android
+description: Integration of Prebid SDK Android with Google Next-Gen SDK using the 'Bidding-Only' integration
+sidebarType: 2
+---
+
+# Prebid SDK Android with the Next-Gen SDK Bidding-Only Integration Method
+{:.no_toc}
+
+- TOC
+{:toc}
+
+{% include mobile/intro-nextgen-bidding-only.md platform='android' %}
+
+## AdUnit-Specific instructions
+
+This section describes the integration details for different ad formats. In each scenario, you'll be asked for a `configId` - this is a key established in conjunction with your Prebid Server provider. It's used at runtime to pull in the bidders and parameters specific to this adunit. Depending on your Prebid Server partner, it may be a UUID or constructed out of parts like an account number and adunit name.
+
+### [Format: HTML Banner](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-html-banner.html)
+
+### [Format: Interstitial Banner](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-banner.html)
+
+### [Format: Non-Instream Video](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-video-outstream.html)
+
+### [Format: Interstitial Video](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-video.html)
+
+### [Format: Rewarded Video Ad](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-rewarded-video.html)
+
+### [Format: Native In-App](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-app.html)
+
+### [Format: Native In-Webview](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-webview.html)
+
+### [Format: Multiformat (Banner+Video+InApp Native)](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat.html)
+
+### [Format: Multiformat Interstitial (Banner+Video)](/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat-interstitial.html)
+
+## Additional Ad Unit Configuration
+
+{% include mobile/adunit-config-android.md %}
+
+### Impression tracking
+
+In the Bidding-Only integration scenario, the Prebid SDK is responsible for tracking events for banner ads, like `burl`, `imp`, and `win`. The disadvantage of this approach is that the SDK doesn't have reliable information about the viewability of the WebView. As a result, impression tracking happens at the rendering stage of the ad. Or, if MRAID is supported, once the `viewableChange` event is fired. It leads to big discrepancies since the "1 pixel in view" requirement is not met.
+
+To activate impression tracking for the banner ad unit - use the `activatePrebidImpressionTracker(adView)` method. The `adView` parameter should be an instance of the Next-Gen SDK `AdView`:
+
+```kotlin
+adUnit.activatePrebidImpressionTracker(adView)
+adUnit.fetchDemand(adRequestBuilder) { ... }
+```
+
+For activation for the interstitial ad unit, you should call `activateInterstitialPrebidImpressionTracker()`:
+
+```kotlin
+adUnit = InterstitialAdUnit(CONFIG_ID, WIDTH, HEIGHT)
+adUnit.activateInterstitialPrebidImpressionTracker()
+```
+
+After the invocation of `activateInterstitialPrebidImpressionTracker()`, the Prebid SDK will start analyzing the View Hierarchy and track the viewability of the ad view. Once the ad view is viewable for the user for at least 1 pixel for 1 second, the SDK will track an impression event for the presented ad. The SDK will stop analyzing the View Hierarchy once the caller object is destroyed.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android Integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Android Global Parameters](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-html-banner.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-html-banner.md
new file mode 100644
index 0000000000..a07b6d3280
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-html-banner.md
@@ -0,0 +1,138 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - HTML Banner
+description: Android Next-Gen SDK Bidding-Only Integration - HTML Banner
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - HTML Banner
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Starting with Prebid Mobile `2.1.0` you can use `BannerAdUnit` to bid over the banner and/or video demand. The default ad format is `BANNER`. To customize the bidding format, specify the ad formats in the `BannerAdUnit` constructor.
+
+Integration example:
+
+```kotlin
+private fun createAd() {
+    // 1. Create BannerAdUnit
+    adUnit = BannerAdUnit(CONFIG_ID, WIDTH, HEIGHT)
+    adUnit?.setAutoRefreshInterval(refreshTimeSeconds)
+
+    // 2. Configure banner parameters
+    val parameters = BannerParameters()
+    parameters.api = listOf(Signals.Api.MRAID_3, Signals.Api.OMID_1)
+    adUnit?.bannerParameters = parameters
+
+    // 3. Create Next-Gen SDK AdView
+    val adView = AdView(this)
+    val adSize = AdSize(WIDTH, HEIGHT)
+    adWrapperView.addView(adView)
+
+    // 4. Build the Next-Gen SDK ad request
+    val adRequestBuilder = BannerAdRequest.Builder(AD_UNIT_ID, adSize)
+
+    // 5. Make a bid request to Prebid Server
+    adUnit?.fetchDemand(adRequestBuilder) {
+
+        // 6. Load Next-Gen Ad
+        adView.loadAd(adRequestBuilder.build(), createAdLoadCallback(adView))
+    }
+}
+```
+
+Prebid SDK can be thought of an OpenRTB request synthesizer.  OpenRTB does not have a notion of adaptive banners, but it has a notion of several banner sizes / formats in one request.  So an adaptive banner may be represented as a request containing several banner sizes, e.g. a fixed width that equals the size of the screen and several different heights.  The examples here deal with a single ad size, but more can be added via BannerParameters.adSizes array.
+
+It may be necessary to resize the banner view according to the creative size when multiple ad sizes are supported.  This logic is not needed for a single-size banner:
+
+Next-Gen SDK ad load callback:
+
+```kotlin
+private fun createAdLoadCallback(adView: AdView): AdLoadCallback<BannerAd> {
+    return object : AdLoadCallback<BannerAd>() {
+        override fun onAdLoaded(ad: BannerAd) {
+            super.onAdLoaded(ad)
+
+            // 7. Resize ad view if needed
+            AdViewUtils.findPrebidCreativeSize(adView, object : AdViewUtils.PbFindSizeListener {
+                override fun success(width: Int, height: Int) {
+                    adView.resize(AdSize(width, height))
+                }
+
+                override fun failure(error: PbFindSizeError) {}
+            })
+
+            ad.adEventCallback = object : BannerAdEventCallback {
+                override fun onAdClicked() {
+                    super.onAdClicked()
+                }
+                override fun onAdImpression() {
+                    super.onAdImpression()
+                }
+            }
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed to load: $adError")
+        }
+    }
+}
+```
+
+Notes:
+
+1. In case you use a single-size banner (as opposed to multi-size), i.e. 300x250 - you don't need to call `AdViewUtils.findPrebidCreativeSize` because you already know the size of the creative. However you still need to call `adView.resize()` because the creative has a 1x1 size by default and without this call it will be rendered as a pixel.
+2. Make sure you properly process all possible cases in the `AdViewUtils.findPrebidCreativeSize` callbacks (both success and failure). Sometimes you might not get the size of the creative (or a failure callback) - it simply means that this is not a Prebid creative. It means that you still need to render the creative, but you most likely don't need to resize it.
+
+## Step 1: Create a BannerAdUnit
+{:.no_toc}
+
+Initialize the `BannerAdUnit` with properties:
+
+- `configId` - an ID of the Stored Impression on the Prebid Server
+- `width` - the width of the ad unit which will be used in the bid request.
+- `height` - the height of the ad unit which will be used in the bid request.
+
+## Step 2: Configure banner parameters
+{:.no_toc}
+
+{% include mobile/banner-params.md %}
+
+## Step 3: Create a Next-Gen SDK AdView
+{:.no_toc}
+
+Follow the [Next-Gen SDK documentation](https://developers.google.com/admob/android/next-gen/banner) to integrate a banner ad unit.
+
+## Step 4: Build the Ad Request
+{:.no_toc}
+
+Create a `BannerAdRequest.Builder` with the Next-Gen SDK Ad Unit ID and the desired `AdSize`.
+
+## Step 5: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `BannerAdRequest.Builder` object to this method. Prebid SDK will set the targeting keywords of the winning bid into the provided object. Eventually you should use this object to make an ad request to the Next-Gen SDK.
+
+## Step 6: Load an Ad
+{:.no_toc}
+
+You should now request the ad from the Next-Gen SDK. If the `BannerAdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `BannerAdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain the targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Step 7: Adjust the ad view size
+{:.no_toc}
+
+Once an app receives a signal that an ad is loaded, you should use the method `AdViewUtils.findPrebidCreativeSize` to verify whether it's Prebid's ad and resize the ad slot respectively to the creative's properties.
+
+Notes:
+
+1. In case you use a single-size banner (as opposed to multi-size), e.g. 300x250 - you don't need to call `AdViewUtils.findPrebidCreativeSize` because you already know the size of the creative. However you still need to call `adView.resize()` because the creative has a 1x1 size by default and without this call it will be rendered as a pixel.
+2. Make sure you properly process all possible cases in the `AdViewUtils.findPrebidCreativeSize` callbacks (both success and failure). Sometimes you might not get the size of the creative (or a failure callback) - it simply means that this is not a Prebid creative. It means that you still need to render the creative, but you most likely don't need to resize it.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-banner.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-banner.md
new file mode 100644
index 0000000000..aec7d2a201
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-banner.md
@@ -0,0 +1,88 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Interstitial Banner
+description: Android Next-Gen SDK Bidding-Only Integration - Interstitial Banner
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Interstitial Banner
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Starting with Prebid Mobile `2.1.0` you can use `InterstitialAdUnit` to bid over the banner and/or video demand. The default ad format is `BANNER`. To customize the bidding format, specify the ad formats in the `InterstitialAdUnit` constructor.
+
+Integration example:
+
+```kotlin
+private fun createAd() {
+    // 1. Create InterstitialAdUnit
+    //    minWidthPercent=80, minHeightPercent=60
+    adUnit = InterstitialAdUnit(CONFIG_ID, 80, 60)
+
+    // 2. Build the Next-Gen SDK ad request
+    val request = AdRequest.Builder(AD_UNIT_ID)
+    adUnit?.fetchDemand(request) {
+
+        // 3. Load a Next-Gen interstitial ad
+        InterstitialAd.load(
+            request.build(),
+            createListener()
+        )
+    }
+}
+```
+
+You also need to implement `AdLoadCallback<InterstitialAd>` in order to track the ad readiness:
+
+```kotlin
+private fun createListener(): AdLoadCallback<InterstitialAd> {
+    return object : AdLoadCallback<InterstitialAd>() {
+        override fun onAdLoaded(ad: InterstitialAd) {
+            super.onAdLoaded(ad)
+
+            // 4. Present the interstitial ad
+            ad.show(this@Activity)
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed to load: $adError")
+        }
+    }
+}
+```
+
+## Step 1: Create an InterstitialAdUnit
+{:.no_toc}
+
+Initialize the Interstitial Ad Unit with properties:
+
+- `configId` - an ID of Stored Impression on the Prebid Server
+- `minWidthPerc`: Optional parameter to specify the minimum width percent an ad may occupy of a device's screen. Support in SDK version 1.2+
+- `minHeightPrec`: Optional parameter to specify the minimum height percent an ad may occupy of a device's screen. Support in SDK version 1.2+
+
+{: .alert.alert-info :}
+Here's how min size percentages work. If the adunit size is 1x1, Prebid Server uses the screen width/height and the minWidthPerc/minHeightPerc to generate a list of ad sizes from a [predefined list](https://github.com/prebid/prebid-server/blob/master/config/interstitial.go). It selects the first 10 sizes that fall within the max size and minimum percentage size. All the interstitial parameters will still be passed to the bidders, allowing them to use their own size matching algorithms if they prefer. If you'd prefer to just define the size list, that's ok too - just set the sizes and don't define minWidthPerc/minHeightPerc.
+
+## Step 2: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide an `AdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 3: Load a Next-Gen interstitial ad
+{:.no_toc}
+
+You should now request the ad from the Next-Gen SDK. If the `AdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `AdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Step 4: Present the interstitial ad
+{:.no_toc}
+
+Follow the [Next-Gen SDK guide](https://developers.google.com/ad-manager/mobile-ads-sdk/android/interstitial#display_the_ad) to display an interstitial ad right after receiving it or later in natural pauses in the flow of an app.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-video.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-video.md
new file mode 100644
index 0000000000..f74a8c8612
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-interstitial-video.md
@@ -0,0 +1,116 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Interstitial Video
+description: Android Next-Gen SDK Bidding-Only Integration - Interstitial Video
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Interstitial Video
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Starting with Prebid Mobile `2.1.0` you can use `InterstitialAdUnit` to bid for the banner and/or video demand. The default ad format is `BANNER`. To customize the bidding format, specify the ad formats in the `InterstitialAdUnit` constructor.
+
+Integration Example:
+
+```kotlin
+private fun createAd() {
+
+    // 1. Create InterstitialAdUnit with video format
+    adUnit = InterstitialAdUnit(CONFIG_ID, EnumSet.of(AdUnitFormat.VIDEO))
+
+    // 2. Configure video ad unit
+    adUnit?.videoParameters = configureVideoParameters()
+
+    // 3. Make a bid request to Prebid Server
+    val requestBuilder = AdRequest.Builder(AD_UNIT_ID)
+    adUnit?.fetchDemand(requestBuilder) {
+
+        // 4. Load a Next-Gen ad
+        InterstitialAd.load(
+            requestBuilder.build(),
+            createAdListener()
+        )
+    }
+}
+```
+
+Configuration function:
+
+```kotlin
+private fun configureVideoParameters(): VideoParameters {
+    return VideoParameters(listOf("video/x-flv", "video/mp4")).apply {
+        placement = Signals.Placement.Interstitial
+
+        api = listOf(
+            Signals.Api.VPAID_1,
+            Signals.Api.VPAID_2
+        )
+
+        maxBitrate = 1500
+        minBitrate = 300
+        maxDuration = 30
+        minDuration = 5
+        playbackMethod = listOf(Signals.PlaybackMethod.AutoPlaySoundOn)
+        protocols = listOf(
+            Signals.Protocols.VAST_2_0
+        )
+    }
+}
+```
+
+Next-Gen SDK ad listener:
+
+```kotlin
+private fun createAdListener(): AdLoadCallback<InterstitialAd> {
+    return object : AdLoadCallback<InterstitialAd>() {
+        override fun onAdLoaded(ad: InterstitialAd) {
+            super.onAdLoaded(ad)
+
+            // 5. Display an interstitial ad
+            ad.show(this@Activity)
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed to load: $adError")
+        }
+    }
+}
+```
+
+## Step 1: Create an Ad Unit
+{:.no_toc}
+
+Initialize the `InterstitialAdUnit` with the following properties:
+
+- `configId` - an ID of Stored Impression on the Prebid Server
+- `adUnitFormats` - `AdUnitFormat.VIDEO` for a video ad
+
+## Step 2: Configure video parameters
+{:.no_toc}
+
+{% include mobile/video-params.md %}
+
+## Step 3: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide an `AdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 4: Load a Next-Gen interstitial ad
+{:.no_toc}
+
+Now you should request the ad from the Next-Gen SDK. If the `AdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `AdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Step 5: Present the interstitial ad
+{:.no_toc}
+
+Follow the [Next-Gen SDK guide](https://developers.google.com/admob/android/next-gen/interstitial#show_the_ad) to display an interstitial ad right after receiving it or later in natural pauses in the flow of an app.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat-interstitial.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat-interstitial.md
new file mode 100644
index 0000000000..56018e26a0
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat-interstitial.md
@@ -0,0 +1,81 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Multiformat Interstitial Banner+Video
+description: Android Next-Gen SDK Bidding-Only Integration - Multiformat Interstitial Banner+Video
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Multiformat Interstitial Banner+Video
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Integration example:
+
+```kotlin
+// 1. Create InterstitialAdUnit
+adUnit = InterstitialAdUnit(configId, EnumSet.of(AdUnitFormat.BANNER, AdUnitFormat.VIDEO))
+adUnit?.setMinSizePercentage(80, 60)
+adUnit?.adUnitConfig.adSize = new AdSize(1, 1);
+adUnit?.videoParameters = VideoParameters(listOf("video/mp4"))
+
+// 2. Make a bid request to Prebid Server
+val requestBuilder = AdRequest.Builder(AD_UNIT_ID)
+adUnit?.fetchDemand(requestBuilder) {
+
+    // 3. Load a Next-Gen interstitial ad
+    InterstitialAd.load(
+        requestBuilder.build(),
+        createListener()
+    )
+}
+```
+
+## Step 1: Create an Ad Unit
+{:.no_toc}
+
+Initialize the `InterstitialAdUnit` with the following properties:
+
+- `configId` - an ID of Stored Impression on the Prebid Server
+- `adUnitFormats` - ad unit formats for the current ad unit.
+
+{: .alert.alert-info :}
+Here's how min size percentages work. If the adunit size is 1x1, Prebid Server takes the screen width/height and the minWidthPerc/minHeightPerc as a size range, generating a list of ad sizes from a [predefined list](https://github.com/prebid/prebid-server/blob/master/config/interstitial.go). It selects the first 10 sizes that fall within the max size and minimum percentage size. All the interstitial parameters will still be passed to the bidders, allowing them to use their own size matching algorithms if they prefer. If you'd prefer to just define the size list, that's ok too - just set the sizes and don't define minWidthPerc/minHeightPerc.
+
+## Step 2: Set ad formats
+{:.no_toc}
+
+For multiformat ad unit, you must set both banner and video ad formats.
+
+## Step 3: Configure parameters
+{:.no_toc}
+
+### Banner parameters
+
+{% include mobile/banner-params.md %}
+
+### Video parameters
+
+{% include mobile/video-params.md %}
+
+## Step 4: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide an `AdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 5: Load a Next-Gen interstitial ad
+{:.no_toc}
+
+You should now request the ad from the Next-Gen SDK. If the `AdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `AdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise the ad request won't contain targeting keywords and Prebid's ad won't ever be displayed.
+
+## Step 6: Present the interstitial ad
+{:.no_toc}
+
+Follow the [Next-Gen SDK guide](https://developers.google.com/admob/android/next-gen/interstitial#show_the_ad) to display an interstitial ad right after receiving it or later in natural pauses in the flow of an app.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat.md
new file mode 100644
index 0000000000..26793b3003
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-multiformat.md
@@ -0,0 +1,267 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Multiformat Banner+Video+InAppNative
+description: Android Next-Gen SDK Bidding-Only Integration - Multiformat Banner+Video+InAppNative
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Multiformat Banner+Video+InAppNative
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Starting with version `2.1.5` Prebid SDK supports the fully multiformat ad unit. It allows to run bid requests with any combination of `banner`, `video`, and `native` formats.
+
+The following code demonstrates the integration of multiformat ad unit.
+
+```kotlin
+private fun createAd() {
+    // random() only for test cases, in production use only one config id
+    val configId = listOf(CONFIG_ID_BANNER, CONFIG_ID_VIDEO, CONFIG_ID_NATIVE).random()
+
+    // Step 1: Create a PrebidAdUnit
+    prebidAdUnit = PrebidAdUnit(configId)
+
+    // Step 2: Create PrebidRequest
+    val prebidRequest = PrebidRequest()
+
+    // Step 3: Setup the parameters
+    prebidRequest.setBannerParameters(createBannerParameters())
+    prebidRequest.setVideoParameters(createVideoParameters())
+    prebidRequest.setNativeParameters(createNativeParameters())
+
+    // Step 4: Make a bid request
+    val requestBuilder = NativeAdRequest.Builder(
+        AD_UNIT_ID,
+        listOf(NativeAd.NativeAdType.NATIVE, NativeAd.NativeAdType.CUSTOM_NATIVE, NativeAd.NativeAdType.BANNER)
+    ).setCustomFormatIds(listOf(CUSTOM_FORMAT_ID))
+        .setAdSizes(listOf(AdSize.BANNER, AdSize.MEDIUM_RECTANGLE))
+    prebidAdUnit?.fetchDemand(requestBuilder, prebidRequest) {
+
+        // Step 5: Load an Ad
+        loadAd(requestBuilder.build())
+    }
+}
+
+private fun createBannerParameters(): BannerParameters {
+    val parameters = BannerParameters()
+    parameters.api = listOf(Signals.Api.MRAID_3, Signals.Api.OMID_1)
+
+    return parameters
+}
+
+private fun createVideoParameters(): VideoParameters {
+    return VideoParameters(listOf("video/mp4"))
+}
+
+private fun createNativeParameters(): NativeParameters {
+    val assets = mutableListOf<NativeAsset>()
+
+    val title = NativeTitleAsset()
+    title.setLength(90)
+    title.isRequired = true
+    assets.add(title)
+
+    val icon = NativeImageAsset(20, 20, 20, 20)
+    icon.imageType = NativeImageAsset.IMAGE_TYPE.ICON
+    icon.isRequired = true
+    assets.add(icon)
+
+    val image = NativeImageAsset(200, 200, 200, 250)
+    image.imageType = NativeImageAsset.IMAGE_TYPE.MAIN
+    image.isRequired = true
+    assets.add(image)
+
+    val data = NativeDataAsset()
+    data.len = 90
+    data.dataType = NativeDataAsset.DATA_TYPE.SPONSORED
+    data.isRequired = true
+    assets.add(data)
+
+    val body = NativeDataAsset()
+    body.isRequired = true
+    body.dataType = NativeDataAsset.DATA_TYPE.DESC
+    assets.add(body)
+
+    val cta = NativeDataAsset()
+    cta.isRequired = true
+    cta.dataType = NativeDataAsset.DATA_TYPE.CTATEXT
+    assets.add(cta)
+
+    val nativeParameters = NativeParameters(assets)
+    nativeParameters.addEventTracker(
+        NativeEventTracker(
+            NativeEventTracker.EVENT_TYPE.IMPRESSION,
+            arrayListOf(NativeEventTracker.EVENT_TRACKING_METHOD.IMAGE)
+        )
+    )
+    nativeParameters.setContextType(NativeAdUnit.CONTEXT_TYPE.SOCIAL_CENTRIC)
+    nativeParameters.setPlacementType(NativeAdUnit.PLACEMENTTYPE.CONTENT_FEED)
+    nativeParameters.setContextSubType(NativeAdUnit.CONTEXTSUBTYPE.GENERAL_SOCIAL)
+
+    return nativeParameters
+}
+```
+
+Load the ad and process the multiformat response using `NativeAdLoader`:
+
+```kotlin
+private fun loadAd(request: NativeAdRequest) {
+    val adCallback = object : NativeAdLoaderCallback {
+        override fun onBannerAdLoaded(bannerAd: BannerAd) {
+            super.onBannerAdLoaded(bannerAd)
+            showBannerAd(bannerAd)
+        }
+
+        override fun onNativeAdLoaded(nativeAd: NativeAd) {
+            super.onNativeAdLoaded(nativeAd)
+            showNativeAd(nativeAd, adWrapperView)
+        }
+
+        override fun onCustomNativeAdLoaded(customNativeAd: CustomNativeAd) {
+            super.onCustomNativeAdLoaded(customNativeAd)
+            showPrebidNativeAd(customNativeAd)
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed: $adError")
+        }
+    }
+    NativeAdLoader.load(request, adCallback)
+}
+```
+
+The methods managing the Prebid and Next-Gen SDK ads:
+
+```kotlin
+private fun showBannerAd(bannerAd: BannerAd) {
+    val adView = AdView(this)
+    adView.registerBannerAd(bannerAd, this)
+    adWrapperView.addView(adView)
+    AdViewUtils.findPrebidCreativeSize(adView, object : AdViewUtils.PbFindSizeListener {
+        override fun success(width: Int, height: Int) {
+            adView.resize(AdSize(width, height))
+        }
+
+        override fun failure(error: PbFindSizeError) {}
+    })
+}
+
+private fun showNativeAd(ad: NativeAd, wrapper: ViewGroup) {
+    val nativeContainer: NativeAdView =
+        View.inflate(wrapper.context, R.layout.layout_native, null) as NativeAdView
+
+    val icon = nativeContainer.findViewById<ImageView>(R.id.imgIcon)
+    val iconUrl = ad.icon?.uri?.toString()
+    if (iconUrl != null) {
+        ImageUtils.download(iconUrl, icon)
+    }
+
+    val title = nativeContainer.findViewById<TextView>(R.id.tvTitle)
+    title.text = ad.headline
+
+    val image = nativeContainer.findViewById<ImageView>(R.id.imgImage)
+    val imageUrl = ad.image?.uri?.toString()
+    if (imageUrl != null) {
+        ImageUtils.download(imageUrl, image)
+    }
+
+    val description = nativeContainer.findViewById<TextView>(R.id.tvDesc)
+    description.text = ad.body
+
+    val cta = nativeContainer.findViewById<Button>(R.id.btnCta)
+    cta.text = ad.callToAction
+
+    nativeContainer.registerNativeAd(ad, null)
+    wrapper.addView(nativeContainer)
+}
+
+private fun showPrebidNativeAd(customNativeAd: CustomNativeAd) {
+    AdViewUtils.findNative(customNativeAd, object : PrebidNativeAdListener {
+        override fun onPrebidNativeLoaded(ad: PrebidNativeAd) {
+            inflatePrebidNativeAd(ad)
+        }
+
+        override fun onPrebidNativeNotFound() {
+            Log.e("PrebidAdViewUtils", "Find native failed: native not found")
+        }
+
+        override fun onPrebidNativeNotValid() {
+            Log.e("PrebidAdViewUtils", "Find native failed: native not valid")
+        }
+    })
+}
+
+private fun inflatePrebidNativeAd(ad: PrebidNativeAd) {
+    val nativeContainer = View.inflate(this, R.layout.layout_native, null)
+
+    val icon = nativeContainer.findViewById<ImageView>(R.id.imgIcon)
+    ImageUtils.download(ad.iconUrl, icon)
+
+    val title = nativeContainer.findViewById<TextView>(R.id.tvTitle)
+    title.text = ad.title
+
+    val image = nativeContainer.findViewById<ImageView>(R.id.imgImage)
+    ImageUtils.download(ad.imageUrl, image)
+
+    val description = nativeContainer.findViewById<TextView>(R.id.tvDesc)
+    description.text = ad.description
+
+    val cta = nativeContainer.findViewById<Button>(R.id.btnCta)
+    cta.text = ad.callToAction
+
+    ad.registerView(nativeContainer, Lists.newArrayList(icon, title, image, description, cta), null)
+
+    adWrapperView.addView(nativeContainer)
+}
+```
+
+## Step 1: Create a PrebidAdUnit
+{:.no_toc}
+
+Initialize the `PrebidAdUnit` with the following properties:
+
+- `configId` - an ID of the Stored Impression on the Prebid Server
+
+## Step 2: Create a PrebidRequest
+{:.no_toc}
+
+Create the instance of `PrebidRequest` initializing it with respective ad format parameters.
+
+In addition you can set the following properties of the `PrebidRequest`.
+
+## Step 3: Setup the parameters
+{:.no_toc}
+
+For each ad format you should create a respective configuration parameter:
+
+### BannerParameters
+{:.no_toc}
+
+{% include mobile/banner-params.md %}
+
+### VideoParameters
+{:.no_toc}
+
+{% include mobile/video-params.md %}
+
+### NativeParameters
+{:.no_toc}
+
+{% include mobile/native-params.md %}
+
+## Step 4: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `NativeAdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 5: Load an Ad
+{:.no_toc}
+
+Use `NativeAdLoader.load()` with a `NativeAdLoaderCallback` to handle the different ad types returned. The callback provides separate methods for banner ads (`onBannerAdLoaded`), unified native ads (`onNativeAdLoaded`), and custom native ads (`onCustomNativeAdLoaded`).
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-app.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-app.md
new file mode 100644
index 0000000000..beaf3f00d0
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-app.md
@@ -0,0 +1,262 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Native In-App
+description: Android Next-Gen SDK Bidding-Only Integration - Native In-App
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Native In-App
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Visit the [AdOps guide](/adops/gam-native.html#create-mobile-in-app-creative) for instructions on setting up the In-App creatives on GAM.
+
+At a high level, the in-app workflow is happening the following way:
+
+1. The publisher prepares the ad layout and provides the native ad configuration to the SDK's ad unit.
+2. Prebid SDK fetches native demand. However, instead of caching the native assets on the server, the assets are cached locally in the SDK.
+3. Ad requests are made to Google Ad Manager.
+4. Upon receiving results from Google Ad Manager, the SDK determines if any of the received items are from Prebid Server.
+5. If there are Prebid ads, the cached assets are then rendered.
+
+{% capture importantNote %}
+The cached assets might expire. If this occurs the publisher will receive a notification and they will have to fetch the assets again.
+{% endcapture %}
+
+Integration Example
+
+```kotlin
+private fun createAd() {
+    // 1. Create NativeAdUnit
+    adUnit = NativeAdUnit(CONFIG_ID)
+    adUnit?.setContextType(NativeAdUnit.CONTEXT_TYPE.SOCIAL_CENTRIC)
+    adUnit?.setPlacementType(NativeAdUnit.PLACEMENTTYPE.CONTENT_FEED)
+    adUnit?.setContextSubType(NativeAdUnit.CONTEXTSUBTYPE.GENERAL_SOCIAL)
+
+    // 2. Add native assets and trackers
+    addNativeAssets(adUnit)
+
+    // 3. Make a bid request to Prebid Server
+    val adRequest = NativeAdRequest.Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.CUSTOM_NATIVE))
+        .setCustomFormatIds(listOf(CUSTOM_FORMAT_ID))
+    adUnit?.fetchDemand(adRequest) {
+
+        // 4. Load a Native Ad
+        loadAd(adRequest.build(), adWrapperView)
+    }
+}
+```
+
+Add native assets:
+
+```kotlin
+private fun addNativeAssets(adUnit: NativeAdUnit?) {
+    // ADD NATIVE ASSETS
+
+    val title = NativeTitleAsset()
+    title.setLength(90)
+    title.isRequired = true
+    adUnit?.addAsset(title)
+
+    val icon = NativeImageAsset(20, 20, 20, 20)
+    icon.imageType = NativeImageAsset.IMAGE_TYPE.ICON
+    icon.isRequired = true
+    adUnit?.addAsset(icon)
+
+    val image = NativeImageAsset(200, 200, 200, 200)
+    image.imageType = NativeImageAsset.IMAGE_TYPE.MAIN
+    image.isRequired = true
+    adUnit?.addAsset(image)
+
+    val data = NativeDataAsset()
+    data.len = 90
+    data.dataType = NativeDataAsset.DATA_TYPE.SPONSORED
+    data.isRequired = true
+    adUnit?.addAsset(data)
+
+    val body = NativeDataAsset()
+    body.isRequired = true
+    body.dataType = NativeDataAsset.DATA_TYPE.DESC
+    adUnit?.addAsset(body)
+
+    val cta = NativeDataAsset()
+    cta.isRequired = true
+    cta.dataType = NativeDataAsset.DATA_TYPE.CTATEXT
+    adUnit?.addAsset(cta)
+
+    // ADD NATIVE EVENT TRACKERS
+    val methods = ArrayList<EVENT_TRACKING_METHOD>()
+    methods.add(EVENT_TRACKING_METHOD.IMAGE)
+    methods.add(EVENT_TRACKING_METHOD.JS)
+    try {
+        val tracker = NativeEventTracker(NativeEventTracker.EVENT_TYPE.IMPRESSION, methods)
+        adUnit?.addEventTracker(tracker)
+    } catch (e: Exception) {
+        e.printStackTrace()
+    }
+}
+```
+
+Load the native ad using `NativeAdLoader`:
+
+```kotlin
+private fun loadAd(request: NativeAdRequest, wrapper: ViewGroup) {
+    val adCallback = object : NativeAdLoaderCallback {
+        override fun onNativeAdLoaded(nativeAd: NativeAd) {
+            super.onNativeAdLoaded(nativeAd)
+            Log.d(TAG, "Unified native loaded")
+        }
+
+        override fun onCustomNativeAdLoaded(customNativeAd: CustomNativeAd) {
+            super.onCustomNativeAdLoaded(customNativeAd)
+            Log.d(TAG, "Custom ad loaded")
+
+            // 5. Find Prebid Native Ad
+            AdViewUtils.findNative(customNativeAd, object : PrebidNativeAdListener {
+                override fun onPrebidNativeLoaded(ad: PrebidNativeAd) {
+
+                    // 6. Render native ad
+                    inflatePrebidNativeAd(ad, wrapper)
+                }
+
+                override fun onPrebidNativeNotFound() {
+                    Log.e(TAG, "onPrebidNativeNotFound")
+                }
+
+                override fun onPrebidNativeNotValid() {
+                    Log.e(TAG, "onPrebidNativeNotValid")
+                }
+            })
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed: $adError")
+        }
+    }
+    NativeAdLoader.load(request, adCallback)
+}
+```
+
+Render a native ad:
+
+```kotlin
+private fun inflatePrebidNativeAd(ad: PrebidNativeAd, wrapper: ViewGroup) {
+    val nativeContainer = View.inflate(wrapper.context, R.layout.layout_native, null)
+
+    val icon = nativeContainer.findViewById<ImageView>(R.id.imgIcon)
+    ImageUtils.download(ad.iconUrl, icon)
+
+    val title = nativeContainer.findViewById<TextView>(R.id.tvTitle)
+    title.text = ad.title
+
+    val image = nativeContainer.findViewById<ImageView>(R.id.imgImage)
+    ImageUtils.download(ad.imageUrl, image)
+
+    val description = nativeContainer.findViewById<TextView>(R.id.tvDesc)
+    description.text = ad.description
+
+    val cta = nativeContainer.findViewById<Button>(R.id.btnCta)
+    cta.text = ad.callToAction
+
+    ad.registerView(nativeContainer, Lists.newArrayList(icon, title, image, description, cta), SafeNativeListener())
+
+    wrapper.addView(nativeContainer)
+}
+```
+
+The listener that you put in registerView() method must not contain any references to View or Activity to prevent memory leak because this listener can remain in the memory for a long time. It's okay to put null listener if you don't need it. It's better to use class implementation with WeakReferences instead of anonymous objects. In Java inner class implementation must be static.
+
+```kotlin
+private class SafeNativeListener : PrebidNativeAdEventListener {
+    override fun onAdClicked() {}
+    override fun onAdImpression() {}
+    override fun onAdExpired() {}
+}
+```
+
+## Step 1: Create a NativeAdUnit
+{:.no_toc}
+
+Initialize the `NativeAdUnit` with the following properties:
+
+- `configId` - an ID of the Stored Impression on the Prebid Server
+
+## Step 2: Add Native Assets and Event Trackers
+{:.no_toc}
+
+In order to make a bid request for the native ads you should provide a description of native assets that should be present in the native bid response. Prebid SDK supports the following set of assets to request.
+
+- `NativeImageAsset`
+- `NativeDataAsset`
+- `NativeTitleAsset`
+
+### Asset Types
+{:.no_toc}
+
+#### NativeAssetImage
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Main | Optional | The image that will be displayed in the native ad. Include a value for `minimumWidth` and `minimumHeight`. Ensure that the `NativeAssetImage.type` is set to ImageAsset.Main |
+| Icon | Optional | The icon that will be displayed with the native ad. Include a value for `minimumWidth` and `minimumHeight`. Ensure that the `NativeAssetImage.type` is set to ImageAsset.Icon. |
+
+#### NativeAssetData
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Description | Optional | The content to appear with the ad. Ensure that the type is set to `DataAsset.description`. |
+| ctatext | Optional | The text for the call to action button of the native ad. Ensure that the type is set to `DataAsset.ctatext`. |
+| Sponsored | Optional | The sponsor (brand) of the native ad. Ensure that the type is set to `DataAsset.sponsored`. |
+
+#### NativeAssetTitle
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Title | Optional | The title of the native ad. |
+
+### Other Native parameters
+
+{% include mobile/native-params.md %}
+
+## Step 3: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `NativeAdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 4: Configure and make a Next-Gen SDK ad request
+{:.no_toc}
+
+Prepare the `NativeAdRequest` and run an ad request using `NativeAdLoader.load()` as described in the Next-Gen SDK docs for the [native ads](https://developers.google.com/admob/android/next-gen/native). Build the request from the same `NativeAdRequest.Builder` object you passed to `fetchDemand`.
+
+If the `NativeAdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM. Be sure to use the same builder object. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Step 5: Implement NativeAdLoaderCallback
+{:.no_toc}
+
+In order to capture the native ad response, you will need to implement `NativeAdLoaderCallback`.
+
+You should use the following Prebid function to determine whether the Prebid line item should be rendered:
+
+```kotlin
+AdViewUtils.findNative(...)
+```
+
+Without it, the SDK won't be able to recognize the Prebid line item.
+
+## Step 6: Inflate the native layout
+{:.no_toc}
+
+Once the Prebid line item is recognized you should extract the ad from the winning bid and init the view properties with native assets data.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-webview.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-webview.md
new file mode 100644
index 0000000000..01559e7dac
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-native-in-webview.md
@@ -0,0 +1,169 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Native In-Webview
+description: Android Next-Gen SDK Bidding-Only Integration - Native In-Webview
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Native In-Webview
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Integration example:
+
+```kotlin
+private fun createAd() {
+    // 1. Create Ad unit
+    nativeAdUnit = NativeAdUnit(CONFIG_ID)
+    nativeAdUnit?.setContextType(NativeAdUnit.CONTEXT_TYPE.SOCIAL_CENTRIC)
+    nativeAdUnit?.setPlacementType(NativeAdUnit.PLACEMENTTYPE.CONTENT_FEED)
+    nativeAdUnit?.setContextSubType(NativeAdUnit.CONTEXTSUBTYPE.GENERAL_SOCIAL)
+
+    // 2. Configure Native Assets and Trackers
+    addNativeAssets(nativeAdUnit)
+
+    // 3. Create Next-Gen SDK AdView
+    val adView = AdView(this)
+    adWrapperView.addView(adView)
+
+    // 4. Make a bid request to Prebid Server
+    val requestBuilder = BannerAdRequest.Builder(AD_UNIT_ID, AdSize.FLUID)
+    nativeAdUnit?.fetchDemand(requestBuilder) {
+
+        // 5. Load an Ad
+        adView.loadAd(requestBuilder.build(), object : AdLoadCallback<BannerAd> {
+            override fun onAdLoaded(ad: BannerAd) {
+                super.onAdLoaded(ad)
+            }
+            override fun onAdFailedToLoad(adError: LoadAdError) {
+                super.onAdFailedToLoad(adError)
+                Log.e(TAG, "Ad failed to load: $adError")
+            }
+        })
+    }
+}
+```
+
+Add native assets:
+
+```kotlin
+private fun addNativeAssets(adUnit: NativeAdUnit?) {
+    // ADD ASSETS
+
+    val title = NativeTitleAsset()
+    title.setLength(90)
+    title.isRequired = true
+    adUnit?.addAsset(title)
+
+    val icon = NativeImageAsset(20, 20, 20, 20)
+    icon.imageType = NativeImageAsset.IMAGE_TYPE.ICON
+    icon.isRequired = true
+    adUnit?.addAsset(icon)
+
+    val image = NativeImageAsset(200, 200, 200, 200)
+    image.imageType = NativeImageAsset.IMAGE_TYPE.MAIN
+    image.isRequired = true
+    adUnit?.addAsset(image)
+
+    val data = NativeDataAsset()
+    data.len = 90
+    data.dataType = NativeDataAsset.DATA_TYPE.SPONSORED
+    data.isRequired = true
+    adUnit?.addAsset(data)
+
+    val body = NativeDataAsset()
+    body.isRequired = true
+    body.dataType = NativeDataAsset.DATA_TYPE.DESC
+    adUnit?.addAsset(body)
+
+    val cta = NativeDataAsset()
+    cta.isRequired = true
+    cta.dataType = NativeDataAsset.DATA_TYPE.CTATEXT
+    adUnit?.addAsset(cta)
+
+    // ADD EVENT TRACKERS
+
+    val methods = ArrayList<NativeEventTracker.EVENT_TRACKING_METHOD>()
+    methods.add(NativeEventTracker.EVENT_TRACKING_METHOD.IMAGE)
+
+    try {
+        val tracker = NativeEventTracker(NativeEventTracker.EVENT_TYPE.IMPRESSION, methods)
+        adUnit?.addEventTracker(tracker)
+    } catch (e: Exception) {
+        e.printStackTrace()
+    }
+}
+```
+
+## Step 1: Create a NativeAdUnit
+{:.no_toc}
+
+Initialize the `NativeAdUnit` with properties:
+
+- `configId` - an ID of the Stored Impression on the Prebid Server
+
+## Step 2: Add Native Assets and Event Trackers
+{:.no_toc}
+
+In order to make a bid request for the native ads you should provide a description of native assets that should be present in the native bid response. Prebid SDK supports the following set of assets to request.
+
+- `NativeImageAsset`
+- `NativeDataAsset`
+- `NativeTitleAsset`
+
+### Asset Types
+{:.no_toc}
+
+#### NativeAssetImage
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Main | Optional | The image that will be displayed in the native ad. Include a value for `minimumWidth` and `minimumHeight`. Ensure that the `NativeAssetImage.type` is set to ImageAsset.Main |
+| Icon | Optional | The icon that will be displayed with the native ad. Include a value for `minimumWidth` and `minimumHeight`. Ensure that the `NativeAssetImage.type` is set to ImageAsset.Icon. |
+
+#### NativeAssetData
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Description | Optional | The content to appear with the ad. Ensure that the type is set to `DataAsset.description`. |
+| ctatext | Optional | The text for the call to action button of the native ad. Ensure that the type is set to `DataAsset.ctatext`. |
+| Sponsored | Optional | The sponsor (brand) of the native ad. Ensure that the type is set to `DataAsset.sponsored`. |
+
+#### NativeAssetTitle
+{:.no_toc}
+
+{: .table .table-bordered .table-striped }
+| Type | Scope | Description |
+| ------- | -------- | ----------- |
+| Title | Optional | The title of the native ad. |
+
+### Other Native parameters
+
+{% include mobile/native-params.md %}
+
+## Step 3: Create a Next-Gen SDK AdView
+{:.no_toc}
+
+Follow the [Next-Gen SDK documentation](https://developers.google.com/admob/android/next-gen/banner) to integrate a banner ad unit. Use `AdSize.FLUID` to allow the webview to adapt to the native creative size.
+
+## Step 4: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `BannerAdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 5: Load an Ad
+{:.no_toc}
+
+Now you should request the ad from the Next-Gen SDK. If the `BannerAdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `BannerAdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-rewarded-video.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-rewarded-video.md
new file mode 100644
index 0000000000..4c096e5091
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-rewarded-video.md
@@ -0,0 +1,101 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Rewarded Video
+description: Android Next-Gen SDK Bidding-Only Integration - Rewarded Video
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Rewarded Video
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+Integration example:
+
+```kotlin
+private fun createAd() {
+    // 1. Create RewardedVideoAdUnit
+    adUnit = RewardedVideoAdUnit(CONFIG_ID)
+
+    // 2. Configure Video parameters
+    adUnit?.videoParameters = configureVideoParameters()
+
+    // 3. Build the Next-Gen SDK ad request
+    val request = AdRequest.Builder(AD_UNIT_ID)
+    adUnit?.fetchDemand(request) {
+
+        // 4. Load a Next-Gen Rewarded Ad
+        RewardedAd.load(
+            request.build(),
+            createListener()
+        )
+    }
+}
+```
+
+Configure video ad unit:
+
+```kotlin
+private fun configureVideoParameters(): VideoParameters {
+    return VideoParameters(listOf("video/mp4")).apply {
+        protocols = listOf(Signals.Protocols.VAST_2_0)
+        playbackMethod = listOf(Signals.PlaybackMethod.AutoPlaySoundOff)
+    }
+}
+```
+
+Implement Rewarded ad listener:
+
+```kotlin
+private fun createListener(): AdLoadCallback<RewardedAd> {
+    return object : AdLoadCallback<RewardedAd>() {
+        override fun onAdLoaded(rewardedAd: RewardedAd) {
+            super.onAdLoaded(rewardedAd)
+
+            // 5. Display rewarded ad
+            rewardedAd.show(
+                this@Activity
+            ) { _ -> }
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed to load: $adError")
+        }
+    }
+}
+```
+
+## Step 1: Create an Ad Unit
+{:.no_toc}
+
+Initialize the Rewarded Video Ad Unit with the following properties:
+
+- `configId` - an ID of Stored Impression on the Prebid Server
+
+## Step 2: Configure video parameters
+{:.no_toc}
+
+Provide configuration properties for the video ad using the [VideoParameters](#step-2-configure-video-parameters) object.
+
+## Step 3: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide an `AdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 4: Load a Next-Gen Rewarded Ad
+{:.no_toc}
+
+Now you should request the ad from the Next-Gen SDK. If the `AdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `AdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Step 5: Present the Rewarded Ad
+{:.no_toc}
+
+Follow the [Next-Gen SDK guide](https://developers.google.com/admob/android/next-gen/rewarded#show_the_ad_2) to display a rewarded ad right after receiving it or later in natural pauses in the flow of an app.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)
diff --git a/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-video-outstream.md b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-video-outstream.md
new file mode 100644
index 0000000000..139a660ecf
--- /dev/null
+++ b/prebid-mobile/recipes/subrecipes/android/nextgen-bidding-only-video-outstream.md
@@ -0,0 +1,121 @@
+---
+layout: page_v2
+title: Android Next-Gen SDK Bidding-Only Integration - Non-Instream Video
+description: Android Next-Gen SDK Bidding-Only Integration - Non-Instream Video
+sidebarType: 2
+---
+
+# Android Next-Gen SDK Bidding-Only Integration - Non-Instream Video
+
+Back to [Bidding-Only Integration](/prebid-mobile/pbm-api/android/android-sdk-integration-nextgen-original-api.html#adunit-specific-instructions)
+
+{: .alert.alert-info :}
+"Non-Instream" refers to the IAB video categories "Accompanying Content" and "Standalone". See [the IAB document](https://iabtechlab.com/industry-adoption-of-amended-iab-tech-lab-guidelines-is-vital-to-drive-change/) for more information.
+
+Integration example:
+
+```kotlin
+private fun createAd() {
+    // 1. Create BannerAdUnit with video format
+    adUnit = BannerAdUnit(CONFIG_ID, WIDTH, HEIGHT, EnumSet.of(AdUnitFormat.VIDEO))
+
+    // 2. Configure video ad unit
+    adUnit?.videoParameters = configureVideoParameters()
+
+    // 3. Create Next-Gen SDK AdView
+    val adView = AdView(this)
+    val adSize = AdSize(WIDTH, HEIGHT)
+    adWrapperView.addView(adView)
+
+    // 4. Build the Next-Gen SDK ad request
+    val requestBuilder = BannerAdRequest.Builder(AD_UNIT_ID, adSize)
+    adUnit?.fetchDemand(requestBuilder) {
+
+        // 5. Load an ad
+        adView.loadAd(requestBuilder.build(), createAdLoadCallback(adView))
+    }
+}
+```
+
+Configure video parameters:
+
+```kotlin
+private fun configureVideoParameters(): VideoParameters {
+    return VideoParameters(listOf("video/x-flv", "video/mp4")).apply {
+        api = listOf(
+            Signals.Api.VPAID_1,
+            Signals.Api.VPAID_2
+        )
+
+        maxBitrate = 1500
+        minBitrate = 300
+        maxDuration = 30
+        minDuration = 5
+        playbackMethod = listOf(Signals.PlaybackMethod.AutoPlaySoundOn)
+        protocols = listOf(
+            Signals.Protocols.VAST_2_0
+        )
+    }
+}
+```
+
+Setup ad load callback:
+
+```kotlin
+private fun createAdLoadCallback(adView: AdView): AdLoadCallback<BannerAd> {
+    return object : AdLoadCallback<BannerAd>() {
+        override fun onAdLoaded(ad: BannerAd) {
+            super.onAdLoaded(ad)
+            AdViewUtils.findPrebidCreativeSize(adView, object : AdViewUtils.PbFindSizeListener {
+                override fun success(width: Int, height: Int) {
+                    adView.resize(AdSize(width, height))
+                }
+
+                override fun failure(error: PbFindSizeError) {}
+            })
+        }
+
+        override fun onAdFailedToLoad(adError: LoadAdError) {
+            super.onAdFailedToLoad(adError)
+            Log.e(TAG, "Ad failed to load: $adError")
+        }
+    }
+}
+```
+
+## Step 1: Create a BannerAdUnit with the video ad type
+{:.no_toc}
+
+Initialize the `BannerAdUnit` with the following properties:
+
+- `configId` - an ID of the Stored Impression on the Prebid Server
+- `adSize` - the size of the ad unit which will be used in the bid request.
+- `adUnitFormats` - `AdUnitFormat.VIDEO` for a video ad
+
+## Step 2: Configure video parameters
+{:.no_toc}
+
+{% include mobile/video-params.md %}
+
+## Step 3: Create a Next-Gen SDK AdView
+{:.no_toc}
+
+Follow the [Next-Gen SDK documentation](https://developers.google.com/admob/android/next-gen/banner) to integrate a banner ad unit.
+
+## Step 4: Make a bid request
+{:.no_toc}
+
+The `fetchDemand` method makes a bid request to the Prebid Server. You should provide a `BannerAdRequest.Builder` object to this method so Prebid SDK sets the targeting keywords of the winning bid for future ad requests.
+
+## Step 5: Load an Ad
+{:.no_toc}
+
+You should now request the ad from the Next-Gen SDK. If the `BannerAdRequest` contains targeting keywords, the respective Prebid line item will be returned from GAM, and the Next-Gen SDK will render its creative.
+
+Be sure that you make the ad request with the same `BannerAdRequest.Builder` object that you passed to the `fetchDemand` method. Otherwise, the ad request won't contain targeting keywords, and Prebid's ad won't ever be displayed.
+
+## Further Reading
+
+- [Prebid Mobile Overview](/prebid-mobile/prebid-mobile.html)
+- [Prebid SDK Android integration](/prebid-mobile/pbm-api/android/code-integration-android.html)
+- [Prebid SDK Global Parameters - Android](/prebid-mobile/pbm-api/android/pbm-targeting-android.html)

From a2ad3bfdcef266ff13289ba1cb355a5810488154 Mon Sep 17 00:00:00 2001
From: Robert Ray Martinez III <rmartinez@magnite.com>
Date: Thu, 9 Apr 2026 17:23:56 -0700
Subject: [PATCH 536/665] Magnite Bid Adapter: Update Registration Text Only
 (#6508)

* update magnite registration text

* formatting
---
 dev-docs/bidders/magnite.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/magnite.md b/dev-docs/bidders/magnite.md
index 2ab8ae168c..96e50e8997 100644
--- a/dev-docs/bidders/magnite.md
+++ b/dev-docs/bidders/magnite.md
@@ -24,15 +24,16 @@ multiformat_supported: will-bid-on-any
 sidebarType: 1
 ---
 
-### Registration
+## Registration
 
-The Magnite adapter requires setup and approval from the Magnite team, even for existing accounts. Please reach out to your account manager or <header-bidding@magnite.com> for more information.
+For existing DV+ Accounts transitioning from the Rubicon adapter to the Magnite adapter, you can use your existing Account, Site, Zone ids, with new line items and orders. Please reach out to your account manager if you have additional questions
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name | Scope | Description | Example | Type |
-|------|-------|-------------|---------|------|
+| --- | --- | --- | --- | --- |
 | `accountId` | required | The publisher account ID | `14062` | `integer` |
 | `siteId` | required | A unique ID for your site | `70608` | `integer` |
 | `zoneId` | required | A unique ID for your site's ad placements | `498816` | `integer` |
@@ -161,8 +162,9 @@ Outstream video is also supported. We recommend discussing video demand with you
 The Magnite adapter supports native ads using the ORTB Native spec. We recommend version 1.2, but versions 1.0 and 1.1 are also supported.
 
 {: .table .table-bordered .table-striped }
+
 | Native Version | Required Fields |
-|---|---|
+| --- | --- |
 | 1.0 and 1.1 | layout, adunit, assets |
 | 1.2 | context, plcmttype, assets, eventtrackers. privacy is a recommended field. |
 

From 24f8e444aaaa4b9ae19bc45c780697ebb61eae97 Mon Sep 17 00:00:00 2001
From: e-volution-tech <61746103+e-volution-tech@users.noreply.github.com>
Date: Fri, 10 Apr 2026 03:31:00 +0300
Subject: [PATCH 537/665] Update e-volution doc for adapter consistency 
 (#6516)

* e-volution doc update

* updates for Prebid v5

* add id5id

* update adapter

* update prebid js doc for teqblazeUtils lib consistent

* check failer update

* check failer update

---------

Co-authored-by: bretg <bgorsline@gmail.com>
---
 dev-docs/bidders/e_volution.md | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/dev-docs/bidders/e_volution.md b/dev-docs/bidders/e_volution.md
index 0d061f302c..66edbff545 100644
--- a/dev-docs/bidders/e_volution.md
+++ b/dev-docs/bidders/e_volution.md
@@ -23,20 +23,23 @@ safeframes_ok: true
 sidebarType: 1
 ---
 
-### Note
+## Note
 
 The E-volution Bidding adapter requires setup before beginning. Please contact us at <admin@e-volution.ai>
 
-### Prebid.JS Bid Params
+## Prebid.JS Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description           | Example   | Type      |
-|---------------|----------|-----------------------|-----------|-----------|
-| `placementId`      | required | E-volution tech placement id         | `'1234asdf'`    | `'string'` |
 
-### Prebid Server Bid Params
+| Name          | Scope    | Description  | Example | Type     |
+|---------------|----------|--------------|---------|----------|
+| `placementId` | optional | Placement Id | `'0'`   | `string` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`   | `string` |
+
+## Prebid Server Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description           | Example   | Type      |
-|---------------|----------|-----------------------|-----------|-----------|
-| `key`      | required | E-volution integration key         | `'cf64c93f277afdd928d8260653d7413d'`    | `'string'` |
+
+| Name  | Scope    | Description                 | Example                              | Type     |
+|-------|----------|-----------------------------|--------------------------------------|----------|
+| `key` | required | E-volution integration key  | `'cf64c93f277afdd928d8260653d7413d'` | `string` |

From b929a2f6303fec078cdab12db10f408367b04cc8 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Mon, 13 Apr 2026 08:50:22 -0700
Subject: [PATCH 538/665] Update some JS video examples to use local cache
 (#6523)

* fix videojs instream example

* Fix jwplayer example 02

* update jwplayer 01
---
 _includes/loadScript.html                     |  11 ++
 _includes/video/mock-video-bid.html           |  21 +++
 _includes/video/pb-is-jw01.html               | 104 ++++++++-------
 _includes/video/pb-is-jw02.html               | 110 ++++++++--------
 _includes/video/pb-is-vjs.html                | 115 ++++++++---------
 .../jwplayer/pb-ve-jwplayer-hosted.html       |  48 ++++---
 .../jwplayer/pb-ve-jwplayer-platform.html     |  43 +++----
 .../video/instream/videojs/pb-ve-videojs.html | 120 +++++++++---------
 8 files changed, 284 insertions(+), 288 deletions(-)
 create mode 100644 _includes/loadScript.html
 create mode 100644 _includes/video/mock-video-bid.html

diff --git a/_includes/loadScript.html b/_includes/loadScript.html
new file mode 100644
index 0000000000..fac994fb38
--- /dev/null
+++ b/_includes/loadScript.html
@@ -0,0 +1,11 @@
+<script type="text/javascript">
+  function loadScript(url) {
+    const scr = document.createElement('script');
+    scr.src = url;
+    return new Promise((resolve, reject) => {
+      scr.onerror = reject;
+      scr.onload = resolve;
+      document.head.appendChild(scr);
+    });
+  }
+</script>
\ No newline at end of file
diff --git a/_includes/video/mock-video-bid.html b/_includes/video/mock-video-bid.html
new file mode 100644
index 0000000000..ec49e19765
--- /dev/null
+++ b/_includes/video/mock-video-bid.html
@@ -0,0 +1,21 @@
+<script>
+    window.pbjs = window.pbjs || {};
+    pbjs.que = pbjs.que || [];
+    pbjs.que.push(() => {
+      pbjs.setConfig({
+        debugging: {
+          enabled: true,
+          intercept: [
+            {
+              when: {},
+              then: {
+                cpm: 1,
+                mediaType: "video",
+                vastXml: "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"3.0\"><Ad><InLine><AdSystem>GDFP</AdSystem><AdTitle>Demo</AdTitle><Description><![CDATA[Demo]]></Description><Creatives><Creative><Linear ><Duration>00:00:11</Duration><VideoClicks><ClickThrough><![CDATA[https://adplayer.pro/]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" width=\"640\" height=\"360\" type=\"video/mp4\" scalable=\"true\" maintainAspectRatio=\"true\"><![CDATA[https://static.adplayer.pro/video/demo_v2.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>"
+              }
+            },
+          ]
+        }
+      })
+    })
+</script>
\ No newline at end of file
diff --git a/_includes/video/pb-is-jw01.html b/_includes/video/pb-is-jw01.html
index a96915d12d..eeab1a3ddc 100644
--- a/_includes/video/pb-is-jw01.html
+++ b/_includes/video/pb-is-jw01.html
@@ -3,68 +3,66 @@
   <head>
     {% include head--common.html %}
     {% include prebidjs-non-prod.html %}
+    {% include loadScript.html %}
+    {% include video/mock-video-bid.html %}
 
     <!--pbjs and player code -->
+    <script type="text/javascript" class="cmplazyload" data-cmp-purpose="c51">
+      loadScript('https://cdn.jwplayer.com/libraries/dNV4UKpE.js')
+        .then(() => {
+          //Test Key - replace this with your own valid JWPlayer license key
+          jwplayer.key = "ssbF6k0i9BPe87xfG/s0ipdp5gwbLoZaDON/GQvuwPU9nVJy";
 
-    <script>
-      var pbjs = pbjs || {};
-      pbjs.que = pbjs.que || [];
+          window.pbjs = window.pbjs || {};
+          pbjs.que = pbjs.que || [];
 
-      // define invokeVideoPlayer in advance in case we get the bids back from prebid before the entire page loads
-      var tempTag = false;
-      var invokeVideoPlayer = function (url) {
-        tempTag = url;
-      };
-
-      var videoAdUnit = {
-        code: "video1",
-        mediaTypes: {
-          video: {
-            context: "instream",
-            playerSize: [640, 480],
-            mimes: ["video/mp4"],
-            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [2],
-            skip: 1,
-          },
-        },
-        bids: [
-          {
-            bidder: "appnexus",
-            params: {
-              placementId: 13232361, // Add your own placement id here
+          var videoAdUnit = {
+            code: "video1",
+            mediaTypes: {
+              video: {
+                context: "instream",
+                playerSize: [640, 480],
+                mimes: ["video/mp4"],
+                protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+                playbackmethod: [2],
+                skip: 1,
+              },
             },
-          },
-        ],
-      };
-
-      pbjs.que.push(function () {
-        pbjs.addAdUnits(videoAdUnit); // add your ad units to the bid request
+            bids: [
+              {
+                bidder: "appnexus",
+                params: {
+                  placementId: 13232361, // Add your own placement id here
+                },
+              },
+            ],
+          };
 
-        pbjs.setConfig({
-          debug: true,
-          cache: {
-            url: "https://prebid.example.com/pbc/v1/cache",
-          },
-        });
+          pbjs.que.push(function () {
+            pbjs.addAdUnits(videoAdUnit); // add your ad units to the bid request
+            pbjs.setConfig({
+              debug: true,
+              cache: {
+                useLocal: true
+              },
+            });
 
-        pbjs.requestBids({
-          bidsBackHandler: function (bids) {
-            var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-              adUnit: videoAdUnit,
-              params: {
-                iu: "/19968336/prebid_cache_video_adunit",
-                cust_params: {
-                  section: "blog",
-                  anotherKey: "anotherValue",
-                },
-                output: "vast",
+            pbjs.requestBids({
+              bidsBackHandler: function (bids) {
+                pbjs.adServers.gam.getVastXml({
+                  bid: bids.video1.bids[0],
+                  adUnit: videoAdUnit,
+                  params: {
+                    iu: '/41758329/localcache',
+                  },
+                }).then(vastXml => {
+                  window.runJWPlayer(vastXml);
+                })
               },
             });
-            window.runJWPlayer(videoUrl);
-          },
-        });
-      });
+          });
+
+        })
     </script>
   </head>
 
diff --git a/_includes/video/pb-is-jw02.html b/_includes/video/pb-is-jw02.html
index 8162a69928..9b8dba6793 100644
--- a/_includes/video/pb-is-jw02.html
+++ b/_includes/video/pb-is-jw02.html
@@ -2,73 +2,67 @@
 <html lang="en" class="html--no-js">
   <head>
     {% include head--common.html %} {% include prebidjs-non-prod.html %}
+    {% include loadScript.html %}
+    {% include video/mock-video-bid.html %}
 
-    <!--pbjs and player code -->
-    <script type="text/plain" class="cmplazyload" data-cmp-purpose="c51">
-      function updateJWPlayer() {
-        jwplayer.key = "ssbF6k0i9BPe87xfG/s0ipdp5gwbLoZaDON/GQvuwPU9nVJy"; //Test Key - replace this with your own valid JWPlayer license key
-      }
-    </script>
 
-    <script
-      type="text/plain"
-      class="cmplazyload"
-      data-cmp-purpose="c51"
-      data-cmp-src="https://ssl.p.jwpcdn.com/player/v/8.0.5/jwplayer.js"
-    ></script>
+    <script type="text/javascript" class="cmplazyload" data-cmp-purpose="c51">
+      loadScript('https://ssl.p.jwpcdn.com/player/v/8.0.5/jwplayer.js')
+        .then(() => {
+          //Test Key - replace this with your own valid JWPlayer license key
+          jwplayer.key = "ssbF6k0i9BPe87xfG/s0ipdp5gwbLoZaDON/GQvuwPU9nVJy";
 
-    <script>
-      var pbjs = pbjs || {};
-      pbjs.que = pbjs.que || [];
+          window.pbjs = window.pbjs || {};
+          pbjs.que = pbjs.que || [];
 
-      var videoAdUnit = {
-        code: "video1",
-        mediaTypes: {
-          video: {
-            context: "instream",
-            playerSize: [640, 480],
-            mimes: ["video/mp4"],
-            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [2],
-            skip: 1,
-          },
-        },
-        bids: [
-          {
-            bidder: "appnexus",
-            params: {
-              placementId: 13232361, // Add your own placement id here
+          var videoAdUnit = {
+            code: "video1",
+            mediaTypes: {
+              video: {
+                context: "instream",
+                playerSize: [640, 480],
+                mimes: ["video/mp4"],
+                protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+                playbackmethod: [2],
+                skip: 1,
+              },
             },
-          },
-        ],
-      };
+            bids: [
+              {
+                bidder: "appnexus",
+                params: {
+                  placementId: 13232361, // Add your own placement id here
+                },
+              },
+            ],
+          };
 
-      pbjs.que.push(function () {
-        pbjs.addAdUnits(videoAdUnit); // add your ad units to the bid request
-        pbjs.setConfig({
-          debug: true,
-          cache: {
-            url: "https://prebid.example.com/pbc/v1/cache",
-          },
-        });
+          pbjs.que.push(function () {
+            pbjs.addAdUnits(videoAdUnit); // add your ad units to the bid request
+            pbjs.setConfig({
+              debug: true,
+              cache: {
+                useLocal: true
+              },
+            });
+
+            pbjs.requestBids({
+              bidsBackHandler: function (bids) {
+                pbjs.adServers.gam.getVastXml({
+                  bid: bids.video1.bids[0],
+                  adUnit: videoAdUnit,
+                  params: {
+                    iu: '/41758329/localcache',
+                  },
+                }).then(vastXml => {
+                  window.runJWPlayer(vastXml);
+                })
 
-        pbjs.requestBids({
-          bidsBackHandler: function (bids) {
-            var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-              adUnit: videoAdUnit,
-              params: {
-                iu: "/19968336/prebid_cache_video_adunit",
-                cust_params: {
-                  section: "blog",
-                  anotherKey: "anotherValue",
-                },
-                output: "vast",
               },
             });
-            window.runJWPlayer(videoUrl);
-          },
-        });
-      });
+          });
+
+        })
     </script>
   </head>
 
diff --git a/_includes/video/pb-is-vjs.html b/_includes/video/pb-is-vjs.html
index bdedf89b65..ef411b5bfe 100644
--- a/_includes/video/pb-is-vjs.html
+++ b/_includes/video/pb-is-vjs.html
@@ -2,6 +2,8 @@
 <html lang="en" class="html--no-js">
   <head>
     {% include head--common.html %} {% include prebidjs-non-prod.html %}
+    {% include loadScript.html %}
+    {% include video/mock-video-bid.html %}
 
     <!--pbjs and player code -->
 
@@ -15,78 +17,67 @@
       rel="stylesheet"
     />
     <!-- videojs-vast-vpaid -->
-    <script type="text/plain" class="cmplazyload" data-cmp-purpose="c51">
-      window.runVideoJSCode();
-    </script>
-    <script
-      type="text/plain"
-      class="cmplazyload"
-      data-cmp-purpose="c51"
-      data-cmp-src="https://cdnjs.cloudflare.com/ajax/libs/video.js/6.4.0/video.js"
-    ></script>
-    <script
-      type="text/plain"
-      class="cmplazyload"
-      data-cmp-purpose="c51"
-      data-cmp-src="https://cdnjs.cloudflare.com/ajax/libs/videojs-vast-vpaid/2.0.2/videojs_5.vast.vpaid.min.js"
-    ></script>
-
-    <script>
-      var pbjs = pbjs || {};
-      pbjs.que = pbjs.que || [];
+    <script type="text/javascript" class="cmplazyload" data-cmp-purpose="c51">
+      loadScript('https://cdnjs.cloudflare.com/ajax/libs/video.js/6.4.0/video.js')
+        .then(() => loadScript('https://cdnjs.cloudflare.com/ajax/libs/videojs-vast-vpaid/2.0.2/videojs_5.vast.vpaid.min.js'))
+        .then(() => {
+          window.runVideoJSCode();
+          window.pbjs = window.pbjs || {};
+          pbjs.que = pbjs.que || [];
 
-      /* Prebid video ad unit */
+          /* Prebid video ad unit */
 
-      var videoAdUnit = {
-        code: "video1",
-        mediaTypes: {
-          video: {
-            context: "instream",
-            playerSize: [640, 480],
-            mimes: ["video/mp4"],
-            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [2],
-            skip: 1,
-          },
-        },
-        bids: [
-          {
-            bidder: "appnexus",
-            params: {
-              placementId: 13232361,
+          var videoAdUnit = {
+            code: 'video1',
+            mediaTypes: {
+              video: {
+                context: 'instream',
+                playerSize: [640, 480],
+                mimes: ['video/mp4'],
+                protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+                playbackmethod: [2],
+                skip: 1,
+              },
             },
-          },
-        ],
-      };
+            bids: [
+              {
+                bidder: 'appnexus',
+                params: {
+                  placementId: 13232361,
+                },
+              },
+            ],
+          };
 
-      pbjs.que.push(function () {
-        pbjs.addAdUnits(videoAdUnit);
+          pbjs.que.push(function () {
+            pbjs.addAdUnits(videoAdUnit);
 
-        pbjs.setConfig({
-          debug: true,
-          cache: {
-            url: "https://prebid.example.com/pbc/v1/cache",
-          },
-        });
+            pbjs.setConfig({
+              debug: true,
+              cache: {
+                useLocal: true
+              },
+            });
 
-        pbjs.requestBids({
-          bidsBackHandler: function (bids) {
-            var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-              adUnit: videoAdUnit,
-              params: {
-                iu: "/19968336/prebid_cache_video_adunit",
-                cust_params: {
-                  section: "blog",
-                  anotherKey: "anotherValue",
-                },
-                output: "vast",
+            pbjs.requestBids({
+              bidsBackHandler: function (bids) {
+                window.invokeVideoPlayer((callback) => {
+                  pbjs.adServers.gam.getVastXml({
+                    bid: bids.video1.bids[0],
+                    adUnit: videoAdUnit,
+                    params: {
+                      iu: '/41758329/localcache',
+                    },
+                  }).then(vastXml => {
+                    callback(null, vastXml)
+                  })
+                });
               },
             });
-            window.invokeVideoPlayer(videoUrl);
-          },
-        });
+          });
       });
     </script>
+
   </head>
 
   <body></body>
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
index 67ab3e318d..261a78d8ca 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
@@ -57,8 +57,8 @@ <h4>Place this code in the page header.</h4>
 
     // define invokeVideoPlayer in advance in case we get the bids back from prebid before the entire page loads<br>
     var tempTag = false;
-    var invokeVideoPlayer = function(url) {
-        tempTag = url;
+    var invokeVideoPlayer = function(vastXml) {
+        tempTag = vastXml;
     }
 
     var videoAdUnit = {
@@ -86,24 +86,18 @@ <h4>Place this code in the page header.</h4>
         pbjs.setConfig({
             debug: true,
             cache: {
-                url: 'https://prebid.example.com/pbc/v1/cache'
+                useLocal: true
             }
         });
 
         pbjs.requestBids({
             bidsBackHandler: function(bids) {
-                var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+                pbjs.adServers.gam.getVastXml({
                     adUnit: videoAdUnit,
                     params: {
-                        iu: '/19968336/prebid_cache_video_adunit',
-                        cust_params: {
-                            section: 'blog',
-                            anotherKey: 'anotherValue'
-                        },
-                        output: 'vast'
-                    }
-                });
-                invokeVideoPlayer(videoUrl);
+                      iu: '/41758329/localcache',
+                    },
+                }).then(vastXml => invokeVideoPlayer(vastXml));
             }
         });
     });
@@ -123,7 +117,7 @@ <h4>Place this code in the page body.</h4>
   &lt;script&gt;
     var jwPlayerInstance = jwplayer("playerContainerJW");
 
-    invokeVideoPlayer = function(url) {
+    invokeVideoPlayer = function(vastXml) {
         jwPlayerInstance.setup({
             "file": "https://vjs.zencdn.net/v/oceans.mp4",
             "width": 640,
@@ -132,12 +126,14 @@ <h4>Place this code in the page body.</h4>
             "mute": false,
             "advertising": {
                 client: "vast",
+                schedule: [
+                  {
+                    vastxml: vastXml,
+                    offset: 'pre'
+                  }
+                ]
             }
         });
-
-        jwPlayerInstance.on('beforePlay', function() {
-            jwPlayerInstance.playAd(url);
-        })
     }
 
     if (tempTag) {
@@ -155,10 +151,10 @@ <h4>Place this code in the page body.</h4>
 
 <!--video player code-->
 <script>
-  function runJWPlayer(url) {
+  function runJWPlayer(vastXml) {
     const jwPlayerInstance = jwplayer("playerContainerJW");
 
-    invokeVideoPlayer = function (url) {
+    invokeVideoPlayer = function (vastXml) {
       jwPlayerInstance.setup({
         file: "https://vjs.zencdn.net/v/oceans.mp4",
         width: 640,
@@ -167,14 +163,16 @@ <h4>Place this code in the page body.</h4>
         mute: true,
         advertising: {
           client: "vast",
+          schedule: [
+            {
+              vastxml: vastXml,
+              offset: 'pre'
+            }
+          ]
         },
       });
-
-      jwPlayerInstance.on("beforePlay", function () {
-        jwPlayerInstance.playAd(url);
-      });
     };
 
-    invokeVideoPlayer(url);
+    invokeVideoPlayer(vastXml);
   }
 </script>
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
index 64f06968ec..fe8c1035af 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
@@ -7,13 +7,6 @@
 sidebarType: 4
 ---
 
-<script
-  type="text/plain"
-  class="cmplazyload"
-  data-cmp-purpose="c51"
-  data-cmp-src="https://cdn.jwplayer.com/libraries/dNV4UKpE.js"
-></script>
-
 <div class="container">
   <div class="row">
     <div class="vidHeader" style="width: 75vw">
@@ -57,8 +50,8 @@ <h4>Place this code in the page header.</h4>
 
       // define invokeVideoPlayer in advance in case we get the bids back from prebid before the entire page loads<br>
       var tempTag = false;
-      var invokeVideoPlayer = function(url) {
-          tempTag = url;
+      var invokeVideoPlayer = function(vastXml) {
+          tempTag = vastXml;
       }
 
       var videoAdUnit = {
@@ -88,26 +81,20 @@ <h4>Place this code in the page header.</h4>
           pbjs.setConfig({
               debug: true,
               cache: {
-                  url: 'https://prebid.example.com/pbc/v1/cache'
+                  useLocal: true
               }
           });
 
-          pbjs.requestBids({
-              bidsBackHandler: function(bids) {
-                  var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-                      adUnit: videoAdUnit,
-                      params: {
-                          iu: '/19968336/prebid_cache_video_adunit',
-                          cust_params: {
-                              section: 'blog',
-                              anotherKey: 'anotherValue'
-                          },
-                          output: 'vast'
-                      }
-                  });
-                  invokeVideoPlayer(videoUrl);
-              }
-          });
+        pbjs.requestBids({
+            bidsBackHandler: function(bids) {
+                pbjs.adServers.gam.getVastXml({
+                    adUnit: videoAdUnit,
+                    params: {
+                      iu: '/41758329/localcache',
+                    },
+                }).then(vastXml => invokeVideoPlayer(vastXml));
+            }
+        });
       });
 
   &lt;/script&gt;
@@ -157,7 +144,7 @@ <h4>Place this code in the page body.</h4>
   </div>
 
   <script>
-    function runJWPlayer(url) {
+    function runJWPlayer(vastXml) {
       // we initialize our player instance, specifying the div to load it into
       var playerInstance = jwplayer("myElement1");
 
@@ -173,7 +160,7 @@ <h4>Place this code in the page body.</h4>
         advertising: {
           client: "vast",
           // url is the vast tag url that we passed in when we called invokeVideoPlayer in the header
-          tag: url,
+          vastxml: vastXml
         },
       });
     }
diff --git a/examples/video/instream/videojs/pb-ve-videojs.html b/examples/video/instream/videojs/pb-ve-videojs.html
index 24ded8fe3b..68ba056f49 100644
--- a/examples/video/instream/videojs/pb-ve-videojs.html
+++ b/examples/video/instream/videojs/pb-ve-videojs.html
@@ -92,31 +92,30 @@ <h4>Place this code in the page header.</h4>
       };
 
       pbjs.que.push(function() {
-          pbjs.addAdUnits(videoAdUnit);
+        pbjs.addAdUnits(videoAdUnit);
 
-          pbjs.setConfig({
-              debug: true,
-              cache: {
-                  url: 'https://prebid.example.com/pbc/v1/cache'
-              }
-          });
-
-          pbjs.requestBids({
-              bidsBackHandler: function(bids) {
-                  var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-                      adUnit: videoAdUnit,
-                      params: {
-                          iu: '/19968336/prebid_cache_video_adunit',
-                          cust_params: {
-                              section: 'blog',
-                              anotherKey: 'anotherValue'
-                          },
-                          output: 'vast'
-                      }
-                  });
-                  invokeVideoPlayer(videoUrl);
-              }
-          });
+        pbjs.setConfig({
+          debug: true,
+          cache: {
+            useLocal: true
+          }
+        });
+
+        pbjs.requestBids({
+          bidsBackHandler: function (bids) {
+            window.invokeVideoPlayer((callback) => {
+              pbjs.adServers.gam.getVastXml({
+                bid: bids.video1.bids[0],
+                adUnit: videoAdUnit,
+                params: {
+                  iu: '/41758329/localcache',
+                },
+              }).then(vastXml => {
+                callback(null, vastXml)
+              })
+            });
+          },
+        });
       });
 
   &lt;/script&gt;
@@ -148,50 +147,48 @@ <h4>Place this code in the page body.</h4>
       page_load_time = new Date().getTime() - performance.timing.navigationStart;
       console.log(page_load_time + "ms -- Player loaded!");
 
-      function invokeVideoPlayer(url) {
-
-          page_load_time = new Date().getTime() - performance.timing.navigationStart;
-          console.log(page_load_time + "ms -- Prebid VAST url = " + url);
-
-          /* Access the player instance by calling videojs() and passing
-             in the player's ID. Add a ready listener to make sure the
-             player is ready before interacting with it. */
+    function invokeVideoPlayer = function (getVastXml) {
+      page_load_time =
+        new Date().getTime() - performance.timing.navigationStart;
 
-          videojs("vid1").ready(function() {
+      /* Access the player instance by calling videojs() and passing
+         in the player's ID. Add a ready listener to make sure the
+         player is ready before interacting with it. */
 
-              page_load_time = new Date().getTime() - performance.timing.navigationStart;
-              console.log(page_load_time + "ms -- Player is ready!");
+      videojs("vid1").ready(function () {
 
-              /* PASS SETTINGS TO VAST PLUGIN
+        page_load_time = new Date().getTime() - performance.timing.navigationStart;
+        console.log(page_load_time + "ms -- Player is ready!");
 
-                 Pass in a JSON object to the player's vastClient (defined
-                 by the VAST/VPAID plugin we're using). The requires an
-                 adTagUrl, which will be the URL returned by Prebid. You
-                 can view all the options available for the vastClient
-                 here:
+      /* PASS SETTINGS TO VAST PLUGIN
 
-                 https://github.com/MailOnline/videojs-vast-vpaid#options */
+         Pass in a JSON object to the player's vastClient (defined
+         by the VAST/VPAID plugin we're using). The requires an
+         adTagUrl, which will be the URL returned by Prebid. You
+         can view all the options available for the vastClient
+         here:
 
-              var player = this;
-              var vastAd = player.vastClient({
-                  adTagUrl: url,
-                  playAdAlways: true,
-                  verbosity: 4,
-                  vpaidFlashLoaderPath: "https://github.com/MailOnline/videojs-vast-vpaid/blob/RELEASE/bin/VPAIDFlash.swf?raw=true",
-                  autoplay: true
-              });
+         https://github.com/MailOnline/videojs-vast-vpaid#options */
 
-              page_load_time = new Date().getTime() - performance.timing.navigationStart;
-              console.log(page_load_time + "ms -- Prebid VAST tag inserted!");
+        var player = this;
+        var vastAd = player.vastClient({
+          adTagXML: getVastXml,
+          playAdAlways: true,
+          verbosity: 4,
+          vpaidFlashLoaderPath: "https://github.com/MailOnline/videojs-vast-vpaid/blob/RELEASE/bin/VPAIDFlash.swf?raw=true",
+          autoplay: true,
+        });
 
-              player.muted(true);
-              player.play();
+        page_load_time = new Date().getTime() - performance.timing.navigationStart;
+        console.log(page_load_time + "ms -- Prebid VAST tag inserted!");
 
-              page_load_time = new Date().getTime() - performance.timing.navigationStart;
-              console.log(page_load_time + "ms -- invokeVideoPlayer complete!");
+        player.muted(true);
+        player.play();
 
-          });
-      }
+        page_load_time = new Date().getTime() - performance.timing.navigationStart;
+        console.log(page_load_time + "ms -- invokeVideoPlayer complete!");
+      });
+    }
 
   &lt;/script&gt;
         </pre>
@@ -212,10 +209,9 @@ <h4>Place this code in the page body.</h4>
     page_load_time = new Date().getTime() - performance.timing.navigationStart;
     console.log(page_load_time + "ms -- Player loaded!");
 
-    window.invokeVideoPlayer = function (url) {
+    window.invokeVideoPlayer = function (getVastXml) {
       page_load_time =
         new Date().getTime() - performance.timing.navigationStart;
-      console.log(page_load_time + "ms -- Prebid VAST url = " + url);
 
       /* Access the player instance by calling videojs()` and passing
                      in the player's ID. Add a `ready` listener to make sure the
@@ -238,12 +234,13 @@ <h4>Place this code in the page body.</h4>
 
         var player = this;
         var vastAd = player.vastClient({
-          adTagUrl: url,
+          adTagXML: getVastXml,
           playAdAlways: true,
           verbosity: 4,
           vpaidFlashLoaderPath:
             "https://github.com/MailOnline/videojs-vast-vpaid/blob/RELEASE/bin/VPAIDFlash.swf?raw=true",
           autoplay: true,
+          adCancelTimeout: 10000
         });
 
         page_load_time =
@@ -258,6 +255,5 @@ <h4>Place this code in the page body.</h4>
         console.log(page_load_time + "ms -- invokeVideoPlayer complete!");
       });
     };
-    window.resolveVideoJS();
   }
 </script>

From c16a84b60bb7a840f781ba2a6edb93eba54e6754 Mon Sep 17 00:00:00 2001
From: Luca Corbo <lucor@scientiamobile.com>
Date: Mon, 13 Apr 2026 19:32:28 +0200
Subject: [PATCH 539/665] fix(wurfl-rtd): correct devicetype value in bid
 request example (#6509)

---
 dev-docs/modules/wurflRtdProvider.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 5ccea54724..77f702bba2 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -163,7 +163,7 @@ WURFL RTD adds comprehensive device information to the bid request. The `ortb2.d
     "language": "it",
     "make": "Apple",
     "model": "iPhone 16e",
-    "devicetype": 1,
+    "devicetype": 4,
     "os": "iOS",
     "osv": "18.3",
     "hwv": "iPhone 16e",

From 62b94da73fbe8476a073143cca0beaf39f50721e Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Mon, 13 Apr 2026 19:37:00 +0200
Subject: [PATCH 540/665] Remove the postinstall script which didn't work
 (#6511)

---
 npm-postinstall.sh | 10 ----------
 package.json       |  3 +--
 2 files changed, 1 insertion(+), 12 deletions(-)
 delete mode 100755 npm-postinstall.sh

diff --git a/npm-postinstall.sh b/npm-postinstall.sh
deleted file mode 100755
index 5d422c25b8..0000000000
--- a/npm-postinstall.sh
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/bin/sh
-
-# Copy all node_modules css and scss files to _sass/node_modules so we can import and build them with Jekyll
-cd node_modules || exit
-cp --parents -Rf "$(find . -name '*.scss')" ../_sass/node_modules
-cp --parents -Rf "$(find . -name '*.css' ! -path "*/dist/*|*/bundle/*")" ../_sass/node_modules
-
-# Rename all css files to scss, so we can import them in other scss files and they get bundled propery
-cd ../_sass/node_modules || exit
-find . -name '*.css' -exec sh -c 'mv "$0" "${0%.css}.scss"' {} \;
diff --git a/package.json b/package.json
index fb06b2e31b..3ddf53d002 100644
--- a/package.json
+++ b/package.json
@@ -10,8 +10,7 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "dev": "npm run development",
-    "watch": "bundle exec jekyll serve",
-    "postinstall": "./npm-postinstall.sh"
+    "watch": "bundle exec jekyll serve"
   },
   "repository": {
     "type": "git",

From 8e92619392d2ccbe530fabb7dad167ac44f04bf8 Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Tue, 14 Apr 2026 10:14:24 +0300
Subject: [PATCH 541/665] New adapter adsmovil (#6461)

* New adapter adsmovil

* content file added

* fixed file content

* refactor(adsmovil.md): table fix

* refactor(adsmovil.md): table fix

---------

Co-authored-by: Vitalii Sumlennyi <vitalii.sumlennyi@teqblaze.com>
---
 dev-docs/bidders/adsmovil.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/adsmovil.md

diff --git a/dev-docs/bidders/adsmovil.md b/dev-docs/bidders/adsmovil.md
new file mode 100644
index 0000000000..aa67cf3b87
--- /dev/null
+++ b/dev-docs/bidders/adsmovil.md
@@ -0,0 +1,35 @@
+---
+layout: adsmovil
+title: adsmovil
+description: Prebid Adsmovil Adapter
+biddercode: adsmovil
+gpp_sids: usstate_all
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{:.table .table-bordered .table-striped}
+| Name          | Scope    | Description  | Example | Type     |
+|---------------|----------|--------------|---------|----------|
+| `placementId` | optional | Placement Id | `'0'`   | `string` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`   | `string` |
+
+## Note
+
+For the prebid server and prebid.js you only need to use one parameter: either `placementId` or `endpointId`.

From 74c9c27414d8f5f3df931577b808e877e3225293 Mon Sep 17 00:00:00 2001
From: mohanjpAtmd <101256106+mohanjpAtmd@users.noreply.github.com>
Date: Tue, 14 Apr 2026 12:45:22 +0530
Subject: [PATCH 542/665] Fix/module code automatad analytics (#6502)

* Mile Bidder Adapter: Initial Release

* fix: enable download for automatadAnalyticsAdapter

* Fixing module code to make sure the prebid js download succeeds

* fixed markdown lint issues

* Apply suggestion from @muuki88

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Apply suggestion from @muuki88

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* heading fix

---------

Co-authored-by: Shashank <=>
Co-authored-by: JP Mohan <jpmohan@MacBook-Pro-9.local>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/analytics/automatad.md | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/dev-docs/analytics/automatad.md b/dev-docs/analytics/automatad.md
index b63f394d84..f09a771420 100644
--- a/dev-docs/analytics/automatad.md
+++ b/dev-docs/analytics/automatad.md
@@ -2,7 +2,7 @@
 layout: analytics
 title: Automatad
 description: Automatad Prebid Analytics Adapter
-modulecode: automatadAnalytics
+modulecode: automatad
 tcfeu_supported: false
 usp_supported: false
 coppa_supported: false
@@ -10,22 +10,23 @@ prebid_member: false
 enable_download: true
 ---
 
-#### Instructions for usage
+## Instructions for usage
 
 The [Automatad](https://automatad.com/) analytics adapter requires on-boarding, configuration
 parameters & addition of an external script that will be supplied to you by your Automatad account team. Please reach out to your account team or
 <cs@automatad.com> for more information.
 
-#### Adapter Configuration Options
+## Adapter Configuration Options
 
 {: .table .table-bordered .table-striped }
-| Name         | Scope              | Description                                                                                                                 | Example                                                                             | Type             |
-|--------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|------------------|
-| siteID | required  | Your site ID | `N8vZLx`  | string |
-| publisherID | required  | Your publisher ID | `PXfvBq`  | string |
-| logDebug | optional  | Flag to collect debug data pertaining to auctions. Defaults to false | `false`  | boolean |
 
-### Example Configuration
+| Name        | Scope    | Description                                                          | Example  | Type    |
+| ----------- | -------- | -------------------------------------------------------------------- | -------- | ------- |
+| siteID      | required | Your site ID                                                         | `N8vZLx` | string  |
+| publisherID | required | Your publisher ID                                                    | `PXfvBq` | string  |
+| logDebug    | optional | Flag to collect debug data pertaining to auctions. Defaults to false | `false`  | boolean |
+
+## Example Configuration
 
 ```js
 import CONSTANTS '../src/constants.json';

From 1ac8c478a93de9d319a311762a4b62cc6f35504b Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Tue, 14 Apr 2026 09:15:37 +0200
Subject: [PATCH 543/665] Fix headline ordering to comply with markdownlint
 (#6524)

---
 .github/workflows/ci.yml   | 2 +-
 .markdownlint.json         | 2 +-
 README.md                  | 2 +-
 _layouts/analytics.html    | 4 ++--
 _layouts/bidder.html       | 8 ++++----
 _sass/components/_pb.scss  | 2 +-
 dev-docs/analytics/agma.md | 6 +++---
 dev-docs/bidders/ttd.md    | 8 ++++----
 8 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 781536638d..638f187465 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -23,7 +23,7 @@ jobs:
         with:
           files: '**/*.md'
           separator: ","
-      - uses: DavidAnson/markdownlint-cli2-action@v22
+      - uses: DavidAnson/markdownlint-cli2-action@v23
         if: steps.changed-files.outputs.any_changed == 'true'
         with:
           globs: "${{ steps.changed-files.outputs.all_changed_files }},!_includes"
diff --git a/.markdownlint.json b/.markdownlint.json
index 2db5196efd..aa59f5565a 100644
--- a/.markdownlint.json
+++ b/.markdownlint.json
@@ -8,4 +8,4 @@
     "MD033": false,
     "MD036": false,
     "MD058": false
-}
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index 744af1333d..3861f54a98 100755
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ The markdown files are linted via [markdownlint-cli](https://github.com/igorshub
 You may need to configure the disabled rules specified in [.markdownlint.json](.markdownlint.json) directly in your project settings. You can invoke linting in CLI via
 
 ```bash
-markdownlint --config .markdownlint.json --ignore-path .markdownlintignore "**/*.md"
+markdownlint --config .markdownlint.json "**/*.md"
 ```
 
 <a name="running-jekyll-locally"></a>
diff --git a/_layouts/analytics.html b/_layouts/analytics.html
index b56424190e..51b4b3e50f 100644
--- a/_layouts/analytics.html
+++ b/_layouts/analytics.html
@@ -32,9 +32,9 @@
             <div class="col-md-9" role="main">
               <div class="bs-docs-section">
 
-                <h3>{{ page.title }}</h3>
+                <h1>{{ page.title }}</h1>
 
-                <h3>Features</h3>
+                <h2>Features</h2>
 
                 {{content}}
 
diff --git a/_layouts/bidder.html b/_layouts/bidder.html
index 62a52c9e95..0b88d873fe 100644
--- a/_layouts/bidder.html
+++ b/_layouts/bidder.html
@@ -33,7 +33,7 @@
               <div class="bs-docs-section">
                 <p><a href="/dev-docs/bidders.html">Back to Bidders</a></p>
 
-                <h2>{{ page.title }}</h2>
+                <h1>{{ page.title }}</h1>
 
                 {% if page.enable_download == false %}
                   <div class="pb-bidder-s2">
@@ -43,17 +43,17 @@ <h4>Note:</h4> This adapter is not available in current versions of Prebid.js. R
 
                 {% if page.s2s_only == true %}
                   <div class="pb-bidder-s2">
-                    <h3>Note:</h3> This is a Prebid Server adapter only.
+                    <h2>Note:</h2> This is a Prebid Server adapter only.
                   </div>
                 {% endif %}
 
-                <h3>Features</h3>
+                <h2>Features</h2>
 
                 {% include dev-docs/bidder-meta-data.html page=page %}
 
                 {{content}}
 
-                <h3>"Send All Bids" Ad Server Keys</h3>
+                <h2>"Send All Bids" Ad Server Keys</h2>
 
                 <font size="-1">These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.</font>
 
diff --git a/_sass/components/_pb.scss b/_sass/components/_pb.scss
index 9033387d5d..e60c411026 100644
--- a/_sass/components/_pb.scss
+++ b/_sass/components/_pb.scss
@@ -24,7 +24,7 @@
 }
 
 .pb-content {
-  $lt-content-font-size: 19px;
+  $lt-content-font-size: 16px;
 
   padding: 22px 30px;
   border: 1px solid $t-divider-color;
diff --git a/dev-docs/analytics/agma.md b/dev-docs/analytics/agma.md
index 1129d80856..947b9784f3 100644
--- a/dev-docs/analytics/agma.md
+++ b/dev-docs/analytics/agma.md
@@ -10,14 +10,14 @@ prebid_member: false
 gvl_id: 1122
 ---
 
-#### Analytics Options
+## Analytics Options
 
 {: .table .table-bordered .table-striped }
 | Name         | Scope              | Description                                                                                                                 | Example                                                                             | Type             |
 |-------------|---------|--------------------|-----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|------------------|
 | code | required  | Provided by agma | `'my-code'`  | string |
 
-### Example Configuration
+## Example Configuration
 
 ```javascript
 pbjs.enableAnalytics({
@@ -28,6 +28,6 @@ pbjs.enableAnalytics({
 });
 ```
 
-#### Registration
+## Registration
 
 Please contact [team-internet@agma-mmc.de](mailto:team-internet@agma-mmc.de) for signup.
diff --git a/dev-docs/bidders/ttd.md b/dev-docs/bidders/ttd.md
index adc903af42..88a2b7c367 100644
--- a/dev-docs/bidders/ttd.md
+++ b/dev-docs/bidders/ttd.md
@@ -38,11 +38,11 @@ Note: The Trade Desk Header Bidding adapter requires setup and approval before b
 | Name | Scope | Description | Example | Type |
 | --- | --- | --- | --- | --- |
 | `supplySourceId` | required | The TTD-provided supply source name. | `'supplier'` | `String` |
-| `publisherId` | required | The publisher ID. If there is a sellers.json, this should be the same as the seller_id in the sellers.json for the site being trafficked. If there is no sellers.json, this should be hardcoded to "1". | `'1427ab10f2e448057ed3b422'` | `String` |
+| `publisherId` | required | The publisher ID. If there is a sellers.json, this should be the same as the seller_id in the sellers.json for the site being trafficked. If there is no sellers.json, this should be hardcoded to "1". | 1427ab10f2e448057ed3b422 | `String` |
 | `placementId` | optional | This field is optional if GPID is passed through the GPT module <https://docs.prebid.org/dev-docs/modules/gpt-pre-auction.html>. If that module isn't used, the GPID value should be passed in this field. | `'/1111/home#header'` | `String` |
 | `banner` | optional | Display banner targeting parameters. See the banner section below. | `{}` | `object` |
 | `bidfloor` | optional | Sets a bid floor price | `0.95` | `Float` |
-| `customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://customBidderEndpoint/bid/bidder/` | `String` |
+| `customBidderEndpoint` | optional | Only set if TTD has provided a custom endpoint. If set the custom endpoint will take precedent over the hard-coded endpoints | `https://custom/bid/` | `String` |
 
 ## Banner Object
 
@@ -54,7 +54,7 @@ The following banner parameters are supported:
 | --- | --- | --- | --- | --- |
 | `expdir` | optional | Directions in which the banner may expand. See "Expandable Direction" in the [OpenRTB 2.5 docs](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) for possible values. | `[1, 3]` | `Array[integer]` |
 
-## `mediaTypes.banner` Parameters
+### `mediaTypes.banner` Parameters
 
 The TTD adapter for banner uses certain parameters in the AdUnit's
 [mediaTypes.banner](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.banner) definition. Specifically, `sizes` is required for banner ad units. `pos` is recommended.
@@ -90,7 +90,7 @@ var bannerAdUnit = {
 
 ## Video
 
-## `mediaTypes.video` Parameters
+### `mediaTypes.video` Parameters
 
 The TTD adapter for video requires certain parameters in the AdUnit's
 [mediaTypes.video](https://docs.prebid.org/dev-docs/adunit-reference.html#adUnit.mediaTypes.video) definition. Specifically, `maxduration`, `api`, `mimes`, `plcmt`, and `protocols` are all required for video ad units. `playerSize`, `startdelay`, `playbackmethod`, and `pos` are recommended. `minduration`, `minbitrate`, `maxbitrate`, `skip`, `skipmin`, and `skipafter` are optional.

From 82e02f525b4887cad4456ce8ce106a6b542eb989 Mon Sep 17 00:00:00 2001
From: verben-gh <ezequiel.espino@verben.com>
Date: Tue, 14 Apr 2026 13:01:58 +0300
Subject: [PATCH 544/665] New adapter: Verben (#6490)

* New adapter: Verben

* Apply suggestion from @muuki88

* New Adapter Verben: Enabled pbs and pbs_app_supported

---------

Co-authored-by: Verben <support_trading@verben.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/verben.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/verben.md b/dev-docs/bidders/verben.md
index 4875e430ec..d08e2339a8 100644
--- a/dev-docs/bidders/verben.md
+++ b/dev-docs/bidders/verben.md
@@ -16,8 +16,8 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 ---

From e5589be2bec860b57ab7d604e70ccaf923366ebd Mon Sep 17 00:00:00 2001
From: prebid-reklamup <prebid@reklamup.com>
Date: Tue, 14 Apr 2026 15:35:52 +0300
Subject: [PATCH 545/665] New adapter reklamup (#6460)

* New adapter reklamup

* New adapter reklamup: Disable pbs and pbs_app_supported

---------

Co-authored-by: Reklamup <support@reklamup.com>
---
 dev-docs/bidders/reklamup.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/reklamup.md

diff --git a/dev-docs/bidders/reklamup.md b/dev-docs/bidders/reklamup.md
new file mode 100644
index 0000000000..7612322a62
--- /dev/null
+++ b/dev-docs/bidders/reklamup.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: Reklamup
+description: Prebid Reklamup Bidder Adapter
+biddercode: reklamup
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From aa8b37c0d5a3da4aef4712a2ce694b5062e9a607 Mon Sep 17 00:00:00 2001
From: markappmedia <markappmedia@gmail.com>
Date: Wed, 15 Apr 2026 13:50:30 +0300
Subject: [PATCH 546/665] Added Bid Adapter Harion (#6413)

* new adapter harion

* fix(pbs): set to false

* Update dev-docs/bidders/harion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/harion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* feat(pbs): values changed

* refactor(lint): removed empty line

---------

Co-authored-by: Vitalii Sumlennyi <vitalii.sumlennyi@teqblaze.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/harion.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 dev-docs/bidders/harion.md

diff --git a/dev-docs/bidders/harion.md b/dev-docs/bidders/harion.md
new file mode 100644
index 0000000000..ec8f1fd981
--- /dev/null
+++ b/dev-docs/bidders/harion.md
@@ -0,0 +1,36 @@
+---
+layout: bidder
+title: harion
+description: Prebid Harion Bidder Adapter
+biddercode: harion
+gpp_sids: usstate_all
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: false
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+gvl_id: 1406
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+### Note
+
+For the prebid server and prebid.js you only need to use one parameter: either `placementId` or `endpointId`.

From 93a1b07177882d03aefb3b7046e6e524cfbcfc8b Mon Sep 17 00:00:00 2001
From: Pavlo Kavulych <72217414+Chucky-choo@users.noreply.github.com>
Date: Thu, 16 Apr 2026 15:16:39 +0300
Subject: [PATCH 547/665] New Adapter: revealon (#6493)

---
 dev-docs/bidders/revealon.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/revealon.md

diff --git a/dev-docs/bidders/revealon.md b/dev-docs/bidders/revealon.md
new file mode 100644
index 0000000000..10da25d256
--- /dev/null
+++ b/dev-docs/bidders/revealon.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: Revealon
+description: Revealon Bidder Adapter
+biddercode: revealon
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: false
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+### Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `0e232769e6f71d291ee7dbc9d157cf84` | `string`  |
+| `env`       | optional | Environment name            | `revealon`                         | `string`  |
+| `ext`       | optional | Specific integration config | `{}`                               | `object`  |

From 7a0142684efa928f1702d9be50fbf6b089a8eb1a Mon Sep 17 00:00:00 2001
From: Vasu Jain <vasujain00@users.noreply.github.com>
Date: Thu, 16 Apr 2026 05:17:39 -0700
Subject: [PATCH 548/665] Docs: add minWinningBidCacheTTL / targeted-bid cache
 TTL to setConfig (#6479)

* Add minimum cache TTL for targeted bids in setConfig documentation

Enhanced the documentation for the `setConfig` method to include details on the `minWinningBidCacheTTL` setting. This addition clarifies how to manage bid caching for targeted bids, addressing potential issues with ad rendering delays and memory trade-offs. Included code examples and considerations for publishers regarding bid expiration and memory usage.

* Update setConfig documentation to clarify minimum cache TTL for targeted bids

Renamed `minWinningBidCacheTTL` to `minTargetedBidCacheTTL` in the documentation to accurately reflect its purpose. Updated explanations and code examples to enhance clarity on managing bid caching and the implications for ad rendering and memory usage.
---
 dev-docs/publisher-api-reference/setConfig.md | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index cebebcc32d..00aff32682 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -346,6 +346,43 @@ When set, bids are only kept in memory for the duration of their actual TTL life
 
 Put another way, this setting doesn't define each bid's TTL, but rather controls how long it's kept around in memory for analytics purposes.
 
+### Minimum cache TTL for targeted bids
+
+<a id="setConfig-minTargetedBidCacheTTL"></a>
+
+When using `minBidCacheTTL` to limit how long bids stay in memory, bids that have already been sent to the ad server (targeting set) can expire before the ad is rendered. This often happens with GPT lazy load or other delayed render: the ad is requested and targeting is set, but the slot only renders when the user scrolls. If the bid is dropped from cache before render, you may see "cannot find ad" (or similar) errors.
+
+Use **`minTargetedBidCacheTTL`** to give targeted bids a longer (or unlimited) cache time than other bids:
+
+```javascript
+pbjs.setConfig({
+  minBidCacheTTL: 30,               // drop non-targeted bids after 30s
+  minTargetedBidCacheTTL: Infinity  // keep targeted bids until page unload (lazy-load / long-delay render)
+});
+```
+
+* When set, it overrides `minBidCacheTTL` only for bids that have had **targeting set** (e.g. sent to GPT via `setTargetingForGPTAsync` / `setTargetingForGPT`).
+* When unset, all bids use `minBidCacheTTL` (current behavior).
+* Use a number (seconds) for a longer but finite TTL, or `Infinity` to keep targeted bids for the life of the page.
+
+#### Publisher choices when using bid cache TTL
+{: .no_toc}
+
+If you use `minBidCacheTTL` (with or without `minTargetedBidCacheTTL`), you are making a tradeoff between memory and ad availability. Be explicit about what should happen when:
+
+1. A bid expires after targeting but before render
+   * Rely on `minTargetedBidCacheTTL` so targeted bids stay in cache until render, or
+   * Accept that the slot may show no ad / blank, or
+   * Run a new auction when the slot is about to render (e.g. in a lazy-load callback).
+
+2. Bids are dropped for memory saving
+   * Decide whether you prefer lower memory (shorter TTL) or fewer "missing ad" cases (longer TTL or `minTargetedBidCacheTTL`).
+
+#### SSP / revenue note
+{: .no_toc}
+
+Bids have a TTL from the bidder/SSP. If an ad is rendered **after** that TTL, the SSP may treat the bid as expired and may not attribute revenue. Keeping bids in Prebid's cache longer (e.g. with `minTargetedBidCacheTTL`) does not change the SSP's own TTL. Use this setting when the delay is on your side (e.g. lazy load), not to extend the SSP's idea of when the bid is valid.
+
 ### Event history TTL
 
 <a id="setConfig-eventHistoryTTL"></a>

From 07314b809681a89ca7e30c53bd3ba3d6c8623123 Mon Sep 17 00:00:00 2001
From: tccdeniz <cansin.deniz@turkcell.com.tr>
Date: Thu, 16 Apr 2026 15:18:34 +0300
Subject: [PATCH 549/665] Updated adplus docs (#6476)

* Added and updated AdPlus docs

* Fixed linter issues

* Removed unnecessary adplus params
---
 dev-docs/modules/userid-submodules/adplus.md | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/adplus.md b/dev-docs/modules/userid-submodules/adplus.md
index fefbb4611c..1fadf949f1 100644
--- a/dev-docs/modules/userid-submodules/adplus.md
+++ b/dev-docs/modules/userid-submodules/adplus.md
@@ -21,8 +21,6 @@ gulp build --modules=adplusIdSystem,userId
 | Param under userSync.userIds[] | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
 | name | Required | String | The name of this module: `"adplusId"` | `"adplusId"` |
-| storage.expires | Optional | Number | How long (in days) the user ID information will be stored | `7` (recommended) |
-| storage.refreshInSeconds | Optional | Number | How many seconds until the ID is refreshed | `24 * 3600` (recommended) |
 
 ## AdPlus ID Example
 
@@ -32,10 +30,7 @@ pbjs.setConfig({
         userIds: [{
             name: "adplusId",
             storage: {
-                name: "adplusId",
-                type: "cookie&html5",
-                expires: 7,
-                refreshInSeconds: 24 * 3600
+                name: "adplusId"
             }
         }]
     }

From d06a009604e1e722df5f3fbaf3f8a212ffbcf89a Mon Sep 17 00:00:00 2001
From: iprom-adserver <79305981+iprom-adserver@users.noreply.github.com>
Date: Thu, 16 Apr 2026 14:18:49 +0200
Subject: [PATCH 550/665] Updated documentaion to reflect adapter changes.
 (#6475)

Co-authored-by: oskarcokl <oskar.cokl@iprom.si>
---
 dev-docs/bidders/iprom.md | 40 ++++++++++++++++++++++++++++++++-------
 1 file changed, 33 insertions(+), 7 deletions(-)

diff --git a/dev-docs/bidders/iprom.md b/dev-docs/bidders/iprom.md
index 5689594c25..6252832ee4 100644
--- a/dev-docs/bidders/iprom.md
+++ b/dev-docs/bidders/iprom.md
@@ -1,22 +1,48 @@
 ---
 layout: bidder
 title: iPROM
-description: iPROM Prebid Adaptor
+description: iPROM Prebid Adapter
 biddercode: iprom
 media_types: banner
 pbjs: true
+pbs: false
+gvl_id: 811
+tcfeu_supported: true
+usp_supported: false
+dsa_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: true
+dchain_supported: false
+userId: none
 enable_download: true
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+fpd_supported: true
+prebid_member: false
+ortb_blocking_supported: false
+privacy_sandbox: no
 sidebarType: 1
 ---
 
-### Prebid Server Note
+## Prebid Server Note
 
 For registration with our bidder please see our website at [www.iprom.eu](https://www.iprom.eu) or contact us at <support@iprom.si>.
 
-### Bid Params
+## First Party Data
+
+iPROM supports first-party data (`ortb2`) and SupplyChain (`schain`) objects.
+In legacy mode, `schain` is sent separately and the remaining `ortb2` data is passed as `firstPartyData`.
+In ORTB mode, the adapter builds an OpenRTB request from the available Prebid request data.
+
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                    | Example | Type      |
-|-------------|----------|--------------------------------|---------|-----------|
-| `id`        | required | The site ID from iPROM.        | '1234'    | string    |
-| `dimension` | required | iPROM specific bidding zone.   | '300x250' | string    |
+
+| Name        | Scope    | Description                                                                   | Example                                 | Type    |
+|-------------|----------|-------------------------------------------------------------------------------|-----------------------------------------|---------|
+| `id`        | required | The site ID from iPROM.                                                       | `'1234'`                                | string  |
+| `dimension` | optional | iPROM-specific bidding zone. Comma-separated if multiple values are provided. | `'300x250'`                             | string  |
+| `endpoint`  | optional | A different HTTPS endpoint to use for bid responses.                          | `'https://core.iprom.net/programmatic'` | string  |
+| `ortb`      | optional | Whether the request payload should be constructed using the OpenRTB format.   | `true`                                  | boolean |

From 4d90dde6b07ddce1b966d34ff60f14bbdb29c425 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Thu, 16 Apr 2026 15:21:07 +0300
Subject: [PATCH 551/665] Attekmi: add PBS to Amcom (#6357)

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/amcom.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/amcom.md b/dev-docs/bidders/amcom.md
index 5db785a20f..e80083e0f4 100644
--- a/dev-docs/bidders/amcom.md
+++ b/dev-docs/bidders/amcom.md
@@ -14,7 +14,7 @@ deals_supported: true
 floors_supported: true
 fpd_supported: false
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: true
 multiformat_supported: will-bid-on-any
 ---

From de62968e29311e7272cb6d04de8560e15dcb5383 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Thu, 16 Apr 2026 05:26:51 -0700
Subject: [PATCH 552/665] Update GAM video tutorial to explain local cache
 (#6527)

* local cache tutorial

* lint
---
 dev-docs/modules/dfp_video.md               |  8 ++-
 dev-docs/show-video-with-a-dfp-video-tag.md | 78 ++++++++++++++++++---
 2 files changed, 72 insertions(+), 14 deletions(-)

diff --git a/dev-docs/modules/dfp_video.md b/dev-docs/modules/dfp_video.md
index 9b577f06c7..2ea4b4d631 100644
--- a/dev-docs/modules/dfp_video.md
+++ b/dev-docs/modules/dfp_video.md
@@ -3,7 +3,7 @@ layout: page_v2
 page_type: module
 title: Module - Google Ad Manager Video
 description: Required for serving instream video through Google Ad Manager.
-module_code : dfpAdServerVideo
+module_code : gamAdServerVideo
 display_name : Google Ad Manager Video Support
 enable_download : true
 vendor_specific: true
@@ -11,7 +11,6 @@ sidebarType : 1
 ---
 
 
-
 # Google Ad Manager Video
 
 {:.no_toc}
@@ -27,7 +26,10 @@ The standard options:
 
 ## Step 2: Integrate into your prebid.js configuration
 
-The method exposes the [`pbjs.adServers.dfp.buildVideoUrl`]({{site.baseurl}}/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html) method to use. For an example, see the DFP video guide linked below.
+This module exposes the following methods:
+
+- [`pbjs.adServers.gam.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html)
+- [`pbjs.adServers.gam.getVastXml`](/dev-docs/publisher-api-reference/adServers.dfp.getVastXml.html)
 
 # Further Reading
 
diff --git a/dev-docs/show-video-with-a-dfp-video-tag.md b/dev-docs/show-video-with-a-dfp-video-tag.md
index 36f72fc8ae..b7eba0fbfd 100644
--- a/dev-docs/show-video-with-a-dfp-video-tag.md
+++ b/dev-docs/show-video-with-a-dfp-video-tag.md
@@ -29,13 +29,13 @@ The code example below was built using the following libraries:
 Also, you need to make sure to build Prebid.js with:
 
 * Support for at least one video-enabled bidder
-* Support for the `dfpAdServerVideo` ad server adapter, which will provide the video ad support
+* Support for the `gamAdServerVideo` ad server adapter, which will provide the video ad support
 
 For example, to build with the AppNexus bidder adapter and the Google Ad Manager
 Video ad server adapter, use the following command:
 
 ```bash
-gulp build --modules=dfpAdServerVideo,appnexusBidAdapter
+gulp build --modules=gamAdServerVideo,appnexusBidAdapter
 ```
 
 For more information about how to build with modules, see the [Prebid.js project README](https://github.com/prebid/Prebid.js/blob/master/README.md#build-optimization).
@@ -82,8 +82,7 @@ For full details on video ad unit parameters, see [Ad Unit Reference for Video](
 
 By default, Prebid.js caps all CPMs at $20.  As a video seller, you may expect to see CPMs over $20.  In order to receive those bids, you'll need to implement custom price buckets setting the [priceGranularity](/dev-docs/publisher-api-reference/setConfig.html#setConfig-Price-Granularity) object in the `setConfig` method.
 
-For instructions and sample code, see [Custom Price Granularity Buckets
-](/dev-docs/examples/custom-price-buckets.html).
+For instructions and sample code, see [Custom Price Granularity Buckets](/dev-docs/examples/custom-price-buckets.html).
 
 ### 3. Request bids, build video URL
 
@@ -91,7 +90,7 @@ Next, we need to do the standard Prebid "add ad units and request bids" dance.
 
 In the example below, our callback builds the video URL the player needs using the `buildVideoUrl` method from the Google Ad Manager ad server module that we built into our copy of Prebid.js in the **Prerequisites** section.
 
-For more information, see the API documentation for [pbjs.adServers.dfp.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html).  Understanding the arguments to this method is *especially* important if you plan to pass any custom parameters to Google Ad Manager.  The `params` key in the argument to `buildVideoUrl` supports all parameters from the [Google Ad Manager API](https://support.google.com/admanager/answer/1068325).
+For more information, see the API documentation for [pbjs.adServers.gam.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html).  Understanding the arguments to this method is *especially* important if you plan to pass any custom parameters to Google Ad Manager.  The `params` key in the argument to `buildVideoUrl` supports all parameters from the [Google Ad Manager API](https://support.google.com/admanager/answer/1068325).
 
 ```javascript
 pbjs.que.push(function() {
@@ -106,7 +105,7 @@ pbjs.que.push(function() {
 
     pbjs.requestBids({
         bidsBackHandler: function(bids) {
-            var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+            var videoUrl = pbjs.adServers.gam.buildVideoUrl({
                 adUnit: videoAdUnit,
                 params: {
                     iu: '/19968336/prebid_cache_video_adunit'
@@ -120,12 +119,12 @@ pbjs.que.push(function() {
 
 #### Notes on Prebid Cache
 
-The VAST XML has to be cached somewhere because most video players can only work with a URL that returns VAST XML, not VAST directly. Some bidders cache the VAST XML on the server side, while others depend on Prebid.js to perform the caching.
+The VAST XML is typically cached somewhere because GAM expects a URL that returns VAST XML, not a VAST document directly (but see [using the local cache](#local-cache)). Some bidders cache the VAST XML on the server side, while others depend on Prebid.js to perform the caching.
 
 * In general, video-enabled bidders must supply `bid.videoCacheKey`, `bid.vastXml`, or `bid.vastUrl` on their responses, and can provide any combination of the three.
-* If `pbjs.setConfig({cache: {URL}})` isn't set and the bidder supplies only `bid.vastXml` in its bid response, [`pbjs.adServers.dfp.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html) will not be able to generate a videoCacheKey, and it will be dropped from the auction.
+* If `pbjs.setConfig({cache: {URL}})` isn't set and the bidder supplies only `bid.vastXml` in its bid response, [`pbjs.adServers.gam.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html) will not be able to generate a videoCacheKey, and it will be dropped from the auction.
 * If `pbjs.setConfig({cache: {URL}})` is defined and the bidder responds with `bid.videoCacheKey`, Prebid.js will not re-cache the VAST XML.
-* If `options.url` is passed as an argument to [`pbjs.adServers.dfp.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html):
+* If `options.url` is passed as an argument to [`pbjs.adServers.gam.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html):
   * If Prebid Cache is disabled, Prebid sets `description_url` field to the bid response's `bid.vastUrl`.
   * If Prebid Cache is enabled, Prebid sets `description_url` field to the cache URL.
 
@@ -136,7 +135,7 @@ Display banners are rendered with the help of the renderAd function. This functi
 ```javascript
 pbjs.requestBids({
     bidsBackHandler: function(bids) {
-        var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+        var videoUrl = pbjs.adServers.gam.buildVideoUrl({
             adUnit: videoAdUnit,
             params: {
                 iu: '/19968336/prebid_cache_video_adunit'
@@ -145,7 +144,7 @@ pbjs.requestBids({
 
         // Mark the bid, used in buildVideoUrl, as used
         pbjs.markWinningBidAsUsed({
-            adUnitCode: videoAdUnit.code // optional if you know the adId
+            adUnitCode: videoAdUnit.code, // optional if you know the adId
             adId: bid.adId // optional
         });
 
@@ -189,6 +188,63 @@ In the body of the page, the following HTML and JS will show the ad:
 
 If you have [set up your ad server line items and creatives correctly]({{site.baseurl}}/adops/setting-up-prebid-video-in-dfp.html), you should see an instream pre-roll video ad followed by the oceans video from the [video.js homepage](https://videojs.com/).
 
+<a id="local-cache"></a>
+
+### 5. Using the local cache
+
+Since version 10.23 it is possible to work around GAM's requirement for a cached VAST URL by using a combination of [client side caching](/dev-docs/publisher-api-reference/setConfig.html#client-side-caching-of-vast-xml) and [`getVastXml`](/dev-docs/publisher-api-reference/adServers.gam.getVastXml.html). This uses the same setup described above, except that the cache is set to local:
+
+```javascript
+pbjs.setConfig({
+  cache: {
+    useLocal: true
+  }
+});
+```
+
+And passing a VAST document directly to the player (instead of an ad tag URL). Using VideoJS:
+
+```javascript
+  function invokeVideoPlayer() {
+    videojs("vid1").ready(function() {
+      this.vastClient({
+        adTagXml: function(callback) {
+          pbjs.adServers.gam.getVastXml({
+            adUnit: videoAdUnit,
+            params: {
+              iu: '/19968336/prebid_cache_video_adunit'
+            }
+          }).then(function(vastXml) {
+            callback(null, vastXml);
+          })
+        },
+        playAdAlways: true,
+        verbosity: 0,
+        vpaidFlashLoaderPath: "https://github.com/MailOnline/videojs-vast-vpaid/blob/RELEASE/bin/VPAIDFlash.swf?raw=true",
+        autoplay: true
+      });
+      this.muted(true);
+      this.play();
+    });
+  }
+```
+
+See [below](#examples) for more examples.
+
+The way this works is:
+
+* when Prebid receives a video bid, it stores its VAST document in the browser as a [blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob), and updates its `.videoCacheKey` with the ID of that blob; 
+* `getVastXml` first makes a request to GAM (using the URL returned by `getVideoUrl`); 
+* If a Prebid bid wins the GAM auction (and the line items are set up as described in [GAM Step by Step - Video Creatives](/adops/setting-up-prebid-video-in-dfp.md)), the response will contain a VAST URL with a cache key that matches a blob ID;
+* `getVastXml` scans the response for such URLs, and replaces them with an inlined copy of the matching VAST XML from blob storage.    
+
+This means that you can migrate an existing setup using a 3rd party cache service to local caching without any changes in GAM (the VAST URLs in GAM creatives are ignored except for the cache key portion).
+
+{: .alert.alert-warning :}
+Video players often add signals to the GAM ad tag URL. They cannot do this when using `getVastXml`, as there is no URL to augment. This can impact the GAM auction; in practice, this means that using client-side caching will likely result in lower AdX demand.   
+
+<a id="examples"></a>
+
 ## Working Examples
 
 **Note:** Prebid video is designed to work across devices and browsers. This demo has been developed and tested only for Chrome desktop, Firefox desktop, and Chrome Android; additional device/browser support is planned to be added at a later date.

From f6435166a69765d1de6600fbcdeb9a4091318ee4 Mon Sep 17 00:00:00 2001
From: Miguel <therevoltingx@gmail.com>
Date: Fri, 17 Apr 2026 01:05:47 -0700
Subject: [PATCH 553/665] Adds agentic audiences module docs (#6518)

* adds agentic audiences module docs

* documents aa object and gvl mapping

* fixes lint error

---------

Co-authored-by: Miguel Morales <miguel@iabtechlab.com>
---
 dev-docs/modules/agenticAudienceAdapter.md | 152 +++++++++++++++++++++
 1 file changed, 152 insertions(+)
 create mode 100644 dev-docs/modules/agenticAudienceAdapter.md

diff --git a/dev-docs/modules/agenticAudienceAdapter.md b/dev-docs/modules/agenticAudienceAdapter.md
new file mode 100644
index 0000000000..c4355c526c
--- /dev/null
+++ b/dev-docs/modules/agenticAudienceAdapter.md
@@ -0,0 +1,152 @@
+---
+layout: page_v2
+title: Agentic Audiences Real-Time Data Module
+display_name: Agentic Audiences RTD
+description: Injects Agentic Audiences embedding signals from browser storage into OpenRTB bid requests
+page_type: module
+module_type: rtd
+module_code: agenticAudienceAdapter
+enable_download: true
+sidebarType: 1
+---
+
+# Agentic Audiences Real-Time Data Module
+
+## Overview
+
+This Real-Time Data (RTD) submodule reads **Agentic Audiences** embedding data from browser storage (localStorage, with cookie fallback) and merges it into the outbound bid request via `ortb2Fragments.global`. It follows the community extension [**Agentic Audiences in OpenRTB**](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/agentic-audiences.md) (see [IAB Tech Lab — Agentic Audiences](https://iabtechlab.com/standards/agentic-audiences/) and the [reference repository](https://github.com/IABTechLab/agentic-audiences)).
+
+The module injects **one** OpenRTB `Data` object under `user.data`: `name` is always the submodule id `agenticAudience`, and `segment` is built from the stored `entries` array. Embedding fields from each stored entry are placed under **`segment.ext.aa`** (`ver`, `vector`, `dimension`, `model`, `type`); optional `id` and `name` on the segment come from the stored entry when present. Fields are copied **without validation or coercion**.
+
+Implementation reference: [Prebid.js PR #14626](https://github.com/prebid/Prebid.js/pull/14626).
+
+## Integration
+
+1. Build the module into your Prebid.js bundle. The parent [**rtdModule**](/dev-docs/publisher-api-reference/setConfig.html#setConfig-realTimeData) is required. `agenticAudienceAdapter` is listed in `modules/.submodules.json`, so builds that include only `agenticAudienceAdapter` still pull in `rtdModule`:
+
+   ```bash
+   gulp build --modules=rtdModule,agenticAudienceAdapter,...
+   ```
+
+2. Register the data provider with `pbjs.setConfig({ realTimeData: ... })` as shown below.
+
+### Configuration
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 300,
+    dataProviders: [{
+      name: 'agenticAudience',
+      waitForIt: true,
+      params: {
+        storageKey: '_my_agentic_audience_' // optional; see below
+      }
+    }]
+  }
+});
+```
+
+Use **`name: 'agenticAudience'`** in `realTimeData.dataProviders[]` so the RTD core loads this submodule. Other fields such as `auctionDelay` and `waitForIt` are generic RTD behavior; see [Publisher Real-Time Data Configuration](/dev-docs/publisher-api-reference/setConfig.html#setConfig-realTimeData).
+
+### Parameters under `params`
+
+{: .table .table-bordered .table-striped }
+
+| Parameter | Type | Description |
+| :-- | :-- | :-- |
+| `storageKey` | string | Optional. Key used for `localStorage` and, if nothing is found there, for the cookie API. If omitted or an empty string, the module uses the default key **`_agentic_audience_`** (exported as `DEFAULT_STORAGE_KEY` in the module source). |
+
+`init` always returns success; if storage is missing, invalid, or has no mappable segments, the module simply does not merge `user` into `ortb2Fragments.global`.
+
+## Storage format
+
+The value at the resolved storage key must be a **string**: Base64-encoded JSON (`atob` + `JSON.parse`). The parsed object must include an **`entries`** array. Each element should be a plain object; the module maps it to an OpenRTB segment as follows:
+
+- `id`, `name` → segment `id`, `name` (optional; may be undefined if absent in storage)
+- `ver`, `vector`, `dimension`, `model`, `type` → `segment.ext.aa.*` (passed through as-is; no normalization)
+
+Invalid Base64/JSON or a missing/non-array `entries` field results in no injection.
+
+## OpenRTB output shape
+
+When at least one segment is produced, the module **`mergeDeep`s** into `reqBidsConfigObj.ortb2Fragments.global` approximately:
+
+```json
+{
+  "user": {
+    "data": [
+      {
+        "name": "agenticAudience",
+        "segment": [
+          {
+            "id": "seg-1",
+            "name": "identity-contextual",
+            "ext": {
+              "aa": {
+                "ver": "1.0.0",
+                "vector": "<Base64 Float32 LE per OpenRTB extension>",
+                "dimension": 10,
+                "model": "sbert-mini-ctx-001",
+                "type": [1, 2]
+              }
+            }
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Downstream consumers should expect the **`ext.aa`** object as emitted by this submodule (see the [OpenRTB community extension](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/agentic-audiences.md) for semantic definitions of the embedding fields).
+
+## Privacy / storage access
+
+Reads go through Prebid’s **storage manager** for the RTD module type and submodule name `agenticAudience`, so access respects the same activity and consent controls as other RTD submodules in your build.
+
+### TCF: `gvlMapping` for `agenticAudience`
+
+If you use [TCF Control](/dev-docs/modules/tcfControl.html) (or related GDPR consent settings) and the submodule is treated as an unknown vendor, map the **submodule name** `agenticAudience` to the correct **IAB Global Vendor List (GVL) ID** for the party whose storage or data processing applies (for example, the embedding provider). Use the real integer from the GVL instead of placeholders.
+
+`gvlMapping` only:
+
+```javascript
+pbjs.setConfig({
+  gvlMapping: {
+    agenticAudience: XXX,
+  },
+});
+```
+
+(`XXX` stands in for your vendor’s numeric GVL ID.)
+
+Together with `realTimeData` (same `setConfig` call or a later one; Prebid merges top-level keys):
+
+```javascript
+pbjs.setConfig({
+  gvlMapping: {
+    agenticAudience: 123, // example only — use your vendor’s GVL ID
+  },
+  realTimeData: {
+    dataProviders: [{ name: 'agenticAudience', params: {} }],
+  },
+});
+```
+
+See the [`gvlMapping` note](/dev-docs/modules/tcfControl.html) on the TCF Control module page for general behavior.
+
+## Testing
+
+From the Prebid.js repository:
+
+```bash
+npm test -- --file test/spec/modules/agenticAudienceAdapter_spec.js
+```
+
+## References
+
+- [Agentic Audiences in OpenRTB (community extension)](https://github.com/InteractiveAdvertisingBureau/openrtb/blob/main/extensions/community_extensions/agentic-audiences.md)
+- [Agentic Audiences | IAB Tech Lab](https://iabtechlab.com/standards/agentic-audiences/)
+- [IABTechLab / agentic-audiences (GitHub)](https://github.com/IABTechLab/agentic-audiences)
+- [Prebid.js PR #14626 — Agentic Audiences RTD](https://github.com/prebid/Prebid.js/pull/14626)

From 5a08d3eaf3b2db4dd42f67a79a75176500e059b9 Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Fri, 17 Apr 2026 01:06:36 -0700
Subject: [PATCH 554/665] Update references to dfpAdServerVideo to use
 gamAdServerVideo instead (#6529)

* Update dfp -> gam

* lint
---
 _includes/video/head.html                     |  2 +-
 assets/js/video/pb-is-jw-01.js                |  2 +-
 assets/js/video/pb-ve-jwplayer-platform-h.js  |  2 +-
 dev-docs/examples/instream-banner-mix.md      |  4 +-
 dev-docs/modules/dfp_video.md                 |  4 +-
 dev-docs/modules/konduit.md                   |  2 +-
 .../bc/bc-prebid-plugin-prebid-options.md     |  2 +-
 .../cross-player-config.md                    |  2 +-
 .../adServers.dfp.buildVideoUrl.md            | 77 +----------------
 .../adServers.gam.buildVideoUrl.md            | 84 +++++++++++++++++++
 dev-docs/show-video-with-a-dfp-video-tag.md   |  2 +-
 prebid-video/video-getting-started.md         |  2 +-
 12 files changed, 98 insertions(+), 87 deletions(-)
 create mode 100644 dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md

diff --git a/_includes/video/head.html b/_includes/video/head.html
index 069581a519..4db1051913 100644
--- a/_includes/video/head.html
+++ b/_includes/video/head.html
@@ -54,7 +54,7 @@
 
 			  pbjs.requestBids({
 			      bidsBackHandler: function(bids) {
-			          var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+			          var videoUrl = pbjs.adServers.gam.buildVideoUrl({
 			              adUnit: videoAdUnit,
 			              params: {
 			                  iu: '/19968336/prebid_cache_video_adunit',
diff --git a/assets/js/video/pb-is-jw-01.js b/assets/js/video/pb-is-jw-01.js
index ec05dfcb8f..34dc298029 100644
--- a/assets/js/video/pb-is-jw-01.js
+++ b/assets/js/video/pb-is-jw-01.js
@@ -42,7 +42,7 @@ pbjs.que.push(function(){
 
   pbjs.requestBids({
       bidsBackHandler: function(bids) {
-          var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+          var videoUrl = pbjs.adServers.gam.buildVideoUrl({
               adUnit: videoAdUnit,
               params: {
                   iu: '/19968336/prebid_cache_video_adunit',
diff --git a/assets/js/video/pb-ve-jwplayer-platform-h.js b/assets/js/video/pb-ve-jwplayer-platform-h.js
index eed52dd020..299e2d4684 100644
--- a/assets/js/video/pb-ve-jwplayer-platform-h.js
+++ b/assets/js/video/pb-ve-jwplayer-platform-h.js
@@ -41,7 +41,7 @@ function loadVideoData() {
 
         pbjs.requestBids({
             bidsBackHandler: function(bids) {
-                var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+                var videoUrl = pbjs.adServers.gam.buildVideoUrl({
                     adUnit: videoAdUnit,
                     params: {
                         iu: '/19968336/prebid_cache_video_adunit',
diff --git a/dev-docs/examples/instream-banner-mix.md b/dev-docs/examples/instream-banner-mix.md
index a099bc3f42..57753efcf1 100644
--- a/dev-docs/examples/instream-banner-mix.md
+++ b/dev-docs/examples/instream-banner-mix.md
@@ -187,8 +187,8 @@ function initAdserver(bids) {
         }
     });
 
-    // Build DFP URL with targeting for videoAdUnit
-    var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+    // Build GAM URL with targeting for videoAdUnit
+    var videoUrl = pbjs.adServers.gam.buildVideoUrl({
         adUnit: videoAdUnit,
         params: {
             iu: '/19968336/prebid_cache_video_adunit',
diff --git a/dev-docs/modules/dfp_video.md b/dev-docs/modules/dfp_video.md
index 2ea4b4d631..60b16d3e8f 100644
--- a/dev-docs/modules/dfp_video.md
+++ b/dev-docs/modules/dfp_video.md
@@ -28,8 +28,8 @@ The standard options:
 
 This module exposes the following methods:
 
-- [`pbjs.adServers.gam.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html)
-- [`pbjs.adServers.gam.getVastXml`](/dev-docs/publisher-api-reference/adServers.dfp.getVastXml.html)
+- [`pbjs.adServers.gam.buildVideoUrl`](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html)
+- [`pbjs.adServers.gam.getVastXml`](/dev-docs/publisher-api-reference/adServers.gam.getVastXml.html)
 
 # Further Reading
 
diff --git a/dev-docs/modules/konduit.md b/dev-docs/modules/konduit.md
index 811753be93..e798acf5e1 100644
--- a/dev-docs/modules/konduit.md
+++ b/dev-docs/modules/konduit.md
@@ -110,7 +110,7 @@ pbjs.que.push(function() {
         adUnitCode: videoAdUnit[0].code,
         timeout: 1500,
         callback: function (error, bids) {
-          var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
+          var videoUrl = pbjs.adServers.gam.buildVideoUrl({
             ...
           });
 ​
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md b/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
index 5380e3a9be..0c28b7e060 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
@@ -325,7 +325,7 @@ None
 
 Parameters used when using Google Ad Manager as the ad server.
 
-See prebid.org documentation for [buildVideoUrl](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html)
+See prebid.org documentation for [buildVideoUrl](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html)
 
 **Acceptable Values:**
 
diff --git a/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md b/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
index 2e6418c867..ee65cff4a8 100644
--- a/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
+++ b/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
@@ -209,7 +209,7 @@ None
 
 Parameters used when using Google Ad Manager (formerly DFP) as the ad server.
 
-See documentation for [buildVideoUrl](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html) for more information.
+See documentation for [buildVideoUrl](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html) for more information.
 
 **Acceptable Values:**
 
diff --git a/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md b/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
index 6c8ccae331..0a98367501 100644
--- a/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
+++ b/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
@@ -5,80 +5,7 @@ description: adServers.dfp.buildVideoUrl API
 sidebarType: 1
 ---
 
+See [adServers.gam.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html).
 
 {: .alert.alert-info :}
-The Google Ad Manager implementation of this function requires including the `dfpAdServerVideo` module in your Prebid.js build.
-
-This method combines publisher-provided parameters with Prebid.js targeting parameters to build a Google Ad Manager video ad tag URL that can be used by a video player.
-
-#### Argument Reference
-
-##### The `options` object
-
-{: .table .table-bordered .table-striped }
-| Field    | Type   | Description                                                                                                                                                                        |
-|----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `adUnit` | object | *Required*. The Prebid ad unit to which the returned URL will map.                                                                                                                 |
-| `params` | object | *Optional*. Querystring parameters that will be used to construct the Google Ad Manager video ad tag URL. Publisher-supplied values will override values set by Prebid.js. See below for fields. |
-| `url`    | string | *Optional*. The video ad server URL. When given alongside params, the parsed URL will be overwritten with any matching components of params.                                       |
-| `bid`    | object | *Optional*. The Prebid bid for which targeting will be set. If this is not defined, Prebid will use the bid with the highest CPM for the adUnit.                                   |
-
-{: .alert.alert-warning :}
-One or both of options.params and options.url is required. In other words, you may pass in one, the other, or both, but not neither.
-
-##### The `options.params` object
-
-{: .table .table-bordered .table-striped }
-| Field             | Type   | Description                                                                                                                 | Example                                         |
-|-------------------+--------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------|
-| `iu`              | string | *Required*. Google Ad Manager ad unit ID.                                                                                                 | `/19968336/prebid_cache_video_adunit`           |
-| `cust_params`     | object | *Optional*. Key-value pairs merged with Prebid's targeting values and sent to Google Ad Manager on the video ad tag URL.                  | `{section: "blog", anotherKey: "anotherValue"}` |
-| `description_url` | string | *Optional*. Describes the video. Required for Ad Exchange. Prebid.js will build this for you unless you pass it explicitly. | `https://www.example.com`                        |
-
-For more information on any of these params, see [the Google Ad Manager video tag documentation](https://support.google.com/admanager/answer/1068325).
-
-#### Examples
-
-There are several different ways to build up your video URL, as shown in the examples below:
-
-Using `options.params` only:
-
-```javascript
-pbjs.requestBids({
-    bidsBackHandler: function(bids) {
-        var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-            adUnit: videoAdUnit,
-            params: {
-                iu: '/19968336/prebid_cache_video_adunit',
-                cust_params: {
-                    section: "blog",
-                    anotherKey: "anotherValue"
-                },
-                hl: "en",
-                output: "xml_vast2",
-                url: "https://www.example.com",
-            }
-        });
-        invokeVideoPlayer(videoUrl);
-    }
-});
-```
-
-Using `options.url` only:
-
-```javascript
-var adserverTag = 'https://pubads.g.doubleclick.net/gampad/ads?'
-+ 'sz=640x480&iu=/19968336/prebid_cache_video_adunit&impl=s&gdfp_req=1'
-+ '&env=vp&output=xml_vast2&unviewed_position_start=1&hl=en&url=https://www.example.com'
-+ '&cust_params=section%3Dblog%26anotherKey%3DanotherValue';
-
-var videoUrl = pbjs.adServers.dfp.buildVideoUrl({
-    adUnit: videoAdUnit,
-    url: adserverTag
-});
-```
-
-<a name="module_pbjs.requestBids"></a>
-
-{: .alert.alert-warning :}
-In the event of collisions, querystring values passed via `options.params` take precedence over those passed via `options.url`.
+In Prebid 10, the `dfpAdServerVideo` module and the `adServers.dfp.buildVideoUrl` API were renamed to `gamAdServerVideo` and `adServers.gam.buildVideoUrl` respectively.**
diff --git a/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md b/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md
new file mode 100644
index 0000000000..a071056949
--- /dev/null
+++ b/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md
@@ -0,0 +1,84 @@
+---
+layout: api_prebidjs
+title: pbjs.adServers.gam.buildVideoUrl(options)
+description: adServers.gam.buildVideoUrl API
+sidebarType: 1
+---
+
+
+{: .alert.alert-info :}
+The Google Ad Manager implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.
+
+This method combines publisher-provided parameters with Prebid.js targeting parameters to build a Google Ad Manager video ad tag URL that can be used by a video player.
+
+## Argument Reference
+
+### The `options` object
+
+{: .table .table-bordered .table-striped }
+| Field    | Type   | Description                                                                                                                                                                        |
+|----------+--------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `adUnit` | object | *Required*. The Prebid ad unit to which the returned URL will map.                                                                                                                 |
+| `params` | object | *Optional*. Querystring parameters that will be used to construct the Google Ad Manager video ad tag URL. Publisher-supplied values will override values set by Prebid.js. See below for fields. |
+| `url`    | string | *Optional*. The video ad server URL. When given alongside params, the parsed URL will be overwritten with any matching components of params.                                       |
+| `bid`    | object | *Optional*. The Prebid bid for which targeting will be set. If this is not defined, Prebid will use the bid with the highest CPM for the adUnit.                                   |
+
+{: .alert.alert-warning :}
+One or both of options.params and options.url is required. In other words, you may pass in one, the other, or both, but not neither.
+
+### The `options.params` object
+
+{: .table .table-bordered .table-striped }
+| Field             | Type   | Description                                                                                                                 | Example                                         |
+|-------------------+--------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------|
+| `iu`              | string | *Required*. Google Ad Manager ad unit ID.                                                                                                 | `/19968336/prebid_cache_video_adunit`           |
+| `cust_params`     | object | *Optional*. Key-value pairs merged with Prebid's targeting values and sent to Google Ad Manager on the video ad tag URL.                  | `{section: "blog", anotherKey: "anotherValue"}` |
+| `description_url` | string | *Optional*. Describes the video. Required for Ad Exchange. Prebid.js will build this for you unless you pass it explicitly. | `https://www.example.com`                        |
+
+For more information on any of these params, see [the Google Ad Manager video tag documentation](https://support.google.com/admanager/answer/1068325).
+
+## Examples
+
+There are several different ways to build up your video URL, as shown in the examples below:
+
+Using `options.params` only:
+
+```javascript
+pbjs.requestBids({
+    bidsBackHandler: function(bids) {
+        var videoUrl = pbjs.adServers.gam.buildVideoUrl({
+            adUnit: videoAdUnit,
+            params: {
+                iu: '/19968336/prebid_cache_video_adunit',
+                cust_params: {
+                    section: "blog",
+                    anotherKey: "anotherValue"
+                },
+                hl: "en",
+                output: "xml_vast2",
+                url: "https://www.example.com",
+            }
+        });
+        invokeVideoPlayer(videoUrl);
+    }
+});
+```
+
+Using `options.url` only:
+
+```javascript
+var adserverTag = 'https://pubads.g.doubleclick.net/gampad/ads?'
++ 'sz=640x480&iu=/19968336/prebid_cache_video_adunit&impl=s&gdfp_req=1'
++ '&env=vp&output=xml_vast2&unviewed_position_start=1&hl=en&url=https://www.example.com'
++ '&cust_params=section%3Dblog%26anotherKey%3DanotherValue';
+
+var videoUrl = pbjs.adServers.gam.buildVideoUrl({
+    adUnit: videoAdUnit,
+    url: adserverTag
+});
+```
+
+<a name="module_pbjs.requestBids"></a>
+
+{: .alert.alert-warning :}
+In the event of collisions, querystring values passed via `options.params` take precedence over those passed via `options.url`.
diff --git a/dev-docs/show-video-with-a-dfp-video-tag.md b/dev-docs/show-video-with-a-dfp-video-tag.md
index b7eba0fbfd..ad9adde953 100644
--- a/dev-docs/show-video-with-a-dfp-video-tag.md
+++ b/dev-docs/show-video-with-a-dfp-video-tag.md
@@ -90,7 +90,7 @@ Next, we need to do the standard Prebid "add ad units and request bids" dance.
 
 In the example below, our callback builds the video URL the player needs using the `buildVideoUrl` method from the Google Ad Manager ad server module that we built into our copy of Prebid.js in the **Prerequisites** section.
 
-For more information, see the API documentation for [pbjs.adServers.gam.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html).  Understanding the arguments to this method is *especially* important if you plan to pass any custom parameters to Google Ad Manager.  The `params` key in the argument to `buildVideoUrl` supports all parameters from the [Google Ad Manager API](https://support.google.com/admanager/answer/1068325).
+For more information, see the API documentation for [pbjs.adServers.gam.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html).  Understanding the arguments to this method is *especially* important if you plan to pass any custom parameters to Google Ad Manager.  The `params` key in the argument to `buildVideoUrl` supports all parameters from the [Google Ad Manager API](https://support.google.com/admanager/answer/1068325).
 
 ```javascript
 pbjs.que.push(function() {
diff --git a/prebid-video/video-getting-started.md b/prebid-video/video-getting-started.md
index 805ff45123..e28cf9701e 100644
--- a/prebid-video/video-getting-started.md
+++ b/prebid-video/video-getting-started.md
@@ -57,7 +57,7 @@ If you already have a Prebid integration for banner, you don’t need to do anyt
 Your first step to implementing header bidding for video is to [download Prebid.js](/download.html). Before downloading, select the adapters you want to include. (You can add more adapters later.)
 
 - Include at least one bid adapter that supports video. Find a list of eligible adapters in [the video bidders table](/dev-docs/bidders.html#bidder-video-native).
-- If Google Ad Manager is your ad server, you must include the [Google Ad Manager Video module](/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.html).
+- If Google Ad Manager is your ad server, you must include the [Google Ad Manager Video module](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html).
 - If you’ll be integrating with Prebid Server, be sure to include “Prebid Server” in the list of adapters.
 
 ### How to integrate

From 2d9633aa65ee68a4a279db5d6415c1a90d7c2fb5 Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Tue, 21 Apr 2026 08:10:59 +0300
Subject: [PATCH 555/665] New adapter: MyCodeMedia (#6488)

* mycodemedia/prebid.github.io

* MyCodeMedia Adapter: disable pbs and pbs_app_supported

* MyCodeMedia adapter: Enable pbs and pbs_app_supported

* MyCodeMedia adapter: Enable pbs and pbs_app_supported

---------

Co-authored-by: MyCodeMedia <support-platform@mycodemedia.com>
Co-authored-by: mc-pacobernal <119521439+mc-pacobernal@users.noreply.github.com>
---
 dev-docs/bidders/mycodemedia.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/mycodemedia.md b/dev-docs/bidders/mycodemedia.md
index 6ee7156e87..ac3906834a 100644
--- a/dev-docs/bidders/mycodemedia.md
+++ b/dev-docs/bidders/mycodemedia.md
@@ -16,8 +16,8 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 ---

From 999eb55664bc31668ba627dcd01403d7f1c2998b Mon Sep 17 00:00:00 2001
From: driftpixelai <166716541+driftpixelai@users.noreply.github.com>
Date: Tue, 21 Apr 2026 08:11:15 +0300
Subject: [PATCH 556/665] New Adapter: DPAI (#6489)

* New adapter DPAI

* New adapter DPAI: Added end line

* New adapter dpai

* new DPA adapter: disable pbs and pbs_app_supported

* New adapter DPAI: Enable pbs and pbs_app_supported
---
 dev-docs/bidders/dpai.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/dpai.md b/dev-docs/bidders/dpai.md
index 5ad9312893..a864ef1819 100644
--- a/dev-docs/bidders/dpai.md
+++ b/dev-docs/bidders/dpai.md
@@ -16,8 +16,8 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 ---

From 0151dabca195dce9889d82e7d5a84792b9dc96ba Mon Sep 17 00:00:00 2001
From: Luca Corbo <lucor@scientiamobile.com>
Date: Tue, 21 Apr 2026 17:34:02 +0200
Subject: [PATCH 557/665] WURFL RTD Provider: update IP retention policy in
 Privacy & Compliance section (#6531)

* WURFL RTD Provider: update IP retention policy in Privacy & Compliance section

* WURFL RTD Provider: fix MD060 table column style in docs

* WURFL RTD Provider: fix MD060 table column style in docs
---
 dev-docs/modules/wurflRtdProvider.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 77f702bba2..4721c0ea3e 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -90,7 +90,7 @@ While the WURFL RTD module enriches the OpenRTB 2.0 payload, SSP adapters must a
 ### Integration Scenarios
 
 | SSP Adapter Status | Required Adapter Changes | Required Server Changes |
-|-------------------|--------------------------|-------------------------|
+| ------------------ | ------------------------ | ----------------------- |
 | Already passing ORTB2 device to server | No changes required | Update backend logic to utilize device data |
 | Not currently passing device data | Update adapter to read `device` and/or `device.ext.wurfl` and pass to endpoint | Update backend logic to utilize device data |
 | No Bidder Adapter exists | Implement Prebid.js adapter to read and pass `device` and/or `device.ext.wurfl` | Implement endpoint logic to read and utilize data |
@@ -124,7 +124,7 @@ pbjs.setConfig({
 {: .table .table-bordered .table-striped }
 
 | Name | Type | Description | Default |
-|------|------|-------------|---------|
+| ---- | ---- | ----------- | ------- |
 | `name` | String | Real time data module name | Always 'wurfl' |
 | `params` | Object | Configuration parameters | |
 | `params.altHost` | String | Alternate host to connect to WURFL.js | |
@@ -266,6 +266,6 @@ The WURFL RTD module processes minimal personal data under legitimate interest f
 
 * Device detection uses only HTTP headers (User-Agent, Client Hints)
 * No user tracking or cross-site identification
-* IP addresses processed transiently for service delivery only
+* IP addresses are retained for up to 36 months for fraud detection and invalid traffic prevention, then permanently redacted. They are not used for user identification or behavioral profiling.
 
 For questions or support, visit [ScientiaMobile Support](https://support.scientiamobile.com).

From f866c278d10f643bf1ae9d0ddb85137074fdbeb1 Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Tue, 21 Apr 2026 18:36:10 +0300
Subject: [PATCH 558/665] New adapter: AppMonstaMedia (#6498)

* New adapter: AppMonstaMedia

* style fixes

---------

Co-authored-by: AppMonstaMedia <>
---
 dev-docs/bidders/appMonstaMedia.md | 37 ++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/appMonstaMedia.md

diff --git a/dev-docs/bidders/appMonstaMedia.md b/dev-docs/bidders/appMonstaMedia.md
new file mode 100644
index 0000000000..cae93db35a
--- /dev/null
+++ b/dev-docs/bidders/appMonstaMedia.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: AppMonstaMedia
+description: Prebid AppMonstaMedia Bidder Adapter
+biddercode: appMonstaMedia
+gpp_sids: usstate_all
+gvl_id: 1283
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+## Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 72776fade222da83d8327e2e79f7fbfa3eb04852 Mon Sep 17 00:00:00 2001
From: markappmedia <markappmedia@gmail.com>
Date: Wed, 22 Apr 2026 15:04:51 +0300
Subject: [PATCH 559/665] Harion: Set pbjs, pbs, pbs_app_supported to true
 (#6539)

* new adapter harion

* fix(pbs): set to false

* Update dev-docs/bidders/harion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/harion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* feat(pbs): values changed

* refactor(lint): removed empty line

* Create SECURITY.md

* Create dependabot.yml

* Adapter harion: Set pbjs, pbs, pbs_app_supported to true

* Adapter harion: Remove files

* Harion: Fix headlines

---------

Co-authored-by: Vitalii Sumlennyi <vitalii.sumlennyi@teqblaze.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/harion.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/harion.md b/dev-docs/bidders/harion.md
index ec8f1fd981..154878e483 100644
--- a/dev-docs/bidders/harion.md
+++ b/dev-docs/bidders/harion.md
@@ -15,15 +15,15 @@ ortb_blocking_supported: false
 media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
-pbjs: false
-pbs: false
-pbs_app_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 gvl_id: 1406
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description  | Example                         | Type       |
@@ -31,6 +31,6 @@ gvl_id: 1406
 | `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
 | `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
 
-### Note
+## Note
 
 For the prebid server and prebid.js you only need to use one parameter: either `placementId` or `endpointId`.

From e24422a8ddb1a52695132fd167e9933e3bf34ffa Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Wed, 22 Apr 2026 15:06:26 +0300
Subject: [PATCH 560/665] Adsmovil: fix of the layout (#6532)

* New adapter adsmovil

* content file added

* fixed file content

* refactor(adsmovil.md): table fix

* refactor(adsmovil.md): table fix

* feat(layout): fixed to bidder

---------

Co-authored-by: Vitalii Sumlennyi <vitalii.sumlennyi@teqblaze.com>
---
 dev-docs/bidders/adsmovil.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/adsmovil.md b/dev-docs/bidders/adsmovil.md
index aa67cf3b87..7be33c895f 100644
--- a/dev-docs/bidders/adsmovil.md
+++ b/dev-docs/bidders/adsmovil.md
@@ -1,5 +1,5 @@
 ---
-layout: adsmovil
+layout: bidder
 title: adsmovil
 description: Prebid Adsmovil Adapter
 biddercode: adsmovil

From 0236d7cdba69fe60411b638ed4efc780873a5f34 Mon Sep 17 00:00:00 2001
From: Eric Poul <31760529+EricPoul@users.noreply.github.com>
Date: Wed, 22 Apr 2026 15:07:05 +0300
Subject: [PATCH 561/665] MGID: update docs to use ID placeholders (#6535)

Co-authored-by: Erik Poul <erik.poul@mgid.com>
---
 dev-docs/bidders/mgid.md | 25 +++++++++++--------------
 1 file changed, 11 insertions(+), 14 deletions(-)

diff --git a/dev-docs/bidders/mgid.md b/dev-docs/bidders/mgid.md
index f832b549a0..eea6f6d96c 100644
--- a/dev-docs/bidders/mgid.md
+++ b/dev-docs/bidders/mgid.md
@@ -15,7 +15,7 @@ multiformat_supported: will-bid-on-any
 sidebarType: 1
 ---
 
-### Table of Contents
+## Table of Contents
 
 - [Table of Contents](#table-of-contents)
 - [Description](#description)
@@ -39,7 +39,6 @@ MGID header bidding adapter connects with MGID demand sources to fetch bids for
 | Name         | Scope    | Description                        | Example    | Type     |
 |--------------|----------|------------------------------------|------------|----------|
 | `accountId`  | required | The account ID from Mgid           | `'123'`    | `string` |
-| `placementId`| optional | The placement ID from Mgid         | `'123456'` | `string` |
 | `bidFloor`   | optional | Lowest value of expected bid price | `1.1`      | `float`  |
 | `currency`   | optional | Currency of request and response   | `'GBP'`    | `string` |
 
@@ -57,11 +56,10 @@ var adUnits = [{
       sizes: [[300, 600]]
     }
   },
-  // Replace this object to test a new Adapter!
   bids: [{
     bidder: 'mgid',
-    params : {
-      accountId : "219" //test accountId, please replace after test
+    params: {
+      accountId: "#{accountId}" // replace with your accountId
     }
   }]
 }];
@@ -77,11 +75,10 @@ var adUnits = [{
       sizes: [[300, 250]]
     }
   },
-  // Replace this object to test a new Adapter!
   bids: [{
     bidder: 'mgid',
-    params : {
-      accountId : "219" //test accountId, please replace after test
+    params: {
+      accountId: "#{accountId}" // replace with your accountId
     }
   }]
 }];
@@ -107,16 +104,15 @@ var adUnits = [{
             required: true,
             len: 80
         },
-        sponsored: {
+        sponsoredBy: {
             required: false
         }
     }
   },
-  // Replace this object to test a new Adapter!
   bids: [{
     bidder: 'mgid',
-    params : {
-        accountId : "219" //test accountId, please replace after test
+    params: {
+        accountId: "#{accountId}" // replace with your accountId
     }
   }]
 }];
@@ -147,10 +143,11 @@ For Prebid.js v1.14.0 and before:
 
 ```javascript
 pbjs.setConfig({
-   userSync: {
+  userSync: {
     iframeEnabled: true,
     enabledBidders: ['mgid']
- }});
+  }
+});
 ```
 
 Note: Combine the above configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only the last call for a given attribute will take effect.

From 6ca92f296e3fa94a0977ac5a963bad406bcd8668 Mon Sep 17 00:00:00 2001
From: jasonc721 <jasonc721@gmail.com>
Date: Wed, 22 Apr 2026 06:13:35 -0600
Subject: [PATCH 562/665] Documentation update for msft.md (#6512)

* Update msft.md

* Update msft.md

---------

Co-authored-by: Jason Crane <jasoncrane@microsoft.com>
---
 dev-docs/bidders/msft.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index 81d0e124f9..e8425c998e 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -67,6 +67,10 @@ All Microsoft (formerly AppNexus/Xandr) placements included in a single call to
 
 If you are migrating from the AppNexus bid adapter, a number of the previously available AppNexus bid parameters have been deprecated as available options for the Microsoft bid parameters. These deprecated bid parameters are still available however, they're just read from other standarized locations offered within Prebid.js. This change was implemented to help us align better to the publisher-aligned features (such as First Party Data) to use a single setup for many bidders.
 
+The Microsoft Bid Adapter connects to Microsoft's advertising exchange for bids. This adapter supports banner, video (instream and outstream), and native ad formats using OpenRTB 2.5 standards.
+
+For reference, here is the IAB OpenRTB 2.5 [specification](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)
+
 The following table shows how the bid parameters have changed between the two adapters:
 
 {: .table .table-bordered .table-striped }
@@ -93,6 +97,11 @@ The following table shows how the bid parameters have changed between the two ad
 | `params.ext_inv_code` | `params.ext_inv_code` | External inventory code (unchanged) |
 | `params.external_imp_id` | `params.ext_imp_id` | External impression ID (shortend to ext) |
 
+#### Keywords 
+With the AppNexus adapter, keywords followed this format: keyname=keyvalue1,keyvalue2,keyvalue3
+
+In the Microsoft Bid Adapter, the new required format is: keyname=keyvalue1,keyname=keyvalue2,keyname=keyvalue3
+
 <a name="migration-from-appnexus-adserver-targeting"></a>
 
 #### Migrating from the AppNexus Bid Adapter & Ad Server Targeting

From d249245c8651bdb507267af449f3239adda0df8a Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Thu, 23 Apr 2026 11:28:36 +0200
Subject: [PATCH 563/665] rename showheroes bidder (#6505)

---
 .../{showheroes-bs.md => showheroes.md}       | 32 ++++++++++---------
 1 file changed, 17 insertions(+), 15 deletions(-)
 rename dev-docs/bidders/{showheroes-bs.md => showheroes.md} (90%)

diff --git a/dev-docs/bidders/showheroes-bs.md b/dev-docs/bidders/showheroes.md
similarity index 90%
rename from dev-docs/bidders/showheroes-bs.md
rename to dev-docs/bidders/showheroes.md
index d8c298a88a..a5282ce057 100644
--- a/dev-docs/bidders/showheroes-bs.md
+++ b/dev-docs/bidders/showheroes.md
@@ -3,7 +3,7 @@ layout: bidder
 title: ShowHeroes
 description: Prebid ShowHeroes Bidder Adapter
 pbjs: true
-biddercode: showheroes-bs
+biddercode: showheroes
 media_types: video, banner
 gvl_id: 111
 tcfeu_supported: true
@@ -17,31 +17,33 @@ sidebarType: 1
 pbs: true
 ---
 
+{: .alert.alert-danger :}
+Showheroes bid adapter is going to be renamed in the Prebid.js version 12, from `showheroes-bs` to `showheroes`
 
-
-### bid params
+## bid params
 
 {: .table .table-bordered .table-striped }
+
 | Name        | Scope                            | Description                         | Example                                  | Type      |
 |-------------|----------------------------------|-------------------------------------|------------------------------------------|-----------|
-| `unitId`    | required                         | ShowHeroes MAX unit ID              | `'1234abcd-5678efgh'`                     | `string`  |
+| `unitId`    | required                         | ShowHeroes MAX unit ID              | `'1234abcd-5678efgh'`                    | `string`  |
 
 All other parameters should be sent inside openRTB request.
 
-### openRTB2 support
+## openRTB2 support
 
 {: .alert.alert-danger :}
 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
+## 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:
+To do that specifically for `showheroes` you can do:
 
 ```javascript
 pbjs.setBidderConfig({
-  bidders: ['showheroesBs'],
+  bidders: ['showheroes'],
   config: {
     ortb2: {
       test:1
@@ -56,7 +58,7 @@ Or, more easily you can mark the whole request as a test request by doing:
 pbjs.setConfig({ortb2: {test: 1}})
 ```
 
-#### Prebid Server Test Request
+### Prebid Server Test Request
 
 To verify that the Prebid Server is working properly with the server-side `Showheroes` adapter a `test` property can be utilized.
 
@@ -77,7 +79,7 @@ To verify that the Prebid Server is working properly with the server-side `Showh
 }
 ```
 
-#### Outstream
+### Outstream
 
 Example of adunit configuration for the outstream unit:
 
@@ -105,7 +107,7 @@ var adUnits = [
             },
         },
         bids: [{
-            bidder: "showheroes-bs",
+            bidder: "showheroes",
             params: {
                 unitId: "1234abcd-5678efgh",
             }
@@ -121,7 +123,7 @@ pbjs.que.push(function () {
 
 You could use this example and place it in .html example pages inside the Prebid.js repository.
 
-#### instream
+### instream
 
 Example of adunit configuration for the instream unit:
 
@@ -137,7 +139,7 @@ var videoAdUnit = {
         },
         bids: [
           {
-            bidder: 'showheroesBs',
+            bidder: 'showheroes',
             params: {
               unitId: "1234abcd-5678efgh",
           }
@@ -164,7 +166,7 @@ pbjs.que.push(function(){
 
 You could use this example and place it in the `test/pages/instream.html` example page inside the Prebid.js repository.
 
-#### banner
+### banner
 
 Example of adunit configuration for banner ads:
 
@@ -180,7 +182,7 @@ var adUnits = [
           }
         },
         bids: [{
-            bidder: "showheroes-bs",
+            bidder: "showheroes",
             params: {
                 unitId: "1234abcd-5678efgh",
             }

From bb594ae2d5ed14b6d8b96773273608a8673b9eae Mon Sep 17 00:00:00 2001
From: Demetrio Girardi <dgirardi@prebid.org>
Date: Thu, 23 Apr 2026 07:08:22 -0700
Subject: [PATCH 564/665] JS: document gpp control restrictActivities option
 (#6540)

* JS: document gpp control restrictActivities option

* fix missin parens

* add examples
---
 dev-docs/modules/gppControl_usnat.md    | 22 ++++++++++++++++++++++
 dev-docs/modules/gppControl_usstates.md | 17 ++++++++++++++++-
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/gppControl_usnat.md b/dev-docs/modules/gppControl_usnat.md
index df2853e3c4..bb84aabfe9 100644
--- a/dev-docs/modules/gppControl_usnat.md
+++ b/dev-docs/modules/gppControl_usnat.md
@@ -32,6 +32,28 @@ Prebid functionality created to address regulatory requirements does not replace
 
 This module activates if the `gpp` object in the consent management configuration section exists and the consentManagementGpp module exists. See that [module's documentation](/dev-docs/modules/consentManagementGpp.html) for parameter definitions. This module does **not** work with static GPP section 7 strings provided in the first-party data `regs.gpp` object, but **does** work if the `gpp.cmpApi` is set to `static` and `gpp.consentData` is appropriately populated via setConfig.
 
+Optional configuration options are:
+
+{: .table .table-bordered .table-striped }
+| Param | Type | Description | Example |
+| --- | --- | --- | --- |
+| gpp.mspa | `Object` | | |
+| gpp.mspa.restrictActivities | `Array` | A list of [activities](/dev-docs/activity-controls.html#activities) to be restricted in addition to the [default restrictions](/features/mspa-usnat.html#usnat-activity-restrictions). If specified, and if not already restricted, they will be treated similarly to `syncUser`. | `['accessDevice']` |
+
+### Example: disable device access on user opt-out
+
+```javascript
+pbjs.setConfig({
+  consentManagement: {
+    gpp: {
+      mspa: {
+        restrictActivities: ['accessDevice', 'accessRequestCredentials']
+      }
+    }
+  }
+})
+```
+
 ## Build the Package
 
 Follow the basic build instructions in the GitHub Prebid.js repo's main [README](https://github.com/prebid/Prebid.js/blob/master/README.md). To include the consent management module and the GPP Control - USNat module, an additional option must be added to the **gulp build** command:
diff --git a/dev-docs/modules/gppControl_usstates.md b/dev-docs/modules/gppControl_usstates.md
index d15c603fd7..d4fec53cd1 100644
--- a/dev-docs/modules/gppControl_usstates.md
+++ b/dev-docs/modules/gppControl_usstates.md
@@ -36,6 +36,7 @@ Optional configuration options are:
 | Param | Type | Description | Example |
 | --- | --- | --- | --- |
 | gpp.mspa | `Object` | | |
+| gpp.mspa.restrictActivities | `Array` | A list of [activities](/dev-docs/activity-controls.html#activities) to be restricted in addition to the [default restrictions](/features/mspa-usnat.html#usnat-activity-restrictions). If specified, and if not already restricted, they will be treated similarly to `syncUser`. | `['accessDevice']` |
 | gpp.mspa.sids | `Array` | GPP SIDs that should be covered by activity restrictions. Defaults to all US state SIDs (`[8, 9, 10, 11, 12]`). This is the only value needed for normal operation. Other options are for special cases and future-proofing. | `[8, 9]` |
 | gpp.mspa.sections | `Object` | Map from section ID to per-section configuration options | `{8: {name: 'usca'}}` |
 | gpp.mspa.sections.name | `String` | GPP API name to use for the section. Defaults to the names given listed under [section information -> section IDs](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/Section%20Information.md#section-ids). This option would only be used if your CMP has named their sections in a non-standard way. | `uscav3` |
@@ -43,6 +44,20 @@ Optional configuration options are:
 
 ### Examples
 
+#### Disable device access on user opt-out
+
+```javascript
+pbjs.setConfig({
+  consentManagement: {
+    gpp: {
+      mspa: {
+        restrictActivities: ['accessDevice', 'accessRequestCredentials']
+      }
+    }
+  }
+})
+```
+
 #### Enable activity controls for certain sections only
 
 ```javascript
@@ -117,7 +132,7 @@ You can also use the [Prebid.js Download](/download.html) page.
 
 - [IAB Global Privacy Platform Full Specification Repository](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform)
 - [IAB Global Privacy Platform CMP API Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Core/CMP%20API%20Specification.md)
-- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md
+- [IAB Global Privacy Platform USNat string Specification](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/US-National/IAB%20Privacy%E2%80%99s%20Multi-State%20Privacy%20Agreement%20(MSPA)%20US%20National%20Technical%20Specification.md)
 - [Prebid US Compliance Support](/features/mspa-usnat.html)
 - [Prebid Activity Controls](/dev-docs/activity-controls.html)
 - [Prebid Consent Management - US Privacy Module](/dev-docs/modules/consentManagementUsp.html)

From 457c7c6f9a9b067b91a58363a6efeaf269a620f9 Mon Sep 17 00:00:00 2001
From: adzida-adquery <a.dzida@adquery.io>
Date: Thu, 23 Apr 2026 19:19:57 +0200
Subject: [PATCH 565/665] adQuery: update docs - instream/outstream video
 (#6520)

* adquery: changes in specification

* adquery: changes in specification

* adquery: update bidder documentation with expanded specs and examples

* update docs

* update docs

---------

Co-authored-by: ppydys <p.pydys@openmobi.pl>
Co-authored-by: adquery <89853721+adquery@users.noreply.github.com>
Co-authored-by: Adrian Dzida <a.dzida@openmobi.pl>
---
 dev-docs/bidders/adquery.md | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/dev-docs/bidders/adquery.md b/dev-docs/bidders/adquery.md
index 139ff8a20c..67f876fb85 100644
--- a/dev-docs/bidders/adquery.md
+++ b/dev-docs/bidders/adquery.md
@@ -14,9 +14,10 @@ sidebarType: 1
 media_types: banner, video
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description                                                                 | Example                                                                  | Type      |
 |---------------|----------|-----------------------------------------------------------------------------|--------------------------------------------------------------------------|-----------|
 | `placementId` | required | Placement ID provided by Adquery (must match the type/format in dashboard)  | `d30f79cf7fef47bd7a5611719f936539bec0d2e9`                               | `string`  |
@@ -25,11 +26,13 @@ media_types: banner, video
 **Notes:**
 
 - `placementId` is always required and should correspond to a placement configured in the Adquery dashboard for the specific `type`.
-- `type` is mandatory in bidder params — it determines the creative format (banner, video, interstitial, anchorad).
-- For **banner** ads: Define sizes in `mediaTypes.banner.sizes`. The adapter automatically parses and sends them.
-- For **video** ( outstream ): Use `type: 'video'` + `mediaTypes.video.context: 'outstream'`. A renderer is required for rendering (e.g. InRenderer or similar). In-stream video is not currently supported by this adapter.
-- For **video** ( instream ): Use `type: 'video'` + `mediaTypes.video.context: 'instream'`. A renderer is required for rendering (e.g. InRenderer or similar). In-stream video is not currently supported by this adapter.
-- For special formats (`interstitial`, `anchorad`): A spetial size placeholder is reqired `[1x1]`.
+- `type` is required in bidder params and determines the creative format returned by Adquery.
+- For **banner** ads: define sizes in `mediaTypes.banner.sizes`. The adapter automatically parses and sends them.
+- For **video** bids: use `type: 'video'` and set `mediaTypes.video.context` to either `outstream` or `instream`.
+- For **video** bids, `mediaTypes.video.playerSize` is required.
+- For **video** (`outstream`): a renderer or equivalent outstream player integration is required (e.g. InRenderer or similar).
+- For **video** (`instream`): a compatible instream video player integration is required to render the returned VAST response.
+- For special formats (`interstitial`, `anchorad`): use the placeholder size `[[1, 1]]`.
 
 ### Example 1: Standard Banner Ad
 
@@ -62,8 +65,8 @@ media_types: banner, video
             playerSize: [[640, 360]],
             mimes: ['video/mp4', 'video/webm'],
             protocols: [2, 3, 5, 6, 7, 8],
-            api: [2],     
-            placement: 1,  
+            api: [2],
+            placement: 1,
             startdelay: 0,
             skip: 1
         }
@@ -108,8 +111,10 @@ media_types: banner, video
 // Anchor / fixed bottom bar
 {
     code: 'anchor-div',
+    mediaTypes: {
         banner: {
-        sizes: [[1, 1]]
+            sizes: [[1, 1]]
+        }
     },
     bids: [{
         bidder: 'adquery',

From 0016ad10992ce96b508fd7fc9800fe9b15474a61 Mon Sep 17 00:00:00 2001
From: eknis <tem.eknis@gmail.com>
Date: Mon, 27 Apr 2026 14:50:23 +0900
Subject: [PATCH 566/665] add dev docs for IntimateMerger Analytics (#6525)

* add dev docs for IntimateMerger Analytics

* add dev docs for IntimateMerger Analytics: update optional cid

* Update dev-docs/analytics/imAnalytics.md
---
 dev-docs/analytics/imAnalytics.md | 47 +++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 dev-docs/analytics/imAnalytics.md

diff --git a/dev-docs/analytics/imAnalytics.md b/dev-docs/analytics/imAnalytics.md
new file mode 100644
index 0000000000..4ed45592cc
--- /dev/null
+++ b/dev-docs/analytics/imAnalytics.md
@@ -0,0 +1,47 @@
+---
+layout: analytics
+title: IM Analytics
+description: IM Analytics Adapter for Prebid.js
+modulecode: imAnalytics
+gdpr_supported: false
+usp_supported: true
+gpp_supported: true
+coppa_supported: true
+enable_download: true
+---
+
+## Description
+
+Analytics Adapter for IM-DMP.
+
+Please visit [intimatemerger.com/im-uid](https://intimatemerger.com/r/im-uid) and request your Customer ID to get started.
+
+If you are an existing publisher and you already use [IM-UID](/dev-docs/modules/userid-submodules/imuid.html), you can use the same Customer ID for this analytics adapter.
+
+By enabling this adapter, you agree to Intimate Merger's privacy policy at <https://corp.intimatemerger.com/privacypolicy/>.
+
+## Configuration
+
+To enable the IM Analytics adapter, configure it in your Prebid.js setup. Use `imAnalytics` as the provider and provide the appropriate `options`.
+
+### Analytics Options
+
+{: .table .table-bordered .table-striped }
+| Parameter | Scope | Type | Example | Description |
+| --- | --- | --- | --- | --- |
+| `cid` | optional | number | 5126 | The Customer ID provided by Intimate Merger. |
+| `waitTimeout` | optional | number | 1500 | Wait time in milliseconds before sending batched requests. (Default: 1500) |
+
+### Example Configuration
+
+```javascript
+pbjs.enableAnalytics({
+    provider: 'imAnalytics',
+    options: {
+        /* Optional: Customer ID. Set the Customer ID assigned to you. */
+        cid: 5126,
+        /* Optional: Wait 2 seconds */
+        waitTimeout: 2000
+    }
+});
+```

From d3ff5e90f0abebdb8a36abb6dd3cba2be8c4c23c Mon Sep 17 00:00:00 2001
From: symplorpro <161946060+symplorpro@users.noreply.github.com>
Date: Mon, 27 Apr 2026 11:21:52 +0530
Subject: [PATCH 567/665] Add Rediads user ID module documentation (#6503)

* Add Rediads user ID module documentation

* Add a fix for build failure

* Add a fix for build failure
---
 dev-docs/bidders/rediads.md                   |  30 +++--
 dev-docs/modules/userid-submodules/rediads.md | 125 ++++++++++++++++++
 2 files changed, 145 insertions(+), 10 deletions(-)
 create mode 100644 dev-docs/modules/userid-submodules/rediads.md

diff --git a/dev-docs/bidders/rediads.md b/dev-docs/bidders/rediads.md
index 180b8a9938..35abcb8a17 100644
--- a/dev-docs/bidders/rediads.md
+++ b/dev-docs/bidders/rediads.md
@@ -16,24 +16,26 @@ safeframes_ok: false
 deals_supported: false
 floors_supported: true
 fpd_supported: true
+userIds: rediadsId
 ortb_blocking_supported: partial
 privacy_sandbox: no
 multiformat_supported: will-bid-on-one
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name         | Scope    | Description                                                                 | Example              | Type           |
-|--------------|----------|-----------------------------------------------------------------------------|----------------------|----------------|
-| account_id   | required | Account ID generated on the Rediads Platform.                               | '123xyz'             | string       |
-| endpoint     | optional | Only to be used if RediAds team provides you with one.                      | 'bidding2'        | string       |
-| slot         | optional | Unique identifier for the ad slot generated on the platform.                | '54321'              | string       |
+
+| Name       | Scope    | Description                                                  | Example      | Type   |
+| ---------- | -------- | ------------------------------------------------------------ | ------------ | ------ |
+| account_id | required | Account ID generated on the Rediads Platform.                | `'123xyz'`   | string |
+| endpoint   | optional | Only to be used if RediAds team provides you with one.       | `'bidding2'` | string |
+| slot       | optional | Unique identifier for the ad slot generated on the platform. | `'54321'`    | string |
 
 ---
 
-### Enabling Test Bids
+## Enabling Test Bids
 
 To enable test bids for the Rediads Bidder Adapter, append rediads-test-bids to the hash of the page URL.
 
@@ -46,9 +48,9 @@ This will activate test bids for debugging and validation purposes.
 
 ---
 
-### AdUnit Examples
+## AdUnit Examples
 
-#### AdUnit Format for Banner
+### AdUnit Format for Banner
 
 ```javascript
 var adUnits = [
@@ -72,7 +74,7 @@ var adUnits = [
 ];
 ```
 
-### First Party Data Support
+## First Party Data Support
 The following fields are supported for First Party Data (FPD):
 
 - `ortb2.site.*`
@@ -81,3 +83,11 @@ The following fields are supported for First Party Data (FPD):
 - `ortb2.devices.locations parameters`
 
 For additional implementation or support, contact us at <support@rediads.com>.
+
+## User ID Support
+
+The Rediads bidder supports the `rediadsId` user ID submodule. To build both together:
+
+```bash
+gulp build --modules=rediadsBidAdapter,userId,rediadsIdSystem
+```
diff --git a/dev-docs/modules/userid-submodules/rediads.md b/dev-docs/modules/userid-submodules/rediads.md
new file mode 100644
index 0000000000..d2d0775a15
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/rediads.md
@@ -0,0 +1,125 @@
+---
+layout: userid
+title: Rediads ID
+description: Rediads User ID sub-module
+useridmodule: rediadsIdSystem
+bidRequestUserId: rediadsId
+eidsource: rediads.com
+example: '"ruid_7b9c1d3f-1e2b-4e7b-9e5a-acde12345678"'
+---
+
+## Overview
+
+The Rediads User ID submodule generates a first-party browser identifier for publisher-side identity and makes it available to Prebid bidders through both `bidRequest.userId.rediadsId` and `bidRequest.userIdAsEids`.
+
+This submodule is implemented as a Prebid User ID module and uses Prebid-managed storage.
+
+## Registration
+
+For setup information, contact [support@rediads.com](mailto:support@rediads.com).
+
+## Installation
+
+Build Prebid.js with the User ID core module, the Rediads ID submodule, and optionally the Rediads bidder:
+
+```bash
+gulp build --modules=rediadsBidAdapter,userId,rediadsIdSystem
+```
+
+If you only need the user ID module, you can omit `rediadsBidAdapter`:
+
+```bash
+gulp build --modules=userId,rediadsIdSystem
+```
+
+## Configuration
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    userIds: [{
+      name: 'rediadsId',
+      params: {
+        source: 'rediads.com'
+      },
+      storage: {
+        type: 'html5',
+        name: 'rediads_id',
+        expires: 30,
+        refreshInSeconds: 3600
+      }
+    }]
+  }
+});
+```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Param under `userSync.userIds[]` | Scope | Type | Description | Example |
+| --- | --- | --- | --- | --- |
+| `name` | Required | String | Module identifier. Must be `"rediadsId"`. | `"rediadsId"` |
+| `params` | Optional | Object | Rediads-specific configuration. | |
+| `params.source` | Optional | String | EID source to emit. Defaults to `"rediads.com"`. | `"rediads.com"` |
+| `storage` | Recommended | Object | Prebid-managed storage configuration. | |
+| `storage.type` | Recommended | String | Storage type. Use `"html5"`, `"cookie"`, or `"cookie&html5"` as needed. | `"html5"` |
+| `storage.name` | Recommended | String | Storage key name. | `"rediads_id"` |
+| `storage.expires` | Optional | Number | Lifetime of the stored ID in days. Defaults to `30`. | `30` |
+| `storage.refreshInSeconds` | Optional | Number | Refresh interval in seconds. Defaults to `3600`. | `3600` |
+
+## Privacy Handling
+
+The Rediads ID submodule follows the standard Prebid User ID privacy flow.
+
+- If COPPA applies, the module does not create or return an ID.
+- If GDPR applies without a valid consent string and Purpose 1 consent, the module does not create or return an ID.
+- If US Privacy or GPP opt-out signals restrict sharing, the module may still retain its local ID state but does not emit EIDs for bidder sharing.
+
+The module uses Prebid's vendorless TCF marker so purpose-level enforcement applies without requiring a separate vendor registration in the module config.
+
+## Bid Request Output
+
+When available, the Rediads ID is exposed on the bid request as:
+
+```javascript
+bidRequest.userId.rediadsId
+```
+
+Example:
+
+```json
+{
+  "uid": "ruid_7b9c1d3f-1e2b-4e7b-9e5a-acde12345678",
+  "source": "rediads.com",
+  "atype": 1,
+  "ext": {
+    "canShare": true
+  }
+}
+```
+
+## EID Output
+
+When sharing is permitted, the module contributes the following EID:
+
+```json
+{
+  "source": "rediads.com",
+  "uids": [{
+    "id": "ruid_7b9c1d3f-1e2b-4e7b-9e5a-acde12345678",
+    "atype": 1
+  }]
+}
+```
+
+## Testing
+
+After building Prebid.js with `userId` and `rediadsIdSystem`, you can verify the module with:
+
+```javascript
+pbjs.getUserIds()
+pbjs.getUserIdsAsEids()
+```
+
+You should see `rediadsId` in `getUserIds()` and a `rediads.com` entry in `getUserIdsAsEids()` when privacy settings allow sharing.

From cc5089171cc0e405c4632dd0d9c1ee57cb463848 Mon Sep 17 00:00:00 2001
From: pritishmd-talentica
 <159415077+pritishmd-talentica@users.noreply.github.com>
Date: Mon, 27 Apr 2026 18:09:49 +0530
Subject: [PATCH 568/665] AdSmartX Bidder Documentation : New Bidder Adapter
 (#6467)

* RM-1476 : Bidder documentation for adsmartx

* copilot review comments

* Modified docs

* Added support for prebid server

* Fixed markdown lint issues

---------

Co-authored-by: Sushant Dey <sushant.dey@talentica.com>
---
 dev-docs/bidders/adsmartx.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 dev-docs/bidders/adsmartx.md

diff --git a/dev-docs/bidders/adsmartx.md b/dev-docs/bidders/adsmartx.md
new file mode 100644
index 0000000000..81951a39df
--- /dev/null
+++ b/dev-docs/bidders/adsmartx.md
@@ -0,0 +1,30 @@
+---
+layout: bidder
+title: AdSmartX
+description: Prebid.js bidder adapter for AdSmartX
+biddercode: adsmartx
+media_types:
+  - banner
+  - video
+gdpr_supported: true
+usp_supported: true
+gpp_supported: true
+user_sync: true
+schain_supported: true
+pbjs: true
+sidebarType: 1
+---
+
+## Overview
+
+AdSmartX is a digital advertising platform that supports banner and video ads through its Prebid.js adapter. The adapter uses OpenRTB standards for request and response formatting.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Type   | Description                             | Example      |
+|-------------|----------|--------|-----------------------------------------|--------------|
+| `bidFloor`  | optional | string | Bid Floor                               | `'0.01'`     |
+| `testMode`  | optional | string | Parameter to indicate prebid test mode  | `'1'`        |
+| `sspId`     | optional | string | Supply Partner ID                       | `'111111'`   |
+| `siteId`    | optional | string | Supply Partner Site ID                  | `'222222'`   |

From 5501e755d0b7a5dc188cf8b6fbe4c1298248e748 Mon Sep 17 00:00:00 2001
From: Arthur Buchatsky <66466997+Arthur482@users.noreply.github.com>
Date: Mon, 27 Apr 2026 19:08:44 +0300
Subject: [PATCH 569/665] pixfuture.md file update (#6526)

* Update for pixfuture.md

* Made changes regarding GitHub reviews

* Made changes regarding GitHub reviews

* Made changes regarding GitHub reviews

* Update of pixfuture.md

* Enhance PixFuture documentation for video support

Updated PixFuture adapter documentation to include video media type support and improved clarity in examples.

* Improve markdown formatting in pixfuture.md

Updated markdown formatting for better readability.

* Enhance PixFuture documentation with video example

Added a video example section to the PixFuture documentation, explaining the configuration for instream video auctions and VAST responses.

* Update PixFuture adapter documentation

Add configuration details for PixFuture adapter in video auctions.

* Add table styling for bid parameters in pixfuture.md

* remove ---

* remove ---

* relative links

* remove ---

* remove ---

* remove ---

* remove blank line

* remove blank line

* remove blank line

* remove blank line

---------

Co-authored-by: pixfuture-media <v.ioussoupov@pixfuture.com>
Co-authored-by: Vitali Ioussoupov <84333122+pixfuture-media@users.noreply.github.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/pixfuture.md | 131 ++++++++++++++++++++++------------
 1 file changed, 86 insertions(+), 45 deletions(-)

diff --git a/dev-docs/bidders/pixfuture.md b/dev-docs/bidders/pixfuture.md
index fd5a5fd2ea..b10b497fac 100644
--- a/dev-docs/bidders/pixfuture.md
+++ b/dev-docs/bidders/pixfuture.md
@@ -3,7 +3,7 @@ layout: bidder
 title: PixFuture
 description: Prebid PixFuture Bidder Adapter
 biddercode: pixfuture
-media_types: banner
+media_types: banner, video
 gvl_id: 839
 tcfeu_supported: true
 prebid_member: false
@@ -15,68 +15,109 @@ pbjs: true
 sidebarType: 1
 ---
 
-### Overview
+## Overview
 
-The PixFuture Bidder Adapter connects publishers to PixFuture’s demand via Prebid.js, supporting banner media types. To use this adapter, your PixFuture account must be approved for Prebid integration. Contact <support@pixfuture.com> to request activation or for setup assistance.
+The PixFuture Bidder Adapter connects publishers to PixFuture’s demand via Prebid.js, supporting **banner and video media types**.
 
-#### Solution
+To use this adapter, your PixFuture account must be approved for Prebid integration. Contact <support@pixfuture.com> to request activation or for setup assistance.
 
-To download the PixFuture adapter for Prebid.js, visit [https://docs.prebid.org/download.html](https://docs.prebid.org/download.html) and select the `pixfuture` bidder from the list, along with other bidders you wish to include in your build.
+### Solution
 
-**Important:** The `pixfuture` adapter requires account approval from PixFuture. To enable this integration, email <support@pixfuture.com>.
+To download the PixFuture adapter for Prebid.js, visit:
 
----
+[/download] 
 
-### Bid Parameters
+Select the `pixfuture` bidder from the list, along with other bidders you wish to include in your build.
 
-| Name       | Scope    | Description                                                        | Example       | Type     |
-|------------|----------|--------------------------------------------------------------------|---------------|----------|
-| `pix_id`   | required | A unique ID for your site’s ad placement. Corresponds to each ad size. | `"12312345"`    | `string` |
+**Important:**  
+The `pixfuture` adapter requires account approval from PixFuture.  
+To enable this integration, email <support@pixfuture.com>.
 
-These bid parameters are supported the Prebid.js pixfuture adapter.
+### Bid Parameters
 
-The `pix_id` is a unique identifier provided by PixFuture and must be specified for each ad placement/size combination.
+{: .table .table-bordered .table-striped }
+| Name     | Scope    | Description                                                                               | Example      | Type     |
+|----------|----------|-------------------------------------------------------------------------------------------|--------------|----------|
+| `pix_id` | required | A unique ID for your site’s ad placement. Corresponds to each ad size or video placement. | `"12312345"` | `string` |
 
----
+These bid parameters are supported by the Prebid.js PixFuture adapter.
+
+The `pix_id` is a unique identifier provided by PixFuture and must be specified for each ad placement.
 
-### Prebid.js Integration
+# Prebid.js Integration
 
-#### Basic Prebid.js Example
+## Banner Example
 
-Below is an example of configuring ad units for PixFuture in Prebid.js:
+Below is an example configuration for banner inventory.
 
 ```javascript
 var adUnits = [
-    {
-        code: 'test-div-300x250',
-        mediaTypes: {
-            banner: {
-                sizes: [[300, 250]]
-            }
-        },
-        bids: [
-            {
-                bidder: 'pixfuture',
-                params: {
-                    pix_id: "11234567890"
-                }
+{
+    code: 'test-div-300x250',
+    mediaTypes: {
+        banner: {
+            sizes: [[300, 250]]
+        }
+    },
+    bids: [
+        {
+            bidder: 'pixfuture',
+            params: {
+                pix_id: "098765"
             }
-        ]
+        }
+    ]
+},
+{
+    code: 'test-div2-728x90',
+    mediaTypes: {
+        banner: {
+            sizes: [[728, 90]]
+        }
     },
-    {
-        code: 'test-div2-728x90',
-        mediaTypes: {
-            banner: {
-                sizes: [[728, 90]]
+    bids: [
+        {
+            bidder: 'pixfuture',
+            params: {
+                pix_id: "012345"
             }
-        },
-        bids: [
-            {
-                bidder: 'pixfuture',
-                params: {
-                    pix_id: "0987654321"
-                }
+        }
+    ]
+}
+];
+
+```
+
+## Video Example
+
+Below is an example configuration for video inventory.
+
+```javascript
+var adUnits = [
+{
+    code: 'video-ad-unit-1',
+    mediaTypes: {
+        video: {
+            context: 'instream',
+            playerSize: [[640, 320]],
+            mimes: ['video/mp4'],
+            protocols: [2, 3, 5, 6],
+            playbackmethod: [2],
+            api: [2],
+            placement: 1
+        }
+    },
+    bids: [
+        {
+            bidder: 'pixfuture',
+            params: {
+                pix_id: '012345'
             }
-        ]
-    }
+        }
+    ]
+}
 ];
+
+```
+
+This configuration enables the PixFuture adapter to participate in instream video auctions and return VAST responses that can be rendered by VAST-compatible video players (e.g., Google IMA SDK or Video.js).

From 42b7e1d06394da63406962f0b5889ee15c53d2b6 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Wed, 29 Apr 2026 09:41:57 +0200
Subject: [PATCH 570/665] Default deferS2Sbidders value fix (#6548)

* Default value fix

* fixing linting errors

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
---
 dev-docs/modules/tcfControl.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/tcfControl.md b/dev-docs/modules/tcfControl.md
index df8e64a7cd..bc014c5625 100644
--- a/dev-docs/modules/tcfControl.md
+++ b/dev-docs/modules/tcfControl.md
@@ -48,9 +48,9 @@ The following table details the Prebid.js activities that fall under the [Transp
 | Read and write data to device | Purpose 1 - Store and/or access information on a device | May prevent one or more adapters or modules from being able to read or write cookies or localstorage in the user's browser. | 3.14+ |
 | Perform header bidding auction | Purpose 2 - Basic ads | May prevent one or more bid adapters from participating in the auction. | 4.0+ |
 | Transmit user first party data to partners | Purpose 4 -  Personalized ads | May prevent  one or more modules from receiving user first party data | 8.16+ |
-| Transmit Extended User IDs to partners | Depends on configuration (see [note](#note-transmitEids))| May prevent one or more modules from receiving user IDs and EIDs. | 8.16+ |
+| Transmit Extended User IDs to partners | Depends on configuration (see [note](#note-transmitEids)) | May prevent one or more modules from receiving user IDs and EIDs. | 8.16+ |
 | Invoke analytics adapters | Purpose 7 - Measurement | May prevent one or more analytics adapters from participating in the auction. | 4.x+ |
-| Transmit precise geolocation data to partners | Specal Feature 1 - Use precise geolocation data |  May cause geolocation data to be truncated for one or more modules | 8.16+ |
+| Transmit precise geolocation data to partners | Specal Feature 1 - Use precise geolocation data | May cause geolocation data to be truncated for one or more modules | 8.16+ |
 
 ## Page Integration
 
@@ -79,7 +79,7 @@ The following fields related to anonymizing aspects of the auction are supported
 | gdpr.rules[].softVendorExceptions | `Array of Strings` | Defines a list of biddercodes or module names that are exempt from the checking vendor signals for this purpose. Unlike with `vendorExceptions`, Purpose consent is still checked. **Note:** Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor. | ["bidderA", "userID-module-B"] |
 | gdpr.rules[].eidsRequireP4Consent | `Boolean` | Only relevant on the personalizedAds `purpose`. If true, user IDs and EIDs will not be shared without evidence of consent for TCF Purpose 4. If false, evidence of consent for any of Purposes 2-10 is sufficient for sharing user IDs and EIDs. Defaults to false. See [note](#note-transmitEids) | true |
 | strictStorageEnforcement | `Boolean` | If false (the default), allows some use of storage regardless of purpose 1 consent - see [note](#strictStorageEnforcement) below | true |
-| gdpr.rules[].deferS2Sbidders | `Boolean` | If true, allows s2s bidders to bypass vendor consent check and delegate it to server. Applies only to `basicAds` rule. Defaults to true | true |
+| gdpr.rules[].deferS2Sbidders | `Boolean` | If true, allows s2s bidders to bypass vendor consent check and delegate it to server. Applies only to `basicAds` rule. Defaults to false | false |
 
 Notes:
 

From 87bd4c4a133508e96085d1f6733fb2050e3254cc Mon Sep 17 00:00:00 2001
From: Abdou <40374175+disparate1@users.noreply.github.com>
Date: Wed, 29 Apr 2026 20:50:46 +0200
Subject: [PATCH 571/665] Impactify Bid Adapter: add instream support (#6534)

* edit impactify.md

* Update impactify.md

* Edit impactify.md

* Edit impactify.md

* Edit impactify.md

* Edit impactify.md
---
 dev-docs/bidders/impactify.md | 191 ++++++++++++++++++++++++++++++----
 1 file changed, 171 insertions(+), 20 deletions(-)

diff --git a/dev-docs/bidders/impactify.md b/dev-docs/bidders/impactify.md
index 70dcb84f69..5cdbb86e7a 100644
--- a/dev-docs/bidders/impactify.md
+++ b/dev-docs/bidders/impactify.md
@@ -10,30 +10,181 @@ tcf2_supported: true
 usp_supported: true
 schain_supported: true
 coppa_supported: true
-media_types: video
+floors_supported: true
+media_types: banner, video
 userIds: criteo, id5Id, pubCommonId, unifiedId, uid2, netId
 gvl_id: 606
 sidebarType: 1
 ---
 
-### Note
+## Note
 
-The Impactify adaptator requires setup and validation from the Impactify team. Simply email us your contact details at <support@impactify.io> and we'll make sure we'll connect you within 48h.
+The Impactify adapter requires setup and validation from the Impactify team. Simply email us your contact details at <support@impactify.io> and we'll make sure we connect with you within 48 hours.
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                                        | Example        | Type      |
-|---------------|----------|----------------------------------------------------|----------------|-----------|
-| `appId`       | required | Impactify publisher id  (Contact us)               | `'example.com'`  | `string`  |
-| `format`      | required | Impactify ad format (screen or display)            | `'screen'`       | `string`  |
-| `style`       | required | Impactify ad style (inline, impact or static)      | `'impact'`       | `string`  |
+| Name        | Scope    | Description                                                                                            | Example                          | Type     |
+| ----------- | -------- | ------------------------------------------------------------------------------------------------------ | -------------------------------- | -------- |
+| `accountId` | required | Impactify publisher ID.                                                                                | `'1234'`                         | `string` |
+| `appId`     | required | Impactify inventory ID.                                                                                | `'example.com'`                  | `string` |
+| `format`    | required | Impactify ad format. Use `screen` for rich media and banner, and `player` for instream video.          | `'screen'`                       | `string` |
+| `style`     | required | Impactify ad style. Supported values depend on the integration type. See below.                        | `'impact'`                       | `string` |
+| `size`      | optional | Impactify ad size.                                                                                     | `'300x250'`                      | `string` |
+| `render`    | optional | Render options. See sub-options below.                                                                 | `{ bottom: 10, expandAd: true }` | `object` |
+
+#### `render` sub-options
+
+{: .table .table-bordered .table-striped }
+| Name              | Scope    | Description                                                  | Example                | Type      |
+| ----------------- | -------- | ------------------------------------------------------------ | ---------------------- | --------- |
+| `top`             | optional | Top offset used for ad rendering.                            | `10`                   | `number`  |
+| `bottom`          | optional | Bottom offset used for ad rendering.                         | `10`                   | `number`  |
+| `expandAd`        | optional | Enables ad expansion behavior when supported.                | `true`                 | `boolean` |
+| `location`        | optional | Changes the position of the player.                          | `'top-left'`           | `string`  |
+| `onAdEventName`   | optional | Name of the browser event fired when an ad is rendered.      | `'impactifyAdLoaded'`  | `string`  |
+| `onNoAdEventName` | optional | Name of the browser event fired when no ad is returned.      | `'impactifyNoAd'`      | `string`  |
+
+### Integration Types
+
+Impactify supports three integration types:
+
+- **Rich media formats**: for Impactify rich media experiences using `format: "screen"` with styles such as `impact`, `inline`, `skyline`, or `static`.
+- **Instream Video**: for standard instream video using `format: "player"`.
+- **Banner**: for standard banner placements, typically using `format: "screen"` with `style: "static"`.
+
+### Rich media formats
+
+Use this integration for rich media placements.
+
+#### Supported styles
+
+- **impact**: sticky at the bottom.
+- **inline**: in-content, then sticky at the bottom on scroll.
+- **skyline**: in-content, then sticky at the top on scroll.
+- **static**: in-content, non-sticky.
+
+```javascript
+var impactAdUnit = [
+  {
+    code: "Publisher DIV",
+    mediaTypes: {
+      banner: {
+        sizes: [[1, 1]]
+      }
+    },
+    bids: [
+      {
+        bidder: "impactify",
+        params: {
+          accountId: "YOUR_ACCOUNTID_HERE",
+          appId: "YOUR_APPID_HERE",
+          format: "screen",
+          style: "impact"
+        }
+      }
+    ]
+  }
+];
+
+//For inline, skyline or static style placements
+var richMediAdUnit = [
+  {
+    code: "Publisher DIV",
+    mediaTypes: {
+      banner: {
+        sizes: [[336, 280]]
+      }
+    },
+    bids: [
+      {
+        bidder: "impactify",
+        params: {
+          accountId: "YOUR_ACCOUNTID_HERE",
+          appId: "YOUR_APPID_HERE",
+          format: "screen",
+          style: "inline" // or "skyline" or "static"
+        }
+      }
+    ]
+  }
+];
+```
+
+### Instream Video
+
+Use this integration for instream video only.
+
+```javascript
+var instreamAdUnit = [
+  {
+    code: "Publisher DIV",
+    mediaTypes: {
+      video: {
+        context: "instream",
+        playerSize: [640, 360],
+        mimes: ["video/mp4", "video/webm", "application/javascript"],
+        minduration: 1,
+        maxduration: 35,
+        protocols: [2, 3, 5, 6, 7, 8, 11, 12, 13, 14],
+        api: [2, 7, 8],
+        placement: 1,
+        plcmt: 1,
+        startdelay: 0,
+        playbackmethod: [1, 2, 6],
+        skip: 1
+      }
+    },
+    bids: [
+      {
+        bidder: "impactify",
+        params: {
+          accountId: "YOUR_ACCOUNTID_HERE",
+          appId: "YOUR_APPID_HERE",
+          format: "player"
+        }
+      }
+    ]
+  }
+];
+```
+
+### Banner
+
+Use this integration for standard banner placements with standard IAB sizes.
+
+```javascript
+var bannerAdUnit = [
+  {
+    code: "Publisher DIV",
+    mediaTypes: {
+      banner: {
+        sizes: [
+          [300, 250],
+          [336, 280]
+        ]
+      }
+    },
+    bids: [
+      {
+        bidder: "impactify",
+        params: {
+          accountId: "YOUR_ACCOUNTID_HERE",
+          appId: "YOUR_APPID_HERE",
+          format: "screen",
+          style: "static"
+        }
+      }
+    ]
+  }
+];
+```
 
 ### Configuration
 
 Impactify recommends the UserSync configuration below. Without it, the Impactify adapter will not be able to perform user syncs, which lowers match rate and reduces monetization.
 
-Note : Impactify adapter needs storage access to work properly (Do not forget to set storageAllowed to true).
+Note: Impactify adapter needs storage access to work properly. Do not forget to set `storageAllowed` to `true`.
 
 {% include dev-docs/storageAllowed.md %}
 
@@ -41,16 +192,16 @@ For Prebid.js v1.15.0 and later:
 
 ```javascript
 pbjs.bidderSettings = {
-    impactify: {
-        storageAllowed: true // Mandatory
-    }
+  impactify: {
+    storageAllowed: true // Mandatory
+  }
 };
 
 pbjs.setConfig({
   userSync: {
     filterSettings: {
       iframe: {
-        bidders: '*',      // '*' represents all bidders
+        bidders: '*',
         filter: 'include'
       }
     }
@@ -61,18 +212,18 @@ pbjs.setConfig({
 For Prebid.js v1.14.0 and before:
 
 ```javascript
-
 pbjs.bidderSettings = {
-    impactify: {
-        storageAllowed: true // Mandatory
-    }
+  impactify: {
+    storageAllowed: true // Mandatory
+  }
 };
 
 pbjs.setConfig({
-   userSync: {
+  userSync: {
     iframeEnabled: true,
     enabledBidders: ['impactify']
- }});
+  }
+});
 ```
 
-Note: Combine the above configuration with any other UserSync configuration. Multiple setConfig() calls overwrite each other and only the last call for a given attribute will take effect.
+Note: Combine the above configuration with any other UserSync configuration. Multiple `setConfig()` calls overwrite each other and only the last call for a given attribute takes effect.

From 77bb4cfbd5ab43de7151a0e4af4bb4c5e94e9162 Mon Sep 17 00:00:00 2001
From: shiba44 <38831888+shiba44@users.noreply.github.com>
Date: Thu, 30 Apr 2026 14:57:07 +0900
Subject: [PATCH 572/665] add LOGLY bidder adapter (#6514)

* add logly bidder adapter

* Address markdownlint error in LOGLY bidder doc

* add meta data for logly bidder adapter
---
 dev-docs/bidders/logly.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/logly.md

diff --git a/dev-docs/bidders/logly.md b/dev-docs/bidders/logly.md
new file mode 100644
index 0000000000..f693ea85e1
--- /dev/null
+++ b/dev-docs/bidders/logly.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: LOGLY
+description: Prebid LOGLY Bidder Adapter
+biddercode: logly
+media_types: banner
+pbjs: true
+pbs: false
+userIds: imuid
+sidebarType: 1
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+safeframes_ok: false
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name       | Scope    | Description     | Example   | Type      |
+|------------|----------|-----------------|-----------|-----------|
+| `adspotId` | required | LOGLY Adspot ID | `4338071` | `integer` |

From f982b0ead4e0336e443051a8127450e0412cc996 Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Thu, 30 Apr 2026 14:01:02 +0200
Subject: [PATCH 573/665] MTC Bid Adapter added (#6541)

* mtc added

* lint fix

---------

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
---
 dev-docs/bidders/mtc.md | 113 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 dev-docs/bidders/mtc.md

diff --git a/dev-docs/bidders/mtc.md b/dev-docs/bidders/mtc.md
new file mode 100644
index 0000000000..4a0eb7c814
--- /dev/null
+++ b/dev-docs/bidders/mtc.md
@@ -0,0 +1,113 @@
+---
+layout: bidder
+title: Media Tradecraft
+description: Prebid Media Tradecraft Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: mtc
+gvl_id: none
+tcfeu_supported: true
+usp_supported: true
+gpp_sids: tcfeu
+schain_supported: true
+dchain_supported: false
+floors_supported: true
+userIds: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+sidebarType: 1
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                | Example                                   | Type      |
+|---------------|----------|----------------------------|--------------------------------------     |-----------|
+| `tagId`       | required*| Media Tradecraft tag ID    | `"testnexx"`                              | `string`  |
+| `placement`   | required*| Media Tradecraft placement | `"test.com_header_ad"`                    | `string`  |
+
+*You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
+The `tagId` and `placement` are **mutually exclusive** but at least one is required. If you pass both, `tagId` takes precedence.
+
+## Bidder Config
+
+You can allow writing in localStorage `pbjs.bidderSettings` for the bidder `mtc`
+
+{% include dev-docs/storageAllowed.md %}
+
+```javascript
+pbjs.bidderSettings = {
+    mtc: {
+        storageAllowed : true
+    }
+}
+```
+
+## First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+
+## Test Parameters
+
+```javascript
+var adUnits = [
+   // Banner adUnit
+   {
+      code: 'banner-div',
+      mediaTypes: {
+        banner: {
+          sizes: [[300, 250], [300,600]]
+        }
+      },
+      bids: [{
+         bidder: 'mtc',
+         params: {
+            tagId: 'testnexx'
+         }
+       }]
+   },
+   // Video adUnit
+   {
+        code: 'video1',
+        mediaTypes: {
+            video: {
+                playerSize: [640, 480],
+                context: 'instream'
+            }
+        },
+        bids: [{
+            bidder: 'mtc',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    },
+     // Native adUnit
+   {
+        code: 'native1',
+        mediaTypes: {
+            native: {
+                title: {
+                    required: true
+                },
+                image: {
+                    required: true
+                },
+                sponsoredBy: {
+                    required: true
+                }
+            }
+        },
+        bids: [{
+            bidder: 'mtc',
+            params: {
+               tagId: 'testnexx'
+            }
+        }]
+    }
+];
+```

From 8c22be433e28865e9ee7fe1d5cd2c8fb0dbd8500 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Thu, 30 Apr 2026 14:03:38 +0200
Subject: [PATCH 574/665] gvl_id necesssary for technical TCF support (#6549)

---
 dev-docs/bidders/mtc.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/mtc.md b/dev-docs/bidders/mtc.md
index 4a0eb7c814..30318fd57f 100644
--- a/dev-docs/bidders/mtc.md
+++ b/dev-docs/bidders/mtc.md
@@ -6,9 +6,9 @@ pbjs: true
 pbs: false
 biddercode: mtc
 gvl_id: none
-tcfeu_supported: true
+tcfeu_supported: false
 usp_supported: true
-gpp_sids: tcfeu
+gpp_sids: none
 schain_supported: true
 dchain_supported: false
 floors_supported: true

From e006ecbc213cfdad0e9b86100ec63cabd6cb084f Mon Sep 17 00:00:00 2001
From: Antonio Gargaro <38767071+AntonioGargaro@users.noreply.github.com>
Date: Thu, 30 Apr 2026 16:04:41 +0100
Subject: [PATCH 575/665] Permutive RTD: document msft bidder custom cohort
 support (#6522)

* docs: update permutiveRtdProvider.md for msft bidder custom cohorts

Add msft to supported custom cohort bidders list, document the new
params.bidders configuration, and note the appnexus-to-msft migration path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: align markdown table columns to pass MD060 lint rule

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* remove hardcoded msft default from docs, add publisher config example

Mirrors the code change in Prebid.js PR #14655. The params.bidders
default is now {} and publishers must explicitly configure msft
custom cohort sources.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 dev-docs/modules/permutiveRtdProvider.md | 32 ++++++++++++++++++------
 1 file changed, 25 insertions(+), 7 deletions(-)

diff --git a/dev-docs/modules/permutiveRtdProvider.md b/dev-docs/modules/permutiveRtdProvider.md
index 10c3836212..0b5fcee63c 100644
--- a/dev-docs/modules/permutiveRtdProvider.md
+++ b/dev-docs/modules/permutiveRtdProvider.md
@@ -61,13 +61,17 @@ as well as enabling settings for specific use cases mentioned above (e.g. acbidd
 
 {: .table .table-bordered .table-striped }
 
-| Name                   | Type                 | Description                                                                                   | Default            |
-| ---------------------- | -------------------- | --------------------------------------------------------------------------------------------- | ------------------ |
-| name                   | String               | This should always be `permutive`                                                             | -                  |
-| waitForIt              | Boolean              | Should be `true` if there's an `auctionDelay` defined (optional)                              | `false`            |
-| params                 | Object               |                                                                                               | -                  |
-| params.acBidders       | String[]             | An array of bidder codes to share cohorts with in certain versions of Prebid, see below                         | `[]`               |
-| params.maxSegs         | Integer              | Maximum number of cohorts to be included in either the `permutive` or `p_standard` key-value. | `500`              |
+| Name                                           | Type                 | Description                                                                                    | Default                                                         |
+| ---------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| name                                           | String               | This should always be `permutive`                                                              | -                                                               |
+| waitForIt                                      | Boolean              | Should be `true` if there's an `auctionDelay` defined (optional)                               | `false`                                                         |
+| params                                         | Object               |                                                                                                | -                                                               |
+| params.acBidders                               | String[]             | An array of bidder codes to share cohorts with in certain versions of Prebid, see below        | `[]`                                                            |
+| params.maxSegs                                 | Integer              | Maximum number of cohorts to be included in either the `permutive` or `p_standard` key-value.  | `500`                                                           |
+| params.bidders                                 | Object               | Per-bidder configuration for custom cohort sources. Keys are bidder codes.                     | `{}`                                                            |
+| params.bidders.\<bidder\>.customCohorts        | Object               | Custom cohorts source configuration for a specific bidder.                                     | -                                                               |
+| params.bidders.\<bidder\>.customCohorts.source | String               | Storage type to read custom cohorts from. Currently only `'ls'` (localStorage) is supported.   | -                                                               |
+| params.bidders.\<bidder\>.customCohorts.key    | String               | The localStorage key to read custom cohorts from.                                              | -                                                               |
 
 ### Context
 
@@ -132,11 +136,25 @@ Currently, bidders with known support for custom cohort targeting are:
 
 * Xandr
 * Magnite
+* Microsoft (msft)
 
 When enabling the respective Activation for a cohort in Permutive, this module will automatically attach that cohort ID to the bid request.
 There is no need to enable individual bidders in the module configuration, it will automatically reflect which SSP integrations you have enabled in your Permutive dashboard.
 Permutive cohorts will be sent in the permutive key-value.
 
+**Note:** Publishers migrating from the `appnexus` bidder to `msft` need to configure the `params.bidders` object so the module knows where to read custom cohorts from. The Permutive SDK writes `msft` custom cohorts to the same localStorage key used by `appnexus` (`_papns`), so publishers should add the following to their Permutive RTD config:
+
+```javascript
+params: {
+  acBidders: ['msft'],
+  bidders: {
+    msft: {
+      customCohorts: { source: 'ls', key: '_papns' }
+    }
+  }
+}
+```
+
 ### _Enabling Advertiser Cohorts_
 
 If you are connecting to an Advertiser seat within Permutive to share Advertiser Cohorts,  populate the acbidders config in the Permutive RTD with an array of bidder codes with whom you wish to share Advertiser Cohorts with.

From 0b960896bc012e2e30b5160ff93b148d7a1b8590 Mon Sep 17 00:00:00 2001
From: mihanikw2g <92710748+mihanikw2g@users.noreply.github.com>
Date: Sat, 2 May 2026 20:10:11 +0700
Subject: [PATCH 576/665] Asterio docs: add bidder documentation (#6521)

* Asterio docs: add bidder documentation

* Asterio docs: fix markdownlint issues

* Asterio docs: simplify table formatting

* Asterio docs: add meta data

* Update dev-docs/bidders/asterio.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/asterio.md | 78 +++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 dev-docs/bidders/asterio.md

diff --git a/dev-docs/bidders/asterio.md b/dev-docs/bidders/asterio.md
new file mode 100644
index 0000000000..00b3faa254
--- /dev/null
+++ b/dev-docs/bidders/asterio.md
@@ -0,0 +1,78 @@
+---
+layout: bidder
+title: Asterio
+description: Prebid Asterio Bidder Adapter
+biddercode: asterio
+pbjs: true
+pbs: false
+media_types: banner, video
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: true
+dchain_supported: false
+userId: none
+safeframes_ok: false
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `adUnitToken` | required | Ad unit token provided by Asterio. | `'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'` | `string` |
+| `pos` | optional | Ad position hint. Allowed values follow OpenRTB position conventions, e.g. above the fold: `1`, below the fold: `3`, middle of the fold: `7`. | `1` | `integer` |
+
+## Banner Test Ad Unit
+
+```javascript
+var adUnits = [{
+  code: 'test-banner',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]]
+    }
+  },
+  bids: [{
+    bidder: 'asterio',
+    params: {
+      adUnitToken: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+    }
+  }]
+}];
+```
+
+## Video Test Ad Unit
+
+```javascript
+var adUnits = [{
+  code: 'test-video',
+  mediaTypes: {
+    video: {
+      context: 'outstream',
+      playerSize: [640, 360],
+      mimes: ['video/mp4'],
+      protocols: [2, 3],
+      playbackmethod: [2],
+      plcmt: 4
+    }
+  },
+  bids: [{
+    bidder: 'asterio',
+    params: {
+      adUnitToken: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+    }
+  }]
+}];
+```

From 541eb47ab4c86d6b4625de9385586f7e2540573f Mon Sep 17 00:00:00 2001
From: Eugene Dorfman <eugene.dorfman@gmail.com>
Date: Tue, 5 May 2026 10:45:55 +0200
Subject: [PATCH 577/665] 51d: introduce hwv into PBS module (#6517)

* 51d: introduce hwv into PBS module

associated PBS PRs:
- https://github.com/prebid/prebid-server-java/pull/4458
- https://github.com/prebid/prebid-server/pull/4740

* fix table styles to satisfy markdownlint
---
 .../pbs-modules/51degrees-device-detection.md | 25 ++++++++++---------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/prebid-server/pbs-modules/51degrees-device-detection.md b/prebid-server/pbs-modules/51degrees-device-detection.md
index 6d936e3169..d6c64d5b4f 100644
--- a/prebid-server/pbs-modules/51degrees-device-detection.md
+++ b/prebid-server/pbs-modules/51degrees-device-detection.md
@@ -19,7 +19,7 @@ sidebarType : 5
 
 The 51Degrees module enriches an incoming OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/_device_detection__overview.html).
 
-The module sets the following fields of the device object: `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio` - interested bidder adapters may use these fields as needed.  In addition the module sets `device.ext.fiftyonedegrees_deviceId` to a permanent device ID which can be rapidly looked up in on premise data exposing over 250 properties including the device age, chip set, codec support, and price, operating system and app/browser versions, age, and embedded features.
+The module sets the following fields of the device object: `make`, `model`, `hwv`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio` - interested bidder adapters may use these fields as needed.  In addition the module sets `device.ext.fiftyonedegrees_deviceId` to a permanent device ID which can be rapidly looked up in on premise data exposing over 250 properties including the device age, chip set, codec support, and price, operating system and app/browser versions, age, and embedded features.
 
 ## Operation Details
 
@@ -252,22 +252,22 @@ The parameter names are specified with full path using dot-notation.  F.e. `sect
 
 {: .table .table-bordered .table-striped }
 
-| PBS-Java Name | PBS-Go Name | Required| Type | Default  value | Description |
-|:-------|:-------|:------|:------|:------|:---------------------------------------|
-| `account-filter` .`allow-list` |  `account_filter` .`allow_list`  |  No | list of strings | [] (empty list) | A list of account IDs that are allowed to use this module - only relevant if enabled globally for the host. If empty, all accounts are allowed. Full-string match is performed (whitespaces and capitalization matter). |
-| `data-file` .`path`    |  `data_file` .`path`  |  **Yes** | string | null |The full path to the device detection data file. Sample file can be downloaded from the [51Degrees data repository](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash), or get an Enterprise data file from the [51Degrees pricing page](https://51degrees.com/pricing). |
+| PBS-Java Name | PBS-Go Name | Required | Type | Default value | Description |
+| :------ | :------ | :------ | :------ | :------ | :------ |
+| `account-filter` .`allow-list` | `account_filter` .`allow_list` | No | list of strings | [] (empty list) | A list of account IDs that are allowed to use this module - only relevant if enabled globally for the host. If empty, all accounts are allowed. Full-string match is performed (whitespaces and capitalization matter). |
+| `data-file` .`path` | `data_file` .`path` | **Yes** | string | null | The full path to the device detection data file. Sample file can be downloaded from the [51Degrees data repository](https://github.com/51Degrees/device-detection-data/blob/main/51Degrees-LiteV4.1.hash), or get an Enterprise data file from the [51Degrees pricing page](https://51degrees.com/pricing). |
 | `data-file` .`make-temp-copy` | `data_file` .`make_temp_copy` | No | boolean | true | If true, the engine will create a temporary copy of the data file rather than using the data file directly. |
 | `data-file` .`update` .`auto` | `data_file` .`update` .`auto` | No | boolean | true | If enabled, the engine will periodically (at predefined time intervals - see `polling-interval` parameter) check if new data file is available. When the new data file is available engine downloads it and switches to it for device detection. If custom `url` is not specified `license_key` param is required. |
 | `data-file` .`update` .`on-startup` | `data_file` .`update` .`on_startup` | No | boolean | true | If enabled, engine will check for the updated data file right away without waiting for the defined time interval. |
 | `data-file` .`update` .`url` | `data_file` .`update` .`url` | No | string | null | Configure the engine to check the specified URL for the availability of the updated data file. If not specified the [51Degrees distributor service](https://51degrees.com/documentation/4.4/_info__distributor.html) URL will be used, which requires a License Key. |
 | `data-file` .`update` .`license-key` | `data_file` .`update` .`license_key` | No | string | null | Required if `auto` is true and custom `url` is not specified. Allows to download the data file from the [51Degrees distributor service](https://51degrees.com/documentation/4.4/_info__distributor.html). |
 | `data-file` .`update` .`watch-file-system` | `data_file` .`update` .`watch_file_system` | No | boolean | true | If enabled the engine will watch the data file path for any changes, and automatically reload the data file from disk once it is updated. |
-| `data-file` .`update`.`polling-interval` | `data_file` .`update` .`polling_interval` | No | int | 1800 | The time interval in seconds between consequent attempts to download an updated data file. Default = 1800 seconds = 30 minutes. |
-| `performance` .`profile` | `performance` .`profile` | No | string | `Balanced` | `performance.*` parameters are related to the tradeoffs between speed of device detection and RAM consumption or accuracy. `profile` dictates the proportion between the use of the RAM (the more RAM used - the faster is the device detection) and reads from disk (less RAM but slower device detection). Must be one of: `LowMemory`, `MaxPerformance`, `HighPerformance`, `Balanced`, `BalancedTemp`, `InMemory`. Defaults to `Balanced`.  |
-| `performance` .`concurrency` | `performance` .`concurrency` | No | int | 10 |  Specify the expected number of concurrent operations that engine does. This sets the concurrency of the internal caches to avoid excessive locking. Default: 10.  |
-| `performance` .`difference` | `performance` .`difference` | No | int | 0 |  Set the maximum difference to allow when processing evidence (HTTP headers). The meaning is the difference in hash value between the hash that was found, and the hash that is being searched for. By default this is 0. For more information see [51Degrees documentation](https://51degrees.com/documentation/_device_detection__hash.html).  |
-| `performance` .`drift` | `performance` .`drift` | No | int | 0 |  Set the maximum drift to allow when matching hashes. If the drift is exceeded, the result is considered invalid and values will not be returned. By default this is 0. For more information see [51Degrees documentation](https://51degrees.com/documentation/_device_detection__hash.html).  |
-| `performance` .`allow-unmatched` | `performance` .`allow_unmatched` | No | boolean | false |  If set to false, a non-matching evidence will result in properties with no values set. If set to true, a non-matching evidence will cause the 'default profiles' to be returned. This means that properties will always have values (i.e. no need to check .hasValue) but some may be inaccurate. By default, this is false. |
+| `data-file` .`update` .`polling-interval` | `data_file` .`update` .`polling_interval` | No | int | 1800 | The time interval in seconds between consequent attempts to download an updated data file. Default = 1800 seconds = 30 minutes. |
+| `performance` .`profile` | `performance` .`profile` | No | string | `Balanced` | `performance.*` parameters are related to the tradeoffs between speed of device detection and RAM consumption or accuracy. `profile` dictates the proportion between the use of the RAM (the more RAM used - the faster is the device detection) and reads from disk (less RAM but slower device detection). Must be one of: `LowMemory`, `MaxPerformance`, `HighPerformance`, `Balanced`, `BalancedTemp`, `InMemory`. Defaults to `Balanced`. |
+| `performance` .`concurrency` | `performance` .`concurrency` | No | int | 10 | Specify the expected number of concurrent operations that engine does. This sets the concurrency of the internal caches to avoid excessive locking. Default: 10. |
+| `performance` .`difference` | `performance` .`difference` | No | int | 0 | Set the maximum difference to allow when processing evidence (HTTP headers). The meaning is the difference in hash value between the hash that was found, and the hash that is being searched for. By default this is 0. For more information see [51Degrees documentation](https://51degrees.com/documentation/_device_detection__hash.html). |
+| `performance` .`drift` | `performance` .`drift` | No | int | 0 | Set the maximum drift to allow when matching hashes. If the drift is exceeded, the result is considered invalid and values will not be returned. By default this is 0. For more information see [51Degrees documentation](https://51degrees.com/documentation/_device_detection__hash.html). |
+| `performance` .`allow-unmatched` | `performance` .`allow_unmatched` | No | boolean | false | If set to false, a non-matching evidence will result in properties with no values set. If set to true, a non-matching evidence will cause the 'default profiles' to be returned. This means that properties will always have values (i.e. no need to check .hasValue) but some may be inaccurate. By default, this is false. |
 
 ## Running the demo (PBS-Java)
 
@@ -322,7 +322,8 @@ curl http://localhost:8080/openrtb2/auction --data @extra/modules/fiftyone-devic
                      "ua": "Mozilla/5.0 (Linux; Android 11; SM-G998W) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.198 Mobile Safari/537.36",
 +                    "devicetype": 1,
 +                    "make": "Samsung",
-+                    "model": "SM-G998W",
++                    "model": "Galaxy",
++                    "hwv": "S21 Ultra 5G",
                      "os": "Android",
                      "osv": "11.0",
                      "h": 3200,

From 17a0baae53fb3278be675a1ab0b0dd024309f12c Mon Sep 17 00:00:00 2001
From: MaksymTeqBlaze <maksym.pavliv@teqblaze.com>
Date: Wed, 6 May 2026 20:13:11 +0300
Subject: [PATCH 578/665] New Adapter: TeqBlaze Demo (#6552)

* Added Bid Adapter TeqBlazeSalesAgent

* New Adapter: TeqBlaze Demo

* add note
---
 dev-docs/bidders/teqBlazeDemo.md | 37 ++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/teqBlazeDemo.md

diff --git a/dev-docs/bidders/teqBlazeDemo.md b/dev-docs/bidders/teqBlazeDemo.md
new file mode 100644
index 0000000000..5ffe4e4346
--- /dev/null
+++ b/dev-docs/bidders/teqBlazeDemo.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: TeqBlazeDemo
+description: Prebid TeqBlazeDemo Bidder Adapter
+biddercode: tqblz_demo
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+## Note
+
+This adapter is for internal testing only and should not be used for production integrations. \
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId.

From a036706438478a631a947af435feef3a71dd3e83 Mon Sep 17 00:00:00 2001
From: Tjorven <t.beckedorf@emetriq.com>
Date: Wed, 13 May 2026 12:49:07 +0200
Subject: [PATCH 579/665] New adapter: t Advertising x blis (#6458)

* remove md file of no longer needed emetriq adapter

* Add initial documentation

* fix table borders

* add trailing line at document end

---------

Co-authored-by: Markus Klink <m.klink@emetriq.com>
---
 dev-docs/bidders/tadvertising_blis.md | 38 +++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 dev-docs/bidders/tadvertising_blis.md

diff --git a/dev-docs/bidders/tadvertising_blis.md b/dev-docs/bidders/tadvertising_blis.md
new file mode 100644
index 0000000000..bf336dc8c0
--- /dev/null
+++ b/dev-docs/bidders/tadvertising_blis.md
@@ -0,0 +1,38 @@
+---
+layout: bidder
+title: T-Advertising Solutions
+description:  T-Advertising Solutions Prebid Bidder Blis Adapter
+biddercode: tadvertising_blis
+tcfeu_supported: true
+gvl_id: 213
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usnat, usp
+schain_supported: true
+dchain_supported: false
+userId: adserver, liveramp, sharedid, pubcid, id5-sync, criteo
+media_types: banner, video, native
+safeframes_ok: false
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: false
+pbs: true
+pbs_app_supported: true
+prebid_member: true
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: partial
+privacy_sandbox: no
+---
+
+### Disclosure
+
+{: .alert.alert-danger :}
+Note: The T-Advertising Solutions Bidding adapter requires setup and approval from the T-Advertising Solutions service team. Please reach out to your account manager for more information to start using it.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description      | Example                      | Type     |
+|---------------|----------|------------------|------------------------------|----------|
+| `publisherId` | required | The publisher ID | `'1427ab10f2e448057ed3b422'` | `String` |

From bc8427625a6ce209bc140de208983661438b4a8e Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Thu, 14 May 2026 19:10:51 +0200
Subject: [PATCH 580/665] Limelight: Update Embi Media (#6562)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* update bidder-embi media adapter parameters

* update bidder-embi media adapter parameters

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/embimedia.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/embimedia.md b/dev-docs/bidders/embimedia.md
index be3fd3dd02..f62df5b55f 100644
--- a/dev-docs/bidders/embimedia.md
+++ b/dev-docs/bidders/embimedia.md
@@ -20,11 +20,11 @@ aliasCode: limelightDigital
 sidebarType: 1
 ---
 
-### Note
+## Note
 
 The Embi Media Bidding adapter requires setup before beginning.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
@@ -32,3 +32,7 @@ The Embi Media Bidding adapter requires setup before beginning.
 |:--------------|:---------|:----------------------|:-----------------------|:----------|
 | `host`        | required | Ad network's RTB host | `'bidder-embi.media'`  | `string`  |
 | `publisherId` | required | Publisher ID          | `12345`                | `integer` |
+
+Prebid Embi Media server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Prebid Embi Media client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Prebid Embi Media server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Prebid Embi Media client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From eaa61241447cb37c9282133c9bfc409607371ad6 Mon Sep 17 00:00:00 2001
From: mkdefinemedia <m.klumpp@definemedia.de>
Date: Thu, 14 May 2026 19:14:59 +0200
Subject: [PATCH 581/665] fix(download): correct Define Media bidder module
 casing (#6561)

* fix(download): correct Define Media bidder module casing

The download page derives bidder module IDs from the bidder doc filename.
The old lowercase filename produced definemediaBidAdapter, so the generated package omitted the actual defineMediaBidAdapter module.
Rename the bidder doc to defineMedia.md so the generated moduleCode matches the adapter name.

* docs(defineMedia): fix markdownlint issues

Adjust heading levels and table formatting in the Define Media bidder doc

* docs(defineMedia): preserve old bidder doc URL
---
 .../bidders/{definemedia.md => defineMedia.md}   | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
 rename dev-docs/bidders/{definemedia.md => defineMedia.md} (53%)

diff --git a/dev-docs/bidders/definemedia.md b/dev-docs/bidders/defineMedia.md
similarity index 53%
rename from dev-docs/bidders/definemedia.md
rename to dev-docs/bidders/defineMedia.md
index 57a8d1cb1d..c1da1fd483 100644
--- a/dev-docs/bidders/definemedia.md
+++ b/dev-docs/bidders/defineMedia.md
@@ -2,7 +2,9 @@
 layout: bidder
 title: DEFINE MEDIA
 description: Prebid DEFINE MEDIA Bidder Adapter
-biddercode: definemedia
+biddercode: defineMedia
+redirect_from:
+	- /dev-docs/bidders/definemedia.html
 tcfeu_supported: true
 gvl_id: 440
 media_types: banner
@@ -15,14 +17,14 @@ prebid_member: false
 sidebarType: 1
 ---
 
-### Registration
+## Registration
 
 Please reach out to our account management team to get started. Contact information is available under [definemedia.de](https://definemedia.de).
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name | Scope | Type    | Description                                                                                                                                                  | Example
-| ---- | ----- |---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------| -------
-| `supplierDomainName` | required | String  | The domain name of the last supplier in the chain. Under this domain a sellers.json must be available under https://${supplierDomainName}/sellers.json       | definemedia.de
-| `devMode` | optional | boolean | This parameter enables our development endpoint instead of the production endpoint. All requests done with this parameter set to "true" are *NOT* billable | true
+| Name                 | Scope    | Type    | Description                                                                                                                                                | Example        |
+| :------------------- | :------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------- |
+| `supplierDomainName` | required | String  | The domain name of the last supplier in the chain. Under this domain a sellers.json must be available under https://${supplierDomainName}/sellers.json     | definemedia.de |
+| `devMode`            | optional | boolean | This parameter enables our development endpoint instead of the production endpoint. All requests done with this parameter set to "true" are *NOT* billable | true           |

From c39c62c2dcddfabd1280c7638bc7324f691f7f94 Mon Sep 17 00:00:00 2001
From: Gabriel Chicoye <gabriel.chicoye@gmail.com>
Date: Thu, 14 May 2026 19:35:50 +0200
Subject: [PATCH 582/665] MTC Bid Adapter: fix tagId example value in docs
 (#6555)

Update tagId example from `testnexx` to `textmtrc` in the MTC bidder
documentation to match the value publishers should use.

Co-authored-by: Gabriel Chicoye <gabriel@macbookrogab24g.lan>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 dev-docs/bidders/mtc.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/mtc.md b/dev-docs/bidders/mtc.md
index 30318fd57f..35f0804427 100644
--- a/dev-docs/bidders/mtc.md
+++ b/dev-docs/bidders/mtc.md
@@ -27,7 +27,7 @@ multiformat_supported: will-bid-on-any
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description                | Example                                   | Type      |
 |---------------|----------|----------------------------|--------------------------------------     |-----------|
-| `tagId`       | required*| Media Tradecraft tag ID    | `"testnexx"`                              | `string`  |
+| `tagId`       | required*| Media Tradecraft tag ID    | `"textmtrc"`                              | `string`  |
 | `placement`   | required*| Media Tradecraft placement | `"test.com_header_ad"`                    | `string`  |
 
 *You *must* only include one ID field - either `tagId` or `placement`, not both. If you have questions on which parameter to use, please reach out to your Account Manager.
@@ -66,7 +66,7 @@ var adUnits = [
       bids: [{
          bidder: 'mtc',
          params: {
-            tagId: 'testnexx'
+            tagId: 'textmtrc'
          }
        }]
    },
@@ -82,7 +82,7 @@ var adUnits = [
         bids: [{
             bidder: 'mtc',
             params: {
-               tagId: 'testnexx'
+               tagId: 'textmtrc'
             }
         }]
     },
@@ -105,7 +105,7 @@ var adUnits = [
         bids: [{
             bidder: 'mtc',
             params: {
-               tagId: 'testnexx'
+               tagId: 'textmtrc'
             }
         }]
     }

From b7b172e55b8e4276f9f44f150a671992e0ee5311 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 14 May 2026 13:38:57 -0400
Subject: [PATCH 583/665] Update display name to 'Storage Control' (#6553)

---
 dev-docs/modules/storageControl.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/modules/storageControl.md b/dev-docs/modules/storageControl.md
index 9c467841f0..e43dc2cbd3 100644
--- a/dev-docs/modules/storageControl.md
+++ b/dev-docs/modules/storageControl.md
@@ -4,7 +4,7 @@ page_type: module
 title: Module - Storage Control
 description: Check or enforce disclosure of device storage use
 module_code : storageControl
-display_name : storageControl
+display_name : Storage Control
 enable_download : true
 recommended: true
 sidebarType : 1

From 7458213609fee43dbb7e6faa831fafc47d4ce397 Mon Sep 17 00:00:00 2001
From: v0idxyz <58184010+v0idxyz@users.noreply.github.com>
Date: Thu, 14 May 2026 13:40:46 -0400
Subject: [PATCH 584/665] ReVantage Bid Adapter: Add gvlid (#6551)

* Add Revantage Bidder Adapter documentation

Added documentation for the Revantage Bidder Adapter, including registration, bid parameters, configuration for banner and video ads, user syncing, privacy support, and price floors.

* Remove notes about bid requests and sync URLs

Removed notes section detailing bid requests and notifications.

* Update dev-docs/bidders/revantage.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/revantage.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Change tcfeu_supported to false for Revantage

* Update Revantage documentation with code examples

* Set GVL ID to 1588 for Revantage

Updated GVL ID for Revantage bidder adapter.

* tcfeu_supported true

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/revantage.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/revantage.md b/dev-docs/bidders/revantage.md
index 3067a476ac..817da9dc93 100644
--- a/dev-docs/bidders/revantage.md
+++ b/dev-docs/bidders/revantage.md
@@ -3,8 +3,8 @@ layout: bidder
 title: Revantage
 description: Prebid Revantage Bidder Adapter
 biddercode: revantage
-tcfeu_supported: false
-gvl_id: none
+tcfeu_supported: true
+gvl_id: 1588
 usp_supported: true
 gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 coppa_supported: false

From 30490b3607fcc80ca2db6aa04337ff81583ae161 Mon Sep 17 00:00:00 2001
From: GoAdserver <jan@goadserver.com>
Date: Thu, 14 May 2026 19:43:29 +0200
Subject: [PATCH 585/665] New Bidder: goadserver (#6550)

* New Bidder: goadserver

Documentation for the goadserver Prebid.js adapter merged in
prebid/Prebid.js#14701. One bidder code (goadserver) serves every
goadserver deployment; publishers select the deployment via
params.host and authenticate the ad unit via params.token.
Supports banner, video (instream + outstream), and native via
ortbConverter, with optional per-bid floor, subid, and PMP deals.

GVL ID is not yet registered with IAB Europe; gvl_id is set to
none and tcfeu_supported to false until the registration lands,
at which point this page will be updated in a follow-up PR.

* goadserver: fix markdownlint failures (heading levels + table style)
---
 dev-docs/bidders/goadserver.md | 170 +++++++++++++++++++++++++++++++++
 1 file changed, 170 insertions(+)
 create mode 100644 dev-docs/bidders/goadserver.md

diff --git a/dev-docs/bidders/goadserver.md b/dev-docs/bidders/goadserver.md
new file mode 100644
index 0000000000..5a62c5fc67
--- /dev/null
+++ b/dev-docs/bidders/goadserver.md
@@ -0,0 +1,170 @@
+---
+layout: bidder
+title: GoAdserver
+description: Prebid GoAdserver Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: goadserver
+userIds:
+media_types: banner, video, native
+schain_supported: true
+dchain_supported: false
+ortb_blocking_supported: partial
+floors_supported: true
+multiformat_supported: will-bid-on-any
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: true
+coppa_supported: true
+gpp_sids: none
+userId: no
+safeframes_ok: true
+deals_supported: true
+fpd_supported: true
+prebid_member: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+## Note
+
+GoAdserver is a self-hosted, multi-tenant ad serving platform with a built-in OpenRTB 2.5 Prebid Server endpoint. One adapter (`goadserver`) serves every deployment — the specific ad server is selected per-ad-unit via `params.host`, and the publisher's SSP campaign authentication token (issued in the GoAdserver panel) is passed via `params.token`. Publishers running multiple GoAdserver instances can mix and match them in a single Prebid.js config by setting different `params.host` values on different ad units.
+
+Requests are POSTed to `https://{params.host}/openrtb2/auction`. The token lands in the outgoing BidRequest as `site.publisher.id`, which the GoAdserver auction handler uses to resolve the publisher account.
+
+For setup or to obtain a token, contact <support@goadserver.com>.
+
+## Bid Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `host` | required | The GoAdserver deployment's public domain. The adapter POSTs to `https://{host}/openrtb2/auction`. | `"ads.example.com"` | `string` |
+| `token` | required | SSP campaign authentication token from the publisher's GoAdserver panel. Forwarded as `site.publisher.id`. | `"a1b2c3d4..."` | `string` |
+| `floor` | optional | Per-bid CPM floor (USD). Honored only when the [Price Floors module](/dev-docs/modules/floors.html) hasn't already set `imp.bidfloor`. | `0.50` | `number` |
+| `subid` | optional | Per-impression sub-identifier for stats attribution (page section, A/B group, etc.). Emitted as `imp.ext.goadserver.subid` and logged against the bid in GoAdserver reporting. | `"article_page"` | `string` |
+| `deals` | optional | Array of private marketplace deal objects attached to this impression. Each entry maps to OpenRTB `imp.pmp.deals[]`: `id` (required), `bidfloor`, `bidfloorcur`, `at`, `wseat[]`, `wadomain[]`. See example below. | see below | `Object[]` |
+| `outstreamRendererUrl` | optional | Override URL for the outstream video renderer script. Defaults to `https://{host}/prebid-outstream.js`, which every GoAdserver deployment hosts. Set this to self-host or bundle a custom player. | `"https://cdn.pub.example.com/my-outstream.js"` | `string` |
+
+## Deals / Private Marketplace
+
+```js
+bids: [{
+  bidder: 'goadserver',
+  params: {
+    host: 'ads.example.com',
+    token: 'your-sspcampaigns-hash',
+    deals: [
+      { id: 'DEAL_XYZ', bidfloor: 2.50, bidfloorcur: 'USD' },
+      { id: 'DEAL_ABC', bidfloor: 1.00, at: 1, wseat: ['agency-42'] }
+    ]
+  }
+}]
+```
+
+Deal objects are forwarded verbatim to downstream DSPs. Winning bids return with `bid.dealid`, surfaced by Prebid.js as `bid.dealId` for GAM line-item targeting.
+
+## Outstream Video
+
+Outstream is supported via the standard `mediaTypes.video.context: 'outstream'` setting. When a video bid is returned for an outstream ad unit, the adapter attaches a Prebid.js `Renderer` that loads the GoAdserver-hosted outstream player. The player parses the VAST XML, injects a muted auto-playing `<video>` element into the slot, and fires impression / click trackers — no publisher-side renderer configuration is required.
+
+```js
+const adUnit = {
+  code: 'outstream-1',
+  mediaTypes: {
+    video: {
+      context: 'outstream',
+      playerSize: [[640, 360]],
+      mimes: ['video/mp4']
+    }
+  },
+  bids: [{
+    bidder: 'goadserver',
+    params: {
+      host: 'ads.example.com',
+      token: 'your-token'
+      // outstreamRendererUrl: 'https://cdn.pub.example.com/my-outstream.js' // optional override
+    }
+  }]
+};
+```
+
+## Test Parameters
+
+```js
+const adUnits = [
+  {
+    code: 'top-banner',
+    mediaTypes: { banner: { sizes: [[728, 90], [970, 250]] } },
+    bids: [{
+      bidder: 'goadserver',
+      params: {
+        host: 'ads.example.com',
+        token: 'your-sspcampaigns-hash',
+        floor: 0.50
+      }
+    }]
+  },
+  {
+    code: 'preroll',
+    mediaTypes: {
+      video: {
+        context: 'instream',
+        playerSize: [[640, 480]],
+        mimes: ['video/mp4']
+      }
+    },
+    bids: [{
+      bidder: 'goadserver',
+      params: { host: 'ads.example.com', token: 'your-sspcampaigns-hash' }
+    }]
+  },
+  {
+    code: 'native-1',
+    mediaTypes: {
+      native: {
+        title: { required: true },
+        image: { required: true },
+        sponsoredBy: { required: true }
+      }
+    },
+    bids: [{
+      bidder: 'goadserver',
+      params: { host: 'ads.example.com', token: 'your-sspcampaigns-hash' }
+    }]
+  }
+];
+```
+
+## Multi-Deployment Example
+
+Two ad units auctioned against two different GoAdserver deployments in one request:
+
+```js
+pbjs.addAdUnits([
+  {
+    code: 'slot-a',
+    mediaTypes: { banner: { sizes: [[300, 250]] } },
+    bids: [{
+      bidder: 'goadserver',
+      params: { host: 'deployment1.example.com', token: 'token-a' }
+    }]
+  },
+  {
+    code: 'slot-b',
+    mediaTypes: { banner: { sizes: [[728, 90]] } },
+    bids: [{
+      bidder: 'goadserver',
+      params: { host: 'deployment2.example.com', token: 'token-b' }
+    }]
+  }
+]);
+```
+
+## Consent & Privacy
+
+The adapter relies on Prebid.js's standard consent plumbing via `ortbConverter`: GDPR (`regs.ext.gdpr`, `user.ext.consent`), US Privacy (`regs.ext.us_privacy`), GPP (`regs.gpp` + `regs.gpp_sid`), and COPPA (`regs.coppa`). No bidder-specific consent handling is required on the publisher side.
+
+**GVL ID:** the GoAdserver adapter is not yet registered with the IAB Global Vendor List. EU publishers using CMPs that enforce GVL may see bid requests dropped pre-auction. A registration is in progress at [iabeurope.eu/tcf](https://iabeurope.eu/tcf/); this page will be updated with the assigned GVL ID once it lands.

From 4d6ab0d535a9abe27806ee67536ccf8088e8b05e Mon Sep 17 00:00:00 2001
From: Daniel Baud <52867769+danielbaud@users.noreply.github.com>
Date: Thu, 14 May 2026 19:44:33 +0200
Subject: [PATCH 586/665] Alliance gravity: added PBS support (#6547)

* misc: added PBS support & changed parameter name

* misc: reverted parameter name

* fix: dummy commit

* fix(md): h3 to h2 header
---
 dev-docs/bidders/alliance_gravity.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/dev-docs/bidders/alliance_gravity.md b/dev-docs/bidders/alliance_gravity.md
index 6382a30957..704271f517 100644
--- a/dev-docs/bidders/alliance_gravity.md
+++ b/dev-docs/bidders/alliance_gravity.md
@@ -13,7 +13,7 @@ deals_supported: true
 floors_supported: true
 fpd_supported: false
 pbjs: true
-pbs: false
+pbs: true
 pbs_app_supported: true
 prebid_member: false
 multiformat_supported: will-bid-on-one
@@ -21,9 +21,9 @@ ortb_blocking_supported: true
 privacy_sandbox: no
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description       | Example   | Type     |
-|---------------|----------|-------------------|-----------|----------|
-| `srid`        | required | Stored Request ID | `'1234'` | `string` |
+| Name   | Scope    | Description  | Example  | Type     |
+|--------|----------|--------------|----------|----------|
+| `srid` | required | Placement ID | `'1234'` | `string` |

From 845b0cff3b94d7614ecdeda16ce446b683da73d3 Mon Sep 17 00:00:00 2001
From: Erik Svilich <erik.svilich@gmail.com>
Date: Thu, 14 May 2026 19:48:15 +0200
Subject: [PATCH 587/665] Encypher RTD Provider: module documentation (#6545)

* docs: add Encypher RTD provider documentation

Documentation for the Encypher C2PA Content Provenance RTD module.
Companion PR to prebid/Prebid.js#14807.

* docs(encypherRtd): update privacy section for consent gate and timeout

* fix(encypherRtd): fix YAML frontmatter and table formatting for markdownlint

- Fix frontmatter delimiters (--- not -)
- Use spaced table separator rows (| --- |)
- Use dash for unordered lists

---------

Co-authored-by: Developer <developer@prebid.org>
---
 dev-docs/modules/encypherRtdProvider.md | 154 ++++++++++++++++++++++++
 1 file changed, 154 insertions(+)
 create mode 100644 dev-docs/modules/encypherRtdProvider.md

diff --git a/dev-docs/modules/encypherRtdProvider.md b/dev-docs/modules/encypherRtdProvider.md
new file mode 100644
index 0000000000..c766915d55
--- /dev/null
+++ b/dev-docs/modules/encypherRtdProvider.md
@@ -0,0 +1,154 @@
+---
+layout: page_v2
+title: Encypher Real Time Data Provider
+display_name: Encypher C2PA Content Provenance
+description: Injects C2PA content provenance signals into OpenRTB bid requests
+page_type: module
+module_type: rtd
+module_code: encypherRtdProvider
+enable_download: true
+vendor_specific: true
+sidebarType: 1
+---
+
+# Encypher RTD Provider
+{:.no_toc}
+
+- TOC
+{:toc}
+
+## Description
+
+The Encypher RTD provider injects [C2PA](https://c2pa.org/) content provenance signals into OpenRTB bid requests at `site.ext.data.c2pa`. This gives DSPs a cryptographic content-integrity signal they can use for brand safety and inventory quality decisioning.
+
+The module detects whether article content already carries embedded provenance markers (from a CMS plugin, CDN worker, or direct API integration) and verifies them server-side. If no existing provenance is found, it signs the content via the Encypher public API. In both cases the result is injected into the bid request.
+
+No external JavaScript is loaded. The module uses only Prebid.js core imports. Every code path calls `callback()`. The module never blocks an auction.
+
+Contact [engineering@encypher.com](mailto:engineering@encypher.com) for more information.
+
+## Integration
+
+Compile the Encypher RTD module into your Prebid build:
+
+```bash
+gulp build -modules=rtdModule,encypherRtdProvider
+```
+
+## Configuration
+
+Add the Encypher RTD provider to your Prebid config:
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 300,
+    dataProviders: [{
+      name: 'encypher',
+      waitForIt: true,
+      params: {
+        // All optional. Free tier works with zero config.
+      }
+    }]
+  }
+});
+```
+
+### Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Type | Description |
+| - | - | - | - |
+| `name` | Required | String | Must be `'encypher'` |
+| `waitForIt` | Optional | Boolean | Set to `true` to delay the auction until provenance data is available. Default: `false` |
+| `params` | Optional | Object | Configuration parameters (see below) |
+| `params.apiBase` | Optional | String | Override the API base URL (default: `https://api.encypher.com`). Useful for staging or development environments. |
+| `params.manifestUrl` | Optional | String | Manual manifest URL. When set, the module fetches this URL directly instead of calling the signing API. |
+
+## How It Works
+
+The module runs once per page load through three paths in strict priority:
+
+### Path A: Manifest Shortcut
+
+If a `<meta name="c2pa-manifest-url">` tag or `params.manifestUrl` is present, the module fetches the manifest directly without calling the signing API.
+
+### Path B: Cache
+
+If provenance data for the current page exists in localStorage (30-day TTL, keyed by canonical URL hash), it is served immediately with no network call.
+
+### Path C: API Signing and Verification
+
+The module extracts article text from the DOM and sends it to the Encypher API. The API detects whether the content already contains embedded C2PA provenance markers:
+
+- **If markers are present:** The API verifies them and returns the existing provenance data, including the original signer tier. No signing quota is consumed.
+- **If no markers are found:** The API signs the content fresh and returns a new manifest.
+
+The result is cached in localStorage and injected into the bid request.
+
+## Content Extraction
+
+Article text is extracted from the DOM in this priority order:
+
+1. **JSON-LD structured data:** `application/ld+json` scripts containing schema.org `Article`, `NewsArticle`, `BlogPosting`, or `Report` types.
+2. **`<article>` element:** `textContent` of the first `<article>` element.
+3. **`[role="main"]` element:** `textContent` of the first element with `role="main"`.
+
+Content shorter than 50 characters is skipped. Content longer than 50,000 characters is truncated.
+
+## Data Injected
+
+The following object is placed at `ortb2Fragments.global.site.ext.data.c2pa`:
+
+```json
+{
+  "manifest_url": "https://api.encypher.com/api/v1/public/prebid/manifest/abc123",
+  "verified": true,
+  "signer_tier": "connected",
+  "signed_at": "2026-04-01T10:00:00Z",
+  "content_hash": "a1b2c3d4e5f6",
+  "source": "auto",
+  "extraction_method": "json-ld"
+}
+```
+
+{: .table .table-bordered .table-striped }
+
+| Field | Type | Description |
+| - | - | - |
+| `manifest_url` | String | URL to retrieve the C2PA manifest |
+| `verified` | Boolean | `true` if provenance was successfully verified or signed |
+| `signer_tier` | String | Signing identity tier (see table below) |
+| `signed_at` | String | ISO 8601 timestamp of signing |
+| `content_hash` | String | SHA-256 hash of article text |
+| `source` | String | How provenance was obtained: `cms`, `cache`, or `auto` |
+| `extraction_method` | String | DOM extraction method: `json-ld`, `article-element`, or `role-main` |
+
+## Signer Tiers
+
+The `signer_tier` field tells DSPs how the content was authenticated:
+
+{: .table .table-bordered .table-striped }
+
+| Tier | Meaning |
+| - | - |
+| `byok` | Publisher signed with their own key (strongest identity) |
+| `connected` | Publisher authenticated with Encypher and signed at publish time |
+| `encypher_free` | Content was auto-signed by Encypher at first pageview (no publisher authentication) |
+| `local` | Manifest fetched from a local or self-hosted endpoint |
+
+DSPs can use this field for differential bidding. Content signed by authenticated publishers carries stronger brand-safety guarantees than content attested by a third party at pageview time.
+
+## Free Tier
+
+The free tier provides 1,000 unique content signatures per publisher domain per month. Re-requests for the same content (deduped by content hash) do not count against quota. Verification of already-signed content does not count against quota. When the quota is exceeded, the module continues without injecting provenance data (fail-open).
+
+## Privacy
+
+The module uses Prebid's `getStorageManager` for localStorage access, which enforces GDPR/TCF consent. If consent is denied, caching is disabled and Path C (auto-sign) is skipped entirely, so no page content leaves the browser. When consent is granted but caching is unavailable, the module falls back to API calls on each page load. Article text sent to the Encypher API for signing is not stored on Encypher's servers. Only content hashes and metadata are persisted. A 2-second timeout ensures the module never blocks the auction.
+
+## Further Reading
+
+- [C2PA Specification](https://c2pa.org/specifications/)
+- [Encypher Documentation](https://encypher.com/docs)

From 37bfe0772df198e7abd49d28b33a861d37ce0077 Mon Sep 17 00:00:00 2001
From: prebid-reklamup <prebid@reklamup.com>
Date: Thu, 14 May 2026 20:48:45 +0300
Subject: [PATCH 588/665] Reklamup adapter:  Set pbs and pbs_app_supported to
 true (#6544)

* New adapter reklamup

* New adapter reklamup: Disable pbs and pbs_app_supported

* Reklamup Adapter: set pbs and pbs_app_supported to true

* Reklamup Adapter: Heading levels

---------

Co-authored-by: Reklamup <support@reklamup.com>
---
 dev-docs/bidders/reklamup.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/reklamup.md b/dev-docs/bidders/reklamup.md
index 7612322a62..6a967912b0 100644
--- a/dev-docs/bidders/reklamup.md
+++ b/dev-docs/bidders/reklamup.md
@@ -16,13 +16,13 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name          | Scope    | Description  | Example                         | Type       |
@@ -30,6 +30,6 @@ sidebarType: 1
 | `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
 | `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
 
-### Note
+## Note
 
 For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From 4b3a5cb85131607034f4245e52a5506fd230ddcf Mon Sep 17 00:00:00 2001
From: Antonio Gargaro <38767071+AntonioGargaro@users.noreply.github.com>
Date: Thu, 14 May 2026 19:00:00 +0100
Subject: [PATCH 589/665] Permutive RTD: note params.bidders now triggers ortb2
 writes (#6538)

* docs: update permutiveRtdProvider.md for msft bidder custom cohorts

Add msft to supported custom cohort bidders list, document the new
params.bidders configuration, and note the appnexus-to-msft migration path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: align markdown table columns to pass MD060 lint rule

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* remove hardcoded msft default from docs, add publisher config example

Mirrors the code change in Prebid.js PR #14655. The params.bidders
default is now {} and publishers must explicitly configure msft
custom cohort sources.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs(permutiveRtdProvider): note params.bidders now triggers ortb2 writes

Document that listing a bidder under params.bidders causes the module
to write ortb2 for that bidder, even when it is not in acBidders or
Permutive's SSP list. Paired with the Prebid.js fix that iterates
params.bidders keys in setBidderRtb.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* github UI lied to me :P

* how to resolve a simple merge conflict in three commits

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/modules/permutiveRtdProvider.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/modules/permutiveRtdProvider.md b/dev-docs/modules/permutiveRtdProvider.md
index 0b5fcee63c..4c6dec2f7d 100644
--- a/dev-docs/modules/permutiveRtdProvider.md
+++ b/dev-docs/modules/permutiveRtdProvider.md
@@ -68,6 +68,7 @@ as well as enabling settings for specific use cases mentioned above (e.g. acbidd
 | params                                         | Object               |                                                                                                | -                                                               |
 | params.acBidders                               | String[]             | An array of bidder codes to share cohorts with in certain versions of Prebid, see below        | `[]`                                                            |
 | params.maxSegs                                 | Integer              | Maximum number of cohorts to be included in either the `permutive` or `p_standard` key-value.  | `500`                                                           |
+| params.bidders                                 | Object               | Per-bidder configuration for custom cohort sources. Keys are bidder codes; listing a bidder here also causes the module to write ortb2 data for that bidder, even if it is not in `acBidders` or on Permutive's SSP list. | `{}`                                                            |
 | params.bidders                                 | Object               | Per-bidder configuration for custom cohort sources. Keys are bidder codes.                     | `{}`                                                            |
 | params.bidders.\<bidder\>.customCohorts        | Object               | Custom cohorts source configuration for a specific bidder.                                     | -                                                               |
 | params.bidders.\<bidder\>.customCohorts.source | String               | Storage type to read custom cohorts from. Currently only `'ls'` (localStorage) is supported.   | -                                                               |

From 8d05917d0e574be953b4e7eab3fe8241cf719bd3 Mon Sep 17 00:00:00 2001
From: PGAMDSP <103131000+mastap150@users.noreply.github.com>
Date: Thu, 14 May 2026 14:00:09 -0400
Subject: [PATCH 590/665] =?UTF-8?q?Docs:=20New=20Bidder=20=E2=80=94=20PGAM?=
 =?UTF-8?q?=20Direct=20(#6536)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Docs: New Bidder — PGAM Direct

Adds the docs page for the new pgamdirect bidder adapter.

Code PR: https://github.com/prebid/Prebid.js/pull/14763

GVL 1353. Related to existing pgamssp adapter; this doc explicitly
calls out the relationship so publishers browsing the bidders list
understand which adapter is which.

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

* Update dev-docs/bidders/pgamdirect.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/pgamdirect.md | 138 +++++++++++++++++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 dev-docs/bidders/pgamdirect.md

diff --git a/dev-docs/bidders/pgamdirect.md b/dev-docs/bidders/pgamdirect.md
new file mode 100644
index 0000000000..6cae04f6f2
--- /dev/null
+++ b/dev-docs/bidders/pgamdirect.md
@@ -0,0 +1,138 @@
+---
+layout: bidder
+title: PGAM Direct
+description: Server-to-server OpenRTB 2.6 adapter from PGAM Media (self-hosted). Dynamic floors, transparent margins, schain integrity. Related — pgamssp (legacy, TeqBlaze-hosted).
+biddercode: pgamdirect
+media_types: banner, video, native
+gvl_id: 1353
+prebid_member: false
+schain_supported: true
+tcfeu_supported: true
+gpp_sids: tcfeu, usnat, usstate_all
+usp_supported: true
+coppa_supported: true
+pbjs: true
+pbs: false
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+userIds: all
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: partial
+privacy_sandbox: paapi
+sidebarType: 1
+---
+
+## Note
+
+PGAM Direct is the self-hosted server-to-server OpenRTB adapter operated by PGAM Media LLC. For the legacy TeqBlaze-hosted integration, see [pgamssp](/dev-docs/bidders/pgamssp.html). We plan to migrate publishers from pgamssp to pgamdirect over 2026; both will coexist on the bidders list during that window.
+
+Key differences from pgamssp:
+
+- Canonical OpenRTB 2.5/2.6 (not a proprietary envelope)
+- Dynamic rolling-quantile floor pricing on our bidder, published per `(dsp × placement × geo × device)` cell
+- Transparent margin enforcement (5% hard floor, compile-time enforced, never zeroable from config)
+- schain integrity — `pgamssp.com,1353` appears verified on every outbound request; complete=1 enforced
+- HMAC-signed `burl` / `nurl` to defeat pixel replay
+- Account onboarding via `orgId` issued by PGAM Media; reach out to your account manager for yours
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                                              | Example                    | Type      |
+|---------------|----------|--------------------------------------------------------------------------|----------------------------|-----------|
+| `orgId`       | required | Your publisher identifier at PGAM Media. Issued during onboarding.       | `'pgam-acme-publisher'`    | `string`  |
+| `placementId` | optional | Free-text placement identifier; mapped to `imp.tagid` on the bid request | `'leaderboard-728x90'`     | `string`  |
+| `bidfloor`    | optional | Per-placement USD bidfloor; bidder still enforces its own minimum        | `1.25`                     | `number`  |
+
+## Example — Banner
+
+```javascript
+pbjs.addAdUnits([{
+  code: 'ad-slot-1',
+  mediaTypes: {
+    banner: { sizes: [[300, 250], [728, 90]] }
+  },
+  bids: [{
+    bidder: 'pgamdirect',
+    params: {
+      orgId: 'pgam-acme-publisher',
+      placementId: 'leaderboard-728x90'
+    }
+  }]
+}]);
+```
+
+## Example — Video (instream)
+
+```javascript
+pbjs.addAdUnits([{
+  code: 'video-adunit',
+  mediaTypes: {
+    video: {
+      playerSize: [[640, 480]],
+      mimes: ['video/mp4', 'application/javascript'],
+      protocols: [2, 3, 5, 6],
+      api: [1, 2],
+      minduration: 5,
+      maxduration: 30,
+      placement: 1,
+      plcmt: 1,
+      linearity: 1
+    }
+  },
+  bids: [{
+    bidder: 'pgamdirect',
+    params: {
+      orgId: 'pgam-acme-publisher',
+      placementId: 'preroll-15s'
+    }
+  }]
+}]);
+```
+
+## Example — Native
+
+```javascript
+pbjs.addAdUnits([{
+  code: 'native-adunit',
+  mediaTypes: {
+    native: {
+      image: { required: true, sizes: [150, 50] },
+      title: { required: true, len: 80 },
+      sponsoredBy: { required: true }
+    }
+  },
+  bids: [{
+    bidder: 'pgamdirect',
+    params: { orgId: 'pgam-acme-publisher' }
+  }]
+}]);
+```
+
+## Privacy
+
+The adapter forwards only what Prebid.js supplies:
+
+- `source.ext.schain` — the publisher's supply-chain object, if set
+- `user.ext.eids` — registered Prebid User-ID modules
+- `regs.ext.gdpr` / `regs.ext.gdpr_consent` — TCF v2 if `consentManagement` is enabled
+- `regs.ext.us_privacy` — CCPA if `consentManagementUSP` is enabled
+- `regs.gpp` / `regs.gpp_sid` — GPP if configured
+- `regs.coppa` — from `ortb2.regs.coppa`
+
+No cookies are set on the publisher's domain by this adapter.
+
+## Migrating from pgamssp
+
+Publishers already integrated via [pgamssp](/dev-docs/bidders/pgamssp.html) can run both adapters in parallel during the migration window:
+
+```javascript
+bids: [
+  { bidder: 'pgamssp',    params: { placementId: 'your-placement' } },
+  { bidder: 'pgamdirect', params: { orgId: 'pgam-your-slug', placementId: 'your-placement' } }
+]
+```
+
+Prebid's auction picks the higher bid per impression, so you get the best of both while you evaluate.

From 238a7242430df0bc5195abe49db0e26217248878 Mon Sep 17 00:00:00 2001
From: cortex-tech <dev@cortextech.it>
Date: Thu, 14 May 2026 21:01:50 +0300
Subject: [PATCH 591/665] New Adapter: cortex (#6546)

* New Adapter: cortex

* set tcf support to false

* Update dev-docs/bidders/cortex.md

* Update dev-docs/bidders/cortex.md

---------

Co-authored-by: Cortex Dev <dev@cortexch.it>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/cortex.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/cortex.md

diff --git a/dev-docs/bidders/cortex.md b/dev-docs/bidders/cortex.md
new file mode 100644
index 0000000000..30617aa6cf
--- /dev/null
+++ b/dev-docs/bidders/cortex.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: Cortex
+description: Prebid Cortex Adapter
+biddercode: cortex
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example | Type       |
+|---------------|----------|--------------|---------|------------|
+| `placementId` | optional | Placement Id | `'0'`   | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`   | `'string'` |
+
+## Note
+
+For the prebid server you only need to use one parameter: either `placementId` or `endpointId`

From b9491095f642eb9922285d58cded3125a1225fdd Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Thu, 14 May 2026 20:03:11 +0200
Subject: [PATCH 592/665] getBidResponses.md: document the meta object (#6472)

* getBidResponses.md: document the meta object

* Adding more meta properties
---
 .../publisher-api-reference/getBidResponses.md    | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/dev-docs/publisher-api-reference/getBidResponses.md b/dev-docs/publisher-api-reference/getBidResponses.md
index 0a01d9f02a..ec1decf4d2 100644
--- a/dev-docs/publisher-api-reference/getBidResponses.md
+++ b/dev-docs/publisher-api-reference/getBidResponses.md
@@ -38,6 +38,21 @@ This function returns the bid responses at the given moment.
 | `status`  | String  | Status of the bid. Possible values: targetingSet, rendered | `"targetingSet"` |
 | `statusMessage`     | String  | The bid's status message                                                                                                        | "Bid returned empty or error response" or "Bid available" |
 | `ttl`  | Integer  | How long (in seconds) this bid is considered valid. See this [FAQ entry]({{site.github.url}}/dev-docs/faq.html#does-prebidjs-cache-bids) for more info. | `300` |
+| `meta` | Object | (Optional) Contains additional meta information about the bid. | `{ "advertiserDomains": [ "wherewindsmeetgame.com" ] }` |
+| `meta.advertiserDomains` | String[] | (Optional) Array with the advertiser domains | |
+| `meta.advertiserId` | String | (Optional) The id of the advertiser | |
+| `meta.advertiserName` | String | (Optional) The name of the advertiser | |
+| `meta.agencyId` | String | (Optional) The id of the agency | |
+| `meta.agencyName` | String | (Optional) The name of the agency | |
+| `meta.brandId` | String | (Optional) The id of the brand | |
+| `meta.brandName` | String | (Optional) The name of the brand | |
+| `meta.dchain` | String | (Optional)  | |
+| `meta.demandSource` | String | (Optional)  | |
+| `meta.mediaType` | String | (Optional)  | |
+| `meta.networkId` | String | (Optional) The id of the network | |
+| `meta.networkName` | String | (Optional) The name of the network | |
+| `meta.primaryCatId` | String | (Optional)  | |
+| `meta.secondaryCatIds` | String[] | (Optional)  | |
 
 <div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
 

From 8f0fe9fa8ae7307f0ed33171c9fc08c7da95d2f1 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Thu, 14 May 2026 20:03:44 +0200
Subject: [PATCH 593/665] Update getEvents.md: added auctionTimeout event
 (#6486)

---
 dev-docs/publisher-api-reference/getEvents.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/dev-docs/publisher-api-reference/getEvents.md b/dev-docs/publisher-api-reference/getEvents.md
index a374315d74..2af6e4c295 100644
--- a/dev-docs/publisher-api-reference/getEvents.md
+++ b/dev-docs/publisher-api-reference/getEvents.md
@@ -27,6 +27,7 @@ The available events are:
 | --- | --- | --- |
 | auctionInit   | The auction has started                 | Object containing auction details |
 | auctionEnd    | The auction has ended                   | Object containing auction details |
+| auctionTimeout | The auction has timed out              | Object containing auction details |
 | beforeRequestBids | Bids are about to be requested from adapters (added in 3.x) | Array of adunits in the auction |
 | beforeBidderHttp | bidder network request is about be triggered | Array of Bid request objects |
 | bidRequested  | A bid was requested from a specific bidder | Bid request object |

From 9e11a79f2c728273efd4b42b4cba80808e39377a Mon Sep 17 00:00:00 2001
From: Pavlo Kyrylenko <kirilenko.pavlo@gmail.com>
Date: Thu, 14 May 2026 21:12:53 +0300
Subject: [PATCH 594/665] Removed tagUrl parameter (#6515)

* removed tagUrl parameter

* marked the params.tagUrl as Deprecated

* fixed linter issue

---------

Co-authored-by: Pavlo <pavlo@id-ward.com>
---
 dev-docs/modules/anonymisedRtdProvider.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/dev-docs/modules/anonymisedRtdProvider.md b/dev-docs/modules/anonymisedRtdProvider.md
index 755b5393cb..d69192bd34 100644
--- a/dev-docs/modules/anonymisedRtdProvider.md
+++ b/dev-docs/modules/anonymisedRtdProvider.md
@@ -59,12 +59,13 @@ For any questions or assistance with integrating Prebid, `anonymisedRtdProvider`
 **Config Syntax details:**
 
 {: .table .table-bordered .table-striped }
-| Name  |Type | Description   | Notes  |
-| :------------ | :------------ | :------------ |:------------ |
-| name | `String` | Anonymised Rtd module name | 'anonymised' always|
+
+| Name | Type | Description | Notes |
+| :------------ | :------------ | :------------ | :------------ |
+| name | `String` | Anonymised Rtd module name | 'anonymised' always |
 | waitForIt | `Boolean` | Required to ensure that the auction is delayed until prefetch is complete | Optional. Defaults to false |
 | params.cohortStorageKey | `String` | the `localStorage` key, under which Anonymised Marketing Tag stores the segment IDs | 'cohort_ids' always |
 | params.bidders | `Array` | Bidders with which to share segment information | Optional |
 | params.segtax | `Integer` | The taxonomy for Anonymised | '1000' always |
 | params.tagConfig | `Object` | Configuration for the Anonymised Marketing Tag | Optional. Defaults to `{}`. |
-| params.tagUrl | `String` | The URL of the Anonymised Marketing Tag script | Optional. Defaults to `https://static.anonymised.io/light/loader.js`. |
+| params.tagUrl | `String` | The URL of the Anonymised Marketing Tag script | **Deprecated.** Optional. Defaults to `https://static.anonymised.io/light/loader.js`. |

From f59074ce3779b345836b3bd59e15dc8b6ff7c63b Mon Sep 17 00:00:00 2001
From: DariaBoykoAdmixer <dboyko@admixer.com>
Date: Thu, 14 May 2026 21:13:45 +0300
Subject: [PATCH 595/665] Add prebid server support to rtb stack docs (#6464)

* Add admixerwl alias for admixerBidAdapter.

* Specify multiformat_supported and safeframes_ok for admixerwl adapter.

* add Prebid Server Support docs to rtb stack

* fix bare examples

---------

Co-authored-by: Yaroslav Masenko <intgr-user@admixer.ua>
Co-authored-by: AdmixerTech <35560933+AdmixerTech@users.noreply.github.com>
Co-authored-by: Daria Boyko <dariaboiko03@gmail.com>
---
 dev-docs/bidders/rtbstack.md | 36 ++++++++++++++++++++++++++++++++----
 1 file changed, 32 insertions(+), 4 deletions(-)

diff --git a/dev-docs/bidders/rtbstack.md b/dev-docs/bidders/rtbstack.md
index f5b30d9950..98af8cc685 100644
--- a/dev-docs/bidders/rtbstack.md
+++ b/dev-docs/bidders/rtbstack.md
@@ -8,6 +8,7 @@ aliasCode: admixer
 media_types: banner, video, native
 tcfeu_supported: true
 usp_supported: true
+pbs: true
 schain_supported: true
 gvl_id: 511
 userIds: AdmixerID
@@ -18,7 +19,7 @@ multiformat_supported: will-bid-on-any
 safeframes_ok: true
 ---
 
-#### Bidder Configuration
+### Bidder Configuration
 
 RTB Stack bidder requires bidderURL to be set. Please note that rtbstack bids will not be requested without this config. It must be set before auction starts.
 
@@ -31,13 +32,13 @@ pbjs.setBidderConfig({
 });
 ```
 
-### Bid Params
+#### Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name                | Scope    | Description                                                                                | Example                      | Type     |
 |---------------------|----------|--------------------------------------------------------------------------------------------|------------------------------|----------|
-| `tagId`        | required |The unique identifier of the ad placement. Will be used for comparison of statistics.                             | 51772                        | `int`    |
-| `kvTargeting`       | optional | Key/Value - a pair of the unique values that will be used for the custom targeting option. | {key1: value2, key2: value2} | `object` |
+| `tagId`        | required |The unique identifier of the ad placement. Will be used for comparison of statistics.                             | `51772`                        | `int`    |
+| `kvTargeting`       | optional | Key/Value - a pair of the unique values that will be used for the custom targeting option. | `{key1: value2, key2: value2}` | `object` |
 
 #### Bid Example
 
@@ -52,3 +53,30 @@ pbjs.setBidderConfig({
   }
 }
 ```
+
+### Prebid Server Configuration
+The RTB Stack adapter allows publishers to connect to RTB Stack demand through Prebid Server using server-to-server (S2S) bidding.
+
+#### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name                | Scope    | Description                                                                                | Example                      | Type     |
+|---------------------|----------|--------------------------------------------------------------------------------------------|------------------------------|----------|
+| `route`             | required | Full RTB Stack route URL used to derive the RTB Stack endpoint. This URL typically includes the region host and query parameters such as client, endpoint, and ssp. | `https://us-adx-example.rtb-stack.com/prebid?client=44e2d241-5051-4b58-8ac6-f17e13732339&ssp=3&endpoint=777`   | `string`    |
+| `tagId`             | required | The unique identifier of the ad placement. Will be used for comparison of statistics.     | `12345` | `string` |
+| `customParams`      | optional | Key/Value - a pair of the unique values that will be used for the custom targeting option.     | `{key1: value2, key2: value2}` | `object` |
+
+#### Bid Example
+
+```js
+{
+  bidder: 'rtbstack',
+  params: {
+    tagId: '12345',
+    route: 'https://us-adx-example.rtb-stack.com/prebid?client=44e2d241-5051-4b58-8ac6-f17e13732339&ssp=3&endpoint=777',
+    customParams: {
+      example: 'test'
+    }
+  }
+}
+```

From 3bc4f64ddc1c9760ee124616e2746533ae77c2e6 Mon Sep 17 00:00:00 2001
From: Jose Climaco <jclimaco@insurads.com>
Date: Thu, 14 May 2026 19:16:11 +0100
Subject: [PATCH 596/665] InsurAds Rtd Provider Documentation (#6465)

* InsurAds Rtd Provider Documentation

* Fix table pipe not aligning with header
---
 dev-docs/modules/insuradsRtdProvider.md | 62 +++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 dev-docs/modules/insuradsRtdProvider.md

diff --git a/dev-docs/modules/insuradsRtdProvider.md b/dev-docs/modules/insuradsRtdProvider.md
new file mode 100644
index 0000000000..0135d4d0e5
--- /dev/null
+++ b/dev-docs/modules/insuradsRtdProvider.md
@@ -0,0 +1,62 @@
+---
+layout: page_v2
+title: InsurAds RTD Module
+display_name: InsurAds RTD Module
+description: InsurAds Real Time Data Module
+page_type: module
+module_type: rtd
+module_code : insuradsRtdProvider
+enable_download : true
+vendor_specific: true
+sidebarType : 1
+---
+
+# InsurAds RTD Module
+{:.no_toc}
+
+* TOC
+{:toc}
+
+## Description
+
+The [InsurAds](https://insurads.com) real-time data module enables publishers to leverage contextual targeting and audience segmentation capabilities. This module fetches real-time key-value targeting data from the InsurAds services and automatically enriches InsurAds bid requests enhancing your advertising strategies without requiring additional code changes.
+
+## Integration
+
+1. Compile the InsurAds RTD Module along with the InsurAds bid adapter and other modules into your Prebid build:
+
+    ```bash
+    gulp build --modules="rtdModule,insuradsRtdProvider,insuradsBidAdapter,..."
+    ```
+
+2. Use `setConfig` to instruct Prebid.js to initialize the InsurAds RTD module, as specified below.
+
+## Configuration
+
+This module is configured as part of the `realTimeData.dataProviders`
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        auctionDelay: 2000,
+        dataProviders: [{
+            name: 'insuradsRtd',
+            waitForIt: true,
+            params: {
+                publicId: 'YOUR_PUBLIC_ID'
+            }
+        }]
+    }
+});
+```
+
+## Parameters
+
+{: .table .table-bordered .table-striped }
+
+| Name              | Type    | Description                                                       | Default              |
+| :---------------- | :------ | :---------------------------------------------------------------- |:-------------------- |
+| name              | String  | Real time data module name                                        | Always 'insuradsRtd' |
+| waitForIt         | Boolean | Should be `true` if there's an `auctionDelay` defined (optional)  | `false`              |
+| params            | Object  |                                                                   |                      |
+| params.publicId   | String  | Your InsurAds public ID (required)                                |                      |

From c8f2f57571c1b1a12e8e2a7d1c99233f8aaf2bbc Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Thu, 14 May 2026 21:18:57 +0300
Subject: [PATCH 597/665] Adnimation adapter (#6446)

* adnimation doc

* naming fix

* using right gvlid

* remove "filename" field

* trying to fix markup

* trying to fix markdownlint error

* reformat table

* pbs: false (just for initial publish)

---------

Co-authored-by: Anna Yablonsky <annay+perion@perion.com>
---
 dev-docs/bidders/adnimation.md | 85 +++++++++++++++++++++++++---------
 1 file changed, 64 insertions(+), 21 deletions(-)

diff --git a/dev-docs/bidders/adnimation.md b/dev-docs/bidders/adnimation.md
index dd7eefa28c..38ca52d2df 100644
--- a/dev-docs/bidders/adnimation.md
+++ b/dev-docs/bidders/adnimation.md
@@ -3,35 +3,78 @@ layout: bidder
 title: Adnimation
 description: Prebid Adnimation Bidder Adaptor
 biddercode: adnimation
-pbjs: true
-pbs: false
-media_types: video, banner
-userIds: all
-fpd_supported: false
+userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 tcfeu_supported: false
 usp_supported: true
-coppa_supported: true
+coppa_supported: false
 schain_supported: true
+gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+floors_supported: true
+media_types: banner, video
 prebid_member: false
-ortb_blocking_supported: true
+safeframes_ok: false
+deals_supported: false
+pbs_app_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
-floors_supported: false
-aliasCode: limelightDigital
+pbjs: true
+pbs: false
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params for Prebid.js
 
 {: .table .table-bordered .table-striped }
 
-| Name          | Scope    | Description                                            | Example                | Type      |
-|:--------------|:---------|:-------------------------------------------------------|:-----------------------|:----------|
-| `host`        | required | Ad network's RTB host                                  | `'adnimation.trading'` | `string`  |
-| `adUnitId`    | required | Ad Unit Id will be generated on Adnimation Platform.   | `42`                   | `integer` |
-| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                | `'banner'`             | `string`  |
-| `publisherId` | required | Publisher ID                                           | `'12345'`              | `string`  |
-| `custom1`     | optional | Custom targeting field 1                               | `'custom1'`            | `string`  |
-| `custom2`     | optional | Custom targeting field 2                               | `'custom2'`            | `string`  |
-| `custom3`     | optional | Custom targeting field 3                               | `'custom3'`            | `string`  |
-| `custom4`     | optional | Custom targeting field 4                               | `'custom4'`            | `string`  |
-| `custom5`     | optional | Custom targeting field 5                               | `'custom5'`            | `string`  |
+| Name       | Scope    | Description                                                                                 | Example                      | Type     |
+|------------|----------|---------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from Adnimation.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`      | required | The publisher ID from Adnimation (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. Adnimation will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+## Bid Params for Prebid Server
+
+{: .table .table-bordered .table-striped }
+
+| Name  | Scope    | Description                        | Example                      | Type     |
+|-------|----------|------------------------------------|------------------------------|----------|
+| `cId` | required | The connection ID from Adnimation. | `'562524b21b1c1f08117fc7f9'` | `string` |
+
+### Example
+
+  ```javascript
+var adUnits = [{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [728, 90]
+            ]
+        }
+    },
+    bids: [{
+        bidder: 'adnimation',
+        params: {
+            cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
+            pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
+            bidFloor: 1.23                   // Optional
+        }
+    }]
+}
+];
+
+// configure pbjs to enable user syncing
+pbjs.setConfig({
+    userSync: {
+        filterSettings: {
+            iframe: {
+                bidders: 'adnimation',
+                filter: 'include'
+            }
+        }
+    }
+});
+```

From 27c5a99dd83f76eef2590592b9d4ed7d29192644 Mon Sep 17 00:00:00 2001
From: PGAMDSP <103131000+mastap150@users.noreply.github.com>
Date: Thu, 14 May 2026 15:47:48 -0400
Subject: [PATCH 598/665] pgamdirect: add redirect_from, remove legacy pgam +
 pgammedia pages (#6565)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Follow-up cleanup to #6536 (which landed pgamdirect.md with GVL 1353).
Two improvements that didn't make the original merge:

1. Add `redirect_from` to pgamdirect.md so historical links to
   `/dev-docs/bidders/pgam` and `/dev-docs/bidders/pgammedia` resolve
   to the new canonical page instead of 404-ing once the legacy
   pages are removed.

2. Remove the legacy pgam.md and pgammedia.md pages. Both are stale:
   - pgam.md: biddercode `pgam`, marked `removed in 8.13.0` — has
     not had a working adapter in prebid-js master for releases.
   - pgammedia.md: documents an aniview alias (`aliasCode: aniview`)
     for an adapter PGAM Media no longer operates. The live PGAM
     bidders are pgamssp (TeqBlaze-hosted, still maintained for
     legacy partners) and pgamdirect (this page, self-hosted).

@muuki88 cherry-picked the redirect commit on a prior branch
(ba009a0c) — re-submitting it here as a clean two-commit PR against
the current master post-#6536 merge.

Lint: markdownlint-cli passes against the repo's `.markdownlint.json`
with 2-space (not tab) indentation in the redirect_from block.
---
 dev-docs/bidders/pgam.md       | 106 ---------------------------------
 dev-docs/bidders/pgamdirect.md |   3 +
 dev-docs/bidders/pgammedia.md  |  48 ---------------
 3 files changed, 3 insertions(+), 154 deletions(-)
 delete mode 100644 dev-docs/bidders/pgam.md
 delete mode 100644 dev-docs/bidders/pgammedia.md

diff --git a/dev-docs/bidders/pgam.md b/dev-docs/bidders/pgam.md
deleted file mode 100644
index 0baba0ba06..0000000000
--- a/dev-docs/bidders/pgam.md
+++ /dev/null
@@ -1,106 +0,0 @@
----
-layout: bidder
-title: PGAM
-description: Prebid PGAM Bidder Adapter
-biddercode: pgam
-media_types: video,banner
-tcfeu_supported: false
-userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
-schain_supported: true
-coppa_supported: true
-usp_supported: true
-safeframes_ok: true
-prebid_member: true
-pbjs: true
-pbs: false
-enable_download: false
-sidebarType: 1
-pbjs_version_notes: removed in 8.13.0
----
-
-### Bid params
-
-{: .table .table-bordered .table-striped }
-| Name  | Scope    | Description                     | Example  | Type      |
-|-------|----------|---------------------------------|----------|-----------|
-| `aid` | required | The source ID from PGAM.   | `529814` | `integer` |
-
-### Description
-
-PGAM header bidding adapter connects with PGAM demand sources in order to fetch bids.
-This adapter provides a solution for accessing Video demand and display demand.
-
-### Test Parameters
-
-```javascript
-var adUnits = [
-
-  // Video instream adUnit
-  {
-    code: 'test-div',
-    mediaTypes: {
-      video: {
-        context: 'instream',
-        playerSize: [640, 480]
-      }
-    },
-    bids: [{
-      bidder: 'pgam',
-      params: {
-        aid: 472386
-      }
-    }]
-  },
-
-  // Video outstream adUnit
-  {
-    code: 'test-div',
-    mediaTypes: {
-      video: {
-        context: 'outstream',
-        playerSize: [640, 480]
-      }
-    },
-    bids: [{
-      bidder: 'pgam',
-      params: {
-        aid: 472386
-      }
-    }]
-  },
-
-    // Video ADPOD adUnit
-  {
-    code: 'test-div',
-    sizes: [[640, 480]],
-    mediaTypes: {
-      video: {
-        context: 'adpod',
-        playerSize: [640, 480]            
-      }
-    },
-    bids: [{
-      bidder: 'pgam',
-      params: {
-        aid: 472386
-      }
-    }]
-  },
-
-  // Banner adUnit
-  {
-    code: 'test-div',
-    mediaTypes:{
-        banner:{
-            sizes: [[300, 250]]
-        }
-    }
-    bids: [{
-      bidder: 'pgam',
-      params: {
-        aid: 529814
-      }
-    }]
-  }
-];
-```
diff --git a/dev-docs/bidders/pgamdirect.md b/dev-docs/bidders/pgamdirect.md
index 6cae04f6f2..1a1b161bb2 100644
--- a/dev-docs/bidders/pgamdirect.md
+++ b/dev-docs/bidders/pgamdirect.md
@@ -2,6 +2,9 @@
 layout: bidder
 title: PGAM Direct
 description: Server-to-server OpenRTB 2.6 adapter from PGAM Media (self-hosted). Dynamic floors, transparent margins, schain integrity. Related — pgamssp (legacy, TeqBlaze-hosted).
+redirect_from:
+  - /dev-docs/bidders/pgam
+  - /dev-docs/bidders/pgammedia
 biddercode: pgamdirect
 media_types: banner, video, native
 gvl_id: 1353
diff --git a/dev-docs/bidders/pgammedia.md b/dev-docs/bidders/pgammedia.md
deleted file mode 100644
index 14f35e5809..0000000000
--- a/dev-docs/bidders/pgammedia.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-layout: bidder
-title: PGAM MEDIA
-description: Prebid PGAM MEDIA Bidder Adapter
-pbjs: true
-biddercode: pgammedia
-aliasCode: aniview
-media_types: banner, video
-gvl_id: 780 (aniview)
-tcfeu_supported: true
-usp_supported: true
-schain_supported: true
-safeframes_ok: true
-sidebarType: 1
----
-
-### Note
-
-For more information about [PGAM MEDIA](https://pgammedia.com/).
-
-### Bid Params
-
-| Name             | Scope    | Description      | Example                      | Type     |
-|------------------|----------|------------------|------------------------------|----------|
-| `AV_PUBLISHERID` | required | Publisher/Netid  | `'55b88d4a181f465b3e8b4567'` | `string` |
-| `AV_CHANNELID`   | required | Channel id       | `'5a5f17a728a06102d14c2718'` | `string` |
-
-### Test Parameters
-
-```javascript
-const videoAdUnit = [
-{
-  code: 'video1',
-  mediaTypes: {
-    video: {
-      playerSize: [[640, 480]],
-      context: 'outstream'
-    },
-  },
-  bids: [{
-    bidder: 'pgammedia',
-    params: {
-      AV_PUBLISHERID: '55b78633181f4603178b4568',
-      AV_CHANNELID: '5d19dfca4b6236688c0a2fc4'
-    }
-  }]
-}];
-```

From 9365773b0f327f60cd55a0fec283478bf9eb14e6 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 15 May 2026 09:45:11 +0200
Subject: [PATCH 599/665] Update reference docs with the changes made in V10
 (#6506)

* Update pb10-notes.md: refer to correct method

* dfp has been renamed to gam

* Made distinction between methods returnning an array and methods returning a map

* Clarified return type

* Clarified return type

* Documented null return type

* Lint error: add missing space to the left/right of table pipe

* Lint error: table should be surrounded by blank lines

* Lint error: add missing space to table pipe

* Lint error: heading levels should only increment by one level at a time

* Restored the level of the headers

* dfpAdServerVideo -> gamAdServerVideo

* Remove trailing blank lines

* Fix header levels

* Re-add a single trailing white line
---
 dev-docs/pb10-notes.md                        | 13 ++++++-----
 .../adServers.dfp.buildVideoUrl.md            | 11 ---------
 ...md => adServers.gam.buildAdpodVideoUrl.md} | 14 +++++------
 .../adServers.gam.buildVideoUrl.md            |  1 -
 .../adServers.gam.getVastXml.md               | 10 ++++----
 .../getBidResponses.md                        | 23 ++++---------------
 .../getBidResponsesForAdUnitCode.md           |  3 ++-
 ...etHighestUnusedBidResponseForAdUnitCode.md |  1 +
 8 files changed, 27 insertions(+), 49 deletions(-)
 delete mode 100644 dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
 rename dev-docs/publisher-api-reference/{adServers.dfp.buildAdpodVideoUrl.md => adServers.gam.buildAdpodVideoUrl.md} (88%)

diff --git a/dev-docs/pb10-notes.md b/dev-docs/pb10-notes.md
index 20fa95ba27..664677a343 100644
--- a/dev-docs/pb10-notes.md
+++ b/dev-docs/pb10-notes.md
@@ -19,11 +19,12 @@ This document describes the changes included for Prebid.js version 10.0.
 1. A large number of obsolete modules have been removed. Many modules have changed name. See below for the list.
 2. The legacy method of native targeting keys, `sendTargetingKeys`, has been removed.
 3. `pbadslot` has been removed from the preAuction module. Use `ortb2Imp.ext.gpid` instead.
-4. The API methods `getBidResponses` and `getNoBidsForAdUnitCode` now return arrays of bids.
-5. TypeScript support has landed and Node.js 20+ is required to build.
-6. Using Prebid as an NPM dependency no longer requires using Babel or Prebid's Babel settings.
-7. `targetingControls.allBidsCustomTargeting` now defaults to `false`, this prevents custom targeting values from being set for non-winning bids.
-8. Storage use disclosures can now be enforced and catalogued 
+4. The API methods `getBidResponsesForAdUnitCode` and `getNoBidsForAdUnitCode` now return arrays of bids.
+5. The API methods `getBidResponses` and `getNoBids` now return an object with an array of bids for each ad unit.
+6. TypeScript support has landed and Node.js 20+ is required to build.
+7. Using Prebid as an NPM dependency no longer requires using Babel or Prebid's Babel settings.
+8. `targetingControls.allBidsCustomTargeting` now defaults to `false`, this prevents custom targeting values from being set for non-winning bids.
+9. Storage use disclosures can now be enforced and catalogued 
 
 ## Removed Modules
 
@@ -32,7 +33,7 @@ The following modules have been removed from Prebid.js as part of the 10.0 relea
 {: .table .table-bordered .table-striped }
 
 | Module | Replacement |
-|:-----------------------------|:-------------------------|
+| :----------------------------- | :------------------------- |
 | dfpAdServerVideo | gamAdServerVideo |
 | dfpAdPod | gamAdPod |
 | telariaBidAdapter | |
diff --git a/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md b/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
deleted file mode 100644
index 0a98367501..0000000000
--- a/dev-docs/publisher-api-reference/adServers.dfp.buildVideoUrl.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-layout: api_prebidjs
-title: pbjs.adServers.dfp.buildVideoUrl(options)
-description: adServers.dfp.buildVideoUrl API
-sidebarType: 1
----
-
-See [adServers.gam.buildVideoUrl](/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.html).
-
-{: .alert.alert-info :}
-In Prebid 10, the `dfpAdServerVideo` module and the `adServers.dfp.buildVideoUrl` API were renamed to `gamAdServerVideo` and `adServers.gam.buildVideoUrl` respectively.**
diff --git a/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md b/dev-docs/publisher-api-reference/adServers.gam.buildAdpodVideoUrl.md
similarity index 88%
rename from dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md
rename to dev-docs/publisher-api-reference/adServers.gam.buildAdpodVideoUrl.md
index 2622837b3c..cf0d72f57c 100644
--- a/dev-docs/publisher-api-reference/adServers.dfp.buildAdpodVideoUrl.md
+++ b/dev-docs/publisher-api-reference/adServers.gam.buildAdpodVideoUrl.md
@@ -1,19 +1,19 @@
 ---
 layout: api_prebidjs
-title: pbjs.adServers.dfp.buildAdpodVideoUrl(options) <span style="color:red" markdown="1">[Alpha]</span>
-description: adServers.dfp.buildAdpodVideoUrl API
+title: pbjs.adServers.gam.buildAdpodVideoUrl(options) <span style="color:red" markdown="1">[Alpha]</span>
+description: adServers.gam.buildAdpodVideoUrl API
 sidebarType: 1
 ---
 
 
 {: .alert.alert-info :}
-The GAM implementation of this function requires including the `dfpAdServerVideo` module in your Prebid.js build.
+The GAM implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.
 
 This method combines publisher-provided parameters with Prebid.js targeting parameters to build a GAM video ad tag URL that can be used by a video player.
 
-#### Argument Reference
+## Argument Reference
 
-##### The `options` object
+### The `options` object
 
 {: .table .table-bordered .table-striped }
 | Field    | Type   | Description                                                                                                                                                                        |
@@ -23,7 +23,7 @@ This method combines publisher-provided parameters with Prebid.js targeting para
 
 {% include alerts/alert_important.html content="For long form Prebid.js will add key-value strings for multiple bids. This prevents retrieving the description url from bid." %}
 
-#### Example
+## Example
 
 ```JavaScript
 pbjs.que.push(function(){
@@ -42,7 +42,7 @@ pbjs.que.push(function(){
 
     pbjs.requestBids({
         bidsBackHandler: function(bids) {
-            pbjs.adServers.dfp. buildAdpodVideoUrl({
+            pbjs.adServers.gam. buildAdpodVideoUrl({
                 codes: ['sample-code'],
                 params: {
                     iu: '/123456/testing/prebid.org/adunit1',
diff --git a/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md b/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md
index a071056949..b30b8bc35c 100644
--- a/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md
+++ b/dev-docs/publisher-api-reference/adServers.gam.buildVideoUrl.md
@@ -5,7 +5,6 @@ description: adServers.gam.buildVideoUrl API
 sidebarType: 1
 ---
 
-
 {: .alert.alert-info :}
 The Google Ad Manager implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.
 
diff --git a/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md b/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md
index 9a45bd6d96..3d85c8dde0 100644
--- a/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md
+++ b/dev-docs/publisher-api-reference/adServers.gam.getVastXml.md
@@ -7,15 +7,15 @@ sidebarType: 1
 
 
 {: .alert.alert-info :}
-The Google Ad Manager implementation of this function requires including the dfpAdServerVideo module in your Prebid.js build.
+The Google Ad Manager implementation of this function requires including the `gamAdServerVideo` module in your Prebid.js build.
 
 This method extends the behavior of `buildVideoUrl` by not only constructing the Google Ad Manager video ad tag URL, but also fetching and processing the resulting VAST wrapper returned by GAM.
 
 If the `cache.useLocal` flag is set to true, the function scans the received GAM VAST wrapper for the bid’s cached asset URL that corresponds to a locally stored blob in Prebid.js. When such a match is found, it replaces the contents of the GAM wrapper with the contents of the locally cached VAST XML blob, effectively inlining the ad markup instead of referencing it remotely.
 
-#### Argument Reference
+## Argument Reference
 
-##### The `options` object
+### The `options` object
 
 {: .table .table-bordered .table-striped }
 | Field    | Type   | Description                                                                                                                                                                        |
@@ -28,7 +28,7 @@ If the `cache.useLocal` flag is set to true, the function scans the received GAM
 {: .alert.alert-warning :}
 One or both of options.params and options.url is required. In other words, you may pass in one, the other, or both, but not neither.
 
-##### The `options.params` object
+### The `options.params` object
 
 {: .table .table-bordered .table-striped }
 | Field             | Type   | Description                                                                                                                 | Example                                         |
@@ -39,7 +39,7 @@ One or both of options.params and options.url is required. In other words, you m
 
 For more information on any of these params, see [the Google Ad Manager video tag documentation](https://support.google.com/admanager/answer/1068325).
 
-#### Example
+## Example
 
 ```javascript
 pbjs.requestBids({
diff --git a/dev-docs/publisher-api-reference/getBidResponses.md b/dev-docs/publisher-api-reference/getBidResponses.md
index ec1decf4d2..276d9b6f97 100644
--- a/dev-docs/publisher-api-reference/getBidResponses.md
+++ b/dev-docs/publisher-api-reference/getBidResponses.md
@@ -10,7 +10,7 @@ This function returns the bid responses at the given moment.
 
 **Kind**: static method of `pbjs`.
 
-**Returns**: `object` - map | object that contains the bidResponses.
+**Returns**: `object` - map | object that contains for each ad unit the array of bid responses. For backwards compatibility, the arrays expose the array also under the `.bids` property.
 
 **Returned Object Params**:
 
@@ -36,7 +36,6 @@ This function returns the bid responses at the given moment.
 | `adserverTargeting`  | Object  | Contains all the adserver targeting parameters | `{ "hb_bidder": "appnexus", "hb_adid": "7a53a9d3" }` |
 | `native`  | Object  | Contains native key value pairs. | `{ "title": "", "body": "" }` |
 | `status`  | String  | Status of the bid. Possible values: targetingSet, rendered | `"targetingSet"` |
-| `statusMessage`     | String  | The bid's status message                                                                                                        | "Bid returned empty or error response" or "Bid available" |
 | `ttl`  | Integer  | How long (in seconds) this bid is considered valid. See this [FAQ entry]({{site.github.url}}/dev-docs/faq.html#does-prebidjs-cache-bids) for more info. | `300` |
 | `meta` | Object | (Optional) Contains additional meta information about the bid. | `{ "advertiserDomains": [ "wherewindsmeetgame.com" ] }` |
 | `meta.advertiserDomains` | String[] | (Optional) Array with the advertiser domains | |
@@ -69,13 +68,11 @@ This function returns the bid responses at the given moment.
 
 ```json
 {
-  "/9968336/header-bid-tag-0": {
-    "bids": [
+  "/9968336/header-bid-tag-0":  [
       {
         "bidderCode": "appnexus",
         "width": 300,
         "height": 250,
-        "statusMessage": "Bid available",
         "adId": "7a53a9d3",
         "creative_id": 29681110,
         "cpm": 0.5,
@@ -96,7 +93,6 @@ This function returns the bid responses at the given moment.
         "bidderCode": "pubmatic",
         "width": "300",
         "height": "250",
-        "statusMessage": "Bid available",
         "adId": "1139e34e14",
         "adSlot": "39620189@300x250",
         "cpm": 1,
@@ -120,7 +116,6 @@ This function returns the bid responses at the given moment.
         "bidderCode": "rubicon",
         "width": "300",
         "height": "250",
-        "statusMessage": "Bid available",
         "adId": "130d3b0d9b",
         "cpm": 0.795995,
         "ad": "<scri...pt>",
@@ -139,15 +134,12 @@ This function returns the bid responses at the given moment.
           "hb_pb": "0.50"
         }
       }
-    ]
-  },
-  "/9968336/header-bid-tag1": {
-    "bids": [
+    ],
+  "/9968336/header-bid-tag1": [
       {
         "bidderCode": "casale",
         "width": 0,
         "height": 0,
-        "statusMessage": "Bid returned empty or error response",
         "adId": "108c0ba49d",
         "requestTimestamp": 1444844944130,
         "responseTimestamp": 1444844944223,
@@ -160,7 +152,6 @@ This function returns the bid responses at the given moment.
         "bidderCode": "openx",
         "width": "728",
         "height": "90",
-        "statusMessage": "Bid available",
         "adId": "14d7f9208f",
         "ad_id": "537161420",
         "cpm": 1.717,
@@ -179,7 +170,6 @@ This function returns the bid responses at the given moment.
         }
       }
     ]
-  }
 }
 ```
 
@@ -203,8 +193,7 @@ This function returns the bid responses at the given moment.
 
 ```json
 {
-    "div-banner-outstream-native" : {
-      "bids" : [
+    "div-banner-outstream-native" : [
           {
             "pbMg" : "10.00",
             "pbLg" : "5.00",
@@ -265,12 +254,10 @@ This function returns the bid responses at the given moment.
             "ttl" : 300,
             "status" : "targetingSet",
             "height" : 0,
-            "statusMessage" : "Bid available",
             "cpm" : 10,
             "currency" : "USD"
           }
       ]
-    }
 }
 ```
 
diff --git a/dev-docs/publisher-api-reference/getBidResponsesForAdUnitCode.md b/dev-docs/publisher-api-reference/getBidResponsesForAdUnitCode.md
index 7e2c984bdd..9018148b4a 100644
--- a/dev-docs/publisher-api-reference/getBidResponsesForAdUnitCode.md
+++ b/dev-docs/publisher-api-reference/getBidResponsesForAdUnitCode.md
@@ -9,9 +9,10 @@ Returns bidResponses for the specified adUnitCode. See full documentation at [pb
 
 **Kind**: static method of `pbjs`
 
-**Returns**: `Object` - bidResponse object
+**Returns**: `Array` - an array of bid responses. For backwards compatibility, the array exposes the array also under the `.bids` property.
 
 {: .table .table-bordered .table-striped }
+
 | Param | Scope | Type | Description |
 | --- | --- | --- | --- |
 | adUnitCode | Required | `String` | adUnitCode |
diff --git a/dev-docs/publisher-api-reference/getHighestUnusedBidResponseForAdUnitCode.md b/dev-docs/publisher-api-reference/getHighestUnusedBidResponseForAdUnitCode.md
index 03058d70c3..8a03ad9570 100644
--- a/dev-docs/publisher-api-reference/getHighestUnusedBidResponseForAdUnitCode.md
+++ b/dev-docs/publisher-api-reference/getHighestUnusedBidResponseForAdUnitCode.md
@@ -6,5 +6,6 @@ sidebarType: 1
 ---
 
 Use this method to retrieve the highest unused bid for the specified adUnit. Unused means not it's not rendered.
+Returns `null` when no suitable bid exists.
 
 This differs from [`getHighestCpmBids()`](/dev-docs/publisher-api-reference/getHighestCpmBids.html) in that getHighestCpmBids only considers bids for auctions that have completed (and are also unused), this function considers bids for ongoing auctions as well.

From 8895316aa73d1549c0cba34396cd8a7d53166c86 Mon Sep 17 00:00:00 2001
From: tzwierzchowski <102951000+tzwierzchowski@users.noreply.github.com>
Date: Fri, 15 May 2026 11:14:51 +0200
Subject: [PATCH 600/665] Add ABTShield User ID docs (#6559)

* Add ABTShield User ID docs

* Update dev-docs/modules/userid-submodules/abtshield.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* fixed lines

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 .../modules/userid-submodules/abtshield.md    | 78 +++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/abtshield.md

diff --git a/dev-docs/modules/userid-submodules/abtshield.md b/dev-docs/modules/userid-submodules/abtshield.md
new file mode 100644
index 0000000000..bd6d9581fe
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/abtshield.md
@@ -0,0 +1,78 @@
+---
+layout: userid
+title: ABTShield ID
+description: ABTShield ID User ID sub-module
+useridmodule: abtshieldIdSystem
+bidRequestUserId: abtshieldId
+eidsource: abtshield.com
+example: '"abc-123-def-456"'
+---
+
+ABTShield provides cookie-less user identification and audience segmentation for publishers. The module fetches a unique user UUID and optional audience segments from the ABTShield MCR endpoint and surfaces them to bid adapters via the standard Prebid.js `user.eids` interface.
+
+For more information and to obtain a service ID, visit [abtshield.com](https://abtshield.com).
+
+## ABTShield ID Prerequisites
+
+Before using this module you need a **service ID (`sid`)** - register at [abtshield.com](https://abtshield.com) to obtain a unique identifier for your integration. You must also whitelist every domain from which the module will be loaded in the ABTShield dashboard.
+
+## ABTShield ID Configuration
+
+Add the module to your Prebid.js build:
+
+```bash
+gulp build --modules=userId,abtshieldIdSystem
+```
+
+Then configure the module in your `userSync` configuration:
+
+```javascript
+pbjs.setConfig({
+    userSync: {
+        userIds: [{
+            name: 'abtshieldId',
+            params: {
+                sid: 'pb.your-service-id'  // required
+            },
+            storage: {
+                type: 'html5',
+                name: 'abtshield_id',
+                expires: 1
+            }
+        }]
+    }
+});
+```
+
+{: .table .table-bordered .table-striped }
+| Param | Scope | Type | Description |
+| --- | --- | --- | --- |
+| `params.sid` | Required | String | Service ID obtained from abtshield.com. |
+| `params.endpoint` | Optional | String | Override the MCR endpoint. For test environments only. Must use HTTPS. |
+| `storage` | Recommended | Object | Standard Prebid User ID storage block (`html5` or `cookie`). |
+
+## ABTShield ID Example
+
+This will add a `userId.abtshieldId` property to bid requests:
+
+```javascript
+{
+  abtshieldId: {
+    uuid: 'abc-123-def-456',
+    segments: ['seg-1', 'seg-2']  // omitted when no segments are returned
+  }
+}
+```
+
+The `user.eids` entry will look like:
+
+```javascript
+{
+  source: 'abtshield.com',
+  uids: [{
+    id: 'abc-123-def-456',
+    atype: 1,
+    ext: { segments: ['seg-1', 'seg-2'] }  // omitted when no segments are returned
+  }]
+}
+```

From bb03e555fd99ae7a222d5ea9f12323b982c8ef58 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 18 May 2026 10:49:49 +0300
Subject: [PATCH 601/665] Attekmi: remove Smarthub docs (#6554)

* Attekmi: remove Smarthub docs

* add redirect_from

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/attekmi.md  |  3 +++
 dev-docs/bidders/smarthub.md | 40 ------------------------------------
 2 files changed, 3 insertions(+), 40 deletions(-)
 delete mode 100644 dev-docs/bidders/smarthub.md

diff --git a/dev-docs/bidders/attekmi.md b/dev-docs/bidders/attekmi.md
index 7d7be2512b..798b475edf 100644
--- a/dev-docs/bidders/attekmi.md
+++ b/dev-docs/bidders/attekmi.md
@@ -3,6 +3,9 @@ layout: bidder
 title: Attekmi
 description: Attekmi Bidder Adapter
 biddercode: smarthub
+redirect_from:
+  - /dev-docs/bidders/attekmi
+  - /dev-docs/bidders/smarthub
 usp_supported: true
 media_types: banner, video, native
 tcfeu_supported: false
diff --git a/dev-docs/bidders/smarthub.md b/dev-docs/bidders/smarthub.md
deleted file mode 100644
index 3b273f6928..0000000000
--- a/dev-docs/bidders/smarthub.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-layout: bidder
-title: Attekmi
-description: Attekmi Bidder Adapter
-biddercode: smarthub
-usp_supported: true
-schain_supported: true
-media_types: banner, video, native
-tcfeu_supported: false
-pbjs: true
-pbs: true
-pbs_app_supported: true
-sidebarType: 1
----
-
-### Note
-
-Please note that SmartHub has been renamed to Attekmi.
-
-### Prebid.js Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                     | Example                             | Type      |
-|---------------|----------|---------------------------------|-------------------------------------|-----------|
-| `partnerName` | required | Unique partner name             | `'partnertest'`                     | `string`  |
-| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
-| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
-| `region`      | optional | Region                          | `apac`                              | `string`  |
-| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`    | `Array(String)`   |
-| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
-| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.    | `4`                                 | `number`  |
-
-### Prebid Server Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description         | Example                              | Type     |
-|---------------|----------|---------------------|--------------------------------------|----------|
-| `partnerName` | required | Unique partner name | `'partnertest'`                      | `string` |
-| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
-| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From a38a89e87127c02eb591b9ab1408f464e7d1be8b Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Mon, 18 May 2026 18:35:16 +0300
Subject: [PATCH 602/665] New adapter: Native Agents (#6533)

* New adapter nativeagents

* fix: lint: change header level from h3 to h2 | MD001

* NativeAgents Bid Adapter: rename bider code to ntvagents
---
 dev-docs/bidders/ntvagents.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 dev-docs/bidders/ntvagents.md

diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md
new file mode 100644
index 0000000000..c51d30ae99
--- /dev/null
+++ b/dev-docs/bidders/ntvagents.md
@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: Native Agents
+description: Prebid Native Agents Bidder Adapter
+biddercode: ntvagents
+gpp_sids: usstate_all
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: false
+pbs_app_supported: false
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description  | Example                         | Type       |
+|---------------|----------|--------------|---------------------------------|------------|
+| `placementId` | optional | Placement Id | `'0'`                           | `'string'` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`                           | `'string'` |
+
+## Note
+
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId

From f49ec249fa01dce12952a9a68313f668d8ffe81a Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Tue, 19 May 2026 18:21:14 +0200
Subject: [PATCH 603/665] New Adapter: 9dotsmedialtd (#5966)

* new adapter 9dotsmedialtd.md

* pbjs support

* add empty line and false for pbjs

* Update 9dotsmedialtd.md

Fix

* Update 9dotsmedialtd.md

remove required fields, add host example

* Update 9dotsmedialtd.md

Host to Optional

* Update dev-docs/bidders/9dotsmedialtd.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update 9dotsmedialtd.md

---------

Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: Alexander Pykhteyev <alex.pykhteyev@gmail.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/9dotsmedialtd.md | 37 +++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/9dotsmedialtd.md

diff --git a/dev-docs/bidders/9dotsmedialtd.md b/dev-docs/bidders/9dotsmedialtd.md
new file mode 100644
index 0000000000..15fe201d4f
--- /dev/null
+++ b/dev-docs/bidders/9dotsmedialtd.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: 9dots media LTD
+description: Prebid 9dots media LTD Bidder Adaptor
+biddercode: 9dotsmedialtd
+pbjs: false
+pbs: true
+media_types: video, banner, native
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                   | Example                | Type      |
+|:--------------|:---------|:--------------------------------------------------------------|:-----------------------|:----------|
+| `publisherId` | required | Publisher ID                                                  | `'12345'`              | `string`  |
+| `custom1`     | optional | Custom targeting field 1                                      | `'custom1'`            | `string`  |
+| `custom2`     | optional | Custom targeting field 2                                      | `'custom2'`            | `string`  |
+| `custom3`     | optional | Custom targeting field 3                                      | `'custom3'`            | `string`  |
+| `custom4`     | optional | Custom targeting field 4                                      | `'custom4'`            | `string`  |
+| `custom5`     | optional | Custom targeting field 5                                      | `'custom5'`            | `string`  |
+
+9dots media LTD server-side Prebid Server adapter requires only `publisherId` parameter.
+9dots media LTD server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types.

From d6e8452322c401bdd7a3161a3cd78394c4fea22d Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Thu, 21 May 2026 17:26:58 +0200
Subject: [PATCH 604/665] Remove duplicate 'cpm' field from example (#6571)

---
 dev-docs/modules/debugging.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/dev-docs/modules/debugging.md b/dev-docs/modules/debugging.md
index d48c921634..e4da4b8637 100644
--- a/dev-docs/modules/debugging.md
+++ b/dev-docs/modules/debugging.md
@@ -212,7 +212,6 @@ pbjs.setConfig({
           mediaType: "native",
           source: "client",
           currency: "EUR",
-          cpm: 1.00,
           creativeId: "222222",
           native: { ortb: {
             link: { url: "http://example.com" },

From 708230fc10b150bd910bbe850a09701a2572e4b8 Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Thu, 21 May 2026 17:28:06 +0200
Subject: [PATCH 605/665] Remove adpod from the adunit-reference page as it is
 no longer supported in V11 (#6564)

---
 dev-docs/adunit-reference.md | 52 +-----------------------------------
 1 file changed, 1 insertion(+), 51 deletions(-)

diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md
index 2e3845022b..aee040614e 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -106,7 +106,7 @@ See [Prebid Native Implementation](/prebid/native-implementation.html) for detai
 | Name | Scope | Type | Description |
 |------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `pos` | Optional | Integer | Ad position on screen, see [OpenRTB 2.5 spec][openRTB]. OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
-| `context` | Recommended | String | The video context, either `'instream'`, `'outstream'`, or `'adpod'` (for long-form videos). Example: `context: 'outstream'`. Defaults to 'instream'. |
+| `context` | Recommended | String | The video context, either `'instream'` or `'outstream'`. Example: `context: 'outstream'`. Defaults to 'instream'. |
 | `useCacheKey` | Optional | Boolean | Defaults to `false`. While context `'instream'` always will return an vastUrl in bidResponse, `'outstream'` will not. Setting this `true` will use cache url defined in global options also for outstream responses. |
 | `placement` | Recommended | Integer | 1=in-stream, 2=in-banner, 3=in-article, 4=in-feed, 5=interstitial/floating. **Highly recommended** because some bidders require more than context=outstream. |
 | `plcmt` | Recommended | Integer | 1=in-stream, 2=accompanying content, 3=interstitial, 4=no content/standalone. **Highly recommended** to comply with new IAB video specifications. See [AdCOM v1 spec](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/develop/AdCOM%20v1.0%20FINAL.md#list_plcmtsubtypesvideo) |
@@ -129,21 +129,6 @@ See [Prebid Native Implementation](/prebid/native-implementation.html) for detai
 | `delivery` | Optional | Array[Integer] | Supported delivery methods (e.g., streaming, progressive), see [OpenRTB 2.5 spec][openRTB]. |
 | `playbackend` | Optional | Integer | The event that causes playback to end, see [OpenRTB 2.5 spec][openRTB]. |
 
-If `'video.context'` is set to `'adpod'` then the following parameters are also available.
-
-{: .table .table-bordered .table-striped }
-| Name | Scope | Type | Description |
-|------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `adPodDurationSec` | Required | Number | The length of the adpod in seconds. Example: `adPodDurationSec = 120` |
-| `durationRangeSec` | Required | Array[Number] | An array of numbers represents a list of the potential/accepted duration values that the creatives can be in the adpod block. Example: `durationRangeSec = [30, 60, 90]` |
-| `requireExactDuration` | Optional | Boolean | Whether the returned creatives running time must match the value of `adPodDurationSec`. Example: `requireExactDuration = true` |
-| `tvSeriesName` | Optional | String | The name of the television series video the adpod will appear in. Example: `tvSeriesName = 'Once Upon A Time'` |
-| `tvEpisodeName` | Optional | String | The name of the episode of the television series video the adpod will appear in. Example: `tvEpisodeName = 'Pilot'` |
-| `tvSeasonNumber` | Optional | Number | A number representing the season number of the television series video the adpod will appear in. Example: `tvSeasonNumber = 1` |
-| `tvEpisodeNumber` | Optional | Number | A number representing the episode number of the television series video the adpod will appear in. Example: `tvEpisodeNumber = 1` |
-| `contentLengthSec` | Optional | Number | A number representing the length of the video in seconds. Example: `contentLengthSec = 1` |
-| `contentMode` | Optional | String | A string indicating the type of content being displayed in the video player. There are two options, `live` and `on-demand`. Example: `contentMode = 'on-demand'` |
-
 <a name="adUnit-examples"></a>
 
 <a name="adUnit.video"></a>
@@ -193,7 +178,6 @@ When using the Video Module, the mediaTypes.video properties get filled out auto
   * [Instream Sound-On](#adUnit-video-example-instream)
   * [Accompanying Content](#adUnit-video-example-accompanying)
   * [No Content/Standalone](#adUnit-video-example-outstream)
-  * [Adpod (Long-Form)](#adUnit-video-example-adpod)
 * [Native](#adUnit-native-example)
 * [Multi-Format](#adUnit-multi-format-example)
 * [Twin Codes](#adUnit-twin-codes-example)
@@ -419,40 +403,6 @@ pbjs.addAdUnits({
 });
 ```
 
-<a name="adUnit-video-example-adpod"></a>
-
-#### Adpod (Long-Form)
-
-For an example of an adpod video ad unit that you handle on your own, see below. For more detailed instructions, see [Show Long-Form Video Ads]({{site.baseurl}}/prebid-video/video-long-form.html).
-
-```javascript
-var longFormatAdUnit = {
-    video: {
-       // required params
-       context: 'adpod',
-       playerSize: [640, 480],
-       adPodDurationSec: 300,
-       durationRangeSec: [15, 30],
-
-       // optional params
-       requireExactDuration: true,
-       tvSeriesName: 'TvName',
-       tvEpisodeName: 'episodeName',
-       tvSeasonNumber: 3,
-       tvEpisodeNumber: 6,
-       contentLength: 300, // time in seconds,
-       contentMode: 'on-demand'
-    }
-
-    bids: [{
-            bidder: 'appnexus',
-            params: {
-                placementId: '123456789',
-            }
-        }]
-}
-```
-
 <a name="adUnit-native-example"></a>
 
 ### Native

From 880d7fd584e40807e11eff397342755cfe79a8cd Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Thu, 28 May 2026 23:01:05 +0300
Subject: [PATCH 606/665] Apester adapter (#6448)

* changing adapter doc

* using right gvlid

* master merge; markdown fix

* remove "filename"

* pbs: false (just for initial publish)

* fix to comment about gpp

---------

Co-authored-by: Anna Yablonsky <annay+perion@perion.com>
---
 dev-docs/bidders/apester.md | 86 ++++++++++++++++++++++++++++---------
 1 file changed, 65 insertions(+), 21 deletions(-)

diff --git a/dev-docs/bidders/apester.md b/dev-docs/bidders/apester.md
index 068a7cb90c..9afcb1b0f4 100644
--- a/dev-docs/bidders/apester.md
+++ b/dev-docs/bidders/apester.md
@@ -1,36 +1,80 @@
 ---
 layout: bidder
 title: Apester
-description: Apester Bidder Adaptor
+description: Prebid Apester Bidder Adaptor
 biddercode: apester
-pbjs: true
-pbs: false
-media_types: video, banner
-userIds: all
-fpd_supported: false
+userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 tcfeu_supported: false
 usp_supported: true
-coppa_supported: true
+gvl_id: 354
+coppa_supported: false
 schain_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
+floors_supported: true
+media_types: banner, video
 prebid_member: false
-ortb_blocking_supported: true
+safeframes_ok: false
+deals_supported: false
+pbs_app_supported: false
+fpd_supported: false
+ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
-floors_supported: false
-aliasCode: limelightDigital
+pbjs: true
+pbs: false
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params for Prebid.js
 
 {: .table .table-bordered .table-striped }
 
-| Name         | Scope    | Description                                       | Example                  | Type      |
-|:-------------|:---------|:--------------------------------------------------|:-------------------------|:----------|
-| `host`       | required | Ad network's RTB host                             | `'apester-exchange.com'` | `string`  |
-| `adUnitId`   | required | Ad Unit Id will be generated on Apester Platform. | `42`                     | `integer` |
-| `adUnitType` | required | Type of Ad Unit (`'video'`, `'banner'`)           | `'banner'`               | `string`  |
-| `custom1`    | optional | Custom targeting field 1                          | `'custom1'`              | `string`  |
-| `custom2`    | optional | Custom targeting field 2                          | `'custom2'`              | `string`  |
-| `custom3`    | optional | Custom targeting field 3                          | `'custom3'`              | `string`  |
-| `custom4`    | optional | Custom targeting field 4                          | `'custom4'`              | `string`  |
-| `custom5`    | optional | Custom targeting field 5                          | `'custom5'`              | `string`  |
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from Apester.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `pId`      | required | The publisher ID from Apester (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. Apester will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+## Bid Params for Prebid Server
+
+{: .table .table-bordered .table-striped }
+
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from Apester.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+
+### Example
+
+  ```javascript
+var adUnits = [{
+    code: 'banner-div',
+    mediaTypes: {
+        banner: {
+            sizes: [
+                [300, 250],
+                [728, 90]
+            ]
+        }
+    },
+    bids: [{
+        bidder: 'apester',
+        params: {
+            cId: '562524b21b1c1f08117fc7f9', // Required - PROVIDED DURING SETUP...
+            pId: '59ac17c192832d0011283fe3', // Required - PROVIDED DURING SETUP...
+            bidFloor: 1.23                   // Optional
+        }
+    }]
+}
+];
+
+// configure pbjs to enable user syncing
+pbjs.setConfig({
+    userSync: {
+        filterSettings: {
+            iframe: {
+                bidders: 'apester',
+                filter: 'include'
+            }
+        }
+    }
+});
+```

From 547d2fdeb12e0b5546e27d690a6b6e23e9e5ea45 Mon Sep 17 00:00:00 2001
From: Florian Erl <46747754+florianerl@users.noreply.github.com>
Date: Fri, 29 May 2026 14:44:21 +0200
Subject: [PATCH 607/665] Humansecurity RTD Provider: migrate to TypeScript and
 optimize token handling (#6579)

* Humansecurity RTD Provider: migrate to TypeScript and optimize token handling

* - Migrated to TypeScript
- Removed hardcoded token injection into ortb2Fragments and delegate to the HUMAN implementation, enabling management of which bidders receive tokens and enhancing monitoring and control of latency and performance
- Introduce a cached implementation reference via getImpl()
- Add module version query parameter when loading the implementation script
- Wire onAuctionInitEvent so the implementation can collect QoS, telemetry and statistics per auction

* Fix markdownlint errors in humansecurityRtdProvider docs.

Add language tags to fenced code blocks and normalize the parameters table spacing for MD060.

Co-authored-by: Cursor <cursoragent@cursor.com>

* add metadata
add top headerline

* Add a newline before the Overview section in the HUMAN Security RTD documentation

---------

Co-authored-by: Florian Erl <46747754@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
---
 dev-docs/modules/humansecurityRtdProvider.md | 45 +++++++++++---------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/dev-docs/modules/humansecurityRtdProvider.md b/dev-docs/modules/humansecurityRtdProvider.md
index 93b1b35ea9..ee0708478b 100644
--- a/dev-docs/modules/humansecurityRtdProvider.md
+++ b/dev-docs/modules/humansecurityRtdProvider.md
@@ -19,6 +19,14 @@ sidebarType : 1
 
 ## Overview
 
+```text
+Module Name: HUMAN Security Rtd provider
+Module Type: Rtd Provider
+Maintainer: alexey@humansecurity.com
+```
+
+### What is it?
+
 The HUMAN Security RTD submodule offers publishers a mechanism to integrate pre-bid signal collection
 for the purpose of providing real-time protection against all sorts of invalid traffic,
 such as bot-generated ad interactions or sophisticated ad fraud schemes.
@@ -34,12 +42,10 @@ sent within bid requests, and used for bot detection on the backend.
 * No incremental signals collected beyond existing HUMAN post-bid solution
 * Offsets negative impact from loss of granularity in IP and User Agent at bid time
 * Does not expose collected IVT signal to any party who doesn’t otherwise already have access to the same signal collected post-bid
-* Does not introduce meaningful latency, as demonstrated in the Latency section
+* Does not introduce meaningful latency
 * Comes at no additional cost to collect IVT signal and make it available at bid time
 * Leveraged to differentiate the invalid bid requests at device level, and cannot be used to identify a user or a device, thus preserving privacy.
 
-{% include dev-docs/loads-external-javascript.md %}
-
 ## Build
 
 First, make sure to add the HUMAN Security submodule to your Prebid.js package with:
@@ -69,8 +75,8 @@ pbjs.setConfig({
 });
 ```
 
-It can be optionally parameterized, for example, to include client ID obtained from HUMAN,
-should any advanced reporting be needed, or to have verbose output for troubleshooting:
+Other parameters can also be provided. For example, a client ID obtained from HUMAN can
+optionally be provided, or verbose output can be enabled for troubleshooting purposes:
 
 ```javascript
 pbjs.setConfig({
@@ -88,11 +94,11 @@ pbjs.setConfig({
 
 ### Supported parameters
 
-{: .table .table-bordered .table-striped }
-| Name             |Type           | Description                                                         | Required |
-| :--------------- | :------------ | :------------------------------------------------------------------ |:---------|
-| `clientId`  | String | Should you need advanced reporting, contact [prebid@humansecurity.com](prebid@humansecurity.com) to receive client ID. | No |
-| `verbose`   | Boolean | Only set to `true` if troubleshooting issues. | No |
+| Name | Type | Description | Required |
+| ---- | ---- | ----------- | -------- |
+| `clientId` | String | Should you need advanced reporting, contact [prebid@humansecurity.com](prebid@humansecurity.com) to receive client ID. | No |
+| `verbose` | Boolean | Only set to `true` if troubleshooting issues. | No |
+| `perBidderOptOut` | string[] | Pass any bidder alias to opt-out from per-bidder signal generation. | No |
 
 ### Logging, latency and troubleshooting
 
@@ -103,9 +109,6 @@ of type `ERROR`. With `verbose` parameter set to `true`, it may additionally:
 
 * Call `logWarning`, resulting in `auctionDebug` events of type `WARNING`,
 * Call `logInfo` with latency information.
-  * To observe these messages in console, Prebid.js must be run in
-    [debug mode](/dev-docs/publisher-api-reference/setConfig.html#debugging) -
-    either by adding `?pbjs_debug=true` to your page's URL, or by configuring with `pbjs.setConfig({ debug: true });`
 
 Example output of the latency information:
 
@@ -153,6 +156,7 @@ There are a few points that are worth being mentioned separately, to avoid confu
   the ever-evolving nature of the threat landscape without the publishers having to rebuild their Prebid.js frequently.
   * The signal collection script is also obfuscated, as a defense-in-depth measure in order to complicate tampering by
     bad actors, as are all similar scripts in the industry, which is something that cannot be accommodated by Prebid.js itself.
+* The collected signals are encrypted before they are passed to bid adapters and can only be interpreted by HUMAN backend systems.
 
 ### Why is this approach an innovation?
 
@@ -213,10 +217,14 @@ ensuring the value of the inventory.
 
 ### FAQ
 
+#### Is partnership with HUMAN required to use the submodule?
+
+No. Using this submodule does not require any prior communication with HUMAN or being a client of HUMAN.
+It is free and usage of the submodule doesn’t automatically make a Publisher HUMAN client. 
+
 #### Is latency an issue?
 
 The HUMAN Security RTD submodule is designed to minimize any latency in the auction within normal SLAs.
-
 #### Do publishers get any insight into how the measurement is judged?
 
 Having the The HUMAN Security RTD submodule be part of the prebid process will allow the publisher to have insight
@@ -225,12 +233,9 @@ inventory to the buyer.
 
 #### How are privacy concerns addressed?
 
-The HUMAN Security RTD submodule seeks to reduce the impacts from signal deprecation that are inevitable without
-compromising privacy by avoiding re-identification. Each bid request is enriched with just enough signal
-to identify if the traffic is invalid or not.
-
-By having the The HUMAN Security RTD submodule operate at the Prebid level, data can be controlled
-and not as freely passed through the bidstream where it may be accessible to various unknown parties.
+The HUMAN Security RTD submodule seeks to reduce the impacts of signal deprecation without compromising privacy.
+Each bid request is enriched with just enough signal to identify if the traffic is invalid or not, and these
+signals are encrypted before being included in bid requests to prevent misuse.
 
 Note: anti-fraud use cases typically have carve outs in laws and regulations to permit data collection
 essential for effective fraud mitigation, but this does not constitute legal advice and you should

From bee5754fc3beab0edc41eb066a9b1b73d7794e5e Mon Sep 17 00:00:00 2001
From: mkdefinemedia <m.klumpp@definemedia.de>
Date: Mon, 1 Jun 2026 16:41:33 +0200
Subject: [PATCH 608/665] fix(defineMedia): replace tab with spaces in
 redirect_from YAML (#6566)

The YAML front matter in defineMedia.md used a hard tab character
to indent the redirect_from list item. YAML does not allow tabs as
indentation, causing Jekyll to throw a parse error and skip the file
entirely. As a result, the Define Media adapter was not rendered on
the download page.

Replace the tab with two spaces to fix the YAML parse error.

Co-authored-by: flow1907 <mklumpp84@gmail.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 dev-docs/bidders/defineMedia.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/defineMedia.md b/dev-docs/bidders/defineMedia.md
index c1da1fd483..4e38afade2 100644
--- a/dev-docs/bidders/defineMedia.md
+++ b/dev-docs/bidders/defineMedia.md
@@ -4,7 +4,7 @@ title: DEFINE MEDIA
 description: Prebid DEFINE MEDIA Bidder Adapter
 biddercode: defineMedia
 redirect_from:
-	- /dev-docs/bidders/definemedia.html
+  - /dev-docs/bidders/definemedia.html
 tcfeu_supported: true
 gvl_id: 440
 media_types: banner

From f4afc6773b224b5939765292777f36ae2d4bbebb Mon Sep 17 00:00:00 2001
From: Ritesh <ritesh.ghodrao@gmail.com>
Date: Mon, 1 Jun 2026 20:12:57 +0530
Subject: [PATCH 609/665] New bidder: Halo ads (#6569)

* added halo docs

* lint changes

---------

Co-authored-by: Ritesh Ghodrao <riteshghodrao@Riteshs-MacBook-Air.local>
---
 dev-docs/bidders/haloads.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/haloads.md

diff --git a/dev-docs/bidders/haloads.md b/dev-docs/bidders/haloads.md
new file mode 100644
index 0000000000..6093282724
--- /dev/null
+++ b/dev-docs/bidders/haloads.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: Halo Ads
+description: Halo Ads Bidder Adapter
+biddercode: haloads
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+userIds: all
+pbjs: true
+pbs: false
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+
+## Bid Params
+
+{:.table .table-bordered .table-striped}
+| Name          | Scope    | Description  | Example | Type     |
+|---------------|----------|--------------|---------|----------|
+| `placementId` | required | Placement Id | `'123'` | `string` |
+| `accountId`   | required | Account Id   | `'456'` | `string` |
+
+## Note
+
+Both `placementId` or `accountId` are mandatory.

From 74a44ed6158d53a389110bc5dbb624edfb55e5bf Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Mon, 1 Jun 2026 16:45:01 +0200
Subject: [PATCH 610/665] Document the null case for the replace rules in the
 debugging module (#6573)

---
 dev-docs/modules/debugging.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/dev-docs/modules/debugging.md b/dev-docs/modules/debugging.md
index e4da4b8637..592c8de6f5 100644
--- a/dev-docs/modules/debugging.md
+++ b/dev-docs/modules/debugging.md
@@ -114,7 +114,9 @@ To illustrate, these definitions are equivalent:
 
 ### Replace rules
 
-The replace rule can be provided as a function that takes the bid request as its only argument and returns an object with the desired response properties. The [first example above](#example) could be written as:
+The replace rule can be provided as a function that takes the bid request as its only argument and returns an object with the desired response properties. 
+The function can also return `null` to indicate that there is no bid.
+The [first example above](#example) could be written as:
 
 ```javascript
 pbjs.setConfig({
@@ -137,6 +139,8 @@ Alternatively, the rule can be expressed as an object, and its `key`-`value` pai
 - if `value` is a function, then `bidResponse[key]` will be set to `value(bidRequest)`;
 - otherwise, `bidResponse[key]` will be set to `value`.
 
+Using `null` as the object indicates that there was no bid.
+
 To illustrate, the following definitions are equivalent:
 
 ```javascript

From c5491dec2e5c0d4b95a8c766e5c904cdc1465e3a Mon Sep 17 00:00:00 2001
From: Pavlo Kavulych <72217414+Chucky-choo@users.noreply.github.com>
Date: Mon, 1 Jun 2026 17:46:53 +0300
Subject: [PATCH 611/665] New Adapter: matterfull (#6574)

* New Adapter: matterfull

* fix markdownlint heading level matterfull

* Matterfull Bid Adapter: make params.env field required
---
 dev-docs/bidders/matterfull.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/matterfull.md

diff --git a/dev-docs/bidders/matterfull.md b/dev-docs/bidders/matterfull.md
new file mode 100644
index 0000000000..d7e02aa524
--- /dev/null
+++ b/dev-docs/bidders/matterfull.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: Matterfull
+description: Matterfull Bidder Adapter
+biddercode: matterfull
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: false
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+## Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `0e232769e6f71d291ee7dbc9d157cf84` | `string`  |
+| `env`       | required | Environment name            | `matterfull`                       | `string`  |
+| `ext`       | optional | Specific integration config | `{}`                               | `object`  |

From b200cd3b91f89d2840df24dbd0d9c333058b2dd3 Mon Sep 17 00:00:00 2001
From: Pavlo Kavulych <72217414+Chucky-choo@users.noreply.github.com>
Date: Mon, 1 Jun 2026 20:46:08 +0300
Subject: [PATCH 612/665] New Adapter: anzuDSP (#6575)

* New Adapter: anzuDSP

* AnzuDSP Bid Adapter: make params.env field required
---
 dev-docs/bidders/anzuDSP.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dev-docs/bidders/anzuDSP.md

diff --git a/dev-docs/bidders/anzuDSP.md b/dev-docs/bidders/anzuDSP.md
new file mode 100644
index 0000000000..d790fb9e41
--- /dev/null
+++ b/dev-docs/bidders/anzuDSP.md
@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: AnzuDSP
+description: AnzuDSP Bidder Adapter
+biddercode: anzuDSP
+media_types: banner, video
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: true
+pbs: false
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+dchain_supported: false
+deals_supported: true
+fpd_supported: false
+ortb_blocking_supported: true
+privacy_sandbox: no
+---
+
+## Prebid.js Bid params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                 | Example                            | Type      |
+|-------------|----------|-----------------------------|------------------------------------|-----------|
+| `pid`       | required | Placement ID                | `0e232769e6f71d291ee7dbc9d157cf84` | `string`  |
+| `env`       | required | Environment name            | `anzuDSP`                          | `string`  |
+| `ext`       | optional | Specific integration config | `{}`                               | `object`  |

From d47b9e9e56a8fa31dd4f3b2b1486a397a2d84ff7 Mon Sep 17 00:00:00 2001
From: Filip Stamenkovic <filip.stamenkovic@showheroes-group.com>
Date: Mon, 1 Jun 2026 20:23:18 +0200
Subject: [PATCH 613/665] Showheroes Bid Adapter: enable gzip compression
 (#6504)

* enable compression

* lint fixes
---
 dev-docs/bidders/showheroes.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/dev-docs/bidders/showheroes.md b/dev-docs/bidders/showheroes.md
index a5282ce057..7f8d90b439 100644
--- a/dev-docs/bidders/showheroes.md
+++ b/dev-docs/bidders/showheroes.md
@@ -15,6 +15,7 @@ fpd_supported: true
 multiformat_supported: will-bid-on-one
 sidebarType: 1
 pbs: true
+endpoint_compression: true
 ---
 
 {: .alert.alert-danger :}
@@ -197,3 +198,22 @@ pbjs.que.push(function () {
 ```
 
 You can use this example and place in the `hello_world` gpt integration test page
+
+## Endpoint Compression
+
+This adapter utilizes gzip compression support built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](https://docs.prebid.org/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests)
+
+### Disabling Compression
+
+You can disable gzip compression at the bidder level using `pbjs.setBidderConfig`. Set the `gzipEnabled` value to false:
+
+```javascript
+pbjs.que.push(function () {
+  pbjs.setBidderConfig({
+    bidders: ['showheroes'],
+    config: {
+      gzipEnabled: false
+    }
+  });
+});
+```

From 27c25b9b3af72895b9e4b223bc91470019f6893b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tuer=C2=B7maimaitiaili=20Ba?= <bte808@foxmail.com>
Date: Thu, 4 Jun 2026 23:25:24 +0800
Subject: [PATCH 614/665] Fix SharedId documentation typo (#6598)

---
 identity/sharedid.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/identity/sharedid.md b/identity/sharedid.md
index 80cab18f7d..50d89c68dd 100644
--- a/identity/sharedid.md
+++ b/identity/sharedid.md
@@ -181,7 +181,7 @@ Publishers that decide to build a first-party opt-out workflow might follow a pr
 
 ## Alternative Implementations
 
-For those not using Prebid's header bidding solution, SharedId can deployed via in inline script reference or from a web server.
+For those not using Prebid's header bidding solution, SharedId can be deployed via in inline script reference or from a web server.
 
 ### SharedId Script
 

From 78b08a84312031c0b0f32bc8facbc1b14ca4e238 Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Fri, 5 Jun 2026 10:06:26 +0300
Subject: [PATCH 615/665] Adnimation adapter pbs (#6583)

* adnimation doc

* naming fix

* using right gvlid

* remove "filename" field

* trying to fix markup

* trying to fix markdownlint error

* reformat table

* pbs: false (just for initial publish)

* pbs: true

* pbs: true

---------

Co-authored-by: Anna Yablonsky <annay+perion@perion.com>
---
 dev-docs/bidders/adnimation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/dev-docs/bidders/adnimation.md b/dev-docs/bidders/adnimation.md
index 38ca52d2df..d7c27d7b90 100644
--- a/dev-docs/bidders/adnimation.md
+++ b/dev-docs/bidders/adnimation.md
@@ -8,7 +8,6 @@ tcfeu_supported: false
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
 gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
@@ -20,7 +19,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
 ---
 

From 9c5415715c1640611bf84b95b62a1936eb914843 Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Fri, 5 Jun 2026 14:35:23 +0200
Subject: [PATCH 616/665] fix in bidResponseFilter example (#6426)

Co-authored-by: Marcin Komorski <marcinkomorski@Marcins-MacBook-Pro.local>
---
 dev-docs/modules/bidResponseFilter.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/dev-docs/modules/bidResponseFilter.md b/dev-docs/modules/bidResponseFilter.md
index 2330ead05a..470ccded61 100644
--- a/dev-docs/modules/bidResponseFilter.md
+++ b/dev-docs/modules/bidResponseFilter.md
@@ -84,9 +84,7 @@ Enable both the attr and mediaTypes filters in the bidResponseFilter configurati
 pbjs.setConfig({
   bidResponseFilter: {
     attr: { enforce: true },
-    mediaTypes: {
-      banner: { enforce: true }
-    }
+    mediaTypes: { enforce: true }
   }
 });
 ```

From 64f0529acb5127f339e1d5c01f75de025f7e4c8b Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Fri, 5 Jun 2026 17:30:05 +0200
Subject: [PATCH 617/665] pubProvidedIdSystem: Document the eids param (#6604)

* Document the eids param

* linting errors
---
 dev-docs/modules/userid-submodules/pubprovided.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/pubprovided.md b/dev-docs/modules/userid-submodules/pubprovided.md
index e533bd8c15..77a8fa07c9 100644
--- a/dev-docs/modules/userid-submodules/pubprovided.md
+++ b/dev-docs/modules/userid-submodules/pubprovided.md
@@ -116,10 +116,11 @@ gulp build --modules=pubProvidedIdSystem
 
 {: .table .table-bordered .table-striped }
 
-| Params under usersync.userIds[]| Scope | Type | Description | Example |
+| Params under usersync.userIds[] | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
-| name | Required | String | ID value for the ID module  | `"PubProvided"` |
+| name | Required | String | ID value for the ID module | `"PubProvided"` |
 | params | Optional | Object | Details for syncing. | |
-| params.eidsFunction | Optional | function | any function that exists in the page | getIdsFn() |
+| params.eids | Optional | Object[] | Array of extended identifiers as defined in the OpenRTB specification. | |
+| params.eidsFunction | Optional | function | any function that exists in the page and returns an array of extended identifiers. The results are concatenated with `eids` | getIdsFn() |
 | uids.atype | optional | int | ADCOM - Type of user agent the match is from | `"1"` |
 | uids.ext.stype | Optional | String | Description of how the id was generated and by whom eg. ('ppuid','DMP','other') | `DMP` |

From 95b2a96b8c54fd24c8817cb714e500fd4159c327 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Fri, 5 Jun 2026 11:50:42 -0400
Subject: [PATCH 618/665] Document bid desirability adjustment (#6602)

---
 .../publisher-api-reference/bidderSettings.md | 60 ++++++++++++++-----
 1 file changed, 44 insertions(+), 16 deletions(-)

diff --git a/dev-docs/publisher-api-reference/bidderSettings.md b/dev-docs/publisher-api-reference/bidderSettings.md
index a39d866c98..a319828a39 100644
--- a/dev-docs/publisher-api-reference/bidderSettings.md
+++ b/dev-docs/publisher-api-reference/bidderSettings.md
@@ -6,7 +6,7 @@ sidebarType: 1
 ---
 
 
-#### 1. Overview
+## 1. Overview
 
 The bidderSettings object provides a way to define some behaviors for the
 platform and specific adapters. The basic structure is a 'standard' section with defaults for all adapters, and then one or more adapter-specific sections that override behavior for that bidder:
@@ -33,23 +33,24 @@ Some sample scenarios where publishers may wish to alter the default settings:
 * passing additional information to the ad server
 * adjusting the bid CPM sent to the ad server
 
-#### 2. Bidder Setting Attributes
+## 2. Bidder Setting Attributes
 
 {: .table .table-bordered .table-striped }
 | Attribute | Scope | Version | Default | Description |
 | --- | --- | --- | --- | --- |
 | adserverTargeting | standard or adapter-specific | all | see below | Define which key/value pairs are sent to the ad server. |
 | bidCpmAdjustment | standard or adapter-specific | all | n/a | Custom CPM adjustment function. Could, for example, adjust a bidder's gross-price bid to net price. |
+| bidDesirabilityAdjustment | standard or adapter-specific | 11.15.0 | n/a | Custom bid desirability adjustment function. Allows bids to be ranked by a publisher-defined score without changing the adjusted CPM. |
 | inverseBidAdjustment | standard or adapter-specific | 7.33.0 | n/a | Inverse of `bidCpmAdjustment` |
 | sendStandardTargeting | adapter-specific | 0.13.0 | true | If adapter-specific targeting is specified, can be used to suppress the standard targeting for that adapter. |
 | suppressEmptyKeys | standard or adapter-specific | 0.13.0 | false | If custom adserverTargeting functions are specified that may generate empty keys, this can be used to suppress them. |
 | allowZeroCpmBids | standard or adapter-specific | 6.2.0 | false | Would allow bids with a 0 CPM to be accepted by Prebid.js and could be passed to the ad server. |
 | storageAllowed | standard or adapter-specific | 6.13.0 | true in 6.x, false after 7.0 | Allow use of cookies and/or local storage. |  
-| allowAlternateBidderCodes | standard or adapter-specific | 6.23.0 | true in v6.x <br /> false from v7.0| Allow adapters to bid with alternate bidder codes. |  
+| allowAlternateBidderCodes | standard or adapter-specific | 6.23.0 | true in v6.x <br /> false from v7.0 | Allow adapters to bid with alternate bidder codes. |  
 | allowedAlternateBidderCodes | standard or adapter-specific | 6.23.0 | n/a | Array of bidder codes for which an adapter can bid. <br />`undefined` or `['*']` will allow adapter to bid with any bidder code. |
 | adjustAlternateBids | standard or adapter-specific | 7.48.0 | false | Optionally allow alternate bidder codes to use an adapter's bidCpmAdjustment function by default instead of the standard bidCpmAdjustment function if present (note: if a bidCpmAdjustment function exists for the alternate bidder code within bidderSettings, then this will be used instead of falling back to the adapter's bidCpmAdjustment function). |
 
-##### 2.1. adserverTargeting
+### 2.1. adserverTargeting
 
 As described in the [AdOps documentation]({{site.baseurl}}/adops/before-you-start.html), Prebid has a recommended standard
 set of ad server targeting that works across bidders. This standard targeting approach is
@@ -144,7 +145,7 @@ pbjs.bidderSettings = {
 }
 ```
 
-In other words, the above config sends 2 pairs of key/value strings targeting for every AppNexus bid and for every ad unit. The 1st pair would be `apn_pbMg` => the value of `bidResponse.pbMg`. The 2nd pair would be `apn_adId` => the value of `bidResponse.adId`. You can find the bidResponse object documentation [here](/troubleshooting/troubleshooting-guide.html#common-bid-response-parameters).
+In other words, the above config sends 2 pairs of key/value strings targeting for every AppNexus bid and for every ad unit. The 1st pair would be `apn_pbMg` => the value of `bidResponse.pbMg`. The 2nd pair would be `apn_adId` => the value of `bidResponse.adId`. See [common bid response parameters](/troubleshooting/troubleshooting-guide.html#common-bid-response-parameters) for bidResponse object documentation.
 
 Note that sendStandardTargeting is set to false so that the standard Prebid targeting (hb_bidder, etc.) aren't also sent to the ad server.
 
@@ -152,7 +153,7 @@ Note that sendStandardTargeting is set to false so that the standard Prebid targ
 
 Now let's say you would like to define a bidder-specific price bucket function rather than use the ones available by default in prebid.js. Even the [priceGranularity config](/dev-docs/publisher-api-reference/setConfig.html#setConfig-Price-Granularity) option applies to all bidders -- with this approach you can overwrite price buckets.
 
-*Note: this will only impact the price bucket sent to the ad server for targeting. It won't actually impact the cpm value used for ordering the bids.*
+*Note: this will only impact the price bucket sent to the ad server for targeting. It won't actually impact the CPM or desirability score used for ordering the bids.*
 
 ```javascript
 pbjs.bidderSettings = {
@@ -180,7 +181,7 @@ pbjs.bidderSettings = {
 }
 ```
 
-##### 2.2. bidCpmAdjustment
+### 2.2. bidCpmAdjustment
 
 Some bidders return gross prices instead of the net prices (what the publisher will actually
 get paid). For example, a publisher's net price might be 15% below the returned gross price.
@@ -189,7 +190,7 @@ header bidding auction. Otherwise, this bidder's gross price will unfairly win o
 other demand sources who report the real price.
 
 Custom adjustment can be provided as a function taking 3 arguments: `bidCpmAdjustment(cpm, bidResponse, bidRequest)`.
-Note that either `bidResponse` or `bidRequest` may be missing, although at least one of them is guaranteed to be present. This is because Prebid will sometimes need to run adjustment when no bid has been made yet; see [inverseBidAdjustment](#23-inversebidadjustment) below.
+Note that either `bidResponse` or `bidRequest` may be missing, although at least one of them is guaranteed to be present. This is because Prebid will sometimes need to run adjustment when no bid has been made yet; see [inverseBidAdjustment](#24-inversebidadjustment) below.
 
 For example:
 
@@ -208,7 +209,34 @@ pbjs.bidderSettings = {
 
 In the above example, the AOL bidder will inherit from "standard" adserverTargeting keys, so that you don't have to define the targeting keywords again.
 
-##### 2.3. inverseBidAdjustment
+### 2.3. bidDesirabilityAdjustment
+
+By default, Prebid.js ranks accepted bids using their CPM after `bidCpmAdjustment` has been applied. Publishers who want to rank bids with additional business logic can provide `bidDesirabilityAdjustment`. This function returns a numeric score used to compare bids: higher scores are preferred.
+
+This is useful when the publisher wants auction ordering to account for signals that should not change the bid's adjusted CPM, price bucket, or ad server reporting value. For example, a publisher could prefer bids from a demand source that has better historical fill, lower discrepancy, or other business-priority signals while keeping the CPM available for targeting and reporting unchanged.
+
+The function takes 3 arguments: `bidDesirabilityAdjustment(cpm, bidResponse, bidRequest)`. The `cpm` argument is the bid CPM after `bidCpmAdjustment` has been applied. The function should return a number, and the default score is the adjusted CPM. If the function throws an error, Prebid.js logs the error and falls back to the adjusted CPM.
+
+For example:
+
+```javascript
+pbjs.bidderSettings = {
+  standard: { ... },
+  exampleBidder: {
+    bidDesirabilityAdjustment: function(adjustedCpm, bid) {
+      // Prefer this bidder slightly for ordering without changing its CPM.
+      if (bid.dealId) {
+        return adjustedCpm + 0.25;
+      }
+      return adjustedCpm;
+    }
+  }
+};
+```
+
+In the above example, deal bids from `exampleBidder` receive a higher desirability score than their adjusted CPM. The bid's CPM is not changed by this function.
+
+### 2.4. inverseBidAdjustment
 
 When using [price floors](/dev-docs/modules/floors.html), Prebid attempts to calculate the inverse of `bidCpmAdjustment`, so that the floor values it requests from SSPs take into account how the bid will be adjusted.
 For example, if the adjustment is `bidCpm * .85` as above, floors are adjusted by `bidFloor * 1 / .85`.
@@ -231,7 +259,7 @@ pbjs.bidderSettings = {
 };
 ```
 
-##### 2.4. sendStandardTargeting
+### 2.5. sendStandardTargeting
 
 This boolean flag minimizes key/value pairs sent to the ad server when
 adapter-specific targeting is specified. By default, the platform will send both adapter-specific adServerTargeting as well as the standard adServerTargeting.
@@ -241,11 +269,11 @@ suppress the standard targeting for adapters that define their own.
 
 See the [example above](#key-targeting-specific-bidder) for example usage.
 
-##### 2.5. suppressEmptyKeys
+### 2.6. suppressEmptyKeys
 
 If a custom adServerTargeting function can return an empty value, this boolean flag can be used to avoid sending those empty values to the ad server.
 
-##### 2.6. allowZeroCpmBids
+### 2.7. allowZeroCpmBids
 
 By default, 0 CPM bids are ignored by Prebid.js entirely.  However if there's a valid business reason to allow these bids, this setting can be enabled to allow
 either specific bid adapter(s) or all bid adapters the permission for these bids to be processed by Prebid.js and potentially sent to the respective ad server
@@ -253,7 +281,7 @@ either specific bid adapter(s) or all bid adapters the permission for these bids
 
 <a id="storageAllowed"></a>
 
-##### 2.7. storageAllowed
+### 2.8. storageAllowed
 
 This setting defines if the bid adapter can access browser cookies or local storage. Allowed values are:
 
@@ -271,13 +299,13 @@ Note that:
 
 <a id="allowAlternateBidderCodes" />
 
-##### 2.8. allowAlternateBidderCodes
+### 2.9. allowAlternateBidderCodes
 
 If this flag is set to `true`, bidders that have not been explicitly requested in [`adUnit.bids`](../adunit-reference.html#adunitbids) may take part in the auction.
 <br />Default value is `true` in version 6.x
 <br />Default value will be `false` from version 7.0
 
-##### 2.9. allowedAlternateBidderCodes
+### 2.10. allowedAlternateBidderCodes
 
 This array will work in conjunction with `allowAlternateBidderCodes`. In this array, you can specify the names of the bidder for which an adapter can accept the bid. If the value is not specified for the array or `[‘*’]` is specified, Prebid will accept bids of all the bidders for the given adapter.
 
@@ -310,7 +338,7 @@ pbjs.bidderSettings = {
 In the above example, `groupm` bid will have a bid adjustment of 80% since the `bidCpmAdjustment` function says so.<br />
 If `appnexus` bids with another bidder code, say `appnexus2`. This bidder code will adjust the bid cpm to 95% because it will apply the `bidCpmAdjustment` function from `standard` setting, since the `bidCpmAdjustment` is missing for given bidder code I.e `appnexus2`
 
-##### 2.10. adjustAlternateBids
+### 2.11. adjustAlternateBids
 
 Optionally allow alternate bidder codes originating from a specific bid adapter to fallback to that same adapter's bidCpmAdjustment function. When adjustAlternateBids is set to true, the prioity of which bidCpmAdjustment function to utilize will be as follows based on what is present within the bidderSettings object:
 

From 139f89ceb0d626a48907a75b589bdd4718e411ef Mon Sep 17 00:00:00 2001
From: Marcin Muras <47107445+mmuras-gemius@users.noreply.github.com>
Date: Fri, 5 Jun 2026 19:18:56 +0200
Subject: [PATCH 619/665] AdOcean Bid Adapter: support for optional, extra
 emitter parameters (#6586)

* AdOcean Bid Adapter: support for optional, extra emitter parameters

* AdOcean Bid Adapter: fix lint error
---
 dev-docs/bidders/adocean.md | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/dev-docs/bidders/adocean.md b/dev-docs/bidders/adocean.md
index 483520cb8b..2c8c2be179 100644
--- a/dev-docs/bidders/adocean.md
+++ b/dev-docs/bidders/adocean.md
@@ -27,15 +27,16 @@ privacy_sandbox: no
 sidebarType: 1
 ---
 
-### Note
+## Note
 
 If you have any issues with setting up the AdOcean bidder, please contact with your local Technical Support team or by visiting [AdOcean website](https://adocean-global.com/en/contact/).
 
-### Prebid.JS Bid Params
+## Prebid.JS Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name     | Scope    | Description       | Example                                            | Type     |
-|----------|----------|-------------------|----------------------------------------------------|----------|
-| slaveId  | required | slave ID          | `'adoceanmyaotcpiltmmnj'`                          | `string` |
-| masterId | required | master ID         | `'ek1AWtSWh3BOa_x2P1vlMQ_uXXJpJcbhsHAY5PFQjWD.D7'` | `string` |
-| emitter  | required | traffic source id | `'myao.adocean.pl'`                                | `string` |
+| Name                  | Scope    | Description                | Example                                            | Type     |
+|-----------------------|----------|----------------------------|----------------------------------------------------|----------|
+| slaveId               | required | slave ID                   | `'adoceanmyaotcpiltmmnj'`                          | `string` |
+| masterId              | required | master ID                  | `'ek1AWtSWh3BOa_x2P1vlMQ_uXXJpJcbhsHAY5PFQjWD.D7'` | `string` |
+| emitter               | required | traffic source id          | `'myao.adocean.pl'`                                | `string` |
+| emitterRequestParams  | optional | extra targeting parameters | `{key: 'value'}`                                   | `object` |

From db037377101064ce01c214a67ef76f12e076fc7d Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Mon, 8 Jun 2026 11:02:50 +0300
Subject: [PATCH 620/665] Apester adapter pbs true (#6582)

* changing adapter doc

* using right gvlid

* master merge; markdown fix

* remove "filename"

* pbs: false (just for initial publish)

* fix to comment about gpp

* pbs: true

---------

Co-authored-by: Anna Yablonsky <annay+perion@perion.com>
---
 dev-docs/bidders/apester.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev-docs/bidders/apester.md b/dev-docs/bidders/apester.md
index 9afcb1b0f4..de13a65541 100644
--- a/dev-docs/bidders/apester.md
+++ b/dev-docs/bidders/apester.md
@@ -20,7 +20,7 @@ fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
 pbjs: true
-pbs: false
+pbs: true
 sidebarType: 1
 ---
 

From 2749a8355316bb9ebc7dabd8cbe7ea251c0c259c Mon Sep 17 00:00:00 2001
From: Anna Yablonsky <annay@perion.com>
Date: Mon, 8 Jun 2026 11:04:14 +0300
Subject: [PATCH 621/665] pbs_app_supported=true and gpp_sids map (#6589)

* pbs_app_supported=true and gpp_sids map

* reformat tables

* more table format

* headers fix

* style fix

---------

Co-authored-by: Anna Yablonsky <annay+perion@perion.com>
---
 dev-docs/bidders/adnimation.md     |  2 +-
 dev-docs/bidders/apester.md        |  2 +-
 dev-docs/bidders/illumin.md        |  8 ++++----
 dev-docs/bidders/kueezrtb.md       |  4 ++--
 dev-docs/bidders/omnidex.md        |  8 ++++----
 dev-docs/bidders/opamarketplace.md |  6 +++---
 dev-docs/bidders/programmaticX.md  | 10 +++++-----
 dev-docs/bidders/shinezRtb.md      |  8 ++++----
 dev-docs/bidders/tagoras.md        |  8 ++++----
 dev-docs/bidders/twistDigital.md   | 13 +++++++------
 dev-docs/bidders/vidazoo.md        |  7 ++++---
 11 files changed, 39 insertions(+), 37 deletions(-)

diff --git a/dev-docs/bidders/adnimation.md b/dev-docs/bidders/adnimation.md
index d7c27d7b90..61326b2f6a 100644
--- a/dev-docs/bidders/adnimation.md
+++ b/dev-docs/bidders/adnimation.md
@@ -14,7 +14,7 @@ media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
diff --git a/dev-docs/bidders/apester.md b/dev-docs/bidders/apester.md
index de13a65541..0953eb25c0 100644
--- a/dev-docs/bidders/apester.md
+++ b/dev-docs/bidders/apester.md
@@ -15,7 +15,7 @@ media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
diff --git a/dev-docs/bidders/illumin.md b/dev-docs/bidders/illumin.md
index fc00073828..a347542248 100644
--- a/dev-docs/bidders/illumin.md
+++ b/dev-docs/bidders/illumin.md
@@ -9,7 +9,7 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
@@ -24,12 +24,12 @@ pbjs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name       | Scope    | Description                                                                               | Example                      | Type     |
-|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
 | `cId`      | required | The connection ID from Illumin.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`      | required | The publisher ID from Illumin.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. Illumin will not respond with bids lower than this value. | `0.90`                       | `float`  |
diff --git a/dev-docs/bidders/kueezrtb.md b/dev-docs/bidders/kueezrtb.md
index e05fb0f016..b4cd5e826f 100644
--- a/dev-docs/bidders/kueezrtb.md
+++ b/dev-docs/bidders/kueezrtb.md
@@ -9,7 +9,7 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
@@ -25,7 +25,7 @@ pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
diff --git a/dev-docs/bidders/omnidex.md b/dev-docs/bidders/omnidex.md
index 09881834a1..275e6740d8 100644
--- a/dev-docs/bidders/omnidex.md
+++ b/dev-docs/bidders/omnidex.md
@@ -10,13 +10,13 @@ usp_supported: true
 gvl_id: 1463
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
@@ -25,7 +25,7 @@ pbs: true
 sidebarType: 1
 ---
 
-### Bid Params for Prebid.js
+## Bid Params for Prebid.js
 
 {: .table .table-bordered .table-striped }
 
@@ -35,7 +35,7 @@ sidebarType: 1
 | `pId`      | required | The publisher ID from Omnidex (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. omnidex will not respond with bids lower than this value. | `0.90`                       | `float`  |
 
-#### Bid Params for Prebid Server
+## Bid Params for Prebid Server
 
 {: .table .table-bordered .table-striped }
 
diff --git a/dev-docs/bidders/opamarketplace.md b/dev-docs/bidders/opamarketplace.md
index afecafc5de..7171bffff2 100644
--- a/dev-docs/bidders/opamarketplace.md
+++ b/dev-docs/bidders/opamarketplace.md
@@ -9,13 +9,13 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
@@ -24,7 +24,7 @@ pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
diff --git a/dev-docs/bidders/programmaticX.md b/dev-docs/bidders/programmaticX.md
index 43147c95e4..a9ffc64e05 100644
--- a/dev-docs/bidders/programmaticX.md
+++ b/dev-docs/bidders/programmaticX.md
@@ -9,13 +9,13 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
 safeframes_ok: false
 deals_supported: false
-pbs_app_supported: false
+pbs_app_supported: true
 fpd_supported: false
 ortb_blocking_supported: false
 multiformat_supported: will-bid-on-one
@@ -25,12 +25,12 @@ sidebarType: 1
 gvl_id: 1344
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name       | Scope    | Description                                                                               | Example                      | Type     |
-|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
+| Name       | Scope    | Description                                                                                    | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------------|------------------------------|----------|
 | `cId`      | required | The connection ID from ProgrammaticX.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`      | required | The publisher ID from ProgrammaticX.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. ProgrammaticX will not respond with bids lower than this value. | `0.90`                       | `float`  |
diff --git a/dev-docs/bidders/shinezRtb.md b/dev-docs/bidders/shinezRtb.md
index 08119040a7..12ce5bf012 100644
--- a/dev-docs/bidders/shinezRtb.md
+++ b/dev-docs/bidders/shinezRtb.md
@@ -9,7 +9,7 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
@@ -23,12 +23,12 @@ pbjs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name       | Scope    | Description                                                                               | Example                      | Type     |
-|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
+| Name       | Scope    | Description                                                                                | Example                      | Type     |
+|------------|----------|--------------------------------------------------------------------------------------------|------------------------------|----------|
 | `cId`      | required | The connection ID from shinezRtb.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`      | required | The publisher ID from shinezRtb.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. shinezRtb will not respond with bids lower than this value. | `0.90`                       | `float`  |
diff --git a/dev-docs/bidders/tagoras.md b/dev-docs/bidders/tagoras.md
index 94b7cb9c03..0395ca5e87 100644
--- a/dev-docs/bidders/tagoras.md
+++ b/dev-docs/bidders/tagoras.md
@@ -9,7 +9,7 @@ tcfeu_supported: true
 usp_supported: true
 coppa_supported: false
 schain_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 floors_supported: true
 media_types: banner, video
 prebid_member: false
@@ -24,12 +24,12 @@ pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name       | Scope    | Description                                                                               | Example                      | Type     |
-|------------|----------|-------------------------------------------------------------------------------------------|------------------------------|----------|
+| Name       | Scope    | Description                                                                              | Example                      | Type     |
+|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
 | `cId`      | required | The connection ID from Tagoras.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`      | required | The publisher ID from Tagoras.                                                           | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. Tagoras will not respond with bids lower than this value. | `0.90`                       | `float`  |
diff --git a/dev-docs/bidders/twistDigital.md b/dev-docs/bidders/twistDigital.md
index 672233164c..5de920388d 100644
--- a/dev-docs/bidders/twistDigital.md
+++ b/dev-docs/bidders/twistDigital.md
@@ -7,7 +7,7 @@ userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrable
 media_types: banner, video
 gvl_id: 1292
 tcfeu_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 usp_supported: true
 coppa_supported: false
 multiformat_supported: will-bid-on-one
@@ -19,10 +19,11 @@ pbjs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name       | Scope    | Description                                                                              | Example                      | Type     |
-|------------|----------|------------------------------------------------------------------------------------------|------------------------------|----------|
-| `cId`      | required | The connection ID from Twist Digital.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
-| `bidFloor` | optional | The minimum bid value desired. Twist Digital will not respond with bids lower than this value. | `0.90`                       | `float`  |
+
+| Name       | Scope    | Description                                                                                | Example                      | Type     |
+|------------|----------|--------------------------------------------------------------------------------------------|------------------------------|----------|
+| `cId`      | required | The connection ID from shinezRtb.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
+| `bidFloor` | optional | The minimum bid value desired. shinezRtb will not respond with bids lower than this value. | `0.90`                       | `float`  |
diff --git a/dev-docs/bidders/vidazoo.md b/dev-docs/bidders/vidazoo.md
index 84cca015f8..9454390de3 100644
--- a/dev-docs/bidders/vidazoo.md
+++ b/dev-docs/bidders/vidazoo.md
@@ -7,14 +7,15 @@ userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrable
 media_types: banner, video
 gvl_id: 744
 tcfeu_supported: true
-gpp_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 usp_supported: true
+pbs_app_supported: true
 pbjs: true
 pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name       | Scope    | Description                                                                              | Example                      | Type     |
@@ -22,4 +23,4 @@ sidebarType: 1
 | `cId`      | required | The connection ID from Vidazoo.                                                          | `'562524b21b1c1f08117fc7f9'` | `string` |
 | `pId`      | required | The publisher ID from Vidazoo (pbjs only).                                               | `'59ac17c192832d0011283fe3'` | `string` |
 | `bidFloor` | optional | The minimum bid value desired. Vidazoo will not respond with bids lower than this value. | `0.90`                       | `float`  |
-| `subDomain`| optional | Sets the server subdomain, default: 'prebid'.                                            | `'prebid'`                     | `string` |
+| `subDomain`| optional | Sets the server subdomain, default: 'prebid'.                                            | `'prebid'`                   | `string` |

From 86cc51d4afdaf5cd335aff85d10b19bb210b8b42 Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Tue, 9 Jun 2026 20:08:59 +0200
Subject: [PATCH 622/665] Limelight New Adapter: pgamrtb  (#6469)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* new adapter pgamrtb

* Update headings in pgamrtb.md for consistency

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
---
 dev-docs/bidders/pgamrtb.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 dev-docs/bidders/pgamrtb.md

diff --git a/dev-docs/bidders/pgamrtb.md b/dev-docs/bidders/pgamrtb.md
new file mode 100644
index 0000000000..4da6606cd3
--- /dev/null
+++ b/dev-docs/bidders/pgamrtb.md
@@ -0,0 +1,34 @@
+---
+layout: bidder
+title: PGAM Rtb
+description: Prebid PGAM Rtb Bidder Adaptor
+biddercode: pgamrtb
+pbjs: true
+pbs: true
+media_types: banner, video, audio, native
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+## Note
+
+PGAM Rtb Bidding adapter requires setup before beginning.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description           | Example           | Type      |
+|:--------------|:---------|:----------------------|:------------------|:----------|
+| `host`        | required | Ad network's RTB host | `'pgamrtb.com'`   | `string`  |
+| `publisherId` | required | Publisher ID          | `12345`           | `integer` |

From d637ee9844177118e14c3a6b5074dbf528a20d68 Mon Sep 17 00:00:00 2001
From: selectmediaPrebid <prebid@selectmedia.asia>
Date: Wed, 10 Jun 2026 11:58:38 +0300
Subject: [PATCH 623/665] Update adapter: Selectmedia - update PBJS, add Prebid
 server adapter (#6560)

* update adapter: selectmedia

* make region param required for prebid.js

* update tables

* update bid params
---
 dev-docs/bidders/selectmedia.md | 86 ++++++++++-----------------------
 1 file changed, 25 insertions(+), 61 deletions(-)

diff --git a/dev-docs/bidders/selectmedia.md b/dev-docs/bidders/selectmedia.md
index de8fd31d0a..25f16ca489 100644
--- a/dev-docs/bidders/selectmedia.md
+++ b/dev-docs/bidders/selectmedia.md
@@ -1,73 +1,37 @@
 ---
 layout: bidder
-title: Select Media Display
-description: Prebid Select Media Bidder Adapter
-pbjs: true
-media_types: banner,video
-tcfeu_supported: true
-gpp_supported: true
+title: Selectmedia
+description: Prebid Selectmedia Bidder Adapter
 biddercode: selectmedia
-aliasCode: adtelligent
+gpp_sids: usstate_all
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+ortb_blocking_supported: false
+media_types: banner, video, native
+multiformat_supported: will-bid-on-one
+userIds: all
+pbjs: true
+pbs: true
+pbs_app_supported: false
+safeframes_ok: true
 sidebarType: 1
 gvl_id: 775
 ---
 
-### Bid params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name  | Scope    | Description                     | Example  | Type      |
-|-------|----------|---------------------------------|----------|-----------|
-| `aid` | required | The traffic source ID | `232131` | `integer` |
-
-### Test Parameters
-
-``` javascript
-    var adUnits = [
 
-      // Video instream adUnit
-      {
-        code: 'div-test-div',
-        sizes: [[640, 480]],
-        mediaTypes: {
-          video: {
-            context: 'instream'
-          }
-        },
-        bids: [{
-          bidder: 'selectmedia',
-          params: {
-            aid: 331133
-          }
-        }]
-      },
+| Name          | Scope    | Description                | Example               | Type       |
+|---------------|----------|----------------------------|-----------------------|------------|
+| `placementId` | optional | Placement Id               | `'0'`                 | `'string'` |
+| `endpointId`  | optional | Endpoint Id                | `'0'`                 | `'string'` |
 
-      // Video outstream adUnit
-      {
-        code: 'outstream-test-div',
-        sizes: [[640, 480]],
-        mediaTypes: {
-          video: {
-            context: 'outstream'
-          }
-        },
-        bids: [{
-          bidder: 'selectmedia',
-          params: {
-            aid: 331133
-          }
-        }]
-      },
+## Note
 
-      // Banner adUnit
-      {
-        code: 'div-test-div',
-        sizes: [[300, 250]],
-        bids: [{
-          bidder: 'selectmedia',
-          params: {
-            aid: 350975
-          }
-        }]
-      }
-    ];
-```
+For the prebid server and prebid.js you only need to use one parameter: either placementId or endpointId.

From f178bea94e1c5ee4d521bc49dd5061436b03cce1 Mon Sep 17 00:00:00 2001
From: Eugene Dorfman <eugene.dorfman@gmail.com>
Date: Wed, 10 Jun 2026 19:33:55 +0200
Subject: [PATCH 624/665] 51degreesRTDProvider new features: IPI geo, 51DiD
 eids, and tdlUrl (#6587)

* 51d new features: ip, geo, 51did eid, tdlUrl

Documents the new capabilities of the 51Degrees RTD provider: IP-derived geo enrichment, the privacy-safe 51DiD identifier emitted into `user.eids`, and the consent forwarding that powers it.

## Changes
- Document IPI geo enrichment: `device.ip`/`device.ipv6` and `device.geo.*` populated on high/medium confidence.
- Document the 51DiD `user.eids` entry (`source = 51d.es`) and its PMP / TCF / GPP consent-derived usage preference.
- Add the `params.tdlUrl` config option feeding the `ext.tdl` array of the eids entry.

* update configurator link

* fix lint errors

* correct capitalization of 51Did
---
 dev-docs/modules/51DegreesRtdProvider.md | 37 +++++++++++++++---------
 1 file changed, 23 insertions(+), 14 deletions(-)

diff --git a/dev-docs/modules/51DegreesRtdProvider.md b/dev-docs/modules/51DegreesRtdProvider.md
index 76b594ec84..eb5ef9fc90 100644
--- a/dev-docs/modules/51DegreesRtdProvider.md
+++ b/dev-docs/modules/51DegreesRtdProvider.md
@@ -25,17 +25,25 @@ The Cloud API is **free** to integrate and use. To increase limits please check
 
 ## Description
 
-51Degrees module enriches an OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/index.html).
+51Degrees module enriches an OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/index.html) and (optionally) IP-derived geo plus a 51Did (51Degrees identifier) entry in `user.eids`.
 
 51Degrees module sets the following fields of the device object: `devicetype`, `make`, `model`, `hwv`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio`. Interested bidder adapters may use these fields as needed. 
 
-The module also adds a `device.ext.fod` extension object (fod == fifty one degrees) and sets `device.ext.fod.deviceId` to a permanent device ID, which can be rapidly looked up in on-premise data, exposing over 250 properties, including device age, chipset, codec support, price, operating system and app/browser versions, age, and embedded features. 
+The module also adds a `device.ext.fod` extension object (fod == fifty one degrees) and sets `device.ext.fod.deviceId` to a permanent device ID, which can be rapidly looked up in on-premise data, exposing over 250 properties, including device age, chipset, codec support, price, operating system and app/browser versions, age, and embedded features.
 
-It also sets `device.ext.fod.tpc` key to a binary value to indicate whether third-party cookies are enabled in the browser (1 if enabled, 0 if disabled).
+It also sets `device.ext.fod.tpc` to a binary value to indicate whether third-party cookies are enabled in the browser (1 if enabled, 0 if disabled).
+
+When 51Degrees IPI is available in the cloud response, the module sets `device.ip` and `device.ipv6`, and (if the location confidence is `high` or `medium`) populates `device.geo.{lat,lon,country,zip,utcoffset,accuracy,type,ipservice}` per OpenRTB 2.6 and AdCOM 1.0.
+
+[51Did](https://51degrees.com/documentation/4.5/_identifiers_51_did.html) is a 51Degrees privacy-safe identifier derived from device signals. Its production requires a marketing usage preference (`id.usage`). The recommended way to collect and store that preference is the [51Degrees Preference Management Platform (PMP)](https://51degrees.com/documentation/4.5/_identifiers__p_m_p.html) — a lightweight consent widget that writes the user's choice to `localStorage`. When PMP is present on the page the module picks up that preference automatically. When PMP is absent the module falls back to inferring the preference from the publisher's existing TCF or GPP consent string (see below).
+
+When 51Did is available, the module appends an entry to `user.eids` with `source = "51d.es"`, `inserter = "51degrees.com"`, `mm = 5` (inference), and `uids` carrying `idproblic` and `idprobglobal`. The `ext.tdl` URL inside the entry comes from the `params.tdlUrl` module config.
+
+The module forwards the publisher's consent strings to the cloud as evidence when present. The TCF consent string (from Prebid's GDPR consent) is sent as `tcstring` and the GPP string (from Prebid's GPP consent) is sent as `gppstring`; the cloud can infer the marketing usage preference from either when PMP is not present, so 51Did works for publishers running any TCF or GPP CMP. These come from Prebid's consent data, not module params.
 
 The module supports on premise and cloud device detection services with free options for both. 
 
-A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
+A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/Q5cD1H9W?utm_source=Prebid&utm_medium=Documentation).  This is the simplest approach to trial the module.
 
 An interface compatible self hosted service can be used with .NET, Java, Node, PHP, and Python.  See [51Degrees examples](https://51degrees.com/documentation/_examples__device_detection__getting_started__web__on_premise.html).
 
@@ -57,7 +65,7 @@ gulp build --modules="rtdModule,51DegreesRtdProvider,appnexusBidAdapter,..."
 
 #### Resource Key
 
-In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
+In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/Q5cD1H9W?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
 
 * DeviceId
 * DeviceType
@@ -109,7 +117,7 @@ In summary we recommend using `Delegate-CH` http-equiv as the preferred method o
 
 ##### Illustrative Cases
 
-* if the device is iPhone/iPad then there is no point checking for or calling GetHighEntropyValues at the moment because iOS does not support this API. However this might change in the future.  Platforms like iOS require additional techniques to identify the model which are not covered via a single API call, and change from version to version of the operating system and browser rendering engine. **When used with iOS 51Degrees resolves the [iPhone/iPad model groups](https://51degrees.com/documentation/4.4/_device_detection__features__apple_device_table.html) using these techniques.** That is one of the benefits the module brings to the Prebid community as most solutions do not resolve iPhone/iPad model groups. More on Apple Device Detection [here](https://51degrees.com/documentation/4.4/_device_detection__features__apple_detection.html).
+* if the device is iPhone/iPad then there is no point checking for or calling GetHighEntropyValues at the moment because iOS does not support this API. However this might change in the future.  Platforms like iOS require additional techniques to identify the model which are not covered via a single API call, and change from version to version of the operating system and browser rendering engine. **When used with iOS 51Degrees resolves the [iPhone/iPad model groups](https://51degrees.com/documentation/4.4/_device_detection__features__apple_device_table.html) using these techniques.** That is one of the benefits the module brings to the Prebid community as most solutions do not resolve iPhone/iPad model groups. Read more on [Apple Device Detection](https://51degrees.com/documentation/4.4/_device_detection__features__apple_detection.html).
 
 * if the browser is Firefox on Android or desktop then there is similarly no point requesting GHEV as the API is not supported.
 
@@ -130,7 +138,7 @@ pbjs.setConfig({
                 waitForIt: true, // should be true, otherwise the auctionDelay will be ignored
                 params: {
                     resourceKey: '<YOUR_RESOURCE_KEY>',
-                    // Get your resource key from https://configure.51degrees.com/jJqVnTJR?utm_source=Prebid&utm_medium=Documentation
+                    // Get your resource key from https://configure.51degrees.com/Q5cD1H9W?utm_source=Prebid&utm_medium=Documentation
                     // alternatively, you can use the on-premise version of the 51Degrees service and connect to your chosen end point
                     // onPremiseJSUrl: 'https://localhost/51Degrees.core.js'
                 },
@@ -145,13 +153,14 @@ pbjs.setConfig({
 > Note that `resourceKey` and `onPremiseJSUrl` are mutually exclusive parameters.  Use strictly one of them: either a `resourceKey` for cloud integration and `onPremiseJSUrl` for the on-premise self-hosted integration. 
 
 {: .table .table-bordered .table-striped }
-| Name                  | Type    | Description                                                                                      | Default            |
-|:----------------------|:--------|:-------------------------------------------------------------------------------------------------|:-------------------|
-| name                  | String  | Real time data module name                                                                       | Always '51Degrees' |
-| waitForIt             | Boolean | Should be `true` if there's an `auctionDelay` defined (mandatory)                                | `false`            |
-| params                | Object  |                                                                                                  |                    |
-| params.resourceKey    | String  | Your 51Degrees Cloud Resource Key                                                                |                    |
-| params.onPremiseJSUrl | String  | Direct URL to your self-hosted on-premise JS file (e.g. `https://your.domain/51Degrees.core.js`) |                    |
+| Name | Type | Description | Default |
+| :--- | :--- | :--- | :--- |
+| name | String | Real time data module name | Always '51Degrees' |
+| waitForIt | Boolean | Should be `true` if there's an `auctionDelay` defined (mandatory) | `false` |
+| params | Object | | |
+| params.resourceKey | String | Your 51Degrees Cloud Resource Key | |
+| params.onPremiseJSUrl | String | Direct URL to your self-hosted on-premise JS file (e.g. `https://your.domain/51Degrees.core.js`) | |
+| params.tdlUrl | String | URL of your Terms Document Locator (TDL) — a machine-readable document declaring the data usage terms under which the identifier is shared, per the [data-labels proposal](https://github.com/jwrosewell/data-labels/tree/main) and its [OpenRTB extension](https://github.com/jwrosewell/data-labels/blob/main/OpenRTB.md). The URL is placed in the `ext.tdl` array of the `51d.es` eids entry. Omit if you do not publish a TDL; the module will log a warning and emit the eids entry without `ext.tdl`. | |
 
 ## Example 
 

From 94f3f7341c826d28d2a5f7d8da7fb6c84d2d4e6a Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Thu, 11 Jun 2026 03:17:37 -0400
Subject: [PATCH 625/665] Document tcfControl `defaultLegalBasis` and
 `gvlLegalBasisMapping` (#6601)

* Document tcfControl default legal basis

* Keep description of legacy behavior, extend new behavior description

* lint

---------

Co-authored-by: Demetrio Girardi <dgirardi@prebid.org>
---
 dev-docs/modules/tcfControl.md                | 106 ++++++++++++++++--
 dev-docs/publisher-api-reference/setConfig.md |  18 +++
 2 files changed, 116 insertions(+), 8 deletions(-)

diff --git a/dev-docs/modules/tcfControl.md b/dev-docs/modules/tcfControl.md
index bc014c5625..e3b9fb4102 100644
--- a/dev-docs/modules/tcfControl.md
+++ b/dev-docs/modules/tcfControl.md
@@ -78,6 +78,7 @@ The following fields related to anonymizing aspects of the auction are supported
 | gdpr.rules[].vendorExceptions | `Array of Strings` | Defines a list of biddercodes or module names that are exempt from determining legal basis for this Purpose. **Note:** Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor. | ["bidderA", "userID-module-B"] |
 | gdpr.rules[].softVendorExceptions | `Array of Strings` | Defines a list of biddercodes or module names that are exempt from the checking vendor signals for this purpose. Unlike with `vendorExceptions`, Purpose consent is still checked. **Note:** Prebid.org recommends working with a privacy lawyer before making enforcement exceptions for any vendor. | ["bidderA", "userID-module-B"] |
 | gdpr.rules[].eidsRequireP4Consent | `Boolean` | Only relevant on the personalizedAds `purpose`. If true, user IDs and EIDs will not be shared without evidence of consent for TCF Purpose 4. If false, evidence of consent for any of Purposes 2-10 is sufficient for sharing user IDs and EIDs. Defaults to false. See [note](#note-transmitEids) | true |
+| gdpr.defaultLegalBasis | `Object` | Defines the fallback legal-basis declarations that tcfControl should use when a module's GVL declaration is not checked or is not known. See [Default Legal Basis](#default-legal-basis) below. | `{purposes: [1, 2, 4, 7], flexiblePurposes: [2], legIntPurposes: [], specialFeatures: [1]}` |
 | strictStorageEnforcement | `Boolean` | If false (the default), allows some use of storage regardless of purpose 1 consent - see [note](#strictStorageEnforcement) below | true |
 | gdpr.rules[].deferS2Sbidders | `Boolean` | If true, allows s2s bidders to bypass vendor consent check and delegate it to server. Applies only to `basicAds` rule. Defaults to false | false |
 
@@ -96,6 +97,10 @@ pbjs.setConfig({
 });
 ```
 
+* If you set `gvlMapping` for a module whose legal-basis declarations are not
+  already known to Prebid.js (i.e. it maps to a GVL ID not used by any other module), also set [`gvlLegalBasisMapping`](/dev-docs/publisher-api-reference/setConfig.html#setConfig-gvlLegalBasisMapping) for that GVL ID or
+  review the `defaultLegalBasis` fallback described below.
+
 ### Examples
 
 The following examples cover a range of use cases and show how Prebid.js supports
@@ -187,36 +192,121 @@ configuration of different business rules.
       }]
     ```
 
-## Basic Legal Basis
+## Legal basis
+
+<a id="full-enforcement"><a>
+
+### Full enforcement (since Prebid.js 11.15)
+
+Since version 11.15, Prebid.js uses the legal basis declared by each vendor in the GVL at the time of release, which can be further configured with [`gvlLegalBasisMapping`](/dev-docs/publisher-api-reference/setConfig.html#setConfig-gvlLegalBasisMapping) and [`consentManagement.gdpr.defaultLegalBasis`](#default-legal-basis).
+This consists of the following fields from GVL vendor entries:
+
+* `purposes` lists purposes where the vendor declares consent as the legal basis.
+* `legIntPurposes` lists purposes where the vendor declares legitimate interest
+  (LI) as the legal basis.
+* `flexiblePurposes` lists purposes where the vendor can use either consent or
+  LI. Each flexible purpose must also be declared in either `purposes` or
+  `legIntPurposes`.
+* `specialFeatures` lists special features the module may utilize when performing some declared purposes processing.
+
+See also: [vendor list format](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20Consent%20string%20and%20vendor%20list%20formats%20v2.md).
+
+Before allowing an activity tied to a TCF-protected Purpose for a given vendor, one of these scenarios must be true:
 
-Prebid.js does not have access to the Global Vendor List (GVL), so it implements
+* Configuration rules check both purpose and vendor signals (`enforcePurpose: true, enforceVendor: true`) and:
+  * we have the user's consent for both purpose and vendor and the vendor declares either consent or LI as a legal basis for the purpose, or
+  * we confirmed that the user's LI transparency was established for both purpose and vendor and the vendor declares LI as a legal basis for the purpose, or
+  * we have the user's consent for the purpose, the vendor is excepted through `softVendorExceptions`, and `defaultLegalBasis` declares either consent or LI as a legal basis for the purpose, or
+  * we confirmed that the user's LI transparency was established for the purpose, the vendor is excepted through `softVendorExceptions`, and `defaultLegalBasis` declares LI as a legal basis for the purpose, or
+  * the vendor is excepted through `vendorExceptions`;
+* Configuration rules check only purpose signals (`enforcePurpose: true, enforceVendor: false`) and:
+  * we have the user's consent for the purpose and `defaultLegalBasis` declares either consent or LI as a legal basis for the purpose or
+  * we confirmed that the user's LI transparency was established for the purpose and `defaultLegalBasis` declares LI as a legal basis for the purpose, or
+  * the vendor is excepted through `vendorExceptions`;
+* Configuration rules check only vendor signals (`enforcePurpose: false, enforceVendor: true`) and:
+  * we have the user's consent for the vendor and the vendor declares either consent or LI as a legal basis for the purpose, or
+  * we confirmed that the user's LI transparency was established for the vendor and the vendor declares LI as a legal basis for the purpose, or
+  * the vendor is excepted through either `softVendorExceptions` or `vendorExceptions`;
+* Configuration rules check neither purpose consent nor vendor signal (`enforcePurpose: false, enforceVendor: false`).
+
+### Basic enforcement (Prebid.js versions prior to 11.15)
+
+Prior to version 11.15, Prebid.js did not have access to the Global Vendor List (GVL), so it implements
 a "basic" form of TCF 'legal basis' validation using the supplied consent string.
 
 A goal of 'basic legal basis' is to confirm that there's enough evidence of consent to pass data on to vendors who do have access to the GVL and can fully parse and take any necessary action.
 
 Evidence of consent for a particular purpose or vendor means that:
 
-* Prebid.js has the the user's vendor purpose or vendor consent, or
-* (for Purpose 2 only) we've confirmed the user's Legitimate Intereset (LI) Transparency is established for this purpose or vendor.
+* Prebid.js has the user's purpose or vendor consent, or
+* (for Purpose 2 only) we've confirmed the user's Legitimate Interest (LI) Transparency is established for this purpose or vendor.
 
 Before allowing an activity tied to a TCF-protected Purpose for a given vendor, one of these scenarios must be true:
 
-* Configuration rules check both consent and vendor signals and:
+* Configuration rules check both purpose and vendor signals (`enforcePurpose: true, enforceVendor: true`) and:
   * we have evidence of consent for both, or
   * we have evidence of consent for the purpose, and the vendor is excepted through `softVendorException`, or
   * the vendor is excepted through `vendorExceptions`;
-* Configuration rules check only purpose consent and either:
+* Configuration rules check only purpose signals (`enforcePurpose: true, enforceVendor: false`) and:
   * we have evidence of consent for the purpose, or
   * the vendor is excepted through `vendorExceptions`;
-* Configuration rules check only vendor signals and either:
+* Configuration rules check only vendor signals (`enforcePurpose: false, enforceVendor: true`) and:
   * we have evidence of consent for the vendor, or
   * the vendor is excepted through either `softVendorExceptions` or `vendorExceptions`;
-* Configuration rules check neither purpose consent nor vendor signal.
+* Configuration rules check neither purpose consent nor vendor signal (`enforcePurpose: false, enforceVendor: false`).
 
 See the [IAB TCF Consent String Format](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20Consent%20string%20and%20vendor%20list%20formats%20v2.md) for details.
 
 Before allowing an activity tied to a TCF-protected Purpose for a publisher module, such as Generic Analytics, SharedId, Pub-provided-id, configuration rules check for the relevant publisher purpose consent instead of vendor consent. IAB Europe officials have written to Prebid that "When one is seeking a signal indicating whether the Publisher has had their consent (or legitimate interest) legal basis established to the data subject by the CMP, one should examine the Publisher Purposes Transparency and Consent string segment signals, if present. The core string PurposesConsent bit sequence is intended solely to represent disclosures made by the CMP in the context of Vendors."
 
+### Default Legal Basis
+
+`consentManagement.gdpr.defaultLegalBasis` defines the fallback legal basis
+declaration that tcfControl uses when vendor declarations are not available or
+are intentionally not checked. It applies when:
+
+* `enforceVendor` is `false` for the applicable rule;
+* the vendor is listed in `softVendorExceptions` for the applicable rule; or
+* tcfControl cannot find the module's declarations, such as when a module's GVL
+  ID is supplied through `gvlMapping` without a matching `gvlLegalBasisMapping`
+  entry.
+
+The default value is:
+
+```javascript
+{
+  purposes: [1, 2, 4, 7],
+  flexiblePurposes: [2],
+  legIntPurposes: [],
+  specialFeatures: [1]
+}
+```
+
+This default preserves the legacy behavior of treating Purposes 1, 2, 4, and 7
+as consent-based, treating Purpose 2 as flexible, and requiring opt-in for
+Special Feature 1. To use LI as the fallback legal basis for Purpose 7, for
+example, move Purpose 7 from `purposes` to `legIntPurposes`:
+
+```javascript
+pbjs.setConfig({
+  consentManagement: {
+    gdpr: {
+      cmpApi: 'iab',
+      defaultLegalBasis: {
+        purposes: [1, 2, 4],
+        legIntPurposes: [7],
+        flexiblePurposes: [2],
+        specialFeatures: [1]
+      }
+    }
+  }
+});
+```
+
+If a purpose is listed in `flexiblePurposes`, it must also be listed in either
+`purposes` or `legIntPurposes`. Do not list the same purpose in both `purposes`
+and `legIntPurposes`.
+
 <a id="note-transmitEids"></a>
 
 ### Note on Extended User IDs
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 00aff32682..0e3d8a7de1 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -1627,6 +1627,24 @@ pbjs.setConfig({
 
 Prebid Server uses this mapping when it sends `ext.prebid.aliasgvlids` for bidder aliases, and the [TCF Control Module](/dev-docs/modules/tcfControl.html) references it when enforcing consent.
 
+<a id="setConfig-gvlLegalBasisMapping"></a>
+
+### Map Global Vendor ID to legal basis declarations
+
+Since version 11.15, Prebid.js includes TCF legal basis declarations, used for [tcfControl full enforcement](/dev-docs/modules/tcfControl.html#full-enforcement). The optional `gvlLegalBasisMapping` configuration option can be used to override them.
+
+```javascript
+pbjs.setConfig({
+  gvlLegalBasisMapping: {
+    123: {
+      purposes: [2],
+      legIntPurposes: [7],
+      flexiblePurposes: [2]
+    }
+  }
+})
+```
+
 ### Set Max Bid
 
 <a id="setConfig-maxBid"></a>

From 3713d784e87fb0b9c199c5dd078a9cc887099ecb Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Mon, 15 Jun 2026 17:37:07 +0200
Subject: [PATCH 626/665] Update 9dotsmedialtd.yaml (#6620)

---
 dev-docs/bidders/pgamrtb.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/dev-docs/bidders/pgamrtb.md b/dev-docs/bidders/pgamrtb.md
index 4da6606cd3..f5d1fc8871 100644
--- a/dev-docs/bidders/pgamrtb.md
+++ b/dev-docs/bidders/pgamrtb.md
@@ -32,3 +32,7 @@ PGAM Rtb Bidding adapter requires setup before beginning.
 |:--------------|:---------|:----------------------|:------------------|:----------|
 | `host`        | required | Ad network's RTB host | `'pgamrtb.com'`   | `string`  |
 | `publisherId` | required | Publisher ID          | `12345`           | `integer` |
+
+Prebid PGAM Rtb Bidder Adaptor server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Prebid PGAM Rtb Bidder Adaptor client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Prebid PGAM Rtb Bidder Adaptor server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Prebid PGAM Rtb Bidder Adaptor client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From d368e824a5fdafed4f03386bb864d7c561423d26 Mon Sep 17 00:00:00 2001
From: universe <88066680+chinaAdministrator@users.noreply.github.com>
Date: Mon, 15 Jun 2026 23:41:20 +0800
Subject: [PATCH 627/665] New Bid Adapter - billow_rtb25 (#6618)

Co-authored-by: zepeng.yin <zp.yin@foxmail.com>
---
 dev-docs/bidders/billow_rtb25.md | 135 +++++++++++++++++++++++++++++++
 1 file changed, 135 insertions(+)
 create mode 100644 dev-docs/bidders/billow_rtb25.md

diff --git a/dev-docs/bidders/billow_rtb25.md b/dev-docs/bidders/billow_rtb25.md
new file mode 100644
index 0000000000..1e161b5035
--- /dev/null
+++ b/dev-docs/bidders/billow_rtb25.md
@@ -0,0 +1,135 @@
+---
+layout: bidder
+title: Billowlink
+description: Prebid Billowlink OpenRTB 2.5 Bidder Adapter
+pbjs: true
+pbs: false
+pbs_app_supported: false
+biddercode: billow_rtb25
+media_types: banner, video, native
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: true
+dchain_supported: false
+floors_supported: false
+fpd_supported: true
+safeframes_ok: true
+deals_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: false
+privacy_sandbox: no
+gvl_id: none
+sidebarType: 1
+---
+
+## Note
+
+The Billowlink bidder adapter requires setup and approval before beginning. Please reach out to <support@billowlink.com> for more details.
+
+This adapter sends requests to Billowlink using OpenRTB 2.5. Billowlink bids are returned in USD.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                                                                         | Example                                                | Type                  |
+|---------------|----------|-----------------------------------------------------------------------------------------------------|--------------------------------------------------------|-----------------------|
+| `placementId` | required | Placement ID configured on the Billowlink side. This value is sent as OpenRTB `imp.tagid`.          | `'12345'`                                              | `string`              |
+| `endpoint`    | optional | Overrides the default Billowlink bid endpoint. This is normally only needed for testing or staging. | `'https://adx-sg.billowlink.com/api/rtb/adsWeb'`       | `string`              |
+
+## First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
+The adapter uses Prebid's OpenRTB converter, so standard request-level and impression-level ORTB data can be included in the outgoing request.
+
+## Ad Unit Setup for Banner
+
+```javascript
+var adUnits = [{
+  code: 'div-gpt-ad-123456-1',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250], [728, 90]]
+    }
+  },
+  bids: [{
+    bidder: 'billow_rtb25',
+    params: {
+      placementId: '12345'
+    }
+  }]
+}];
+```
+
+## Ad Unit Setup for Video
+
+```javascript
+var adUnits = [{
+  code: 'video-ad-unit',
+  mediaTypes: {
+    video: {
+      context: 'instream',
+      playerSize: [640, 480],
+      mimes: ['video/mp4'],
+      minduration: 1,
+      maxduration: 120,
+      protocols: [2, 3, 5, 6]
+    }
+  },
+  bids: [{
+    bidder: 'billow_rtb25',
+    params: {
+      placementId: 'video-placement-123'
+    }
+  }]
+}];
+```
+
+For outstream video, publishers must provide a renderer through the ad unit or use their standard video integration.
+
+## Ad Unit Setup for Native
+
+```javascript
+var adUnits = [{
+  code: 'native-ad-unit',
+  mediaTypes: {
+    native: {
+      ortb: {
+        ver: '1.2',
+        assets: [
+          { id: 1, required: 1, title: { len: 80 } },
+          { id: 2, required: 1, img: { type: 3, wmin: 100, hmin: 100 } }
+        ]
+      }
+    }
+  },
+  bids: [{
+    bidder: 'billow_rtb25',
+    params: {
+      placementId: 'native-placement-123'
+    }
+  }]
+}];
+```
+
+## Endpoint Override
+
+```javascript
+var adUnits = [{
+  code: 'div-gpt-ad-123456-2',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250]]
+    }
+  },
+  bids: [{
+    bidder: 'billow_rtb25',
+    params: {
+      placementId: '12345',
+      endpoint: 'https://adx-sg.billowlink.com/api/rtb/adsWeb'
+    }
+  }]
+}];
+```

From fdf117a422c187a624441354e71b19c9547a68c3 Mon Sep 17 00:00:00 2001
From: teqblaze <162988436+teqblaze@users.noreply.github.com>
Date: Mon, 15 Jun 2026 17:44:21 +0200
Subject: [PATCH 628/665] Native Agents adapter: Set pbs and pbs_app_supported
 to true (#6615)

* New adapter nativeagents

* fix: lint: change header level from h3 to h2 | MD001

* NativeAgents Bid Adapter: rename bider code to ntvagents

* Native Agents adapter: Set pbs and pbs_app_supported to true
---
 dev-docs/bidders/ntvagents.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/ntvagents.md b/dev-docs/bidders/ntvagents.md
index c51d30ae99..2f45839851 100644
--- a/dev-docs/bidders/ntvagents.md
+++ b/dev-docs/bidders/ntvagents.md
@@ -16,8 +16,8 @@ media_types: banner, video, native
 multiformat_supported: will-bid-on-one
 userIds: all
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 safeframes_ok: true
 sidebarType: 1
 ---

From 058940adbcdd7fa452f7c043cfa7e5fcf892585d Mon Sep 17 00:00:00 2001
From: product-trustedstack
 <141160331+product-trustedstack@users.noreply.github.com>
Date: Mon, 15 Jun 2026 21:16:49 +0530
Subject: [PATCH 629/665] Update trustedstack features (#6613)

* Update trustedstack bidder details

* lint changes

* resolved multiple consecutive blank lines
---
 dev-docs/bidders/trustedstack.md | 57 +++++++++++++++++---------------
 1 file changed, 31 insertions(+), 26 deletions(-)

diff --git a/dev-docs/bidders/trustedstack.md b/dev-docs/bidders/trustedstack.md
index db9e705a29..0fcde6a9bf 100644
--- a/dev-docs/bidders/trustedstack.md
+++ b/dev-docs/bidders/trustedstack.md
@@ -4,14 +4,19 @@ title: TrustedStack
 description: Prebid TrustedStack Bidder Adaptor
 biddercode: trustedstack
 aliasCode : medianet
-tcfeu_supported: false
+tcfeu_supported: true
+dsa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 usp_supported: true
 coppa_supported: true
-gpp_supported: true
+dchain_supported: false
+pbs_app_supported: true
+deals_supported: true
+endpoint_compression: false
 media_types: banner,native,video
 multiformat_supported: will-bid-on-any
 safeframes_ok: true
-userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
+userIds: all
 prebid_member: false
 pbjs: true
 gvl_id: 1288
@@ -22,38 +27,38 @@ pbs: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name       | Scope    | Description                            | Example       | Type     |
-|------------|----------|----------------------------------------|---------------|----------|
-| `cid`      | required | The customer id provided by TrustedStack. | `'trustedstack_test_customer'` | `string` |
-| `crid`     | required | The placement id provided by TrustedStack. | `'trustedstack_crid'`   | `string` |
-| `bidfloor` | optional | Bidfloor for the impression          | `1.0`         | `float`  |
-| `video`    | required for video Ad units | Object containing video targeting parameters.  See [Video Object](#video-object) for details.|`video: { maxduration: 60 }`         | `object`  |
+| Name       | Scope                       | Description                                                                                   | Example                        | Type     |
+| ---------- | --------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------ | -------- |
+| `cid`      | required                    | The customer id provided by TrustedStack.                                                     | `'trustedstack_test_customer'` | `string` |
+| `crid`     | required                    | The placement id provided by TrustedStack.                                                    | `'trustedstack_crid'`          | `string` |
+| `bidfloor` | optional                    | Bidfloor for the impression                                                                   | `1.0`                          | `float`  |
+| `video`    | required for video Ad units | Object containing video targeting parameters.  See [Video Object](#video-object) for details. | `video: { maxduration: 60 }`   | `object` |
 
-#### Video Object
+### Video Object
 
 {: .table .table-bordered .table-striped }
-| Name       | Type    | Description   | Example|
-|------------|----------|--------------|--------|
-|mimes|array of strings|(Recommended) Specifies the video content MIME types supported; for example, video/x-ms-wmv and video/x-flv.|["video/x-ms-wmv","video/x-flv"]|
-|minduration|integer|(Recommended) Specifies the minimum video ad duration, in seconds.|10|
-|maxduration|integer|(Recommended) Specifies the maximum video ad duration, in seconds.|60|
-|w|integer|(Recommended) Specifies the width of the video player, in pixels. Required if playerSize not present in `mediaTypes.video`|640|
-|h|integer|(Recommended) Specifies the height of the video player, in pixels. Required if playerSize not present in `mediaTypes.video`|480|
-|startdelay |integer | (Recommended) Specifies the start delay of the video ad|0|
-|battr| array of integers|Specifies the video creative attributes to block. Refer to section 5.3 of the IAB specification for a list of attributes.| [ 13, 14 ]|
-|playbackmethod| array of integers| Specifies the allowed playback methods. If not specified, all are assumed to be allowed. Currently supported values are: `1: Autoplay, sound on`; `2: Autoplay, sound off`; `3: Click to play`; `4: Mouse over to play`|[1, 3]|
-|api| array of integers| Specifies the supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. Currently supported values are: `1: VPAID 1.0`; `2: VPAID 2.0`; `3: MRAID-1`; `4: ORMMA`; `5: MRAID-2`|[1, 2]|
-|protocols |array of integers| Array of supported video protocols. Currently supported values are: `1: VAST 1.0`; `2: VAST 2.0`; `3: VAST 3.0`; `4: VAST 1.0 Wrapper`; `5: VAST 2.0 Wrapper`; `6: VAST 3.0 Wrapper`; `7: VAST 4.0`|[1, 2]|
-|placement |integer|Placement type for the impression. Possible options: `1: In-Stream`; `2: In-banner`; `3: Outstream/In-article`; `4: In-feed`; `5: Interstitial/Slider/Floating`; `6: Long-Form`;|1|
+| Name           | Type              | Description                                                                                                                                                                                                                               | Example                          |
+| -------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| mimes          | array of strings  | (Recommended) Specifies the video content MIME types supported; for example, video/x-ms-wmv and video/x-flv.                                                                                                                              | ["video/x-ms-wmv","video/x-flv"] |
+| minduration    | integer           | (Recommended) Specifies the minimum video ad duration, in seconds.                                                                                                                                                                        | 10                               |
+| maxduration    | integer           | (Recommended) Specifies the maximum video ad duration, in seconds.                                                                                                                                                                        | 60                               |
+| w              | integer           | (Recommended) Specifies the width of the video player, in pixels. Required if playerSize not present in `mediaTypes.video`                                                                                                                | 640                              |
+| h              | integer           | (Recommended) Specifies the height of the video player, in pixels. Required if playerSize not present in `mediaTypes.video`                                                                                                               | 480                              |
+| startdelay     | integer           | (Recommended) Specifies the start delay of the video ad                                                                                                                                                                                   | 0                                |
+| battr          | array of integers | Specifies the video creative attributes to block. Refer to section 5.3 of the IAB specification for a list of attributes.                                                                                                                 | [ 13, 14 ]                       |
+| playbackmethod | array of integers | Specifies the allowed playback methods. If not specified, all are assumed to be allowed. Currently supported values are: `1: Autoplay, sound on`; `2: Autoplay, sound off`; `3: Click to play`; `4: Mouse over to play`                   | [1, 3]                           |
+| api            | array of integers | Specifies the supported API frameworks for this impression. If an API is not explicitly listed, it is assumed not to be supported. Currently supported values are: `1: VPAID 1.0`; `2: VPAID 2.0`; `3: MRAID-1`; `4: ORMMA`; `5: MRAID-2` | [1, 2]                           |
+| protocols      | array of integers | Array of supported video protocols. Currently supported values are: `1: VAST 1.0`; `2: VAST 2.0`; `3: VAST 3.0`; `4: VAST 1.0 Wrapper`; `5: VAST 2.0 Wrapper`; `6: VAST 3.0 Wrapper`; `7: VAST 4.0`                                       | [1, 2]                           |
+| placement      | integer           | Placement type for the impression. Possible options: `1: In-Stream`; `2: In-banner`; `3: Outstream/In-article`; `4: In-feed`; `5: Interstitial/Slider/Floating`; `6: Long-Form`;                                                          | 1                                |
 
 Besides the above-mentioned parameters, we support all other OpenRTB 2.x video objects as optional parameters.
 
 In addition to `bids[].params.video`, TrustedStack adapter consumes parameters specified in the `mediaTypes.video`.
 
-#### Example of Instream Video Ad-unit
+### Example of Instream Video Ad-unit
 
 ```javascript
 var videoAdUnit = {
@@ -76,7 +81,7 @@ var videoAdUnit = {
 };
 ```
 
-#### Example of Banner Ad-unit
+### Example of Banner Ad-unit
 
 ```javascript
 var adUnits = [{

From 3daf51a3ed2ec0f792feb74b81e2d51bd66a0e35 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 15 Jun 2026 11:52:58 -0400
Subject: [PATCH 630/665] Recommend dynamic creatives for native templates
 (#6611)

---
 adops/gam-native.md             | 35 ++++++++++++---
 prebid/native-implementation.md | 77 ++++++++++++---------------------
 2 files changed, 56 insertions(+), 56 deletions(-)

diff --git a/adops/gam-native.md b/adops/gam-native.md
index e331b85f91..664053de3b 100644
--- a/adops/gam-native.md
+++ b/adops/gam-native.md
@@ -19,9 +19,9 @@ This page walks you through the steps required to set up native ads in GAM for t
 - Create a native ad template within the Google Ad Manager (GAM) native design tool.
 - Prebid Mobile In-App native
 
-You don't necessarily need to use GAM's native design tool - if you're using Prebid.js and have chosen to use
-in-adunit or external native templates, then you can just follow the
-instructions for [banner creatives with the PUC](/adops/gam-creative-banner-sbs.html).
+You don't necessarily need to use GAM's native design tool. If you're using Prebid.js and have chosen to use
+in-adunit or external native templates, the recommended ad ops workflow is to use a
+[Prebid.js dynamic creative](/adops/js-dynamic-creative.html) rather than Prebid Universal Creative (PUC).
 
 {: .alert.alert-success :}
 For complete instructions on setting up Prebid line items in Google Ad Manager, see [Google Ad Manager with Prebid Step by Step](/adops/step-by-step.html).
@@ -71,8 +71,8 @@ If this creative is served, it will fire impression trackers on load. Clicking t
 The creative template HTML will depend on which of the three scenarios you're implementing. You can choose to manage the native template in one of these ways:
 
 - in GAM ([Managing the Native Template in GAM](#managing-the-native-template-in-gam) below)
-- in the Prebid.js AdUnit - this is handled as a 3rd party HTML creative using the Prebid Universal Creative.
-- in a separate JavaScript file - this is handled as a 3rd party HTML creative using the Prebid Universal Creative.
+- in the Prebid.js AdUnit, handled as a third-party HTML creative using the [Prebid.js dynamic creative workflow](#managing-the-native-template-outside-of-gam)
+- in a separate JavaScript file, handled as a third-party HTML creative using the [Prebid.js dynamic creative workflow](#managing-the-native-template-outside-of-gam)
 
 {: .alert.alert-info :}
 For engineering instructions, see [Native Implementation Guide](/prebid/native-implementation.html).
@@ -82,6 +82,29 @@ For engineering instructions, see [Native Implementation Guide](/prebid/native-i
 3. Add any targeting you want to apply and click **Save and activate** (or **Save** if you're not yet ready to activate your template.)
 4. Provide a **Name** for your native style and click **Save**.
 
+#### Managing the Native Template Outside of GAM
+
+If your native template is defined in the Prebid.js AdUnit or in a separate JavaScript renderer,
+set up the ad server creative with the [Prebid.js dynamic creative](/adops/js-dynamic-creative.html).
+This is the recommended browser workflow for Prebid.js native ads because the creative asks
+Prebid.js to render the winning bid directly instead of loading PUC.
+
+Use this workflow when all of the following are true:
+
+- the line item targets browser inventory where Prebid.js is present on the page;
+- your Prebid.js bundle includes the [nativeRendering](/dev-docs/modules/nativeRendering.html) module;
+- you are using Prebid.js 8.36 or later.
+
+For GAM, create a third-party HTML creative and paste the dynamic creative from the
+[Prebid.js dynamic creatives](/adops/js-dynamic-creative.html) guide. Keep the GAM macros in the
+second `script` block. In Send All Bids setups, replace `%%PATTERN:hb_adid%%` with the bidder-specific
+`%%PATTERN:hb_adid_BIDDERCODE%%` value for each bidder creative, truncating the key name as required
+by GAM.
+
+{: .alert.alert-info :}
+Dynamic creatives are for Prebid.js browser line items. Continue to use the GAM native design-tool
+workflow below when GAM owns the native template, and use the mobile in-app workflow for Prebid Mobile.
+
 #### Managing the Native Template in GAM
 
 There are three key aspects of the native template:
@@ -235,6 +258,6 @@ Follow the instructions in [Google Ad Manager with Prebid Step by Step](/adops/s
 - [Google Ad Manager with Prebid Step by Step](/adops/step-by-step.html)
 - [Prebid Native Implementation Guide](/prebid/native-implementation.html)
 - [Send All Bids vs Top Price](/adops/send-all-vs-top-price.html)
-- [Prebid Universal Creative](/overview/prebid-universal-creative.html)
+- [Prebid.js dynamic creatives](/adops/js-dynamic-creative.html)
 - [Creative Considerations](/adops/creative-considerations.html)
 - [Ad Ops Planning Guide](/adops/adops-planning-guide.html)
diff --git a/prebid/native-implementation.md b/prebid/native-implementation.md
index 6e43a8891e..93b038c731 100644
--- a/prebid/native-implementation.md
+++ b/prebid/native-implementation.md
@@ -64,11 +64,11 @@ This table summarizes how the 3 approaches work:
 {: .table .table-bordered .table-striped }
 
 | Component | AdServer-Defined Creative Scenario | AdUnit-Defined Creative Scenario | Custom Renderer Scenario |
-| --- | --- |--- | --- |
+| --- | --- | --- | --- |
 | Prebid.js | mediaTypes. native.ortb | mediaTypes. native.ortb and mediaTypes.native.adTemplate contains ##macros## | mediaTypes. native.ortb and mediaTypes.native.rendererUrl |
 | Ad Server Key Value Pairs | hb_adid | hb_adid | hb_adid |
-| Ad Server | Native template loads native.js and calls renderNativeAd(). Uses Prebid ##macro## format. | Native creative loads native.js and calls renderNativeAd() with requestAllAssets: true | Native creative loads native.js and calls renderNativeAd(), with requestAllAssets:true |
-| Prebid Universal Creative | renderNativeAd resolves macros in the creative body and CSS. | renderNativeAd resolves ##macros## in adTemplate and CSS, appending the adTemplate to the creative body | renderNativeAd loads javascript from renderUrl, calls the renderAd function, appending the results to the creative body. |
+| Ad Server | Native template loads native.js and calls renderNativeAd(). Uses Prebid ##macro## format. | Dynamic creative calls Prebid.js with the winning hb_adid. | Dynamic creative calls Prebid.js with the winning hb_adid. |
+| Rendering code | renderNativeAd resolves macros in the creative body and CSS. | Prebid.js uses the nativeRendering module to resolve ##macros## in adTemplate and append the adTemplate to the creative body. | Prebid.js uses the nativeRendering module to load JavaScript from renderUrl, call the renderAd function, and append the results to the creative body. |
 | Javascript rendering function | n/a | n/a | Receives the ortb response into `bid.ortb`, and the renderer is responsible for resolving any macro format and returning an HTML block. |
 
 ## 3. Prebid.js Native AdUnit Overview
@@ -425,32 +425,20 @@ var adUnits = [{
 
 #### 4.2.2. Define the AdServer Creative
 
-Even though the body of the native creative is defined in the AdUnit, an AdServer creative is still needed. There are two key aspects of the native creative in this scenario:
+Even though the body of the native creative is defined in the AdUnit, an AdServer creative is still needed.
+For Prebid.js browser inventory, the recommended ad server creative is the
+[Prebid.js dynamic creative](/adops/js-dynamic-creative.html) rather than PUC.
+The dynamic creative calls back to Prebid.js with the winning `hb_adid`, and Prebid.js uses the
+[nativeRendering](/dev-docs/modules/nativeRendering.html) module to render the AdUnit-defined template.
 
-1. Load the Prebid.js native rendering code. You may utilize the jsdelivr version of native.js or host your own copy. If you use the version hosted on jsdelivr, make sure any necessary ad server permissions are established.
-2. Invoke the Prebid.js native rendering function with an object containing the following attributes:
-   1. adid - used to identify which Prebid.js creative holds the appropriate native assets
-   2. pubUrl - the URL of the page, which is needed for the HTML postmessage call
-   3. requestAllAssets - tells the renderer to get all the native assets from Prebid.js. The rendering function cannot currently scan a template defined in the AdUnit.
-
-Example Creative HTML
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist//%%PATTERN:hb_format%%.js"></script>
-<script>
-    var pbNativeTagData = {};
-    pbNativeTagData.pubUrl = "%%PATTERN:url%%";     // GAM specific
-    pbNativeTagData.adId = "%%PATTERN:hb_adid%%";   // GAM specific
-    // if you're using 'Send All Bids' mode, you should use %%PATTERN:hb_adid_BIDDER%%
-    pbNativeTagData.requestAllAssets = true;
-    // if you want to track clicks in GAM, add the following variable
-    pbNativeTagData.clickUrlUnesc = "%%CLICK_URL_UNESC%%";
-    window.pbNativeTag.renderNativeAd(pbNativeTagData);
-</script>
-```
+Dynamic creatives require Prebid.js 8.36 or later and require Prebid.js to be present on the page.
+Set up the creative following the [dynamic creative example](/adops/js-dynamic-creative.html#how-to-use).
+For GAM, keep the `%%PATTERN:hb_adid%%`, `%%PATTERN:url%%`, and `%%CLICK_URL_UNESC%%` macros in the
+second `script` block.
 
 {: .alert.alert-warning :}
-When using 'Send All Bids' mode you should update `pbNativeTagData.adId = "%%PATTERN:hb_adid_BIDDERCODE%%";` for each bidder’s creative.
+When using 'Send All Bids' mode, replace `%%PATTERN:hb_adid%%` with
+`%%PATTERN:hb_adid_BIDDERCODE%%` for each bidder's creative, truncating the key name as required by GAM.
 
 {: .alert.alert-info :}
 See [Managing the Native Template Outside of GAM](/adops/gam-native.html#managing-the-native-template-outside-of-gam) for ad server instructions.
@@ -515,32 +503,21 @@ var adUnits = [{
 
 #### 4.3.2. Define the AdServer Creative
 
-Even though the body of the native creative is defined in the external JavaScript, an AdServer creative is still needed. There are two key aspects of the native creative in this scenario:
-
-1. Load the Prebid.js native rendering code. You may utilize the jsdelivr version of native.js or host your own copy. If you use the version hosted on jsdelivr, make sure any necessary ad server permissions are established.
-2. Invoke the Prebid.js native rendering function with an object containing the following attributes:
-   1. adid - used to identify which Prebid.js creative holds the appropriate native assets
-   2. pubUrl - the URL of the page, which is needed for the HTML postmessage call
-   3. requestAllAssets - tells the renderer to get all the native assets from Prebid.js so they can be passed to the render function.
+Even though the body of the native creative is defined in the external JavaScript,
+an AdServer creative is still needed. For Prebid.js browser inventory, use the
+[Prebid.js dynamic creative](/adops/js-dynamic-creative.html) rather than PUC.
+The dynamic creative calls back to Prebid.js with the winning `hb_adid`, and Prebid.js uses the
+[nativeRendering](/dev-docs/modules/nativeRendering.html) module to load the `rendererUrl` and call
+`window.renderAd()`.
 
-Example creative HTML:
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/prebid-universal-creative@%%PATTERN:hb_ver%%/dist//%%PATTERN:hb_format%%.js"></script>
-<script>
-    var pbNativeTagData = {};
-    pbNativeTagData.pubUrl = "%%PATTERN:url%%";    // GAM specific
-    pbNativeTagData.adId = "%%PATTERN:hb_adid%%";  // GAM specific
-    // if you're using 'Send All Bids' mode, you should use %%PATTERN:hb_adid_BIDDER%%
-    pbNativeTagData.requestAllAssets = true;
-    // if you want to track clicks in GAM, add the following variable
-    pbNativeTagData.clickUrlUnesc = "%%CLICK_URL_UNESC%%";
-    window.pbNativeTag.renderNativeAd(pbNativeTagData);
-</script>
-```
+Dynamic creatives require Prebid.js 8.36 or later and require Prebid.js to be present on the page.
+Set up the creative following the [dynamic creative example](/adops/js-dynamic-creative.html#how-to-use).
+For GAM, keep the `%%PATTERN:hb_adid%%`, `%%PATTERN:url%%`, and `%%CLICK_URL_UNESC%%` macros in the
+second `script` block.
 
 {: .alert.alert-warning :}
-When using `Send All Bids` you should update `pbNativeTagData.adId = "%%PATTERN:hb_adid_biddercode%%";` for each bidder’s creative
+When using `Send All Bids`, replace `%%PATTERN:hb_adid%%` with
+`%%PATTERN:hb_adid_BIDDERCODE%%` for each bidder's creative, truncating the key name as required by GAM.
 
 {: .alert.alert-info :}
 See [Managing the Native Template Outside of GAM](/adops/gam-native.html#managing-the-native-template-outside-of-gam) for ad server instructions.
@@ -549,7 +526,7 @@ See [Managing the Native Template Outside of GAM](/adops/gam-native.html#managin
 
 Requirements for a native rendering function:
 
-- It must define a `window.renderAd()` function that will be called by the Prebid Universal Creative
+- It must define a `window.renderAd()` function that will be called by the Prebid.js native rendering module
 - The `renderAd()` function is passed an object containing an `ortb` property that contains the response in OpenRTB format, and must return a fully resolved and ready-to-display block of HTML that will be appended to the body.
 - The renderer can optionally expose a `window.postRenderAd()` function that can be useful to trigger javascript functions.
 

From 257b6ce02ad91b8a3422b9b0fa282f603a191137 Mon Sep 17 00:00:00 2001
From: Satyajit-magicbid <satyajit@magicbid.ai>
Date: Mon, 15 Jun 2026 21:23:46 +0530
Subject: [PATCH 631/665] Add MagicBid bid adapter documentation (#6610)

* Add files via upload

Add MagicBid bid adapter documentation

* Add files via upload

MagicBid: fix MD001 and MD060 markdownlint errors in dev-docs

* Add files via upload
---
 dev-docs/bidders/magicbid.md | 45 ++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 dev-docs/bidders/magicbid.md

diff --git a/dev-docs/bidders/magicbid.md b/dev-docs/bidders/magicbid.md
new file mode 100644
index 0000000000..db49010c12
--- /dev/null
+++ b/dev-docs/bidders/magicbid.md
@@ -0,0 +1,45 @@
+---
+layout: bidder
+title: MagicBid
+description: MagicBid Prebid Bidder Adapter
+biddercode: magicbid
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: true
+coppa_supported: true
+gpp_sids: usnat, usstate_all, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video
+safeframes_ok: true
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+## Note
+
+The MagicBid adapter requires setup before beginning. Please contact us at [support@magicbid.ai](mailto:support@magicbid.ai) to receive your `host` and `adUnitId` values.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                                                    | Example                          | Type      |
+| ------------- | -------- | ------------------------------------------------------------------------------ | -------------------------------- | --------- |
+| `host`        | required | Publisher-specific RTB host provided by MagicBid (ends with .rtb-magicbid.ai)  | `'ads-2j0kac.rtb-magicbid.ai'`   | `string`  |
+| `adUnitId`    | required | Ad Unit ID for this placement, provided by MagicBid                            | `631967104`                      | `integer` |
+| `adUnitType`  | optional | Ad format: `'banner'` or `'video'`. Inferred from mediaTypes if omitted.       | `'banner'`                       | `string`  |
+| `custom1`     | optional | Custom targeting parameter 1                                                   | `'sports'`                       | `string`  |
+| `custom2`     | optional | Custom targeting parameter 2                                                   | `'en'`                           | `string`  |
+| `custom3`     | optional | Custom targeting parameter 3                                                   | `'US'`                           | `string`  |
+| `custom4`     | optional | Custom targeting parameter 4                                                   | `'premium'`                      | `string`  |
+| `custom5`     | optional | Custom targeting parameter 5                                                   | `'homepage'`                     | `string`  |

From 5cca59a282a72a8bd0190393c787a348310c5e59 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 15 Jun 2026 18:56:26 +0300
Subject: [PATCH 632/665] Attekmi: add Stackup (#6608)

* Attekmi: add Stackup

* Attekmi: add Stackup

* Update dev-docs/bidders/stackup.md

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/stackup.md | 42 +++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 dev-docs/bidders/stackup.md

diff --git a/dev-docs/bidders/stackup.md b/dev-docs/bidders/stackup.md
new file mode 100644
index 0000000000..7bce0d082c
--- /dev/null
+++ b/dev-docs/bidders/stackup.md
@@ -0,0 +1,42 @@
+---
+layout: bidder
+title: Stackup
+description: Stackup Bidder Adapter
+biddercode: stackup
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: false
+multiformat_supported: will-bid-on-any
+---
+
+## Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                        | Example                              | Type            |
+| :------------ | :------- | :----------------------------------------------------------------- | :----------------------------------- | :-------------- |
+| `seat`        | required | Seat value                                                         | `'9Q20EdGxzgWdfPYShScl'`             | `string`        |
+| `token`       | required | Token                                                              | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`        |
+| `region`      | optional | Region                                                             | `apac`                               | `string`        |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`     | `Array(String)` |
+| `minBidfloor` | optional | Minimal CPM value                                                  | `0.03`                               | `float`         |
+| `pos`         | optional | The position of the placement on the page, see OpenRTB spec v2.5.  | `4`                                  | `number`        |
+
+## Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description         | Example                              | Type     |
+| :------------ | :------- | :------------------ | :----------------------------------- | :------- |
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From b0264a7cacb384b7f196aa8adf249a06f65350ac Mon Sep 17 00:00:00 2001
From: PiekharievaK <86105196+PiekharievaK@users.noreply.github.com>
Date: Mon, 15 Jun 2026 18:58:20 +0300
Subject: [PATCH 633/665] ViewdeosDX Bid Adapter: deprecate adapter (#6607)

Co-authored-by: k-piekharieva <k.piekharieva@adtelligent.com>
---
 dev-docs/bidders/viewdeosDX.md | 102 ---------------------------------
 1 file changed, 102 deletions(-)
 delete mode 100644 dev-docs/bidders/viewdeosDX.md

diff --git a/dev-docs/bidders/viewdeosDX.md b/dev-docs/bidders/viewdeosDX.md
deleted file mode 100644
index ccb428f03a..0000000000
--- a/dev-docs/bidders/viewdeosDX.md
+++ /dev/null
@@ -1,102 +0,0 @@
----
-layout: bidder
-title: ViewdeosDX Client
-description: Prebid.js ViewDeos Bidder Adapter
-pbjs: true
-pbs: false
-biddercode: viewdeosDX
-media_types: banner,video
-tcfeu_supported: true
-gvl_id: 924
-sidebarType: 1
----
-
-Note that for Prebid Server, use "viewdeos" bidder code.
-
-### Bid params
-
-{: .table .table-bordered .table-striped }
-| Name  | Scope    | Description                     | Example  | Type      |
-|-------|----------|---------------------------------|----------|-----------|
-| `aid` | required | The source ID from member zone | `350975` | `integer` |
-| `outstream` | optional | Oustream player settings object | `{"audio_setting":"on","video_controls":"show"}` | `object` |
-
-#### Oustream settings object
-
-{: .table .table-bordered .table-striped }
-| Name  | Scope    | Description                     | Example  | Type      |
-|-------|----------|---------------------------------|----------|-----------|
-| `type` | optional | allows to set the outstream type to one of inread/inbanner/interstitial/slider  | `'inbanner'` | `string` |
-| `audio_setting` | optional | allows to set audio settings, set to one of: on/muted/hover  | `'hover'` | `string` |
-| `video_controls` | optional |  enables or disables the visibility of controls, set to one of: show/hide/hover | `'show'` | `string` |
-| `close_button_options` | optional |  allows to choose when/if it is needed to show the "close" button, set to one of: delay/not_show/based_on | `'delay'` | `string` |
-| `view_out_action` | optional |  allows to apply the action type to an outstream unit when it is out of the visible zone, set to one of: jump/detach/continue_playing_muted/close/continue_playing/pause | `'pause'` | `string` |
-| `default_volume` | optional | allows to set the volume of outstream video ad 0-100 | `45` | `integer` |
-| `percent_visible_before_show` | optional | allows to setup visible percentage of an outstream unit to play 0-100 | `60` | `integer` |
-| `is_countdown_show` | optional | allows to enable/disable a countdown before the "close" button appears 0 - is enabled 1 - is disabled | `1` | `integer` |
-| `countdown_time` | optional | allows to set up how long the countdown will last and show it to the user. | `5` | `integer` |
-| `close_button_delay` | optional | allows to set a delay before showing close button | `5` | `integer` |
-| `disengagement_delay` | optional | allows to set a delay before actions selected in desangagement_method parameter | `5` | `integer` |
-| `disengagement_method` | optional | is applicable solely to Interstitial units allowing determine the actions that can be applied to the player, set to one of: close_button/detach_button/no/auto_detach | `'close_button'` | `string` |
-| `event_for_expand` | optional | allows to select when outstream unit should be expanded, set to one of: on_start_ad/on_load_ad | `'on_load_ad'` | `string` |
-| `detach_location_on page` | optional | allows to select the location where you want the detached player to be placed, set to one of: bottom_right/fullscreen/bottom_left/center_left/center_right/top_right/top_left | `'top_left'` | `string` |
-| `animation_mode` | optional | allows to control your outstream unit's animation mode on the webpage, set to one of: ease/ease_in/ease_out/step_start/linear | `'ease'` | `string` |
-| `detach_width` | optional | detached player's width in pixels | `300` | `integer` |
-| `detach_height` | optional | detached player's height in pixels | `200` | `integer` |
-
-### Test Parameters
-
-```
-    var adUnits = [
-
-      // Video instream adUnit
-      {
-        code: 'div-test-div',
-        mediaTypes: {
-          video: {
-            playerSize:[640, 480],
-            context: 'instream'
-          }
-        },
-        bids: [{
-          bidder: 'viewdeosDX',
-          params: {
-            aid: 331133
-          }
-        }]
-      },
-
-      // Video outstream adUnit
-      {
-        code: 'outstream-test-div',
-        mediaTypes: {
-          video: {
-            playerSize:[640, 480],
-            context: 'outstream'
-          }
-        },
-        bids: [{
-          bidder: 'viewdeosDX',
-          params: {
-            aid: 331133
-          }
-        }]
-      },
-
-      // Banner adUnit
-      {
-        code: 'div-test-div',
-        mediaTypes: {
-          banner: {
-            sizes:[[300, 250]]
-          }
-        },
-        bids: [{
-          bidder: 'viewdeosDX',
-          params: {
-            aid: 350975
-          }
-        }]
-      }
-    ];
-```

From 44191676c5fe52be338685391ac237d6774f906d Mon Sep 17 00:00:00 2001
From: robin-crazygames <robin@crazygames.com>
Date: Mon, 15 Jun 2026 17:58:44 +0200
Subject: [PATCH 634/665] Documented missing params for euid and uid2 id
 systems (#6605)

* Added missing euid params

* Documented missing params for unified id 2

* Move value to the bottom so that all param properties are grouped together

* Linting errors
---
 dev-docs/modules/userid-submodules/euid.md     |  8 +++++++-
 dev-docs/modules/userid-submodules/unified2.md | 11 +++++++++--
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/euid.md b/dev-docs/modules/userid-submodules/euid.md
index aeedada2c7..0ea2e77eea 100644
--- a/dev-docs/modules/userid-submodules/euid.md
+++ b/dev-docs/modules/userid-submodules/euid.md
@@ -185,8 +185,14 @@ The following parameters apply only to the European Unified ID module integratio
 | value | Optional, Server only | Object | An object containing the value for the advertising token. | See the example above. |
 | params.euidToken | Optional, Client refresh | Object | The initial EUID token. This should be `body` element of the decrypted response from a call to the `/token/generate` or `/token/refresh` endpoint. | See the sample token above. |
 | params.euidCookie | Optional, Client refresh | String | The name of a cookie which holds the initial EUID token, set by the server. The cookie should contain JSON in the same format as the euidToken param. **If euidToken is supplied, this param is ignored.** | See the sample token above. |
-| params.euidApiBase | Optional, Client refresh | String | Overrides the default EUID API endpoint. | `"https://prod.euid.eu"` _(default)_|
+| params.euidApiBase | Optional, Client refresh | String | Overrides the default EUID API endpoint. | `"https://prod.euid.eu"` _(default)_ |
 | params.storage | Optional, Client refresh | String | Specify whether to use `cookie` or `localStorage` for module-internal storage. It is recommended to not provide this and allow the module to use the default. | `localStorage` _(default)_ |
+| params.serverPublicKey | Optional | String | Server public key for client-side token generation | |
+| params.subscriptionId | Optional | String | Subscription id for client-side token generation, provided by the EUID team. | |
+| params.email | Optional | String | User email for client-side token generation. Only one of the DII parameters will be used. | |
+| params.phone | Optional | String | User phone number for client-side token generation. Only one of the DII parameters will be used. | |
+| params.emailHash | Optional | String | Hashed user email for client-side token generation. Only one of the DII parameters will be used. | |
+| params.phoneHash | Optional | String | Hashed phone number for client-side token generation. Only one of the DII parameters will be used. | |
 
 ## European Unified ID Examples
 
diff --git a/dev-docs/modules/userid-submodules/unified2.md b/dev-docs/modules/userid-submodules/unified2.md
index 0c2fc02cc3..a7b5eb7313 100644
--- a/dev-docs/modules/userid-submodules/unified2.md
+++ b/dev-docs/modules/userid-submodules/unified2.md
@@ -96,10 +96,17 @@ The following parameters apply only to the Unified ID 2.0 module integration.
 | --- | --- | --- | --- | --- |
 | name | Required | String | ID value for the Unified ID 2.0 module - `"uid2"` | `"uid2"` |
 | params.uid2Token | Optional | Object | The initial UID2 token. This should be the `body` element of the decrypted response from a call to the `/token/generate` or `/token/refresh` endpoint. | See the sample token above. |
-| params.uid2ServerCookie | Optional | String | The name of a cookie that holds the initial UID2 token, set by the server. The cookie should contain JSON in the same format as the alternative uid2Token param. **If uid2Token is supplied, this param is ignored.** | See the sample token above. |
+| params.uid2Cookie | Optional | String | The name of a cookie that holds the initial UID2 token, set by the server. The cookie should contain JSON in the same format as the alternative uid2Token param. **If uid2Token is supplied, this param is ignored.** | See the sample token above. |
+| params.uid2ServerCookie | Optional | String | Alias for `uid2Cookie`. | |
 | params.uid2ApiBase | Optional | String | Overrides the default UID2 API endpoint. | `https://prod.uidapi.com` _(default)_ |
-| value | Optional | Object | Used only if the page has a separate mechanism for storing the UID 2.0 ID. The value is an object containing the values to be sent to the adapters. In this scenario, no URL is called and nothing is added to local storage, and the tokens are **not** automatically refreshed. | `{"uid2": { "id": "eb33b0cb-8d35-4722-b9c0-1a31d4064888"}}` |
 | params.storage | Optional, Client refresh | String | Specify whether to use `cookie` or `localStorage` for module-internal storage. It is recommended to not provide this and allow the module to use the default. | `localStorage` _(default)_ |
+| params.serverPublicKey | Optional | String | Server public key for client-side token generation | |
+| params.subscriptionId | Optional | String | Subscription id for client-side token generation, provided by the EUID team. | |
+| params.email | Optional | String | User email for client-side token generation. Only one of the DII parameters will be used. | |
+| params.phone | Optional | String | User phone number for client-side token generation. Only one of the DII parameters will be used. | |
+| params.emailHash | Optional | String | Hashed user email for client-side token generation. Only one of the DII parameters will be used. | |
+| params.phoneHash | Optional | String | Hashed phone number for client-side token generation. Only one of the DII parameters will be used. | |
+| value | Optional | Object | Used only if the page has a separate mechanism for storing the UID 2.0 ID. The value is an object containing the values to be sent to the adapters. In this scenario, no URL is called and nothing is added to local storage, and the tokens are **not** automatically refreshed. | `{"uid2": { "id": "eb33b0cb-8d35-4722-b9c0-1a31d4064888"}}` |
 
 ## Unified ID 2.0 Examples
 

From 4de308a229a5e09aee36f61042aac398b1a89883 Mon Sep 17 00:00:00 2001
From: Patrick McCann <patmmccann@gmail.com>
Date: Mon, 15 Jun 2026 12:00:10 -0400
Subject: [PATCH 635/665] Clarify TCF CMP timeout behavior in
 consentManagementTcf docs (#6600)

### Motivation
- The existing doc text implied `gdpr.timeout` will wait for a missing IAB CMP API/stub/locator to appear, which contradicts Prebid.js behavior and related issues; the docs needed to explicitly describe the distinction between a missing CMP interface and a slow/awaiting CMP response.

### Description
- Updated the `gdpr.timeout` description to state it applies to an already-discovered CMP interface and does not poll for a missing IAB CMP API/stub/locator.
- Updated the `gdpr.actionTimeout` description to clarify the action timer begins after an already-discovered CMP returns an initial/provisional response indicating user action is needed.
- Rewrote Example 2 to explain the actual sequence (500ms applies only when the CMP interface is discoverable, otherwise lookup fails immediately).
- Replaced a non-descriptive link text and fixed the markdownlint `MD059` issue by using a descriptive link to the AppNexus CMP repository.

### Testing
- Ran `markdownlint --config .markdownlint.json dev-docs/modules/consentManagementTcf.md` and resolved the reported `MD059` error, after which linting passed.
- Ran `npm install -g markdownlint-cli` and `bundle install` to satisfy tooling, and then executed `bundle exec jekyll build`, which completed successfully.
---
 dev-docs/modules/consentManagementTcf.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/dev-docs/modules/consentManagementTcf.md b/dev-docs/modules/consentManagementTcf.md
index f766a94aa9..69caf4c083 100644
--- a/dev-docs/modules/consentManagementTcf.md
+++ b/dev-docs/modules/consentManagementTcf.md
@@ -68,8 +68,8 @@ but we recommend migrating to the new config structure as soon as possible.
 | gdpr | `Object` | | |
 | gdpr.enabled | `boolean` | Enables or disables the TCF consent management module. When set to `false`, Prebid does not initialize the CMP integration, does not delay auctions for consent, removes any active CMP event listeners. Defaults to `true` if not specified. | `false` |
 | gdpr.cmpApi | `string` | The CMP interface that is in use. Supported values are **'iab'** or **'static'**. Static allows integrations where IAB-formatted consent strings are provided in a non-standard way. Default is `'iab'`. | `'iab'` |
-| gdpr.timeout | `integer` | Length of time (in milliseconds) to allow the CMP to obtain the GDPR consent string. Default is `10000`. | `10000` |
-| gdpr.actionTimeout | `integer` | Length of time (in milliseconds) to allow the user to take action to consent if they have not already done so. The actionTimer first waits for the CMP to load, then the actionTimeout begins for the specified duration. Default is `undefined`. | `10000` |
+| gdpr.timeout | `integer` | Length of time (in milliseconds) to allow an already-discovered CMP interface to obtain the GDPR consent string. This timer does not wait for a missing IAB CMP API/stub/locator to appear; if no CMP interface is found when Prebid checks for one, the CMP lookup fails immediately. Default is `10000`. | `10000` |
+| gdpr.actionTimeout | `integer` | Length of time (in milliseconds) to allow the user to take action to consent if they have not already done so. The action timer begins after the already-discovered CMP returns an initial/provisional response indicating that user action is still needed. Default is `undefined`. | `10000` |
 | gdpr.defaultGdprScope | `boolean` | Defines what the `gdprApplies` flag should be when the CMP doesn't respond in time or the static data doesn't supply. Defaults to `false`. | `true` |
 | gdpr.consentData | `Object` | An object representing the GDPR consent data being passed directly; only used when cmpApi is 'static'. Default is `undefined`. | |
 | gpdr.dsaPlatform | `boolean` | If true, indicates that the publisher is to be considered an "Online Platform" for the purposes of the [Digital Services Act](https://digital-strategy.ec.europa.eu/en/policies/digital-services-act-package) | |  
@@ -93,7 +93,9 @@ A related parameter is `deviceAccess`, which is at the global level of Prebid.js
 
 ### TCF v2.x Examples
 
-Example 1: IAB CMP using custom timeout and setting GDPR in-scope by default.
+For the IAB CMP examples below, Prebid must be able to discover the CMP API/stub/locator when it checks for one. The `timeout` setting limits how long Prebid waits for that already-discovered CMP interface to return consent data; it is not a polling period for a missing CMP interface to appear.
+
+Example 1: IAB CMP using custom timeout for a discoverable CMP interface and setting GDPR in-scope by default.
 
 ```javascript
      var pbjs = pbjs || {};
@@ -111,7 +113,7 @@ Example 1: IAB CMP using custom timeout and setting GDPR in-scope by default.
      });
 ```
 
-Example 2: IAB CMP using custom timeout in combination with actionTimeout and setting GDPR in-scope by default. The following will wait `500ms` for the CMP to load, if it does an additional `10000ms` will be waited for a user to provide consent (if none had yet been provided).
+Example 2: IAB CMP using custom timeout in combination with actionTimeout and setting GDPR in-scope by default. For a discoverable CMP interface, the following waits up to `500ms` for an initial usable CMP response. If that response indicates that user consent is still pending, Prebid then waits up to an additional `10000ms` for the user to provide consent. If no CMP API/stub/locator is discoverable when Prebid checks for it, Prebid does not wait `500ms` for one to appear; the CMP lookup fails immediately.
 
 ```javascript
      var pbjs = pbjs || {};
@@ -308,7 +310,7 @@ At a high level, this could be done as follows:
 2. If SafeFrames are in use, build a message receiver function.
 3. Format consent data in a string according to the [IAB standard](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework).
 
-Below is sample code for implementing the stub functions. Sample code for formatting the consent string can be obtained [here](https://github.com/appnexus/cmp).
+Below is sample code for implementing the stub functions. Sample code for formatting the consent string can be obtained from the [AppNexus CMP repository](https://github.com/appnexus/cmp).
 
 ```javascript
 var iabConsentData;  // build the IAB consent string

From f9dd07a3e40783b1157997e2a48684af61cdaf42 Mon Sep 17 00:00:00 2001
From: trgsteve <steve@realry.com>
Date: Tue, 16 Jun 2026 01:04:13 +0900
Subject: [PATCH 636/665] New Bidder Docs: Realry (#6599)

* Add Realry bidder docs (companion to prebid-server#4813)

* Realry bidder docs: enable pbjs (companion to Prebid.js#14997)

* fix: bump bidder doc headings to h2 (MD001)

* Update dev-docs/bidders/realry.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/realry.md | 47 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 dev-docs/bidders/realry.md

diff --git a/dev-docs/bidders/realry.md b/dev-docs/bidders/realry.md
new file mode 100644
index 0000000000..432b48f2d0
--- /dev/null
+++ b/dev-docs/bidders/realry.md
@@ -0,0 +1,47 @@
+---
+layout: bidder
+title: Realry
+description: Prebid Realry Bidder Adapter
+biddercode: realry
+media_types: banner, native
+tcfeu_supported: false
+gdpr_supported: false
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+floors_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+safeframes_ok: true
+deals_supported: false
+fpd_supported: false
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                         | Example          | Type     |
+|---------------|----------|-----------------------------------------------------|------------------|----------|
+| `placementId` | required | Publisher-side identifier for the slot.             | `"slot-pdp-1"`   | `string` |
+| `sellerId`    | optional | Realry-assigned advertiser id (partnerships team).  | `"seller-acme"`  | `string` |
+
+## Description
+
+Realry is a commerce DSP focused on luxury fashion product listings. The adapter
+forwards the entire OpenRTB BidRequest to `https://bid.realry.com/bid/openrtb`
+and returns standard OpenRTB 2.6 BidResponses:
+
+- **Banner** imps receive an `adm` with HTML markup (anchor + image).
+- **Native** imps receive an `adm` containing a Native 1.2 admObject with assets
+  filled per the requested asset ids (title, main image, sponsored, price, CTA).
+
+The adapter infers bid type from the matching imp's media types — Realry's
+endpoint does not stamp `ext.prebid.type` on returned bids.
+
+## Maintainer
+
+`steve@realry.com`

From c76b327a0ace92e957f3f573ba09702d791f0a53 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Mon, 15 Jun 2026 19:07:36 +0300
Subject: [PATCH 637/665] Attekmi: formatting fix (#6594)

* Attekmi: remove Smarthub docs

* add redirect_from

* Attekmi: looping redirect fix

* MD formatting fix

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/attekmi.md | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/dev-docs/bidders/attekmi.md b/dev-docs/bidders/attekmi.md
index 798b475edf..b6bb311325 100644
--- a/dev-docs/bidders/attekmi.md
+++ b/dev-docs/bidders/attekmi.md
@@ -4,7 +4,6 @@ title: Attekmi
 description: Attekmi Bidder Adapter
 biddercode: smarthub
 redirect_from:
-  - /dev-docs/bidders/attekmi
   - /dev-docs/bidders/smarthub
 usp_supported: true
 media_types: banner, video, native
@@ -23,24 +22,26 @@ multiformat_supported: true
 sidebarType: 1
 ---
 
-### Prebid.js Bid Params
+## Prebid.js Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                     | Example                             | Type      |
-|---------------|----------|---------------------------------|-------------------------------------|-----------|
-| `partnerName` | required | Unique partner name             | `'partnertest'`                     | `string`  |
-| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
-| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
-| `region`      | optional | Region                          | `apac`                              | `string`  |
-| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`    | `Array(String)`   |
-| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
-| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.    | `4`                                 | `number`  |
 
-### Prebid Server Bid Params
+| Name          | Scope    | Description                                                        | Example                              | Type            |
+| :------------ | :------- | :----------------------------------------------------------------- | :----------------------------------- | :-------------- |
+| `partnerName` | required | Unique partner name                                                | `'partnertest'`                      | `string`        |
+| `seat`        | required | Seat value                                                         | `'9Q20EdGxzgWdfPYShScl'`             | `string`        |
+| `token`       | required | Token                                                              | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`        |
+| `region`      | optional | Region                                                             | `apac`                               | `string`        |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`     | `Array(String)` |
+| `minBidfloor` | optional | Minimal CPM value                                                  | `0.03`                               | `float`         |
+| `pos`         | optional | The position of the placement on the page, see OpenRTB spec v2.5.  | `4`                                  | `number`        |
+
+## Prebid Server Bid Params
 
 {: .table .table-bordered .table-striped }
+
 | Name          | Scope    | Description         | Example                              | Type     |
-|---------------|----------|---------------------|--------------------------------------|----------|
+| :------------ | :------- | :------------------ | :----------------------------------- | :------- |
 | `partnerName` | required | Unique partner name | `'partnertest'`                      | `string` |
 | `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
 | `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 465ba856328181aba68a3706cbb9aee847139947 Mon Sep 17 00:00:00 2001
From: Maxime Lequain <maxime.lequain@gmail.com>
Date: Mon, 15 Jun 2026 18:13:24 +0200
Subject: [PATCH 638/665] New adapter: hubvisor analytics (#6592)

* New adapter: hubvisor analytics

* Update dev-docs/analytics/hubvisor.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/analytics/hubvisor.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 dev-docs/analytics/hubvisor.md

diff --git a/dev-docs/analytics/hubvisor.md b/dev-docs/analytics/hubvisor.md
new file mode 100644
index 0000000000..33d1d6407b
--- /dev/null
+++ b/dev-docs/analytics/hubvisor.md
@@ -0,0 +1,21 @@
+---
+layout: analytics
+title: Hubvisor
+description: Hubvisor Analytics Adapter
+modulecode: hubvisor
+prebid_member: true
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+enable_download: true
+---
+
+## Example prebid.js setup
+
+```javascript
+pbjs.que.push(function () {
+    pbjs.enableAnalytics({
+        provider: 'hubvisor'
+    });
+});
+```

From 99c4f51e46ef19fca7dce54c3ae1a4a73d34961b Mon Sep 17 00:00:00 2001
From: Andrius Versockas <andrius.versockas@gmail.com>
Date: Mon, 15 Jun 2026 19:13:52 +0300
Subject: [PATCH 639/665] Eskimi: enable Prebid Server adapter (#6591)

Flips pbs: true and adds pbs_app_supported: true to match the
adapter shipping in prebid/prebid-server. Media types unchanged.

Co-authored-by: Andrius Versockas <andrius.v@eskimi.com>
---
 dev-docs/bidders/eskimi.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/dev-docs/bidders/eskimi.md b/dev-docs/bidders/eskimi.md
index c4e7ce5c61..0a686289ab 100644
--- a/dev-docs/bidders/eskimi.md
+++ b/dev-docs/bidders/eskimi.md
@@ -3,7 +3,8 @@ layout: bidder
 title: Eskimi
 description: Prebid Eskimi Bidder Adapter
 pbjs: true
-pbs: false
+pbs: true
+pbs_app_supported: true
 biddercode: eskimi
 media_types: banner, video
 schain_supported: true
@@ -21,7 +22,7 @@ gvl_id: 814
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
@@ -31,10 +32,10 @@ sidebarType: 1
 | `bcat`            | optional | ORTB blocked categories         | `['IAB-1-1']`          | `string[]`|
 | `badv`            | optional | ORTB blocked advertiser domains | `['example.com']`      | `string[]`|
 | `bapp`            | optional | ORTB blocked applications       | `['com.example.game']` | `string[]`|
-| `bidFloor`        | optional | Minimum CPM                   | `0.3`                | `number` |
-| `bidFloorCur`     | optional | Currency of bid floor         | `'USD'`              | `string` |
-| `coppa`           | optional | Set to `true` to enable COPPA  | `true`               | `boolean` |
-| `test`            | optional | Set to `1` to enable test mode | `1`                  | `integer` |
+| `bidFloor`        | optional | Minimum CPM                     | `0.3`                  | `number`  |
+| `bidFloorCur`     | optional | Currency of bid floor           | `'USD'`                | `string`  |
+| `coppa`           | optional | Set to `true` to enable COPPA   | `true`                 | `boolean` |
+| `test`            | optional | Set to `1` to enable test mode  | `1`                    | `integer` |
 
 Additionally `battr` ORTB blocking param may be set on `BANNER` and `VIDEO` media types to specify blocked creative
 attributes.

From f93807f020be9af7404588e746d69aad45520da8 Mon Sep 17 00:00:00 2001
From: Muki Seiler <muuki88@users.noreply.github.com>
Date: Mon, 15 Jun 2026 18:14:21 +0200
Subject: [PATCH 640/665] move aps.md to bidders (#6621)

---
 dev-docs/{ => bidders}/aps.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename dev-docs/{ => bidders}/aps.md (100%)

diff --git a/dev-docs/aps.md b/dev-docs/bidders/aps.md
similarity index 100%
rename from dev-docs/aps.md
rename to dev-docs/bidders/aps.md

From 9ea9741cb0d5d9fee17ddfeaa02334d974a27e13 Mon Sep 17 00:00:00 2001
From: prebid-compas <prebid@compas-inc.com>
Date: Mon, 15 Jun 2026 19:17:36 +0300
Subject: [PATCH 641/665] Add initial documentation for Synapse HX adapter
 (#6581)

---
 dev-docs/bidders/synapsehx.md | 43 +++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 dev-docs/bidders/synapsehx.md

diff --git a/dev-docs/bidders/synapsehx.md b/dev-docs/bidders/synapsehx.md
new file mode 100644
index 0000000000..99bd11a539
--- /dev/null
+++ b/dev-docs/bidders/synapsehx.md
@@ -0,0 +1,43 @@
+---
+layout: bidder
+title: Synapse HX
+biddercode: synapseHX
+description: Prebid Synapse HX Adapter
+tcfeu_supported: false
+coppa_supported: true
+gpp_supported: false
+floors_supported: true
+media_types: banner, video
+multiformat_supported: will-bid-on-any
+safeframes_ok: false
+schain_supported: false
+usp_supported: true
+pbjs: false
+pbs: true
+prebid_member: false
+fpd_supported: false
+privacy_sandbox: no
+ortb_blocking_supported: true
+sidebarType: 1
+---
+
+## Before You Begin
+
+The Synapse HX bidder adapter requires additional setup and approval from the Compas team. For additional information, please reach out to <prebid@compas-inc.com>.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `tenantId` | required | Synapse HX tenant identifier | `'deadbeef-cafe-4bad-8000-feedfacecafe'` | `string` |
+| `adUnitId` | optional | Synapse HX ad unit identifier | `'cafebabe-feed-4f00-9000-deadbeefbabe'` | `string` |
+
+## Additional Notes
+
+### Request Attributes
+
+- Bids are returned in **net** - that is, the bids returned reflect the bid amount with revenue sharing already taken into account. No adjustment is necessary.
+- Ensure that the `tenantId` parameter is set correctly for your integration.
+- If the `adUnitId` parameter is omitted, the integration falls back to the default ad unit configured for the specified `tenantId`.

From 6ed085e74799c5f1d329ba835f8686be80913346 Mon Sep 17 00:00:00 2001
From: oleksandrhn-code <oleksandr.hn@intentiq.com>
Date: Mon, 15 Jun 2026 19:17:52 +0300
Subject: [PATCH 642/665] AGT-843 Module documentation (#21) (#6580)

* AGT-843 Module documentation (#21)

Co-authored-by: Alex <alex@MacBook-Pro-Alex.local>

* Add new format for intentiq documentation (#22)

Co-authored-by: Alex <alex@MacBook-Pro-Alex.local>

* Iiq docs update (#23)

* Add new format for intentiq documentation

* Add new format for intentiq documentation

---------

Co-authored-by: Alex <alex@MacBook-Pro-Alex.local>

---------

Co-authored-by: Alex <alex@MacBook-Pro-Alex.local>
---
 dev-docs/analytics/intentiq.md | 44 +++++++++++++++++-----------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index d535f578ad..28fb3c3d85 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -5,15 +5,15 @@ description: IntentIQ Analytics Adapter
 modulecode: intentIq
 ---
 
-### Description
+## Description
 
 By using this Intent IQ adapter, you will be able to obtain comprehensive analytics and metrics regarding the performance of the Intent IQ Unified ID module. This includes how the module impacts your revenue, CPMs, and fill rates related to bidders and domains.
 
-#### Intent IQ Universal ID Registration
+### Intent IQ Universal ID Registration
 
 No registration for this module is required.
 
-#### Intent IQ Universal ID Configuration
+### Intent IQ Universal ID Configuration
 
 **IMPORTANT**: only effective when Intent IQ Universal ID module be installed and configured. [(How-To)](https://docs.prebid.org/dev-docs/modules/userid-submodules/intentiq.html)
 
@@ -22,18 +22,18 @@ No registration for this module is required.
 {: .table .table-bordered .table-striped }
 | Parameter | Scope | Type | Description | Example |
 | --- | --- | --- | --- | --- |
-| options.partner| Required | Number   | This is the partner ID value obtained from registering with IntentIQ.   | `1177538` |
+| options.partner | Required | Number | This is the partner ID value obtained from registering with IntentIQ. | `1177538` |
 | options.manualWinReportEnabled | Optional | Boolean | This variable determines whether the bidWon event is triggered automatically. If set to false, the event will occur automatically, and manual reporting with reportExternalWin will be disabled. If set to true, the event will not occur automatically, allowing manual reporting through reportExternalWin. The default value is false. | `false` |
 | options.reportMethod | Optional | String | Defines the HTTP method used to send the analytics report. If set to `"POST"`, the report payload will be sent in the body of the request. If set to `"GET"` (default), the payload will be included as a query parameter in the request URL. | `"GET"` |
 | options.reportingServerAddress | Optional | String | The base URL for the IntentIQ reporting server. If parameter is provided in `configParams`, it will be used. | `"https://domain.com"` |
-| options.adUnitConfig | Optional | Number |  Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId. | `1` |
-| options.gamPredictReporting | Optional | Boolean |  This variable controls whether the GAM prediction logic is enabled or disabled. The main purpose of this logic is to extract information from a rendered GAM slot when no Prebid bidWon event is available. In that case, we take the highest CPM from the current auction and add 0.01 to that value. | `false` |
+| options.adUnitConfig | Optional | Number | Determines how the `placementId` parameter is extracted in the report (default is 1). Possible values: 1 – adUnitCode first, 2 – placementId first, 3 – only adUnitCode, 4 – only placementId. | `1` |
+| options.gamPredictReporting | Optional | Boolean | This variable controls whether the GAM prediction logic is enabled or disabled. The main purpose of this logic is to extract information from a rendered GAM slot when no Prebid bidWon event is available. In that case, we take the highest CPM from the current auction and add 0.01 to that value. | `false` |
 | options. ABTestingConfigurationSource | Optional | String | Determines how AB group will be defined. Possible values: `"IIQServer"` – group defined by IIQ server, `"percentage"` – generated group based on abPercentage, `"group"` – define group based on value provided by partner. | `IIQServer` |
 | options.abPercentage | Optional | Number | Percentage for A/B testing group. Default value is `95` | `95` |
 | options.group | Optional | String | Define group provided by partner, possible values: `"A"`, `"B"` | `"A"` |
-| options.gamObjectReference      | Optional | Object   | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured.| `googletag`|
-| options.browserBlackList        | Optional | String   | This is the name of a browser that can be added to a blacklist.| `"chrome"`|
-| options.domainName              | Optional | String   | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages.| `"currentDomain.com"`|
+| options.gamObjectReference | Optional | Object | This is a reference to the Google Ad Manager (GAM) object, which will be used to set targeting. If this parameter is not provided, the group reporting will not be configured. | `googletag` |
+| options.browserBlackList | Optional | String | This is the name of a browser that can be added to a blacklist. | `"chrome"` |
+| options.domainName | Optional | String | Specifies the domain of the page in which the IntentIQ object is currently running and serving the impression. This domain will be used later in the revenue reporting breakdown by domain. For example, cnn.com. It identifies the primary source of requests to the IntentIQ servers, even within nested web pages. | `"currentDomain.com"` |
 | options. additionalParams | Optional | Array | This parameter allows sending additional custom key-value parameters with specific destination logic (sync, VR, winreport). Each custom parameter is defined as an object in the array. | `[ { parameterName: “abc”, parameterValue: 123, destination: [1,1,0] } ]` |
 | options. additionalParams[0].parameterName | Optional | String | Name of the custom parameter. This will be sent as a query parameter. | `"abc"` |
 | options. additionalParams[0].parameterValue | Optional | String / Number | Value to assign to the parameter. | `123` |
@@ -96,20 +96,20 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
 
 {: .table .table-bordered .table-striped }
 | Field | Data Type | Description | Example | Mandatory |
-|--------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|-----------|
-| biddingPlatformId   | Integer   | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1                             | Yes       |
-| partnerAuctionId    | String    | Use this when you are running multiple auction solutions across your assets and have a unified identifier for auctions                            | 3d44542d-xx-4662-xxxx-4xxxx3d8e | No        |
-| bidderCode          | String    | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms                                       | newAppnexus                   | Yes       |
+| -------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ----------- |
+| biddingPlatformId | Integer | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1 | Yes |
+| partnerAuctionId | String | Use this when you are running multiple auction solutions across your assets and have a unified identifier for auctions | 3d44542d-xx-4662-xxxx-4xxxx3d8e | No |
+| bidderCode | String | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms | newAppnexus | Yes |
 | prebidAuctionId | String | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform | 3513ce01-de02-490b-9d87-bfc137697f82 | No |
-| cpm                 | Decimal   | Cost per mille of the impression as received from the demand-side auction (without modifications or reductions)                                   | 5.62                          | Yes       |
-| currency            | String    | Currency of the auction                                                                                                                          | USD                           | Yes       |
-| originalCpm         | Decimal   | Leave empty or undefined if Prebid is not the bidding platform                                                                                    | 5.5                           | No        |
-| originalCurrency    | String    | Currency of the original auction                                                                                                                 | USD                           | No        |
-| status              | String    | Status of the impression. Leave empty or undefined if Prebid is not the bidding platform                                                          | rendered                      | No        |
-| placementId         | String    | Unique identifier of the ad unit on the webpage that showed this ad                                                                               | div-1                         | No        |
-| adType              | String    | Specifies the type of ad served. Possible values: “banner“, “video“, “native“, “audio“.                                                           | banner                        | No        |
-| size              | String    | Size of adUnit item                                                           | 320x250                       | No        |
-| pos              | number    | The pos field specifies the position of the adUnit on the page according to the OpenRTB 2.5 specification                                                           | 0                        | No        |
+| cpm | Decimal | Cost per mille of the impression as received from the demand-side auction (without modifications or reductions) | 5.62 | Yes |
+| currency | String | Currency of the auction | USD | Yes |
+| originalCpm | Decimal | Leave empty or undefined if Prebid is not the bidding platform | 5.5 | No |
+| originalCurrency | String | Currency of the original auction | USD | No |
+| status | String | Status of the impression. Leave empty or undefined if Prebid is not the bidding platform | rendered | No |
+| placementId | String | Unique identifier of the ad unit on the webpage that showed this ad | div-1 | Yes |
+| adType | String | Specifies the type of ad served. Possible values: “banner“, “video“, “native“, “audio“. | banner | No |
+| size | String | Size of adUnit item | 320x250 | No |
+| pos | number | The pos field specifies the position of the adUnit on the page according to the OpenRTB 2.5 specification | 0 | No |
 
 To report the auction win, call the function as follows:
 

From 81d84ef7519e80020d1ff1cf5040b79477453217 Mon Sep 17 00:00:00 2001
From: mihanikw2g <92710748+mihanikw2g@users.noreply.github.com>
Date: Mon, 15 Jun 2026 23:18:10 +0700
Subject: [PATCH 643/665] Asterio docs: native support (#6578)

---
 dev-docs/bidders/asterio.md | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/dev-docs/bidders/asterio.md b/dev-docs/bidders/asterio.md
index 00b3faa254..4061b9217d 100644
--- a/dev-docs/bidders/asterio.md
+++ b/dev-docs/bidders/asterio.md
@@ -5,7 +5,7 @@ description: Prebid Asterio Bidder Adapter
 biddercode: asterio
 pbjs: true
 pbs: false
-media_types: banner, video
+media_types: banner, video, native
 tcfeu_supported: false
 dsa_supported: false
 gvl_id: none
@@ -76,3 +76,22 @@ var adUnits = [{
   }]
 }];
 ```
+
+## Native Test Ad Unit
+
+Asterio uses `adUnitToken` to resolve the ad unit and format. For native ad units, include `mediaTypes.native` and render the returned native assets in the publisher layout. See the [Prebid Native Implementation Guide](/prebid/native-implementation.html) for rendering options.
+
+```javascript
+var adUnits = [{
+  code: 'test-native',
+  mediaTypes: {
+    native: {}
+  },
+  bids: [{
+    bidder: 'asterio',
+    params: {
+      adUnitToken: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
+    }
+  }]
+}];
+```

From a08861ec01c8403066ff0948467b0a219fba0e76 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Mon, 15 Jun 2026 19:19:52 +0300
Subject: [PATCH 644/665] Adkernel: documenting ReLoad alias (#6572)

---
 dev-docs/bidders/reload.md | 43 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 dev-docs/bidders/reload.md

diff --git a/dev-docs/bidders/reload.md b/dev-docs/bidders/reload.md
new file mode 100644
index 0000000000..7b6f78cc31
--- /dev/null
+++ b/dev-docs/bidders/reload.md
@@ -0,0 +1,43 @@
+---
+layout: bidder
+title: ReLoad
+description: ReLoad Adaptor
+biddercode: reload
+aliasCode: adkernel
+tcfeu_supported: true
+dsa_supported: false
+gvl_id: 14 (adkernel)
+usp_supported: true
+coppa_supported: true
+gpp_sids: tcfeu, usp
+schain_supported: true
+dchain_supported: false
+userId: all
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+pbs_app_supported: false
+prebid_member: false
+multiformat_supported: will-bid-on-any
+ortb_blocking_supported: true
+privacy_sandbox: no
+sidebarType: 1
+
+---
+
+## Note
+
+The ReLoad bidding adaptor requires setup and approval before beginning. Please reach out to <reload@cultureg.eu> for more details
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name     | Scope    | Description           | Example                   | Type      |
+|----------|----------|-----------------------|---------------------------|-----------|
+| `host`   | required | RTB host              | `'cpm.reload.ad'`         | `string`  |
+| `zoneId` | required | RTB zone id           | `30164`                   | `integer` |

From df29437ba01ac2102e27565e6d19123cce0c997d Mon Sep 17 00:00:00 2001
From: anzuprebid <prebid@anzu.io>
Date: Mon, 15 Jun 2026 19:21:49 +0300
Subject: [PATCH 645/665] New adapter: Anzu SSP (#6567)

* new docs added

* new line added

---------

Co-authored-by: Vitalii Sumlennyi <vitalii.sumlennyi@teqblaze.com>
---
 dev-docs/bidders/anzuSSP.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 dev-docs/bidders/anzuSSP.md

diff --git a/dev-docs/bidders/anzuSSP.md b/dev-docs/bidders/anzuSSP.md
new file mode 100644
index 0000000000..8c7ad30ee9
--- /dev/null
+++ b/dev-docs/bidders/anzuSSP.md
@@ -0,0 +1,31 @@
+---
+layout: bidder
+title: Anzu SSP
+description: Anzu SSP Bidder Adapter
+biddercode: AnzuSSP
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: false
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+multiformat_supported: will-bid-on-any
+---
+
+
+## Bid Params
+
+{:.table .table-bordered .table-striped}
+| Name          | Scope    | Description  | Example | Type     |
+|---------------|----------|--------------|---------|----------|
+| `placementId` | optional | Placement Id | `'0'`   | `string` |
+| `endpointId`  | optional | Endpoint Id  | `'0'`   | `string` |
+
+## Note
+
+For the prebid server and prebid.js you only need to use one parameter: either `placementId` or `endpointId`.

From 6f47b4a06c6a4acfe9215e461f6e15ca912ba0c4 Mon Sep 17 00:00:00 2001
From: Djole <dd@umcaruje.net>
Date: Mon, 15 Jun 2026 18:24:06 +0200
Subject: [PATCH 646/665] Adelerate Bidder: initial docs (#6557)

* Add Adelerate bidder docs

* Lint fixes

* Align metadata with adapter code

* Update dev-docs/bidders/adelerate.md

* Update dev-docs/bidders/adelerate.md

* Set pbs to false for faster merge

---------

Co-authored-by: Djole <djole@Djole.local>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/adelerate.md | 39 +++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 dev-docs/bidders/adelerate.md

diff --git a/dev-docs/bidders/adelerate.md b/dev-docs/bidders/adelerate.md
new file mode 100644
index 0000000000..399fb148ed
--- /dev/null
+++ b/dev-docs/bidders/adelerate.md
@@ -0,0 +1,39 @@
+---
+layout: bidder
+title: Adelerate
+description: Adelerate's Prebid Bidder Adapter for banner, video, and native demand
+biddercode: adelerate
+media_types: video, native
+dsa_supported: true
+usp_supported: true
+gpp_sids: tcfca, usnat, usstate_all, usp
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+multiformat_supported: will-bid-on-any
+userId: all
+pbjs: true
+pbs: false
+pbs_app_supported: true
+safeframes_ok: true
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name            | Scope    | Description                                          | Example     | Type     |
+|-----------------|----------|------------------------------------------------------|-------------|----------|
+| `placementId`   | required | The placement ID provided by Adelerate.              | `'abc123'`  | `string` |
+| `publisherId`   | required | The publisher ID provided by Adelerate.              | `'pub-456'` | `string` |
+| `floor`         | optional | Minimum CPM in USD. Floors module is preferred.      | `0.50`      | `number` |
+| `floorCurrency` | optional | Currency for the floor param. Defaults to `USD`.     | `'EUR'`     | `string` |
+
+## Note
+
+Adelerate is not currently registered on the IAB Europe Global Vendor List, so this adapter does not declare a `gvlid`.
+Under GDPR, Prebid core will withhold bid requests and user syncs to this bidder unless the publisher's CMP setup explicitly permits.
+A `gvlid` will be added once IAB Europe registration is finalized.

From 66aa2433077a7ace5504cbfbf2574a4ce99f292f Mon Sep 17 00:00:00 2001
From: "David K." <david.kambersky.rok1@gmail.com>
Date: Mon, 15 Jun 2026 20:04:27 +0100
Subject: [PATCH 647/665] Add Engerio bidder docs (#6576)

* Add Engerio bidder docs

* Update dev-docs/bidders/engerio.md

---------

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/engerio.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 dev-docs/bidders/engerio.md

diff --git a/dev-docs/bidders/engerio.md b/dev-docs/bidders/engerio.md
new file mode 100644
index 0000000000..5ce31d6211
--- /dev/null
+++ b/dev-docs/bidders/engerio.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: Engerio
+description: Prebid Engerio Bidder Adapter
+biddercode: engerio
+tcfeu_supported: false
+dsa_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_sids: none
+schain_supported: false
+dchain_supported: false
+media_types: banner
+safeframes_ok: true
+deals_supported: false
+floors_supported: false
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-not-bid
+ortb_blocking_supported: false
+privacy_sandbox: no
+sidebarType: 1
+---
+
+### Note
+
+The Engerio adapter requires an active publisher account. Please contact [info@thinkeasy.cz](mailto:info@thinkeasy.cz) to obtain an ad slot code (`adUnitCode`) for your placement.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|------|-------|-------------|---------|------|
+| `adUnitCode` | required | The ad slot identifier configured in the Engerio admin for this placement. | `'homepage-sidebar'` | `string` |

From 44dadc9a87fa98da2a377ba4f97e17cd3f6ae011 Mon Sep 17 00:00:00 2001
From: Chris Connors <connorsRU@gmail.com>
Date: Tue, 16 Jun 2026 00:42:41 -0400
Subject: [PATCH 648/665] Update Scaleable Analytics Adapter docs (#6617)

* Update Scaleable Analytics Adapter docs

* Updated Scaleable docs with linting

* Scaleable Analytics PR Feedback for gpp_sids
---
 dev-docs/analytics/scaleable.md | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/dev-docs/analytics/scaleable.md b/dev-docs/analytics/scaleable.md
index 7ebd129ea8..806814b54c 100644
--- a/dev-docs/analytics/scaleable.md
+++ b/dev-docs/analytics/scaleable.md
@@ -3,8 +3,33 @@ layout: analytics
 title: Scaleable
 description: Scaleable Analytics Adapter
 modulecode: scaleable
+tcfeu_supported: false
+usp_supported: true
+gpp_sids: usp, usnat, usstate_all
+coppa_supported: true
+prebid_member: false
 ---
 
-#### Registration
+## Analytics Options
 
-Please visit [scaleable.ai](https://scaleable.ai/) for more information.
+{: .table .table-bordered .table-striped }
+| Name              | Scope    | Description                                                               | Example          | Type     |
+|-------------------|----------|---------------------------------------------------------------------------|------------------|----------|
+| `siteId`          | required | Identifies your site to Scaleable. Contact Scaleable to receive it.       | `'YOUR_SITE_ID'` | `string` |
+| `auctionEndDelay` | optional | Milliseconds to wait after `AUCTION_END` before reporting (default 1500). | `1000`           | `int`    |
+| `sampling`        | optional | 0–1; the fraction of sessions to collect data on (default 1.0).           | `0.5`            | `float`  |
+
+## Example Configuration
+
+```javascript
+pbjs.enableAnalytics({
+    provider: 'scaleable',
+    options: {
+        siteId: 'YOUR_SITE_ID' // contact Scaleable to receive your siteId
+    }
+});
+```
+
+## Registration
+
+Contact <team@scaleable.ai> for more information or to sign up for analytics. See [Scaleable Advertising](https://scaleable.ai/services/advertising).

From 46693f0c1cdf4f0812eb86551030784aae47a8f7 Mon Sep 17 00:00:00 2001
From: Denis Logachov <ckbo3hrk@gmail.com>
Date: Tue, 16 Jun 2026 10:11:00 +0300
Subject: [PATCH 649/665] Adkernel: updating waardex_ak alias (#6379)

---
 dev-docs/bidders/waardex_ak.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev-docs/bidders/waardex_ak.md b/dev-docs/bidders/waardex_ak.md
index 52fb5df578..6e1d8b4eb9 100644
--- a/dev-docs/bidders/waardex_ak.md
+++ b/dev-docs/bidders/waardex_ak.md
@@ -19,8 +19,8 @@ deals_supported: false
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbs: false
-pbs_app_supported: false
+pbs: true
+pbs_app_supported: true
 prebid_member: false
 multiformat_supported: will-bid-on-any
 ortb_blocking_supported: true

From fe89459836bd662be17886226e43b19bbe9b6092 Mon Sep 17 00:00:00 2001
From: SmartHubSolutions <87376145+SmartHubSolutions@users.noreply.github.com>
Date: Tue, 16 Jun 2026 16:50:06 +0300
Subject: [PATCH 650/665] Attekmi: rename Adinify to Adlywise (#6570)

* Attekmi: rename Adinify to Adlywise

* only pbjs

* headers fix

---------

Co-authored-by: Victor <victor.banudz@smart-hub.io>
---
 dev-docs/bidders/adinify.md  | 39 ----------------------------------
 dev-docs/bidders/adlywise.md | 41 ++++++++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 39 deletions(-)
 delete mode 100644 dev-docs/bidders/adinify.md
 create mode 100644 dev-docs/bidders/adlywise.md

diff --git a/dev-docs/bidders/adinify.md b/dev-docs/bidders/adinify.md
deleted file mode 100644
index 996e97836d..0000000000
--- a/dev-docs/bidders/adinify.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-layout: bidder
-title: Adinify
-description: Adinify Bidder Adapter
-biddercode: adinify
-aliasCode : smarthub
-usp_supported: true
-coppa_supported: true
-schain_supported: true
-dchain_supported: true
-media_types: banner, video, native
-safeframes_ok: true
-deals_supported: true
-floors_supported: true
-fpd_supported: false
-pbjs: true
-pbs: true
-pbs_app_supported: true
-multiformat_supported: will-bid-on-any
----
-
-### Prebid.js Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description                     | Example                             | Type      |
-|---------------|----------|---------------------------------|-------------------------------------|-----------|
-| `seat`        | required | Seat value                      | `'9Q20EdGxzgWdfPYShScl'`            | `string`  |
-| `token`       | required | Token                           | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`  |
-| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']` | `Array(String)` |
-| `minBidfloor`  | optional | Minimal CPM value               | `0.03`                              | `float`    |
-| `pos`         | optional | The position of the placement on the page, see Open RTB spec v2.5.  | `4` | `number`  |
-
-### Prebid Server Bid Params
-
-{: .table .table-bordered .table-striped }
-| Name          | Scope    | Description         | Example                              | Type     |
-|---------------|----------|---------------------|--------------------------------------|----------|
-| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
-| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |
diff --git a/dev-docs/bidders/adlywise.md b/dev-docs/bidders/adlywise.md
new file mode 100644
index 0000000000..e46ed103a8
--- /dev/null
+++ b/dev-docs/bidders/adlywise.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Adlywise
+description: Adlywise Bidder Adapter
+biddercode: adlywise
+aliasCode : smarthub
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+dchain_supported: true
+media_types: banner, video, native
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+pbs_app_supported: false
+multiformat_supported: will-bid-on-any
+---
+
+## Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                                        | Example                              | Type            |
+| :------------ | :------- | :----------------------------------------------------------------- | :----------------------------------- | :-------------- |
+| `seat`        | required | Seat value                                                         | `'9Q20EdGxzgWdfPYShScl'`             | `string`        |
+| `token`       | required | Token                                                              | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string`        |
+| `iabCat`      | optional | Array of IAB content categories that describe the content producer | `['IAB1-1', 'IAB3-1', 'IAB4-3']`     | `Array(String)` |
+| `minBidfloor` | optional | Minimal CPM value                                                  | `0.03`                               | `float`         |
+| `pos`         | optional | The position of the placement on the page, see OpenRTB spec v2.5.  | `4`                                  | `number`        |
+
+## Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description         | Example                              | Type     |
+| :------------ | :------- | :------------------ | :----------------------------------- | :------- |
+| `seat`        | required | Seat value          | `'9Q20EdGxzgWdfPYShScl'`             | `string` |
+| `token`       | required | Token               | `'eKmw6alpP3zWQhRCe3flOpz0wpuwRFjW'` | `string` |

From 4c6dcd4cc7cfa571c5a52804aa01c5518f1672fe Mon Sep 17 00:00:00 2001
From: vdo-ai-tech <126867429+vdo-ai-tech@users.noreply.github.com>
Date: Tue, 16 Jun 2026 20:11:02 +0530
Subject: [PATCH 651/665] VDOAI Bid Adapter: updated documentation for
 bidfloors and VDOAI PBS module (#6584)

* updated vdoai bidder adapter documentation

* vdoai bid adapter: updated documentation for bidfloor

* fixed markdown linting errors

---------

Co-authored-by: Rishabh Sehrawat <rishabh.s@z1tech.com>
---
 dev-docs/bidders/vdoai.md | 36 +++++++++++++++++++++---------------
 1 file changed, 21 insertions(+), 15 deletions(-)

diff --git a/dev-docs/bidders/vdoai.md b/dev-docs/bidders/vdoai.md
index 7a43e2c39e..1fcb2e2d1e 100644
--- a/dev-docs/bidders/vdoai.md
+++ b/dev-docs/bidders/vdoai.md
@@ -4,35 +4,41 @@ title: VDO.AI
 description: Prebid vdo.ai Bidder Adaptor
 biddercode: vdoai
 pbjs: true
+pbs: true
 media_types: video, banner
 userIds: all
 fpd_supported: false
-tcfeu_supported: false
+tcfeu_supported: true
 usp_supported: true
+gvl_id: 1561
 coppa_supported: true
 schain_supported: true
 prebid_member: false
 ortb_blocking_supported: true
 multiformat_supported: will-bid-on-one
-floors_supported: false
+floors_supported: true
 sidebarType: 1
 ---
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
-| Name          | Scope    | Description                                                 | Example               | Type      |
-|:--------------|:---------|:------------------------------------------------------------|:----------------------|:----------|
-| `host`        | required | Ad network's RTB host                                       | `'exchange.ortb.net'` | `string`  |
-| `adUnitId`    | required | Ad Unit Id will be generated on VDO.AI Platform.            | `42`                  | `integer` |
-| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)                     | `'banner'`            | `string`  |
-| `custom1`     | optional | Custom targeting field 1                                    | `'custom1'`           | `string`  |
-| `custom2`     | optional | Custom targeting field 2                                    | `'custom2'`           | `string`  |
-| `custom3`     | optional | Custom targeting field 3                                    | `'custom3'`           | `string`  |
-| `custom4`     | optional | Custom targeting field 4                                    | `'custom4'`           | `string`  |
-| `custom5`     | optional | Custom targeting field 5                                    | `'custom5'`           | `string`  |
+| Name          | Scope    | Description                                      | Example               | Type               |
+| :------------ | :------- | :----------------------------------------------- | :-------------------- | :----------------- |
+| `host`        | required | Ad network's RTB host                            | `'exchange.ortb.net'` | `string`           |
+| `adUnitId`    | required | Ad Unit Id will be generated on VDO.AI Platform. | `123456`              | `integer / string` |
+| `publisherId` | required | publisherId will be generated on VDO.AI Platform | `'pub-abc'`           | `string`           |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)          | `'banner'`            | `string`           |
+| `custom1`     | optional | Custom targeting field 1                         | `'custom1'`           | `string`           |
+| `custom2`     | optional | Custom targeting field 2                         | `'custom2'`           | `string`           |
+| `custom3`     | optional | Custom targeting field 3                         | `'custom3'`           | `string`           |
+| `custom4`     | optional | Custom targeting field 4                         | `'custom4'`           | `string`           |
+| `custom5`     | optional | Custom targeting field 5                         | `'custom5'`           | `string`           |
+| `bidfloor`    | optional | Minimum bid floor price in USD                   | `1.5`                 | `float`            |
 
-VDO.AI client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+VDO.AI client-side Prebid.js adapter requires only `host`, `publisherId`, `adUnitId`, `adUnitType`.
 
-VDO.AI client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.
+VDO.AI server-side Prebid Server adapter requires `host`, `publisherId`, `adUnitId`, `adUnitType`.
+
+Both VDO.AI client-side Prebid.js and server-side Prebid Server adapters support only `banner` and `video` media types, and do not support `audio` or `native`.

From 5d3c891a7d657f12b87007117796fd3b75293afc Mon Sep 17 00:00:00 2001
From: mkomorski <marcin.komorski@pollub.edu.pl>
Date: Tue, 16 Jun 2026 16:43:14 +0200
Subject: [PATCH 652/665] Safe renderer (#6585)

* Safe renderer

* linting

* Update dev-docs/renderer.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* removing mediaType from explicit paramters

---------

Co-authored-by: Marcin Komorski <marcinkomorski@marcins-mbp.home>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/renderer.md | 172 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 157 insertions(+), 15 deletions(-)

diff --git a/dev-docs/renderer.md b/dev-docs/renderer.md
index 30cd9155bf..89a870c57f 100644
--- a/dev-docs/renderer.md
+++ b/dev-docs/renderer.md
@@ -17,22 +17,23 @@ In simple terms, a renderer offers publishers:
 - A way to introduce new ad formats without disrupting user experience
 - Control over maintaining design consistency between ads and site content
 
-## Renderer Object
+## Types of renderers
 
-{: .table .table-bordered .table-striped }
-| Name | Scope | Type | Description |
-|--------------+----------+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `url` | Required | String | URL to the renderer script that will be loaded. This script should create a renderer object in the global scope. |
-| `render` | Required | Function | Function that tells Prebid.js how to invoke the renderer script to render a bid. The function receives the bid object as a parameter. |
-| `backupOnly` | Optional | Boolean | if set to true, buyer or adapter renderer will be preferred |
+From Prebid 11.15 onward, publishers and adapters can specify their custom renderers in two ways: top window renderers (the old-fashioned way) and the new Safe Renderer approach. The latter has the significant advantage of executing renderer code inside the ad frame, where the ad markup and other important data are accessible within the frame context, whereas the old approach executed renderers in the top window. We strongly recommend using the new Safe Renderer approach whenever possible.
+
+If both Safe Renderer and top window renderers are specified, the Safe Renderer takes precedence. You can also disable top window renderers through the top level configuration flag:
+
+```javascript
+pbjs.setConfig({ allowTopWindowRenderers: false })
+```
 
 ## Renderer Implementation Levels
 
-Renderers can be specified at multiple levels:
+Renderers can be specified at multiple levels by specifying either `safeRenderer` or `renderer` field on one of the following levels:
 
-1. MediaType Level (adUnit.mediaTypes.video\|banner\|native.renderer): If a renderer is associated with a specific mediaType (video, banner, or native), it will be used to display any demand associated with that mediaType. This is the preferred method for all ad types.
-2. AdUnit Level (adUnit.renderer): Applied to all bids for this ad unit that don't override it. This is a legacy approach; using the mediaType-level renderer is preferred.
-3. Bidder Level (adUnit.bids[].renderer): Applied only to this bidder, overriding adUnit renderer if both exist.
+1. MediaType Level `adUnit.mediaTypes.video|banner|native|audio`: If a renderer is associated with a specific mediaType (video, banner, audio or native), it will be used to display any demand associated with that mediaType. This is the preferred method for all ad types.
+2. AdUnit Level `adUnit`: Applied to all bids for this ad unit that don't override it. This is a legacy approach; using the mediaType-level renderer is preferred.
+3. Bidder Level `adUnit.bids[]`: Applied only to this bidder, overriding adUnit renderer if both exist.
 4. Default: If no renderer is specified at any level, Prebid will use the default renderer for the media type, if one exists. For banner and native ads, Prebid.js has built-in default rendering capabilities.
 
 ### Priority Order
@@ -44,9 +45,150 @@ When multiple renderers are defined, the following priority is used:
 3. Bidder Level renderer
 4. Default renderer
 
-## Special Cases
+## Safe renderer
+
+The Safe Renderer works similarly to the default Prebid renderer in that it is injected into the ad frame. The key difference is that it does not render the ad by itself. Instead, it loads an external renderer script using the URL specified in the Safe Renderer configuration. Once the script is loaded, the Safe Renderer executes the `window.pbRenderInFrame({ config, ...renderingData })` function, which must be defined by the external script
+
+### Config object
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Type | Description |
+| -------------- | ---------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `url` | Required | String | URL to the external renderer script that will be loaded and executed within Safe renderer |
+| `config` | Optional | Object | Object that will be passed to external renderer script as a `config` field. For bid adapters use |
+| `getConfig` | Optional | Function | Function that will evaluate `config` object accessible in external renderer script. For publisher's use. Accepts `bidResponse` as a parameter |
+
+```javascript
+const adUnits = [
+      {
+        mediaTypes: {
+          video: {
+            context: 'outstream',
+            playerSize: [300, 250],
+            mimes: ['video/mp4'],
+            safeRenderer: {
+              url: 'https://trafto.s3.eu-central-1.amazonaws.com/rendererV2.js',
+              getConfig: (bidResponse) => {
+                return {
+                  configField: 'passed-from-adunit-config'
+                }
+              }
+            },
+          }
+        },
+        code: adUnitCode,
+      }
+    ];
+```
+
+### External script example implementation
+
+Existing top level custom renderers can be easily migrated to work with the new Safe Renderer approach. The external script simply needs to define the `window.pbRenderInFrame` method and execute the rendering logic inside it. The function accepts a payload object containing `config` (either passed by bid adapters or evaluated by the publisher-provided `getConfig(bidResponse)` function), and [...renderingData](/dev-docs/renderer.html#renderingData).
+
+```javascript
+/* global YVAP */
+/**
+ * Reference implementation for `bid.safeRenderer.url`.
+ * Prebid injects this script into the creative iframe and then calls `window.pbRenderInFrame(payload)`.
+ */
+window.pbRenderInFrame = function ({ config, ...renderingData }) {
+
+  function yvapPlayerRender(b) {
+      var safeAdId =
+        b.adId != null && String(b.adId).length
+          ? String(b.adId).replace(/[^a-zA-Z0-9_-]/g, '')
+          : '';
+      var targetNodeId =
+        'pb-yvap-' +
+        (safeAdId || 'slot-' + Date.now() + '-' + Math.random().toString(36).slice(2, 9));
+  
+      var container = document.createElement('div');
+      container.id = targetNodeId;
+      if (b.width != null) {
+        container.style.width =
+          typeof b.width === 'number' ? b.width + 'px' : String(b.width);
+      }
+      if (b.height != null) {
+        container.style.height =
+          typeof b.height === 'number' ? b.height + 'px' : String(b.height);
+      }
+      document.body.appendChild(container);
+
+
+      function initPlayer() {
+        // eslint-disable-next-line no-new
+          new YVAP({
+            id: targetNodeId,
+            player: {
+              type: 'Outstream',
+              controls: true,
+              height: b.height,
+              width: b.width
+            },
+            ads: {
+              adTagXml: b.vastXml
+            }
+          });
+      }
+  
+      if (window.YVAP) {
+        initPlayer();
+        return;
+      }
+  
+      var script = document.createElement('script');
+      script.src = 'https://s.yimg.com/kp/yvap/1.9.0/yvap.js';
+      script.async = true;
+      script.onload = function () {
+        initPlayer();
+      };
+      script.onerror = function () {
+        // eslint-disable-next-line no-console
+        console.error('[Yahoo ADS bid adapter]: Outstream renderer script failed to load.');
+      };
+      var firstScript = document.getElementsByTagName('script')[0];
+      if (firstScript && firstScript.parentNode) {
+        firstScript.parentNode.insertBefore(script, firstScript);
+      } else {
+        (document.head || document.documentElement).appendChild(script);
+      }    
+    }
+
+  yvapPlayerRender(renderingData);
+};
+```
+
+<a id="renderingData"></a>
+
+### Rendering data
+
+{: .table .table-bordered .table-striped }
+| Property | Description |
+| ---------- | ------------- |
+| `ad` | Ad markup |
+| `adUrl` | Ad markup url |
+| `width` | Width of the creative |
+| `height` | Height of the creative |
+| `instl` | Interstitial flag (`1` for interstitial, `0` for non-interstitial) |
+| `vastXml` | The VAST XML content (if available instead of vastUrl) |
+| `vastUrl` | URL to the VAST XML for video ads |
+| `mediaType` | Type of media ('video', 'banner', etc.) |
+| `safeRenderer` | Prepared Safe Renderer configuration (including `url` and related fields) used to load and run the external renderer script |
+
+## Top window renderer 
+
+### Config object
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Type | Description |
+|--------------+----------+---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `url` | Required | String | URL to the renderer script that will be loaded. This script should create a renderer object in the global scope. |
+| `render` | Required | Function | Function that tells Prebid.js how to invoke the renderer script to render a bid. The function receives the bid object as a parameter. |
+| `backupOnly` | Optional | Boolean | if set to true, buyer or adapter renderer will be preferred |
+
+### Special Cases
 
-### Banner with Custom Renderer
+#### Banner with Custom Renderer
 
 Although renderers are commonly associated with video ads, they can also be used with banner ads to create custom rendering experiences:
 
@@ -96,7 +238,7 @@ A banner renderer might be used to:
 4. Apply custom styling or containers to maintain site design aesthetics
 5. Implement fallback scenarios for different devices or browsers
 
-## Renderer Implementation Example
+### Renderer Implementation Example
 
 ```javascript
 // Example of a secure custom banner renderer implementation
@@ -182,7 +324,7 @@ window.BannerRenderer = function (config) {
 };
 ```
 
-## Common Renderer Properties
+### Common Top window renderer Properties
 
 Here are commonly used properties from the bid object that can be accessed in the renderer:
 

From f19c388737fc5055b6fc23ff129a5a658ae4a7fb Mon Sep 17 00:00:00 2001
From: gregneuwo <grzegorz.malisz@neuwo.ai>
Date: Wed, 17 Jun 2026 17:21:44 +0200
Subject: [PATCH 653/665] Neuwo Rtd Module: Version v2.0.0 and Quality of Life
 Improvements Documentation (#6384)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: update Neuwo RTD Module documentation with new features

- Document `iabTaxonomyFilters` parameter for per-tier filtering
- Add IAB Taxonomy Filtering section with tier configuration examples
- Add section on accessing Neuwo data outside Prebid.js via events
- Document `bidRequested` event usage with code example
- Include event lifecycle table for reference

* style: apply formatting to Neuwo RTD Module markdown documentation

* docs: update Neuwo RTD Module documentation for new API version

- Change default IAB Content Taxonomy version from "3.0" to "2.2"
- Add IAB Content Taxonomy version "1.0" to supported values list
- Add server-side filtering explanation to IAB Taxonomy Filtering section
- Update Available Tiers table to focus on taxonomy types instead of API internals
- Add recommended configuration comments for `auctionDelay` and `waitForIt`
- Update all configuration examples to use "2.2" as default taxonomy version
- Remove "How it works" section
- Add Neuwo RTD Module version information

* docs: add OpenRTB 2.5 category fields support documentation to Neuwo RTD Module

Changes:
- Add OpenRTB 2.5 feature description to module overview
- Add `enableOrtb25Fields` parameter to parameters table
- Add dedicated "OpenRTB 2.5 Category Fields" section with examples
- Update ORTB2 data structure examples to show category fields
- Add filtering section explaining IAB 1.0 filter application
- Update "Accessing Neuwo Data" section with category field extraction example
- Update segtax value in example (7 → 6)
- Update version to 2.1.0

* docs: bump Neuwo RTD Module version to 2.2.0

* docs: bump Neuwo RTD Module version to 2.2.0

---------

Co-authored-by: grzgm <125459798+grzgm@users.noreply.github.com>
Co-authored-by: gregneuwo <226034698+gregneuwo@users.noreply.github.com>
---
 dev-docs/modules/neuwoRtdProvider.md | 320 ++++++++++++++++++++-------
 1 file changed, 240 insertions(+), 80 deletions(-)

diff --git a/dev-docs/modules/neuwoRtdProvider.md b/dev-docs/modules/neuwoRtdProvider.md
index 1148c09e20..1760b18e7e 100644
--- a/dev-docs/modules/neuwoRtdProvider.md
+++ b/dev-docs/modules/neuwoRtdProvider.md
@@ -18,55 +18,47 @@ The Neuwo RTD provider fetches real-time contextual data from the Neuwo API. Whe
 
 This data is then added to the bid request by populating the OpenRTB 2.x objects `ortb2.site.content.data` (for IAB Content Taxonomy) and `ortb2.user.data` (for IAB Audience Taxonomy). This enrichment allows bidders to leverage Neuwo's contextual analysis for more precise targeting and decision-making.
 
+Additionally, when enabled, the module populates OpenRTB 2.5 category fields (`ortb2.site.cat`, `ortb2.site.sectioncat`, `ortb2.site.pagecat`, `ortb2.site.content.cat`) with IAB Content Taxonomy 1.0 segments.
+
 Here is an example scheme of the data injected into the `ortb2` object by our module:
 
 ```javascript
 ortb2: {
   site: {
+    // OpenRTB 2.5 category fields (IAB Content Taxonomy 1.0)
+    cat: ["IAB12", "IAB12-3", "IAB12-5"],
+    sectioncat: ["IAB12", "IAB12-3", "IAB12-5"],
+    pagecat: ["IAB12", "IAB12-3", "IAB12-5"],
     content: {
+      // OpenRTB 2.5 category field (IAB Content Taxonomy 1.0)
+      cat: ["IAB12", "IAB12-3", "IAB12-5"],
       // IAB Content Taxonomy data is injected here
       data: [{
         name: "www.neuwo.ai",
-        segment: [{
-            id: "274",
-            name: "Home & Garden",
-          },
-          {
-            id: "42",
-            name: "Books and Literature",
-          },
-          {
-            id: "210",
-            name: "Food & Drink",
-          },
+        segment: [
+          { id: "274" },
+          { id: "42" },
+          { id: "210" },
         ],
         ext: {
-          segtax: 7,
+          segtax: 6,
         },
-      }, ],
+      }],
     },
   },
   user: {
     // IAB Audience Taxonomy data is injected here
     data: [{
       name: "www.neuwo.ai",
-      segment: [{
-          id: "49",
-          name: "Demographic | Gender | Female |",
-        },
-        {
-          id: "161",
-          name: "Demographic | Marital Status | Married |",
-        },
-        {
-          id: "6",
-          name: "Demographic | Age Range | 30-34 |",
-        },
+      segment: [
+        { id: "49" },
+        { id: "161" },
+        { id: "6" },
       ],
       ext: {
         segtax: 4,
       },
-    }, ],
+    }],
   },
 }
 ```
@@ -81,43 +73,82 @@ This module is configured as part of the `realTimeData.dataProviders` object.
 
 ```javascript
 pbjs.setConfig({
-    realTimeData: {
-        auctionDelay: 500, // Value can be adjusted based on the needs
-        dataProviders: [
-            {
-                name: "NeuwoRTDModule",
-                waitForIt: true,
-                params: {
-                    neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
-                    neuwoApiToken: "<Your Neuwo API Token>",
-                    iabContentTaxonomyVersion: "3.0",
-                    enableCache: true, // Default: true. Caches API responses to avoid redundant requests
-                },
-            },
-        ],
-    },
+  realTimeData: {
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
+    dataProviders: [
+      {
+        name: "NeuwoRTDModule",
+        waitForIt: true, // Recommended to be set to `true`
+        params: {
+          neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+          neuwoApiToken: "<Your Neuwo API Token>",
+          iabContentTaxonomyVersion: "2.2",
+          enableCache: true, // Default: true. Caches API responses to avoid redundant requests
+          enableOrtb25Fields: true, // Default: true.
+        },
+      },
+    ],
+  },
 });
 ```
 
 **Parameters**
 
-| Name                                | Type     | Required | Default | Description                                                                                                                                                                                                                                                                                                                |
-| :---------------------------------- | :------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`                              | String   | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                                                                                                                                                                                                                                         |
-| `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                  |
-| `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                   |
-| `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                   |
-| `params.iabContentTaxonomyVersion`  | String   | No       | `'3.0'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'2.2'`, `'3.0'`.                                                                                                                                                                                                                          |
-| `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                        |
-| `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                        |
-| `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains. |
-| `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                 |
-| `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                     |
+| Name                                | Type     | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                |
+| :---------------------------------- | :------- | :------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`                              | String   | Yes      |         | The name of the module, which is `NeuwoRTDModule`.                                                                                                                                                                                                                                                                                                                         |
+| `params`                            | Object   | Yes      |         | Container for module-specific parameters.                                                                                                                                                                                                                                                                                                                                  |
+| `params.neuwoApiUrl`                | String   | Yes      |         | The endpoint URL for the Neuwo Edge API.                                                                                                                                                                                                                                                                                                                                   |
+| `params.neuwoApiToken`              | String   | Yes      |         | Your unique API token provided by Neuwo.                                                                                                                                                                                                                                                                                                                                   |
+| `params.iabContentTaxonomyVersion`  | String   | No       | `'2.2'` | Specifies the version of the IAB Content Taxonomy to be used. Supported values: `'1.0'`, `'2.2'`, `'3.0'`.                                                                                                                                                                                                                                                                 |
+| `params.enableCache`                | Boolean  | No       | `true`  | If `true`, caches API responses to avoid redundant requests for the same page during the session. Set to `false` to disable caching and make a fresh API call on every bid request.                                                                                                                                                                                        |
+| `params.enableOrtb25Fields`         | Boolean  | No       | `true`  | If `true`, populates OpenRTB 2.5 category fields (`ortb2.site.cat`, `ortb2.site.sectioncat`, `ortb2.site.pagecat`, `ortb2.site.content.cat`) with IAB Content Taxonomy 1.0 segments. See [OpenRTB 2.5 Category Fields](#openrtb-25-category-fields) section below for details.                                                                                             |
+| `params.stripAllQueryParams`        | Boolean  | No       | `false` | If `true`, strips all query parameters from the URL before analysis. Takes precedence over other stripping options.                                                                                                                                                                                                                                                        |
+| `params.stripQueryParamsForDomains` | String[] | No       | `[]`    | List of domains for which to strip **all** query parameters. When a domain matches, all query params are removed for that domain and all its subdomains (e.g., `'example.com'` strips params for both `'example.com'` and `'sub.example.com'`). This option takes precedence over `stripQueryParams` for matching domains.                                                 |
+| `params.stripQueryParams`           | String[] | No       | `[]`    | List of specific query parameter names to strip from the URL (e.g., `['utm_source', 'fbclid']`). Other parameters are preserved. Only applies when the domain does not match `stripQueryParamsForDomains`.                                                                                                                                                                 |
+| `params.stripFragments`             | Boolean  | No       | `false` | If `true`, strips URL fragments (hash, e.g., `#section`) from the URL before analysis.                                                                                                                                                                                                                                                                                     |
+| `params.iabTaxonomyFilters`         | Object   | No       |         | Per-tier filtering configuration for IAB taxonomies. Allows filtering by relevance threshold and limiting the count of categories per tier. Filters configured for `ContentTier1` and `ContentTier2` are automatically applied to IAB Content Taxonomy 1.0 when `enableOrtb25Fields` is `true`. See [IAB Taxonomy Filtering](#iab-taxonomy-filtering) section for details. |
 
 ### API Response Caching
 
 By default, the module caches API responses during the page session to optimise performance and reduce redundant API calls. This behaviour can be disabled by setting `enableCache: false` if needed for dynamic content scenarios.
 
+### OpenRTB 2.5 Category Fields
+
+The module supports populating OpenRTB 2.5 category fields with IAB Content Taxonomy 1.0 segments. This feature is enabled by default and provides additional contextual signals to bidders through standard OpenRTB fields.
+
+**Category Fields Populated:**
+
+- `ortb2.site.cat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.sectioncat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.pagecat` - Array of IAB Content Taxonomy 1.0 category IDs
+- `ortb2.site.content.cat` - Array of IAB Content Taxonomy 1.0 category IDs
+
+**Result Example:**
+
+With `enableOrtb25Fields: true`, the module injects:
+
+```javascript
+ortb2: {
+  site: {
+    // OpenRTB 2.5 category fields
+    cat: ["IAB12", "IAB12-3", "IAB12-5"],
+    sectioncat: ["IAB12", "IAB12-3", "IAB12-5"],
+    pagecat: ["IAB12", "IAB12-3", "IAB12-5"],
+    content: {
+      // OpenRTB 2.5 category field
+      cat: ["IAB12", "IAB12-3", "IAB12-5"],
+      // Standard content data
+      data: [{
+        name: "www.neuwo.ai",
+        segment: [{ id: "274" }, { id: "42" }],
+        ext: { segtax: 6 }
+      }]
+    }
+  }
+}
+```
+
 ### URL Cleaning Options
 
 The module provides optional URL cleaning capabilities to strip query parameters and/or fragments from the analysed URL before sending it to the Neuwo API. This can be useful for privacy, caching, or analytics purposes.
@@ -126,35 +157,162 @@ The module provides optional URL cleaning capabilities to strip query parameters
 
 ```javascript
 pbjs.setConfig({
-    realTimeData: {
-        auctionDelay: 500, // Value can be adjusted based on the needs
-        dataProviders: [
-            {
-                name: "NeuwoRTDModule",
-                waitForIt: true,
-                params: {
-                    neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
-                    neuwoApiToken: "<Your Neuwo API Token>",
-                    iabContentTaxonomyVersion: "3.0",
-
-                    // Option 1: Strip all query parameters from the URL
-                    stripAllQueryParams: true,
-
-                    // Option 2: Strip all query parameters only for specific domains
-                    // stripQueryParamsForDomains: ['example.com', 'another-domain.com'],
-
-                    // Option 3: Strip specific query parameters by name
-                    // stripQueryParams: ['utm_source', 'utm_campaign', 'fbclid'],
-
-                    // Optional: Strip URL fragments (hash)
-                    stripFragments: true,
-                },
-            },
-        ],
-    },
+  realTimeData: {
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
+    dataProviders: [
+      {
+        name: "NeuwoRTDModule",
+        waitForIt: true, // Recommended to be set to `true`
+        params: {
+          neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+          neuwoApiToken: "<Your Neuwo API Token>",
+          iabContentTaxonomyVersion: "2.2",
+
+          // Option 1: Strip all query parameters from the URL
+          stripAllQueryParams: true,
+
+          // Option 2: Strip all query parameters only for specific domains
+          // stripQueryParamsForDomains: ['example.com', 'another-domain.com'],
+
+          // Option 3: Strip specific query parameters by name
+          // stripQueryParams: ['utm_source', 'utm_campaign', 'fbclid'],
+
+          // Optional: Strip URL fragments (hash)
+          stripFragments: true,
+        },
+      },
+    ],
+  },
+});
+```
+
+### IAB Taxonomy Filtering
+
+The module provides optional per-tier filtering for IAB taxonomies to control the quantity and quality of categories injected into bid requests. This allows you to limit categories based on their relevance score and restrict the maximum number of categories per tier. Filtering is performed server-side, which means only the filtered categories are returned in the response. This reduces bandwidth and improves performance.
+
+**Filter Configuration:**
+
+Each tier can have two optional parameters:
+
+- `threshold` (Number): Minimum relevance score (0.0 to 1.0). Categories below this threshold are excluded.
+- `limit` (Number): Maximum number of categories to include for this tier (after filtering and sorting by relevance).
+
+**Available Tiers:**
+
+| Tier Name       | Description         | IAB Taxonomy                         |
+| :-------------- | :------------------ | :----------------------------------- |
+| `ContentTier1`  | IAB Content Tier 1  | Based on configured taxonomy version |
+| `ContentTier2`  | IAB Content Tier 2  | Based on configured taxonomy version |
+| `ContentTier3`  | IAB Content Tier 3  | Based on configured taxonomy version |
+| `AudienceTier3` | IAB Audience Tier 3 | IAB Audience Taxonomy 1.1 (segtax 4) |
+| `AudienceTier4` | IAB Audience Tier 4 | IAB Audience Taxonomy 1.1 (segtax 4) |
+| `AudienceTier5` | IAB Audience Tier 5 | IAB Audience Taxonomy 1.1 (segtax 4) |
+
+**Example with IAB taxonomy filtering:**
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    auctionDelay: 500, // Value can be adjusted based on the needs. Recommended to start with value `500`
+    dataProviders: [
+      {
+        name: "NeuwoRTDModule",
+        waitForIt: true, // Recommended to be set to `true`
+        params: {
+          neuwoApiUrl: "<Your Neuwo Edge API Endpoint URL>",
+          neuwoApiToken: "<Your Neuwo API Token>",
+          iabContentTaxonomyVersion: "2.2",
+
+          // Filter IAB taxonomies by tier
+          iabTaxonomyFilters: {
+            // Content Tier 1: Keep only the top category with at least 10% relevance
+            ContentTier1: { limit: 1, threshold: 0.1 },
+
+            // Content Tier 2: Keep top 2 categories with at least 10% relevance
+            ContentTier2: { limit: 2, threshold: 0.1 },
+
+            // Content Tier 3: Keep top 3 categories with at least 15% relevance
+            ContentTier3: { limit: 3, threshold: 0.15 },
+
+            // Audience Tier 3: Keep top 3 categories with at least 20% relevance
+            AudienceTier3: { limit: 3, threshold: 0.2 },
+
+            // Audience Tier 4: Keep top 5 categories with at least 20% relevance
+            AudienceTier4: { limit: 5, threshold: 0.2 },
+
+            // Audience Tier 5: Keep top 7 categories with at least 30% relevance
+            AudienceTier5: { limit: 7, threshold: 0.3 },
+          },
+        },
+      },
+    ],
+  },
 });
 ```
 
+**OpenRTB 2.5 Category Fields Filtering**
+
+When `iabTaxonomyFilters` are configured, the same filters applied to `ContentTier1` and `ContentTier2` are automatically applied to IAB Content Taxonomy 1.0 data used for these fields. Note that IAB Content Taxonomy 1.0 only has tiers 1 and 2, so `ContentTier3` filters are ignored for these fields.
+
+## Accessing Neuwo Data Outside Prebid.js
+
+The Neuwo RTD module enriches bid requests with contextual data that can be accessed in application code for analytics, targeting, integration with Google Ad Manager as [Publisher Provided Signals (PPS)](https://support.google.com/admanager/answer/15287325) or other purposes. The enriched data is available through Prebid.js events.
+
+### Example of Using the `bidRequested` Event
+
+Listen to the `bidRequested` event to access the enriched ORTB2 data. This event fires early in the auction lifecycle and provides direct access to the Neuwo data:
+
+```javascript
+pbjs.que.push(function () {
+  pbjs.onEvent("bidRequested", function (bidRequest) {
+    // The ortb2 data is available directly on the bidRequest
+    const ortb2 = bidRequest.ortb2;
+
+    // Extract Neuwo-specific data (from www.neuwo.ai provider)
+    const neuwoSiteData = ortb2?.site?.content?.data?.find(
+      (d) => d.name === "www.neuwo.ai"
+    );
+    const neuwoUserData = ortb2?.user?.data?.find(
+      (d) => d.name === "www.neuwo.ai"
+    );
+
+    // Extract OpenRTB 2.5 category fields (if enableOrtb25Fields is true)
+    const categoryFields = {
+      siteCat: ortb2?.site?.cat,
+      siteSectioncat: ortb2?.site?.sectioncat,
+      sitePagecat: ortb2?.site?.pagecat,
+      contentCat: ortb2?.site?.content?.cat,
+    };
+
+    // Use the data in the application
+    console.log("Neuwo Site Content:", neuwoSiteData);
+    console.log("Neuwo User Data:", neuwoUserData);
+    console.log("OpenRTB 2.5 Category Fields:", categoryFields);
+
+    // Example: Store in a global variable for later use
+    window.neuwoData = {
+      siteContent: neuwoSiteData,
+      user: neuwoUserData,
+      categoryFields: categoryFields,
+    };
+  });
+});
+```
+
+### Other Prebid.js Events
+
+The Neuwo data is also available in other Prebid.js events:
+
+| Order | Event              | Fires Once Per | Data Location                        |
+| :---- | :----------------- | :------------- | :----------------------------------- |
+| 1     | `auctionInit`      | Auction        | `auctionData.bidderRequests[].ortb2` |
+| 2     | `bidRequested`     | Bidder         | `bidRequest.ortb2`                   |
+| 3     | `beforeBidderHttp` | Bidder         | `bidRequests[].ortb2`                |
+| 4     | `bidResponse`      | Bidder         | `bidResponse.ortb2`                  |
+| 5     | `auctionEnd`       | Auction        | `auctionData.bidderRequests[].ortb2` |
+
+For more information on Prebid.js events, see the [Prebid.js Event API documentation](https://docs.prebid.org/dev-docs/publisher-api-reference/getEvents.html).
+
 ## Installation
 
 ### Step 1: Install Prebid.js
@@ -170,3 +328,5 @@ Include `neuwoRtdProvider` in build: `gulp build --modules=rtdModule,neuwoRtdPro
 ### Step 2: Set configuration
 
 Enable Neuwo Real-Time Data Module using `pbjs.setConfig` in a related Javascript context. Command example is provided in [Configuration](#configuration) section.
+
+> Version **2.2.6**

From 1710feaf0a458e5dd05d9c7b1839fdf41b2040e2 Mon Sep 17 00:00:00 2001
From: Chris Huie <3444727+ChrisHuie@users.noreply.github.com>
Date: Thu, 18 Jun 2026 07:26:06 -0600
Subject: [PATCH 654/665] Add centered Prebid.js logo to header bidding and
 Prebid.js pages (#6629)

Adds the Prebid.js logo (stored locally at assets/images/logos/) centered
at the top of four pages: Intro to Header Bidding, About Prebid.js, and the
Prebid.js components/flow video pages.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
---
 assets/images/logos/prebid-js-logo.png | Bin 0 -> 1538 bytes
 overview/intro-to-header-bidding.md    |   3 +++
 prebid/prebidjs-components-video.md    |   4 ++++
 prebid/prebidjs-flow-video.md          |   4 ++++
 prebid/prebidjs.md                     |   6 +++++-
 5 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 assets/images/logos/prebid-js-logo.png

diff --git a/assets/images/logos/prebid-js-logo.png b/assets/images/logos/prebid-js-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f6b34ad1570bf07a93e42aa254b6e459493e617
GIT binary patch
literal 1538
zcmZXUdpMH|9LL|Rr9`<lk#<zfB_g@sqRkRx%n(gFnz@BE#zsiTj7&~eE|K<@aybae
zHOjh~@{HUvw<520kYnjMj<dt_oag*;&hz}9&-49!|M>m+W#Qehax!W%00782pG12C
zz!vdF#&3shaQHXcra0nVy)f8lSJm<<#KS4oiYdfKD4*I;NffZbe@_y+sdGU<Ix9&M
z33Ph`l8b;O8ju8U_C(DO;Knx<s;3(PIHd5}CW5=Zh#zKVK1N878o4yIT+pg~4*+mK
zXS9P?{D*nrsQ0Lqe9DvnlGnhaJwLCXjXmK}Ymlw->0Ws1_r#eBeoU6cB9{!?u6b47
z@ju9r7|3!`iSVevVi}cghxIvSVq_BzE;>wf*!6`_x+8drto+wYD0nqVN7p*=;cTo-
zhe1mj97Sdd5{&PnCFO=g3_}{Y+{S_IJuUAnv|a;i_&S1QE`RQ+XdJr7?_jfAx)qaJ
zZ?#s}T3a<!oRBvlcVZkGi430JbGmyS%Ba=&xXeA+-LeZY#&kCeEkws7s&L62GRJp}
zD0%eMH<@ASv*6CAJsN3QVp=ICzj^+{bKKalQZ8+exs%W5w0TfpbRg-gG3s=GIJXNi
z17&SVaaFm(n*Xfbf17Yd{G%;y-*bdLBbI0}F^oD7E<37^h4}S(KXbVKL=S{+pv^-S
z#^Nieaz*8wQwS1fCG2`mWMciJ5sh|>F9{aud{HR)q)wO4@|sJantqFREj<;aL}G;9
zAAoLJB~Zj%R_>I1_qT?TgnjMS;*0xj%?G525wRE;D<?q8IL?X2yBIAyd&^#(G<8`_
zey7$>7WsNt3$Rk^q}5rBIj=5ewNY_Qm=y^au|?NF#xxg851?Yr$Fc4)$#KgC3qIV+
z)rcd0MBweOI=2kzR9!9H4IX;;d`gr39}VGz$>O7Ci~~QnR)-5n_PLb}rbwC62i=^=
zj~a#0qZLm=Tn<UB_+U%fg6Cp3yJs!I_+6KA9+3f7>V_zdJ<leWb;a4ani5)9^z^6#
zITJwm4$7?9dMW;T^O~rF{}fV1yt1rkk_h)p!_+EfoJlG;j);r8+?htPYQ|57jJs6^
zte|}ckJ#Tfp*5#@kynDwDU8*fOGJ?BVLc1IVwRi3v)rmXb5RqP{q<{WC~To~ZANu|
zs$pX7oufpH9JW!xi%zqaS!td$WsyU>`}$CIqk2YDMoG~p{v<bi62+=u1#E-Gp?ymH
z?A{311E^7f3S-ZCeHlohySrC`wpDdiURjbr6W{9}YIkh`b{H&rEBM5Q!eJ{DWRqOF
zGq=dW0*0eLwxk!D_xMkYBklS}*XCZl465l0khICQ<wZGtFF&rX(VXgG(qq%Ygxlu7
zUV@on-GwKVM`$}cnM<?BsH@&o4H-Z^X-z3QGt%|@(4SiV=cRwRz%E(+9<9>XmYC8N
zZ<*azvWOYFQ|B`H{$m<M(9EHMl$D4cl9;z!bwJMu+~$9?H0Ss7fOoKoGYlkp(XYut
z+#OSMbQH5&m~uQVPkY<L7C8KHEuL$mw-!Qu(aYqdox0eIhr65i$RQ?to*c_8$!IWm
z3;M@KHMZ*wDXt5k>uY;~bl3Cwkn%5%c+Gx<G>LjL3#IDf;oYx8PvT5_Az)E`7bsQ*
zQk>kZMrqJoKftbaI_Ati0_H>}i(TT^1*Q7#pGCz{4M$en6JZ_WeD5I?R@$YiNtZ6A
zZFO}KL*v!O4z+FX7++u>K<4aX`G%bk%SKS6Cs^#uU!jA2GK?PNx#{+s4=_j{cN|qa
z`y~g`BD|`>JOPodvb;;tz%1X15>KaYFQHen78Fg7N+F8vhl<JE-GhVtuU)U+%nx8e
zSeY3^cD<04AuKkuqjxNYiKWa|By^%<nOh#^+{E6q7~h%1pE{2hQCPQA)n_WV0^Z9V
z!#p1~ZF1uy3?R~n+1@Byusc$uSJZBUS;|ok>bF)`uIdW3Z}g~zr$;7#vTbdl3mt-@
kB$m2{|DVEtmXW6|+0w4hbi%bYZjL(OjB!I(I|g3)8)nkqx&QzG

literal 0
HcmV?d00001

diff --git a/overview/intro-to-header-bidding.md b/overview/intro-to-header-bidding.md
index ddebe6e639..d4fcd0ffae 100644
--- a/overview/intro-to-header-bidding.md
+++ b/overview/intro-to-header-bidding.md
@@ -6,6 +6,9 @@ description: An beginner's guide to header bidding.
 sidebarType: 0
 ---
 
+<div style="text-align: center;">
+  <img src="/assets/images/logos/prebid-js-logo.png" alt="Prebid.js Logo" width="500" height="80" style="max-width: 100%; height: auto;" />
+</div>
 
 # Introduction to Header Bidding
 
diff --git a/prebid/prebidjs-components-video.md b/prebid/prebidjs-components-video.md
index 7cba372518..8ef15b7cfe 100644
--- a/prebid/prebidjs-components-video.md
+++ b/prebid/prebidjs-components-video.md
@@ -5,6 +5,10 @@ description: A video overview of Prebid.js Components
 sidebarType: 1
 ---
 
+<div style="text-align: center;">
+  <img src="/assets/images/logos/prebid-js-logo.png" alt="Prebid.js Logo" width="500" height="80" style="max-width: 100%; height: auto;" />
+</div>
+
 # A Video Overview of Prebid.js Components
 
 An explanation of Prebid.js’ components and a guide to using Prebid.js reference documentation.
diff --git a/prebid/prebidjs-flow-video.md b/prebid/prebidjs-flow-video.md
index 046002b9a9..9d85dac220 100644
--- a/prebid/prebidjs-flow-video.md
+++ b/prebid/prebidjs-flow-video.md
@@ -5,6 +5,10 @@ description: A video overview of a Prebid.js Auction
 sidebarType: 1
 ---
 
+<div style="text-align: center;">
+  <img src="/assets/images/logos/prebid-js-logo.png" alt="Prebid.js Logo" width="500" height="80" style="max-width: 100%; height: auto;" />
+</div>
+
 # A Video Walkthrough of a Typical Prebid.js Auction
 
 A step-by-step walkthrough of a typical Prebid.js auction.
diff --git a/prebid/prebidjs.md b/prebid/prebidjs.md
index 840091ce64..2e7182b293 100644
--- a/prebid/prebidjs.md
+++ b/prebid/prebidjs.md
@@ -6,7 +6,11 @@ description: An overview of Prebid.js
 sidebarType: 1
 
 ---
- 
+
+<div style="text-align: center;">
+  <img src="/assets/images/logos/prebid-js-logo.png" alt="Prebid.js Logo" width="500" height="80" style="max-width: 100%; height: auto;" />
+</div>
+
 # What is Prebid.js?
 
 Prebid.js is a feature-rich header bidding platform for the web, including more than 300 demand sources and 50 analytics adapters. It supports currency conversion, GDPR, common ID systems, and multiple ad servers.

From 823a230300ac678e8b589a20f00f25dd13a97116 Mon Sep 17 00:00:00 2001
From: bTimor <btimor.dev@gmail.com>
Date: Mon, 22 Jun 2026 10:57:38 +0300
Subject: [PATCH 655/665] [Update] Add Prebid Server support for Scalibur
 bidder (#6381)

* Add Prebid Server support for Scalibur adapte

* ..

* fix lint comments

---------

Co-authored-by: Timor Bibi <timor@Timors-MacBook-Pro-2.local>
---
 dev-docs/bidders/scalibur.md | 50 ++++++++++++++++++++++++++----------
 1 file changed, 36 insertions(+), 14 deletions(-)

diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md
index 85623a597d..eb915c8918 100644
--- a/dev-docs/bidders/scalibur.md
+++ b/dev-docs/bidders/scalibur.md
@@ -14,7 +14,7 @@ deals_supported: false
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbs: false
+pbs: true
 prebid_member: false
 multiformat_supported: will-bid-on-any
 ortb_blocking_supported: false
@@ -24,19 +24,21 @@ pbs_app_supported: false
 
 The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertising platform. It supports both banner and video ad formats through OpenRTB 2.x protocol and provides full compliance with privacy regulations.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 
 | Name | Scope | Type | Description | Example |
 | ---- | ----- | ---- | ----------- | ------- |
 | `placementId` | required | String | Placement identifier provided by Scalibur | `'test-placement-123'` |
+| `bidfloor` | optional | Float | Fallback minimum CPM for the impression | `0.50` |
+| `bidfloorcur` | optional | String | Currency for the bid floor | `'USD'` |
 
-### Test Parameters
+## Test Parameters
 
 For testing purposes, you can use the following ad unit configurations:
 
-#### Banner Ad Unit
+### Banner Ad Unit
 
 ```javascript
 var adUnits = [
@@ -59,7 +61,7 @@ var adUnits = [
 ];
 ```
 
-#### Video Ad Unit
+### Video Ad Unit
 
 ```javascript
 var adUnits = [
@@ -90,7 +92,7 @@ var adUnits = [
 ];
 ```
 
-#### Multi-format Ad Unit
+### Multi-format Ad Unit
 
 ```javascript
 var adUnits = [
@@ -121,7 +123,26 @@ var adUnits = [
 ];
 ```
 
-### First Party Data
+## Prebid Server Configuration (S2S)
+
+Scalibur supports Server-to-Server bidding through Prebid Server. To enable this, include `scalibur` in your `s2sConfig`.
+
+```javascript
+pbjs.setConfig({
+    s2sConfig: {
+        endpoint: 'https://prebid-server.example.com/openrtb2/auction',
+        enabled: true,
+        bidders: ['scalibur'],
+        timeout: 1000
+    }
+});
+```
+
+## Video Support
+
+The adapter supports Video via both direct VAST XML and VAST URLs. For bids returned with a VAST URL, the server-side adapter automatically generates a VAST 3.0 wrapper to ensure player compatibility.
+
+## First Party Data
 
 The adapter supports First Party Data (FPD) in multiple ways:
 
@@ -129,16 +150,16 @@ The adapter supports First Party Data (FPD) in multiple ways:
 - **AdUnit FPD**: Includes ad unit specific `ortb2Imp` data
 - **Local Storage**: Generates and stores first-party identifiers for enhanced targeting
 
-### User Sync
+## User Sync
 
-The Scalibur adapter supports user synchronization through:
+The Scalibur adapter supports user synchronization to maximize bid value:
 
-- **Iframe syncs**: For enhanced matching capabilities
-- **Image syncs**: For lightweight synchronization
+- **Client-Side**: Supports `iframe` and `image` syncs.
+- **Server-Side**: Uses `iframe` sync managed via Prebid Server's `/cookie_sync` and `/setuid` endpoints.
 
 All privacy parameters are automatically included in sync requests.
 
-#### Configuration Example
+### Configuration Example
 
 ```javascript
 pbjs.que.push(function() {
@@ -169,15 +190,16 @@ pbjs.que.push(function() {
 });
 ```
 
-### Support
+## Support
 
 For technical support or integration assistance:
 
 - **Email**: [support@scalibur.io](mailto:support@scalibur.io)
 - **Documentation**: Contact Scalibur Support Team
 
-### Notes
+## Notes
 
+- **Multi-format**: Fully supports multi-format ad units by utilizing the `mtype` field in the OpenRTB response.
 - Video ads support instream context with standard IAB video parameters
 - Banner ads support multiple sizes including standard IAB sizes
 - All requests are sent via secure HTTPS endpoints

From 8125d367e50f6236af52a032444bf32076240669 Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Mon, 22 Jun 2026 13:58:39 +0200
Subject: [PATCH 656/665] Limelight New Adapter: Nuclion (#6542)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* new adapter Nuclion

* fix lint errors

* Update dev-docs/bidders/nuclion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/nuclion.md | 41 +++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 dev-docs/bidders/nuclion.md

diff --git a/dev-docs/bidders/nuclion.md b/dev-docs/bidders/nuclion.md
new file mode 100644
index 0000000000..64bc490702
--- /dev/null
+++ b/dev-docs/bidders/nuclion.md
@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Nuclion
+description: Prebid Nuclion Bidder Adaptor
+biddercode: nuclion
+pbjs: true
+pbs: false
+media_types: video, banner
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description                                         | Example              | Type      |
+|---------------|----------|-----------------------------------------------------|----------------------|-----------|
+| `host`        | required | Ad network's RTB host                               | `'rtb-nuclion.io'`   | `string`  |
+| `adUnitId`    | required | Ad Unit Id will be generated on Nuclion Platform.   | `42`                 | `integer` |
+| `adUnitType`  | required | Type of Ad Unit (`'video'`, `'banner'`)             | `'banner'`           | `string`  |
+| `publisherId` | required | Publisher ID                                        | `12345`              | `integer` |
+| `custom1`     | optional | Custom targeting field 1                            | `'custom1'`          | `string`  |
+| `custom2`     | optional | Custom targeting field 2                            | `'custom2'`          | `string`  |
+| `custom3`     | optional | Custom targeting field 3                            | `'custom3'`          | `string`  |
+| `custom4`     | optional | Custom targeting field 4                            | `'custom4'`          | `string`  |
+| `custom5`     | optional | Custom targeting field 5                            | `'custom5'`          | `string`  |
+
+Nuclion server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Nuclion client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Nuclion server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Nuclion client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From 1ee7db4056b901da9bfb597dc2221b2a0f3595bf Mon Sep 17 00:00:00 2001
From: quietPusher <129727954+quietPusher@users.noreply.github.com>
Date: Mon, 22 Jun 2026 13:58:56 +0200
Subject: [PATCH 657/665] Limelight: New Adapter Datafusion (#6624)

* Remove required host from Limelight prebid server adapters

* revert changes

* revert changes

* new adapter Datafusion

* Update dev-docs/bidders/datafusion.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

---------

Co-authored-by: apykhteyev <alex@project-limelight.com>
Co-authored-by: belousovdmitry <belousov.dmitry92@gmail.com>
Co-authored-by: maksimD24 <129727954+maksimD24@users.noreply.github.com>
Co-authored-by: mderevyanko <mderevyanko24@gmail.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/datafusion.md | 38 ++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 dev-docs/bidders/datafusion.md

diff --git a/dev-docs/bidders/datafusion.md b/dev-docs/bidders/datafusion.md
new file mode 100644
index 0000000000..c4a6ee4278
--- /dev/null
+++ b/dev-docs/bidders/datafusion.md
@@ -0,0 +1,38 @@
+---
+layout: bidder
+title: Datafusion
+description: Prebid Datafusion Adaptor
+biddercode: datafusion
+pbjs: true
+pbs: false
+media_types: banner, video, audio, native
+userIds: all
+fpd_supported: false
+tcfeu_supported: false
+usp_supported: true
+coppa_supported: true
+schain_supported: true
+prebid_member: false
+ortb_blocking_supported: true
+multiformat_supported: will-bid-on-one
+floors_supported: false
+aliasCode: limelightDigital
+sidebarType: 1
+---
+
+## Note
+
+The Datafusion adapter requires setup before beginning.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+
+| Name          | Scope    | Description           | Example                  | Type      |
+|:--------------|:---------|:----------------------|:-------------------------|:----------|
+| `host`        | required | Ad network's RTB host | `'ssp-data-fusion.bid'`  | `string`  |
+| `publisherId` | required | Publisher ID          | `12345`                  | `integer` |
+
+Prebid Datafusion server-side Prebid Server adapter requires only `publisherId` and `host` parameters. But Prebid Datafusion client-side Prebid.js adapter requires only `host`, `adUnitId`, `adUnitType`.
+
+Prebid Datafusion server-side Prebid Server adapter supports only `banner`, `video`, `audio`, `native` media types. But Prebid Datafusion client-side Prebid.js adapter supports only `banner` and `video` media types, doesn't support `audio` and `native`.

From a57be92d1f9e0d9efb8944d1e78367d7a6e55863 Mon Sep 17 00:00:00 2001
From: jasonc721 <jasonc721@gmail.com>
Date: Tue, 23 Jun 2026 09:25:36 -0600
Subject: [PATCH 658/665] Updating the site to begin the Appnexus adpater
 (#6627)

* Updating the site to begin the Appnexus adpater
decpreatction and to rename elements to Microsoft.

* Updated files based on PR feedback

* updated files based on comments.

* Removed references to defaultvendor.

* Updating files based on PR feedback.

* one last file to update for the PR.

---------

Co-authored-by: Jason Crane <jasoncrane@microsoft.com>
---
 .devcontainer/devcontainer.json               |  9 ++-
 .gitignore                                    |  2 +
 _data/sidebar.yml                             |  4 +-
 _includes/send-all-bids-keyword-targeting.md  | 10 +--
 _includes/video/head.html                     |  4 +-
 _includes/video/pb-is-jw01.html               |  4 +-
 _includes/video/pb-is-jw02.html               |  4 +-
 _includes/video/pb-is-vjs.html                |  4 +-
 _includes/video/pb-lf-fw.html                 |  4 +-
 _includes/video/pb-os-dfp.html                |  4 +-
 _includes/video/pb-os-nas-renderer.html       |  4 +-
 _includes/video/pb-os-nas.html                |  4 +-
 adops/ad-server-integration.md                |  2 +-
 adops/adops-general-sbs.md                    |  2 +-
 adops/before-you-start.md                     |  2 +-
 ...g-up-prebid-with-the-appnexus-ad-server.md |  6 +-
 assets/js/video/pb-is-jw-01.js                |  4 +-
 assets/js/video/pb-ve-jwplayer-platform-h.js  |  4 +-
 deprecated/old_index_md_content.html          |  4 +-
 dev-docs/adunit-reference.md                  | 32 ++++-----
 dev-docs/analytics-ga.md                      | 18 ++---
 dev-docs/analytics/intentiq.md                |  2 +-
 dev-docs/bidder-adaptor.md                    | 12 ++--
 dev-docs/bidders/appnexus.md                  |  5 +-
 dev-docs/bidders/msft.md                      | 66 ++++++++++---------
 dev-docs/bidders/zmaticoo.md                  | 36 +++++-----
 dev-docs/examples/adunit-refresh.md           |  4 +-
 dev-docs/examples/basic-example.md            |  4 +-
 dev-docs/examples/custom-price-buckets.md     |  4 +-
 dev-docs/examples/instream-banner-mix.md      | 12 ++--
 .../examples/intercept-banner-not-for-prod.js |  2 +-
 dev-docs/examples/meta-bid-filtering.md       |  4 +-
 dev-docs/examples/native-ad-example.md        |  8 +--
 dev-docs/examples/no-adserver.md              |  8 +--
 dev-docs/examples/postbid.md                  |  4 +-
 dev-docs/examples/size-mapping.md             |  4 +-
 dev-docs/examples/sync-tid.md                 |  4 +-
 ...=> use-prebid-with-microsoft-ad-server.md} |  8 +--
 dev-docs/modules/1plusXRtdProvider.md         | 20 +++---
 dev-docs/modules/51DegreesRtdProvider.md      |  4 +-
 dev-docs/modules/adpod.md                     | 14 ++--
 dev-docs/modules/airgridRtdProvider.md        | 12 ++--
 dev-docs/modules/anonymisedRtdProvider.md     |  2 +-
 dev-docs/modules/blueconicRtdProvider.md      | 10 +--
 dev-docs/modules/captifyRtdProvider.md        | 20 +++---
 dev-docs/modules/contxtfulRtdProvider.md      | 16 ++---
 dev-docs/modules/dgkeywordRtdProvider.md      | 14 ++--
 dev-docs/modules/genericAnalyticsAdapter.md   | 26 ++++----
 dev-docs/modules/geoedgeRtdProvider.md        |  2 +-
 dev-docs/modules/growthCodeRtdProvider.md     |  2 +-
 dev-docs/modules/hadronRtdProvider.md         |  4 +-
 dev-docs/modules/konduit.md                   |  2 +-
 dev-docs/modules/oftmediaRtdProvider.md       |  2 +-
 dev-docs/modules/optableRtdProvider.md        |  4 +-
 dev-docs/modules/optimeraRtdProvider.md       |  2 +-
 dev-docs/modules/oxxionRtdProvide.md          |  2 +-
 dev-docs/modules/permutiveRtdProvider.md      |  2 +-
 dev-docs/modules/prebidServer.md              | 45 ++++++-------
 dev-docs/modules/pubCommonId.md               |  2 +-
 dev-docs/modules/raveltechRtdProvider.md      |  4 +-
 dev-docs/modules/raynRtdProvider.md           |  4 +-
 dev-docs/modules/relevadRtdProvider.md        |  4 +-
 dev-docs/modules/s2sTesting.md                |  2 +-
 dev-docs/modules/scope3RtdProvider.md         |  4 +-
 dev-docs/modules/sirdataRtdProvider.md        | 10 +--
 dev-docs/modules/symitriDapRtdProvider.md     |  2 +-
 dev-docs/modules/weboramaRtdProvider.md       | 28 ++++----
 dev-docs/modules/wurflRtdProvider.md          |  4 +-
 dev-docs/plugins/bc/about-bc-prebid-plugin.md |  6 +-
 dev-docs/plugins/bc/bc-prebid-plugin-api.md   |  4 +-
 .../bc-prebid-plugin-integration-dynamic.md   | 12 ++--
 .../bc/bc-prebid-plugin-integration-studio.md | 12 ++--
 .../bc/bc-prebid-plugin-multiad-options.md    | 20 +++---
 .../bc/bc-prebid-plugin-prebid-options.md     |  6 +-
 .../bc/bc-prebid-plugin-sample-prebid-body.md |  6 +-
 .../bc-prebid-plugin-sample-prebid-header.md  |  6 +-
 ...ample-studio-integration-general-method.md |  4 +-
 ...bid-plugin-sample-third-party-ad-server.md | 12 ++--
 .../cross-player-config.md                    | 16 ++---
 .../publisher-api-reference/addAdUnits.md     | 24 +++----
 .../publisher-api-reference/aliasBidder.md    |  8 +--
 .../publisher-api-reference/bidderSettings.md | 12 ++--
 .../getAdserverTargeting.md                   |  6 +-
 .../getAdserverTargetingForAdUnitCodeStr.md   |  2 +-
 .../getBidResponses.md                        | 14 ++--
 dev-docs/publisher-api-reference/setConfig.md | 18 ++---
 .../setTargetingForAst.md                     |  2 +-
 dev-docs/renderer.md                          |  4 +-
 .../tcf2/PrebidSupportforEnforcingTCF2.html   |  2 +-
 dev-docs/show-long-form-video-with-gam.md     |  8 +--
 dev-docs/show-native-ads.md                   | 12 ++--
 dev-docs/show-outstream-video-ads.md          |  4 +-
 dev-docs/show-prebid-ads-on-amp-pages.md      |  4 +-
 dev-docs/show-video-with-a-dfp-video-tag.md   | 10 +--
 docs-examples/web-example.md                  |  4 +-
 .../jwplayer/pb-ve-jwplayer-hosted.html       |  4 +-
 .../jwplayer/pb-ve-jwplayer-platform.html     |  4 +-
 .../video/instream/videojs/pb-ve-videojs.html |  4 +-
 .../long-form-video-with-freewheel.html       |  8 +--
 .../video/long-form/pb-ve-lf-freewheel.html   |  4 +-
 examples/video/outstream/basic-ima.html       |  4 +-
 .../video/outstream/pb-ve-outstream-dfp.html  |  4 +-
 ...-outstream-no-server-specify-renderer.html |  6 +-
 overview/how-to-simplify-line-item-setup.md   | 12 ++--
 overview/prebid-universal-creative.md         |  4 +-
 overview/what-is-prebid-org.md                |  2 +-
 prebid-mobile/dr-prebid.md                    |  2 +-
 .../android/code-integration-android.md       |  2 +-
 .../pbm-api/ios/code-integration-ios.md       |  2 +-
 prebid-server/developers/add-a-module-go.md   |  4 +-
 prebid-server/developers/add-new-bidder-go.md |  4 +-
 .../endpoints/info/pbs-endpoint-info.md       |  4 +-
 .../endpoints/openrtb2/pbs-endpoint-amp.md    | 10 +--
 .../openrtb2/pbs-endpoint-auction.md          | 18 ++---
 .../endpoints/openrtb2/pbs-endpoint-video.md  |  8 +--
 prebid-server/features/pbs-default-request.md |  2 +-
 prebid-server/features/pbs-storedreqs-go.md   |  4 +-
 prebid-server/features/pbs-storedreqs-java.md |  4 +-
 .../pbs-modules/greenbids-real-time-data.md   |  2 +-
 prebid-server/use-cases/pbs-amp.md            |  2 +-
 prebid-server/use-cases/pbs-sdk.md            |  2 +-
 prebid-video/video-integrating-solo.md        |  6 +-
 prebid-video/video-long-form.md               |  6 +-
 tools/line-item-manager.md                    |  4 +-
 troubleshooting/troubleshooting-guide.md      |  4 +-
 125 files changed, 487 insertions(+), 484 deletions(-)
 rename dev-docs/examples/{use-prebid-with-appnexus-ad-server.md => use-prebid-with-microsoft-ad-server.md} (95%)

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index f18a02c5d7..1b3d6e8735 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,5 +1,11 @@
+
 {
   "image": "mcr.microsoft.com/devcontainers/jekyll:2",
+  "features": {
+    "ghcr.io/devcontainers/features/ruby:1": {
+      "version": "2.7.6"
+    }
+  },
   "customizations": {
     "vscode": {
       "extensions": [
@@ -8,4 +14,5 @@
       ]
     }
   }
-}
\ No newline at end of file
+}
+
diff --git a/.gitignore b/.gitignore
index 3c50b583af..2d9ea0d194 100755
--- a/.gitignore
+++ b/.gitignore
@@ -17,3 +17,5 @@ node_modules/
 /.vs/prebid.github.io/v17/.suo
 /.vs/slnx.sqlite
 /.vs
+.devcontainer/devcontainer.json
+.devcontainer/devcontainer-lock.json
diff --git a/_data/sidebar.yml b/_data/sidebar.yml
index deaa1c05f1..2aa172f834 100644
--- a/_data/sidebar.yml
+++ b/_data/sidebar.yml
@@ -267,7 +267,7 @@
 
 - sbSecId: 1
   title: Using Prebid.js with Microsoft Monetize Ad Server
-  link: /dev-docs/examples/use-prebid-with-appnexus-ad-server.html
+  link: /dev-docs/examples/use-prebid-with-microsoft-ad-server.html
   isHeader: 0
   isSectionHeader: 0
   sectionTitle:
@@ -1230,7 +1230,7 @@
 
 - sbSecId: 3
   title: 'Setting up Prebid'
-  link: /adops/setting-up-prebid-with-the-appnexus-ad-server.html
+  link: /adops/setting-up-prebid-with-the-microsoft-ad-server.html
   isHeader: 0
   isSectionHeader: 0
   sectionTitle:
diff --git a/_includes/send-all-bids-keyword-targeting.md b/_includes/send-all-bids-keyword-targeting.md
index 2ba6d4d662..59c392dd81 100644
--- a/_includes/send-all-bids-keyword-targeting.md
+++ b/_includes/send-all-bids-keyword-targeting.md
@@ -4,8 +4,8 @@
 
 {: .table .table-bordered .table-striped }
 
-| Default Key   | Scope    | Description | Example |
-| :----         | :----    | :----       | :----   |
-| `hb_pb_BIDDERCODE`       | Required | The price bucket. Used by the line item to target. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_pb_rubicon` = `2.10` |
-| `hb_adid_BIDDERCODE`     | Required | The ad Id. Used by the ad server creative to render ad. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_adid_longBidderNa` = `234234` |
-| `hb_size_BIDDERCODE`   | Optional | This is not required for adops. Case sensitive and truncated to 20 chars. | `hb_size_appnexus` = `300x250` |
+| Default Key | Scope | Description | Example |
+| :--- | :--- | :--- | :--- |
+| `hb_pb_BIDDERCODE` | Required | The price bucket. Used by the line item to target. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_pb_rubicon` = `2.10` |
+| `hb_adid_BIDDERCODE` | Required | The ad Id. Used by the ad server creative to render ad. Case sensitive and truncated to 20 chars. The `BIDDERCODE` is documented at [Bidder Params](/dev-docs/bidders.html). | `hb_adid_longBidderNa` = `234234` |
+| `hb_size_BIDDERCODE` | Optional | This is not required for adops. Case sensitive and truncated to 20 chars. | `hb_size_bidderA` = `300x250` |
diff --git a/_includes/video/head.html b/_includes/video/head.html
index 4db1051913..046188be11 100644
--- a/_includes/video/head.html
+++ b/_includes/video/head.html
@@ -33,9 +33,9 @@
 			  },
 			  bids: [
 			    {
-			      bidder: 'appnexusAst',
+			      bidder: 'msft',
 			      params: {
-			        placementId: '13232361', // Add your own placement id here
+			        placement_id: '13232361', // Add your own placement id here
 			        video: {
 			          skipppable: true,
 			          playback_method: ['auto_play_sound_off']
diff --git a/_includes/video/pb-is-jw01.html b/_includes/video/pb-is-jw01.html
index eeab1a3ddc..9fd27f788c 100644
--- a/_includes/video/pb-is-jw01.html
+++ b/_includes/video/pb-is-jw01.html
@@ -30,9 +30,9 @@
             },
             bids: [
               {
-                bidder: "appnexus",
+                bidder: "msft",
                 params: {
-                  placementId: 13232361, // Add your own placement id here
+                  placement_id: 13232361, // Add your own placement id here
                 },
               },
             ],
diff --git a/_includes/video/pb-is-jw02.html b/_includes/video/pb-is-jw02.html
index 9b8dba6793..cc536cfd7f 100644
--- a/_includes/video/pb-is-jw02.html
+++ b/_includes/video/pb-is-jw02.html
@@ -29,9 +29,9 @@
             },
             bids: [
               {
-                bidder: "appnexus",
+                bidder: "msft",
                 params: {
-                  placementId: 13232361, // Add your own placement id here
+                  placement_id: 13232361, // Add your own placement id here
                 },
               },
             ],
diff --git a/_includes/video/pb-is-vjs.html b/_includes/video/pb-is-vjs.html
index ef411b5bfe..b3ad01aeae 100644
--- a/_includes/video/pb-is-vjs.html
+++ b/_includes/video/pb-is-vjs.html
@@ -41,9 +41,9 @@
             },
             bids: [
               {
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                  placementId: 13232361,
+                  placement_id: 13232361,
                 },
               },
             ],
diff --git a/_includes/video/pb-lf-fw.html b/_includes/video/pb-lf-fw.html
index b40c5d204d..ed011379f4 100644
--- a/_includes/video/pb-lf-fw.html
+++ b/_includes/video/pb-lf-fw.html
@@ -82,9 +82,9 @@
         },
         bids: [
           {
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-              placementId: 14542875
+              placement_id: 14542875
             }
           }
         ]
diff --git a/_includes/video/pb-os-dfp.html b/_includes/video/pb-os-dfp.html
index bc7fe61309..84b52e0111 100644
--- a/_includes/video/pb-os-dfp.html
+++ b/_includes/video/pb-os-dfp.html
@@ -28,9 +28,9 @@
           },
           bids: [
             {
-              bidder: "appnexus",
+              bidder: "msft",
               params: {
-                placementId: 13232385,
+                placement_id: 13232385,
               },
             },
           ],
diff --git a/_includes/video/pb-os-nas-renderer.html b/_includes/video/pb-os-nas-renderer.html
index a73741d997..9ac21cba98 100644
--- a/_includes/video/pb-os-nas-renderer.html
+++ b/_includes/video/pb-os-nas-renderer.html
@@ -67,9 +67,9 @@
                     }
                 },
                 bids: [{
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 13232385
+                        placement_id: 13232385
                     }
                 }]
             }];
diff --git a/_includes/video/pb-os-nas.html b/_includes/video/pb-os-nas.html
index 533197b79b..0c46ae7a14 100644
--- a/_includes/video/pb-os-nas.html
+++ b/_includes/video/pb-os-nas.html
@@ -24,9 +24,9 @@
           },
           bids: [
             {
-              bidder: "appnexus",
+              bidder: "msft",
               params: {
-                placementId: 13232385,
+                placement_id: 13232385,
               },
             },
           ],
diff --git a/adops/ad-server-integration.md b/adops/ad-server-integration.md
index 28afb7b10a..6ffee38d65 100644
--- a/adops/ad-server-integration.md
+++ b/adops/ad-server-integration.md
@@ -49,7 +49,7 @@ We don’t currently have details on specific header bidding support in other ad
 
 For step-by-step instructions on using some of the other ad servers, see the following documentation:
 
-- [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-appnexus-ad-server.html)
+- [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-microsoft-ad-server.html)
 - [Smart Ad Server](/adops/setting-up-prebidjs-with-Smart-Ad-Server.html)
 - [FreeWheel](/adops/setting-up-prebid-video-in-freewheel.html)
 
diff --git a/adops/adops-general-sbs.md b/adops/adops-general-sbs.md
index 369b71de20..577e3e49df 100644
--- a/adops/adops-general-sbs.md
+++ b/adops/adops-general-sbs.md
@@ -18,7 +18,7 @@ sidebarType: 3
 Prebid.org provides step-by-step instructions for manually configuring Prebid in the following ad servers:
 
 * [Google Ad Manager](/adops/step-by-step.html)
-* [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-appnexus-ad-server.html)
+* [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-microsoft-ad-server.html)
 * [Freewheel](/adops/setting-up-prebid-video-in-freewheel.html)
 * [Smart Ad Server](/adops/setting-up-prebidjs-with-Smart-Ad-Server.html)
 
diff --git a/adops/before-you-start.md b/adops/before-you-start.md
index 056e917932..3fa9404251 100644
--- a/adops/before-you-start.md
+++ b/adops/before-you-start.md
@@ -22,7 +22,7 @@ When the ad request arrives at the ad server, the ad server reads the targeting
 After you’ve completed your planning, move on to the appropriate setup documentation for your ad server.
 
 - [Google Ad Manager](/adops/step-by-step.html)
-- [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-appnexus-ad-server.html)
+- [Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-microsoft-ad-server.html)
 - [Smart Ad Server](/adops/setting-up-prebidjs-with-Smart-Ad-Server.html)
 - [FreeWheel](/adops/setting-up-prebid-video-in-freewheel.html)
 
diff --git a/adops/setting-up-prebid-with-the-appnexus-ad-server.md b/adops/setting-up-prebid-with-the-appnexus-ad-server.md
index cfff8b85d0..7c1885657d 100644
--- a/adops/setting-up-prebid-with-the-appnexus-ad-server.md
+++ b/adops/setting-up-prebid-with-the-appnexus-ad-server.md
@@ -18,7 +18,7 @@ This page describes how to set up the Microsoft Monetize Ad Server to work with
 
 In some cases there are links to the [Microsoft Help Center](https://docs.xandr.com/).
 
-Once the Ad Ops setup is complete, developers will need to add code to the page as shown in the example [Using Prebid.js with Microsoft Monetize as your Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html).
+Once the Ad Ops setup is complete, developers will need to add code to the page as shown in the example [Using Prebid.js with Microsoft Monetize as your Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-microsoft-ad-server.html).
 
 {: .alert.alert-success :}
 **Microsoft Monetize Ad Server Features**  
@@ -107,7 +107,7 @@ Note that creatives are automatically marked as inactive by the Microsoft Moneti
 
 {: .alert.alert-warning :}
 **SafeFrame**
-If you want your creative to serve into a SafeFrame, this will need to be enabled on the site-side of the Prebid.js implementation rather than as a setting in the ad server.  A developer can learn how to enable this setting for the publisher by referencing [Using Prebid.js with Microsoft Monetize Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html).  Additionally if the Microsoft Monetize Ad Server tags are configured to use SafeFrames, you **will** need to use the above creative template to properly render the creative.  Earlier versions of the Prebid.js creative template may not be fully SafeFrame compliant (if they are still in-use from older setups), so it is recommended to switch to the above template in this scenario.
+If you want your creative to serve into a SafeFrame, this will need to be enabled on the site-side of the Prebid.js implementation rather than as a setting in the ad server.  A developer can learn how to enable this setting for the publisher by referencing [Using Prebid.js with Microsoft Monetize Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-microsoft-ad-server.html).  Additionally if the Microsoft Monetize Ad Server tags are configured to use SafeFrames, you **will** need to use the above creative template to properly render the creative.  Earlier versions of the Prebid.js creative template may not be fully SafeFrame compliant (if they are still in-use from older setups), so it is recommended to switch to the above template in this scenario.
 
 ## Step 4. Set up Insertion Order
 
@@ -163,4 +163,4 @@ It will also make it easy to turn the targeting on and off for a given placement
 * [Ad Ops and Prebid](/adops/before-you-start.html)
 * [Ad Ops Planning Guide](/adops/adops-planning-guide.html)
 * [Getting Started with Prebid.js for Developers](/dev-docs/getting-started.html)
-* [Using Prebid.js with Microsoft Monetize Ad Server](/dev-docs/examples/use-prebid-with-appnexus-ad-server.html)(Developer example)
+* [Using Prebid.js with Microsoft Monetize Ad Server](/dev-docs/examples/use-prebid-with-microsoft-ad-server.html)(Developer example)
diff --git a/assets/js/video/pb-is-jw-01.js b/assets/js/video/pb-is-jw-01.js
index 34dc298029..55a14836df 100644
--- a/assets/js/video/pb-is-jw-01.js
+++ b/assets/js/video/pb-is-jw-01.js
@@ -21,9 +21,9 @@ var videoAdUnit = {
   },
   bids: [
     {
-      bidder: 'appnexusAst',
+      bidder: 'msft',
       params: {
-        placementId: '13232361', // Add your own placement id here
+        placement_id: '13232361', // Add your own placement id here
         video: {
           skipppable: true,
           playback_method: ['auto_play_sound_off']
diff --git a/assets/js/video/pb-ve-jwplayer-platform-h.js b/assets/js/video/pb-ve-jwplayer-platform-h.js
index 299e2d4684..384ef2f6af 100644
--- a/assets/js/video/pb-ve-jwplayer-platform-h.js
+++ b/assets/js/video/pb-ve-jwplayer-platform-h.js
@@ -18,9 +18,9 @@ function loadVideoData() {
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13232361, // Add your own placement id here
+                placement_id: 13232361, // Add your own placement id here
                 video: {
                     skipppable: true,
                     playback_method: ['auto_play_sound_off']
diff --git a/deprecated/old_index_md_content.html b/deprecated/old_index_md_content.html
index cfe3a01a2d..8c639b222b 100644
--- a/deprecated/old_index_md_content.html
+++ b/deprecated/old_index_md_content.html
@@ -34,7 +34,7 @@ <h3>Notifications</h3>
       <div class="col-sm-4">
         <img src="assets/images/icons/icon-ninja.png" alt="Header bidding no dev" class="img-responsive">
         <h3>No development required</h3>
-        <p>Prebid.js includes adapters for AppNexus, Pubmatic, Rubicon Project, and many more.</p>
+        <p>Prebid.js includes adapters for Microsoft, Pubmatic, Rubicon Project, and many more.</p>
         <a href="/dev-docs/bidders.html" class="btn btn-outline">See the Full Bidder List</a>
       </div>
 
@@ -65,7 +65,7 @@ <h2 class="bs-docs-featurette-title">Partners that work with Prebid</h2>
 
     <!-- START BIDDERS -->
 
-    <div class="col-xs-6 col-sm-4"><h3>AppNexus</h3></div>
+    <div class="col-xs-6 col-sm-4"><h3>Microsoft</h3></div>
     <div class="col-xs-6 col-sm-4"><h3>OpenX</h3></div>
     <div class="col-xs-6 col-sm-4"><h3>PubMatic</h3></div>
     <div class="col-xs-6 col-sm-4"><h3>Rubicon</h3></div>
diff --git a/dev-docs/adunit-reference.md b/dev-docs/adunit-reference.md
index aee040614e..ff74b9925f 100644
--- a/dev-docs/adunit-reference.md
+++ b/dev-docs/adunit-reference.md
@@ -199,9 +199,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13144370,
+        placement_id: 13144370,
       },
     },
   ],
@@ -268,9 +268,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13232361,
+        placement_id: 13232361,
       },
     },
   ],
@@ -299,9 +299,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13232361,
+        placement_id: 13232361,
       },
     },
   ],
@@ -330,9 +330,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13232361,
+        placement_id: 13232361,
       },
     },
   ],
@@ -458,9 +458,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13232354,
+        placement_id: 13232354,
       },
     },
   ],
@@ -498,9 +498,9 @@ pbjs.addAdUnits([
     },
     bids: [
       {
-        bidder: "appnexus",
+        bidder: "msft",
         params: {
-          placementId: 13232392,
+          placement_id: 13232392,
         },
       },
     ],
@@ -519,9 +519,9 @@ pbjs.addAdUnits([
     },
     bids: [
       {
-        bidder: "appnexus",
+        bidder: "msft",
         params: {
-          placementId: 13232392,
+          placement_id: 13232392,
         },
       },
     ],
@@ -554,9 +554,9 @@ pbjs.addAdUnits([
     },
     bids: [
       {
-        bidder: "appnexus",
+        bidder: "msft",
         params: {
-          placementId: 13232392,
+          placement_id: 13232392,
         },
       },
     ],
diff --git a/dev-docs/analytics-ga.md b/dev-docs/analytics-ga.md
index e1f580e411..8d9badea6c 100644
--- a/dev-docs/analytics-ga.md
+++ b/dev-docs/analytics-ga.md
@@ -85,14 +85,14 @@ Prebid.js sends out GA-compatible [Events](https://support.google.com/analytics/
 In this example, the page has 1 ad unit with 3 bidders. The timeout is set to 400ms. Let's go through what Prebid Analytics sends out to GA:
 
 {: .table .table-bordered .table-striped }
-|    Time |    What Happened     |     GA Events Sent |
-| :----  |:--------| :-------|
-|    15ms |    Prebid.js sends out bid requests to bidders AppNexus, OpenX, and Pubmatic. | Event 1: Category=`Prebid.js Bids`, Action=`Requests`, Label=`appnexus`, Value=1.<br />Event 2: Category=`Prebid.js Bids`, Action=`Requests`, Label=`openx`, Value=1.<br />Event 3: Category=`Prebid.js Bids`, Action=`Requests`, Label=`pubmatic`, Value=1 |
-|    203ms |    AppNexus' bid came back with a CPM of $2.314 and a latency of 188ms. |    Event 1: Category=`Prebid.js Bids`, Action=`Bids`, Label=`appnexus`, Value=231.<br />Event 2: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`appnexus`, Value=188 |
-|    274ms |    Pubmatic's bid came back with a CPM of $0 and a latency of 259ms. |    No bid event sent out because it is a no bid. <br /> Event 1: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`appnexus`, Value=259 |
+| Time | What Happened | GA Events Sent |
+| :--- | :------------ | :------------- |
+| 15ms | Prebid.js sends out bid requests to bidders Microsoft, OpenX, and Pubmatic. | Event 1: Category=`Prebid.js Bids`, Action=`Requests`, Label=`msft`, Value=1.<br/>Event 2: Category=`Prebid.js Bids`, Action=`Requests`, Label=`openx`, Value=1.<br/>Event 3: Category=`Prebid.js Bids`, Action=`Requests`, Label=`pubmatic`, Value=1 |
+| 203ms | Microsoft's bid came back with a CPM of $2.314 and a latency of 188ms. | Event 1: Category=`Prebid.js Bids`, Action=`Bids`, Label=`msft`, Value=231.<br/>Event 2: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`msft`, Value=188 |
+| 274ms | Pubmatic's bid came back with a CPM of $0 and a latency of 259ms. | No bid event sent out because it is a no bid.<br/>Event 1: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`msft`, Value=259 |
 | 415ms | Timeout is up because 400ms has passed since bid requests were sent. OpenX has timed out. | Event 1: Category=`Prebid.js Bids`, Action=`Timeouts`, Label=`openx`, Value=1 |
-| 476ms | OpenX's bid came back with a CPM of $2.831 and a latency of 461ms (a bid may still come back after a timeout). | Event 1: Category=`Prebid.js Bids`, Action=`Bids`, Label=`openx`, Value=283. <br /> Event 2: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`openx`, Value=461 |
-| 572ms | Google Ad Manager completed its auction and the AppNexus $2.314 bid won. | Event 3: Category=`Prebid.js Bids`, Action=`Wins`, Label=`appnexus`, Value=231 |
+| 476ms | OpenX's bid came back with a CPM of $2.831 and a latency of 461ms (a bid may still come back after a timeout). | Event 1: Category=`Prebid.js Bids`, Action=`Bids`, Label=`openx`, Value=283.<br/>Event 2: Category=`Prebid.js Bids`, Action=`Bid Load Time`, Label=`openx`, Value=461 |
+| 572ms | Google Ad Manager completed its auction and the Microsoft $2.314 bid won. | Event 3: Category=`Prebid.js Bids`, Action=`Wins`, Label=`msft`, Value=231 |
 
 Note that a Win event is a true win, meaning that it is not just the highest bid in the header bidding auction, but the winning bid across the entire auction hosted by the ad server and its creative is served back to the page.
 
@@ -118,8 +118,8 @@ After you've implemented the above code snippet, load the page a few times, wait
 
 As you can see, this reporting screen cannot help you answer questions such as:
 
-* What's the AppNexus bidder's avg. bid CPM
-* What's the AppNexus bidder's avg. bid load time?
+* What's the Microsoft bidder's avg. bid CPM
+* What's the Microsoft bidder's avg. bid load time?
 
 To see how to answer these questions, see the following sections.
 
diff --git a/dev-docs/analytics/intentiq.md b/dev-docs/analytics/intentiq.md
index 28fb3c3d85..06823b18e1 100644
--- a/dev-docs/analytics/intentiq.md
+++ b/dev-docs/analytics/intentiq.md
@@ -99,7 +99,7 @@ pos: 0 // The following values are defined in the ORTB 2.5 spec
 | -------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ----------- |
 | biddingPlatformId | Integer | Specify the platform in which this ad impression was rendered – 1 – Prebid, 2 – Amazon, 3 – Google, 4 – Open RTB (including your local Prebid server) | 1 | Yes |
 | partnerAuctionId | String | Use this when you are running multiple auction solutions across your assets and have a unified identifier for auctions | 3d44542d-xx-4662-xxxx-4xxxx3d8e | No |
-| bidderCode | String | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms | newAppnexus | Yes |
+| bidderCode | String | Specifies the name of the bidder that won the auction as reported by Prebid and all other bidding platforms | bidderA | Yes |
 | prebidAuctionId | String | Specifies the identifier of the Prebid auction. Leave empty or undefined if Prebid is not the bidding platform | 3513ce01-de02-490b-9d87-bfc137697f82 | No |
 | cpm | Decimal | Cost per mille of the impression as received from the demand-side auction (without modifications or reductions) | 5.62 | Yes |
 | currency | String | Currency of the auction | USD | Yes |
diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md
index 2926915754..510cd44d4c 100644
--- a/dev-docs/bidder-adaptor.md
+++ b/dev-docs/bidder-adaptor.md
@@ -766,12 +766,12 @@ Use aliases if you want to reuse your adapter using other name for your partner/
 ```javascript
 
 export const spec = {
-    code: 'appnexus',
+    code: 'msft',
     aliases: [
-        'apnx',
+        'microsoft',
         {
-            code:'apx',
-            gvlid: 1,
+            code:'mft',
+            gvlid: 32,
             skipPbsAliasing: false
         }
     ],
@@ -900,7 +900,7 @@ if (bid.mediaType === 'video' || (videoMediaType && context !== 'outstream')) {
 {: .alert.alert-info :}
 The following is Prebid's way to setup bid request for long-form, adapters are free to choose their own approach.
 
-Prebid now accepts multiple bid responses for a single `bidRequest.bids` object. For each Ad pod Prebid expects you to send back n bid responses. It is up to you how bid responses are returned. Prebid's recommendation is that you expand an Ad pod placement into a set of request objects according to the total adpod duration and the range of duration seconds. It also depends on your endpoint as well how you may want to create your request for long-form. Appnexus adapter follows below algorithm to expand its placement.
+Prebid now accepts multiple bid responses for a single `bidRequest.bids` object. For each Ad pod Prebid expects you to send back n bid responses. It is up to you how bid responses are returned. Prebid's recommendation is that you expand an Ad pod placement into a set of request objects according to the total adpod duration and the range of duration seconds. It also depends on your endpoint as well how you may want to create your request for long-form. Microsoft adapter follows below algorithm to expand its placement.
 
 #### Use case 1: I want to request my endpoint to return bids with varying ranges of durations
 
@@ -990,7 +990,7 @@ Adapter must add following new properties to bid response
 }
 ```
 
-Appnexus Adapter uses the approach explained above. You can see an example in the [AppNexus adapter](https://github.com/prebid/Prebid.js/blob/master/modules/appnexusBidAdapter.js)
+Microsoft Adapter uses the approach explained above. You can see an example in the [Microsoft adapter](https://github.com/prebid/Prebid.js/blob/master/modules/msftBidAdapter.js)
 
 Adapter must return one [IAB accepted subcategories](https://iabtechlab.com/wp-content/uploads/2017/11/IAB_Tech_Lab_Content_Taxonomy_V2_Final_2017-11.xlsx) (links to MS Excel file) if they want to support competitive separation. These IAB sub categories will be converted to Ad server industry/group. If adapter is returning their own proprietary categroy, it is the responsibility of the adapter to convert their categories into [IAB accepted subcategories](https://iabtechlab.com/wp-content/uploads/2017/11/IAB_Tech_Lab_Content_Taxonomy_V2_Final_2017-11.xlsx) (links to MS Excel file).
 
diff --git a/dev-docs/bidders/appnexus.md b/dev-docs/bidders/appnexus.md
index 5d190a1250..7056a78dcb 100644
--- a/dev-docs/bidders/appnexus.md
+++ b/dev-docs/bidders/appnexus.md
@@ -15,7 +15,7 @@ gpp_supported: true
 floors_supported: true
 fpd_supported: false
 pbjs: true
-pbjs_version_notes: please avoid using v7.15 and v7.16
+pbjs_version_notes: Support for the AppNexus adapter will be reduced beginning July 1, 2026, with full deprecation planned for early 2027. To maintain uninterrupted support and access to the latest features, please migrate to the Microsoft adapter. More information can be seen on the msft.md page.
 pbs: true
 gvl_id: 32
 sidebarType: 1
@@ -40,6 +40,9 @@ sidebarType: 1
 
 <a name="appnexus-bid-params"></a>
 
+{: .alert.alert-danger :}
+Support for the AppNexus adapter will be reduced beginning July 1, 2026, with full deprecation planned for early 2027. To maintain uninterrupted support and access to the latest features, please migrate to the [Microsoft adapter](msft.md).
+
 {: .alert.alert-danger :}
 All AppNexus (Microsoft/Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher.  If placements from two different publishers are included in the call, the AppNexus bidder will not return any demand for those placements. <br />
 *Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the AppNexus adapter.*
diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index e8425c998e..99c6844210 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -15,13 +15,15 @@ gpp_supported: true
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbjs_version_notes: This adapter is new, and will ultimately replace the AppNexus adapter. We recommend careful monitoring of this replacement, and please communicate any questions or unexpected behavior.
+pbjs_version_notes: 
+redirect_from
+	- /dev-docs/bidders/appnexus.html
 pbs: true
 gvl_id: 32
 sidebarType: 1
 ---
 
-### Table of Contents
+## Table of Contents
 
 - [Table of Contents](#table-of-contents)
   - [Bid Params](#bid-params)
@@ -32,8 +34,8 @@ sidebarType: 1
   - [First Party Data](#first-party-data)
   - [Debug Auction](#debug-auction)
 
-{: .alert.alert-danger :}
-This adapter is new, and will ultimately replace the AppNexus adapter. We recommend careful monitoring of this replacement, and please communicate any questions or unexpected behavior.
+{: .alert.alert-success :}
+This is the official adapter to integrate with Microsoft Monetize. Please update any integration using the [Appnexus Adapter](appnexus.md)
 
 <a name="bid-params"></a>
 
@@ -41,29 +43,29 @@ This adapter is new, and will ultimately replace the AppNexus adapter. We recomm
 All Microsoft (formerly AppNexus/Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher.  If placements from two different publishers are included in the call, the Microsoft bidder will not return any demand for those placements. <br />
 *Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the Microsoft adapter.*
 
-#### Bid Params
+### Bid Params
 
 **NOTE** Either `placement_id` OR both `member` and `inv_code` are required.  Please don't specify all three together, it may impact delivery.
 
 {: .table .table-bordered .table-striped }
 
-| Name | Scope | Description | Example | Type |
-|------|-------|-------------|---------|------|
-| `placement_id` | required (see note above) | The placement ID from Microsoft Monetize.  You may identify a placement using the `inv_code` and `member` instead of a placement ID. | `11223344` | `integer` |
-| `member` | required (see note above) | The member ID from Microsoft Monetize.  Must be used with `inv_code`. | `1234` | `integer` |
-| `inv_code` | required (see note above) | The inventory code from Microsoft Monetize.  Must be used with `member`. | `'abc123'` | `string` |
-| `allow_smaller_sizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` |
-| `use_pmt_rule` | optional | If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` |
-| `keywords` | optional | A comma-delimited string of key-value pairs (or terms) applied to this specific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.  | `pet=dog,food,brand=oldroy` | `string` |
-| `traffic_source_code` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` |
-| `pubclick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly. | `'http://click.adserver.com/'` | `string` |
-| `ext_inv_code` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` |
-| `ext_imp_id` | optional | Specifies the unique identifier of an externally generated auction. | `'bacbab02626452b097f6030b3c89ac05'` | `string` |
-| `banner_frameworks` | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `[1,2]` | `array of integers` |
+|Name|Scope|Description|Example|Type|
+|:---|:---|:---|:---|:---|
+|`placement_id`|required (see note above)|The placement ID from Microsoft Monetize. You may identify a placement using the `inv_code` and `member` instead of a placement ID.|`11223344`|`integer`|
+|`member`|required (see note above)|The member ID from Microsoft Monetize. Must be used with `inv_code`.|`1234`|`integer`|
+|`inv_code`|required (see note above)|The inventory code from Microsoft Monetize. Must be used with `member`.|`'abc123'`|`string`|
+|`allow_smaller_sizes`|optional|If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`.|`true`|`boolean`|
+|`use_pmt_rule`|optional|If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied.|`true`|`boolean`|
+|`keywords`|optional|A comma-delimited string of key-value pairs (or terms) applied to this specific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.`|`pet=dog,food,brand=oldroy`|`string`|
+|`traffic_source_code`|optional|Specifies the third-party source of this impression.|`'my_traffic_source'`|`string`|
+|`pubclick`|optional|Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly.`|`'http://click.adserver.com/'`|`string`|
+|`ext_inv_code`|optional|Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged.|`'10039'`|`string`|
+|`ext_imp_id`|optional|Specifies the unique identifier of an externally generated auction.|`'bacbab02626452b097f6030b3c89ac05'`|`string`|
+|`banner_frameworks`|optional|Array of integers listing API frameworks for Banner supported by the publisher.|`[1,2]`|`array of integers`|
 
 <a name="migration-from-appnexus-bid-params"></a>
 
-#### Migrating from the AppNexus Bid Adapter & Bid Params
+### Migrating from the AppNexus Bid Adapter & Bid Params
 
 If you are migrating from the AppNexus bid adapter, a number of the previously available AppNexus bid parameters have been deprecated as available options for the Microsoft bid parameters. These deprecated bid parameters are still available however, they're just read from other standarized locations offered within Prebid.js. This change was implemented to help us align better to the publisher-aligned features (such as First Party Data) to use a single setup for many bidders.
 
@@ -76,7 +78,7 @@ The following table shows how the bid parameters have changed between the two ad
 {: .table .table-bordered .table-striped }
 
 | AppNexus Parameter | Microsoft Parameter | Description |
-|-------------------|-------------------|-------------|
+| :--- | :--- | :--- |
 | `params.placementId` | `params.placement_id` | Placement ID (**only** the underscore case is now supported in the name, value **only** accepts integers) |
 | `params.member` | `params.member` | Member ID (value **only** accepts integers) |
 | `params.inv_code` | `params.inv_code` | Inventory code (unchanged) |
@@ -97,20 +99,20 @@ The following table shows how the bid parameters have changed between the two ad
 | `params.ext_inv_code` | `params.ext_inv_code` | External inventory code (unchanged) |
 | `params.external_imp_id` | `params.ext_imp_id` | External impression ID (shortend to ext) |
 
-#### Keywords 
+### Keywords
 With the AppNexus adapter, keywords followed this format: keyname=keyvalue1,keyvalue2,keyvalue3
 
 In the Microsoft Bid Adapter, the new required format is: keyname=keyvalue1,keyname=keyvalue2,keyname=keyvalue3
 
 <a name="migration-from-appnexus-adserver-targeting"></a>
 
-#### Migrating from the AppNexus Bid Adapter & Ad Server Targeting
+### Migrating from the AppNexus Bid Adapter & Ad Server Targeting
 
 If you are migrating from the AppNexus bid adapter and your Ad Server Line Items (or related entities) relied on bidder specific keyword targeting to the Prebid.js keys (eg hb_bidder=appnexus or hb_pb_appnexus=5.00), you will like need to adjust your setup.  Some adjustments could be creating additional line-items, updating the existing targeting, reomving targeting (if it's no longer needed), or some other variation to ensure the targeting includes the `msft` term in either the key-name or key-value.
 
 <a name="migration-from-appnexus-native"></a>
 
-#### Migrating from the AppNexus Bid Adapter & Native Ads
+### Migrating from the AppNexus Bid Adapter & Native Ads
 
 If you are migrating from the AppNexus bid adapter, the setup for Native adUnits now require the use of the Prebid.js ORTB Native setup.  The Microsoft Bid Adapter **no longer offers support** to the legacy Prebid.js Native adUnit setup.  
 
@@ -120,7 +122,7 @@ Please refer to the [Prebid.js Native Implementation Guide](https://docs.prebid.
 
 <a name="migration-from-appnexus-auction-level-keywords"></a>
 
-#### Migrating from the AppNexus Bid Adapter & Auction Level Keywords
+### Migrating from the AppNexus Bid Adapter & Auction Level Keywords
 
 If you are migrating from the AppNexus bid adapter, the previously available `setConfig` option named `appnexusAuctionKeywords` is not supported within the Microsoft bid adapter.
 
@@ -128,7 +130,7 @@ If you need to specify keyword-like data at the auction/request level, please in
 
 <a name="fpd"></a>
 
-#### First Party Data
+### First Party Data
 
 Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
 
@@ -136,7 +138,7 @@ PBS/PSP supports all first party data fields: site, user, segments, and imp-leve
 
 <a name="debug-auction"></a>
 
-#### Debug Auction
+### Debug Auction
 
 {: .alert.alert-danger :}
 Enabling the Microsoft Monetize Debug Auction feature should only be done for diagnosing the Monetize auction. Do **NOT** enable this feature in a production setting where it may impact users.  The debug output will take the place of the normal bid response, meaning the ad will **NOT** show even if the auction debug output indicated there was a winning bid.
@@ -159,11 +161,11 @@ To view the results of the debug auction, add the `pbjs_debug=true` query string
 
 {: .table .table-bordered .table-striped }
 
-| Name              | Description                                                     | Example               | Type             |
-|-------------------|-----------------------------------------------------------------|-----------------------|------------------|
-| `enabled`         | Toggle the debug auction to occur                               | `true`                | `boolean`        |
-| `dongle`          | Your account's unique debug password.                           | `QWERTY`              | `string`         |
-| `member_id`       | The ID of the member running the debug auction                  | `958`                 | `integer`        |
-| `debug_timeout`   | The timeout for the debug auction results to be returned        | `3000`                | `integer`        |
+| Name | Description | Example | Type |
+| :--- | :--- | :--- | :--- |
+| `enabled` | Toggle the debug auction to occur | `true` | `boolean` |
+| `dongle` | Your account's unique debug password. | `QWERTY` | `string` |
+| `member_id` | The ID of the member running the debug auction | `958` | `integer` |
+| `debug_timeout` | The timeout for the debug auction results to be returned | `3000` | `integer` |
 
 <a name="prebid-server-test-request"></a>
diff --git a/dev-docs/bidders/zmaticoo.md b/dev-docs/bidders/zmaticoo.md
index 596d9aeaa5..02f81e8d9d 100644
--- a/dev-docs/bidders/zmaticoo.md
+++ b/dev-docs/bidders/zmaticoo.md
@@ -13,16 +13,15 @@ safeframes_ok: true
 ortb_blocking_supported: partial
 ---
 
-### Note
+# Note
 
 To use this bidder you will need a valid pubId. For further information, please contact <support@zmaticoo.com>.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
 | Name                 | Scope    | Description                                                                                                                | Example                 | Type           |
-|----------------------|----------|----------------------------------------------------------------------------------------------------------------------------|-------------------------|----------------|
-| `pubId`              | required | The pubId provided by zmaticoo                                                                                             |`"prebid_test"`          | `string`       |
+| --- | --- | --- | --- | --- |\n| `pubId`              | required | The pubId provided by zmaticoo                                                                                             |`"prebid_test"`          | `string`       |
 | `user`               | optional | The object containing user data (See OpenRTB spec)                                                                         | `user: {}`              | `object`       |
 | `device`             | optional | The object containing device data (See OpenRTB spec)                                                                       | `device: {}`            | `object`       |
 | `site`               | optional | The object containing site data (See OpenRTB spec)                                                                         | `site: {}`              | `object`       |
@@ -36,12 +35,11 @@ To use this bidder you will need a valid pubId. For further information, please
 | `wlang`              | optional | White list of languages for creatives                                                                                      | `wlang: ["ENG"]`        | `string array` |
 | `bcat`               | optional | Blocked advertiser categories using the IAB content categories                                                             | `bcat: ["123"]`         | `string array` |
 | `badv`               | optional | Block list of advertisers by their domains                                                                                 | `badv: ["blocked.com"]` | `string array` |
-| `bapp`               | optional | Block list of applications by their platform-specific exchange independent application identifiers                         | `badv: ["com.blocked"]` | `string array` |
-| `source`             | optional | A Source object that provides data about the inventory source and which entity makes the final decision (See OpenRTB spec) | `source: {}`            | `object`       |
+| --- | --- | --- | --- | --- |\n| `source`             | optional | A Source object that provides data about the inventory source and which entity makes the final decision (See OpenRTB spec) | `source: {}`            | `object`       |
 | `ext`                | optional | An extension object that allows for custom fields and objects to be sent  (See OpenRTB spec)                               | `ext: {}`               | `object`       |
 
-### AdUnit Format Example
-#### AdUnit Format for Banner
+## AdUnit Format Example
+### AdUnit Format for Banner
 
 ```javascript
  var adUnits = [{
@@ -61,7 +59,7 @@ To use this bidder you will need a valid pubId. For further information, please
 }];
 ```
 
-#### AdUnit Format for video
+### AdUnit Format for video
 
 ```javascript
      var adUnits = [{
@@ -103,24 +101,20 @@ To use this bidder you will need a valid pubId. For further information, please
 }];
 ```
 
-### Use prebid.js for an Admanager
+## Use prebid.js for an Admanager
    To use prebid.js,you can use an Ad Server,like:Google Ad Manager、Smart Ad Server、Xandr Monetize Ad Server。Ad Server helps you manage your ad order,and helps you record  ad rendor impression.
    Below these file demo implemented settings with Google Ad Manager
 
    {: .table .table-bordered .table-striped }
-   | mediaType            | demo(md)  | demo(html)                        |                                                                                       
-   |----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------|
-   | `Banner`             | `https://creative.cdnyeah.com/tpl/renderer/template/banner-gam.md` | `https://creative.cdnyeah.com/tpl/renderer/template/banner-gam.html`          |
-   | `outstream video`    | `https://creative.cdnyeah.com/tpl/renderer/template/video-outstream-gam.md` | `https://creative.cdnyeah.com/tpl/renderer/template/video-outstream-gam.html`    |
-   | `instream video`     | `https://creative.cdnyeah.com/tpl/renderer/template/video-instream-gam.md` | `https://creative.cdnyeah.com/tpl/renderer/template/video-instream-gam.html`    |
+   | mediaType            | demo(md)  | demo(html)                        |
+| --- | --- | --- |\n| --- | --- | --- |
+| --- | --- | --- |\n| --- | --- | --- |
 
-### Use prebid.js for No Admanager
+## Use prebid.js for No Admanager
 If you don't want to use third-party Ad Server,you can direct integration with zMaticoo。zMaticoo  will provide you with a platform(`https://adx.zmaticoo.com`),You can count your request volume,impressions,and income.
 Below, these file demos help you integrate with no Admanager
 
 {: .table .table-bordered .table-striped }
-| mediaType            | demo(md)  | demo(html)                        |                                                                                       
-|----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------|
-| `Banner`             | `https://creative.cdnyeah.com/tpl/renderer/template/banner-noadserver.md` | `https://creative.cdnyeah.com/tpl/renderer/template/banner-noadserver.html`        |
-| `outstream video`    | `https://creative.cdnyeah.com/tpl/renderer/template/video-outstream-noadserver.md` | `https://creative.cdnyeah.com/tpl/renderer/template/video-outstream-noadserver.html`    |
-| `instream video`     | `https://creative.cdnyeah.com/tpl/renderer/template/video-instream-noadserver.md` | `https://creative.cdnyeah.com/tpl/renderer/template/video-instream-noadserver.html`   |
+| mediaType            | demo(md)  | demo(html)                        |
+| --- | --- | --- |\n| --- | --- | --- |
+| --- | --- | --- |\n| --- | --- | --- |
diff --git a/dev-docs/examples/adunit-refresh.md b/dev-docs/examples/adunit-refresh.md
index e79b28718c..c91d1b85c4 100644
--- a/dev-docs/examples/adunit-refresh.md
+++ b/dev-docs/examples/adunit-refresh.md
@@ -45,9 +45,9 @@ var adUnits = [{
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13144370
+            placement_id: 13144370
         }
     }]
 }];
diff --git a/dev-docs/examples/basic-example.md b/dev-docs/examples/basic-example.md
index e4f2519984..392296af31 100644
--- a/dev-docs/examples/basic-example.md
+++ b/dev-docs/examples/basic-example.md
@@ -45,9 +45,9 @@ var adUnits = [{
     }
   },
   bids: [{
-    bidder: 'appnexus',
+    bidder: 'msft',
     params: {
-      placementId: 'XXXXXXX' //not used in prod
+      placement_id: 'XXXXXXX' //not used in prod
     }
   }]
 }];
diff --git a/dev-docs/examples/custom-price-buckets.md b/dev-docs/examples/custom-price-buckets.md
index b8bc178adc..448c0a4c63 100644
--- a/dev-docs/examples/custom-price-buckets.md
+++ b/dev-docs/examples/custom-price-buckets.md
@@ -37,9 +37,9 @@ var adUnits = [{
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13144370
+            placement_id: 13144370
         }
     }]
 }];
diff --git a/dev-docs/examples/instream-banner-mix.md b/dev-docs/examples/instream-banner-mix.md
index 57753efcf1..7966aa58b3 100644
--- a/dev-docs/examples/instream-banner-mix.md
+++ b/dev-docs/examples/instream-banner-mix.md
@@ -89,9 +89,9 @@ var adUnits = [
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13144370
+                placement_id: 13144370
             }
         }]
     },
@@ -103,9 +103,9 @@ var adUnits = [
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13144370
+                placement_id: 13144370
             }
         }]
     }
@@ -121,9 +121,9 @@ var videoAdUnit = {
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13232361, // Add your own placement id here
+            placement_id: 13232361, // Add your own placement id here
             video: {
                 skipppable: true,
                 playback_method: ['auto_play_sound_off']
diff --git a/dev-docs/examples/intercept-banner-not-for-prod.js b/dev-docs/examples/intercept-banner-not-for-prod.js
index a881714fc0..f8b59127d1 100644
--- a/dev-docs/examples/intercept-banner-not-for-prod.js
+++ b/dev-docs/examples/intercept-banner-not-for-prod.js
@@ -5,7 +5,7 @@ pbjs.que.push(() => {
            enabled: true,
            intercept: [{
                when: {
-                     bidder: 'appnexus',
+                     bidder: 'msft',
                },
                then: {
                      ad: '<html><body><img src="https://files.prebid.org/creatives/prebid300x250.png" width="300" height="250" /></body></html>'
diff --git a/dev-docs/examples/meta-bid-filtering.md b/dev-docs/examples/meta-bid-filtering.md
index 7ff0d28077..79d167923a 100644
--- a/dev-docs/examples/meta-bid-filtering.md
+++ b/dev-docs/examples/meta-bid-filtering.md
@@ -38,9 +38,9 @@ var adUnits = [{
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13144370
+            placement_id: 13144370
         },
         
     }]
diff --git a/dev-docs/examples/native-ad-example.md b/dev-docs/examples/native-ad-example.md
index 4d87c6fe72..a2032dd2aa 100644
--- a/dev-docs/examples/native-ad-example.md
+++ b/dev-docs/examples/native-ad-example.md
@@ -95,9 +95,9 @@ pbjs.que.push(function() {
                 }
             },
             bids: [{
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                    placementId: 13232354,
+                    placement_id: 13232354,
                     allowSmallerSizes: true
                 }
             }]
@@ -127,9 +127,9 @@ pbjs.que.push(function() {
                 }
             },
             bids: [{
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                    placementId: 13232354,
+                    placement_id: 13232354,
                     allowSmallerSizes: true
                 }
             }]
diff --git a/dev-docs/examples/no-adserver.md b/dev-docs/examples/no-adserver.md
index c1b2dee071..141e7f5490 100644
--- a/dev-docs/examples/no-adserver.md
+++ b/dev-docs/examples/no-adserver.md
@@ -30,9 +30,9 @@ jsfiddle_link: jsfiddle.net/Prebid_Examples/svumodbe/embedded/html,result
         },
         bids: [
             {
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                    placementId: 13144370
+                    placement_id: 13144370
                 }
             }
         ]
@@ -46,9 +46,9 @@ jsfiddle_link: jsfiddle.net/Prebid_Examples/svumodbe/embedded/html,result
         },
         bids: [
             {
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                    placementId: 13144370
+                    placement_id: 13144370
                 }
             }
         ]
diff --git a/dev-docs/examples/postbid.md b/dev-docs/examples/postbid.md
index b4e0579047..1b7623917e 100644
--- a/dev-docs/examples/postbid.md
+++ b/dev-docs/examples/postbid.md
@@ -44,9 +44,9 @@ var adUnits = [{
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13144370
+            placement_id: 13144370
         }
     }]
 }];
diff --git a/dev-docs/examples/size-mapping.md b/dev-docs/examples/size-mapping.md
index 4ad3401392..e54918a5da 100644
--- a/dev-docs/examples/size-mapping.md
+++ b/dev-docs/examples/size-mapping.md
@@ -59,9 +59,9 @@ var adUnits = [
         },
         bids: [
             {
-                bidder: 'appnexus',
+                bidder: 'msft',
                 params: {
-                    placementId: 13144370
+                    placement_id: 13144370
                 }
             }
         ]
diff --git a/dev-docs/examples/sync-tid.md b/dev-docs/examples/sync-tid.md
index 0922e41ffd..69ae0a0d00 100644
--- a/dev-docs/examples/sync-tid.md
+++ b/dev-docs/examples/sync-tid.md
@@ -69,9 +69,9 @@ pbjs.que.push(function() {
             },
             bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 13144370,
+                        placement_id: 13144370,
                     },
                 },
             ],
diff --git a/dev-docs/examples/use-prebid-with-appnexus-ad-server.md b/dev-docs/examples/use-prebid-with-microsoft-ad-server.md
similarity index 95%
rename from dev-docs/examples/use-prebid-with-appnexus-ad-server.md
rename to dev-docs/examples/use-prebid-with-microsoft-ad-server.md
index 45dbb89fad..7efe0d663d 100644
--- a/dev-docs/examples/use-prebid-with-appnexus-ad-server.md
+++ b/dev-docs/examples/use-prebid-with-microsoft-ad-server.md
@@ -58,9 +58,9 @@ var adUnits = [
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13144370
+                placement_id: 13144370
             }
         }]
     },
@@ -72,9 +72,9 @@ var adUnits = [
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13144370
+                placement_id: 13144370
             }
         }]
     }
diff --git a/dev-docs/modules/1plusXRtdProvider.md b/dev-docs/modules/1plusXRtdProvider.md
index 8ce79efad6..423f87853b 100644
--- a/dev-docs/modules/1plusXRtdProvider.md
+++ b/dev-docs/modules/1plusXRtdProvider.md
@@ -26,7 +26,7 @@ The 1plusX RTD module appends User and Contextual segments to the bidding object
 1. Compile the 1plusX RTD Module along with your bid adapter and other modules into your Prebid build:  
 
     ```bash
-    gulp build --modules="rtdModule,1plusXRtdProvider,appnexusBidAdapter,..."  
+    gulp build --modules="rtdModule,1plusXRtdProvider,bidderABidAdapter,..."  
     ```
 
 2. Use `setConfig` to instruct Prebid.js to initilize the 1plusX RTD module, as specified below.
@@ -45,7 +45,7 @@ pbjs.setConfig({
             waitForIt: true,
             params: {
                 customerId: 'acme',
-                bidders: ['appnexus', 'rubicon'],
+                bidders: ['bidderA', 'bidderB'],
                 timeout: TIMEOUT,
                 fpidStorageType: 'html5'
             }
@@ -58,12 +58,12 @@ pbjs.setConfig({
 
 {: .table .table-bordered .table-striped }
 
-| Name              | Type          | Description                                                      | Default           |
-| :---------------- | :------------ | :--------------------------------------------------------------- |:----------------- |
-| name              | String        | Real time data module name                                       | Always '1plusX'   |
-| waitForIt         | Boolean       | Should be `true` if there's an `auctionDelay` defined (optional) | `false`           |
-| params            | Object        |                                                                  |                   |
-| params.customerId | String        | Your 1plusX customer id                                          |                   |
-| params.bidders    | Array<string> | List of bidders for which you would like data to be set          |                   |
-| params.timeout    | Integer       | timeout (ms)                                                     | 1000ms            |
+| Name | Type | Description | Default |
+| :--- | :--- | :--- | :--- |
+| name | String | Real time data module name | Always '1plusX' |
+| waitForIt | Boolean | Should be `true` if there's an `auctionDelay` defined (optional) | `false` |
+| params | Object | | |
+| params.customerId | String | Your 1plusX customer id | |
+| params.bidders | Array<string> | List of bidders for which you would like data to be set | |
+| params.timeout | Integer | timeout (ms) | 1000ms |
 | params.fpidStorageType | String | Where to read the first party id ('html5' or 'cookie') | 'html5' |
diff --git a/dev-docs/modules/51DegreesRtdProvider.md b/dev-docs/modules/51DegreesRtdProvider.md
index eb5ef9fc90..a8f0dc5b1d 100644
--- a/dev-docs/modules/51DegreesRtdProvider.md
+++ b/dev-docs/modules/51DegreesRtdProvider.md
@@ -56,7 +56,7 @@ Free cloud and on premise solutions can be expanded to support unlimited request
 Compile the 51Degrees RTD Module with other modules and adapters into your Prebid.js build:
 
 ```bash
-gulp build --modules="rtdModule,51DegreesRtdProvider,appnexusBidAdapter,..."  
+gulp build --modules="rtdModule,51DegreesRtdProvider,bidderABidAdapter,..."  
 ```
 
 > Note that the 51Degrees RTD module is dependent on the global real-time data module, `rtdModule`.
@@ -171,7 +171,7 @@ pbjs.setConfig({
 If you want to see an example of how the 51Degrees RTD module works,\
 run the following command:
 
-`gulp serve --modules=rtdModule,51DegreesRtdProvider,appnexusBidAdapter`
+`gulp serve --modules=rtdModule,51DegreesRtdProvider,bidderABidAdapter`
 
 and then open the following URL in your browser:
 
diff --git a/dev-docs/modules/adpod.md b/dev-docs/modules/adpod.md
index 9e173e4f4e..ffff53fc98 100644
--- a/dev-docs/modules/adpod.md
+++ b/dev-docs/modules/adpod.md
@@ -68,12 +68,12 @@ This variable equates to `hb_cache_id`.
 To enable publishers to prioritize video deals with direct buys and over deals at the same price in the FreeWheel stack two new ad pod configs have been added, `prioritzeDeals` and `dealTier`. To obtain this higher priority the method uses the deal priority tier value that is passed by the bidder. This helps inflate the bid CPM that is passed into FreeWheel and gives it a higher priority.
 
 {: .table .table-bordered .table-striped }
-| Parameter  | Scope  | Type  | Description  |
-|---|---|---|---|
-| prioritizeDeals  |  Optional | Boolean  |  A flag to give a higher preference to deals. This will replace the CPM value within the `hb_pb_cat_dur` key with the `bid.video.dealTier` value.  For example: A bid with `hp_pb_cat_dur` value of `12.00_395_15s` that has a `dealTier.BIDDER.prefix` of tier and a `bid.video.dealTier` value of 6 would have its `hp_pb_cat_dur` value changed to `tier6_395_15s`. |
-| dealTier  | Optional  | Object  | The dealTier parameter contains objects which hold information about the minimum deal tier to set for each bidder and the prefix required by that bidder to conduct a deal. This enables each publisher to have line items set up in the ad server with different priorities. See the `dealTier` object below for parameters.  |
-| dealTier.BIDDER.prefix  | Optional  | String  | The prefix required by the bidder to indicate this is a deal.  |
-| dealTier.BIDDER.minDealTier  | Optional  | Integer  | When an `adpod` is passed with the `prioritizeDeals` flag set to true, a higher preference is given to bids with a deal tier greater than the `minDealTier` setting. As an example, if the `dealTier.BIDDER.minDealTier` is set to 5 than all bids with a `dealTier` greater than or equal to five will be given a higher preference. Bid with a `dealTier` less than five will be considered the same as non-deal bids.   |
+|Parameter|Scope|Type|Description|
+|:---|:---|:---|:---|
+|prioritizeDeals|Optional|Boolean|A flag to give a higher preference to deals. This will replace the CPM value within the `hb_pb_cat_dur` key with the `bid.video.dealTier` value. For example: A bid with `hp_pb_cat_dur` value of `12.00_395_15s` that has a `dealTier.BIDDER.prefix` of tier and a `bid.video.dealTier` value of 6 would have its `hp_pb_cat_dur` value changed to `tier6_395_15s`.|
+|dealTier|Optional|Object|The dealTier parameter contains objects which hold information about the minimum deal tier to set for each bidder and the prefix required by that bidder to conduct a deal. This enables each publisher to have line items set up in the ad server with different priorities. See the `dealTier` object below for parameters.|
+|dealTier.BIDDER.prefix|Optional|String|The prefix required by the bidder to indicate this is a deal.|
+|dealTier.BIDDER.minDealTier|Optional|Integer|When an `adpod` is passed with the `prioritizeDeals` flag set to true, a higher preference is given to bids with a deal tier greater than the `minDealTier` setting. As an example, if the `dealTier.BIDDER.minDealTier` is set to 5 than all bids with a `dealTier` greater than or equal to five will be given a higher preference. Bid with a `dealTier` less than five will be considered the same as non-deal bids.|
 
 ### Examples
 
@@ -83,7 +83,7 @@ pbjs.setConfig({
   adpod: {
     prioritizeDeals: true,
     dealTier: {
-      'appnexus': {
+      'bidderA': {
         prefix: 'tier',
         minDealTier: 5
       },
diff --git a/dev-docs/modules/airgridRtdProvider.md b/dev-docs/modules/airgridRtdProvider.md
index 3e06e61d00..91a5f6f736 100644
--- a/dev-docs/modules/airgridRtdProvider.md
+++ b/dev-docs/modules/airgridRtdProvider.md
@@ -27,7 +27,7 @@ injected into bid request objects destined for different bidders in order to opt
 
 Compile the AirGrid RTD module (`airgridRtdProvider`) into your Prebid build, along with the parent RTD Module (`rtdModule`):
 
-`gulp build --modules=rtdModule,airgridRtdProvider,appnexusBidAdapter`
+`gulp build --modules=rtdModule,airgridRtdProvider,msftBidAdapter`
 
 Next we configure the module, via `pbjs.setConfig`. See the **Parameter Descriptions** below for more detailed information of the configuration parameters.
 
@@ -45,7 +45,7 @@ pbjs.setConfig(
                     apiKey: 'apiKey',
                     accountId: 'accountId',
                     publisherId: 'publisherId',
-                    bidders: ['appnexus', 'pubmatic']
+                    bidders: ['bidderA', 'bidderB']
                 }
             }
         ]
@@ -57,8 +57,8 @@ pbjs.setConfig(
 ### Parameter Descriptions
 
 {: .table .table-bordered .table-striped }
-| Name  |Type | Description   | Notes  |
-| :------------ | :------------ | :------------ |:------------ |
+| Name | Type | Description | Notes |
+| :--- | :--- | :--- | :--- |
 | name | `String` | RTD sub module name | Always 'airgrid' |
 | waitForIt | `Boolean` | Wether to delay auction for module response | Optional. Defaults to false |
 | params.apiKey | `String` | Publisher partner specific API key | Required |
@@ -66,7 +66,7 @@ pbjs.setConfig(
 | params.publisherId | `String` | Publisher partner specific publisher ID | Required |
 | params.bidders | `Array` | Bidders with which to share segment information | Optional |
 
-_Note: Although the module supports passing segment data to any bidder using the ORTB2 spec, there is no way for this to be currently monetised. Please reach out to support, to discuss using bidders other than Xandr/AppNexus._
+_Note: Although the module supports passing segment data to any bidder using the ORTB2 spec, there is no way for this to be currently monetised. Please reach out to support, to discuss using bidders other than Xandr/Microsoft._
 
 If you do not have your own `apiKey`, `accountId` & `publisherId` please reach out to [support@airgrid.io](mailto:support@airgrid.io) or you can sign up via the [AirGrid platform](https://app.airgrid.io).
 
@@ -75,7 +75,7 @@ If you do not have your own `apiKey`, `accountId` & `publisherId` please reach o
 To view an example of the on page setup required:
 
 ```bash
-gulp serve-fast --modules=rtdModule,airgridRtdProvider,appnexusBidAdapter
+gulp serve-fast --modules=rtdModule,airgridRtdProvider,msftBidAdapter
 ```
 
 Then in your browser access:
diff --git a/dev-docs/modules/anonymisedRtdProvider.md b/dev-docs/modules/anonymisedRtdProvider.md
index d69192bd34..05bc75ddab 100644
--- a/dev-docs/modules/anonymisedRtdProvider.md
+++ b/dev-docs/modules/anonymisedRtdProvider.md
@@ -37,7 +37,7 @@ gulp build --modules=rtdModule,anonymisedRtdProvider,...
          waitForIt: true,
          params: {
            cohortStorageKey: "cohort_ids",
-           bidders: ["appnexus", "onetag", "pubmatic", "smartadserver", ...],
+           bidders: ["bidderA", "bidderB", "bidderC", ...],
            segtax: 1000,
            tagConfig: {
             clientId: 'testId'
diff --git a/dev-docs/modules/blueconicRtdProvider.md b/dev-docs/modules/blueconicRtdProvider.md
index a419c0da36..feb243fcec 100644
--- a/dev-docs/modules/blueconicRtdProvider.md
+++ b/dev-docs/modules/blueconicRtdProvider.md
@@ -24,7 +24,7 @@ BlueConic's Real-time Data Provider automatically obtains segmentation data and
 
 Compile the BlueConic RTD module into your Prebid build:
 
-`gulp build --modules=rtdModule,blueconicRtdProvider,appnexusBidAdapter`
+`gulp build --modules=rtdModule,blueconicRtdProvider,bidderABidAdapter`
 
 Add the BlueConic RTD provider to your Prebid config. In this example we will configure
 publisher 1234 to retrieve segments, profile data from BlueConic. See the
@@ -57,8 +57,8 @@ pbjs.setConfig(
 ## BlueConic Configuration Parameters
 
 {: .table .table-bordered .table-striped }
-| Name  |Type | Description   | Notes  |
-| :------------ | :------------ | :------------ |:------------ |
+| Name | Type | Description | Notes |
+| :--- | :--- | :--- | :--- |
 | name | String | Real time data module name | Always 'blueconic' |
 | waitForIt | Boolean | Required to ensure that the auction is delayed until prefetch is complete | Optional. Defaults to false |
 | params | Object | | |
@@ -71,13 +71,13 @@ tests.
 
 To run test suite for blueconic:
 
-`gulp test --modules=rtdModule,blueconicRtdProvider,appnexusBidAdapter`
+`gulp test --modules=rtdModule,blueconicRtdProvider,bidderABidAdapter`
 
 ## Example
 
 To view an example of available segments & profile data:
 
-`gulp serve --modules=rtdModule,blueconicRtdProvider,appnexusBidAdapter`
+`gulp serve --modules=rtdModule,blueconicRtdProvider,bidderABidAdapter`
 
 and then point your browser at:
 
diff --git a/dev-docs/modules/captifyRtdProvider.md b/dev-docs/modules/captifyRtdProvider.md
index e8de341105..e2bb1f48e3 100644
--- a/dev-docs/modules/captifyRtdProvider.md
+++ b/dev-docs/modules/captifyRtdProvider.md
@@ -37,7 +37,7 @@ Contact <prebid@captify.tech> for more information.
 1. Compile the Captify RTD Module along with your bid adapter and other modules into your Prebid build:  
 
     ```bash
-    gulp build --modules="rtdModule,captifyRtdProvider,appnexusBidAdapter,..."  
+    gulp build --modules="rtdModule,captifyRtdProvider,bidderABidAdapter,..."  
     ```
 
 2. Use `setConfig` to instruct Prebid.js to initialize the Captify RTD module, as specified below.
@@ -57,7 +57,7 @@ pbjs.setConfig({
                 waitForIt: true,
                 params: {
                     pubId: 123456,
-                    bidders: ['appnexus'],
+                    bidders: ['bidderA'],
                 }
             }
         ]
@@ -68,11 +68,11 @@ pbjs.setConfig({
 ## Parameters
 
 {: .table .table-bordered .table-striped }
-| Name             |Type           | Description                                                         |Mandatory | Notes  |
-| :--------------- | :------------ | :------------------------------------------------------------------ |:---------|:------------ |
-| `name`           | String        | Real time data module name                                          | yes     | Always 'CaptifyRTDModule' |
-| `waitForIt`      | Boolean       | Should be `true` if there's an `auctionDelay` defined (recommended) | no      | Default `false` |
-| `params`         | Object        | |  | |
-| `params.pubId`   | Integer       | Partner ID, required to get results and provided by Captify         | yes      | Use `123456` for tests, speak to your Captify account manager to receive your pubId |
-| `params.bidders` | Array<String> | List of bidders for which you would like data to be set             | yes      | Currently only 'appnexus' supported |
-| `params.url`     | String        | Captify live-classification service url                             | no       | Defaults to `https://live-classification.cpx.to/prebid-segments` |
+| Name | Type | Description | Mandatory | Notes |
+| :--- | :--- | :--- | :--- | :--- |
+| `name` | String | Real time data module name | yes | Always 'CaptifyRTDModule' |
+| `waitForIt` | Boolean | Should be `true` if there's an `auctionDelay` defined (recommended) | no | Default `false` |
+| `params` | Object | | | |
+| `params.pubId` | Integer | Partner ID, required to get results and provided by Captify | yes | Use `123456` for tests, speak to your Captify account manager to receive your pubId |
+| `params.bidders` | Array<String> | List of bidders for which you would like data to be set | yes | Currently only 'msft' supported |
+| `params.url` | String | Captify live-classification service url | no | Defaults to `https://live-classification.cpx.to/prebid-segments` |
diff --git a/dev-docs/modules/contxtfulRtdProvider.md b/dev-docs/modules/contxtfulRtdProvider.md
index b5523da656..b5297e7fd6 100644
--- a/dev-docs/modules/contxtfulRtdProvider.md
+++ b/dev-docs/modules/contxtfulRtdProvider.md
@@ -57,13 +57,13 @@ pbjs.setConfig({
 ## Parameters
 
 {: .table .table-bordered .table-striped }
-| Name                | Type     | Scope    | Description                                |
-|---------------------|----------|----------|--------------------------------------------|
-| `version`           | `String` | Required | Specifies the version of the Contxtful Receptivity API. |
-| `customer`          | `String` | Required | Your unique customer identifier.           |
-| `hostname`          | `String` | Optional | Target URL for CONTXTFUL external JavaScript file. Default is "api.receptivity.io". Changing default behaviour is not recommended. Please reach out to [contact@contxtful.com](mailto:contact@contxtful.com) if you experience issues. |
-| `adServerTargeting` | `Boolean`| Optional | Enables the `getTargetingData` to inject targeting value in ad units. Setting to true enables the feature, false disables the feature. Default is true      |
-| `bidders`           | `Array`  | Optional | Setting this array enables Receptivity in the `ortb2` object through `getBidRequestData` for all the listed `bidders`. Default is `[]` (an empty array). RECOMMENDED : Add all the bidders active like this `["bidderCode1", "bidderCode", "..."]` |
+| Name | Type | Scope | Description |
+| :--- | :--- | :--- | :--- |
+| `version` | `String` | Required | Specifies the version of the Contxtful Receptivity API. |
+| `customer` | `String` | Required | Your unique customer identifier. |
+| `hostname` | `String` | Optional | Target URL for CONTXTFUL external JavaScript file. Default is "api.receptivity.io". Changing default behaviour is not recommended. Please reach out to [contact@contxtful.com](mailto:contact@contxtful.com) if you experience issues. |
+| `adServerTargeting` | `Boolean` | Optional | Enables the `getTargetingData` to inject targeting value in ad units. Setting to true enables the feature, false disables the feature. Default is true |
+| `bidders` | `Array` | Optional | Setting this array enables Receptivity in the `ortb2` object through `getBidRequestData` for all the listed `bidders`. Default is `[]` (an empty array). RECOMMENDED : Add all the bidders active like this `["bidderCode1", "bidderCode", "..."]` |
 
 ## Usage: Injection in Ad Servers
 
@@ -93,7 +93,7 @@ To view an integration example:
 1. In your CLI run:
 
     ```bash
-    gulp serve --modules=rtdModule,appnexusBidAdapter,rubiconBidAdapter,sharethroughBidAdapter,contxtfulRtdProvider
+    gulp serve --modules=rtdModule,bidderABidAdapter,bidderBBidAdapter,bidderCBidAdapter,contxtfulRtdProvider
     ```
 
 2. In your browser, navigate to:
diff --git a/dev-docs/modules/dgkeywordRtdProvider.md b/dev-docs/modules/dgkeywordRtdProvider.md
index b6c0959edc..21a7193e57 100644
--- a/dev-docs/modules/dgkeywordRtdProvider.md
+++ b/dev-docs/modules/dgkeywordRtdProvider.md
@@ -19,10 +19,10 @@ sidebarType : 1
 
 ## Integration
 
-1. Compile the Digital Garage Keyword Module and Appnexus Bid Adapter into your Prebid build:  
+1. Compile the Digital Garage Keyword Module and Microsoft Bid Adapter into your Prebid build:  
 
     ```bash
-    gulp build --modules="dgkeywordRtdProvider,appnexusBidAdapter,..."  
+    gulp build --modules="dgkeywordRtdProvider,bidderABidAdapter,..."  
     ```
 
 2. Use `setConfig` to instruct Prebid.js to initilize the dgkeyword module, as specified below.
@@ -50,9 +50,9 @@ pbjs.setConfig({
 Syntax details:
 
 {: .table .table-bordered .table-striped }
-| Name  |Type | Description   | Notes  |
-| :------------ | :------------ | :------------ |:------------ |
-| name  | String | Real time data module name | Always 'dgkeyword' |
+| Name | Type | Description | Notes |
+| :--- | :--- | :--- | :--- |
+| name | String | Real time data module name | Always 'dgkeyword' |
 | waitForIt | Boolean | Should be `true` if there's an `auctionDelay` defined (optional) | `false` |
-| params  | Object |   |   |
-| params.timeout  | Integer |timeout (ms)| 1000 |
+| params | Object | | |
+| params.timeout | Integer | timeout (ms) | 1000 |
diff --git a/dev-docs/modules/genericAnalyticsAdapter.md b/dev-docs/modules/genericAnalyticsAdapter.md
index 201410e70b..e3fe405552 100644
--- a/dev-docs/modules/genericAnalyticsAdapter.md
+++ b/dev-docs/modules/genericAnalyticsAdapter.md
@@ -15,16 +15,16 @@ This is an analytics adapter that can interface with any backend, meant for publ
 ### Analytics Options
 
 {: .table .table-bordered .table-striped }
-| Name         | Scope              | Type     | Description                                                                                                                                                                                       |
-|--------------|---------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `handler`    | required unless `url` is provided | Function | Custom handler function - [example](#custom-handler)                                                                                                                                              |
-| `url`        | required unless `handler` is  provided  | String   | Data collection URL                                                                                                                                                                               |
-| `method`     | optional | String   | HTTP method used to call `url`. Defaults to `'POST'`                                                                                                                                              |
-| `batchSize`  | optional | Number   | Number of events to collect into a single call to `handler` or `url`. Defaults to `1`                                                                                                             |
-| `batchDelay` | optional | Number   | Time (in milliseconds) to wait before calling `handler` or `url` with an incomplete batch (when fewer than `batchSize` events have been collected). Defaults to `100`                             |
-| `events`     | optional | Object   | Map from event name to a custom format function. When provided, only events in this map will be collected, using the data returned by their corresponding function - [example](#event-formatters) |
-| `gvlid`      | optional | Number   | Global vendor list ID to use for the purpose of GDPR purpose 7 enforcement - see [note](#gdpr) |
-| `sampling`   | optional | Number   | Sampling rate, expressed as a number between 0 and 1. Data is collected only on this ratio of browser sessions. Defaults to `1`                                                               |
+| Name | Scope | Type | Description |
+| :--- | :--- | :--- | :--- |
+| `handler` | required unless `url` is provided | Function | Custom handler function - [example](#custom-handler) |
+| `url` | required unless `handler` is provided | String | Data collection URL |
+| `method` | optional | String | HTTP method used to call `url`. Defaults to `'POST'` |
+| `batchSize` | optional | Number | Number of events to collect into a single call to `handler` or `url`. Defaults to `1` |
+| `batchDelay` | optional | Number | Time (in milliseconds) to wait before calling `handler` or `url` with an incomplete batch (when fewer than `batchSize` events have been collected). Defaults to `100` |
+| `events` | optional | Object | Map from event name to a custom format function. When provided, only events in this map will be collected, using the data returned by their corresponding function - [example](#event-formatters) |
+| `gvlid` | optional | Number | Global vendor list ID to use for the purpose of GDPR purpose 7 enforcement - see [note](#gdpr) |
+| `sampling` | optional | Number | Sampling rate, expressed as a number between 0 and 1. Data is collected only on this ratio of browser sessions. Defaults to `1` |
 
 <a id="gdpr"></a>
 
@@ -125,7 +125,7 @@ Example request payload:
     {
         "eventType": "bidRequested",
         "args": {
-            "bidderCode": "appnexus",
+            "bidderCode": "bidderA",
             "auctionId": "db4edde6-ee66-4779-b7ed-c7295d3e3c49",
             "bidderRequestId": "3cf3eaf48bd5f48",
             "uniquePbsTid": "1565fd02-d4fd-4369-bf8e-0dee2a00aca5",
@@ -189,12 +189,12 @@ Example request payload:
 [
   {
     "auctionId": "e41e3fcb-6209-4995-b0be-2aed21a8bdf6",
-    "bidder": "appnexus",
+    "bidder": "bidderA",
     "type": "REQUEST"
   },
   {
     "auctionId": "e41e3fcb-6209-4995-b0be-2aed21a8bdf6",
-    "bidder": "appnexus",
+    "bidder": "bidderA",
     "type": "RESPONSE"
   }
   /* ... */
diff --git a/dev-docs/modules/geoedgeRtdProvider.md b/dev-docs/modules/geoedgeRtdProvider.md
index 944cf0f5bc..6f734d926c 100644
--- a/dev-docs/modules/geoedgeRtdProvider.md
+++ b/dev-docs/modules/geoedgeRtdProvider.md
@@ -74,7 +74,7 @@ To view an integration example:
 1. in your cli run:
 
     ```bash
-    gulp serve --modules=appnexusBidAdapter,geoedgeRtdProvider
+    gulp serve --modules=msftBidAdapter,geoedgeRtdProvider
     ```
 
 2. in your browser, navigate to:
diff --git a/dev-docs/modules/growthCodeRtdProvider.md b/dev-docs/modules/growthCodeRtdProvider.md
index b31397709c..9ff17aae13 100644
--- a/dev-docs/modules/growthCodeRtdProvider.md
+++ b/dev-docs/modules/growthCodeRtdProvider.md
@@ -28,7 +28,7 @@ your advertising strategies.
 
 Compile the GrowthCode RTD module into your Prebid build:
 
-`gulp build --modules=userId,rtdModule,growthCodeRtdProvider,appnexusBidAdapter`
+`gulp build --modules=userId,rtdModule,growthCodeRtdProvider,msftBidAdapter`
 
 Please visit [growthcode.io](https://growthcode.io) for more information.
 
diff --git a/dev-docs/modules/hadronRtdProvider.md b/dev-docs/modules/hadronRtdProvider.md
index 6f3149fbea..d9c2e1918c 100644
--- a/dev-docs/modules/hadronRtdProvider.md
+++ b/dev-docs/modules/hadronRtdProvider.md
@@ -40,7 +40,7 @@ please visit <a href="https://audigent.com">https://audigent.com</a> or contact
 
 Compile the Hadron RTD module into your Prebid build:
 
-`gulp build --modules=userId,unifiedIdSystem,rtdModule,hadronRtdProvider,appnexusBidAdapter`
+`gulp build --modules=userId,unifiedIdSystem,rtdModule,hadronRtdProvider,msftBidAdapter`
 
 Add the Hadron RTD provider to your Prebid config. In this example we will configure
 publisher 1234 to retrieve segments from Audigent. See the
@@ -134,7 +134,7 @@ on how to best configure your own Hadron RTD & Open RTB data handlers.
 
 To view an example of available segments returned by Audigent's backends:
 
-`gulp serve --modules=userId,unifiedIdSystem,rtdModule,hadronRtdProvider,appnexusBidAdapter`
+`gulp serve --modules=userId,unifiedIdSystem,rtdModule,hadronRtdProvider,msftBidAdapter`
 
 and then point your browser at:
 
diff --git a/dev-docs/modules/konduit.md b/dev-docs/modules/konduit.md
index e798acf5e1..5f208a517c 100644
--- a/dev-docs/modules/konduit.md
+++ b/dev-docs/modules/konduit.md
@@ -73,7 +73,7 @@ Konduit platform supports the ‘Send all bids’ scenario, but the GAM configur
 - If Send all bids is enabled, update the GAM line item creative URL as shown here:
 `https://p.konduit.me/api/vastProxy?konduit_hb=1&konduit_hb_awarded=1&konduit_cache_key=%%PATTERN:k_cache_key_BIDDERCODE%%&konduit_id=%%PATTERN:k_id%%`
 
-`k_cache_key_BIDDERCODE` is a bidder-specific macro. Replace ‘BIDDERCODE’ with an actual bidder code, such as `k_cache_key_appnexus`.
+`k_cache_key_BIDDERCODE` is a bidder-specific macro. Replace ‘BIDDERCODE’ with an actual bidder code, such as `k_cache_key_msft`.
 
 Note that the creative URL contains a few custom macros that allow Konduit platform to combine different data for predictive insights functionality.
 
diff --git a/dev-docs/modules/oftmediaRtdProvider.md b/dev-docs/modules/oftmediaRtdProvider.md
index ababdb4866..716cfd97dc 100644
--- a/dev-docs/modules/oftmediaRtdProvider.md
+++ b/dev-docs/modules/oftmediaRtdProvider.md
@@ -56,7 +56,7 @@ pbjs.setConfig({
         params: {
           publisherId: "0653b3fc-a645-4bcc-bfee-b8982974dd53", // Required: Get this ID from 152media
           keywords: ["red", "blue", "white"], // Optional: Contextual keywords
-          bidderCode: "appnexus", // Required: Targeted bidder
+          bidderCode: "msft", // Required: Targeted bidder
           enrichRequest: true // Optional: Adds additional targeting fields
         }
       }
diff --git a/dev-docs/modules/optableRtdProvider.md b/dev-docs/modules/optableRtdProvider.md
index 79c42fb4ba..56f56118f7 100644
--- a/dev-docs/modules/optableRtdProvider.md
+++ b/dev-docs/modules/optableRtdProvider.md
@@ -31,7 +31,7 @@ Optable RTD submodule enriches the OpenRTB request by populating `user.ext.eids`
 Compile the Optable RTD Module with other modules and adapters into your Prebid.js build:
 
 ```bash
-gulp build --modules="rtdModule,optableRtdProvider,appnexusBidAdapter,..."
+gulp build --modules="rtdModule,optableRtdProvider,msftBidAdapter,..."
 ```
 
 > Note that Optable RTD module is dependent on the global real-time data module, `rtdModule`.
@@ -140,7 +140,7 @@ A `handleRtd` function implementation has access to its surrounding context incl
 If you want to see an example of how the optable RTD module works, run the following command:
 
 ```bash
-gulp serve --modules=optableRtdProvider,consentManagementGpp,consentManagementTcf,appnexusBidAdapter
+gulp serve --modules=optableRtdProvider,consentManagementGpp,consentManagementTcf,msftBidAdapter
 ```
 
 and then open the following URL in your browser:
diff --git a/dev-docs/modules/optimeraRtdProvider.md b/dev-docs/modules/optimeraRtdProvider.md
index 8f816eab25..6baa0f88b0 100644
--- a/dev-docs/modules/optimeraRtdProvider.md
+++ b/dev-docs/modules/optimeraRtdProvider.md
@@ -80,7 +80,7 @@ To view an integration example:
 1. in your cli run:
 
     ```bash
-    gulp serve --modules=appnexusBidAdapter,optimeraRtdProvider`
+    gulp serve --modules=msftBidAdapter,optimeraRtdProvider`
     ```
 
 2. in your browser, navigate to:
diff --git a/dev-docs/modules/oxxionRtdProvide.md b/dev-docs/modules/oxxionRtdProvide.md
index 646160121c..78980c80c1 100644
--- a/dev-docs/modules/oxxionRtdProvide.md
+++ b/dev-docs/modules/oxxionRtdProvide.md
@@ -31,7 +31,7 @@ Make sure to have the following modules listed while building prebid : `rtdModul
 For example :
 
 ```bash
-gulp build --modules=schain,priceFloors,currency,consentManagement,appnexusBidAdapter,rubiconBidAdapter,rtdModule,oxxionRtdProvider
+gulp build --modules=schain,priceFloors,currency,consentManagement,msftBidAdapter,rubiconBidAdapter,rtdModule,oxxionRtdProvider
 ```
 
 Then add the oxxion Rtd module to your prebid configuration :
diff --git a/dev-docs/modules/permutiveRtdProvider.md b/dev-docs/modules/permutiveRtdProvider.md
index 4c6dec2f7d..dde1e6009c 100644
--- a/dev-docs/modules/permutiveRtdProvider.md
+++ b/dev-docs/modules/permutiveRtdProvider.md
@@ -44,7 +44,7 @@ pbjs.setConfig({
       name: 'permutive',
       waitForIt: true, // should be true if there's an `auctionDelay`
       params: {
-        acBidders: ['appnexus']
+        acBidders: ['msft']
       }
     }]
   },
diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md
index 50bfac23b0..fd93d90854 100644
--- a/dev-docs/modules/prebidServer.md
+++ b/dev-docs/modules/prebidServer.md
@@ -37,14 +37,13 @@ Video notes:
 
 ## Configuration
 
-Here's an example config enabling the AppNexus Prebid Server:
+Here's an example config enabling the appnexuspsp Prebid Server:
 
 ```javascript
 pbjs.setConfig({
     s2sConfig: {
         accountId : '12345',
-        bidders : ['appnexus','pubmatic', 'rubicon'],
-        defaultVendor: 'appnexus',
+        bidders : ['msft','pubmatic', 'rubicon'],
         timeout: 300
     }
 });
@@ -55,22 +54,21 @@ The same bidder cannot be set in both configs. For example:
 
 ```javascript
 pbjs.setConfig({
-    s2sConfig: [
-      {
-          name: "pbs-appnexus",
-          accountId: '12345',
-          bidders: ['appnexus','pubmatic'],
-          defaultVendor: 'appnexus',
-          timeout: 300,
-      },
-      {
-          name: "pbs-rubicon",
-          accountId: '678910',
-          bidders: ['rubicon'],
-          defaultVendor: 'rubicon',
-          timeout: 300,
-      },
-    ],
+  s2sConfig: {
+    accountId: YOUR_SELLER_MEMBER_ID,
+    bidders: ['msft'],
+    enabled: true,
+    allowUnknownBidderCodes: true,
+    timeout: 1000,
+    endpoint: {
+      p1Consent:   'https://ib.adnxs.com/openrtb2/prebid',
+      noP1Consent: 'https://ib.adnxs-simple.com/openrtb2/prebid'
+    },
+    syncEndpoint: {
+      p1Consent:   'https://prebid.adnxs.com/pbs/v1/cookie_sync',
+      noP1Consent: 'https://prebid.adnxs-simple.com/pbs/v1/cookie_sync'
+    }
+  }
 });
 ```
 
@@ -83,7 +81,6 @@ There are many configuration options for s2sConfig:
 | `name` | Optional | String | A handle for this configuration, used to reference a specific server (when multiple are present) from [ad unit configuration](/dev-docs/adunit-reference.html#stored-imp) |
 | `bidders` | Optional | Array of Strings | Which bidders auctions should take place on the server side |
 | `allowUnknownBidderCodes` | Optional | Boolean | Allow Prebid Server to bid on behalf of bidders that are not explicitly listed in the adUnit. See important [note](#allowUnknownBidderCodes) below. Defaults to `false`. |
-| `defaultVendor` | Optional | String | Automatically includes all following options in the config with vendor's default values.  Individual properties can be overridden by including them in the config along with this setting. See the Additional Notes below for more information. |
 | `enabled` | Optional | Boolean | Enables this s2sConfig block - defaults to `false` |
 | `timeout` | Optional | Integer | Number of milliseconds allowed for the server-side auctions. This should be approximately 200ms-300ms less than your Prebid.js timeout to allow for all bids to be returned in a timely manner. Defaults to 75% of [`bidderTimeout`](/dev-docs/publisher-api-reference/setConfig.html#setConfig-Bidder-Timeouts) or 750ms, whichever is lesser. | 
 | `adapter` | Required | String | Adapter to use to connect to Prebid Server. Defaults to 'prebidServer' |
@@ -111,8 +108,6 @@ If `endpoint` and `syncEndpoint` are objects, these are the supported properties
 
 **Notes on s2sConfig properties**
 
-- Currently supported vendors are: appnexus, openx, and rubicon
-- When using `defaultVendor` option, `accountId` still needs to be defined.
 - If `bidders` is omitted, only adUnits that also omit bidders will be sent to Prebid Server. See the [stored impressions](#stored-imp) example below.
 - If the `s2sConfig` timeout is not specified, Prebid Server will utilize a configured default for `tmax`.
 - When using the `endpoint` or `syncEndpoint` object configs, you should define both properties.  If either property is not defined, Prebid Server requests for that type of user will not be made.  If you do not need to distinguish endpoints for consent reasons, you can simply define the same URL value in both fields or use the String version of the field (which is configured to use defined URL for all users).
@@ -147,7 +142,7 @@ the bad parameter.
 
 ### Defining endpoints
 
-s2sConfig example with the endpoint attributes defined instead of using the 'defaultVendor' approach:
+s2sConfig example with the endpoint attributes defined:
 
 ```javascript
 pbjs.setConfig({
@@ -191,7 +186,8 @@ pbjs.setConfig({
   s2sConfig: [{
     accountId: '1',
     bidders: ['tripleliftVideo'],
-    defaultVendor: 'appnexus',
+    endpoint: 'https://mypbs.example.com/path',
+    syncEndpoint: 'https://mypbs.example.com/path',
     timeout: 500,
     extPrebid: {
       aliases: {
@@ -261,7 +257,6 @@ pbjs.setConfig({
     s2sConfig: [{
         accountId: '1001',
         bidders: ['rubicon', 'pubmatic'],
-        defaultVendor: 'rubicon',
         timeout: 250,
         extPrebid: {
             cache: {
diff --git a/dev-docs/modules/pubCommonId.md b/dev-docs/modules/pubCommonId.md
index 50322e12c0..775adce72f 100644
--- a/dev-docs/modules/pubCommonId.md
+++ b/dev-docs/modules/pubCommonId.md
@@ -71,7 +71,7 @@ Adapters should look for `bid.crumbs.pubcid` in buildRequests() method.
 ```javascript
 [
    {
-      "bidder":"appnexus",
+      "bidder":"msft",
       "params":{
          "placement":"12345"
       },
diff --git a/dev-docs/modules/raveltechRtdProvider.md b/dev-docs/modules/raveltechRtdProvider.md
index 596720699f..e492616d63 100644
--- a/dev-docs/modules/raveltechRtdProvider.md
+++ b/dev-docs/modules/raveltechRtdProvider.md
@@ -48,7 +48,7 @@ Please contact <support@raveltech.io> to activate your adapter after installatio
 ### Build
 
 ```bash
-gulp build --modules="rtdModule,raveltechRtdProvider,appnexusBidAdapter,..."  
+gulp build --modules="rtdModule,raveltechRtdProvider,msftBidAdapter,..."  
 ```
 
 > Note that the global RTD module, `rtdModule`, is a prerequisite of the raveltech RTD module.
@@ -68,7 +68,7 @@ pbjs.setConfig({
         dataProviders: [{
             name: 'raveltech',
             params: {
-                bidders: ['appnexus', 'rubicon'],
+                bidders: ['msft', 'rubicon'],
                 preserveOriginalBid: true
             }
         }]
diff --git a/dev-docs/modules/raynRtdProvider.md b/dev-docs/modules/raynRtdProvider.md
index 81cbcd02bf..ed6decfca0 100644
--- a/dev-docs/modules/raynRtdProvider.md
+++ b/dev-docs/modules/raynRtdProvider.md
@@ -43,7 +43,7 @@ pbjs.setConfig(
                 name: "rayn",
                 waitForIt: true,
                 params: {
-                    bidders: ["appnexus", "pubmatic"],
+                    bidders: ["msft", "pubmatic"],
                     integration: {
                         iabAudienceCategories: {
                             v1_1: {
@@ -103,7 +103,7 @@ Please note that raynRtdProvider should be integrated into the website along wit
 To view an example of the on page setup:
 
 ```bash
-gulp serve-fast --modules=rtdModule,raynRtdProvider,appnexusBidAdapter
+gulp serve-fast --modules=rtdModule,raynRtdProvider,msftBidAdapter
 ```
 
 Then in your browser access: [http://localhost:9999/integrationExamples/gpt/raynRtdProvider_example.html](http://localhost:9999/integrationExamples/gpt/raynRtdProvider_example.html)
diff --git a/dev-docs/modules/relevadRtdProvider.md b/dev-docs/modules/relevadRtdProvider.md
index 9d33922dec..1eb54e9e7a 100644
--- a/dev-docs/modules/relevadRtdProvider.md
+++ b/dev-docs/modules/relevadRtdProvider.md
@@ -46,7 +46,7 @@ pbjs.setConfig({
  
             // The list of bidders to target with Relevad categories and segments. If absent or empty, target all bidders.
             bidders: [
-              { bidder: "appnexus",                   // Bidder name
+              { bidder: "msft",                   // Bidder name
                 adUnitCodes: ['adUnit-1','adUnit-2'], // List of adUnit codes to target. If absent or empty, target all ad units.
                 minscore: 70, // Minimum relevancy score for this bidder (0-100). If absent, defaults to the global minscore.
               },
@@ -81,7 +81,7 @@ pbjs.setConfig({
 
 | Name        | Type             | Description                                                  | Notes                                                    |
 | :---------- | :--------------- | :----------------------------------------------------------- | :------------------------------------------------------- |
-| bidder      | String           | Bidder name                                                  | Mandatory. Example: “appnexus”                           |
+| bidder      | String           | Bidder name                                                  | Mandatory. Example: "msft"                           |
 | adUnitCodes | Array of Strings | List of specific AdUnit codes you with to target             | Optional. If empty or absent, all ad units are targeted. |
 | minscore    | Integer          | Bidder-specific minimum categorization relevancy score (0, 100) | Optional, defaults to global minscore above.             |
 
diff --git a/dev-docs/modules/s2sTesting.md b/dev-docs/modules/s2sTesting.md
index e227acf841..51599ce02a 100644
--- a/dev-docs/modules/s2sTesting.md
+++ b/dev-docs/modules/s2sTesting.md
@@ -116,7 +116,7 @@ keep in mind the various data sources you may have access to:
 monitor revenue impact before going entirely to server-side header bidding.
 I don't want to modify AdUnits because that's time consuming in the CMS.*
 
-Example S2S Config defining that 10% of Rubicon requests and 100% of AppNexus requests go through the server:
+Example S2S Config defining that 10% of Rubicon requests and 100% of Microsoft requests go through the server:
 
 ```javascript
 pbjs.setConfig({
diff --git a/dev-docs/modules/scope3RtdProvider.md b/dev-docs/modules/scope3RtdProvider.md
index bac3d92a13..251b547b21 100644
--- a/dev-docs/modules/scope3RtdProvider.md
+++ b/dev-docs/modules/scope3RtdProvider.md
@@ -62,7 +62,7 @@ pbjs.setConfig({
                 orgId: "your-org-id",
                 endpoint: "<https://prebid.scope3.com/prebid>",
                 timeout: 1500,
-                bidders: ["appnexus", "rubicon", "pubmatic"],
+                bidders: ["msft", "rubicon", "pubmatic"],
                 includeKey: "axei",
                 excludeKey: "axex",
                 macroKey: "axem",
@@ -105,7 +105,7 @@ The Scope3 AEE returns signals in this format:
     "exclude": ["competitor_exposed"],
     "macro": "eyJjb250ZXh0IjogImhpZ2hfdmFsdWUifQ==",
     "bidders": {
-      "appnexus": {
+      "msft": {
         "segments": ["seg1", "seg2"],
         "deals": ["DEAL123"]
       },
diff --git a/dev-docs/modules/sirdataRtdProvider.md b/dev-docs/modules/sirdataRtdProvider.md
index 724a036dac..0e10ca0f00 100644
--- a/dev-docs/modules/sirdataRtdProvider.md
+++ b/dev-docs/modules/sirdataRtdProvider.md
@@ -125,7 +125,7 @@ Bidders can receive common setting :
 
 As indicated above, it is possible to provide your own bid augmentation functions. This is useful if you know a bid adapter's API supports segment fields which aren't specifically being added to request objects in the Prebid bid adapter.
 
-Please see the following example, which provides a function to modify bids for a bid adapter called ix and overrides the appnexus.
+Please see the following example, which provides a function to modify bids for a bid adapter called ix and overrides the msft.
 data Object format for usage in this kind of function :
 
 ```json
@@ -182,7 +182,7 @@ data Object format for usage in this kind of function :
 ```
 
 ```javascript
-function overrideAppnexus (adUnit, segmentsArray, dataObject, bid) {
+function overrideMsft (adUnit, segmentsArray, dataObject, bid) {
     for (var i = 0; i < segmentsArray.length; i++) {
         if (segmentsArray[i]) {
             bid.params.user.segments.push(segmentsArray[i]);
@@ -205,8 +205,8 @@ pbjs.setConfig({
                     contextualMinRelevancyScore: 50, //Min score to keep contextual category in the bidders (0-100 scale)
                     actualUrl: actual_url, //top location url, for contextual categories
                     bidders: [{
-                        bidder: 'appnexus',
-                        customFunction: overrideAppnexus,
+                        bidder: 'msft',
+                        customFunction: overrideMsft,
                         curationId: '111'
                     },{
                         bidder: 'ix',
@@ -227,7 +227,7 @@ pbjs.setConfig({
 To view an example of available segments returned by Sirdata's backends:
 
 ```bash
-gulp serve --modules=rtdModule,sirdataRtdProvider,appnexusBidAdapter
+gulp serve --modules=rtdModule,sirdataRtdProvider,msftBidAdapter
 ```
 
 and then point your browser at:
diff --git a/dev-docs/modules/symitriDapRtdProvider.md b/dev-docs/modules/symitriDapRtdProvider.md
index 66211f6908..ab93999dae 100644
--- a/dev-docs/modules/symitriDapRtdProvider.md
+++ b/dev-docs/modules/symitriDapRtdProvider.md
@@ -107,7 +107,7 @@ pbjs.setConfig({
 To view an example of available segments returned by dap:
 
 ```bash
-gulp serve --modules=rtdModule,symitriDapRtdProvider,appnexusBidAdapter,sovrnBidAdapter
+gulp serve --modules=rtdModule,symitriDapRtdProvider,msftBidAdapter,sovrnBidAdapter
 ```
 
 and then point your browser at:
diff --git a/dev-docs/modules/weboramaRtdProvider.md b/dev-docs/modules/weboramaRtdProvider.md
index f558c47da3..1d21923776 100644
--- a/dev-docs/modules/weboramaRtdProvider.md
+++ b/dev-docs/modules/weboramaRtdProvider.md
@@ -219,16 +219,16 @@ This property support the following types
 | Type  | Description | Example   | Notes  |
 | :------------ | :------------ | :------------ |:------------ |
 | Boolean|If true, send data to all bidders, or not in case of false| `true` | default value |
-| String|Will send data to only one bidder | `'appnexus'` |  |
-| Array of Strings|Will send data to only some bidders | `['appnexus','pubmatic']` |  |
-| Object |Will send data to only some bidders and some ad units | `{appnexus: true, pubmatic:['adUnitCode1']}` |  |
-| Callback |Will be executed for each adunit, expects return a true value to set prebid targeting or not| `function(bid, adUnitCode){return bid.bidder == 'appnexus' && adUnitCode == 'adUnitCode';}` |  |
+| String|Will send data to only one bidder | `'msft'` |  |
+| Array of Strings|Will send data to only some bidders | `['msft','pubmatic']` |  |
+| Object |Will send data to only some bidders and some ad units | `{msft: true, pubmatic:['adUnitCode1']}` |  |
+| Callback |Will be executed for each adunit, expects return a true value to set prebid targeting or not| `function(bid, adUnitCode){return bid.bidder == 'msft' && adUnitCode == 'adUnitCode';}` |  |
 
 A better look on the `Object` type
 
 ```javascript
 sendToBidders: {
-    appnexus: true,           // send profile to appnexus on all ad units
+    msft: true,           // send profile to msft on all ad units
     pubmatic: ['adUnitCode1'],// send profile to pubmatic on this ad units 
 }
 ```
@@ -254,8 +254,8 @@ It is possible customize the targeting based on the parameters:
 
 ```javascript
 sendToBidders: function(bid, adUnitCode, data, metadata){
-    if (bid.bidder == 'appnexus' && adUnitCode == 'adUnitCode1'){
-        data['foo']=['bar']; // add this section only for appnexus + adUnitCode1
+    if (bid.bidder == 'msft' && adUnitCode == 'adUnitCode1'){
+        data['foo']=['bar']; // add this section only for msft + adUnitCode1
         delete data['other']; // remove this section
     }
     return true;
@@ -282,7 +282,7 @@ sendToBidders: function(bid, adUnitCode, data, metadata){
 In case of using bid _aliases_, we should match the same string used in the adUnit configuration.
 
 ```javascript
-pbjs.aliasBidder('appnexus', 'foo');
+pbjs.aliasBidder('msft', 'foo');
 pbjs.aliasBidder('criteo', 'bar');
 pbjs.aliasBidder('pubmatic', 'baz');
 pbjs.setConfig({
@@ -503,7 +503,7 @@ pbjs.que.push(function () {
                     weboCtxConf: {
                         token: "to-be-defined", // mandatory
                         setPrebidTargeting: ['adUnitCode1',...], // set target only on certain adunits 
-                        sendToBidders: ['appnexus',...], // overide, send to only some bidders
+                        sendToBidders: ['msft',...], // overide, send to only some bidders
                         enabled: true,
                     },
                     weboUserDataConf: {
@@ -553,7 +553,7 @@ pbjs.que.push(function () {
                         token: "to-be-defined", // mandatory
                         targetURL: "https://prebid.org", // default is document.URL
                         setPrebidTargeting: true, // override param.setPrebidTargeting or default true
-                        sendToBidders: ['appnexus',...], // overide, send to only some bidders
+                        sendToBidders: ['msft',...], // overide, send to only some bidders
                         defaultProfile: {         // optional
                             webo_ctx: ['moon'],
                             webo_ds: ['bar']
@@ -565,7 +565,7 @@ pbjs.que.push(function () {
                         accountId: 12345,           // recommended
                         setPrebidTargeting: ['adUnitCode1',...], // set target only on certain adunits 
                         sendToBidders: { // send to only some bidders and adunits
-                            'appnexus': true,               // all adunits for appnexus 
+                            'msft': true,               // all adunits for msft 
                             'pubmatic': ['adUnitCode1',...] // some adunits for pubmatic
                             // other bidders will be ignored
                         },
@@ -582,7 +582,7 @@ pbjs.que.push(function () {
                             return adUnitCode == 'adUnitCode1';
                         },
                         sendToBidders: function(bid, adUnitCode){ // specify sendToBidders via callback
-                            return bid.bidder == 'appnexus' && adUnitCode == 'adUnitCode1';
+                            return bid.bidder == 'msft' && adUnitCode == 'adUnitCode1';
                         }
                         defaultProfile: {           // optional
                             lite_occupation: ['gérant', 'bénévole'],
@@ -603,7 +603,7 @@ pbjs.que.push(function () {
 
 We currently support the following bidder adapters with dedicated code:
 
-* AppNexus SSP
+* Microsoft SSP
 
 We also set the bidder (and global, if no specific bidders are set on `sendToBidders`) ortb2 `site.ext.data` and `user.ext.data` sections (as arbitrary data). The following bidders may support it, to be sure, check the `First Party Data Support` on the feature list for the particular bidder from [here](https://docs.prebid.org/dev-docs/bidders).
 
@@ -645,7 +645,7 @@ We also set the bidder (and global, if no specific bidders are set on `sendToBid
 
 To view an example of available segments returned by Weborama's backends:
 
-`gulp serve --notest --nolint --modules=rtdModule,weboramaRtdProvider,smartadserverBidAdapter,pubmaticBidAdapter,appnexusBidAdapter,rubiconBidAdapter,criteoBidAdapter`
+`gulp serve --notest --nolint --modules=rtdModule,weboramaRtdProvider,smartadserverBidAdapter,pubmaticBidAdapter,msftBidAdapter,rubiconBidAdapter,criteoBidAdapter`
 
 and then point your browser at:
 
diff --git a/dev-docs/modules/wurflRtdProvider.md b/dev-docs/modules/wurflRtdProvider.md
index 4721c0ea3e..93f4e86308 100644
--- a/dev-docs/modules/wurflRtdProvider.md
+++ b/dev-docs/modules/wurflRtdProvider.md
@@ -100,7 +100,7 @@ While the WURFL RTD module enriches the OpenRTB 2.0 payload, SSP adapters must a
 To build the WURFL RTD module with Prebid.js:
 
 ```bash
-gulp build --modules="wurflRtdProvider,appnexusBidAdapter,..."
+gulp build --modules="wurflRtdProvider,msftBidAdapter,..."
 ```
 
 ## Configuration
@@ -137,7 +137,7 @@ pbjs.setConfig({
 To test the WURFL RTD module locally:
 
 ```bash
-gulp serve --modules=wurflRtdProvider,appnexusBidAdapter
+gulp serve --modules=wurflRtdProvider,msftBidAdapter
 ```
 
 Then navigate to:
diff --git a/dev-docs/plugins/bc/about-bc-prebid-plugin.md b/dev-docs/plugins/bc/about-bc-prebid-plugin.md
index 98f24954ca..f36746c00a 100644
--- a/dev-docs/plugins/bc/about-bc-prebid-plugin.md
+++ b/dev-docs/plugins/bc/about-bc-prebid-plugin.md
@@ -29,9 +29,9 @@ The Brightcove Prebid Plugin supports the following features:
   * Single Ad Playback via VAST XML at one or more ad break positions within a video. (For example, you can specify options for a preroll and a postroll ad in a single call to the plugin.)
   * Versions up thru VAST 3.0
   * Both Video and VPAID creatives
-  * If the AppNexus Viewability Wrapper is delivered:
-    * AppNexus viewability measurement
-    * AppNexus domain detection
+  * If the Microsoft Viewability Wrapper is delivered:
+    * Microsoft viewability measurement
+    * Microsoft domain detection
 
 * The plugin supports more than one ad renderer by default.
   * If Google Ad Manager is detected as the primary ad server (indicated by the presence of dfpParameters) for *any* of the ad breaks specified in the Prebid options, then the Brightcove IMA Plugin will be used to render the ad.
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-api.md b/dev-docs/plugins/bc/bc-prebid-plugin-api.md
index d9be241b21..19c99c263f 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-api.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-api.md
@@ -123,9 +123,9 @@ If the results of the prebid process is being determined outside of the plugin,
             }
         },
         "bids": [{
-            "bidder": "appnexus",
+            "bidder": "msft",
             "params": {
-                "placementId": 8845778
+                "placement_id": 8845778
             }
         }]
     },
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-integration-dynamic.md b/dev-docs/plugins/bc/bc-prebid-plugin-integration-dynamic.md
index 0a4e4af9dc..72909a5b17 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-integration-dynamic.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-integration-dynamic.md
@@ -66,16 +66,16 @@ Once the Brightcove Player has loaded, then publisher needs to call `renderAd()`
     // define options for ad playback
     window.bc_plugin_pbjs = {plugin_prebid_options: {}};
     // specify prebid parameters as the value of biddersSpec
-    // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+    // the set of bidders here shows how to specify the Microsoft video bidder:  msft
     var params = {
             code : 'my-video-tag',
             sizes : [640, 480],
             mediaType: 'video',
             bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 12334567,
+                        placement_id: 12334567,
                         video: {
                             skippable: true,
                             playback_method: ['auto_play_sound_off']
@@ -172,16 +172,16 @@ To do this, the publisher must add code in the body of the document where the Br
     // define options for prebid
     var plugin_options = {};
     // specify prebid parameters as the value of biddersSpec
-    // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+    // the set of bidders here shows how to specify the Microsoft video bidder:  msft
     var params = {
             code : 'my-video-tag',
             sizes : [640, 480],
             mediaType: 'video',
             bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 12334567,
+                        placement_id: 12334567,
                         video: {
                             skippable: true,
                             playback_method: ['auto_play_sound_off']
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md b/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
index d7f53f6e03..d5fb9c78a1 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-integration-studio.md
@@ -143,9 +143,9 @@ var adOptions =
             }
         },
         "bids": [{
-            "bidder": "appnexus",
+            "bidder": "msft",
             "params": {
-                "placementId": 8845778
+                "placement_id": 8845778
             }
         }]
     },
@@ -252,7 +252,7 @@ None
     "bidderAliases": [
         {
             "name": "alias1",
-            "bidderName": "appnexus"
+            "bidderName": "msft"
         }
     ],
     "biddersSpec": {
@@ -268,9 +268,9 @@ None
             }
         },
         "bids": [{
-            "bidder": "appnexus",
+            "bidder": "msft",
             "params": {
-                "placementId": 8845778,
+                "placement_id": 8845778,
                 "video": {"skippable": true,
                 "playback_method":
                     ["auto_play_sound_off"]
@@ -329,7 +329,7 @@ None
                 }
             ]
         },
-        "appnexus": {
+        "msft": {
             "adserverTargeting": [
                 {
                     "key": "hb_size",
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md b/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
index 7edbfcf383..2651465f7b 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-multiad-options.md
@@ -58,9 +58,9 @@ The following is a sample JSON definition of the plugin configuration defining c
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 12527596
+                    "placement_id": 12527596
                 }
             }
         ]
@@ -153,9 +153,9 @@ The following is a sample JSON definition of the plugin configuration defining c
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 12531984
+                    "placement_id": 12531984
                 }
             }
         ]
@@ -259,9 +259,9 @@ The following is a sample JSON definition of the plugin configuration defining c
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 12527596
+                    "placement_id": 12527596
                 }
             }
         ]
@@ -355,9 +355,9 @@ The following is a sample JSON definition of the plugin configuration defining c
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 12531984
+                    "placement_id": 12531984
                 }
             }
         ]
@@ -451,9 +451,9 @@ The following is a sample JSON definition of the plugin configuration defining c
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 12531977
+                    "placement_id": 12531977
                 }
             }
         ]
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md b/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
index 0c28b7e060..1635d26d5b 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-prebid-options.md
@@ -129,11 +129,11 @@ None
 ```javascript
 "bidderAliases": [
     {
-      "bidderName": "appnexus",
+      "bidderName": "msft",
       "name": "alias1"
     },
     {
-      "bidderName": "appnexus",
+      "bidderName": "msft",
       "name": "alias2"
     }
 ]
@@ -610,7 +610,7 @@ No
 
 The publisher must pass the prebid parameters to the plugin, via the `biddersSpec` option, if the plugin is expected to invoke the prebid process.  The syntax for these parameters is defined in [Bidders' Params]({{site.baseurl}}/dev-docs/bidders.html) on Prebid.org.
 
-Use the parameters for AppNexus bidder to include an AppNexus bidder for video ads.
+Use the parameters for Microsoft bidder to include an Microsoft bidder for video ads.
 
 If these parameters are not specified, the plugin assumes that the prebid process has occurred outside of the plugin and that the results of the header bidding will be provided to the plugin via the `headerBiddingResult` option.
 
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-body.md b/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-body.md
index 9a5970d373..32b2e94391 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-body.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-body.md
@@ -69,16 +69,16 @@ The following is a sample Brightcove Player Prebid Plugin integration that invok
 
     // set the prebid options
     // specify prebid parameters as the value of biddersSpec
-    // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+    // the set of bidders here shows how to specify the Microsoft video bidder:  msft
     var params = {
          code : 'my-video-tag',
          sizes : [640, 480],
          mediaType: 'video',
          bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 12334567,
+                        placement_id: 12334567,
                         video: {
                             skippable: true,
                             playback_method: ['auto_play_sound_off']
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-header.md b/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-header.md
index 11062bc016..6f35b5d230 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-header.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-sample-prebid-header.md
@@ -47,7 +47,7 @@ The following is a sample Brightcove Player Prebid Plugin integration that invok
         window.bc_plugin_pbjs = { plugin_prebid_options: {} };
 
         // specify prebid parameters as the value of biddersSpec
-        // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+        // the set of bidders here shows how to specify the Microsoft video bidder:  msft
         var params = {
             code : 'my-video-tag',
             mediaTypes: {
@@ -61,9 +61,9 @@ The following is a sample Brightcove Player Prebid Plugin integration that invok
                 }
                 bids: [
                     {
-                        bidder: 'appnexus',
+                        bidder: 'msft',
                         params: {
-                            placementId: 12334567
+                            placement_id: 12334567
                         }
                     }
                 ]
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md b/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
index 6f6ca02132..ef161b5522 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-sample-studio-integration-general-method.md
@@ -65,9 +65,9 @@ This page presents a sample publisher page using the General Integration Method
                 }
             },
             "bids": [{
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 8845778
+                    "placement_id": 8845778
                 }
             }]
         },
diff --git a/dev-docs/plugins/bc/bc-prebid-plugin-sample-third-party-ad-server.md b/dev-docs/plugins/bc/bc-prebid-plugin-sample-third-party-ad-server.md
index 4efd8fb244..e4b92f7962 100644
--- a/dev-docs/plugins/bc/bc-prebid-plugin-sample-third-party-ad-server.md
+++ b/dev-docs/plugins/bc/bc-prebid-plugin-sample-third-party-ad-server.md
@@ -42,16 +42,16 @@ The following is a sample Brightcove Prebid Plugin integration that invokes preb
         window.bc_plugin_pbjs = { plugin_prebid_options: {} };
 
         // specify prebid parameters as the value of biddersSpec
-        // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+        // the set of bidders here shows how to specify the Microsoft video bidder:  msft
         var params = {
             code : 'my-video-tag',
             sizes : [640, 480],
             mediaType: 'video',
             bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 12334567,
+                        placement_id: 12334567,
                         video: {
                             skippable: true,
                             playback_method: ['auto_play_sound_off']
@@ -152,16 +152,16 @@ The following is a sample Brightcove Prebid Plugin integration that invokes preb
 
     // set the prebid options
     // specify prebid parameters as the value of biddersSpec
-    // the set of bidders here shows how to specify the AppNexus video bidder:  appnexus
+    // the set of bidders here shows how to specify the Microsoft video bidder:  msft
     var params = {
          code : 'my-video-tag',
          sizes : [640, 480],
          mediaType: 'video',
          bids: [
                 {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                     params: {
-                        placementId: 12334567,
+                        placement_id: 12334567,
                         video: {
                             skippable: true,
                             playback_method: ['auto_play_sound_off']
diff --git a/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md b/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
index ee65cff4a8..98c9365d14 100644
--- a/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
+++ b/dev-docs/plugins/cross-player-prebid-component/cross-player-config.md
@@ -109,11 +109,11 @@ None
 ```javascript
 "bidderAliases": [
     {
-      "bidderName": "appnexus",
+      "bidderName": "msft",
       "name": "alias1"
     },
     {
-      "bidderName": "appnexus",
+      "bidderName": "msft",
       "name": "alias2"
     }
 ]
@@ -324,9 +324,9 @@ Here is a sample Prebid configuration JSON object returned via URL:
         },
         "bids": [
             {
-                "bidder": "appnexus",
+                "bidder": "msft",
                 "params": {
-                    "placementId": 9999
+                    "placement_id": 9999
                 }
             }
         ]
@@ -372,10 +372,10 @@ Here is a sample Prebid configuration JSON object returned via URL:
                 }
             ]
         },
-        "appnexus": {
+        "msft": {
             "adserverTargeting": [
                 {
-                    "key": "hb_appnexus_key1",
+                    "key": "hb_msft_key1",
                     "val": [
                         "valueIsFunction",
                         "function (bidResponse) {",
@@ -384,7 +384,7 @@ Here is a sample Prebid configuration JSON object returned via URL:
                     ]
                 },
                 {
-                    "key": "hb_appnexus_key2",
+                    "key": "hb_msft_key2",
                     "val": [
                         "valueIsFunction",
                         "function (bidResponse) {",
@@ -393,7 +393,7 @@ Here is a sample Prebid configuration JSON object returned via URL:
                     ]
                 },
                 {
-                    "key": "hb_appnexus_key3",
+                    "key": "hb_msft_key3",
                     "val": "value3"
                 }
             ]
diff --git a/dev-docs/publisher-api-reference/addAdUnits.md b/dev-docs/publisher-api-reference/addAdUnits.md
index 4af75f0210..3d1b0e339b 100644
--- a/dev-docs/publisher-api-reference/addAdUnits.md
+++ b/dev-docs/publisher-api-reference/addAdUnits.md
@@ -13,7 +13,7 @@ Takes one ad unit object or an array of ad unit objects and adds them to the Pre
 
 <a name="addAdUnits-AdUnitProperties"></a>
 
-#### Ad Unit Properties
+## Ad Unit Properties
 
 See the table below for the list of properties on the ad unit.  For example ad units, see the [Examples](#addAdUnits-Examples) below.
 
@@ -30,7 +30,7 @@ See the table below for the list of properties on the ad unit.  For example ad u
 
 <a name="addAdUnits-Bids"></a>
 
-##### Bids
+### Bids
 
 See the table below for the list of properties in the `bids` array of the ad unit.  For example ad units, see the [Examples](#addAdUnits-Examples) below.
 
@@ -47,7 +47,7 @@ Note that `bids` is optional only for [Prebid Server stored impressions](/dev-do
 
 <a name="addAdUnits-MediaTypes"></a>
 
-##### Media Types
+### Media Types
 
 See the table below for the list of properties in the `mediaTypes` object of the ad unit.  For example ad units showing the different media types, see the [Examples](#addAdUnits-Examples) below.
 
@@ -58,7 +58,7 @@ See the table below for the list of properties in the `mediaTypes` object of the
 | `native` | optional | Object | Defines properties of a native ad.  For an example native ad unit, see [the native example below](#adUnit-native). |
 | `video`  | optional | Object | Defines properties of a video ad.  For examples, see [the video examples below](#adUnit-video).                    |
 
-#### Video
+### Video
 
 For the list of properties please visit the [adUnit.video reference]({{site.baseurl}}/dev-docs/adunit-reference.html#adUnit.video).
 
@@ -112,9 +112,9 @@ pbjs.addAdUnits({
     },
     bids: [
         {
-            bidder: 'appnexus',
+            bidder: 'bidderA',
             params: {
-                placementId: 13232354
+                placement_id: 13232354
             }
         }
     ]
@@ -143,9 +143,9 @@ pbjs.addAdUnits({
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'bidderA',
         params: {
-            placementId: 13232361
+            placement_id: 13232361
         }
     }]
 });
@@ -167,9 +167,9 @@ pbjs.addAdUnits({
         },
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'bidderA',
         params: {
-            placementId: 13232361
+            placement_id: 13232361
         }
     }]
 });
@@ -219,9 +219,9 @@ pbjs.addAdUnits({
     },
     bids: [
         {
-            bidder: 'appnexus',
+            bidder: 'bidderA',
             params: {
-                placementId: 13144370
+                placement_id: 13144370
             }
         }
     ]
diff --git a/dev-docs/publisher-api-reference/aliasBidder.md b/dev-docs/publisher-api-reference/aliasBidder.md
index 590cfc3584..0618f496c9 100644
--- a/dev-docs/publisher-api-reference/aliasBidder.md
+++ b/dev-docs/publisher-api-reference/aliasBidder.md
@@ -9,11 +9,11 @@ To define an alias for a bidder adapter, call this method at runtime:
 
 ```javascript
 
-pbjs.aliasBidder('appnexus', 'newAlias', optionsObject);
+pbjs.aliasBidder('bidderA', 'newAlias', optionsObject);
 
 ```
 
-Defining an alias can help avoid user confusion since it's possible to send parameters to the same adapter but in different contexts (e.g, The publisher uses `"appnexus"` for demand and also uses `"newAlias"` which is an SSP partner that uses the `"appnexus"` adapter to serve their own unique demand).
+Defining an alias can help avoid user confusion since it's possible to send parameters to the same adapter but in different contexts (e.g, The publisher uses `"bidderA"` for demand and also uses `"newAlias"` which is an SSP partner that uses the `"bidderA"` adapter to serve their own unique demand).
 
 If you define an alias and are using `pbjs.sendAllBids`, you must also set up additional line items in the ad server with keyword targeting that matches the name of the alias.  For example:
 
@@ -25,8 +25,8 @@ If you define an alias and are using `pbjs.sendAllBids`, you must also set up ad
 The options object supports these parameters:
 
 {: .table .table-bordered .table-striped }
-| Option Parameter    | Scope    | Type    | Description             |
-|------------|---------|---------|---------------------------------|
+| Option Parameter | Scope | Type | Description |
+| :--- | :--- | :--- | :--- |
 | gvlid | optional | integer | IAB Global Vendor List ID for this alias for use with the [TCF control module](/dev-docs/modules/tcfControl.html). |
 | useBaseGvlid | optional | boolean | Flag determining if the GVL ID of the original adapter should be re-used. (PBJS 9.14+) |
 
diff --git a/dev-docs/publisher-api-reference/bidderSettings.md b/dev-docs/publisher-api-reference/bidderSettings.md
index a319828a39..641d33d637 100644
--- a/dev-docs/publisher-api-reference/bidderSettings.md
+++ b/dev-docs/publisher-api-reference/bidderSettings.md
@@ -120,13 +120,13 @@ Note that the existence of `bidderSettings.adserverTargeting.standard` will prev
 **Keyword targeting for a specific bidder**
 
 Let’s say the bidder prefers a separate set of line items. You can overwrite the bidder
-settings as the below example for AppNexus shows.
+settings as the below example for Microsoft shows.
 
 *Note that the line item setup has to match the targeting change*
 
 ```javascript
 pbjs.bidderSettings = {
-    appnexus: {
+    msft: {
       sendStandardTargeting: false,
       adserverTargeting: [
         {
@@ -145,7 +145,7 @@ pbjs.bidderSettings = {
 }
 ```
 
-In other words, the above config sends 2 pairs of key/value strings targeting for every AppNexus bid and for every ad unit. The 1st pair would be `apn_pbMg` => the value of `bidResponse.pbMg`. The 2nd pair would be `apn_adId` => the value of `bidResponse.adId`. See [common bid response parameters](/troubleshooting/troubleshooting-guide.html#common-bid-response-parameters) for bidResponse object documentation.
+In other words, the above config sends 2 pairs of key/value strings targeting for every Microsoft bid and for every ad unit. The 1st pair would be `apn_pbMg` => the value of `bidResponse.pbMg`. The 2nd pair would be `apn_adId` => the value of `bidResponse.adId`. See [common bid response parameters](/troubleshooting/troubleshooting-guide.html#common-bid-response-parameters) for bidResponse object documentation.
 
 Note that sendStandardTargeting is set to false so that the standard Prebid targeting (hb_bidder, etc.) aren't also sent to the ad server.
 
@@ -322,7 +322,7 @@ pbjs.bidderSettings = {
         allowedAlternateBidderCodes: ["groupm"],
         [...]
     },
-    appnexus: {
+    msft: {
         allowAlternateBidderCodes: true,
         allowedAlternateBidderCodes: ["*"],
         bidCpmAdjustment: function(bidCpm, bid){ return bidCpm * .90; },
@@ -336,7 +336,7 @@ pbjs.bidderSettings = {
 ```
 
 In the above example, `groupm` bid will have a bid adjustment of 80% since the `bidCpmAdjustment` function says so.<br />
-If `appnexus` bids with another bidder code, say `appnexus2`. This bidder code will adjust the bid cpm to 95% because it will apply the `bidCpmAdjustment` function from `standard` setting, since the `bidCpmAdjustment` is missing for given bidder code I.e `appnexus2`
+If `msft` bids with another bidder code, say `msft2`. This bidder code will adjust the bid cpm to 95% because it will apply the `bidCpmAdjustment` function from `standard` setting, since the `bidCpmAdjustment` is missing for given bidder code I.e `msft2`
 
 ### 2.11. adjustAlternateBids
 
@@ -361,7 +361,7 @@ pbjs.bidderSettings = {
         bidCpmAdjustment: function(bidCpm, bid){ return bidCpm * .85; },
         [...]
     },
-    appnexus: {
+    msft: {
         allowAlternateBidderCodes: true,
         allowedAlternateBidderCodes: ["*"],
         bidCpmAdjustment: function(bidCpm, bid){ return bidCpm * .90; },
diff --git a/dev-docs/publisher-api-reference/getAdserverTargeting.md b/dev-docs/publisher-api-reference/getAdserverTargeting.md
index 296c69a785..e100db4b8c 100644
--- a/dev-docs/publisher-api-reference/getAdserverTargeting.md
+++ b/dev-docs/publisher-api-reference/getAdserverTargeting.md
@@ -11,7 +11,7 @@ Returns all ad server targeting for all ad units. Note that some bidder's respon
 
 The targeting keys can be configured in [ad server targeting](/dev-docs/publisher-api-reference/bidderSettings.html).
 
-When [deals are enabled]({{site.baseurl}}/adops/deals.html), the object returned by this method may include a field `hb_deal_BIDDERCODE`, where `BIDDERCODE` is replaced by the name of the bidder, e.g., AppNexus, Rubicon, etc.
+When [deals are enabled]({{site.baseurl}}/adops/deals.html), the object returned by this method may include a field `hb_deal_BIDDERCODE`, where `BIDDERCODE` is replaced by the name of the bidder, e.g., Microsoft, Rubicon, etc.
 
 **Kind**: static method of `pbjs`
 
@@ -32,10 +32,10 @@ When [deals are enabled]({{site.baseurl}}/adops/deals.html), the object returned
     "hb_pb": "1.00"
   },
   "/9968336/header-bid-tag-2": {
-    "hb_bidder": "appnexus",
+    "hb_bidder": "msft",
     "hb_adid": "147ac541a",
     "hb_pb": "2.50",
-    "hb_deal_appnexus": "ABC_123"
+    "hb_deal_msft": "ABC_123"
   }
 }
 ```
diff --git a/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md b/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
index bd4fe3627a..0e28261df8 100644
--- a/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
+++ b/dev-docs/publisher-api-reference/getAdserverTargetingForAdUnitCodeStr.md
@@ -23,5 +23,5 @@ Returns the query string targeting parameters available at the moment for the sp
 
 ```javascript
 const targetingStrings = pbjs.getAdserverTargetingForAdUnitCodeStr('div-1');
-// ["hb_bidder=appnexus", "hb_adid=233bcbee889d46d", ...]
+// ["hb_bidder=msft", "hb_adid=233bcbee889d46d", ...]
 ```
diff --git a/dev-docs/publisher-api-reference/getBidResponses.md b/dev-docs/publisher-api-reference/getBidResponses.md
index 276d9b6f97..a4fce6c82a 100644
--- a/dev-docs/publisher-api-reference/getBidResponses.md
+++ b/dev-docs/publisher-api-reference/getBidResponses.md
@@ -33,7 +33,7 @@ This function returns the bid responses at the given moment.
 | `creativeId`     | String  | Bidder-specific creative ID | `"12345678"` |
 | `mediaType`  | String  | One of: banner, native, video | `banner` |
 | `dealId`            | String  | (Optional) If the bid is [associated with a Deal]({{site.baseurl}}/adops/deals.html), this field contains the deal ID.          |                                                 "ABC_123" |
-| `adserverTargeting`  | Object  | Contains all the adserver targeting parameters | `{ "hb_bidder": "appnexus", "hb_adid": "7a53a9d3" }` |
+| `adserverTargeting`  | Object  | Contains all the adserver targeting parameters | `{ "hb_bidder": "msft", "hb_adid": "7a53a9d3" }` |
 | `native`  | Object  | Contains native key value pairs. | `{ "title": "", "body": "" }` |
 | `status`  | String  | Status of the bid. Possible values: targetingSet, rendered | `"targetingSet"` |
 | `ttl`  | Integer  | How long (in seconds) this bid is considered valid. See this [FAQ entry]({{site.github.url}}/dev-docs/faq.html#does-prebidjs-cache-bids) for more info. | `300` |
@@ -70,7 +70,7 @@ This function returns the bid responses at the given moment.
 {
   "/9968336/header-bid-tag-0":  [
       {
-        "bidderCode": "appnexus",
+        "bidderCode": "msft",
         "width": 300,
         "height": 250,
         "adId": "7a53a9d3",
@@ -81,11 +81,11 @@ This function returns the bid responses at the given moment.
         "responseTimestamp": 1444844944180,
         "timeToRespond": 85,
         "adUnitCode": "/19968336/header-bid-tag-0",
-        "bidder": "appnexus",
+        "bidder": "msft",
         "usesGenericKeys": true,
         "size": "300x250",
         "adserverTargeting": {
-          "hb_bidder": "appnexus",
+          "hb_bidder": "msft",
           "hb_adid": "7a53a9d3",
           "hb_pb": "0.50"
         }
@@ -203,7 +203,7 @@ This function returns the bid responses at the given moment.
             "pbCg" : "",
             "adUnitCode" : "div-banner-outstream-native",
             "size" : "0x0",
-            "bidder" : "appnexus",
+            "bidder" : "msft",
             "pbAg" : "10.00",
             "adId" : "473965c9df19d2",
             "adserverTargeting" : {
@@ -213,7 +213,7 @@ This function returns the bid responses at the given moment.
                 "hb_adid" : "473965c9df19d2",
                 "hb_pb" : "10.00",
                 "hb_source" : "client",
-                "hb_bidder" : "appnexus",
+                "hb_bidder" : "msft",
                 "hb_native_image" : "https://vcdn.adnxs.com/p/creative-image/9e/26/5f/b2/9e265fb2-50c8-43f0-88ef-a5a48a9d0dcf.jpg",
                 "hb_size" : "0x0",
                 "hb_mediatype" : "native",
@@ -244,7 +244,7 @@ This function returns the bid responses at the given moment.
             },
             "timeToRespond" : 143,
             "mediaType" : "native",
-            "bidderCode" : "appnexus",
+            "bidderCode" : "msft",
             "source" : "client",
             "auctionId" : "1338a6fb-e514-48fc-8db6-872ddf3babdb",
             "responseTimestamp" : 1516315716205,
diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md
index 0e3d8a7de1..b0e1a82790 100644
--- a/dev-docs/publisher-api-reference/setConfig.md
+++ b/dev-docs/publisher-api-reference/setConfig.md
@@ -229,13 +229,13 @@ Note that targeting config must be set before either `pbjs.setTargetingForGPTAsy
   "hb_deal_rubicon": "11111111",
   "hb_format_rubicon": "banner",
   "hb_source_rubicon": "client",
-  "hb_adid_appnexus": "191f4aca0c0be8",
-  "hb_pb_appnexus": "10.00",
-  "hb_size_appnexus": "300x250",
-  "hb_format_appnexus": "banner",
-  "hb_source_appnexus": "client",
+  "hb_adid_msft": "191f4aca0c0be8",
+  "hb_pb_msft": "10.00",
+  "hb_size_msft": "300x250",
+  "hb_format_msft": "banner",
+  "hb_source_msft": "client",
   // the winning bid is copied to attributes without a suffix
-  "hb_bidder": "appnexus",
+  "hb_bidder": "msft",
   "hb_adid": "191f4aca0c0be8",
   "hb_pb": "10.00",
   "hb_size": "300x250",
@@ -1563,8 +1563,8 @@ pbjs.setConfig({
                 iframeURL: 'https://rubicon.com:8080/topics/fpd/topic.html', // dummy URL
                 expiry: 7 // Configurable expiry days
             },{
-                bidder: 'appnexus',
-                iframeURL: 'https://appnexus.com:8080/topics/fpd/topic.html', // dummy URL
+                bidder: 'msft',
+                iframeURL: 'https://microsoft.com:8080/topics/fpd/topic.html', // dummy URL
                 expiry: 7 // Configurable expiry days
             }]
         }
@@ -1619,7 +1619,7 @@ Prebid modules sometimes need to know the [IAB Global Vendor List](https://iabeu
 ```javascript
 pbjs.setConfig({
   gvlMapping: {
-    appnexus: 4,
+    msft: 4,
     someModule: 123
   }
 });
diff --git a/dev-docs/publisher-api-reference/setTargetingForAst.md b/dev-docs/publisher-api-reference/setTargetingForAst.md
index 5a58ec6ff9..1e07a89d6f 100644
--- a/dev-docs/publisher-api-reference/setTargetingForAst.md
+++ b/dev-docs/publisher-api-reference/setTargetingForAst.md
@@ -6,7 +6,7 @@ sidebarType: 1
 ---
 
 
-Set query string targeting for AST ([Seller Tag](https://docs.xandr.com/bundle/seller-tag/page/seller-tag.html)) ad unit(s).  Note that this function has to be called after all ad units on page are defined.  For working example code, see [Using Prebid.js with AppNexus Publisher Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-appnexus-ad-server.html). If the function is invoked without arguments it will set targeting for all adUnits defined.
+Set query string targeting for AST ([Seller Tag](https://docs.xandr.com/bundle/seller-tag/page/seller-tag.html)) ad unit(s).  Note that this function has to be called after all ad units on page are defined.  For working example code, see [Using Prebid.js with Microsoft Publisher Ad Server]({{site.github.url}}/dev-docs/examples/use-prebid-with-microsoft-ad-server.html). If the function is invoked without arguments it will set targeting for all adUnits defined.
 
 **Kind**: static method of pbjs API
 
diff --git a/dev-docs/renderer.md b/dev-docs/renderer.md
index 89a870c57f..f9cbceafd5 100644
--- a/dev-docs/renderer.md
+++ b/dev-docs/renderer.md
@@ -221,9 +221,9 @@ pbjs.addAdUnits({
   },
   bids: [
     {
-      bidder: "appnexus",
+      bidder: "msft",
       params: {
-        placementId: 13144370,
+        placement_id: 13144370,
       },
     },
   ],
diff --git a/dev-docs/requirements/tcf2/PrebidSupportforEnforcingTCF2.html b/dev-docs/requirements/tcf2/PrebidSupportforEnforcingTCF2.html
index bd7edfa7a2..73158843a1 100644
--- a/dev-docs/requirements/tcf2/PrebidSupportforEnforcingTCF2.html
+++ b/dev-docs/requirements/tcf2/PrebidSupportforEnforcingTCF2.html
@@ -1 +1 @@
-<html><head><meta content="text/html; charset=UTF-8" http-equiv="content-type"><style type="text/css">@import url('https://themes.googleusercontent.com/fonts/css?kit=lhDjYqiy3mZ0x6ROQEUoUw');ol.lst-kix_7fhxg8i5msmt-8.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-8 0}.lst-kix_pkkwt0mfnd4r-1>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-1}ol.lst-kix_pkkwt0mfnd4r-8.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-8 0}.lst-kix_xygzk5z3cyvz-2>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-2}ol.lst-kix_xygzk5z3cyvz-5.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-5 0}.lst-kix_jwv9q4tqofnu-8>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-8}.lst-kix_u56eprq9ell0-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-2>li:before{content:"\0025a0  "}.lst-kix_u56eprq9ell0-0>li:before{content:"\0025cf  "}.lst-kix_5zdork13zaj5-2>li{counter-increment:lst-ctn-kix_5zdork13zaj5-2}ol.lst-kix_8irgp2z20781-7.start{counter-reset:lst-ctn-kix_8irgp2z20781-7 0}ol.lst-kix_5zdork13zaj5-6.start{counter-reset:lst-ctn-kix_5zdork13zaj5-6 0}.lst-kix_7fhxg8i5msmt-0>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-0}.lst-kix_3vftmdlxcpj0-7>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-7}.lst-kix_w5k728jy05vp-6>li{counter-increment:lst-ctn-kix_w5k728jy05vp-6}ol.lst-kix_pzmtiq5h0915-5.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-5 0}.lst-kix_ozkivkncyqrh-7>li:before{content:"\0025cb  "}.lst-kix_ozkivkncyqrh-6>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-8>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-5>li:before{content:"\0025a0  "}.lst-kix_svmmnj1snhr2-5>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-5}.lst-kix_6jgx19e9u9pe-5>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-5}.lst-kix_u56eprq9ell0-8>li:before{content:"\0025a0  "}.lst-kix_u56eprq9ell0-5>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-0>li:before{content:"\0025cf  "}.lst-kix_u56eprq9ell0-7>li:before{content:"\0025cb  "}.lst-kix_ozkivkncyqrh-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-3>li:before{content:"\0025cf  "}ol.lst-kix_68qsl6zcqxrq-6.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-6 0}.lst-kix_u56eprq9ell0-6>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-3>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-2>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-4>li:before{content:"\0025cb  "}.lst-kix_36fxx9lqc91n-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-4>li:before{content:"\0025cb  "}ol.lst-kix_6jgx19e9u9pe-8.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-8 0}.lst-kix_36fxx9lqc91n-0>li:before{content:"\0025cf  "}.lst-kix_7fhxg8i5msmt-6>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-6,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-3.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-3 0}.lst-kix_7fhxg8i5msmt-5>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-5,lower-roman) ". "}ol.lst-kix_pkkwt0mfnd4r-3.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-3 0}.lst-kix_7fhxg8i5msmt-4>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-4,lower-latin) ". "}.lst-kix_68qsl6zcqxrq-1>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-1}ul.lst-kix_hii6fafh6hm-0{list-style-type:none}ul.lst-kix_hii6fafh6hm-1{list-style-type:none}.lst-kix_7fhxg8i5msmt-2>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-2,lower-roman) ". "}ul.lst-kix_hii6fafh6hm-2{list-style-type:none}ul.lst-kix_hii6fafh6hm-3{list-style-type:none}.lst-kix_7fhxg8i5msmt-1>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-1,lower-latin) ". "}.lst-kix_7fhxg8i5msmt-3>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-3,decimal) ". "}ul.lst-kix_hii6fafh6hm-4{list-style-type:none}ul.lst-kix_hii6fafh6hm-5{list-style-type:none}.lst-kix_w5k728jy05vp-2>li{counter-increment:lst-ctn-kix_w5k728jy05vp-2}ul.lst-kix_hii6fafh6hm-6{list-style-type:none}ul.lst-kix_hii6fafh6hm-7{list-style-type:none}ul.lst-kix_hii6fafh6hm-8{list-style-type:none}.lst-kix_jwv9q4tqofnu-4>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-4}.lst-kix_svmmnj1snhr2-1>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-1}.lst-kix_w6yj8blbe06x-6>li:before{content:"\0025cf  "}.lst-kix_w6yj8blbe06x-8>li:before{content:"\0025a0  "}.lst-kix_7fhxg8i5msmt-0>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-0,decimal) ". "}.lst-kix_7fhxg8i5msmt-7>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-7}.lst-kix_w6yj8blbe06x-7>li:before{content:"\0025cb  "}.lst-kix_3vftmdlxcpj0-0>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-0}ul.lst-kix_wchaiekwhio-7{list-style-type:none}ul.lst-kix_wchaiekwhio-6{list-style-type:none}ul.lst-kix_wchaiekwhio-5{list-style-type:none}ol.lst-kix_svmmnj1snhr2-7.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-7 0}.lst-kix_w6yj8blbe06x-0>li:before{content:"\0025cf  "}ul.lst-kix_wchaiekwhio-4{list-style-type:none}ul.lst-kix_wchaiekwhio-3{list-style-type:none}ul.lst-kix_wchaiekwhio-2{list-style-type:none}ul.lst-kix_wchaiekwhio-1{list-style-type:none}.lst-kix_w6yj8blbe06x-3>li:before{content:"\0025cf  "}ul.lst-kix_wchaiekwhio-0{list-style-type:none}ol.lst-kix_svmmnj1snhr2-0.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-0 0}.lst-kix_w6yj8blbe06x-4>li:before{content:"\0025cb  "}ol.lst-kix_68qsl6zcqxrq-1.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-1 0}ol.lst-kix_6fc6u2jowkph-4.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-4 0}.lst-kix_5zdork13zaj5-6>li{counter-increment:lst-ctn-kix_5zdork13zaj5-6}.lst-kix_w6yj8blbe06x-5>li:before{content:"\0025a0  "}.lst-kix_w6yj8blbe06x-2>li:before{content:"\0025a0  "}.lst-kix_w6yj8blbe06x-1>li:before{content:"\0025cb  "}ul.lst-kix_wchaiekwhio-8{list-style-type:none}ul.lst-kix_hxgng6in8mo4-7{list-style-type:none}ol.lst-kix_6fc6u2jowkph-8{list-style-type:none}.lst-kix_tb82mrxazni-7>li:before{content:"\0025cb  "}ul.lst-kix_hxgng6in8mo4-6{list-style-type:none}.lst-kix_6jgx19e9u9pe-1>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-1}ol.lst-kix_6fc6u2jowkph-7{list-style-type:none}ul.lst-kix_hxgng6in8mo4-5{list-style-type:none}ol.lst-kix_6fc6u2jowkph-6{list-style-type:none}.lst-kix_hxgng6in8mo4-1>li:before{content:"\0025cb  "}.lst-kix_hxgng6in8mo4-3>li:before{content:"\0025cf  "}ul.lst-kix_hxgng6in8mo4-4{list-style-type:none}.lst-kix_tb82mrxazni-5>li:before{content:"\0025a0  "}.lst-kix_68qsl6zcqxrq-4>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-4}.lst-kix_wz4xrdza29b-2>li:before{content:"\0025a0  "}.lst-kix_wz4xrdza29b-6>li:before{content:"\0025cf  "}ul.lst-kix_hxgng6in8mo4-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-8.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-8 0}.lst-kix_tb82mrxazni-3>li:before{content:"\0025cf  "}ol.lst-kix_pkkwt0mfnd4r-1.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-1 0}ol.lst-kix_w5k728jy05vp-2.start{counter-reset:lst-ctn-kix_w5k728jy05vp-2 0}ul.lst-kix_hxgng6in8mo4-3{list-style-type:none}ul.lst-kix_hxgng6in8mo4-2{list-style-type:none}.lst-kix_wz4xrdza29b-4>li:before{content:"\0025cb  "}ul.lst-kix_hxgng6in8mo4-1{list-style-type:none}ul.lst-kix_hxgng6in8mo4-0{list-style-type:none}.lst-kix_7fhxg8i5msmt-4>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-4}ol.lst-kix_5zdork13zaj5-1{list-style-type:none}ol.lst-kix_5zdork13zaj5-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-3.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-3 0}ol.lst-kix_6fc6u2jowkph-1{list-style-type:none}ol.lst-kix_5zdork13zaj5-7{list-style-type:none}ol.lst-kix_6fc6u2jowkph-0{list-style-type:none}ol.lst-kix_5zdork13zaj5-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-1.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-1 0}ol.lst-kix_5zdork13zaj5-8{list-style-type:none}ol.lst-kix_6fc6u2jowkph-5{list-style-type:none}ol.lst-kix_5zdork13zaj5-3{list-style-type:none}ol.lst-kix_6fc6u2jowkph-4{list-style-type:none}ol.lst-kix_5zdork13zaj5-2{list-style-type:none}ol.lst-kix_6fc6u2jowkph-3{list-style-type:none}ol.lst-kix_5zdork13zaj5-5{list-style-type:none}.lst-kix_wz4xrdza29b-8>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-2{list-style-type:none}ol.lst-kix_5zdork13zaj5-4{list-style-type:none}.lst-kix_ewcld7rry2cw-1>li:before{content:"\0025cb  "}ol.lst-kix_xygzk5z3cyvz-6{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-7{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-8{list-style-type:none}.lst-kix_ewcld7rry2cw-5>li:before{content:"\0025a0  "}.lst-kix_6jgx19e9u9pe-2>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-2}.lst-kix_ewcld7rry2cw-7>li:before{content:"\0025cb  "}.lst-kix_6v7qjvftgbe8-2>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-2}.lst-kix_6fc6u2jowkph-5>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-5}ol.lst-kix_6jgx19e9u9pe-1.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-1 0}ul.lst-kix_u56eprq9ell0-0{list-style-type:none}ul.lst-kix_u56eprq9ell0-2{list-style-type:none}.lst-kix_tb82mrxazni-1>li:before{content:"\0025cb  "}ol.lst-kix_5zdork13zaj5-4.start{counter-reset:lst-ctn-kix_5zdork13zaj5-4 0}ul.lst-kix_u56eprq9ell0-1{list-style-type:none}.lst-kix_xygzk5z3cyvz-6>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-6}ul.lst-kix_u56eprq9ell0-4{list-style-type:none}ul.lst-kix_u56eprq9ell0-3{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-2{list-style-type:none}ul.lst-kix_u56eprq9ell0-6{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-3{list-style-type:none}ul.lst-kix_u56eprq9ell0-5{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-4{list-style-type:none}ul.lst-kix_u56eprq9ell0-8{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-5{list-style-type:none}ul.lst-kix_u56eprq9ell0-7{list-style-type:none}.lst-kix_hxgng6in8mo4-5>li:before{content:"\0025a0  "}.lst-kix_hxgng6in8mo4-7>li:before{content:"\0025cb  "}.lst-kix_ewcld7rry2cw-3>li:before{content:"\0025cf  "}ol.lst-kix_6v7qjvftgbe8-5.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-5 0}ol.lst-kix_xygzk5z3cyvz-0{list-style-type:none}.lst-kix_8irgp2z20781-6>li{counter-increment:lst-ctn-kix_8irgp2z20781-6}.lst-kix_wz4xrdza29b-0>li:before{content:"\0025cf  "}ol.lst-kix_xygzk5z3cyvz-1{list-style-type:none}.lst-kix_pzmtiq5h0915-5>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-5}ol.lst-kix_5zdork13zaj5-1.start{counter-reset:lst-ctn-kix_5zdork13zaj5-1 0}.lst-kix_7fhxg8i5msmt-8>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-8,lower-roman) ". "}.lst-kix_8irgp2z20781-4>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-4,lower-latin) ") "}.lst-kix_8irgp2z20781-8>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-8,lower-roman) ". "}.lst-kix_36fxx9lqc91n-3>li:before{content:"\0025cf  "}.lst-kix_8irgp2z20781-6>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-6,decimal) ". "}.lst-kix_36fxx9lqc91n-5>li:before{content:"\0025a0  "}.lst-kix_36fxx9lqc91n-7>li:before{content:"\0025cb  "}.lst-kix_6v7qjvftgbe8-1>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-1}.lst-kix_pzmtiq5h0915-6>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-6}.lst-kix_8irgp2z20781-0>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-0,decimal) ") "}ol.lst-kix_6v7qjvftgbe8-8{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-7{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-6{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-5{list-style-type:none}.lst-kix_8irgp2z20781-2>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-2,lower-roman) ") "}ol.lst-kix_6v7qjvftgbe8-4{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-7.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-7 0}ol.lst-kix_6v7qjvftgbe8-3{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-2{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-0{list-style-type:none}.lst-kix_68qsl6zcqxrq-5>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-5}.lst-kix_7fhxg8i5msmt-3>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-3}.lst-kix_pkkwt0mfnd4r-5>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-5}ol.lst-kix_6fc6u2jowkph-7.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-7 0}.lst-kix_d8lzxbbe1553-0>li:before{content:"\0025cf  "}.lst-kix_3vftmdlxcpj0-7>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-7,lower-latin) ". "}.lst-kix_8irgp2z20781-5>li{counter-increment:lst-ctn-kix_8irgp2z20781-5}ol.lst-kix_pzmtiq5h0915-0.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-0 0}.lst-kix_d8lzxbbe1553-2>li:before{content:"\0025a0  "}.lst-kix_d8lzxbbe1553-4>li:before{content:"\0025cb  "}ol.lst-kix_xygzk5z3cyvz-0.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-0 0}.lst-kix_3vftmdlxcpj0-3>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-3,decimal) ". "}.lst-kix_3vftmdlxcpj0-5>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-5,lower-roman) ". "}ol.lst-kix_w5k728jy05vp-0.start{counter-reset:lst-ctn-kix_w5k728jy05vp-0 0}ol.lst-kix_6jgx19e9u9pe-3.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-3 0}.lst-kix_3vftmdlxcpj0-1>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-1,lower-latin) ". "}.lst-kix_d8lzxbbe1553-6>li:before{content:"\0025cf  "}.lst-kix_pzmtiq5h0915-8>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-8}.lst-kix_w5k728jy05vp-5>li{counter-increment:lst-ctn-kix_w5k728jy05vp-5}.lst-kix_jwv9q4tqofnu-5>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-5,lower-roman) ". "}.lst-kix_3vftmdlxcpj0-8>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-8}ol.lst-kix_pkkwt0mfnd4r-0{list-style-type:none}.lst-kix_6fc6u2jowkph-0>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-0,decimal) ". "}.lst-kix_5zdork13zaj5-1>li{counter-increment:lst-ctn-kix_5zdork13zaj5-1}.lst-kix_d8lzxbbe1553-8>li:before{content:"\0025a0  "}ol.lst-kix_pkkwt0mfnd4r-2{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-1{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-4{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-3{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-6{list-style-type:none}.lst-kix_jwv9q4tqofnu-6>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-6,decimal) ". "}ol.lst-kix_8irgp2z20781-8{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-5{list-style-type:none}ol.lst-kix_8irgp2z20781-7{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-8{list-style-type:none}.lst-kix_svmmnj1snhr2-4>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-4}ol.lst-kix_pkkwt0mfnd4r-7{list-style-type:none}.lst-kix_jwv9q4tqofnu-7>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-7}.lst-kix_6fc6u2jowkph-4>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-0>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-0,decimal) ". "}.lst-kix_6fc6u2jowkph-3>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-3,decimal) ". "}.lst-kix_6fc6u2jowkph-7>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-7,lower-latin) ". "}ol.lst-kix_3vftmdlxcpj0-8.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-8 0}ol.lst-kix_5zdork13zaj5-3.start{counter-reset:lst-ctn-kix_5zdork13zaj5-3 0}.lst-kix_6v7qjvftgbe8-8>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-8}ol.lst-kix_8irgp2z20781-4.start{counter-reset:lst-ctn-kix_8irgp2z20781-4 0}.lst-kix_hii6fafh6hm-6>li:before{content:"\0025cf  "}.lst-kix_wchaiekwhio-2>li:before{content:"\0025a0  "}.lst-kix_xygzk5z3cyvz-3>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-3,decimal) ". "}.lst-kix_xygzk5z3cyvz-7>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-7,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-4>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-8>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-8,lower-roman) ". "}.lst-kix_6jgx19e9u9pe-8>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-8}ol.lst-kix_jwv9q4tqofnu-7.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-7 0}.lst-kix_6fc6u2jowkph-8>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-8,lower-roman) ". "}.lst-kix_wchaiekwhio-6>li:before{content:"\0025cf  "}ol.lst-kix_pkkwt0mfnd4r-0.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-0 0}ul.lst-kix_36fxx9lqc91n-1{list-style-type:none}.lst-kix_6fc6u2jowkph-8>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-8}ul.lst-kix_36fxx9lqc91n-2{list-style-type:none}.lst-kix_3vftmdlxcpj0-6>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-6}ul.lst-kix_36fxx9lqc91n-0{list-style-type:none}.lst-kix_wchaiekwhio-7>li:before{content:"\0025cb  "}ul.lst-kix_36fxx9lqc91n-5{list-style-type:none}ol.lst-kix_pzmtiq5h0915-2.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-2 0}ul.lst-kix_36fxx9lqc91n-6{list-style-type:none}ul.lst-kix_36fxx9lqc91n-3{list-style-type:none}ul.lst-kix_36fxx9lqc91n-4{list-style-type:none}.lst-kix_xygzk5z3cyvz-3>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-3}ol.lst-kix_3vftmdlxcpj0-2.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-2 0}ol.lst-kix_6jgx19e9u9pe-5.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-5 0}.lst-kix_68qsl6zcqxrq-0>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-0}ul.lst-kix_36fxx9lqc91n-7{list-style-type:none}ul.lst-kix_36fxx9lqc91n-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-1.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-1 0}.lst-kix_svmmnj1snhr2-2>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-2}ol.lst-kix_68qsl6zcqxrq-3.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-3 0}.lst-kix_wchaiekwhio-3>li:before{content:"\0025cf  "}.lst-kix_6fc6u2jowkph-6>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-6}ol.lst-kix_6jgx19e9u9pe-6{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-5{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-8{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-7{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-0{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-2{list-style-type:none}.lst-kix_jwv9q4tqofnu-5>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-5}ol.lst-kix_6jgx19e9u9pe-1{list-style-type:none}.lst-kix_68qsl6zcqxrq-7>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-7}ol.lst-kix_6jgx19e9u9pe-4{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-3{list-style-type:none}ul.lst-kix_wz4xrdza29b-3{list-style-type:none}ul.lst-kix_wz4xrdza29b-2{list-style-type:none}ul.lst-kix_wz4xrdza29b-5{list-style-type:none}.lst-kix_pzmtiq5h0915-3>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-3,decimal) ". "}ul.lst-kix_wz4xrdza29b-4{list-style-type:none}ul.lst-kix_wz4xrdza29b-1{list-style-type:none}ul.lst-kix_wz4xrdza29b-0{list-style-type:none}.lst-kix_xygzk5z3cyvz-5>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-5}ul.lst-kix_wz4xrdza29b-7{list-style-type:none}ul.lst-kix_wz4xrdza29b-6{list-style-type:none}ol.lst-kix_w5k728jy05vp-4.start{counter-reset:lst-ctn-kix_w5k728jy05vp-4 0}.lst-kix_pzmtiq5h0915-0>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-0,decimal) ". "}ul.lst-kix_wz4xrdza29b-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-8.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-8 0}ol.lst-kix_jwv9q4tqofnu-0.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-0 0}ol.lst-kix_w5k728jy05vp-3.start{counter-reset:lst-ctn-kix_w5k728jy05vp-3 0}ol.lst-kix_8irgp2z20781-5.start{counter-reset:lst-ctn-kix_8irgp2z20781-5 0}ol.lst-kix_6jgx19e9u9pe-6.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-6 0}ol.lst-kix_3vftmdlxcpj0-1.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-1 0}.lst-kix_xcsisnkihklz-4>li:before{content:"\0025cb  "}.lst-kix_pzmtiq5h0915-4>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-4,lower-latin) ". "}ol.lst-kix_jwv9q4tqofnu-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-7{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-6{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-5{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-4{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-3{list-style-type:none}.lst-kix_xcsisnkihklz-1>li:before{content:"\0025cb  "}ol.lst-kix_jwv9q4tqofnu-2{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-1{list-style-type:none}.lst-kix_6v7qjvftgbe8-3>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-3}ol.lst-kix_jwv9q4tqofnu-0{list-style-type:none}.lst-kix_pzmtiq5h0915-1>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-1}.lst-kix_pzmtiq5h0915-7>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-7,lower-latin) ". "}.lst-kix_xcsisnkihklz-0>li:before{content:"\0025cf  "}ol.lst-kix_jwv9q4tqofnu-6.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-6 0}.lst-kix_pzmtiq5h0915-8>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-8,lower-roman) ". "}ol.lst-kix_3vftmdlxcpj0-7.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-7 0}ol.lst-kix_68qsl6zcqxrq-2.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-2 0}.lst-kix_6jgx19e9u9pe-1>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-1,lower-latin) ". "}.lst-kix_tb82mrxazni-8>li:before{content:"\0025a0  "}.lst-kix_hxgng6in8mo4-0>li:before{content:"\0025cf  "}.lst-kix_hxgng6in8mo4-4>li:before{content:"\0025cb  "}.lst-kix_tb82mrxazni-4>li:before{content:"\0025cb  "}.lst-kix_wz4xrdza29b-3>li:before{content:"\0025cf  "}ol.lst-kix_68qsl6zcqxrq-5.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-5 0}.lst-kix_w5k728jy05vp-0>li{counter-increment:lst-ctn-kix_w5k728jy05vp-0}.lst-kix_ewcld7rry2cw-8>li:before{content:"\0025a0  "}ol.lst-kix_jwv9q4tqofnu-5.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-5 0}.lst-kix_6jgx19e9u9pe-5>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-5,lower-roman) ". "}.lst-kix_wz4xrdza29b-7>li:before{content:"\0025cb  "}ol.lst-kix_pzmtiq5h0915-6.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-6 0}.lst-kix_xcsisnkihklz-8>li:before{content:"\0025a0  "}.lst-kix_ewcld7rry2cw-0>li:before{content:"\0025cf  "}.lst-kix_6v7qjvftgbe8-5>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-5}ol.lst-kix_3vftmdlxcpj0-6.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-6 0}ol.lst-kix_w5k728jy05vp-5.start{counter-reset:lst-ctn-kix_w5k728jy05vp-5 0}.lst-kix_3vftmdlxcpj0-1>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-1}.lst-kix_3vftmdlxcpj0-3>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-3}.lst-kix_pzmtiq5h0915-3>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-3}.lst-kix_tb82mrxazni-0>li:before{content:"\0025cf  "}.lst-kix_hxgng6in8mo4-8>li:before{content:"\0025a0  "}ol.lst-kix_w5k728jy05vp-8.start{counter-reset:lst-ctn-kix_w5k728jy05vp-8 0}ol.lst-kix_8irgp2z20781-3.start{counter-reset:lst-ctn-kix_8irgp2z20781-3 0}.lst-kix_7fhxg8i5msmt-5>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-5}.lst-kix_ewcld7rry2cw-4>li:before{content:"\0025cb  "}ol.lst-kix_8irgp2z20781-0.start{counter-reset:lst-ctn-kix_8irgp2z20781-0 0}ol.lst-kix_5zdork13zaj5-7.start{counter-reset:lst-ctn-kix_5zdork13zaj5-7 0}ol.lst-kix_5zdork13zaj5-8.start{counter-reset:lst-ctn-kix_5zdork13zaj5-8 0}.lst-kix_7fhxg8i5msmt-7>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-7,lower-latin) ". "}.lst-kix_8irgp2z20781-5>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-5,lower-roman) ") "}.lst-kix_6v7qjvftgbe8-7>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-7,lower-latin) ". "}.lst-kix_6v7qjvftgbe8-3>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-3,decimal) ". "}.lst-kix_36fxx9lqc91n-2>li:before{content:"\0025a0  "}.lst-kix_5zdork13zaj5-4>li{counter-increment:lst-ctn-kix_5zdork13zaj5-4}ol.lst-kix_8irgp2z20781-2.start{counter-reset:lst-ctn-kix_8irgp2z20781-2 0}.lst-kix_pkkwt0mfnd4r-1>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-1,lower-latin) ". "}.lst-kix_36fxx9lqc91n-6>li:before{content:"\0025cf  "}ul.lst-kix_tb82mrxazni-8{list-style-type:none}ul.lst-kix_tb82mrxazni-7{list-style-type:none}.lst-kix_l0zuj3yh3ryb-3>li:before{content:"\0025cf  "}ol.lst-kix_pzmtiq5h0915-8.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-8 0}ul.lst-kix_tb82mrxazni-6{list-style-type:none}ul.lst-kix_tb82mrxazni-5{list-style-type:none}ol.lst-kix_w5k728jy05vp-0{list-style-type:none}ul.lst-kix_tb82mrxazni-4{list-style-type:none}ul.lst-kix_tb82mrxazni-3{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-4.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-4 0}ul.lst-kix_tb82mrxazni-2{list-style-type:none}ol.lst-kix_w5k728jy05vp-7.start{counter-reset:lst-ctn-kix_w5k728jy05vp-7 0}ul.lst-kix_tb82mrxazni-1{list-style-type:none}ol.lst-kix_w5k728jy05vp-4{list-style-type:none}ul.lst-kix_tb82mrxazni-0{list-style-type:none}ol.lst-kix_w5k728jy05vp-3{list-style-type:none}ol.lst-kix_w5k728jy05vp-2{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-2.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-2 0}.lst-kix_8irgp2z20781-1>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-1,lower-latin) ") "}.lst-kix_l0zuj3yh3ryb-7>li:before{content:"\0025cb  "}ol.lst-kix_3vftmdlxcpj0-3.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-3 0}ol.lst-kix_w5k728jy05vp-1{list-style-type:none}ol.lst-kix_w5k728jy05vp-8{list-style-type:none}.lst-kix_pkkwt0mfnd4r-5>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-5,lower-roman) ". "}ol.lst-kix_w5k728jy05vp-7{list-style-type:none}ol.lst-kix_w5k728jy05vp-6{list-style-type:none}ol.lst-kix_w5k728jy05vp-5{list-style-type:none}.lst-kix_w5k728jy05vp-8>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-8,lower-roman) ". "}.lst-kix_pkkwt0mfnd4r-8>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-8}.lst-kix_jwv9q4tqofnu-0>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-0}.lst-kix_68qsl6zcqxrq-2>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-2}.lst-kix_d8lzxbbe1553-1>li:before{content:"\0025cb  "}.lst-kix_w5k728jy05vp-7>li{counter-increment:lst-ctn-kix_w5k728jy05vp-7}ol.lst-kix_3vftmdlxcpj0-4.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-4 0}.lst-kix_hii6fafh6hm-2>li:before{content:"\0025a0  "}.lst-kix_3vftmdlxcpj0-6>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-6,decimal) ". "}.lst-kix_8irgp2z20781-2>li{counter-increment:lst-ctn-kix_8irgp2z20781-2}ol.lst-kix_8irgp2z20781-6{list-style-type:none}ol.lst-kix_8irgp2z20781-5{list-style-type:none}.lst-kix_d8lzxbbe1553-5>li:before{content:"\0025a0  "}ol.lst-kix_jwv9q4tqofnu-3.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-3 0}ol.lst-kix_8irgp2z20781-4{list-style-type:none}ol.lst-kix_8irgp2z20781-3{list-style-type:none}ol.lst-kix_8irgp2z20781-2{list-style-type:none}ol.lst-kix_8irgp2z20781-1{list-style-type:none}ol.lst-kix_8irgp2z20781-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-7.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-7 0}.lst-kix_3vftmdlxcpj0-2>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-1>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-1}.lst-kix_jwv9q4tqofnu-2>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-2,lower-roman) ". "}ul.lst-kix_w6yj8blbe06x-6{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-1.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-1 0}ul.lst-kix_w6yj8blbe06x-7{list-style-type:none}.lst-kix_68qsl6zcqxrq-4>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-4,lower-latin) ") "}.lst-kix_68qsl6zcqxrq-5>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-5,lower-roman) ") "}ol.lst-kix_3vftmdlxcpj0-5.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-5 0}.lst-kix_svmmnj1snhr2-8>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-8,lower-roman) ". "}ul.lst-kix_w6yj8blbe06x-4{list-style-type:none}ul.lst-kix_w6yj8blbe06x-5{list-style-type:none}.lst-kix_6jgx19e9u9pe-7>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-7}.lst-kix_68qsl6zcqxrq-6>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-6,decimal) ". "}ol.lst-kix_6jgx19e9u9pe-2.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-2 0}ul.lst-kix_w6yj8blbe06x-8{list-style-type:none}.lst-kix_68qsl6zcqxrq-2>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-2,lower-roman) ") "}.lst-kix_68qsl6zcqxrq-1>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-1,lower-latin) ") "}ol.lst-kix_6fc6u2jowkph-3.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-3 0}.lst-kix_68qsl6zcqxrq-8>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-8,lower-roman) ". "}.lst-kix_svmmnj1snhr2-4>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-4,lower-latin) ". "}ol.lst-kix_svmmnj1snhr2-6.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-6 0}ol.lst-kix_jwv9q4tqofnu-4.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-4 0}.lst-kix_68qsl6zcqxrq-7>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-7,lower-latin) ". "}.lst-kix_svmmnj1snhr2-2>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-2,lower-roman) ". "}.lst-kix_svmmnj1snhr2-3>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-3,decimal) ". "}.lst-kix_68qsl6zcqxrq-0>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-0,decimal) ") "}ol.lst-kix_w5k728jy05vp-6.start{counter-reset:lst-ctn-kix_w5k728jy05vp-6 0}.lst-kix_svmmnj1snhr2-3>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-3}ol.lst-kix_8irgp2z20781-1.start{counter-reset:lst-ctn-kix_8irgp2z20781-1 0}.lst-kix_svmmnj1snhr2-5>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-5,lower-roman) ". "}.lst-kix_68qsl6zcqxrq-3>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-3,decimal) ") "}.lst-kix_svmmnj1snhr2-6>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-6,decimal) ". "}.lst-kix_svmmnj1snhr2-7>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-7,lower-latin) ". "}.lst-kix_w5k728jy05vp-2>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-2,lower-roman) ". "}ol.lst-kix_5zdork13zaj5-0.start{counter-reset:lst-ctn-kix_5zdork13zaj5-0 0}.lst-kix_w5k728jy05vp-3>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-3,decimal) ". "}ol.lst-kix_w5k728jy05vp-1.start{counter-reset:lst-ctn-kix_w5k728jy05vp-1 0}ol.lst-kix_7fhxg8i5msmt-2.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-2 0}.lst-kix_w5k728jy05vp-4>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-4,lower-latin) ". "}.lst-kix_w5k728jy05vp-1>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-1,lower-latin) ". "}ul.lst-kix_w6yj8blbe06x-2{list-style-type:none}ul.lst-kix_w6yj8blbe06x-3{list-style-type:none}ul.lst-kix_w6yj8blbe06x-0{list-style-type:none}ul.lst-kix_w6yj8blbe06x-1{list-style-type:none}.lst-kix_xygzk5z3cyvz-0>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-0}.lst-kix_w5k728jy05vp-0>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-0,decimal) ". "}.lst-kix_w5k728jy05vp-8>li{counter-increment:lst-ctn-kix_w5k728jy05vp-8}ol.lst-kix_6jgx19e9u9pe-7.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-7 0}ol.lst-kix_8irgp2z20781-6.start{counter-reset:lst-ctn-kix_8irgp2z20781-6 0}.lst-kix_8irgp2z20781-0>li{counter-increment:lst-ctn-kix_8irgp2z20781-0}ol.lst-kix_68qsl6zcqxrq-0.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-0 0}.lst-kix_6fc6u2jowkph-0>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-0}ol.lst-kix_3vftmdlxcpj0-0.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-0 0}ol.lst-kix_pzmtiq5h0915-4.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-4 0}ol.lst-kix_svmmnj1snhr2-1.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-1 0}.lst-kix_8irgp2z20781-7>li{counter-increment:lst-ctn-kix_8irgp2z20781-7}ol.lst-kix_68qsl6zcqxrq-7.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-7 0}.lst-kix_pkkwt0mfnd4r-3>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-3}.lst-kix_svmmnj1snhr2-7>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-7}.lst-kix_5zdork13zaj5-0>li{counter-increment:lst-ctn-kix_5zdork13zaj5-0}.lst-kix_5zdork13zaj5-8>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-8,lower-roman) ". "}ol.lst-kix_5zdork13zaj5-5.start{counter-reset:lst-ctn-kix_5zdork13zaj5-5 0}.lst-kix_5zdork13zaj5-2>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-2,lower-roman) ". "}.lst-kix_svmmnj1snhr2-0>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-0,decimal) ". "}.lst-kix_svmmnj1snhr2-1>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-1,lower-latin) ". "}.lst-kix_5zdork13zaj5-3>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-3,decimal) ". "}.lst-kix_6jgx19e9u9pe-0>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-0}.lst-kix_6jgx19e9u9pe-3>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-3}.lst-kix_5zdork13zaj5-4>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-4,lower-latin) ". "}.lst-kix_6v7qjvftgbe8-0>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-0}.lst-kix_5zdork13zaj5-5>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-5,lower-roman) ". "}.lst-kix_5zdork13zaj5-7>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-7,lower-latin) ". "}.lst-kix_pzmtiq5h0915-7>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-7}.lst-kix_5zdork13zaj5-6>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-6,decimal) ". "}ol.lst-kix_pzmtiq5h0915-7{list-style-type:none}.lst-kix_6jgx19e9u9pe-2>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-3>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-3}ol.lst-kix_pzmtiq5h0915-6{list-style-type:none}ol.lst-kix_pzmtiq5h0915-8{list-style-type:none}.lst-kix_jwv9q4tqofnu-2>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-2}.lst-kix_5zdork13zaj5-7>li{counter-increment:lst-ctn-kix_5zdork13zaj5-7}.lst-kix_6jgx19e9u9pe-6>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-6,decimal) ". "}ol.lst-kix_pzmtiq5h0915-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-8.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-8 0}ol.lst-kix_pzmtiq5h0915-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-3{list-style-type:none}.lst-kix_6jgx19e9u9pe-0>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-0,decimal) ". "}ol.lst-kix_xygzk5z3cyvz-1.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-1 0}ol.lst-kix_pzmtiq5h0915-2{list-style-type:none}.lst-kix_6jgx19e9u9pe-8>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-8,lower-roman) ". "}ol.lst-kix_pzmtiq5h0915-5{list-style-type:none}ol.lst-kix_pzmtiq5h0915-4{list-style-type:none}ul.lst-kix_ewcld7rry2cw-7{list-style-type:none}.lst-kix_8irgp2z20781-4>li{counter-increment:lst-ctn-kix_8irgp2z20781-4}ul.lst-kix_ewcld7rry2cw-6{list-style-type:none}.lst-kix_5zdork13zaj5-8>li{counter-increment:lst-ctn-kix_5zdork13zaj5-8}ul.lst-kix_ewcld7rry2cw-8{list-style-type:none}.lst-kix_5zdork13zaj5-1>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-1,lower-latin) ". "}.lst-kix_pkkwt0mfnd4r-6>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-6}.lst-kix_xcsisnkihklz-5>li:before{content:"\0025a0  "}.lst-kix_xcsisnkihklz-7>li:before{content:"\0025cb  "}.lst-kix_6jgx19e9u9pe-4>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-8>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-8}.lst-kix_pkkwt0mfnd4r-8>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-8,lower-roman) ". "}ul.lst-kix_ewcld7rry2cw-1{list-style-type:none}ul.lst-kix_ewcld7rry2cw-0{list-style-type:none}ul.lst-kix_ewcld7rry2cw-3{list-style-type:none}ul.lst-kix_ewcld7rry2cw-2{list-style-type:none}ul.lst-kix_ewcld7rry2cw-5{list-style-type:none}ul.lst-kix_ewcld7rry2cw-4{list-style-type:none}.lst-kix_68qsl6zcqxrq-6>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-6}.lst-kix_pzmtiq5h0915-0>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-0}.lst-kix_7fhxg8i5msmt-2>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-2}.lst-kix_3vftmdlxcpj0-5>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-5}ol.lst-kix_svmmnj1snhr2-2{list-style-type:none}.lst-kix_6v7qjvftgbe8-6>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-6,decimal) ". "}ol.lst-kix_svmmnj1snhr2-3{list-style-type:none}ol.lst-kix_svmmnj1snhr2-0{list-style-type:none}ol.lst-kix_svmmnj1snhr2-1{list-style-type:none}.lst-kix_6v7qjvftgbe8-4>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-4,lower-latin) ". "}ol.lst-kix_6v7qjvftgbe8-6.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-6 0}.lst-kix_l0zuj3yh3ryb-8>li:before{content:"\0025a0  "}.lst-kix_pkkwt0mfnd4r-0>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-0,decimal) ". "}.lst-kix_svmmnj1snhr2-0>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-0}ol.lst-kix_svmmnj1snhr2-8{list-style-type:none}ol.lst-kix_svmmnj1snhr2-6{list-style-type:none}.lst-kix_svmmnj1snhr2-6>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-6}ul.lst-kix_xcsisnkihklz-7{list-style-type:none}.lst-kix_pkkwt0mfnd4r-2>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-2,lower-roman) ". "}ol.lst-kix_svmmnj1snhr2-7{list-style-type:none}ul.lst-kix_xcsisnkihklz-6{list-style-type:none}ol.lst-kix_6fc6u2jowkph-8.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-8 0}ol.lst-kix_svmmnj1snhr2-4{list-style-type:none}ol.lst-kix_svmmnj1snhr2-5{list-style-type:none}ul.lst-kix_xcsisnkihklz-8{list-style-type:none}.lst-kix_6v7qjvftgbe8-7>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-7}.lst-kix_l0zuj3yh3ryb-4>li:before{content:"\0025cb  "}ul.lst-kix_xcsisnkihklz-3{list-style-type:none}.lst-kix_pkkwt0mfnd4r-4>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-4,lower-latin) ". "}ul.lst-kix_xcsisnkihklz-2{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-4.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-4 0}ul.lst-kix_xcsisnkihklz-5{list-style-type:none}.lst-kix_w5k728jy05vp-5>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-5,lower-roman) ". "}.lst-kix_w5k728jy05vp-7>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-7,lower-latin) ". "}ul.lst-kix_xcsisnkihklz-4{list-style-type:none}.lst-kix_6v7qjvftgbe8-0>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-0,decimal) ". "}ol.lst-kix_pzmtiq5h0915-1.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-1 0}ul.lst-kix_xcsisnkihklz-1{list-style-type:none}ul.lst-kix_xcsisnkihklz-0{list-style-type:none}.lst-kix_6v7qjvftgbe8-2>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-2,lower-roman) ". "}.lst-kix_pkkwt0mfnd4r-6>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-6,decimal) ". "}.lst-kix_l0zuj3yh3ryb-6>li:before{content:"\0025cf  "}.lst-kix_hii6fafh6hm-5>li:before{content:"\0025a0  "}ol.lst-kix_pkkwt0mfnd4r-2.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-2 0}ol.lst-kix_5zdork13zaj5-2.start{counter-reset:lst-ctn-kix_5zdork13zaj5-2 0}.lst-kix_hii6fafh6hm-3>li:before{content:"\0025cf  "}.lst-kix_xygzk5z3cyvz-7>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-7}.lst-kix_hii6fafh6hm-1>li:before{content:"\0025cb  "}.lst-kix_w5k728jy05vp-4>li{counter-increment:lst-ctn-kix_w5k728jy05vp-4}.lst-kix_jwv9q4tqofnu-3>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-3}.lst-kix_xygzk5z3cyvz-1>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-1}.lst-kix_l0zuj3yh3ryb-2>li:before{content:"\0025a0  "}.lst-kix_l0zuj3yh3ryb-0>li:before{content:"\0025cf  "}.lst-kix_6fc6u2jowkph-4>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-4}ol.lst-kix_8irgp2z20781-8.start{counter-reset:lst-ctn-kix_8irgp2z20781-8 0}ol.lst-kix_7fhxg8i5msmt-0.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-0 0}.lst-kix_jwv9q4tqofnu-3>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-3,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-8{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-7{list-style-type:none}.lst-kix_jwv9q4tqofnu-1>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-1,lower-latin) ". "}.lst-kix_jwv9q4tqofnu-0>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-0,decimal) ". "}.lst-kix_jwv9q4tqofnu-4>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-4,lower-latin) ". "}ul.lst-kix_l0zuj3yh3ryb-0{list-style-type:none}ul.lst-kix_l0zuj3yh3ryb-1{list-style-type:none}.lst-kix_jwv9q4tqofnu-7>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-7,lower-latin) ". "}ol.lst-kix_7fhxg8i5msmt-0{list-style-type:none}.lst-kix_3vftmdlxcpj0-0>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-0,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-1{list-style-type:none}.lst-kix_6fc6u2jowkph-2>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-2,lower-roman) ". "}ol.lst-kix_7fhxg8i5msmt-4{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-5{list-style-type:none}.lst-kix_6fc6u2jowkph-1>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-1,lower-latin) ". "}ol.lst-kix_7fhxg8i5msmt-2{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-3{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-4.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-4 0}.lst-kix_pkkwt0mfnd4r-0>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-0}ol.lst-kix_pkkwt0mfnd4r-5.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-5 0}.lst-kix_jwv9q4tqofnu-8>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-8,lower-roman) ". "}.lst-kix_xygzk5z3cyvz-1>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-1,lower-latin) ". "}ol.lst-kix_xygzk5z3cyvz-2.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-2 0}.lst-kix_6fc6u2jowkph-6>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-6,decimal) ". "}.lst-kix_xygzk5z3cyvz-2>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-5>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-5,lower-roman) ". "}ol.lst-kix_svmmnj1snhr2-3.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-3 0}.lst-kix_xygzk5z3cyvz-5>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-5,lower-roman) ". "}.lst-kix_wchaiekwhio-0>li:before{content:"\0025cf  "}.lst-kix_hii6fafh6hm-7>li:before{content:"\0025cb  "}.lst-kix_wchaiekwhio-1>li:before{content:"\0025cb  "}.lst-kix_wchaiekwhio-5>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-0.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-0 0}.lst-kix_hii6fafh6hm-8>li:before{content:"\0025a0  "}.lst-kix_xygzk5z3cyvz-6>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-6,decimal) ". "}ol.lst-kix_6fc6u2jowkph-6.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-6 0}ul.lst-kix_l0zuj3yh3ryb-2{list-style-type:none}.lst-kix_7fhxg8i5msmt-8>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-8}ul.lst-kix_l0zuj3yh3ryb-3{list-style-type:none}.lst-kix_6v7qjvftgbe8-8>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-8,lower-roman) ". "}ul.lst-kix_l0zuj3yh3ryb-4{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-8.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-8 0}ul.lst-kix_l0zuj3yh3ryb-5{list-style-type:none}.lst-kix_wchaiekwhio-4>li:before{content:"\0025cb  "}ul.lst-kix_l0zuj3yh3ryb-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-5.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-5 0}ul.lst-kix_l0zuj3yh3ryb-7{list-style-type:none}ul.lst-kix_l0zuj3yh3ryb-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-6{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-7{list-style-type:none}ol.lst-kix_svmmnj1snhr2-8.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-8 0}ol.lst-kix_68qsl6zcqxrq-4{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-5{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-2{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-3{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-0.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-0 0}.lst-kix_pkkwt0mfnd4r-4>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-4}ol.lst-kix_68qsl6zcqxrq-0{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-3.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-3 0}.lst-kix_7fhxg8i5msmt-1>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-1}.lst-kix_w5k728jy05vp-3>li{counter-increment:lst-ctn-kix_w5k728jy05vp-3}.lst-kix_pzmtiq5h0915-1>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-1,lower-latin) ". "}.lst-kix_wchaiekwhio-8>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-5.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-5 0}.lst-kix_3vftmdlxcpj0-4>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-4}.lst-kix_pzmtiq5h0915-2>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-2,lower-roman) ". "}.lst-kix_8irgp2z20781-1>li{counter-increment:lst-ctn-kix_8irgp2z20781-1}.lst-kix_5zdork13zaj5-3>li{counter-increment:lst-ctn-kix_5zdork13zaj5-3}.lst-kix_pzmtiq5h0915-6>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-6,decimal) ". "}ol.lst-kix_pkkwt0mfnd4r-4.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-4 0}.lst-kix_pzmtiq5h0915-5>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-5,lower-roman) ". "}ul.lst-kix_d8lzxbbe1553-4{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-1{list-style-type:none}ul.lst-kix_d8lzxbbe1553-5{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-0{list-style-type:none}.lst-kix_6jgx19e9u9pe-6>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-6}.lst-kix_xcsisnkihklz-2>li:before{content:"\0025a0  "}.lst-kix_xcsisnkihklz-3>li:before{content:"\0025cf  "}ul.lst-kix_d8lzxbbe1553-6{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-3{list-style-type:none}ul.lst-kix_d8lzxbbe1553-7{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-2{list-style-type:none}ul.lst-kix_d8lzxbbe1553-0{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-5{list-style-type:none}ul.lst-kix_d8lzxbbe1553-1{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-4{list-style-type:none}ul.lst-kix_d8lzxbbe1553-2{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-7{list-style-type:none}ul.lst-kix_d8lzxbbe1553-3{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-6{list-style-type:none}.lst-kix_pzmtiq5h0915-4>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-4}ol.lst-kix_3vftmdlxcpj0-8{list-style-type:none}.lst-kix_6v7qjvftgbe8-6>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-6}ul.lst-kix_d8lzxbbe1553-8{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-3.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-3 0}.lst-kix_wz4xrdza29b-5>li:before{content:"\0025a0  "}.lst-kix_pzmtiq5h0915-2>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-2}.lst-kix_tb82mrxazni-6>li:before{content:"\0025cf  "}.lst-kix_6jgx19e9u9pe-3>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-3,decimal) ". "}.lst-kix_pkkwt0mfnd4r-7>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-7}.lst-kix_tb82mrxazni-2>li:before{content:"\0025a0  "}.lst-kix_6jgx19e9u9pe-7>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-7,lower-latin) ". "}.lst-kix_hxgng6in8mo4-2>li:before{content:"\0025a0  "}.lst-kix_6v7qjvftgbe8-4>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-4}.lst-kix_jwv9q4tqofnu-1>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-1}.lst-kix_5zdork13zaj5-0>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-0,decimal) ". "}.lst-kix_xcsisnkihklz-6>li:before{content:"\0025cf  "}ol.lst-kix_7fhxg8i5msmt-4.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-4 0}.lst-kix_ewcld7rry2cw-2>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-2.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-2 0}ol.lst-kix_svmmnj1snhr2-2.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-2 0}ol.lst-kix_6v7qjvftgbe8-2.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-2 0}ol.lst-kix_xygzk5z3cyvz-4.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-4 0}.lst-kix_svmmnj1snhr2-8>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-8}.lst-kix_6fc6u2jowkph-2>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-2}.lst-kix_ewcld7rry2cw-6>li:before{content:"\0025cf  "}ol.lst-kix_svmmnj1snhr2-5.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-5 0}.lst-kix_68qsl6zcqxrq-3>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-3}ol.lst-kix_pkkwt0mfnd4r-6.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-6 0}.lst-kix_wz4xrdza29b-1>li:before{content:"\0025cb  "}.lst-kix_8irgp2z20781-3>li{counter-increment:lst-ctn-kix_8irgp2z20781-3}.lst-kix_hxgng6in8mo4-6>li:before{content:"\0025cf  "}.lst-kix_6v7qjvftgbe8-5>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-5,lower-roman) ". "}ol.lst-kix_6fc6u2jowkph-1.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-1 0}.lst-kix_8irgp2z20781-3>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-3,decimal) ") "}.lst-kix_6jgx19e9u9pe-4>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-4}.lst-kix_8irgp2z20781-7>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-7,lower-latin) ". "}.lst-kix_36fxx9lqc91n-4>li:before{content:"\0025cb  "}.lst-kix_pkkwt0mfnd4r-3>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-3,decimal) ". "}.lst-kix_5zdork13zaj5-5>li{counter-increment:lst-ctn-kix_5zdork13zaj5-5}ol.lst-kix_xygzk5z3cyvz-7.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-7 0}ol.lst-kix_7fhxg8i5msmt-6.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-6 0}.lst-kix_l0zuj3yh3ryb-5>li:before{content:"\0025a0  "}.lst-kix_w5k728jy05vp-6>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-6,decimal) ". "}.lst-kix_6v7qjvftgbe8-1>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-1,lower-latin) ". "}.lst-kix_pkkwt0mfnd4r-7>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-7,lower-latin) ". "}ol.lst-kix_pkkwt0mfnd4r-7.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-7 0}.lst-kix_36fxx9lqc91n-8>li:before{content:"\0025a0  "}.lst-kix_hii6fafh6hm-4>li:before{content:"\0025cb  "}.lst-kix_pkkwt0mfnd4r-2>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-2}.lst-kix_68qsl6zcqxrq-8>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-8}ol.lst-kix_6v7qjvftgbe8-0.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-0 0}.lst-kix_jwv9q4tqofnu-6>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-6}.lst-kix_8irgp2z20781-8>li{counter-increment:lst-ctn-kix_8irgp2z20781-8}.lst-kix_3vftmdlxcpj0-8>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-8,lower-roman) ". "}ol.lst-kix_7fhxg8i5msmt-7.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-7 0}.lst-kix_l0zuj3yh3ryb-1>li:before{content:"\0025cb  "}.lst-kix_hii6fafh6hm-0>li:before{content:"\0025cf  "}.lst-kix_7fhxg8i5msmt-6>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-6}.lst-kix_xygzk5z3cyvz-4>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-4}.lst-kix_3vftmdlxcpj0-4>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-4,lower-latin) ". "}ul.lst-kix_ozkivkncyqrh-0{list-style-type:none}ul.lst-kix_ozkivkncyqrh-1{list-style-type:none}ul.lst-kix_ozkivkncyqrh-2{list-style-type:none}ul.lst-kix_ozkivkncyqrh-3{list-style-type:none}ul.lst-kix_ozkivkncyqrh-4{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-6.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-6 0}.lst-kix_d8lzxbbe1553-3>li:before{content:"\0025cf  "}.lst-kix_d8lzxbbe1553-7>li:before{content:"\0025cb  "}ul.lst-kix_ozkivkncyqrh-5{list-style-type:none}.lst-kix_6fc6u2jowkph-7>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-7}ul.lst-kix_ozkivkncyqrh-6{list-style-type:none}ol.lst-kix_svmmnj1snhr2-4.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-4 0}ul.lst-kix_ozkivkncyqrh-7{list-style-type:none}ul.lst-kix_ozkivkncyqrh-8{list-style-type:none}.lst-kix_w5k728jy05vp-1>li{counter-increment:lst-ctn-kix_w5k728jy05vp-1}.lst-kix_3vftmdlxcpj0-2>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-2}ol{margin:0;padding:0}table td,table th{padding:0}.c11{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;background-color:#d9d9d9;border-left-style:solid;border-bottom-width:1pt;width:93.6pt;border-top-color:#000000;border-bottom-style:solid}.c14{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:280.8pt;border-top-color:#000000;border-bottom-style:solid}.c5{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:57.8pt;border-top-color:#000000;border-bottom-style:solid}.c10{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:183.8pt;border-top-color:#000000;border-bottom-style:solid}.c17{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:93.6pt;border-top-color:#000000;border-bottom-style:solid}.c28{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:468pt;border-top-color:#000000;border-bottom-style:solid}.c19{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:109.5pt;border-top-color:#000000;border-bottom-style:solid}.c22{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:117pt;border-top-color:#000000;border-bottom-style:solid}.c7{-webkit-text-decoration-skip:none;color:#1155cc;font-weight:400;text-decoration:underline;vertical-align:baseline;text-decoration-skip-ink:none;font-size:11pt;font-family:"Arial";font-style:normal}.c9{margin-left:36pt;padding-top:0pt;padding-left:0pt;padding-bottom:0pt;line-height:1.15;orphans:2;widows:2;text-align:left}.c29{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:20pt;font-family:"Arial";font-style:normal}.c34{margin-left:18pt;padding-top:3pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c21{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:16pt;font-family:"Arial";font-style:normal}.c18{padding-top:20pt;padding-bottom:6pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.c1{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Courier New";font-style:normal}.c8{color:#333333;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:10pt;font-family:"Consolas";font-style:normal}.c32{padding-top:18pt;padding-bottom:6pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.c0{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Arial";font-style:normal}.c38{color:#ff0000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:26pt;font-family:"Arial";font-style:normal}.c39{padding-top:0pt;padding-bottom:3pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:center}.c12{padding-top:0pt;padding-bottom:0pt;line-height:1.15;orphans:2;widows:2;text-align:left}.c26{color:#000000;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Arial";font-style:normal}.c20{padding-top:0pt;padding-bottom:0pt;line-height:1.42857;orphans:2;widows:2;text-align:left}.c40{padding-top:4pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c30{padding-top:10pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c33{padding-top:10pt;padding-bottom:4pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c37{font-size:10pt;font-family:"Consolas";color:#333333;font-weight:400}.c24{text-decoration-skip-ink:none;-webkit-text-decoration-skip:none;color:#1155cc;text-decoration:underline}.c6{padding-top:0pt;padding-bottom:0pt;line-height:1.0;text-align:left}.c36{border-spacing:0;border-collapse:collapse;margin-right:auto}.c27{background-color:#ffffff;max-width:468pt;padding:72pt 72pt 72pt 72pt}.c2{padding:0;margin:0}.c25{color:inherit;text-decoration:inherit}.c16{margin-left:72pt;padding-left:0pt}.c31{font-style:italic}.c35{height:21pt}.c15{margin-left:36pt}.c23{padding-left:0pt}.c4{height:0pt}.c3{font-weight:700}.c13{height:11pt}.title{padding-top:0pt;color:#000000;font-size:26pt;padding-bottom:3pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.subtitle{padding-top:0pt;color:#666666;font-size:15pt;padding-bottom:16pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}li{color:#000000;font-size:11pt;font-family:"Arial"}p{margin:0;color:#000000;font-size:11pt;font-family:"Arial"}h1{padding-top:20pt;color:#000000;font-size:20pt;padding-bottom:6pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h2{padding-top:18pt;color:#000000;font-size:16pt;padding-bottom:6pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h3{padding-top:16pt;color:#434343;font-size:14pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h4{padding-top:14pt;color:#666666;font-size:12pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h5{padding-top:12pt;color:#666666;font-size:11pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h6{padding-top:12pt;color:#666666;font-size:11pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;font-style:italic;orphans:2;widows:2;text-align:left}</style></head><body class="c27"><p class="c39 title" id="h.hlpacpauqwkx"><span>Prebid</span><span>&nbsp;Support for Enforcing TCF 2.0</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c40"><span class="c7"><a class="c25" href="#h.x9c0lsi8ay8">Overview</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.tldmebv0bdgp">Definitions</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.8ycuibmrgs9x">Assumptions</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.1pnyovoljlrm">Summary of Prebid TCF 2.0 Enforcement</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.3kby792a2sqy">Basic-vs-Full Enforcement</a></span></p><p class="c34"><span class="c7"><a class="c25" href="#h.83ablyvhjp4o">Basic Enforcement</a></span></p><p class="c34"><span class="c7"><a class="c25" href="#h.8cgpj780kmcq">Full Enforcement (Prebid Server Only)</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.t62kkttx488d">Prebid.js Functional Requirements</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.wjk7zfwgo1a2">Prebid SDK Functional Requirements</a></span></p><p class="c33"><span class="c7"><a class="c25" href="#h.o5pjp8p4qy06">Prebid Server Functional Requirements</a></span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.x9c0lsi8ay8"><span class="c29">Overview</span></h1><p class="c12"><span class="c0">The IAB&#39;s Transparency and Consent Framework version 2.0 for enhanced support of GDPR is scheduled to take effect Apr 1 2020. It&#39;s a major update from TCF 1.1 which Prebid currently supports, and is not compatible with the previous release.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The key changes are:</span></p><ul class="c2 lst-kix_wchaiekwhio-0 start"><li class="c9"><span class="c0">More &#39;purposes&#39; are defined.</span></li><li class="c9"><span class="c0">More flexibility for the legal bases used by vendors.</span></li><li class="c9"><span class="c0">Different in-page javascript API</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">References</span></p><ul class="c2 lst-kix_wz4xrdza29b-0 start"><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://iabeurope.eu/tcf-2-0/&amp;sa=D&amp;ust=1584107233971000">IAB Europe&#39;s TCF 2.0 Homepage</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://iabeurope.eu/tcfdocuments/documents/legal/tcfpolicyFINALv2.pdf&amp;sa=D&amp;ust=1584107233971000">TCF Policy</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%2520Tech%2520Lab%2520-%2520Consent%2520string%2520and%2520vendor%2520list%2520formats%2520v2.md&amp;sa=D&amp;ust=1584107233971000">TCF 2.0 Consent String Format</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://github.com/rubicon-project/prebid-server-java/blob/master/docs/developers/PrebidServerJava_GDPR_Requirements.pdf&amp;sa=D&amp;ust=1584107233972000">GDPR Requirements for Prebid Server (TCF1.1)</a></span></li></ul><h1 class="c18" id="h.tldmebv0bdgp"><span class="c29">Definitions</span></h1><ul class="c2 lst-kix_xcsisnkihklz-0 start"><li class="c9"><span class="c0">GDPR - General Data Protection Regulation. The EU&#39;s privacy regulations.</span></li><li class="c9"><span class="c0">EEA - European Economic Area. The region where the GDPR is in effect.</span></li><li class="c9"><span class="c0">IAB - Interactive Advertising Bureau. The ad industry consortium that developed the TCF as a way to help the ad ecosystem adhere to GDPR rules.</span></li><li class="c9"><span class="c0">TCF - Transparency and Consent Framework. </span></li><li class="c9"><span class="c0">CMP - Consent Management Platform. The user interface part of the TCF.</span></li><li class="c9"><span class="c0">GVL - Global Vendors List. The place where each ad entity registers what they do with user data.</span></li><li class="c9"><span class="c0">PBS - Prebid Server</span></li><li class="c9"><span class="c0">PBJS - Prebid.js</span></li><li class="c9"><span class="c0">PBS Host Company - the organization running a cluster of Prebid Servers</span></li><li class="c9"><span class="c0">Purpose 1 - &nbsp;Under TCF, there are many defined uses of private data. &quot;Purpose 1&quot; is &quot;Store and/or access information on a device&quot;. This means that users must consent before an ad tech vendor reads or writes data from their computer or phone. Those of us dealing with these things a lot memorize the numbers. Forgive us.</span></li><li class="c9"><span>Purpose 2 - &quot;Basic Ad Selection&quot;. </span><span class="c0">This looks to be one of the bigger areas of concern because the TCF policy could be interpreted to be a form of ad blocking. Or maybe not. Talk to your lawyers.</span></li><li class="c9"><span class="c0">Purpose 4 - &quot;Personalized Ad Selection&quot;. Basically, if the user doesn&rsquo;t consent, they don&rsquo;t want ads based on any type of direct user profile.</span></li><li class="c9"><span class="c0">Purpose 7 - &quot;Measure ad performance&quot;. This is another area of concern, because the TCF policy doesn&rsquo;t clearly define what it means to measure the &ldquo;effectiveness&rdquo; of ads. Talk to your lawyers about what this means for your organization.</span></li><li class="c9"><span class="c0">Special Feature 1 - &quot;Use precise geolocation data&quot;. Special Features are quite different than Purposes. They only allow user &quot;opt-in&quot;, and don&#39;t have as many layers of nuance as Purposes.</span></li><li class="c9"><span class="c0">Legal Basis - how an ad tech vendor views the importance of each Purpose for their mission. If they define &quot;consent&quot; as their &quot;basis&quot; for a given Purpose, they&#39;re able to work without some or all aspects of the user&#39;s data. But if they define &quot;Legitimate Interest&quot; (LI), they&#39;re basically saying &quot;We can&#39;t do our job without this data&quot;.</span></li><li class="c9"><span class="c0">Basic enforcement - a high-level mode of consent confirmation where the looks for a good-faith indication that the user has provided consent or legal basis signals before engaging in a privacy-protected activity. Does not read the GVL.</span></li><li class="c9"><span class="c0">Full enforcement - a detailed confirmation mode that reads the GVL, interprets the consent string, and performs legal basis analysis.</span></li></ul><h1 class="c18" id="h.8ycuibmrgs9x"><span class="c29">Assumptions</span></h1><p class="c12 c13"><span class="c0"></span></p><a id="t.e67b00b9c01ec82c8517d66b7ccbe4a7c7e6445b"></a><a id="t.0"></a><table class="c36"><tbody><tr class="c4"><td class="c28" colspan="1" rowspan="1"><p class="c6"><span class="c3">Important Legal Note</span><span class="c0">: Prebid.org cannot provide legal advice about GDPR or any other governmental regulation. Our aim is to provide a toolkit of functionality that will let publishers configure header bidding as defined by their legal counsel. We will consider feature suggestions, and review any code offered by the community.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">Enforcement of Purpose 2 (basic ad selection) looks to be one of the bigger areas of concern because the TCF policy could be interpreted to be a form of ad blocking. You will need to work with your legal counsel to determine how you intend to handle this scenario. Prebid.js and Prebid Server offer publishers the ability to enforce or not-enforce purposes individually. As an example of the kind of flexibility we aim to offer (*), here are some options you could discuss with your lawyers:</span></p><p class="c6 c13"><span class="c0"></span></p><ol class="c2 lst-kix_68qsl6zcqxrq-0 start" start="1"><li class="c6 c15 c23"><span class="c0">Treat Purpose 2 as an ad blocker.</span></li><li class="c6 c15 c23"><span class="c0">Ignore enforcement of selected Purposes at the Prebid level entirely, assuming that downstream vendors will handle the TCF strings appropriately. </span></li><li class="c6 c15 c23"><span class="c0">Ignore enforcement Purpose 2, assuming that users who object to &lsquo;Basic Ads&rsquo; will also object to &lsquo;Personalized Ads&rsquo;, causing any User IDs to be removed from ad requests.</span></li><li class="c6 c15 c23"><span class="c0">Ignore the Purpose-Consent portion of Purpose 2, but allow the user to block specific vendors.</span></li></ol><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c3">(*) - Note on phasing</span><span class="c0">: Please be aware that Prebid.js and Prebid Server will likely not deliver on the full TCF functionality by April 1st. Our initial goal for both products is to support Purpose 1 (Device Access) enforcement by that date. The ability to enforce the other purposes will be developed as soon as we can.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c3">(**)</span><span class="c0">&nbsp;Did we mention that you cannot rely on this document to learn how to configure your header bidding for GDPR? Seriously, talk to your lawyers.</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">General</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_svmmnj1snhr2-0 start" start="1"><li class="c9"><span class="c0">Prebid.org is neither a data controller nor data processor, but we supply software to both types of entities. Therefore, our software should provide a flexible set of controls necessary for both types of entities to run their businesses.</span></li><li class="c9"><span class="c0">Even if Prebid is configured to enforce activities by parsing consent data, publishers and downstream vendors are still responsible for ensuring their legal bases using the consent data they&#39;re provided. </span></li><li class="c9"><span class="c0">Prebid will ignore the TCF &quot;stack&quot; feature, assuming that the CMP will set the underlying Purposes appropriately.</span></li><li class="c9"><span class="c0">Data from the CMP will never be modified before passing to downstream entities.</span></li><li class="c9"><span class="c0">If TCF processing is turned on, and the user is determined to be in GDPR scope, and hasn&rsquo;t provided a consent string, the system should assume a consent string that has no consent offered.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid.js</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_6fc6u2jowkph-0 start" start="1"><li class="c9"><span class="c0">Prebid.js will only support parsing the TCF 2.0 consent string.</span></li><li class="c9"><span class="c0">TCF 2.0 features are available in Prebid.js only in a consent module, not as part of core. This allows publishers to build two versions of their wrappers: one for users in the EEA, one for users outside of the EEA.</span></li><li class="c9"><span class="c0">It&#39;s assumed that publishers run in two modes:</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-1 start" start="1"><li class="c12 c16"><span class="c0">A CMP is loaded on every page so TCF functions and data are fully available.</span></li><li class="c12 c16"><span class="c0">Consent data is stored in first party storage and passed to Prebid directly. TCF functions are not available from the CMP.</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-0" start="4"><li class="c9"><span class="c0">Prebid.js will not load the Global Vendors List (GVL) as this would significantly impact the success of header bidding implementations. However, Prebid.js will require a mapping of GVL vendor IDs to Prebid.js bidder codes. </span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-1 start" start="1"><li class="c12 c16"><span class="c0">Further, we assume that not all Prebid adapters will be in the GVL, so we&#39;ll need to support reference by GVL ID or bidder code.</span></li><li class="c12 c16"><span class="c0">Further, we assume that bidder aliases within one adapter may have different GVL IDs.</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-0" start="5"><li class="c9"><span class="c0">As a result of not having access to GVL entries, Prebid.js will only support &lsquo;Basic Enforcement&rsquo;.</span></li><li class="c9"><span>TCF2 will be supported in Prebid.js 3.x, with &#39;no enforcement&#39; being the default option. Prebid.js 4.0 will enforce Purpose 1 by default when the module is included.</span></li><li class="c9"><span>PurposeOneTreatment is ignored</span><span class="c0">&nbsp;for Prebid.js. Publishers who don&rsquo;t want to enforce Purpose 1 (or any other purpose) need to set Prebid&rsquo;s configuration appropriately.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid Server</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_pkkwt0mfnd4r-0 start" start="1"><li class="c9"><span class="c0">Prebid Server will need concurrent support of TCF 1.1 and TCF 2.0.</span></li><li class="c9"><span class="c0">Prebid Server will need to support &ldquo;Full Enforcement&rdquo; checks.</span></li><li class="c9"><span class="c0">AMP TCF 2.0 will be passed on the same parameter as TCF 1.1. </span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid SDK</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_xygzk5z3cyvz-0 start" start="1"><li class="c9"><span class="c0">Prebid SDK should parse the consent string in order to read the IDFA. Other than that, SDK just passes consent values to Prebid Server..</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.1pnyovoljlrm"><span class="c29">Summary of Prebid TCF 2.0 Enforcement</span></h1><p class="c12 c13"><span class="c0"></span></p><a id="t.de6c946673ec683bd257d6a726fa40f4a547f1ee"></a><a id="t.1"></a><table class="c36"><tbody><tr class="c4"><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c3">TCF </span><span class="c26 c3">Field</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">In-scope Activities</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">System</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Enforcement</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Publisher/</span></p><p class="c6"><span class="c26 c3">Host Company Controls</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 1 - Store and/or access information on a device</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">usersync pixels, user ID modules, and device storage</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server and Prebid SDK</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in preventing one or more uesrsync activities for one or more vendors.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 1</span></p><p class="c6"><span class="c0">Do not enforce purpose 1 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 1 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 2 - Select basic ads</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">call bid adapters</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in skipping one or more bid adapters.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">All configured modules will be called as usual unless all bidders are eliminated.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 2</span></p><p class="c6"><span>Do not enforce purpose 2 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 2 at the vendor level only.</span></p><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 4 - Select Personalized Ads</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">call bid adapters with userIds</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in removing the userIds before calling one or more bid adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 4</span></p><p class="c6"><span class="c0">Do not enforce purpose 4 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 4 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 7 - Measure ad performance</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">initiate analytics</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in skipping one or more analytics adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 7</span></p><p class="c6"><span class="c0">Do not enforce purpose 7 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 7 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Special Feature 1 - Use precise geolocation data</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">passing lat/long to server-side bid adapters</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in rounding lat/long values and IP address before sending to server-side adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce Special Feature 1</span></p></td></tr><tr class="c35"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Special Purpose 2 - Technically deliver ads or content</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">n/a</span></p></td><td class="c14" colspan="3" rowspan="1"><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">Special Purposes do not require consent. If a publisher&rsquo;s legal team wants to consider SP2, Prebid software should not be called.</span></p></td></tr><tr class="c35"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">PurposeOneConsent</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">n/a</span></p></td><td class="c14" colspan="3" rowspan="1"><p class="c6"><span class="c0">Prebid does not provide specific support for enforcing this flag. Instead, publishers may use the provided controls for Purpose 1 and other Prebid configuration to control whether the user&rsquo;s device is accessed.</span></p></td></tr></tbody></table><h1 class="c18" id="h.3kby792a2sqy"><span class="c29">Basic-vs-Full Enforcement</span></h1><p class="c12"><span class="c0">Prebid offers publishers several controls for whether consent/legal basis confirmation is even performed. The following flowchart shows how the controls</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span style="overflow: hidden; display: inline-block; margin: 0.00px 0.00px; border: 0.00px solid #000000; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px); width: 634.15px; height: 335.15px;"><img alt="" src="images/image2.png" style="width: 634.15px; height: 335.15px; margin-left: 0.00px; margin-top: 0.00px; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px);" title=""></span></p><p class="c12 c13"><span class="c0"></span></p><h2 class="c32" id="h.83ablyvhjp4o"><span class="c21">Basic Enforcement</span></h2><p class="c12"><span class="c0">The goal of &#39;basic enforcement&#39; is to confirm that there&#39;s enough evidence of consent to pass data on to vendors who have access to the GVL and can fully parse and enforce.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing a Purpose for a given Vendor, one of these scenarios must be true: :</span></p><ul class="c2 lst-kix_hxgng6in8mo4-0 start"><li class="c9"><span class="c0">User&rsquo;s purpose consent and user&rsquo;s vendor consent</span></li><li class="c9"><span class="c0">The Prebid-specific &lsquo;enforceVendor&rsquo; flag is set and user&rsquo;s vendor consent</span></li><li class="c9"><span class="c0">purpose LI established and vendor LI established</span></li><li class="c9"><span class="c0">The Prebid-specific &lsquo;enforceVendor&rsquo; flag is set and vendor LI established</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">In terms of the TCF 2.0 fields, Purpose P is ok for vendor V if either of these is true:</span></p><ol class="c2 lst-kix_jwv9q4tqofnu-0 start" start="1"><li class="c9"><span class="c0">PurposesConsent[P,V]==1 AND VendorConsentBitfield[V]==1</span></li><li class="c9"><span class="c0">pbEnforceVendor[P]==true AND VendorConsentBitfield[V]==1</span></li><li class="c9"><span class="c0">PurposesLITransparency[P]==1 AND VendorLegitimateInterestBitfield[V]==1</span></li><li class="c9"><span class="c0">pbEnforceVendor[P,V]==true AND VendorLegitimateInterestBitfield[V]==1</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing Special Feature 1, SpecialFeatureOptIns[1] must be true.</span></p><h2 class="c32" id="h.8cgpj780kmcq"><span class="c21">Full Enforcement (Prebid Server Only)</span></h2><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The big difference between &#39;basic&#39; and &#39;full&#39; enforcement is that Prebid Server has the GVL available to examine vendor legal bases.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing an activity that falls under a specific Purpose for a given Vendor, one of these 6 basic scenarios needs to be true:</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_3vftmdlxcpj0-0 start" start="1"><li class="c9"><span class="c0">Vendor claims consent as their basis, publisher doesn&#39;t restrict the purpose, user consents to the purpose (if the enforcePurpose flag is on), and user consents to the vendor (if the enforceVendor flag is on).</span></li><li class="c9"><span class="c0">Vendor claims (inflexible) legitimate interest as their basis, publisher doesn&#39;t restrict the purpose, user was provided notice of the legitimate interest basis for this purpose (if the enforcePurpose flag is on), and user was provided notice for the LI basis for this vendor (if the enforceVendor flag is on)</span></li><li class="c9"><span>Vendor claims flexible legal basis with legitimate interest as the default, publisher restriction </span><span class="c3">doesn&#39;t</span><span>&nbsp;require consent, and ((user was provided notice of the legitimate interest basis for this purpose+vendor) </span><span>OR (user consents to purpose+vendor)) [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with legitimate interest as the default, publisher </span><span class="c3">does</span><span class="c0">&nbsp;require consent, user consents to the purpose, and user consents to the vendor. [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with consent as the default, publisher restriction </span><span class="c3">doesn&#39;t</span><span>&nbsp;require legitimate interest, ((user consents to the purpose+vendor) </span><span>OR (user was provided notice for the legitimate interest basis for this purpose+vendor)) </span><span>[Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with consent as the default, publisher restriction </span><span class="c3">does</span><span class="c0">&nbsp;require legitimate interest, and user was provided notice for the legitimate interest basis for this purpose+vendor. [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on] </span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>Note that there are many more scenarios where the activity would </span><span class="c31">not</span><span class="c0">&nbsp;be allowed. </span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The technical definition in terms of the TCF 2.0 fields follows. Purpose P is ok for vendor V if any of these is true:</span></p><ol class="c2 lst-kix_6v7qjvftgbe8-0 start" start="1"><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes doesn&#39;t contain P and publisherRestrictions[P]!=0 and (!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes doesn&#39;t contain P and publisherRestrictions[P]!=0 and (!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==2 and (((!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)) OR ((!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)))</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==1 and (!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==1 and (((!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)) OR ((!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)))</span></li><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==2 and (!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing Special Feature 1, SpecialFeatureOptIns[1] must be true.</span></p><h1 class="c18" id="h.t62kkttx488d"><span class="c29">Prebid.js Functional Requirements</span></h1><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">1) An optional module must be available for reading the IAB TCF 2.0 API data. Publishers will include this module in their Prebid.js package when they need to support EEA users.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) Prebid.js must support scenarios where the TCF string parsing functions are not available. &nbsp;If the codebase for parsing the TCF string is significant, it should be made an optional module separate from the enforcement functions. A key goal of Prebid.js is to include only the code that publishers need for their particular use case. The technical design should consider whether it makes sense to bundle all of these components together, or break them into 2 or 3 separate modules:</span></p><ul class="c2 lst-kix_ewcld7rry2cw-0 start"><li class="c9"><span class="c0">Reading the TCF string</span></li><li class="c9"><span class="c0">Enforcing the TCF string</span></li><li class="c9"><span class="c0">Parsing the TCF string (?)</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) Prebid.js must support the following publisher controls:</span></p><ul class="c2 lst-kix_d8lzxbbe1553-0 start"><li class="c9"><span class="c0">Don&#39;t even read the TCF string (accomplished by not configuring the module)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P for vendor V</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Here&#39;s a set of proposed configurations within the existing consentManagement config object:</span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.d2f201df0390c3de46409e5bc5a638f6f58e1055"></a><a id="t.2"></a><table class="c36"><tbody><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Param</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c3 c26">Type</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Description</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Details</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.allowAuctionWithoutConsent</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Available in 3.x only, defines behavior for backwards compatibility. </span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span>For 3.x: If true, consider all Purposes as </span><span class="c31">not</span><span class="c0">&nbsp;enforceable.</span></p><p class="c6"><span class="c0">If false, consider only Purpose 2 enforceable.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.consentData</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">object</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Consent data provided statically.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Used when cmpApi is &quot;static&quot;.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.defaultGdprScope</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">object</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Lets the publisher override the defaults set by the enforceMode</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].purpose</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">string</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Possible values are &quot;storage&quot;, &quot;basicAds&quot;, &quot;personalizedAds&quot;, and &quot;measurement&quot; corresponding to Purposes 1,2,4, and 7 respectively.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">For some reason, people tend to prefer using the string names rather than the numbers.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].enforcePurpose</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Whether to enforce this purpose or not. Overrides the setting from enforceMode.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">The default in PBJS 3.x will be to enforce no purposes, and in 4.0 to enforce Purpose 1 and no others.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].enforceVendor</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Whether to enforce vendor consent/legal basis for this purpose or not..</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">The default in PBJS 3.x will be to enforce no purposes, and in 4.0 to enforce Purpose 1 and no others.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].vendorExceptions</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">array of strings</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Which biddercodes or module names should be treated as the opposite of the enforceVendor flag.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">If enforceVendor=false, then vendorExceptions are those that will be treated as true.</span></p><p class="c6"><span class="c0">If enforce=true, then vendorExceptions are those that will be treated as false.</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Example configurations:</span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.4cd6d00b2bd97ee52bb8fe7d3b16fd51a6657718"></a><a id="t.3"></a><table class="c36"><tbody><tr class="c4"><td class="c28" colspan="1" rowspan="1"><p class="c12"><span class="c1">pbjs.setConfig({</span></p><p class="c12"><span class="c1">&nbsp; consentManagement: {</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; gdpr: {</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; cmpApi: &#39;iab&#39;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; defaultGdprScope: true/false (0/1?)</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; timeout: 3000,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; // allowAuctionWithoutConsent: false, &nbsp;// deprecated</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; rules: [{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // don&rsquo;t enforce Purpose 1 except for bidderA.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // this means that TCF approval is only considered</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // for this one bidder.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;storage&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderA&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // Allow the user to object to vendors for Purpose 2</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // but don&rsquo;t allow them to turn off header bidding</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // altogether.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // The exception is bidderB, which the user will</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // not be allowed to reject</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;basicAds&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: true,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderB&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // allow the user to have their userId removed from</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // header bidding except for bidders A and B</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;personalizedAds&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: true,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: true</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderA&quot;,&quot;bidderB&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // analytics adapters are ok</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp;</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;measurement&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; }]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; }</span></p><p class="c12"><span class="c1">&nbsp; }</span></p><p class="c12"><span class="c1">});</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">You may notice that the examples above provide more flexibility than TCF requires. This allows publishers to establish custom legal bases in consultation with their legal counsel.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) If the &#39;gdprApplies&#39; flag is defined and is false, then Prebid.js may assume that GDPR is not in scope and therefore doesn&#39;t need to be enforced. All Purposes will be set to enforce=false.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) There should be a way for bidAdapters to supply a GVL ID for each alias they support.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">5) The aliasBidder() function should be extended to support specification of a GVL ID. e.g.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c20 c15"><span class="c37">pbjs.aliasBidder(&#39;appnexus&#39;, &#39;newAlias&#39;, 999);</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>6) If a bidder code isn&#39;t associated with a GVL ID, enforcement should assume that the vendor is </span><span class="c31">not allowed</span><span class="c0">&nbsp;unless the publisher has specifically named their bidder code.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">7) Analytics adapters must be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which analytics adapter(s) are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">8) User ID modules and Real Time Data modules should be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which modules are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">9) The system must be able to verify vendor consent in two ways:</span></p><ul class="c2 lst-kix_tb82mrxazni-0 start"><li class="c9"><span class="c0">User consents to GVL ID 52, and Prebid.js knows that 52 corresponds to the Rubicon bid adapter (and the Rubicon analytics adapter)</span></li></span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">10) The internal interface to bid adapters should remain the same: bidrequest.gdprConsent</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">11) The OpenRTB interface to Prebid Server should remain the same:</span></p><ul class="c2 lst-kix_u56eprq9ell0-0 start"><li class="c9"><span class="c0">regs.ext.gdpr </span></li><li class="c9"><span class="c0">user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">12) The system must support all the activity enforcement noted in the &#39;Summary of Prebid TCF 2.0 Enforcement&#39; section.</span></p><ol class="c2 lst-kix_7fhxg8i5msmt-0 start" start="1"><li class="c9"><span class="c0">If Purpose 1 is being enforced:</span></li></ol><ol class="c2 lst-kix_7fhxg8i5msmt-1 start" start="1"><li class="c12 c16"><span class="c0">Before invoking usersync pixels for each enforceable vendor, verify consent as described in &#39;Basic Enforcement&#39;.</span></li><li class="c12 c16"><span class="c0">Before reading or storing cookies or HTML 5 localstorage for each enforceable vendor, verify consent as described in &#39;Basic Enforcement&#39;. This will require enhancing the getCookie and setCookie utility functions to determine or accept the biddercode or module name.</span></li><li class="c12 c16"><span class="c0">Before invoking each enforceable userID sub-module, verify consent as described in &#39;Basic Enforcement&#39;.</span></li></ol><ol class="c2 lst-kix_7fhxg8i5msmt-0" start="2"><li class="c9"><span class="c0">If Purpose 2 is being enforced, verify consent for each vendor as described in &#39;Basic Enforcement&#39; before calling a bid adapter. If consent is not granted, log a console warning and skip it.</span></li><li class="c9"><span class="c0">If Purpose 4 is being enforced, verify consent for each vendor that passed the Purpose 2 test. If consent is not granted, log a console warning, remove the bidrequest.userId attribute and call the adapter.</span></li><li class="c9"><span class="c0">If Purpose 7 is being enforced, verify consent for each analytics module. If consent is not granted, log a console warning and skip it.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) If consentManagement.gdpr is configured but no consent string is available, the system must assume that the user does not consent to either purpose or vendor. Activities may still take place if the publisher has configured the relevant Purposes as &#39;not enforced&#39;.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) Bid adapters must do one of the following for all device access activities (reading or setting cookies or local storage):</span></p><ul class="c2 lst-kix_l0zuj3yh3ryb-0 start"><li class="c9"><span class="c0">Use the PBJS core utility functions, which will handle Purpose 1 enforcement.</span></li><li class="c9"><span class="c0">Post a public disclosure in the code and on prebid.org explaining the legal basis for not adhering to GDPR.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">14) Prebid core must make the following information available to analytics adapters:</span></p><ul class="c2 lst-kix_w6yj8blbe06x-0 start"><li class="c9"><span class="c0">Enforcement status of Purposes 1,2,4 and 7.</span></li><li class="c9"><span class="c0">An array of bidders and modules skipped due to TCF enforcement.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">15) It should be possible for a pub to define a mapping between a module code and a GVL ID</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">&nbsp; &nbsp;pbjs.setConfig({</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp;gvlMapping: {</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &ldquo;id5&rdquo;: 9999</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &ldquo;bidderX&rdquo;: 8888</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp;}</span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.wjk7zfwgo1a2"><span>Prebid SDK Functional Requirements</span></h1><p class="c12"><span class="c0">1) Prebid SDK must accept the following optional parameters to support TCF 2.0. It&rsquo;s assumed the app will pass these values directly or indirectly from a mobile CMP.</span></p><ul class="c2 lst-kix_ozkivkncyqrh-0 start"><li class="c9"><span class="c0">GDPR in-scope</span></li><li class="c9"><span class="c0">TCF Consent string</span></li><li class="c9"><span>&lsquo;deviceAccessConsent&rsquo; flag defining whether the SDK is allowed to read the IDFA or equivalent. It&rsquo;s assumed that the app will parse the consent string to confirm the user has consented to Purpose 1.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) When a request is defined to be GDPR in-scope, the SDK must confirm that the &lsquo;deviceAccessConsent&rsquo; flag is true. Here&rsquo;s the truth table for when the SDK is allowed to access the device ID:</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.cf04e882f648981d69d9d186d69ef24c3991b712"></a><a id="t.4"></a><table class="c36"><tbody><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent=true</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent=false</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent undefined</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope=false</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope=true</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope undefined</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) The SDK must pass the consent data to Prebid Server on the same OpenRTB attributes as defined in TCF 1.1:</span></p><ul class="c2 lst-kix_hii6fafh6hm-0 start"><li class="c9"><span class="c0">GDPR in-scope flag is regs.ext.gdpr</span></li><li class="c9"><span class="c0">Consent string is user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.o5pjp8p4qy06"><span class="c29">Prebid Server Functional Requirements</span></h1><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">1) Optional configuration must be available for host companies to turn on and off enforcing GDPR with IAB TCF 2.0 API data. There should be global and publisher account level configuration. The default should be to enforce.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) If enforcement is turned on for this request, Prebid Server must be able to determine whether it&#39;s in-scope for GDPR processing. If any of the following conditions are true, the request is in-scope:</span></p><ol class="c2 lst-kix_6jgx19e9u9pe-0 start" start="1"><li class="c9"><span class="c0">the incoming request defines regs.ext.gdpr:true.</span></li><li class="c9"><span class="c0">regs.ext.gdpr is undefined, geo-lookup is turned on, and the user&#39;s IP address is in a configurable set of countries.</span></li><li class="c9"><span class="c0">regs.ext.gdpr is undefined and the host company&#39;s default scope is to enforce.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) Prebid Server must support the following host company controls:</span></p><ul class="c2 lst-kix_d8lzxbbe1553-0"><li class="c9"><span class="c0">Enforce/Do not enforce purpose P (globally and per-account)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P for vendor V (globally and per-account)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce special purpose 1</span></li><li class="c9"><span class="c0">Enforce/Do not enforce special purpose 1 for vendor V</span></li><li class="c9"><span class="c0">ACCOUNT</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) Prebid Server must give host company config to say what to do with the purposeOneTreatment - both as a default and for each account:</span></p><ol class="c2 lst-kix_pzmtiq5h0915-0 start" start="1"><li class="c9"><span class="c0">ignore the flag entirely</span></li><li class="c9"><span class="c0">if purposeOneTreatment=1 and IsServiceSpecific=1 then Purpose 1 is overridden to no-access-allowed</span></li><li class="c9"><span>if</span><span>&nbsp;purposeOneTreatment=1 and IsServiceSpecific=1</span><span class="c0">&nbsp;then Purpose 1 is overridden to access-allowed</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The implementation of this &ldquo;PurposeOneTreatmentInterpretation flag modifies the flowchart above: it may short-circuit the logic, jumping straight to Yes or No without a normal enforcement check.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span style="overflow: hidden; display: inline-block; margin: 0.00px 0.00px; border: 0.00px solid #000000; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px); width: 624.00px; height: 376.28px;"><img alt="" src="images/image1.png" style="width: 624.00px; height: 376.28px; margin-left: 0.00px; margin-top: 0.00px; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px);" title=""></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">5) It must be possible for a Host Company to define its GVL ID to use for confirming user user consent for setting cookies.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Example configuration/DB entries:</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c15"><span class="c1">gdpr.host-vendor-id: 52<br>gdpr.enabled: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.enforcePurpose: no/basic/full // default full</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.enforceVendors: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.vendorExceptions: list of biddercodes<br>gdpr.specialfeature.S.enforce: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.specialfeature.S.vendorExceptions: list of biddercodes</span></p><p class="c12 c15"><span class="c1">gdpr.purposeOneTreatmentInterpretation: ignore/no-access-allowed/access-allowed</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.enabled: true/false &nbsp;// default true</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.enforcePurpose</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.enforceVendors</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.vendorExceptions<br>account.A.gdpr.specialfeature.S.enforce</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.specialfeature.S.vendorExceptions</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purposeOneTreatmentInterpretation</span></p><p class="c12 c15"><span class="c1">geolocation.VENDOR.server: url // location of geo lookup service</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">6) There should be a way for bidAdapters to supply a GVL ID for each alias they support.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">7) The external definition of aliases should be extended to support specification of a GVL ID. e.g.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c20 c15"><span class="c8">&quot;ext&quot;: {</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &quot;prebid&quot;: {</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &quot;aliases&quot;: { &nbsp; &nbsp; &nbsp; &nbsp; // existing feature</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &nbsp; &quot;districtm&quot;: &quot;appnexus&quot;</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; },</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &quot;aliasgvlids&quot;: { &nbsp; &nbsp; // new feature</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &nbsp; &quot;districtm&quot;: 144</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; }</span></p><p class="c15 c20"><span class="c8">&nbsp; &nbsp; }</span></p><p class="c20 c15"><span class="c8">&nbsp; }</span></p><p class="c20 c13"><span class="c8"></span></p><p class="c12"><span class="c0">8) Prebid Server&#39;s enforcement should be &quot;Full&quot; mode unless it doesn&#39;t have access to the proper GVL version.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">9) Prebid Server should be able to read the TCF2.0 GVL that&#39;s specified in the consent string. If it does not have immediate access to that version of the GVL, it may downgrade enforcement to &quot;Basic&quot;. The assumption is that subsequent requests for that version of the GVL will succeed. The system should log any usage of Basic Enforcement.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>10) If a bidder code isn&#39;t associated with a GVL ID, enforcement should assume that the vendor is </span><span class="c31">not allowed</span><span class="c0">&nbsp;unless the publisher has specifically named the bidder code as a configured exception.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">11) Analytics adapters must be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which analytics adapter(s) are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">12) User ID modules and Real Time Data modules should be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which modules are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) The system must be able to verify vendor consent in two ways:</span></p><ul class="c2 lst-kix_tb82mrxazni-0"><li class="c9"><span class="c0">User consents to GVL ID 52, and Prebid Server knows that 52 corresponds to the Rubicon bid adapter (and the Rubicon analytics adapter)</span></li><li class="c9"><span class="c0">The Host Company consents to the name &quot;bidderB&quot;, which would allow that biddercode to bid even if the user&#39;s Purpose 1 doesn&#39;t have specific consent.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">14) The internal interface to bid adapters should remain the same.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">15) The OpenRTB interface to Prebid Server should remain the same:</span></p><ul class="c2 lst-kix_u56eprq9ell0-0"><li class="c9"><span class="c0">regs.ext.gdpr </span></li><li class="c9"><span class="c0">user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">16) The system must support all the activity enforcement noted in the &#39;Summary of Prebid TCF 2.0 Enforcement&#39; section.</span></p><ol class="c2 lst-kix_w5k728jy05vp-0 start" start="1"><li class="c9"><span class="c0">If Purpose 1 is being enforced:</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-1 start" start="1"><li class="c12 c16"><span class="c0">Before invoking /cookie_sync pixels for each enforceable vendor, verify consent as appropriate for the enforcement method.</span></li><li class="c12 c16"><span class="c0">Before setting a cookie on /setuid, verify consent for the Host Company&#39;s GVL ID as appropriate for the enforcement method</span></li><li class="c12 c16"><span class="c0">Before passing ID values to each enforceable vendor, verify consent as appropriate for the enforcement method.</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-0" start="2"><li class="c9"><span class="c0">If Purpose 2 is being enforced, verify consent for each vendor as appropriate for the enforcement method before calling a bid adapter. If consent is not granted, log a metric and skip it.</span></li><li class="c9"><span class="c0">If Purpose 4 is being enforced, verify consent for each vendor that passed the Purpose 2 test. If consent is not granted, log a metric, remove the bidrequest.userId attribute and call the adapter.</span></li><li class="c9"><span class="c0">If Purpose 7 is being enforced, verify consent for each analytics module. If consent is not granted, log a metric and skip it.</span></li><li class="c9"><span class="c0">If Special Feature 1 is being enforced, verify user opt-in. If the user has opted out, round off the IP address and lat/long details and log a metric.</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-1 start" start="1"><li class="c12 c16"><span class="c0">IP masking: for IPv4, zero out the last byte. For IPv6, zero out the last 2 bytes.</span></li><li class="c12 c16"><span class="c0">Check the OpenRtb packet for $.device.geo.lat, $.device.geo.lon, $.user.geo.lat, $.user.geo.lon. Round off the values to the last two decimal points if they exist.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>17) If GDPR is being enforced but </span><span>no consent string is available</span><span class="c0">, the system must assume that the user does not consent to either purpose or vendor. Activities may still take place if the Host Company has configured the relevant Purposes as &#39;not enforced&#39;.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">18) Prebid Server core must make the following information available to analytics adapters:</span></p><ul class="c2 lst-kix_w6yj8blbe06x-0"><li class="c9"><span class="c0">Enforcement status of Purposes 1,2,4,7, and Special Purpose 1</span></li><li class="c9"><span class="c0">An array of bidders and modules skipped due to TCF enforcement.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p></body></html>
+<html><head><meta content="text/html; charset=UTF-8" http-equiv="content-type"><style type="text/css">@import url('https://themes.googleusercontent.com/fonts/css?kit=lhDjYqiy3mZ0x6ROQEUoUw');ol.lst-kix_7fhxg8i5msmt-8.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-8 0}.lst-kix_pkkwt0mfnd4r-1>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-1}ol.lst-kix_pkkwt0mfnd4r-8.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-8 0}.lst-kix_xygzk5z3cyvz-2>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-2}ol.lst-kix_xygzk5z3cyvz-5.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-5 0}.lst-kix_jwv9q4tqofnu-8>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-8}.lst-kix_u56eprq9ell0-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-2>li:before{content:"\0025a0  "}.lst-kix_u56eprq9ell0-0>li:before{content:"\0025cf  "}.lst-kix_5zdork13zaj5-2>li{counter-increment:lst-ctn-kix_5zdork13zaj5-2}ol.lst-kix_8irgp2z20781-7.start{counter-reset:lst-ctn-kix_8irgp2z20781-7 0}ol.lst-kix_5zdork13zaj5-6.start{counter-reset:lst-ctn-kix_5zdork13zaj5-6 0}.lst-kix_7fhxg8i5msmt-0>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-0}.lst-kix_3vftmdlxcpj0-7>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-7}.lst-kix_w5k728jy05vp-6>li{counter-increment:lst-ctn-kix_w5k728jy05vp-6}ol.lst-kix_pzmtiq5h0915-5.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-5 0}.lst-kix_ozkivkncyqrh-7>li:before{content:"\0025cb  "}.lst-kix_ozkivkncyqrh-6>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-8>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-5>li:before{content:"\0025a0  "}.lst-kix_svmmnj1snhr2-5>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-5}.lst-kix_6jgx19e9u9pe-5>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-5}.lst-kix_u56eprq9ell0-8>li:before{content:"\0025a0  "}.lst-kix_u56eprq9ell0-5>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-0>li:before{content:"\0025cf  "}.lst-kix_u56eprq9ell0-7>li:before{content:"\0025cb  "}.lst-kix_ozkivkncyqrh-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-3>li:before{content:"\0025cf  "}ol.lst-kix_68qsl6zcqxrq-6.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-6 0}.lst-kix_u56eprq9ell0-6>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-3>li:before{content:"\0025cf  "}.lst-kix_ozkivkncyqrh-2>li:before{content:"\0025a0  "}.lst-kix_ozkivkncyqrh-4>li:before{content:"\0025cb  "}.lst-kix_36fxx9lqc91n-1>li:before{content:"\0025cb  "}.lst-kix_u56eprq9ell0-4>li:before{content:"\0025cb  "}ol.lst-kix_6jgx19e9u9pe-8.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-8 0}.lst-kix_36fxx9lqc91n-0>li:before{content:"\0025cf  "}.lst-kix_7fhxg8i5msmt-6>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-6,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-3.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-3 0}.lst-kix_7fhxg8i5msmt-5>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-5,lower-roman) ". "}ol.lst-kix_pkkwt0mfnd4r-3.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-3 0}.lst-kix_7fhxg8i5msmt-4>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-4,lower-latin) ". "}.lst-kix_68qsl6zcqxrq-1>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-1}ul.lst-kix_hii6fafh6hm-0{list-style-type:none}ul.lst-kix_hii6fafh6hm-1{list-style-type:none}.lst-kix_7fhxg8i5msmt-2>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-2,lower-roman) ". "}ul.lst-kix_hii6fafh6hm-2{list-style-type:none}ul.lst-kix_hii6fafh6hm-3{list-style-type:none}.lst-kix_7fhxg8i5msmt-1>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-1,lower-latin) ". "}.lst-kix_7fhxg8i5msmt-3>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-3,decimal) ". "}ul.lst-kix_hii6fafh6hm-4{list-style-type:none}ul.lst-kix_hii6fafh6hm-5{list-style-type:none}.lst-kix_w5k728jy05vp-2>li{counter-increment:lst-ctn-kix_w5k728jy05vp-2}ul.lst-kix_hii6fafh6hm-6{list-style-type:none}ul.lst-kix_hii6fafh6hm-7{list-style-type:none}ul.lst-kix_hii6fafh6hm-8{list-style-type:none}.lst-kix_jwv9q4tqofnu-4>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-4}.lst-kix_svmmnj1snhr2-1>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-1}.lst-kix_w6yj8blbe06x-6>li:before{content:"\0025cf  "}.lst-kix_w6yj8blbe06x-8>li:before{content:"\0025a0  "}.lst-kix_7fhxg8i5msmt-0>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-0,decimal) ". "}.lst-kix_7fhxg8i5msmt-7>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-7}.lst-kix_w6yj8blbe06x-7>li:before{content:"\0025cb  "}.lst-kix_3vftmdlxcpj0-0>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-0}ul.lst-kix_wchaiekwhio-7{list-style-type:none}ul.lst-kix_wchaiekwhio-6{list-style-type:none}ul.lst-kix_wchaiekwhio-5{list-style-type:none}ol.lst-kix_svmmnj1snhr2-7.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-7 0}.lst-kix_w6yj8blbe06x-0>li:before{content:"\0025cf  "}ul.lst-kix_wchaiekwhio-4{list-style-type:none}ul.lst-kix_wchaiekwhio-3{list-style-type:none}ul.lst-kix_wchaiekwhio-2{list-style-type:none}ul.lst-kix_wchaiekwhio-1{list-style-type:none}.lst-kix_w6yj8blbe06x-3>li:before{content:"\0025cf  "}ul.lst-kix_wchaiekwhio-0{list-style-type:none}ol.lst-kix_svmmnj1snhr2-0.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-0 0}.lst-kix_w6yj8blbe06x-4>li:before{content:"\0025cb  "}ol.lst-kix_68qsl6zcqxrq-1.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-1 0}ol.lst-kix_6fc6u2jowkph-4.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-4 0}.lst-kix_5zdork13zaj5-6>li{counter-increment:lst-ctn-kix_5zdork13zaj5-6}.lst-kix_w6yj8blbe06x-5>li:before{content:"\0025a0  "}.lst-kix_w6yj8blbe06x-2>li:before{content:"\0025a0  "}.lst-kix_w6yj8blbe06x-1>li:before{content:"\0025cb  "}ul.lst-kix_wchaiekwhio-8{list-style-type:none}ul.lst-kix_hxgng6in8mo4-7{list-style-type:none}ol.lst-kix_6fc6u2jowkph-8{list-style-type:none}.lst-kix_tb82mrxazni-7>li:before{content:"\0025cb  "}ul.lst-kix_hxgng6in8mo4-6{list-style-type:none}.lst-kix_6jgx19e9u9pe-1>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-1}ol.lst-kix_6fc6u2jowkph-7{list-style-type:none}ul.lst-kix_hxgng6in8mo4-5{list-style-type:none}ol.lst-kix_6fc6u2jowkph-6{list-style-type:none}.lst-kix_hxgng6in8mo4-1>li:before{content:"\0025cb  "}.lst-kix_hxgng6in8mo4-3>li:before{content:"\0025cf  "}ul.lst-kix_hxgng6in8mo4-4{list-style-type:none}.lst-kix_tb82mrxazni-5>li:before{content:"\0025a0  "}.lst-kix_68qsl6zcqxrq-4>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-4}.lst-kix_wz4xrdza29b-2>li:before{content:"\0025a0  "}.lst-kix_wz4xrdza29b-6>li:before{content:"\0025cf  "}ul.lst-kix_hxgng6in8mo4-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-8.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-8 0}.lst-kix_tb82mrxazni-3>li:before{content:"\0025cf  "}ol.lst-kix_pkkwt0mfnd4r-1.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-1 0}ol.lst-kix_w5k728jy05vp-2.start{counter-reset:lst-ctn-kix_w5k728jy05vp-2 0}ul.lst-kix_hxgng6in8mo4-3{list-style-type:none}ul.lst-kix_hxgng6in8mo4-2{list-style-type:none}.lst-kix_wz4xrdza29b-4>li:before{content:"\0025cb  "}ul.lst-kix_hxgng6in8mo4-1{list-style-type:none}ul.lst-kix_hxgng6in8mo4-0{list-style-type:none}.lst-kix_7fhxg8i5msmt-4>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-4}ol.lst-kix_5zdork13zaj5-1{list-style-type:none}ol.lst-kix_5zdork13zaj5-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-3.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-3 0}ol.lst-kix_6fc6u2jowkph-1{list-style-type:none}ol.lst-kix_5zdork13zaj5-7{list-style-type:none}ol.lst-kix_6fc6u2jowkph-0{list-style-type:none}ol.lst-kix_5zdork13zaj5-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-1.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-1 0}ol.lst-kix_5zdork13zaj5-8{list-style-type:none}ol.lst-kix_6fc6u2jowkph-5{list-style-type:none}ol.lst-kix_5zdork13zaj5-3{list-style-type:none}ol.lst-kix_6fc6u2jowkph-4{list-style-type:none}ol.lst-kix_5zdork13zaj5-2{list-style-type:none}ol.lst-kix_6fc6u2jowkph-3{list-style-type:none}ol.lst-kix_5zdork13zaj5-5{list-style-type:none}.lst-kix_wz4xrdza29b-8>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-2{list-style-type:none}ol.lst-kix_5zdork13zaj5-4{list-style-type:none}.lst-kix_ewcld7rry2cw-1>li:before{content:"\0025cb  "}ol.lst-kix_xygzk5z3cyvz-6{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-7{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-8{list-style-type:none}.lst-kix_ewcld7rry2cw-5>li:before{content:"\0025a0  "}.lst-kix_6jgx19e9u9pe-2>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-2}.lst-kix_ewcld7rry2cw-7>li:before{content:"\0025cb  "}.lst-kix_6v7qjvftgbe8-2>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-2}.lst-kix_6fc6u2jowkph-5>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-5}ol.lst-kix_6jgx19e9u9pe-1.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-1 0}ul.lst-kix_u56eprq9ell0-0{list-style-type:none}ul.lst-kix_u56eprq9ell0-2{list-style-type:none}.lst-kix_tb82mrxazni-1>li:before{content:"\0025cb  "}ol.lst-kix_5zdork13zaj5-4.start{counter-reset:lst-ctn-kix_5zdork13zaj5-4 0}ul.lst-kix_u56eprq9ell0-1{list-style-type:none}.lst-kix_xygzk5z3cyvz-6>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-6}ul.lst-kix_u56eprq9ell0-4{list-style-type:none}ul.lst-kix_u56eprq9ell0-3{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-2{list-style-type:none}ul.lst-kix_u56eprq9ell0-6{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-3{list-style-type:none}ul.lst-kix_u56eprq9ell0-5{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-4{list-style-type:none}ul.lst-kix_u56eprq9ell0-8{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-5{list-style-type:none}ul.lst-kix_u56eprq9ell0-7{list-style-type:none}.lst-kix_hxgng6in8mo4-5>li:before{content:"\0025a0  "}.lst-kix_hxgng6in8mo4-7>li:before{content:"\0025cb  "}.lst-kix_ewcld7rry2cw-3>li:before{content:"\0025cf  "}ol.lst-kix_6v7qjvftgbe8-5.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-5 0}ol.lst-kix_xygzk5z3cyvz-0{list-style-type:none}.lst-kix_8irgp2z20781-6>li{counter-increment:lst-ctn-kix_8irgp2z20781-6}.lst-kix_wz4xrdza29b-0>li:before{content:"\0025cf  "}ol.lst-kix_xygzk5z3cyvz-1{list-style-type:none}.lst-kix_pzmtiq5h0915-5>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-5}ol.lst-kix_5zdork13zaj5-1.start{counter-reset:lst-ctn-kix_5zdork13zaj5-1 0}.lst-kix_7fhxg8i5msmt-8>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-8,lower-roman) ". "}.lst-kix_8irgp2z20781-4>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-4,lower-latin) ") "}.lst-kix_8irgp2z20781-8>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-8,lower-roman) ". "}.lst-kix_36fxx9lqc91n-3>li:before{content:"\0025cf  "}.lst-kix_8irgp2z20781-6>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-6,decimal) ". "}.lst-kix_36fxx9lqc91n-5>li:before{content:"\0025a0  "}.lst-kix_36fxx9lqc91n-7>li:before{content:"\0025cb  "}.lst-kix_6v7qjvftgbe8-1>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-1}.lst-kix_pzmtiq5h0915-6>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-6}.lst-kix_8irgp2z20781-0>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-0,decimal) ") "}ol.lst-kix_6v7qjvftgbe8-8{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-7{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-6{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-5{list-style-type:none}.lst-kix_8irgp2z20781-2>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-2,lower-roman) ") "}ol.lst-kix_6v7qjvftgbe8-4{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-7.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-7 0}ol.lst-kix_6v7qjvftgbe8-3{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-2{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-0{list-style-type:none}.lst-kix_68qsl6zcqxrq-5>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-5}.lst-kix_7fhxg8i5msmt-3>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-3}.lst-kix_pkkwt0mfnd4r-5>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-5}ol.lst-kix_6fc6u2jowkph-7.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-7 0}.lst-kix_d8lzxbbe1553-0>li:before{content:"\0025cf  "}.lst-kix_3vftmdlxcpj0-7>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-7,lower-latin) ". "}.lst-kix_8irgp2z20781-5>li{counter-increment:lst-ctn-kix_8irgp2z20781-5}ol.lst-kix_pzmtiq5h0915-0.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-0 0}.lst-kix_d8lzxbbe1553-2>li:before{content:"\0025a0  "}.lst-kix_d8lzxbbe1553-4>li:before{content:"\0025cb  "}ol.lst-kix_xygzk5z3cyvz-0.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-0 0}.lst-kix_3vftmdlxcpj0-3>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-3,decimal) ". "}.lst-kix_3vftmdlxcpj0-5>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-5,lower-roman) ". "}ol.lst-kix_w5k728jy05vp-0.start{counter-reset:lst-ctn-kix_w5k728jy05vp-0 0}ol.lst-kix_6jgx19e9u9pe-3.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-3 0}.lst-kix_3vftmdlxcpj0-1>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-1,lower-latin) ". "}.lst-kix_d8lzxbbe1553-6>li:before{content:"\0025cf  "}.lst-kix_pzmtiq5h0915-8>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-8}.lst-kix_w5k728jy05vp-5>li{counter-increment:lst-ctn-kix_w5k728jy05vp-5}.lst-kix_jwv9q4tqofnu-5>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-5,lower-roman) ". "}.lst-kix_3vftmdlxcpj0-8>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-8}ol.lst-kix_pkkwt0mfnd4r-0{list-style-type:none}.lst-kix_6fc6u2jowkph-0>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-0,decimal) ". "}.lst-kix_5zdork13zaj5-1>li{counter-increment:lst-ctn-kix_5zdork13zaj5-1}.lst-kix_d8lzxbbe1553-8>li:before{content:"\0025a0  "}ol.lst-kix_pkkwt0mfnd4r-2{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-1{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-4{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-3{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-6{list-style-type:none}.lst-kix_jwv9q4tqofnu-6>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-6,decimal) ". "}ol.lst-kix_8irgp2z20781-8{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-5{list-style-type:none}ol.lst-kix_8irgp2z20781-7{list-style-type:none}ol.lst-kix_pkkwt0mfnd4r-8{list-style-type:none}.lst-kix_svmmnj1snhr2-4>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-4}ol.lst-kix_pkkwt0mfnd4r-7{list-style-type:none}.lst-kix_jwv9q4tqofnu-7>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-7}.lst-kix_6fc6u2jowkph-4>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-0>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-0,decimal) ". "}.lst-kix_6fc6u2jowkph-3>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-3,decimal) ". "}.lst-kix_6fc6u2jowkph-7>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-7,lower-latin) ". "}ol.lst-kix_3vftmdlxcpj0-8.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-8 0}ol.lst-kix_5zdork13zaj5-3.start{counter-reset:lst-ctn-kix_5zdork13zaj5-3 0}.lst-kix_6v7qjvftgbe8-8>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-8}ol.lst-kix_8irgp2z20781-4.start{counter-reset:lst-ctn-kix_8irgp2z20781-4 0}.lst-kix_hii6fafh6hm-6>li:before{content:"\0025cf  "}.lst-kix_wchaiekwhio-2>li:before{content:"\0025a0  "}.lst-kix_xygzk5z3cyvz-3>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-3,decimal) ". "}.lst-kix_xygzk5z3cyvz-7>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-7,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-4>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-8>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-8,lower-roman) ". "}.lst-kix_6jgx19e9u9pe-8>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-8}ol.lst-kix_jwv9q4tqofnu-7.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-7 0}.lst-kix_6fc6u2jowkph-8>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-8,lower-roman) ". "}.lst-kix_wchaiekwhio-6>li:before{content:"\0025cf  "}ol.lst-kix_pkkwt0mfnd4r-0.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-0 0}ul.lst-kix_36fxx9lqc91n-1{list-style-type:none}.lst-kix_6fc6u2jowkph-8>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-8}ul.lst-kix_36fxx9lqc91n-2{list-style-type:none}.lst-kix_3vftmdlxcpj0-6>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-6}ul.lst-kix_36fxx9lqc91n-0{list-style-type:none}.lst-kix_wchaiekwhio-7>li:before{content:"\0025cb  "}ul.lst-kix_36fxx9lqc91n-5{list-style-type:none}ol.lst-kix_pzmtiq5h0915-2.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-2 0}ul.lst-kix_36fxx9lqc91n-6{list-style-type:none}ul.lst-kix_36fxx9lqc91n-3{list-style-type:none}ul.lst-kix_36fxx9lqc91n-4{list-style-type:none}.lst-kix_xygzk5z3cyvz-3>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-3}ol.lst-kix_3vftmdlxcpj0-2.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-2 0}ol.lst-kix_6jgx19e9u9pe-5.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-5 0}.lst-kix_68qsl6zcqxrq-0>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-0}ul.lst-kix_36fxx9lqc91n-7{list-style-type:none}ul.lst-kix_36fxx9lqc91n-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-1.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-1 0}.lst-kix_svmmnj1snhr2-2>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-2}ol.lst-kix_68qsl6zcqxrq-3.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-3 0}.lst-kix_wchaiekwhio-3>li:before{content:"\0025cf  "}.lst-kix_6fc6u2jowkph-6>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-6}ol.lst-kix_6jgx19e9u9pe-6{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-5{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-8{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-7{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-0{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-2{list-style-type:none}.lst-kix_jwv9q4tqofnu-5>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-5}ol.lst-kix_6jgx19e9u9pe-1{list-style-type:none}.lst-kix_68qsl6zcqxrq-7>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-7}ol.lst-kix_6jgx19e9u9pe-4{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-3{list-style-type:none}ul.lst-kix_wz4xrdza29b-3{list-style-type:none}ul.lst-kix_wz4xrdza29b-2{list-style-type:none}ul.lst-kix_wz4xrdza29b-5{list-style-type:none}.lst-kix_pzmtiq5h0915-3>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-3,decimal) ". "}ul.lst-kix_wz4xrdza29b-4{list-style-type:none}ul.lst-kix_wz4xrdza29b-1{list-style-type:none}ul.lst-kix_wz4xrdza29b-0{list-style-type:none}.lst-kix_xygzk5z3cyvz-5>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-5}ul.lst-kix_wz4xrdza29b-7{list-style-type:none}ul.lst-kix_wz4xrdza29b-6{list-style-type:none}ol.lst-kix_w5k728jy05vp-4.start{counter-reset:lst-ctn-kix_w5k728jy05vp-4 0}.lst-kix_pzmtiq5h0915-0>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-0,decimal) ". "}ul.lst-kix_wz4xrdza29b-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-8.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-8 0}ol.lst-kix_jwv9q4tqofnu-0.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-0 0}ol.lst-kix_w5k728jy05vp-3.start{counter-reset:lst-ctn-kix_w5k728jy05vp-3 0}ol.lst-kix_8irgp2z20781-5.start{counter-reset:lst-ctn-kix_8irgp2z20781-5 0}ol.lst-kix_6jgx19e9u9pe-6.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-6 0}ol.lst-kix_3vftmdlxcpj0-1.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-1 0}.lst-kix_xcsisnkihklz-4>li:before{content:"\0025cb  "}.lst-kix_pzmtiq5h0915-4>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-4,lower-latin) ". "}ol.lst-kix_jwv9q4tqofnu-8{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-7{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-6{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-5{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-4{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-3{list-style-type:none}.lst-kix_xcsisnkihklz-1>li:before{content:"\0025cb  "}ol.lst-kix_jwv9q4tqofnu-2{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-1{list-style-type:none}.lst-kix_6v7qjvftgbe8-3>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-3}ol.lst-kix_jwv9q4tqofnu-0{list-style-type:none}.lst-kix_pzmtiq5h0915-1>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-1}.lst-kix_pzmtiq5h0915-7>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-7,lower-latin) ". "}.lst-kix_xcsisnkihklz-0>li:before{content:"\0025cf  "}ol.lst-kix_jwv9q4tqofnu-6.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-6 0}.lst-kix_pzmtiq5h0915-8>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-8,lower-roman) ". "}ol.lst-kix_3vftmdlxcpj0-7.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-7 0}ol.lst-kix_68qsl6zcqxrq-2.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-2 0}.lst-kix_6jgx19e9u9pe-1>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-1,lower-latin) ". "}.lst-kix_tb82mrxazni-8>li:before{content:"\0025a0  "}.lst-kix_hxgng6in8mo4-0>li:before{content:"\0025cf  "}.lst-kix_hxgng6in8mo4-4>li:before{content:"\0025cb  "}.lst-kix_tb82mrxazni-4>li:before{content:"\0025cb  "}.lst-kix_wz4xrdza29b-3>li:before{content:"\0025cf  "}ol.lst-kix_68qsl6zcqxrq-5.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-5 0}.lst-kix_w5k728jy05vp-0>li{counter-increment:lst-ctn-kix_w5k728jy05vp-0}.lst-kix_ewcld7rry2cw-8>li:before{content:"\0025a0  "}ol.lst-kix_jwv9q4tqofnu-5.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-5 0}.lst-kix_6jgx19e9u9pe-5>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-5,lower-roman) ". "}.lst-kix_wz4xrdza29b-7>li:before{content:"\0025cb  "}ol.lst-kix_pzmtiq5h0915-6.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-6 0}.lst-kix_xcsisnkihklz-8>li:before{content:"\0025a0  "}.lst-kix_ewcld7rry2cw-0>li:before{content:"\0025cf  "}.lst-kix_6v7qjvftgbe8-5>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-5}ol.lst-kix_3vftmdlxcpj0-6.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-6 0}ol.lst-kix_w5k728jy05vp-5.start{counter-reset:lst-ctn-kix_w5k728jy05vp-5 0}.lst-kix_3vftmdlxcpj0-1>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-1}.lst-kix_3vftmdlxcpj0-3>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-3}.lst-kix_pzmtiq5h0915-3>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-3}.lst-kix_tb82mrxazni-0>li:before{content:"\0025cf  "}.lst-kix_hxgng6in8mo4-8>li:before{content:"\0025a0  "}ol.lst-kix_w5k728jy05vp-8.start{counter-reset:lst-ctn-kix_w5k728jy05vp-8 0}ol.lst-kix_8irgp2z20781-3.start{counter-reset:lst-ctn-kix_8irgp2z20781-3 0}.lst-kix_7fhxg8i5msmt-5>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-5}.lst-kix_ewcld7rry2cw-4>li:before{content:"\0025cb  "}ol.lst-kix_8irgp2z20781-0.start{counter-reset:lst-ctn-kix_8irgp2z20781-0 0}ol.lst-kix_5zdork13zaj5-7.start{counter-reset:lst-ctn-kix_5zdork13zaj5-7 0}ol.lst-kix_5zdork13zaj5-8.start{counter-reset:lst-ctn-kix_5zdork13zaj5-8 0}.lst-kix_7fhxg8i5msmt-7>li:before{content:"" counter(lst-ctn-kix_7fhxg8i5msmt-7,lower-latin) ". "}.lst-kix_8irgp2z20781-5>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-5,lower-roman) ") "}.lst-kix_6v7qjvftgbe8-7>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-7,lower-latin) ". "}.lst-kix_6v7qjvftgbe8-3>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-3,decimal) ". "}.lst-kix_36fxx9lqc91n-2>li:before{content:"\0025a0  "}.lst-kix_5zdork13zaj5-4>li{counter-increment:lst-ctn-kix_5zdork13zaj5-4}ol.lst-kix_8irgp2z20781-2.start{counter-reset:lst-ctn-kix_8irgp2z20781-2 0}.lst-kix_pkkwt0mfnd4r-1>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-1,lower-latin) ". "}.lst-kix_36fxx9lqc91n-6>li:before{content:"\0025cf  "}ul.lst-kix_tb82mrxazni-8{list-style-type:none}ul.lst-kix_tb82mrxazni-7{list-style-type:none}.lst-kix_l0zuj3yh3ryb-3>li:before{content:"\0025cf  "}ol.lst-kix_pzmtiq5h0915-8.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-8 0}ul.lst-kix_tb82mrxazni-6{list-style-type:none}ul.lst-kix_tb82mrxazni-5{list-style-type:none}ol.lst-kix_w5k728jy05vp-0{list-style-type:none}ul.lst-kix_tb82mrxazni-4{list-style-type:none}ul.lst-kix_tb82mrxazni-3{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-4.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-4 0}ul.lst-kix_tb82mrxazni-2{list-style-type:none}ol.lst-kix_w5k728jy05vp-7.start{counter-reset:lst-ctn-kix_w5k728jy05vp-7 0}ul.lst-kix_tb82mrxazni-1{list-style-type:none}ol.lst-kix_w5k728jy05vp-4{list-style-type:none}ul.lst-kix_tb82mrxazni-0{list-style-type:none}ol.lst-kix_w5k728jy05vp-3{list-style-type:none}ol.lst-kix_w5k728jy05vp-2{list-style-type:none}ol.lst-kix_jwv9q4tqofnu-2.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-2 0}.lst-kix_8irgp2z20781-1>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-1,lower-latin) ") "}.lst-kix_l0zuj3yh3ryb-7>li:before{content:"\0025cb  "}ol.lst-kix_3vftmdlxcpj0-3.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-3 0}ol.lst-kix_w5k728jy05vp-1{list-style-type:none}ol.lst-kix_w5k728jy05vp-8{list-style-type:none}.lst-kix_pkkwt0mfnd4r-5>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-5,lower-roman) ". "}ol.lst-kix_w5k728jy05vp-7{list-style-type:none}ol.lst-kix_w5k728jy05vp-6{list-style-type:none}ol.lst-kix_w5k728jy05vp-5{list-style-type:none}.lst-kix_w5k728jy05vp-8>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-8,lower-roman) ". "}.lst-kix_pkkwt0mfnd4r-8>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-8}.lst-kix_jwv9q4tqofnu-0>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-0}.lst-kix_68qsl6zcqxrq-2>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-2}.lst-kix_d8lzxbbe1553-1>li:before{content:"\0025cb  "}.lst-kix_w5k728jy05vp-7>li{counter-increment:lst-ctn-kix_w5k728jy05vp-7}ol.lst-kix_3vftmdlxcpj0-4.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-4 0}.lst-kix_hii6fafh6hm-2>li:before{content:"\0025a0  "}.lst-kix_3vftmdlxcpj0-6>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-6,decimal) ". "}.lst-kix_8irgp2z20781-2>li{counter-increment:lst-ctn-kix_8irgp2z20781-2}ol.lst-kix_8irgp2z20781-6{list-style-type:none}ol.lst-kix_8irgp2z20781-5{list-style-type:none}.lst-kix_d8lzxbbe1553-5>li:before{content:"\0025a0  "}ol.lst-kix_jwv9q4tqofnu-3.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-3 0}ol.lst-kix_8irgp2z20781-4{list-style-type:none}ol.lst-kix_8irgp2z20781-3{list-style-type:none}ol.lst-kix_8irgp2z20781-2{list-style-type:none}ol.lst-kix_8irgp2z20781-1{list-style-type:none}ol.lst-kix_8irgp2z20781-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-7.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-7 0}.lst-kix_3vftmdlxcpj0-2>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-1>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-1}.lst-kix_jwv9q4tqofnu-2>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-2,lower-roman) ". "}ul.lst-kix_w6yj8blbe06x-6{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-1.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-1 0}ul.lst-kix_w6yj8blbe06x-7{list-style-type:none}.lst-kix_68qsl6zcqxrq-4>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-4,lower-latin) ") "}.lst-kix_68qsl6zcqxrq-5>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-5,lower-roman) ") "}ol.lst-kix_3vftmdlxcpj0-5.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-5 0}.lst-kix_svmmnj1snhr2-8>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-8,lower-roman) ". "}ul.lst-kix_w6yj8blbe06x-4{list-style-type:none}ul.lst-kix_w6yj8blbe06x-5{list-style-type:none}.lst-kix_6jgx19e9u9pe-7>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-7}.lst-kix_68qsl6zcqxrq-6>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-6,decimal) ". "}ol.lst-kix_6jgx19e9u9pe-2.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-2 0}ul.lst-kix_w6yj8blbe06x-8{list-style-type:none}.lst-kix_68qsl6zcqxrq-2>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-2,lower-roman) ") "}.lst-kix_68qsl6zcqxrq-1>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-1,lower-latin) ") "}ol.lst-kix_6fc6u2jowkph-3.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-3 0}.lst-kix_68qsl6zcqxrq-8>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-8,lower-roman) ". "}.lst-kix_svmmnj1snhr2-4>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-4,lower-latin) ". "}ol.lst-kix_svmmnj1snhr2-6.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-6 0}ol.lst-kix_jwv9q4tqofnu-4.start{counter-reset:lst-ctn-kix_jwv9q4tqofnu-4 0}.lst-kix_68qsl6zcqxrq-7>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-7,lower-latin) ". "}.lst-kix_svmmnj1snhr2-2>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-2,lower-roman) ". "}.lst-kix_svmmnj1snhr2-3>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-3,decimal) ". "}.lst-kix_68qsl6zcqxrq-0>li:before{content:"" counter(lst-ctn-kix_68qsl6zcqxrq-0,decimal) ") "}ol.lst-kix_w5k728jy05vp-6.start{counter-reset:lst-ctn-kix_w5k728jy05vp-6 0}.lst-kix_svmmnj1snhr2-3>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-3}ol.lst-kix_8irgp2z20781-1.start{counter-reset:lst-ctn-kix_8irgp2z20781-1 0}.lst-kix_svmmnj1snhr2-5>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-5,lower-roman) ". "}.lst-kix_68qsl6zcqxrq-3>li:before{content:"(" counter(lst-ctn-kix_68qsl6zcqxrq-3,decimal) ") "}.lst-kix_svmmnj1snhr2-6>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-6,decimal) ". "}.lst-kix_svmmnj1snhr2-7>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-7,lower-latin) ". "}.lst-kix_w5k728jy05vp-2>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-2,lower-roman) ". "}ol.lst-kix_5zdork13zaj5-0.start{counter-reset:lst-ctn-kix_5zdork13zaj5-0 0}.lst-kix_w5k728jy05vp-3>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-3,decimal) ". "}ol.lst-kix_w5k728jy05vp-1.start{counter-reset:lst-ctn-kix_w5k728jy05vp-1 0}ol.lst-kix_7fhxg8i5msmt-2.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-2 0}.lst-kix_w5k728jy05vp-4>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-4,lower-latin) ". "}.lst-kix_w5k728jy05vp-1>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-1,lower-latin) ". "}ul.lst-kix_w6yj8blbe06x-2{list-style-type:none}ul.lst-kix_w6yj8blbe06x-3{list-style-type:none}ul.lst-kix_w6yj8blbe06x-0{list-style-type:none}ul.lst-kix_w6yj8blbe06x-1{list-style-type:none}.lst-kix_xygzk5z3cyvz-0>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-0}.lst-kix_w5k728jy05vp-0>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-0,decimal) ". "}.lst-kix_w5k728jy05vp-8>li{counter-increment:lst-ctn-kix_w5k728jy05vp-8}ol.lst-kix_6jgx19e9u9pe-7.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-7 0}ol.lst-kix_8irgp2z20781-6.start{counter-reset:lst-ctn-kix_8irgp2z20781-6 0}.lst-kix_8irgp2z20781-0>li{counter-increment:lst-ctn-kix_8irgp2z20781-0}ol.lst-kix_68qsl6zcqxrq-0.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-0 0}.lst-kix_6fc6u2jowkph-0>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-0}ol.lst-kix_3vftmdlxcpj0-0.start{counter-reset:lst-ctn-kix_3vftmdlxcpj0-0 0}ol.lst-kix_pzmtiq5h0915-4.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-4 0}ol.lst-kix_svmmnj1snhr2-1.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-1 0}.lst-kix_8irgp2z20781-7>li{counter-increment:lst-ctn-kix_8irgp2z20781-7}ol.lst-kix_68qsl6zcqxrq-7.start{counter-reset:lst-ctn-kix_68qsl6zcqxrq-7 0}.lst-kix_pkkwt0mfnd4r-3>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-3}.lst-kix_svmmnj1snhr2-7>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-7}.lst-kix_5zdork13zaj5-0>li{counter-increment:lst-ctn-kix_5zdork13zaj5-0}.lst-kix_5zdork13zaj5-8>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-8,lower-roman) ". "}ol.lst-kix_5zdork13zaj5-5.start{counter-reset:lst-ctn-kix_5zdork13zaj5-5 0}.lst-kix_5zdork13zaj5-2>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-2,lower-roman) ". "}.lst-kix_svmmnj1snhr2-0>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-0,decimal) ". "}.lst-kix_svmmnj1snhr2-1>li:before{content:"" counter(lst-ctn-kix_svmmnj1snhr2-1,lower-latin) ". "}.lst-kix_5zdork13zaj5-3>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-3,decimal) ". "}.lst-kix_6jgx19e9u9pe-0>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-0}.lst-kix_6jgx19e9u9pe-3>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-3}.lst-kix_5zdork13zaj5-4>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-4,lower-latin) ". "}.lst-kix_6v7qjvftgbe8-0>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-0}.lst-kix_5zdork13zaj5-5>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-5,lower-roman) ". "}.lst-kix_5zdork13zaj5-7>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-7,lower-latin) ". "}.lst-kix_pzmtiq5h0915-7>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-7}.lst-kix_5zdork13zaj5-6>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-6,decimal) ". "}ol.lst-kix_pzmtiq5h0915-7{list-style-type:none}.lst-kix_6jgx19e9u9pe-2>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-3>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-3}ol.lst-kix_pzmtiq5h0915-6{list-style-type:none}ol.lst-kix_pzmtiq5h0915-8{list-style-type:none}.lst-kix_jwv9q4tqofnu-2>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-2}.lst-kix_5zdork13zaj5-7>li{counter-increment:lst-ctn-kix_5zdork13zaj5-7}.lst-kix_6jgx19e9u9pe-6>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-6,decimal) ". "}ol.lst-kix_pzmtiq5h0915-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-8.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-8 0}ol.lst-kix_pzmtiq5h0915-0{list-style-type:none}ol.lst-kix_pzmtiq5h0915-3{list-style-type:none}.lst-kix_6jgx19e9u9pe-0>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-0,decimal) ". "}ol.lst-kix_xygzk5z3cyvz-1.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-1 0}ol.lst-kix_pzmtiq5h0915-2{list-style-type:none}.lst-kix_6jgx19e9u9pe-8>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-8,lower-roman) ". "}ol.lst-kix_pzmtiq5h0915-5{list-style-type:none}ol.lst-kix_pzmtiq5h0915-4{list-style-type:none}ul.lst-kix_ewcld7rry2cw-7{list-style-type:none}.lst-kix_8irgp2z20781-4>li{counter-increment:lst-ctn-kix_8irgp2z20781-4}ul.lst-kix_ewcld7rry2cw-6{list-style-type:none}.lst-kix_5zdork13zaj5-8>li{counter-increment:lst-ctn-kix_5zdork13zaj5-8}ul.lst-kix_ewcld7rry2cw-8{list-style-type:none}.lst-kix_5zdork13zaj5-1>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-1,lower-latin) ". "}.lst-kix_pkkwt0mfnd4r-6>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-6}.lst-kix_xcsisnkihklz-5>li:before{content:"\0025a0  "}.lst-kix_xcsisnkihklz-7>li:before{content:"\0025cb  "}.lst-kix_6jgx19e9u9pe-4>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-4,lower-latin) ". "}.lst-kix_xygzk5z3cyvz-8>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-8}.lst-kix_pkkwt0mfnd4r-8>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-8,lower-roman) ". "}ul.lst-kix_ewcld7rry2cw-1{list-style-type:none}ul.lst-kix_ewcld7rry2cw-0{list-style-type:none}ul.lst-kix_ewcld7rry2cw-3{list-style-type:none}ul.lst-kix_ewcld7rry2cw-2{list-style-type:none}ul.lst-kix_ewcld7rry2cw-5{list-style-type:none}ul.lst-kix_ewcld7rry2cw-4{list-style-type:none}.lst-kix_68qsl6zcqxrq-6>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-6}.lst-kix_pzmtiq5h0915-0>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-0}.lst-kix_7fhxg8i5msmt-2>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-2}.lst-kix_3vftmdlxcpj0-5>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-5}ol.lst-kix_svmmnj1snhr2-2{list-style-type:none}.lst-kix_6v7qjvftgbe8-6>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-6,decimal) ". "}ol.lst-kix_svmmnj1snhr2-3{list-style-type:none}ol.lst-kix_svmmnj1snhr2-0{list-style-type:none}ol.lst-kix_svmmnj1snhr2-1{list-style-type:none}.lst-kix_6v7qjvftgbe8-4>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-4,lower-latin) ". "}ol.lst-kix_6v7qjvftgbe8-6.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-6 0}.lst-kix_l0zuj3yh3ryb-8>li:before{content:"\0025a0  "}.lst-kix_pkkwt0mfnd4r-0>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-0,decimal) ". "}.lst-kix_svmmnj1snhr2-0>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-0}ol.lst-kix_svmmnj1snhr2-8{list-style-type:none}ol.lst-kix_svmmnj1snhr2-6{list-style-type:none}.lst-kix_svmmnj1snhr2-6>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-6}ul.lst-kix_xcsisnkihklz-7{list-style-type:none}.lst-kix_pkkwt0mfnd4r-2>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-2,lower-roman) ". "}ol.lst-kix_svmmnj1snhr2-7{list-style-type:none}ul.lst-kix_xcsisnkihklz-6{list-style-type:none}ol.lst-kix_6fc6u2jowkph-8.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-8 0}ol.lst-kix_svmmnj1snhr2-4{list-style-type:none}ol.lst-kix_svmmnj1snhr2-5{list-style-type:none}ul.lst-kix_xcsisnkihklz-8{list-style-type:none}.lst-kix_6v7qjvftgbe8-7>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-7}.lst-kix_l0zuj3yh3ryb-4>li:before{content:"\0025cb  "}ul.lst-kix_xcsisnkihklz-3{list-style-type:none}.lst-kix_pkkwt0mfnd4r-4>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-4,lower-latin) ". "}ul.lst-kix_xcsisnkihklz-2{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-4.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-4 0}ul.lst-kix_xcsisnkihklz-5{list-style-type:none}.lst-kix_w5k728jy05vp-5>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-5,lower-roman) ". "}.lst-kix_w5k728jy05vp-7>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-7,lower-latin) ". "}ul.lst-kix_xcsisnkihklz-4{list-style-type:none}.lst-kix_6v7qjvftgbe8-0>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-0,decimal) ". "}ol.lst-kix_pzmtiq5h0915-1.start{counter-reset:lst-ctn-kix_pzmtiq5h0915-1 0}ul.lst-kix_xcsisnkihklz-1{list-style-type:none}ul.lst-kix_xcsisnkihklz-0{list-style-type:none}.lst-kix_6v7qjvftgbe8-2>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-2,lower-roman) ". "}.lst-kix_pkkwt0mfnd4r-6>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-6,decimal) ". "}.lst-kix_l0zuj3yh3ryb-6>li:before{content:"\0025cf  "}.lst-kix_hii6fafh6hm-5>li:before{content:"\0025a0  "}ol.lst-kix_pkkwt0mfnd4r-2.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-2 0}ol.lst-kix_5zdork13zaj5-2.start{counter-reset:lst-ctn-kix_5zdork13zaj5-2 0}.lst-kix_hii6fafh6hm-3>li:before{content:"\0025cf  "}.lst-kix_xygzk5z3cyvz-7>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-7}.lst-kix_hii6fafh6hm-1>li:before{content:"\0025cb  "}.lst-kix_w5k728jy05vp-4>li{counter-increment:lst-ctn-kix_w5k728jy05vp-4}.lst-kix_jwv9q4tqofnu-3>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-3}.lst-kix_xygzk5z3cyvz-1>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-1}.lst-kix_l0zuj3yh3ryb-2>li:before{content:"\0025a0  "}.lst-kix_l0zuj3yh3ryb-0>li:before{content:"\0025cf  "}.lst-kix_6fc6u2jowkph-4>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-4}ol.lst-kix_8irgp2z20781-8.start{counter-reset:lst-ctn-kix_8irgp2z20781-8 0}ol.lst-kix_7fhxg8i5msmt-0.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-0 0}.lst-kix_jwv9q4tqofnu-3>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-3,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-8{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-7{list-style-type:none}.lst-kix_jwv9q4tqofnu-1>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-1,lower-latin) ". "}.lst-kix_jwv9q4tqofnu-0>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-0,decimal) ". "}.lst-kix_jwv9q4tqofnu-4>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-4,lower-latin) ". "}ul.lst-kix_l0zuj3yh3ryb-0{list-style-type:none}ul.lst-kix_l0zuj3yh3ryb-1{list-style-type:none}.lst-kix_jwv9q4tqofnu-7>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-7,lower-latin) ". "}ol.lst-kix_7fhxg8i5msmt-0{list-style-type:none}.lst-kix_3vftmdlxcpj0-0>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-0,decimal) ". "}ol.lst-kix_7fhxg8i5msmt-1{list-style-type:none}.lst-kix_6fc6u2jowkph-2>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-2,lower-roman) ". "}ol.lst-kix_7fhxg8i5msmt-4{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-5{list-style-type:none}.lst-kix_6fc6u2jowkph-1>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-1,lower-latin) ". "}ol.lst-kix_7fhxg8i5msmt-2{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-3{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-4.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-4 0}.lst-kix_pkkwt0mfnd4r-0>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-0}ol.lst-kix_pkkwt0mfnd4r-5.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-5 0}.lst-kix_jwv9q4tqofnu-8>li:before{content:"" counter(lst-ctn-kix_jwv9q4tqofnu-8,lower-roman) ". "}.lst-kix_xygzk5z3cyvz-1>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-1,lower-latin) ". "}ol.lst-kix_xygzk5z3cyvz-2.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-2 0}.lst-kix_6fc6u2jowkph-6>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-6,decimal) ". "}.lst-kix_xygzk5z3cyvz-2>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-2,lower-roman) ". "}.lst-kix_6fc6u2jowkph-5>li:before{content:"" counter(lst-ctn-kix_6fc6u2jowkph-5,lower-roman) ". "}ol.lst-kix_svmmnj1snhr2-3.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-3 0}.lst-kix_xygzk5z3cyvz-5>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-5,lower-roman) ". "}.lst-kix_wchaiekwhio-0>li:before{content:"\0025cf  "}.lst-kix_hii6fafh6hm-7>li:before{content:"\0025cb  "}.lst-kix_wchaiekwhio-1>li:before{content:"\0025cb  "}.lst-kix_wchaiekwhio-5>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-0.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-0 0}.lst-kix_hii6fafh6hm-8>li:before{content:"\0025a0  "}.lst-kix_xygzk5z3cyvz-6>li:before{content:"" counter(lst-ctn-kix_xygzk5z3cyvz-6,decimal) ". "}ol.lst-kix_6fc6u2jowkph-6.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-6 0}ul.lst-kix_l0zuj3yh3ryb-2{list-style-type:none}.lst-kix_7fhxg8i5msmt-8>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-8}ul.lst-kix_l0zuj3yh3ryb-3{list-style-type:none}.lst-kix_6v7qjvftgbe8-8>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-8,lower-roman) ". "}ul.lst-kix_l0zuj3yh3ryb-4{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-8.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-8 0}ul.lst-kix_l0zuj3yh3ryb-5{list-style-type:none}.lst-kix_wchaiekwhio-4>li:before{content:"\0025cb  "}ul.lst-kix_l0zuj3yh3ryb-6{list-style-type:none}ol.lst-kix_7fhxg8i5msmt-5.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-5 0}ul.lst-kix_l0zuj3yh3ryb-7{list-style-type:none}ul.lst-kix_l0zuj3yh3ryb-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-8{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-6{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-7{list-style-type:none}ol.lst-kix_svmmnj1snhr2-8.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-8 0}ol.lst-kix_68qsl6zcqxrq-4{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-5{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-2{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-3{list-style-type:none}ol.lst-kix_6jgx19e9u9pe-0.start{counter-reset:lst-ctn-kix_6jgx19e9u9pe-0 0}.lst-kix_pkkwt0mfnd4r-4>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-4}ol.lst-kix_68qsl6zcqxrq-0{list-style-type:none}ol.lst-kix_68qsl6zcqxrq-1{list-style-type:none}ol.lst-kix_6v7qjvftgbe8-3.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-3 0}.lst-kix_7fhxg8i5msmt-1>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-1}.lst-kix_w5k728jy05vp-3>li{counter-increment:lst-ctn-kix_w5k728jy05vp-3}.lst-kix_pzmtiq5h0915-1>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-1,lower-latin) ". "}.lst-kix_wchaiekwhio-8>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-5.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-5 0}.lst-kix_3vftmdlxcpj0-4>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-4}.lst-kix_pzmtiq5h0915-2>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-2,lower-roman) ". "}.lst-kix_8irgp2z20781-1>li{counter-increment:lst-ctn-kix_8irgp2z20781-1}.lst-kix_5zdork13zaj5-3>li{counter-increment:lst-ctn-kix_5zdork13zaj5-3}.lst-kix_pzmtiq5h0915-6>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-6,decimal) ". "}ol.lst-kix_pkkwt0mfnd4r-4.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-4 0}.lst-kix_pzmtiq5h0915-5>li:before{content:"" counter(lst-ctn-kix_pzmtiq5h0915-5,lower-roman) ". "}ul.lst-kix_d8lzxbbe1553-4{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-1{list-style-type:none}ul.lst-kix_d8lzxbbe1553-5{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-0{list-style-type:none}.lst-kix_6jgx19e9u9pe-6>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-6}.lst-kix_xcsisnkihklz-2>li:before{content:"\0025a0  "}.lst-kix_xcsisnkihklz-3>li:before{content:"\0025cf  "}ul.lst-kix_d8lzxbbe1553-6{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-3{list-style-type:none}ul.lst-kix_d8lzxbbe1553-7{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-2{list-style-type:none}ul.lst-kix_d8lzxbbe1553-0{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-5{list-style-type:none}ul.lst-kix_d8lzxbbe1553-1{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-4{list-style-type:none}ul.lst-kix_d8lzxbbe1553-2{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-7{list-style-type:none}ul.lst-kix_d8lzxbbe1553-3{list-style-type:none}ol.lst-kix_3vftmdlxcpj0-6{list-style-type:none}.lst-kix_pzmtiq5h0915-4>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-4}ol.lst-kix_3vftmdlxcpj0-8{list-style-type:none}.lst-kix_6v7qjvftgbe8-6>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-6}ul.lst-kix_d8lzxbbe1553-8{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-3.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-3 0}.lst-kix_wz4xrdza29b-5>li:before{content:"\0025a0  "}.lst-kix_pzmtiq5h0915-2>li{counter-increment:lst-ctn-kix_pzmtiq5h0915-2}.lst-kix_tb82mrxazni-6>li:before{content:"\0025cf  "}.lst-kix_6jgx19e9u9pe-3>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-3,decimal) ". "}.lst-kix_pkkwt0mfnd4r-7>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-7}.lst-kix_tb82mrxazni-2>li:before{content:"\0025a0  "}.lst-kix_6jgx19e9u9pe-7>li:before{content:"" counter(lst-ctn-kix_6jgx19e9u9pe-7,lower-latin) ". "}.lst-kix_hxgng6in8mo4-2>li:before{content:"\0025a0  "}.lst-kix_6v7qjvftgbe8-4>li{counter-increment:lst-ctn-kix_6v7qjvftgbe8-4}.lst-kix_jwv9q4tqofnu-1>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-1}.lst-kix_5zdork13zaj5-0>li:before{content:"" counter(lst-ctn-kix_5zdork13zaj5-0,decimal) ". "}.lst-kix_xcsisnkihklz-6>li:before{content:"\0025cf  "}ol.lst-kix_7fhxg8i5msmt-4.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-4 0}.lst-kix_ewcld7rry2cw-2>li:before{content:"\0025a0  "}ol.lst-kix_6fc6u2jowkph-2.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-2 0}ol.lst-kix_svmmnj1snhr2-2.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-2 0}ol.lst-kix_6v7qjvftgbe8-2.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-2 0}ol.lst-kix_xygzk5z3cyvz-4.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-4 0}.lst-kix_svmmnj1snhr2-8>li{counter-increment:lst-ctn-kix_svmmnj1snhr2-8}.lst-kix_6fc6u2jowkph-2>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-2}.lst-kix_ewcld7rry2cw-6>li:before{content:"\0025cf  "}ol.lst-kix_svmmnj1snhr2-5.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-5 0}.lst-kix_68qsl6zcqxrq-3>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-3}ol.lst-kix_pkkwt0mfnd4r-6.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-6 0}.lst-kix_wz4xrdza29b-1>li:before{content:"\0025cb  "}.lst-kix_8irgp2z20781-3>li{counter-increment:lst-ctn-kix_8irgp2z20781-3}.lst-kix_hxgng6in8mo4-6>li:before{content:"\0025cf  "}.lst-kix_6v7qjvftgbe8-5>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-5,lower-roman) ". "}ol.lst-kix_6fc6u2jowkph-1.start{counter-reset:lst-ctn-kix_6fc6u2jowkph-1 0}.lst-kix_8irgp2z20781-3>li:before{content:"(" counter(lst-ctn-kix_8irgp2z20781-3,decimal) ") "}.lst-kix_6jgx19e9u9pe-4>li{counter-increment:lst-ctn-kix_6jgx19e9u9pe-4}.lst-kix_8irgp2z20781-7>li:before{content:"" counter(lst-ctn-kix_8irgp2z20781-7,lower-latin) ". "}.lst-kix_36fxx9lqc91n-4>li:before{content:"\0025cb  "}.lst-kix_pkkwt0mfnd4r-3>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-3,decimal) ". "}.lst-kix_5zdork13zaj5-5>li{counter-increment:lst-ctn-kix_5zdork13zaj5-5}ol.lst-kix_xygzk5z3cyvz-7.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-7 0}ol.lst-kix_7fhxg8i5msmt-6.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-6 0}.lst-kix_l0zuj3yh3ryb-5>li:before{content:"\0025a0  "}.lst-kix_w5k728jy05vp-6>li:before{content:"" counter(lst-ctn-kix_w5k728jy05vp-6,decimal) ". "}.lst-kix_6v7qjvftgbe8-1>li:before{content:"" counter(lst-ctn-kix_6v7qjvftgbe8-1,lower-latin) ". "}.lst-kix_pkkwt0mfnd4r-7>li:before{content:"" counter(lst-ctn-kix_pkkwt0mfnd4r-7,lower-latin) ". "}ol.lst-kix_pkkwt0mfnd4r-7.start{counter-reset:lst-ctn-kix_pkkwt0mfnd4r-7 0}.lst-kix_36fxx9lqc91n-8>li:before{content:"\0025a0  "}.lst-kix_hii6fafh6hm-4>li:before{content:"\0025cb  "}.lst-kix_pkkwt0mfnd4r-2>li{counter-increment:lst-ctn-kix_pkkwt0mfnd4r-2}.lst-kix_68qsl6zcqxrq-8>li{counter-increment:lst-ctn-kix_68qsl6zcqxrq-8}ol.lst-kix_6v7qjvftgbe8-0.start{counter-reset:lst-ctn-kix_6v7qjvftgbe8-0 0}.lst-kix_jwv9q4tqofnu-6>li{counter-increment:lst-ctn-kix_jwv9q4tqofnu-6}.lst-kix_8irgp2z20781-8>li{counter-increment:lst-ctn-kix_8irgp2z20781-8}.lst-kix_3vftmdlxcpj0-8>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-8,lower-roman) ". "}ol.lst-kix_7fhxg8i5msmt-7.start{counter-reset:lst-ctn-kix_7fhxg8i5msmt-7 0}.lst-kix_l0zuj3yh3ryb-1>li:before{content:"\0025cb  "}.lst-kix_hii6fafh6hm-0>li:before{content:"\0025cf  "}.lst-kix_7fhxg8i5msmt-6>li{counter-increment:lst-ctn-kix_7fhxg8i5msmt-6}.lst-kix_xygzk5z3cyvz-4>li{counter-increment:lst-ctn-kix_xygzk5z3cyvz-4}.lst-kix_3vftmdlxcpj0-4>li:before{content:"" counter(lst-ctn-kix_3vftmdlxcpj0-4,lower-latin) ". "}ul.lst-kix_ozkivkncyqrh-0{list-style-type:none}ul.lst-kix_ozkivkncyqrh-1{list-style-type:none}ul.lst-kix_ozkivkncyqrh-2{list-style-type:none}ul.lst-kix_ozkivkncyqrh-3{list-style-type:none}ul.lst-kix_ozkivkncyqrh-4{list-style-type:none}ol.lst-kix_xygzk5z3cyvz-6.start{counter-reset:lst-ctn-kix_xygzk5z3cyvz-6 0}.lst-kix_d8lzxbbe1553-3>li:before{content:"\0025cf  "}.lst-kix_d8lzxbbe1553-7>li:before{content:"\0025cb  "}ul.lst-kix_ozkivkncyqrh-5{list-style-type:none}.lst-kix_6fc6u2jowkph-7>li{counter-increment:lst-ctn-kix_6fc6u2jowkph-7}ul.lst-kix_ozkivkncyqrh-6{list-style-type:none}ol.lst-kix_svmmnj1snhr2-4.start{counter-reset:lst-ctn-kix_svmmnj1snhr2-4 0}ul.lst-kix_ozkivkncyqrh-7{list-style-type:none}ul.lst-kix_ozkivkncyqrh-8{list-style-type:none}.lst-kix_w5k728jy05vp-1>li{counter-increment:lst-ctn-kix_w5k728jy05vp-1}.lst-kix_3vftmdlxcpj0-2>li{counter-increment:lst-ctn-kix_3vftmdlxcpj0-2}ol{margin:0;padding:0}table td,table th{padding:0}.c11{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;background-color:#d9d9d9;border-left-style:solid;border-bottom-width:1pt;width:93.6pt;border-top-color:#000000;border-bottom-style:solid}.c14{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:280.8pt;border-top-color:#000000;border-bottom-style:solid}.c5{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:57.8pt;border-top-color:#000000;border-bottom-style:solid}.c10{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:183.8pt;border-top-color:#000000;border-bottom-style:solid}.c17{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:93.6pt;border-top-color:#000000;border-bottom-style:solid}.c28{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:468pt;border-top-color:#000000;border-bottom-style:solid}.c19{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:109.5pt;border-top-color:#000000;border-bottom-style:solid}.c22{border-right-style:solid;padding:5pt 5pt 5pt 5pt;border-bottom-color:#000000;border-top-width:1pt;border-right-width:1pt;border-left-color:#000000;vertical-align:top;border-right-color:#000000;border-left-width:1pt;border-top-style:solid;border-left-style:solid;border-bottom-width:1pt;width:117pt;border-top-color:#000000;border-bottom-style:solid}.c7{-webkit-text-decoration-skip:none;color:#1155cc;font-weight:400;text-decoration:underline;vertical-align:baseline;text-decoration-skip-ink:none;font-size:11pt;font-family:"Arial";font-style:normal}.c9{margin-left:36pt;padding-top:0pt;padding-left:0pt;padding-bottom:0pt;line-height:1.15;orphans:2;widows:2;text-align:left}.c29{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:20pt;font-family:"Arial";font-style:normal}.c34{margin-left:18pt;padding-top:3pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c21{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:16pt;font-family:"Arial";font-style:normal}.c18{padding-top:20pt;padding-bottom:6pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.c1{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Courier New";font-style:normal}.c8{color:#333333;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:10pt;font-family:"Consolas";font-style:normal}.c32{padding-top:18pt;padding-bottom:6pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.c0{color:#000000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Arial";font-style:normal}.c38{color:#ff0000;font-weight:400;text-decoration:none;vertical-align:baseline;font-size:26pt;font-family:"Arial";font-style:normal}.c39{padding-top:0pt;padding-bottom:3pt;line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:center}.c12{padding-top:0pt;padding-bottom:0pt;line-height:1.15;orphans:2;widows:2;text-align:left}.c26{color:#000000;text-decoration:none;vertical-align:baseline;font-size:11pt;font-family:"Arial";font-style:normal}.c20{padding-top:0pt;padding-bottom:0pt;line-height:1.42857;orphans:2;widows:2;text-align:left}.c40{padding-top:4pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c30{padding-top:10pt;padding-bottom:0pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c33{padding-top:10pt;padding-bottom:4pt;line-height:1.0;orphans:2;widows:2;text-align:left}.c37{font-size:10pt;font-family:"Consolas";color:#333333;font-weight:400}.c24{text-decoration-skip-ink:none;-webkit-text-decoration-skip:none;color:#1155cc;text-decoration:underline}.c6{padding-top:0pt;padding-bottom:0pt;line-height:1.0;text-align:left}.c36{border-spacing:0;border-collapse:collapse;margin-right:auto}.c27{background-color:#ffffff;max-width:468pt;padding:72pt 72pt 72pt 72pt}.c2{padding:0;margin:0}.c25{color:inherit;text-decoration:inherit}.c16{margin-left:72pt;padding-left:0pt}.c31{font-style:italic}.c35{height:21pt}.c15{margin-left:36pt}.c23{padding-left:0pt}.c4{height:0pt}.c3{font-weight:700}.c13{height:11pt}.title{padding-top:0pt;color:#000000;font-size:26pt;padding-bottom:3pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}.subtitle{padding-top:0pt;color:#666666;font-size:15pt;padding-bottom:16pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}li{color:#000000;font-size:11pt;font-family:"Arial"}p{margin:0;color:#000000;font-size:11pt;font-family:"Arial"}h1{padding-top:20pt;color:#000000;font-size:20pt;padding-bottom:6pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h2{padding-top:18pt;color:#000000;font-size:16pt;padding-bottom:6pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h3{padding-top:16pt;color:#434343;font-size:14pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h4{padding-top:14pt;color:#666666;font-size:12pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h5{padding-top:12pt;color:#666666;font-size:11pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;orphans:2;widows:2;text-align:left}h6{padding-top:12pt;color:#666666;font-size:11pt;padding-bottom:4pt;font-family:"Arial";line-height:1.15;page-break-after:avoid;font-style:italic;orphans:2;widows:2;text-align:left}</style></head><body class="c27"><p class="c39 title" id="h.hlpacpauqwkx"><span>Prebid</span><span>&nbsp;Support for Enforcing TCF 2.0</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c40"><span class="c7"><a class="c25" href="#h.x9c0lsi8ay8">Overview</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.tldmebv0bdgp">Definitions</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.8ycuibmrgs9x">Assumptions</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.1pnyovoljlrm">Summary of Prebid TCF 2.0 Enforcement</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.3kby792a2sqy">Basic-vs-Full Enforcement</a></span></p><p class="c34"><span class="c7"><a class="c25" href="#h.83ablyvhjp4o">Basic Enforcement</a></span></p><p class="c34"><span class="c7"><a class="c25" href="#h.8cgpj780kmcq">Full Enforcement (Prebid Server Only)</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.t62kkttx488d">Prebid.js Functional Requirements</a></span></p><p class="c30"><span class="c7"><a class="c25" href="#h.wjk7zfwgo1a2">Prebid SDK Functional Requirements</a></span></p><p class="c33"><span class="c7"><a class="c25" href="#h.o5pjp8p4qy06">Prebid Server Functional Requirements</a></span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.x9c0lsi8ay8"><span class="c29">Overview</span></h1><p class="c12"><span class="c0">The IAB&#39;s Transparency and Consent Framework version 2.0 for enhanced support of GDPR is scheduled to take effect Apr 1 2020. It&#39;s a major update from TCF 1.1 which Prebid currently supports, and is not compatible with the previous release.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The key changes are:</span></p><ul class="c2 lst-kix_wchaiekwhio-0 start"><li class="c9"><span class="c0">More &#39;purposes&#39; are defined.</span></li><li class="c9"><span class="c0">More flexibility for the legal bases used by vendors.</span></li><li class="c9"><span class="c0">Different in-page javascript API</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">References</span></p><ul class="c2 lst-kix_wz4xrdza29b-0 start"><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://iabeurope.eu/tcf-2-0/&amp;sa=D&amp;ust=1584107233971000">IAB Europe&#39;s TCF 2.0 Homepage</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://iabeurope.eu/tcfdocuments/documents/legal/tcfpolicyFINALv2.pdf&amp;sa=D&amp;ust=1584107233971000">TCF Policy</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%2520Tech%2520Lab%2520-%2520Consent%2520string%2520and%2520vendor%2520list%2520formats%2520v2.md&amp;sa=D&amp;ust=1584107233971000">TCF 2.0 Consent String Format</a></span></li><li class="c9"><span class="c24"><a class="c25" href="https://www.google.com/url?q=https://github.com/rubicon-project/prebid-server-java/blob/master/docs/developers/PrebidServerJava_GDPR_Requirements.pdf&amp;sa=D&amp;ust=1584107233972000">GDPR Requirements for Prebid Server (TCF1.1)</a></span></li></ul><h1 class="c18" id="h.tldmebv0bdgp"><span class="c29">Definitions</span></h1><ul class="c2 lst-kix_xcsisnkihklz-0 start"><li class="c9"><span class="c0">GDPR - General Data Protection Regulation. The EU&#39;s privacy regulations.</span></li><li class="c9"><span class="c0">EEA - European Economic Area. The region where the GDPR is in effect.</span></li><li class="c9"><span class="c0">IAB - Interactive Advertising Bureau. The ad industry consortium that developed the TCF as a way to help the ad ecosystem adhere to GDPR rules.</span></li><li class="c9"><span class="c0">TCF - Transparency and Consent Framework. </span></li><li class="c9"><span class="c0">CMP - Consent Management Platform. The user interface part of the TCF.</span></li><li class="c9"><span class="c0">GVL - Global Vendors List. The place where each ad entity registers what they do with user data.</span></li><li class="c9"><span class="c0">PBS - Prebid Server</span></li><li class="c9"><span class="c0">PBJS - Prebid.js</span></li><li class="c9"><span class="c0">PBS Host Company - the organization running a cluster of Prebid Servers</span></li><li class="c9"><span class="c0">Purpose 1 - &nbsp;Under TCF, there are many defined uses of private data. &quot;Purpose 1&quot; is &quot;Store and/or access information on a device&quot;. This means that users must consent before an ad tech vendor reads or writes data from their computer or phone. Those of us dealing with these things a lot memorize the numbers. Forgive us.</span></li><li class="c9"><span>Purpose 2 - &quot;Basic Ad Selection&quot;. </span><span class="c0">This looks to be one of the bigger areas of concern because the TCF policy could be interpreted to be a form of ad blocking. Or maybe not. Talk to your lawyers.</span></li><li class="c9"><span class="c0">Purpose 4 - &quot;Personalized Ad Selection&quot;. Basically, if the user doesn&rsquo;t consent, they don&rsquo;t want ads based on any type of direct user profile.</span></li><li class="c9"><span class="c0">Purpose 7 - &quot;Measure ad performance&quot;. This is another area of concern, because the TCF policy doesn&rsquo;t clearly define what it means to measure the &ldquo;effectiveness&rdquo; of ads. Talk to your lawyers about what this means for your organization.</span></li><li class="c9"><span class="c0">Special Feature 1 - &quot;Use precise geolocation data&quot;. Special Features are quite different than Purposes. They only allow user &quot;opt-in&quot;, and don&#39;t have as many layers of nuance as Purposes.</span></li><li class="c9"><span class="c0">Legal Basis - how an ad tech vendor views the importance of each Purpose for their mission. If they define &quot;consent&quot; as their &quot;basis&quot; for a given Purpose, they&#39;re able to work without some or all aspects of the user&#39;s data. But if they define &quot;Legitimate Interest&quot; (LI), they&#39;re basically saying &quot;We can&#39;t do our job without this data&quot;.</span></li><li class="c9"><span class="c0">Basic enforcement - a high-level mode of consent confirmation where the looks for a good-faith indication that the user has provided consent or legal basis signals before engaging in a privacy-protected activity. Does not read the GVL.</span></li><li class="c9"><span class="c0">Full enforcement - a detailed confirmation mode that reads the GVL, interprets the consent string, and performs legal basis analysis.</span></li></ul><h1 class="c18" id="h.8ycuibmrgs9x"><span class="c29">Assumptions</span></h1><p class="c12 c13"><span class="c0"></span></p><a id="t.e67b00b9c01ec82c8517d66b7ccbe4a7c7e6445b"></a><a id="t.0"></a><table class="c36"><tbody><tr class="c4"><td class="c28" colspan="1" rowspan="1"><p class="c6"><span class="c3">Important Legal Note</span><span class="c0">: Prebid.org cannot provide legal advice about GDPR or any other governmental regulation. Our aim is to provide a toolkit of functionality that will let publishers configure header bidding as defined by their legal counsel. We will consider feature suggestions, and review any code offered by the community.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">Enforcement of Purpose 2 (basic ad selection) looks to be one of the bigger areas of concern because the TCF policy could be interpreted to be a form of ad blocking. You will need to work with your legal counsel to determine how you intend to handle this scenario. Prebid.js and Prebid Server offer publishers the ability to enforce or not-enforce purposes individually. As an example of the kind of flexibility we aim to offer (*), here are some options you could discuss with your lawyers:</span></p><p class="c6 c13"><span class="c0"></span></p><ol class="c2 lst-kix_68qsl6zcqxrq-0 start" start="1"><li class="c6 c15 c23"><span class="c0">Treat Purpose 2 as an ad blocker.</span></li><li class="c6 c15 c23"><span class="c0">Ignore enforcement of selected Purposes at the Prebid level entirely, assuming that downstream vendors will handle the TCF strings appropriately. </span></li><li class="c6 c15 c23"><span class="c0">Ignore enforcement Purpose 2, assuming that users who object to &lsquo;Basic Ads&rsquo; will also object to &lsquo;Personalized Ads&rsquo;, causing any User IDs to be removed from ad requests.</span></li><li class="c6 c15 c23"><span class="c0">Ignore the Purpose-Consent portion of Purpose 2, but allow the user to block specific vendors.</span></li></ol><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c3">(*) - Note on phasing</span><span class="c0">: Please be aware that Prebid.js and Prebid Server will likely not deliver on the full TCF functionality by April 1st. Our initial goal for both products is to support Purpose 1 (Device Access) enforcement by that date. The ability to enforce the other purposes will be developed as soon as we can.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c3">(**)</span><span class="c0">&nbsp;Did we mention that you cannot rely on this document to learn how to configure your header bidding for GDPR? Seriously, talk to your lawyers.</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">General</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_svmmnj1snhr2-0 start" start="1"><li class="c9"><span class="c0">Prebid.org is neither a data controller nor data processor, but we supply software to both types of entities. Therefore, our software should provide a flexible set of controls necessary for both types of entities to run their businesses.</span></li><li class="c9"><span class="c0">Even if Prebid is configured to enforce activities by parsing consent data, publishers and downstream vendors are still responsible for ensuring their legal bases using the consent data they&#39;re provided. </span></li><li class="c9"><span class="c0">Prebid will ignore the TCF &quot;stack&quot; feature, assuming that the CMP will set the underlying Purposes appropriately.</span></li><li class="c9"><span class="c0">Data from the CMP will never be modified before passing to downstream entities.</span></li><li class="c9"><span class="c0">If TCF processing is turned on, and the user is determined to be in GDPR scope, and hasn&rsquo;t provided a consent string, the system should assume a consent string that has no consent offered.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid.js</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_6fc6u2jowkph-0 start" start="1"><li class="c9"><span class="c0">Prebid.js will only support parsing the TCF 2.0 consent string.</span></li><li class="c9"><span class="c0">TCF 2.0 features are available in Prebid.js only in a consent module, not as part of core. This allows publishers to build two versions of their wrappers: one for users in the EEA, one for users outside of the EEA.</span></li><li class="c9"><span class="c0">It&#39;s assumed that publishers run in two modes:</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-1 start" start="1"><li class="c12 c16"><span class="c0">A CMP is loaded on every page so TCF functions and data are fully available.</span></li><li class="c12 c16"><span class="c0">Consent data is stored in first party storage and passed to Prebid directly. TCF functions are not available from the CMP.</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-0" start="4"><li class="c9"><span class="c0">Prebid.js will not load the Global Vendors List (GVL) as this would significantly impact the success of header bidding implementations. However, Prebid.js will require a mapping of GVL vendor IDs to Prebid.js bidder codes. </span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-1 start" start="1"><li class="c12 c16"><span class="c0">Further, we assume that not all Prebid adapters will be in the GVL, so we&#39;ll need to support reference by GVL ID or bidder code.</span></li><li class="c12 c16"><span class="c0">Further, we assume that bidder aliases within one adapter may have different GVL IDs.</span></li></ol><ol class="c2 lst-kix_6fc6u2jowkph-0" start="5"><li class="c9"><span class="c0">As a result of not having access to GVL entries, Prebid.js will only support &lsquo;Basic Enforcement&rsquo;.</span></li><li class="c9"><span>TCF2 will be supported in Prebid.js 3.x, with &#39;no enforcement&#39; being the default option. Prebid.js 4.0 will enforce Purpose 1 by default when the module is included.</span></li><li class="c9"><span>PurposeOneTreatment is ignored</span><span class="c0">&nbsp;for Prebid.js. Publishers who don&rsquo;t want to enforce Purpose 1 (or any other purpose) need to set Prebid&rsquo;s configuration appropriately.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid Server</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_pkkwt0mfnd4r-0 start" start="1"><li class="c9"><span class="c0">Prebid Server will need concurrent support of TCF 1.1 and TCF 2.0.</span></li><li class="c9"><span class="c0">Prebid Server will need to support &ldquo;Full Enforcement&rdquo; checks.</span></li><li class="c9"><span class="c0">AMP TCF 2.0 will be passed on the same parameter as TCF 1.1. </span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Prebid SDK</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_xygzk5z3cyvz-0 start" start="1"><li class="c9"><span class="c0">Prebid SDK should parse the consent string in order to read the IDFA. Other than that, SDK just passes consent values to Prebid Server..</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.1pnyovoljlrm"><span class="c29">Summary of Prebid TCF 2.0 Enforcement</span></h1><p class="c12 c13"><span class="c0"></span></p><a id="t.de6c946673ec683bd257d6a726fa40f4a547f1ee"></a><a id="t.1"></a><table class="c36"><tbody><tr class="c4"><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c3">TCF </span><span class="c26 c3">Field</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">In-scope Activities</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">System</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Enforcement</span></p></td><td class="c11" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Publisher/</span></p><p class="c6"><span class="c26 c3">Host Company Controls</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 1 - Store and/or access information on a device</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">usersync pixels, user ID modules, and device storage</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server and Prebid SDK</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in preventing one or more uesrsync activities for one or more vendors.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 1</span></p><p class="c6"><span class="c0">Do not enforce purpose 1 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 1 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 2 - Select basic ads</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">call bid adapters</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in skipping one or more bid adapters.</span></p><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">All configured modules will be called as usual unless all bidders are eliminated.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 2</span></p><p class="c6"><span>Do not enforce purpose 2 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 2 at the vendor level only.</span></p><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 4 - Select Personalized Ads</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">call bid adapters with userIds</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in removing the userIds before calling one or more bid adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 4</span></p><p class="c6"><span class="c0">Do not enforce purpose 4 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 4 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Purpose 7 - Measure ad performance</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">initiate analytics</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid.js and Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in skipping one or more analytics adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce purpose 7</span></p><p class="c6"><span class="c0">Do not enforce purpose 7 for vendor V</span></p><p class="c6"><span class="c0">Enforce purpose 7 at the vendor level only.</span></p></td></tr><tr class="c4"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Special Feature 1 - Use precise geolocation data</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">passing lat/long to server-side bid adapters</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Prebid Server</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">May result in rounding lat/long values and IP address before sending to server-side adapters.</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Do not enforce Special Feature 1</span></p></td></tr><tr class="c35"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">Special Purpose 2 - Technically deliver ads or content</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">n/a</span></p></td><td class="c14" colspan="3" rowspan="1"><p class="c6 c13"><span class="c0"></span></p><p class="c6"><span class="c0">Special Purposes do not require consent. If a publisher&rsquo;s legal team wants to consider SP2, Prebid software should not be called.</span></p></td></tr><tr class="c35"><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">PurposeOneConsent</span></p></td><td class="c17" colspan="1" rowspan="1"><p class="c6"><span class="c0">n/a</span></p></td><td class="c14" colspan="3" rowspan="1"><p class="c6"><span class="c0">Prebid does not provide specific support for enforcing this flag. Instead, publishers may use the provided controls for Purpose 1 and other Prebid configuration to control whether the user&rsquo;s device is accessed.</span></p></td></tr></tbody></table><h1 class="c18" id="h.3kby792a2sqy"><span class="c29">Basic-vs-Full Enforcement</span></h1><p class="c12"><span class="c0">Prebid offers publishers several controls for whether consent/legal basis confirmation is even performed. The following flowchart shows how the controls</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span style="overflow: hidden; display: inline-block; margin: 0.00px 0.00px; border: 0.00px solid #000000; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px); width: 634.15px; height: 335.15px;"><img alt="" src="images/image2.png" style="width: 634.15px; height: 335.15px; margin-left: 0.00px; margin-top: 0.00px; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px);" title=""></span></p><p class="c12 c13"><span class="c0"></span></p><h2 class="c32" id="h.83ablyvhjp4o"><span class="c21">Basic Enforcement</span></h2><p class="c12"><span class="c0">The goal of &#39;basic enforcement&#39; is to confirm that there&#39;s enough evidence of consent to pass data on to vendors who have access to the GVL and can fully parse and enforce.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing a Purpose for a given Vendor, one of these scenarios must be true: :</span></p><ul class="c2 lst-kix_hxgng6in8mo4-0 start"><li class="c9"><span class="c0">User&rsquo;s purpose consent and user&rsquo;s vendor consent</span></li><li class="c9"><span class="c0">The Prebid-specific &lsquo;enforceVendor&rsquo; flag is set and user&rsquo;s vendor consent</span></li><li class="c9"><span class="c0">purpose LI established and vendor LI established</span></li><li class="c9"><span class="c0">The Prebid-specific &lsquo;enforceVendor&rsquo; flag is set and vendor LI established</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">In terms of the TCF 2.0 fields, Purpose P is ok for vendor V if either of these is true:</span></p><ol class="c2 lst-kix_jwv9q4tqofnu-0 start" start="1"><li class="c9"><span class="c0">PurposesConsent[P,V]==1 AND VendorConsentBitfield[V]==1</span></li><li class="c9"><span class="c0">pbEnforceVendor[P]==true AND VendorConsentBitfield[V]==1</span></li><li class="c9"><span class="c0">PurposesLITransparency[P]==1 AND VendorLegitimateInterestBitfield[V]==1</span></li><li class="c9"><span class="c0">pbEnforceVendor[P,V]==true AND VendorLegitimateInterestBitfield[V]==1</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing Special Feature 1, SpecialFeatureOptIns[1] must be true.</span></p><h2 class="c32" id="h.8cgpj780kmcq"><span class="c21">Full Enforcement (Prebid Server Only)</span></h2><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The big difference between &#39;basic&#39; and &#39;full&#39; enforcement is that Prebid Server has the GVL available to examine vendor legal bases.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing an activity that falls under a specific Purpose for a given Vendor, one of these 6 basic scenarios needs to be true:</span></p><p class="c12 c13"><span class="c0"></span></p><ol class="c2 lst-kix_3vftmdlxcpj0-0 start" start="1"><li class="c9"><span class="c0">Vendor claims consent as their basis, publisher doesn&#39;t restrict the purpose, user consents to the purpose (if the enforcePurpose flag is on), and user consents to the vendor (if the enforceVendor flag is on).</span></li><li class="c9"><span class="c0">Vendor claims (inflexible) legitimate interest as their basis, publisher doesn&#39;t restrict the purpose, user was provided notice of the legitimate interest basis for this purpose (if the enforcePurpose flag is on), and user was provided notice for the LI basis for this vendor (if the enforceVendor flag is on)</span></li><li class="c9"><span>Vendor claims flexible legal basis with legitimate interest as the default, publisher restriction </span><span class="c3">doesn&#39;t</span><span>&nbsp;require consent, and ((user was provided notice of the legitimate interest basis for this purpose+vendor) </span><span>OR (user consents to purpose+vendor)) [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with legitimate interest as the default, publisher </span><span class="c3">does</span><span class="c0">&nbsp;require consent, user consents to the purpose, and user consents to the vendor. [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with consent as the default, publisher restriction </span><span class="c3">doesn&#39;t</span><span>&nbsp;require legitimate interest, ((user consents to the purpose+vendor) </span><span>OR (user was provided notice for the legitimate interest basis for this purpose+vendor)) </span><span>[Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on]</span></li><li class="c9"><span>Vendor claims flexible legal basis with consent as the default, publisher restriction </span><span class="c3">does</span><span class="c0">&nbsp;require legitimate interest, and user was provided notice for the legitimate interest basis for this purpose+vendor. [Purpose checked only if the enforcePurpose flag is on, and vendor checked only if the enforceVendor flag is on] </span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>Note that there are many more scenarios where the activity would </span><span class="c31">not</span><span class="c0">&nbsp;be allowed. </span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The technical definition in terms of the TCF 2.0 fields follows. Purpose P is ok for vendor V if any of these is true:</span></p><ol class="c2 lst-kix_6v7qjvftgbe8-0 start" start="1"><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes doesn&#39;t contain P and publisherRestrictions[P]!=0 and (!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes doesn&#39;t contain P and publisherRestrictions[P]!=0 and (!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==2 and (((!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)) OR ((!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)))</span></li><li class="c9"><span class="c0">GVL[V].legIntPurposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==1 and (!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)</span></li><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==1 and (((!enforcePurpose[P] or PurposesConsent[P]==1) AND (!enforceVendor[P,V] or VendorConsentBitfield[V]==1)) OR ((!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)))</span></li><li class="c9"><span class="c0">GVL[V].purposes contains P and GVL[V].flexiblePurposes contains P and publisherRestrictions[P]==2 and (!enforcePurpose[P] or PurposesLITransparency[P]==1) AND (!enforceVendor[P,V] or VendorLegitimateInterestBitfield[V]==1)</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Before allowing Special Feature 1, SpecialFeatureOptIns[1] must be true.</span></p><h1 class="c18" id="h.t62kkttx488d"><span class="c29">Prebid.js Functional Requirements</span></h1><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">1) An optional module must be available for reading the IAB TCF 2.0 API data. Publishers will include this module in their Prebid.js package when they need to support EEA users.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) Prebid.js must support scenarios where the TCF string parsing functions are not available. &nbsp;If the codebase for parsing the TCF string is significant, it should be made an optional module separate from the enforcement functions. A key goal of Prebid.js is to include only the code that publishers need for their particular use case. The technical design should consider whether it makes sense to bundle all of these components together, or break them into 2 or 3 separate modules:</span></p><ul class="c2 lst-kix_ewcld7rry2cw-0 start"><li class="c9"><span class="c0">Reading the TCF string</span></li><li class="c9"><span class="c0">Enforcing the TCF string</span></li><li class="c9"><span class="c0">Parsing the TCF string (?)</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) Prebid.js must support the following publisher controls:</span></p><ul class="c2 lst-kix_d8lzxbbe1553-0 start"><li class="c9"><span class="c0">Don&#39;t even read the TCF string (accomplished by not configuring the module)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P for vendor V</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Here&#39;s a set of proposed configurations within the existing consentManagement config object:</span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.d2f201df0390c3de46409e5bc5a638f6f58e1055"></a><a id="t.2"></a><table class="c36"><tbody><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Param</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c3 c26">Type</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Description</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c26 c3">Details</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.allowAuctionWithoutConsent</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Available in 3.x only, defines behavior for backwards compatibility. </span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span>For 3.x: If true, consider all Purposes as </span><span class="c31">not</span><span class="c0">&nbsp;enforceable.</span></p><p class="c6"><span class="c0">If false, consider only Purpose 2 enforceable.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.consentData</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">object</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Consent data provided statically.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Used when cmpApi is &quot;static&quot;.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.defaultGdprScope</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">object</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Lets the publisher override the defaults set by the enforceMode</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].purpose</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">string</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Possible values are &quot;storage&quot;, &quot;basicAds&quot;, &quot;personalizedAds&quot;, and &quot;measurement&quot; corresponding to Purposes 1,2,4, and 7 respectively.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">For some reason, people tend to prefer using the string names rather than the numbers.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].enforcePurpose</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Whether to enforce this purpose or not. Overrides the setting from enforceMode.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">The default in PBJS 3.x will be to enforce no purposes, and in 4.0 to enforce Purpose 1 and no others.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].enforceVendor</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">boolean</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Whether to enforce vendor consent/legal basis for this purpose or not..</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">The default in PBJS 3.x will be to enforce no purposes, and in 4.0 to enforce Purpose 1 and no others.</span></p></td></tr><tr class="c4"><td class="c10" colspan="1" rowspan="1"><p class="c6"><span class="c0">gdpr.rules[].vendorExceptions</span></p></td><td class="c5" colspan="1" rowspan="1"><p class="c6"><span class="c0">array of strings</span></p></td><td class="c19" colspan="1" rowspan="1"><p class="c6"><span class="c0">Which biddercodes or module names should be treated as the opposite of the enforceVendor flag.</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">If enforceVendor=false, then vendorExceptions are those that will be treated as true.</span></p><p class="c6"><span class="c0">If enforce=true, then vendorExceptions are those that will be treated as false.</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Example configurations:</span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.4cd6d00b2bd97ee52bb8fe7d3b16fd51a6657718"></a><a id="t.3"></a><table class="c36"><tbody><tr class="c4"><td class="c28" colspan="1" rowspan="1"><p class="c12"><span class="c1">pbjs.setConfig({</span></p><p class="c12"><span class="c1">&nbsp; consentManagement: {</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; gdpr: {</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; cmpApi: &#39;iab&#39;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; defaultGdprScope: true/false (0/1?)</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; timeout: 3000,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; // allowAuctionWithoutConsent: false, &nbsp;// deprecated</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; rules: [{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // don&rsquo;t enforce Purpose 1 except for bidderA.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // this means that TCF approval is only considered</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // for this one bidder.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;storage&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderA&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // Allow the user to object to vendors for Purpose 2</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // but don&rsquo;t allow them to turn off header bidding</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // altogether.</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // The exception is bidderB, which the user will</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // not be allowed to reject</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;basicAds&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: true,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderB&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // allow the user to have their userId removed from</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // header bidding except for bidders A and B</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;personalizedAds&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: true,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforceVendor: true</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; vendorExceptions: [&quot;bidderA&quot;,&quot;bidderB&quot;]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; },{</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; // analytics adapters are ok</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp;</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; purpose: &quot;measurement&quot;,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false,</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; &nbsp; enforcePurpose: false</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; &nbsp; }]</span></p><p class="c12"><span class="c1">&nbsp; &nbsp; }</span></p><p class="c12"><span class="c1">&nbsp; }</span></p><p class="c12"><span class="c1">});</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">You may notice that the examples above provide more flexibility than TCF requires. This allows publishers to establish custom legal bases in consultation with their legal counsel.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) If the &#39;gdprApplies&#39; flag is defined and is false, then Prebid.js may assume that GDPR is not in scope and therefore doesn&#39;t need to be enforced. All Purposes will be set to enforce=false.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) There should be a way for bidAdapters to supply a GVL ID for each alias they support.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">5) The aliasBidder() function should be extended to support specification of a GVL ID. e.g.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c20 c15"><span class="c37">pbjs.aliasBidder(&#39;msft&#39;, &#39;newAlias&#39;, 999);</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>6) If a bidder code isn&#39;t associated with a GVL ID, enforcement should assume that the vendor is </span><span class="c31">not allowed</span><span class="c0">&nbsp;unless the publisher has specifically named their bidder code.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">7) Analytics adapters must be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which analytics adapter(s) are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">8) User ID modules and Real Time Data modules should be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which modules are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">9) The system must be able to verify vendor consent in two ways:</span></p><ul class="c2 lst-kix_tb82mrxazni-0 start"><li class="c9"><span class="c0">User consents to GVL ID 52, and Prebid.js knows that 52 corresponds to the Rubicon bid adapter (and the Rubicon analytics adapter)</span></li></span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">10) The internal interface to bid adapters should remain the same: bidrequest.gdprConsent</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">11) The OpenRTB interface to Prebid Server should remain the same:</span></p><ul class="c2 lst-kix_u56eprq9ell0-0 start"><li class="c9"><span class="c0">regs.ext.gdpr </span></li><li class="c9"><span class="c0">user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">12) The system must support all the activity enforcement noted in the &#39;Summary of Prebid TCF 2.0 Enforcement&#39; section.</span></p><ol class="c2 lst-kix_7fhxg8i5msmt-0 start" start="1"><li class="c9"><span class="c0">If Purpose 1 is being enforced:</span></li></ol><ol class="c2 lst-kix_7fhxg8i5msmt-1 start" start="1"><li class="c12 c16"><span class="c0">Before invoking usersync pixels for each enforceable vendor, verify consent as described in &#39;Basic Enforcement&#39;.</span></li><li class="c12 c16"><span class="c0">Before reading or storing cookies or HTML 5 localstorage for each enforceable vendor, verify consent as described in &#39;Basic Enforcement&#39;. This will require enhancing the getCookie and setCookie utility functions to determine or accept the biddercode or module name.</span></li><li class="c12 c16"><span class="c0">Before invoking each enforceable userID sub-module, verify consent as described in &#39;Basic Enforcement&#39;.</span></li></ol><ol class="c2 lst-kix_7fhxg8i5msmt-0" start="2"><li class="c9"><span class="c0">If Purpose 2 is being enforced, verify consent for each vendor as described in &#39;Basic Enforcement&#39; before calling a bid adapter. If consent is not granted, log a console warning and skip it.</span></li><li class="c9"><span class="c0">If Purpose 4 is being enforced, verify consent for each vendor that passed the Purpose 2 test. If consent is not granted, log a console warning, remove the bidrequest.userId attribute and call the adapter.</span></li><li class="c9"><span class="c0">If Purpose 7 is being enforced, verify consent for each analytics module. If consent is not granted, log a console warning and skip it.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) If consentManagement.gdpr is configured but no consent string is available, the system must assume that the user does not consent to either purpose or vendor. Activities may still take place if the publisher has configured the relevant Purposes as &#39;not enforced&#39;.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) Bid adapters must do one of the following for all device access activities (reading or setting cookies or local storage):</span></p><ul class="c2 lst-kix_l0zuj3yh3ryb-0 start"><li class="c9"><span class="c0">Use the PBJS core utility functions, which will handle Purpose 1 enforcement.</span></li><li class="c9"><span class="c0">Post a public disclosure in the code and on prebid.org explaining the legal basis for not adhering to GDPR.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">14) Prebid core must make the following information available to analytics adapters:</span></p><ul class="c2 lst-kix_w6yj8blbe06x-0 start"><li class="c9"><span class="c0">Enforcement status of Purposes 1,2,4 and 7.</span></li><li class="c9"><span class="c0">An array of bidders and modules skipped due to TCF enforcement.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">15) It should be possible for a pub to define a mapping between a module code and a GVL ID</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">&nbsp; &nbsp;pbjs.setConfig({</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp;gvlMapping: {</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &ldquo;id5&rdquo;: 9999</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &ldquo;bidderX&rdquo;: 8888</span></p><p class="c12"><span class="c0">&nbsp; &nbsp; &nbsp;}</span></p><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.wjk7zfwgo1a2"><span>Prebid SDK Functional Requirements</span></h1><p class="c12"><span class="c0">1) Prebid SDK must accept the following optional parameters to support TCF 2.0. It&rsquo;s assumed the app will pass these values directly or indirectly from a mobile CMP.</span></p><ul class="c2 lst-kix_ozkivkncyqrh-0 start"><li class="c9"><span class="c0">GDPR in-scope</span></li><li class="c9"><span class="c0">TCF Consent string</span></li><li class="c9"><span>&lsquo;deviceAccessConsent&rsquo; flag defining whether the SDK is allowed to read the IDFA or equivalent. It&rsquo;s assumed that the app will parse the consent string to confirm the user has consented to Purpose 1.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) When a request is defined to be GDPR in-scope, the SDK must confirm that the &lsquo;deviceAccessConsent&rsquo; flag is true. Here&rsquo;s the truth table for when the SDK is allowed to access the device ID:</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><a id="t.cf04e882f648981d69d9d186d69ef24c3991b712"></a><a id="t.4"></a><table class="c36"><tbody><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6 c13"><span class="c0"></span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent=true</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent=false</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c12"><span class="c0">deviceAccessConsent undefined</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope=false</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope=true</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td></tr><tr class="c4"><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">GDPR scope undefined</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">No, don&rsquo;t read IDFA</span></p></td><td class="c22" colspan="1" rowspan="1"><p class="c6"><span class="c0">Yes, read IDFA</span></p></td></tr></tbody></table><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) The SDK must pass the consent data to Prebid Server on the same OpenRTB attributes as defined in TCF 1.1:</span></p><ul class="c2 lst-kix_hii6fafh6hm-0 start"><li class="c9"><span class="c0">GDPR in-scope flag is regs.ext.gdpr</span></li><li class="c9"><span class="c0">Consent string is user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><h1 class="c18" id="h.o5pjp8p4qy06"><span class="c29">Prebid Server Functional Requirements</span></h1><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">1) Optional configuration must be available for host companies to turn on and off enforcing GDPR with IAB TCF 2.0 API data. There should be global and publisher account level configuration. The default should be to enforce.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">2) If enforcement is turned on for this request, Prebid Server must be able to determine whether it&#39;s in-scope for GDPR processing. If any of the following conditions are true, the request is in-scope:</span></p><ol class="c2 lst-kix_6jgx19e9u9pe-0 start" start="1"><li class="c9"><span class="c0">the incoming request defines regs.ext.gdpr:true.</span></li><li class="c9"><span class="c0">regs.ext.gdpr is undefined, geo-lookup is turned on, and the user&#39;s IP address is in a configurable set of countries.</span></li><li class="c9"><span class="c0">regs.ext.gdpr is undefined and the host company&#39;s default scope is to enforce.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">3) Prebid Server must support the following host company controls:</span></p><ul class="c2 lst-kix_d8lzxbbe1553-0"><li class="c9"><span class="c0">Enforce/Do not enforce purpose P (globally and per-account)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce purpose P for vendor V (globally and per-account)</span></li><li class="c9"><span class="c0">Enforce/Do not enforce special purpose 1</span></li><li class="c9"><span class="c0">Enforce/Do not enforce special purpose 1 for vendor V</span></li><li class="c9"><span class="c0">ACCOUNT</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">4) Prebid Server must give host company config to say what to do with the purposeOneTreatment - both as a default and for each account:</span></p><ol class="c2 lst-kix_pzmtiq5h0915-0 start" start="1"><li class="c9"><span class="c0">ignore the flag entirely</span></li><li class="c9"><span class="c0">if purposeOneTreatment=1 and IsServiceSpecific=1 then Purpose 1 is overridden to no-access-allowed</span></li><li class="c9"><span>if</span><span>&nbsp;purposeOneTreatment=1 and IsServiceSpecific=1</span><span class="c0">&nbsp;then Purpose 1 is overridden to access-allowed</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">The implementation of this &ldquo;PurposeOneTreatmentInterpretation flag modifies the flowchart above: it may short-circuit the logic, jumping straight to Yes or No without a normal enforcement check.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span style="overflow: hidden; display: inline-block; margin: 0.00px 0.00px; border: 0.00px solid #000000; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px); width: 624.00px; height: 376.28px;"><img alt="" src="images/image1.png" style="width: 624.00px; height: 376.28px; margin-left: 0.00px; margin-top: 0.00px; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px);" title=""></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">5) It must be possible for a Host Company to define its GVL ID to use for confirming user user consent for setting cookies.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">Example configuration/DB entries:</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c15"><span class="c1">gdpr.host-vendor-id: 52<br>gdpr.enabled: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.enforcePurpose: no/basic/full // default full</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.enforceVendors: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.purpose.P.vendorExceptions: list of biddercodes<br>gdpr.specialfeature.S.enforce: true/false // default true</span></p><p class="c12 c15"><span class="c1">gdpr.specialfeature.S.vendorExceptions: list of biddercodes</span></p><p class="c12 c15"><span class="c1">gdpr.purposeOneTreatmentInterpretation: ignore/no-access-allowed/access-allowed</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.enabled: true/false &nbsp;// default true</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.enforcePurpose</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.enforceVendors</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purpose.P.vendorExceptions<br>account.A.gdpr.specialfeature.S.enforce</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.specialfeature.S.vendorExceptions</span></p><p class="c12 c15"><span class="c1">account.A.gdpr.purposeOneTreatmentInterpretation</span></p><p class="c12 c15"><span class="c1">geolocation.VENDOR.server: url // location of geo lookup service</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">6) There should be a way for bidAdapters to supply a GVL ID for each alias they support.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">7) The external definition of aliases should be extended to support specification of a GVL ID. e.g.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c20 c15"><span class="c8">&quot;ext&quot;: {</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &quot;prebid&quot;: {</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &quot;aliases&quot;: { &nbsp; &nbsp; &nbsp; &nbsp; // existing feature</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &nbsp; &quot;districtm&quot;: &quot;msft&quot;</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; },</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &quot;aliasgvlids&quot;: { &nbsp; &nbsp; // new feature</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; &nbsp; &quot;districtm&quot;: 144</span></p><p class="c20 c15"><span class="c8">&nbsp; &nbsp; &nbsp; }</span></p><p class="c15 c20"><span class="c8">&nbsp; &nbsp; }</span></p><p class="c20 c15"><span class="c8">&nbsp; }</span></p><p class="c20 c13"><span class="c8"></span></p><p class="c12"><span class="c0">8) Prebid Server&#39;s enforcement should be &quot;Full&quot; mode unless it doesn&#39;t have access to the proper GVL version.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">9) Prebid Server should be able to read the TCF2.0 GVL that&#39;s specified in the consent string. If it does not have immediate access to that version of the GVL, it may downgrade enforcement to &quot;Basic&quot;. The assumption is that subsequent requests for that version of the GVL will succeed. The system should log any usage of Basic Enforcement.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>10) If a bidder code isn&#39;t associated with a GVL ID, enforcement should assume that the vendor is </span><span class="c31">not allowed</span><span class="c0">&nbsp;unless the publisher has specifically named the bidder code as a configured exception.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">11) Analytics adapters must be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which analytics adapter(s) are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">12) User ID modules and Real Time Data modules should be associated with a GVL ID and/or a &quot;name&quot; to allow the system to determine which modules are permitted to operate in the current context.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">13) The system must be able to verify vendor consent in two ways:</span></p><ul class="c2 lst-kix_tb82mrxazni-0"><li class="c9"><span class="c0">User consents to GVL ID 52, and Prebid Server knows that 52 corresponds to the Rubicon bid adapter (and the Rubicon analytics adapter)</span></li><li class="c9"><span class="c0">The Host Company consents to the name &quot;bidderB&quot;, which would allow that biddercode to bid even if the user&#39;s Purpose 1 doesn&#39;t have specific consent.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">14) The internal interface to bid adapters should remain the same.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">15) The OpenRTB interface to Prebid Server should remain the same:</span></p><ul class="c2 lst-kix_u56eprq9ell0-0"><li class="c9"><span class="c0">regs.ext.gdpr </span></li><li class="c9"><span class="c0">user.ext.consent</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">16) The system must support all the activity enforcement noted in the &#39;Summary of Prebid TCF 2.0 Enforcement&#39; section.</span></p><ol class="c2 lst-kix_w5k728jy05vp-0 start" start="1"><li class="c9"><span class="c0">If Purpose 1 is being enforced:</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-1 start" start="1"><li class="c12 c16"><span class="c0">Before invoking /cookie_sync pixels for each enforceable vendor, verify consent as appropriate for the enforcement method.</span></li><li class="c12 c16"><span class="c0">Before setting a cookie on /setuid, verify consent for the Host Company&#39;s GVL ID as appropriate for the enforcement method</span></li><li class="c12 c16"><span class="c0">Before passing ID values to each enforceable vendor, verify consent as appropriate for the enforcement method.</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-0" start="2"><li class="c9"><span class="c0">If Purpose 2 is being enforced, verify consent for each vendor as appropriate for the enforcement method before calling a bid adapter. If consent is not granted, log a metric and skip it.</span></li><li class="c9"><span class="c0">If Purpose 4 is being enforced, verify consent for each vendor that passed the Purpose 2 test. If consent is not granted, log a metric, remove the bidrequest.userId attribute and call the adapter.</span></li><li class="c9"><span class="c0">If Purpose 7 is being enforced, verify consent for each analytics module. If consent is not granted, log a metric and skip it.</span></li><li class="c9"><span class="c0">If Special Feature 1 is being enforced, verify user opt-in. If the user has opted out, round off the IP address and lat/long details and log a metric.</span></li></ol><ol class="c2 lst-kix_w5k728jy05vp-1 start" start="1"><li class="c12 c16"><span class="c0">IP masking: for IPv4, zero out the last byte. For IPv6, zero out the last 2 bytes.</span></li><li class="c12 c16"><span class="c0">Check the OpenRtb packet for $.device.geo.lat, $.device.geo.lon, $.user.geo.lat, $.user.geo.lon. Round off the values to the last two decimal points if they exist.</span></li></ol><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span>17) If GDPR is being enforced but </span><span>no consent string is available</span><span class="c0">, the system must assume that the user does not consent to either purpose or vendor. Activities may still take place if the Host Company has configured the relevant Purposes as &#39;not enforced&#39;.</span></p><p class="c12 c13"><span class="c0"></span></p><p class="c12"><span class="c0">18) Prebid Server core must make the following information available to analytics adapters:</span></p><ul class="c2 lst-kix_w6yj8blbe06x-0"><li class="c9"><span class="c0">Enforcement status of Purposes 1,2,4,7, and Special Purpose 1</span></li><li class="c9"><span class="c0">An array of bidders and modules skipped due to TCF enforcement.</span></li></ul><p class="c12 c13"><span class="c0"></span></p><p class="c12 c13"><span class="c0"></span></p></body></html>
diff --git a/dev-docs/show-long-form-video-with-gam.md b/dev-docs/show-long-form-video-with-gam.md
index 573d25680d..b12f4af3cd 100644
--- a/dev-docs/show-long-form-video-with-gam.md
+++ b/dev-docs/show-long-form-video-with-gam.md
@@ -22,10 +22,10 @@ The code example below was built with Prebid.js and the following:
 * The [`dfpAdServerVideo` module](/dev-docs/modules/dfp_video.html), which will provide the video ad support.  
 * The [`categoryTranslation` module](/dev-docs/modules/categoryTranslation.html), to enable competitive separation.
 
-For example, to build with the AppNexus bidder adapter and GAM use the following command:
+For example, to build with the Microsoft bidder adapter and GAM use the following command:
 
 ```bash
-gulp build --modules=appnexusBidAdapter,dfpAdServerVideo
+gulp build --modules=msftBidAdapter,dfpAdServerVideo
 ```
 
 For more information about how to build with modules, see the [Prebid module documentation](/dev-docs/modules/).
@@ -63,9 +63,9 @@ var videoAdUnit = [{
     },
     bids: [
         {
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 14542875
+                placement_id: 14542875
             }
         }
     ]
diff --git a/dev-docs/show-native-ads.md b/dev-docs/show-native-ads.md
index 7e71f1b57b..fbd9b37c0c 100644
--- a/dev-docs/show-native-ads.md
+++ b/dev-docs/show-native-ads.md
@@ -20,7 +20,7 @@ using the [improved Prebid.js native ad](/prebid/native-implementation.html) sup
 
 In this tutorial, we'll set up Prebid.js to show native ads.
 
-We'll use the [AppNexus adapter]({{site.github.url}}/dev-docs/bidders.html#appnexus) since that adapter supports native ads, but the concepts and setup will be largely the same for any bidder adapter that supports the `"native"` media type.
+We'll use the [Micosoft adapter]({{site.github.url}}/dev-docs/bidders.html#msft) since that adapter supports native ads, but the concepts and setup will be largely the same for any bidder adapter that supports the `"native"` media type.
 
 Similarly, we'll use Google Ad Manager as the ad server, but the concept and implementation should be pretty similar to other ad servers.
 
@@ -69,7 +69,7 @@ This section describes the implementation using code samples, but ignores some o
 
 ### 1. Set up your ad slot
 
-In this example we'll store the ad slot info in a variable for reference throughout the page.  We use a 1x1 static ad slot size since AppNexus (our demand partner in this example) uses that size for native creatives.
+In this example we'll store the ad slot info in a variable for reference throughout the page.  We use a 1x1 static ad slot size since Microsoft (our demand partner in this example) uses that size for native creatives.
 
 ```javascript
 const slot = {
@@ -145,9 +145,9 @@ pbjs.addAdUnits({
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13232354
+            placement_id: 13232354
         }
     }, ]
 })
@@ -187,9 +187,9 @@ const adUnits = [{
         }
     }
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13232354
+            placement_id: 13232354
         }
     }]
 }];
diff --git a/dev-docs/show-outstream-video-ads.md b/dev-docs/show-outstream-video-ads.md
index 5446854e22..c812889a27 100644
--- a/dev-docs/show-outstream-video-ads.md
+++ b/dev-docs/show-outstream-video-ads.md
@@ -48,9 +48,9 @@ var videoAdUnits = [{
         }
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13232385,
+            placement_id: 13232385,
         }
     }]
 }];
diff --git a/dev-docs/show-prebid-ads-on-amp-pages.md b/dev-docs/show-prebid-ads-on-amp-pages.md
index 78fdedc434..3c2073fab5 100644
--- a/dev-docs/show-prebid-ads-on-amp-pages.md
+++ b/dev-docs/show-prebid-ads-on-amp-pages.md
@@ -131,7 +131,7 @@ The `amp-ad` elements in the page body need to be set up as shown below, especia
   - `vendors` is an object that defines any vendors that will be receiving RTC callouts (including Prebid Server) up to a maximum of five.  The list of supported RTC vendors is maintained in [callout-vendors.js](https://github.com/ampproject/amphtml/blob/master/src/service/real-time-config/callout-vendors.js). We recommend working with your Prebid Server hosting company to set up which bidders and parameters should be involved for each AMP ad unit.
   - `timeoutMillis` is an optional integer that defines the timeout in milliseconds for each individual RTC callout.  The configured timeout must be greater than 0 and less than 1000ms.  If omitted, the timeout value defaults to 1000ms.
 
-e.g. for the AppNexus cluster of Prebid Servers:
+e.g. for the Microsoft cluster of Prebid Servers:
 
 ```html
 <amp-ad width="300" height="250"
@@ -229,7 +229,7 @@ Notes:
 - The `sandbox` parameter to the amp-iframe must include both "allow-scripts" and "allow-same-origin".
 - If your PBS host company is using a version of `load-cookie.html` older than July of 2024 and if your AMP page is using a CMP, you should consider using `load-cookie-with-consent.html` instead. It's the same functionality, but older versions of `load-cookie.html` cannot read from CMPs.
 
-If you're using AppNexus' managed service, you would enter something like this:
+If you're using Microsoft's managed service, you would enter something like this:
 
 ```html
 <amp-iframe width="1" title="User Sync"
diff --git a/dev-docs/show-video-with-a-dfp-video-tag.md b/dev-docs/show-video-with-a-dfp-video-tag.md
index ad9adde953..2d4942c36c 100644
--- a/dev-docs/show-video-with-a-dfp-video-tag.md
+++ b/dev-docs/show-video-with-a-dfp-video-tag.md
@@ -13,7 +13,7 @@ sidebarType: 4
 
 In this tutorial, we'll show how to set up Prebid to show a video ad
 from Google Ad Manager.  We'll use the [Video.js](https://videojs.com/) player and
-the AppNexus bidder, but the principles are the same across
+the Microsoft bidder, but the principles are the same across
 different video players and video-enabled bidders.
 
 * TOC
@@ -31,11 +31,11 @@ Also, you need to make sure to build Prebid.js with:
 * Support for at least one video-enabled bidder
 * Support for the `gamAdServerVideo` ad server adapter, which will provide the video ad support
 
-For example, to build with the AppNexus bidder adapter and the Google Ad Manager
+For example, to build with the Microsoft bidder adapter and the Google Ad Manager
 Video ad server adapter, use the following command:
 
 ```bash
-gulp build --modules=gamAdServerVideo,appnexusBidAdapter
+gulp build --modules=gamAdServerVideo,msftBidAdapter
 ```
 
 For more information about how to build with modules, see the [Prebid.js project README](https://github.com/prebid/Prebid.js/blob/master/README.md#build-optimization).
@@ -68,9 +68,9 @@ var videoAdUnit = {
         },
     },
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: 13232361
+            placement_id: 13232361
         }
     }]
 };
diff --git a/docs-examples/web-example.md b/docs-examples/web-example.md
index 79c5246494..9e1c64903e 100644
--- a/docs-examples/web-example.md
+++ b/docs-examples/web-example.md
@@ -56,9 +56,9 @@ var adUnits = [{
     }
   },
   bids: [{
-    bidder: 'appnexus',
+    bidder: 'msft',
     params: {
-      placementId: 13144370
+      placement_id: 13144370
     }
   }]
 }];
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
index 261a78d8ca..7ce8a8bbd7 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-hosted.html
@@ -74,9 +74,9 @@ <h4>Place this code in the page header.</h4>
             }
         },
         bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 13232361  // Add your own placement id here<br>
+                placement_id: 13232361  // Add your own placement id here<br>
             }
         }]
     };
diff --git a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
index fe8c1035af..772fbd724f 100644
--- a/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
+++ b/examples/video/instream/jwplayer/pb-ve-jwplayer-platform.html
@@ -67,9 +67,9 @@ <h4>Place this code in the page header.</h4>
               }
           },
           bids: [{
-              bidder: 'appnexus',
+              bidder: 'msft',
               params: {
-                  placementId: 13232361  //put your placement id here<br>
+                  placement_id: 13232361  //put your placement id here<br>
               }
           }]
       };
diff --git a/examples/video/instream/videojs/pb-ve-videojs.html b/examples/video/instream/videojs/pb-ve-videojs.html
index 68ba056f49..d5884c418f 100644
--- a/examples/video/instream/videojs/pb-ve-videojs.html
+++ b/examples/video/instream/videojs/pb-ve-videojs.html
@@ -84,9 +84,9 @@ <h4>Place this code in the page header.</h4>
               }
           },
           bids: [{
-              bidder: 'appnexus',
+              bidder: 'msft',
               params: {
-                  placementId: 13232361
+                  placement_id: 13232361
               }
           }]
       };
diff --git a/examples/video/long-form/long-form-video-with-freewheel.html b/examples/video/long-form/long-form-video-with-freewheel.html
index 28f5e06c6b..f88cd24d1d 100644
--- a/examples/video/long-form/long-form-video-with-freewheel.html
+++ b/examples/video/long-form/long-form-video-with-freewheel.html
@@ -68,9 +68,9 @@
         },
         bids: [
           {
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-              placementId: 14542875
+              placement_id: 14542875
             }
           }
         ]
@@ -329,9 +329,9 @@ <h4>Prebid Freewheel Integration Demo</h4>
   },
   bids: [
     {
-      bidder: 'appnexus',
+      bidder: 'msft',
       params: {
-        placementId: 14542875
+        placement_id: 14542875
       }
     }
   ]
diff --git a/examples/video/long-form/pb-ve-lf-freewheel.html b/examples/video/long-form/pb-ve-lf-freewheel.html
index bbf15b1a6d..cc2e7ff78c 100644
--- a/examples/video/long-form/pb-ve-lf-freewheel.html
+++ b/examples/video/long-form/pb-ve-lf-freewheel.html
@@ -85,9 +85,9 @@ <h1>{{ page.title }}</h1>
     },
     bids: [
       {
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-          placementId: 14542875
+          placement_id: 14542875
         }
       }
     ]
diff --git a/examples/video/outstream/basic-ima.html b/examples/video/outstream/basic-ima.html
index 6c853181c2..cdbad74405 100644
--- a/examples/video/outstream/basic-ima.html
+++ b/examples/video/outstream/basic-ima.html
@@ -136,9 +136,9 @@ <h1>{{ page.title }}</h1>
     },
     bids: [
       {
-        bidder: "appnexus",
+        bidder: "msft",
         params: {
-          placementId: 13232385,
+          placement_id: 13232385,
         },
       },
     ],
diff --git a/examples/video/outstream/pb-ve-outstream-dfp.html b/examples/video/outstream/pb-ve-outstream-dfp.html
index 803e067576..5b31ae0d2c 100644
--- a/examples/video/outstream/pb-ve-outstream-dfp.html
+++ b/examples/video/outstream/pb-ve-outstream-dfp.html
@@ -101,9 +101,9 @@ <h4>Place this code in the page header.</h4>
           },
           bids: [
               {
-                  bidder: 'appnexus',
+                  bidder: 'msft',
                   params: {
-                      placementId: 13232385
+                      placement_id: 13232385
                   }
               }
           ]
diff --git a/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html b/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
index eb53b2dd88..5154ac5f71 100644
--- a/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
+++ b/examples/video/outstream/pb-ve-outstream-no-server-specify-renderer.html
@@ -135,9 +135,9 @@ <h4>Place this code in the page header.</h4>
               }
           },
           bids: [{
-              bidder: 'appnexus',
+              bidder: 'msft',
               params: {
-                  placementId: 13232385
+                  placement_id: 13232385
               }
           }]
       }];
@@ -149,7 +149,7 @@ <h4>Place this code in the page header.</h4>
               intercept: [
                 {
                   when: {
-                    bidder: 'appnexus',
+                    bidder: 'msft',
                   },
                   then: {
                     cpm: 10,
diff --git a/overview/how-to-simplify-line-item-setup.md b/overview/how-to-simplify-line-item-setup.md
index a470df22b4..44f1f6ce54 100644
--- a/overview/how-to-simplify-line-item-setup.md
+++ b/overview/how-to-simplify-line-item-setup.md
@@ -65,7 +65,7 @@ There you go!
 
 ### Simplification 2: Remove the bidder dimension
 
-In this section, we'll learn how to remove the bidder dimension for header bidding. Before, a publisher would have to create different set of line items for different bidders. For example, 3 different set of line items for AppNexus, Pubmatic, and Rubicon. With Prebid.js, a publisher only need to create 1 set of line items for all bidders.
+In this section, we'll learn how to remove the bidder dimension for header bidding. Before, a publisher would have to create different set of line items for different bidders. For example, 3 different set of line items for Microsoft, Pubmatic, and Rubicon. With Prebid.js, a publisher only need to create 1 set of line items for all bidders.
 
 There're a few reasons why previously you'd need different set of line items for bidders.
 
@@ -73,14 +73,14 @@ There're a few reasons why previously you'd need different set of line items for
 2. Bidders all have different targeting parameters.
 3. You need to run reports to learn fill rates and CPM from different bidders.
 
-Assume we have 1 set of line items for ALL bidders. Consider the below key-value pairs came in: (AppNexus bid $1.60, Rubicon bid $1.20. Ad IDs are used for rendering the right creative):
+Assume we have 1 set of line items for ALL bidders. Consider the below key-value pairs came in: (Microsoft bid $1.60, Rubicon bid $1.20. Ad IDs are used for rendering the right creative):
 
-* `appnexus_cpm`: 1.60
-* `appnexus_adId`: 65432
+* `msft_cpm`: 1.60
+* `msft_adId`: 65432
 * `rubicon_cpm`: 1.20
 * `rubicon_adId`: 23456
 
-The line item for $1.60 is chosen because it has the highest price. However, the creative attached to this line item will be given both `appnexus_ad_id`: 65432 and `rubicon_ad_id`: 23456. There's not an easy way for the right creative (in this case the AppNexus creative) to render.
+The line item for $1.60 is chosen because it has the highest price. However, the creative attached to this line item will be given both `msft_ad_id`: 65432 and `rubicon_ad_id`: 23456. There's not an easy way for the right creative (in this case the Microsoft creative) to render.
 
 <a name="pbjs-sends-highest-price-only"></a>
 
@@ -90,7 +90,7 @@ Prebid.js only picks the highest price bid and sends its key-value pairs to the
 
 * `hb_pb`: 1.60
 * `hb_adId`: 65432
-* `hb_bidder`: appnexus
+* `hb_bidder`: msft
 
 This simplifies the setup and the right creative (with adId 65432) will get displayed.
 
diff --git a/overview/prebid-universal-creative.md b/overview/prebid-universal-creative.md
index 9a1c5c8e7f..a3eb7ca400 100644
--- a/overview/prebid-universal-creative.md
+++ b/overview/prebid-universal-creative.md
@@ -45,7 +45,7 @@ Since version 10.11.0, Prebid.js populates the `hb_ver` ad server key-value whic
 This loads the PUC from the Prebid-maintained location. Your managed
 service provider may have a different location.
 
-To see specific examples of how to use the PUC within your ad server, see the guides for [GAM](/adops/gam-creative-banner-sbs.html), [Microsoft](/adops/setting-up-prebid-with-the-appnexus-ad-server.html), or [other ad servers](/adops/adops-general-sbs.html).
+To see specific examples of how to use the PUC within your ad server, see the guides for [GAM](/adops/gam-creative-banner-sbs.html), [Microsoft](/adops/setting-up-prebid-with-the-microsoft-ad-server.html), or [other ad servers](/adops/adops-general-sbs.html).
 
 ## Features of the PUC
 
@@ -114,5 +114,5 @@ If safeframe support is required, some options are:
 ## Further Reading
 
 - [Step by Step Guide to Google Ad Manager Setup](/adops/step-by-step.html)
-- [Setting up Prebid with the Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-appnexus-ad-server.html)
+- [Setting up Prebid with the Xandr Monetize Ad Server](/adops/setting-up-prebid-with-the-microsoft-ad-server.html)
 - [Prebid.js dynamic creatives](/adops/js-dynamic-creative.html)
diff --git a/overview/what-is-prebid-org.md b/overview/what-is-prebid-org.md
index cfba8f7a0c..08f0502e32 100644
--- a/overview/what-is-prebid-org.md
+++ b/overview/what-is-prebid-org.md
@@ -7,7 +7,7 @@ sidebarType: 0
 
 # About Prebid.org
 
-Header bidding has seen incredible adoption across the industry, and Prebid.js has been an integral part of that. AppNexus (now Xandr) created Prebid.js, but considered it too important to be owned by any one company. Thus, Prebid.org was created.
+Header bidding has seen incredible adoption across the industry, and Prebid.js has been an integral part of that. AppNexus (now Microsoft) created Prebid.js, but considered it too important to be owned by any one company. Thus, Prebid.org was created.
 
 Formed in September of 2017, Prebid.org is an independent organization designed to ensure and promote fair, transparent, and efficient header bidding across the industry. Funded by dues-paying members, it manages the open source projects Prebid.js, Prebid Mobile, Prebid Server, Prebid Video, Prebid Native, and others.
 
diff --git a/prebid-mobile/dr-prebid.md b/prebid-mobile/dr-prebid.md
index 4683098357..ea280bf0af 100644
--- a/prebid-mobile/dr-prebid.md
+++ b/prebid-mobile/dr-prebid.md
@@ -98,7 +98,7 @@ These settings will help verify that Prebid Mobile and Prebid Server are connect
 
 Select your Prebid Server host:
 
-- *AppNexus*
+- *AppNexus (Microsoft)*
 - *Rubicon*
 - *Custom*
 
diff --git a/prebid-mobile/pbm-api/android/code-integration-android.md b/prebid-mobile/pbm-api/android/code-integration-android.md
index 911fc9e71b..a6028faf58 100644
--- a/prebid-mobile/pbm-api/android/code-integration-android.md
+++ b/prebid-mobile/pbm-api/android/code-integration-android.md
@@ -313,7 +313,7 @@ PrebidMobile.setStoredAuctionResponse("response-prebid-banner-320-50")
 Stored Bid Responses are similar to Stored Auction Responses in that they signal to Prebid Server to respond with a static pre-defined response, except Stored Bid Responses is done at the bidder level, with bid requests sent out for any bidders not specified in the bidder parameter. For more information on how stored auction responses work, refer to the written [description on github issue 133](https://github.com/prebid/prebid-mobile-android/issues/133).
 
 ```kotlin
-PrebidMobile.addStoredBidResponse("appnexus", "221144");
+PrebidMobile.addStoredBidResponse("msft", "221144");
 PrebidMobile.addStoredBidResponse("rubicon", "221155");
 ```
 
diff --git a/prebid-mobile/pbm-api/ios/code-integration-ios.md b/prebid-mobile/pbm-api/ios/code-integration-ios.md
index 0c61ddaf5e..83ffc1a219 100644
--- a/prebid-mobile/pbm-api/ios/code-integration-ios.md
+++ b/prebid-mobile/pbm-api/ios/code-integration-ios.md
@@ -402,7 +402,7 @@ Prebid.shared.pbsDebug = true
 Prebid.shared.storedAuctionResponse = "111122223333"
 
 //or
-Prebid.shared.addStoredBidResponse(bidder: "appnexus", responseId: "221144")
+Prebid.shared.addStoredBidResponse(bidder: "msft", responseId: "221144")
 Prebid.shared.addStoredBidResponse(bidder: "rubicon", responseId: "221155")
 ```
 
diff --git a/prebid-server/developers/add-a-module-go.md b/prebid-server/developers/add-a-module-go.md
index 1b31e12647..663c3f0daf 100644
--- a/prebid-server/developers/add-a-module-go.md
+++ b/prebid-server/developers/add-a-module-go.md
@@ -229,11 +229,11 @@ Notes:
                                     "attributes": []string{"bcat"},
                                     "bcat":       []string{"IAB-1"},
                                 },
-                                AppliedTo: hookanalytics.AppliedTo{Bidder: "appnexus", ImpIds: []string{"imp_ID1"}},
+                                AppliedTo: hookanalytics.AppliedTo{Bidder: "msft", ImpIds: []string{"imp_ID1"}},
                             },
                             {
                                 Status:    hookanalytics.ResultStatusAllow,
-                                AppliedTo: hookanalytics.AppliedTo{Bidder: "appnexus", ImpIds: []string{"imp_ID2"}},
+                                AppliedTo: hookanalytics.AppliedTo{Bidder: "msft", ImpIds: []string{"imp_ID2"}},
                             },
                         },
                     },
diff --git a/prebid-server/developers/add-new-bidder-go.md b/prebid-server/developers/add-new-bidder-go.md
index b9593b57ce..ea830a8783 100644
--- a/prebid-server/developers/add-new-bidder-go.md
+++ b/prebid-server/developers/add-new-bidder-go.md
@@ -1066,7 +1066,7 @@ func newAdapterBuilders() map[openrtb_ext.BidderName]adapters.Builder {
 You need to provide default settings for your bid adapter. You can decide if you'd like your bid adapter to be enabled out of the box, and if so, you'll need to provide a default endpoint and default extra adapter info (if applicable). If your bid adapter requires host specific information to function properly, such as a security token or host account, then it's best to leave the adapter disabled.
 
 {: .alert.alert-warning :}
-**HOST SPECIFIC INFO:** The default endpoint must not be specific to any particular host, such as Xandr/AppNexus. We may ask you about suspicious looking ids during the review process. Please reach out to individual hosts if you need to set specialized configuration.
+**HOST SPECIFIC INFO:** The default endpoint must not be specific to any particular host, such as Microsoft/AppNexus. We may ask you about suspicious looking ids during the review process. Please reach out to individual hosts if you need to set specialized configuration.
 
 ## Aliasing an Adapter
 
@@ -1077,7 +1077,7 @@ the whole adapter codebase. Rather, follow these steps to create a 'hardcoded' a
 1. Add "aliasOf" in the config.yaml file with its value set to the name of the adapter you are creating an alias for
 
 ```yaml
-aliasOf: "appnexus"
+aliasOf: "msft"
 ```
 
 Notes:
diff --git a/prebid-server/endpoints/info/pbs-endpoint-info.md b/prebid-server/endpoints/info/pbs-endpoint-info.md
index f9b5713ea4..6e8f85ff68 100644
--- a/prebid-server/endpoints/info/pbs-endpoint-info.md
+++ b/prebid-server/endpoints/info/pbs-endpoint-info.md
@@ -26,7 +26,7 @@ This endpoint returns JSON like:
 
 ```json
 [
-  "appnexus",
+  "msft",
   "audienceNetwork",
   "pubmatic",
   "rubicon",
@@ -94,7 +94,7 @@ For example:
 
 ```json
 {
-  "appnexus": { /* A json-schema describing AppNexus' bidder params */ },
+  "msft": { /* A json-schema describing Microsoft's bidder params */ },
   "magnite": { /* A json-schema describing Rubicon's bidder params */ },
   "otherBidder": { /* A json-schema describing Rubicon's bidder params */ }
 }
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.md
index c1e56de9ed..6307c4515c 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-amp.md
@@ -147,15 +147,15 @@ A sample response payload looks like this:
 ```javascript
 {
     "targeting": {
-        "hb_bidder": "appnexus",
-        "hb_bidder_appnexus": "appnexus",
+        "hb_bidder": "msft",
+        "hb_bidder_msft": "msft",
         "hb_cache_id": "420d7329-30e8-4c4e-8eaa-fe937172e4e0",
-        "hb_cache_id_appnexus": "420d7329-30e8-4c4e-8eaa-fe937172e4e0",
+        "hb_cache_id_msft": "420d7329-30e8-4c4e-8eaa-fe937172e4e0",
         "hb_creative_loadtype": "html",
         "hb_pb": "0.50",
-        "hb_pb_appnexus": "0.50",
+        "hb_pb_msft": "0.50",
         "hb_size": "300x250",
-        "hb_size_appnexus": "300x250",
+        "hb_size_msft": "300x250",
         "hb_env": "amp"                      // PBS-Java only
     }
     "errors": {
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index ff592862e8..e18b502002 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -739,18 +739,18 @@ This can be used to request bids from the same Bidder with different params. For
       "mimes": ["video/mp4"]
     },
     "ext": {
-      "appnexus": {
-        "placementId": 123
+      "msft": {
+        "placement_id": 123
       },
       "districtm": {
-        "placementId": 456
+        "placement_id": 456
       }
     }
   }],
   "ext": {
     "prebid": {
       "aliases": {
-        "districtm": "appnexus"
+        "districtm": "msft"
       }
     }
   }
@@ -768,12 +768,12 @@ For example, if the Request defines an alias like this:
 
 ```json5
 "aliases": {
-  "appnexus": "rubicon"
+  "msft": "rubicon"
 }
 ```
 
-then any `imp[].ext.appnexus` params will actually go to the **rubicon** adapter.
-It will become impossible to fetch bids from AppNexus within that Request.
+then any `imp[].ext.msft` params will actually go to the **rubicon** adapter.
+It will become impossible to fetch bids from Microsoft within that Request.
 
 ##### Bidder Alias GVL IDs
 
@@ -1923,9 +1923,9 @@ For example, a request may return this in `response.ext`
 {
   "ext": {
     "errors": {
-      "appnexus": [{
+      "msft": [{
         "code": 2,
-        "message": "A hybrid Banner/Audio Imp was offered, but Appnexus doesn't support Audio."
+        "message": "A hybrid Banner/Audio Imp was offered, but Microsoft doesn't support Audio."
       }],
       "rubicon": [{
         "code": 1,
diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
index b098600c34..34295d37d1 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
@@ -62,12 +62,12 @@ These key-values are returned to the SSAI server as part of the video response.
 | podconfig.pods | Required | `Object[]` |  Container object for describing the adPod(s) to be requested.  |
 | site | Required | `Object` |  Container object for the URL of the impression to be shown. Can be excluded if app is included.  |
 | site.page | Required | `String` | URL of the page where the impression will be shown.  |
-| site.publisher.id | Required | `String` | Appnexus member ID.  |
+| site.publisher.id | Required | `String` | Microsoft member ID.  |
 | app | Required | `Object` |  Container object for app information where the impression is to be shown. Can be excluded if site is included.  |
 | app.bundle | Optional | `String` |  A platform-specific application identifier intended to be unique to the app and independent of the exchange. On Android, this should be a bundle or package name (e.g., com.foo.mygame). On iOS, it is typically a numeric ID. |
 | app.domain | Required | `String` |  The domain of the app. |
 | app.name | Optional | `String` |  The name of the app. |
-| app.publisher.id | Required | `String` |  Appnexus member ID. |
+| app.publisher.id | Required | `String` |  Microsoft member ID. |
 | app.storeurl | Optional | `String` |  App store URL for an installed app. |
 | video | Required | `Object` |  Container object for video player data. |
 | video.w | Optional | `Integer` |  Width of the video player in device independent pixels. |
@@ -169,7 +169,7 @@ These are the supported (registered) bidder names.
 * "adform"
 * "adkernelAdn"
 * "adtelligent"  
-* "appnexus"
+* "msft"
 * "audienceNetwork"  
 * "beachfront"
 * "eplanning"
@@ -241,7 +241,7 @@ Publishers can comply with CCPA regulations by setting `regs.ext.us.privacy` to
     "yob": 1982,
     "gender": "M",
     "buyeruids": {
-      "appnexus": "unique_id_an"
+      "msft": "unique_id_an"
     },
     "gdpr": {
       "consentrequired": false,
diff --git a/prebid-server/features/pbs-default-request.md b/prebid-server/features/pbs-default-request.md
index 5053f8401d..c94fae0ef5 100644
--- a/prebid-server/features/pbs-default-request.md
+++ b/prebid-server/features/pbs-default-request.md
@@ -43,7 +43,7 @@ For both PBS-Go and PBS-Java, here's an example default request file:
     "ext": {
         "prebid": {
             "aliases": {
-                "districtm": "appnexus"
+                "districtm": "msft"
             }
         }
     }
diff --git a/prebid-server/features/pbs-storedreqs-go.md b/prebid-server/features/pbs-storedreqs-go.md
index 92b8bb4e63..0110de7b98 100644
--- a/prebid-server/features/pbs-storedreqs-go.md
+++ b/prebid-server/features/pbs-storedreqs-go.md
@@ -39,7 +39,7 @@ Add the file `stored_requests/data/by_id/stored_imps/{id}.json` and populate it
   "ext": {
     "prebid": {
       "bidder": {
-        "appnexus": {
+        "msft": {
           "placement_id": 12883451
         }
       }
@@ -97,7 +97,7 @@ You can also store _part_ of the Imp on the server. For example:
   "ext": {
     "prebid": {
       "bidder": {
-        "appnexus": {
+        "msft": {
           "placement_id": 12883451
         }
       }
diff --git a/prebid-server/features/pbs-storedreqs-java.md b/prebid-server/features/pbs-storedreqs-java.md
index d9249deb78..c354b9da19 100644
--- a/prebid-server/features/pbs-storedreqs-java.md
+++ b/prebid-server/features/pbs-storedreqs-java.md
@@ -53,7 +53,7 @@ Add the file `stored_imps/{id}.json` and populate it with some [imp](https://www
   "ext": {
     "prebid": {
       "bidder": {
-        "appnexus": {
+        "msft": {
           "placement_id": 10433394
         }
       }
@@ -104,7 +104,7 @@ You can also store _part_ of the `imp` on the server. For example:
   "ext": {
     "prebid": {
       "bidder": {
-        "appnexus": {
+        "msft": {
           "placement_id": 10433394
         }
       }
diff --git a/prebid-server/pbs-modules/greenbids-real-time-data.md b/prebid-server/pbs-modules/greenbids-real-time-data.md
index 062366d70a..c67f47c56b 100644
--- a/prebid-server/pbs-modules/greenbids-real-time-data.md
+++ b/prebid-server/pbs-modules/greenbids-real-time-data.md
@@ -204,7 +204,7 @@ Here's an example analytics tag that might be produced for use in an analytics a
                 "fingerprint": "ad63524e-b13f-4359-a975-dba9b5dc08f4",
                 "keptInAuction": {
                   "improvedigital": false,
-                  "appnexus": true,
+                  "msft": true,
                   "pubmatic": false,
                   "rubicon": true,
                   "teads": false
diff --git a/prebid-server/use-cases/pbs-amp.md b/prebid-server/use-cases/pbs-amp.md
index bf2b03b61c..089e192528 100644
--- a/prebid-server/use-cases/pbs-amp.md
+++ b/prebid-server/use-cases/pbs-amp.md
@@ -52,7 +52,7 @@ There are two basic ways of invoking AMP RTC:
 ```
 
 {: .alert.alert-info :}
-**Note:** the `prebidrubicon` and `prebidappnexuspsp` AMP vendor strings define slightly different parameters; AppNexus uses "PLACEMENT_ID" as the argument to rtc-config while Rubicon uses "REQUEST_ID". They both translate to `tag_id` when passed to Prebid Server.
+**Note:** the `prebidrubicon` and `prebidappnexuspsp` AMP vendor strings define slightly different parameters; Microsoft uses "PLACEMENT_ID" as the argument to rtc-config while Rubicon uses "REQUEST_ID". They both translate to `tag_id` when passed to Prebid Server.
 
 - The other option is to construct a direct URL from component pieces: w, h, slot, targeting, gdpr_consent, account, page url (purl), etc.
 
diff --git a/prebid-server/use-cases/pbs-sdk.md b/prebid-server/use-cases/pbs-sdk.md
index dd14f5de6c..4638855806 100644
--- a/prebid-server/use-cases/pbs-sdk.md
+++ b/prebid-server/use-cases/pbs-sdk.md
@@ -63,7 +63,7 @@ The resulting OpenRTB generated by the SDK and sent to Prebid Server would be:
 {
   "id": "random-uuid",
   "app": {
-        "bundle": "AppNexus.PrebidMobileDemo",
+        "bundle": "Microsoft.PrebidMobileDemo",
         "ext": {
             "prebid": {
                 "version": "0.2.0",
diff --git a/prebid-video/video-integrating-solo.md b/prebid-video/video-integrating-solo.md
index eb6095632f..cc770c93d3 100644
--- a/prebid-video/video-integrating-solo.md
+++ b/prebid-video/video-integrating-solo.md
@@ -38,15 +38,15 @@ The mediaTypes.video.playerSize field is where you define the player size that w
 
 For full details on video ad unit parameters, see [Ad Unit Reference for Video]({{site.baseurl}}/dev-docs/adunit-reference.html#adunitmediatypesvideo)
 
-In your ad unit you also need to define your list of bidders. For example, including AppNexus as a bidder would look something like this:
+In your ad unit you also need to define your list of bidders. For example, including Microsoft as a bidder would look something like this:
 
 ```javascript
 var adUnit1 = {
     // ...
     bids: [{
-        bidder: 'appnexus',
+        bidder: 'msft',
         params: {
-            placementId: '123456789',
+            placement_id: '123456789',
         }
     }]
 }
diff --git a/prebid-video/video-long-form.md b/prebid-video/video-long-form.md
index 38bed5fbbe..d8feb2caa7 100644
--- a/prebid-video/video-long-form.md
+++ b/prebid-video/video-long-form.md
@@ -78,9 +78,9 @@ var longFormatAdUnit = {
     }
 
     bids: [{
-            bidder: 'appnexus',
+            bidder: 'msft',
             params: {
-                placementId: 123456789,
+                placement_id: 123456789,
             }
         }]
 }
@@ -171,7 +171,7 @@ pbjs.setConfig({
   adpod: {
     prioritizeDeals: true,
     dealTier: {
-      'appnexus': {
+      'msft': {
         prefix: 'tier',
         minDealTier: 5
       },
diff --git a/tools/line-item-manager.md b/tools/line-item-manager.md
index de88441b0b..975fa0a234 100644
--- a/tools/line-item-manager.md
+++ b/tools/line-item-manager.md
@@ -131,10 +131,10 @@ This would create a set of orders for bidder Rubicon
 ![Line Item Results 1](/assets/images/tools/line-item-mgmt-img1.png){:class="pb-xlg-img"}
 
 ```bash
-line_item_manager create my_config.yml -b rubicon -b appnexus -b openx
+line_item_manager create my_config.yml -b rubicon -b msft -b openx
 ```
 
-This would create a set of orders for bidders Rubicon, Appnexus and OpenX
+This would create a set of orders for bidders Rubicon, Microsoft and OpenX
 
 ![Line Item Results 2](/assets/images/tools/line-item-mgmt-img2.png){:class="pb-xlg-img"}
 
diff --git a/troubleshooting/troubleshooting-guide.md b/troubleshooting/troubleshooting-guide.md
index d62d726bc1..9641cdd4a5 100644
--- a/troubleshooting/troubleshooting-guide.md
+++ b/troubleshooting/troubleshooting-guide.md
@@ -376,7 +376,7 @@ The following parameters in the `bidResponse` object are common across all bidde
 {: .table .table-bordered .table-striped }
 | Name     | Type    | Description                                                                                                                                                       | Example                                                                 |
 |----------+---------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------|
-| `bidder` | String  | Unique bidder code used by ad server's line items to identify the bidder                                                                                          | `"appnexus"`                                                            |
+| `bidder` | String  | Unique bidder code used by ad server's line items to identify the bidder                                                                                          | `"msft"`                                                            |
 | `adId`   | String  | Unique identifier of a bid creative. Used by the line item's creative as in [this example](/adops/gam-creative-banner-sbs.html) | `"123"`                                                                 |
 | `pbLg`   | String  | Low granularity price bucket: $0.50 increment, capped at $5, floored to 2 decimal places (0.50, 1.00, 1.50, ..., 5.00)                                            | `"1.50"`                                                                |
 | `pbMg`   | String  | Medium granularity price bucket: 0.10 increment, capped at $20, floored to 2 decimal places (0.10, 0.20, ..., 19.90, 20.00)                                       | `"1.60"`                                                                |
@@ -395,7 +395,7 @@ The below snippet can be added to your page to better understand the Auction whe
 ```javascript
 pbjs.que.push(function() {
   pbjs.addAdUnits(adUnits);
-  pbjs.aliasBidder('appnexus', 'waitForMe');
+  pbjs.aliasBidder('msft', 'waitForMe');
   pbjs.aliasBidder('rubicon', 'doNotWaitForMe');
   pbjs.setConfig({
       'auctionOptions': {

From cdcaee60a7d74c3366398790d04cb6bfd4a7322f Mon Sep 17 00:00:00 2001
From: tom-utiq <tomasz.januszek@utiq.com>
Date: Tue, 23 Jun 2026 17:26:15 +0200
Subject: [PATCH 659/665] Utiq: Update contact emails (#6633)

---
 dev-docs/modules/userid-submodules/utiq.md    | 2 +-
 dev-docs/modules/userid-submodules/utiqMtp.md | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/utiq.md b/dev-docs/modules/userid-submodules/utiq.md
index 87ca81589f..26e1f40884 100644
--- a/dev-docs/modules/userid-submodules/utiq.md
+++ b/dev-docs/modules/userid-submodules/utiq.md
@@ -62,4 +62,4 @@ pbjs.setConfig({
 
 ## Utiq ID onboarding
 
-If you wish to find out more about Utiq, please contact <csm@utiq.com>
+If you wish to find out more about Utiq, please contact <onboard@utiq.com>
diff --git a/dev-docs/modules/userid-submodules/utiqMtp.md b/dev-docs/modules/userid-submodules/utiqMtp.md
index 6f061622a4..6a6041e42b 100644
--- a/dev-docs/modules/userid-submodules/utiqMtp.md
+++ b/dev-docs/modules/userid-submodules/utiqMtp.md
@@ -45,7 +45,7 @@ pbjs.setConfig({
 })
 ```
 
-You may like to consider limiting the SSPs that receive the martechpass by **adding the bidders array**, to make sure they are not forwarding this first party ID to DSPs. We are working with SSPs to blacklist the above source from being sent to DSPs, please reach out to <csm@utiq.com> to verify which are these SSPs.
+You may like to consider limiting the SSPs that receive the martechpass by **adding the bidders array**, to make sure they are not forwarding this first party ID to DSPs. We are working with SSPs to blacklist the above source from being sent to DSPs, please contact <onboard@utiq.com> to verify which are these SSPs.
 
 ## TCF Activity Integration
 
@@ -74,4 +74,4 @@ pbjs.setConfig({
 
 ## Utiq ID onboarding
 
-If you wish to find out more about Utiq, please contact <csm@utiq.com>
+If you wish to find out more about Utiq, please contact <onboard@utiq.com>

From 4a1a085ff58470ae99e80a35b158d4fcc3e2790f Mon Sep 17 00:00:00 2001
From: jasonc721 <jasonc721@gmail.com>
Date: Wed, 24 Jun 2026 08:39:50 -0600
Subject: [PATCH 660/665] msft bidder file - fix syntax issue (Ado10829159)
 (#6637)

* Updating the site to begin the Appnexus adpater
decpreatction and to rename elements to Microsoft.

* Updated files based on PR feedback

* updated files based on comments.

* Removed references to defaultvendor.

* Updating files based on PR feedback.

* one last file to update for the PR.

* Fixed sytax error in the Microsoft bidder documentation.

---------

Co-authored-by: Jason Crane <jasoncrane@microsoft.com>
---
 dev-docs/bidders/msft.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index 99c6844210..567e34727f 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -2,6 +2,8 @@
 layout: bidder
 title: Microsoft
 description: Prebid Microsoft Bidder Adaptor
+redirect_from: 
+- /dev-docs/bidders/appnexus.html
 biddercode: msft
 media_types: banner, video, native
 tcfeu_supported: true
@@ -15,9 +17,7 @@ gpp_supported: true
 floors_supported: true
 fpd_supported: true
 pbjs: true
-pbjs_version_notes: 
-redirect_from
-	- /dev-docs/bidders/appnexus.html
+pbjs_version_notes: 	
 pbs: true
 gvl_id: 32
 sidebarType: 1

From 7655bc5814f56bb21bc9714cd73e39ffbb834756 Mon Sep 17 00:00:00 2001
From: rtuschkany <35923908+rtuschkany@users.noreply.github.com>
Date: Wed, 24 Jun 2026 17:18:04 +0200
Subject: [PATCH 661/665] ConnectAd Update (#6593)

* ConnectAd: documentation update

Co-authored-by: Cursor <cursoragent@cursor.com>

* Update dev-docs/bidders/connectad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/connectad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/connectad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/connectad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Update dev-docs/bidders/connectad.md

Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>

* Fix ConnectAd doc markdownlint and multiformat metadata.

Set multiformat_supported to will-bid-on-any and simplify the bid params table to resolve MD060 alignment errors.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Muki Seiler <muuki88@users.noreply.github.com>
---
 dev-docs/bidders/connectad.md | 103 ++++++++++++++++++++++++++++++----
 1 file changed, 92 insertions(+), 11 deletions(-)

diff --git a/dev-docs/bidders/connectad.md b/dev-docs/bidders/connectad.md
index ec7418a887..2023a3debe 100644
--- a/dev-docs/bidders/connectad.md
+++ b/dev-docs/bidders/connectad.md
@@ -1,34 +1,115 @@
 ---
 layout: bidder
 title: ConnectAd
-description: ConnectAd Prebid Adaptor
+description: ConnectAd Prebid Adapter
 biddercode: connectad
-media_types: banner
+media_types: banner, video, native, audio
 tcfeu_supported: true
 usp_supported: true
 coppa_supported: true
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true
+dchain_supported: true
 userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrableId, pubCommonId, unifiedId
 prebid_member: true
 safeframes_ok: true
 floors_supported: true
+deals_supported: true
 pbjs: true
 pbs: true
+pbs_app_supported: true
+fpd_supported: true
+ortb_blocking_supported: true
 gvl_id: 138
+multiformat_supported: will-bid-on-any
 sidebarType: 1
+endpoint_compression: true
 ---
 
-### Prebid Server Note
-
-{% include dev-docs/pbjs-adapter-required-for-pbs.md %}
+## Prebid Server Note
 
 Please reach out to your ConnectAd Account Manager before configuring the S2S adapter for approval and setup.
 
-### Bid Params
+The ConnectAd server-side adapters (Java and Go) have been modernized to fully support **Video** and **Native** ad formats, OpenRTB 2.6 dynamic bid type resolution, and complete request payload (`imp.ext`) preservation.
+
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name        | Scope    | Description                    | Example | Type      |
-|-------------|----------|--------------------------------|---------|-----------|
-| `siteId`    | required | The site ID from ConnectAd.    | 12345   | integer   |
-| `networkId` | required | The network ID from ConnectAd. | 10047   | integer   |
-| `bidfloor`  | optional | Requested Floorprice           | 0.15    | number    |
+| Name | Scope | Description | Example | Type |
+| --- | --- | --- | --- | --- |
+| `siteId` | required | The site ID from ConnectAd. | 12345 | integer |
+| `networkId` | required | The network ID from ConnectAd. | 10047 | integer |
+| `bidfloor` | optional | Requested floor price, used as a fallback when the Price Floors module does not set one. | 0.15 | number |
+| `endpointUrl` | optional | Prebid.js only: override the bid endpoint URL for testing or a custom datacenter. Ignored by Prebid Server. | `https://i.connectad.io/api/v3` | string |
+
+## Additional Features
+
+- **Video & Native Support**: ConnectAd now supports standard Prebid Video and Native formats via the `ortbConverter`.
+- **Viewability Measurement**: The Prebid.js adapter natively integrates standardized viewability measurement (`percentInView`).
+- **OpenRTB 2.6**: Full support for OpenRTB 2.6 standards, including dynamic bid type resolution.
+
+## User Sync
+
+ConnectAd recommends enabling user syncing via iFrame. This significantly improves user match rates and overall monetization performance. Be sure to call `pbjs.setConfig()` only once.
+
+```javascript
+pbjs.setConfig({
+  userSync: {
+    iframeEnabled: true,
+    filterSettings: {
+      iframe: {
+        bidders: ['connectad'],
+        filter: 'include'
+      }
+    }
+  }
+});
+```
+
+**Note:** *Combine the above configuration with any other UserSync configuration. Multiple `setConfig()` calls overwrite each other and only the last call for a given attribute will take effect.*
+
+## First Party Data
+
+Publishers should use the `ortb2` method of setting [First Party Data](/features/firstPartyData.html). The following fields are supported:
+
+- `ortb2.site.*`
+- `ortb2.user.*`
+
+AdUnit-specific data is supported using `adUnit.ortb2Imp.ext.*`:
+
+```javascript
+pbjs.setConfig({
+  ortb2: {
+    site: {
+      keywords: 'sports, news',
+      content: {
+        language: 'en'
+      }
+    },
+    user: {
+      keywords: 'automotive'
+    }
+  }
+});
+```
+
+## Endpoint Compression
+
+The ConnectAd adapter supports gzip compression for outgoing requests, which is built into Prebid.js core. For more information, see [Compression Support for Outgoing Requests](/dev-docs/bidder-adaptor.html#compression-support-for-outgoing-requests).
+
+### Disabling Compression
+
+You can disable gzip compression at the bidder level using `pbjs.setBidderConfig`. Set the `gzipEnabled` value to `false`:
+
+```javascript
+pbjs.que.push(function () {
+  pbjs.setBidderConfig({
+    bidders: ['connectad'],
+    config: {
+      gzipEnabled: false
+    }
+  });
+});
+```
+
+<!-- workaround bug where code blocks at end of a file are incorrectly formatted-->

From 774a680784aab006c5360d49e8ddf3673908d867 Mon Sep 17 00:00:00 2001
From: jasonc721 <jasonc721@gmail.com>
Date: Wed, 24 Jun 2026 09:31:01 -0600
Subject: [PATCH 662/665] msft bidder page - corrected bid params table
 Ado10829159  (#6638)

* Updating the site to begin the Appnexus adpater
decpreatction and to rename elements to Microsoft.

* Updated files based on PR feedback

* updated files based on comments.

* Removed references to defaultvendor.

* Updating files based on PR feedback.

* one last file to update for the PR.

* Fixed sytax error in the Microsoft bidder documentation.

* fix table format in the bid params section

---------

Co-authored-by: Jason Crane <jasoncrane@microsoft.com>
---
 dev-docs/bidders/msft.md | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index 567e34727f..7ac9299287 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -49,19 +49,19 @@ All Microsoft (formerly AppNexus/Xandr) placements included in a single call to
 
 {: .table .table-bordered .table-striped }
 
-|Name|Scope|Description|Example|Type|
-|:---|:---|:---|:---|:---|
-|`placement_id`|required (see note above)|The placement ID from Microsoft Monetize. You may identify a placement using the `inv_code` and `member` instead of a placement ID.|`11223344`|`integer`|
-|`member`|required (see note above)|The member ID from Microsoft Monetize. Must be used with `inv_code`.|`1234`|`integer`|
-|`inv_code`|required (see note above)|The inventory code from Microsoft Monetize. Must be used with `member`.|`'abc123'`|`string`|
-|`allow_smaller_sizes`|optional|If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`.|`true`|`boolean`|
-|`use_pmt_rule`|optional|If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied.|`true`|`boolean`|
-|`keywords`|optional|A comma-delimited string of key-value pairs (or terms) applied to this specific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager.`|`pet=dog,food,brand=oldroy`|`string`|
-|`traffic_source_code`|optional|Specifies the third-party source of this impression.|`'my_traffic_source'`|`string`|
-|`pubclick`|optional|Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly.`|`'http://click.adserver.com/'`|`string`|
-|`ext_inv_code`|optional|Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged.|`'10039'`|`string`|
-|`ext_imp_id`|optional|Specifies the unique identifier of an externally generated auction.|`'bacbab02626452b097f6030b3c89ac05'`|`string`|
-|`banner_frameworks`|optional|Array of integers listing API frameworks for Banner supported by the publisher.|`[1,2]`|`array of integers`|
+| Name | Scope | Description | Example | Type |
+| :--- | :--- | :--- | :--- | :--- |
+| `placement_id` | required (see note above) | The placement ID from Microsoft Monetize. You may identify a placement using the `inv_code` and `member` instead of a placement ID. | `11223344` | `integer` |
+| `member` | required (see note above) | The member ID from Microsoft Monetize. Must be used with `inv_code`. | `1234` | `integer` |
+| `inv_code` | required (see note above) | The inventory code from Microsoft Monetize. Must be used with `member`. | `'abc123'` | `string` |
+| `allow_smaller_sizes` | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`. | `true` | `boolean` |
+| `use_pmt_rule` | optional | If `true`, Microsoft Monetize will return net price to Prebid.js after publisher payment rules have been applied. | `true` | `boolean` |
+| `keywords` | optional | A comma-delimited string of key-value pairs (or terms) applied to this specific ad slot on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the request/page level. Each tag can have up to 100 additional key/value pairs defined. If you want to pass keywords for all adUnits, please use the relevant keywords fields in the First Party Data feature. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an Microsoft Monetize account manager. | `pet=dog,food,brand=oldroy` | `string` |
+| `traffic_source_code` | optional | Specifies the third-party source of this impression. | `'my_traffic_source'` | `string` |
+| `pubclick` | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using Microsoft Monetize click tracking properly. | `'http://click.adserver.com/'` | `string` |
+| `ext_inv_code` | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged. | `'10039'` | `string` |
+| `ext_imp_id` | optional | Specifies the unique identifier of an externally generated auction. | `'bacbab02626452b097f6030b3c89ac05'` | `string` |
+| `banner_frameworks` | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `[1,2]` | `array of integers` |
 
 <a name="migration-from-appnexus-bid-params"></a>
 

From 3526559227d7fab4429e85ef468bfd84493c1e29 Mon Sep 17 00:00:00 2001
From: deferoper <dev@ferio.cloud>
Date: Wed, 24 Jun 2026 19:32:54 +0300
Subject: [PATCH 663/665] New Adapter: ferio docs (+ myfeature alias and
 lunamedia adapter maintenance transfer) (#6568)

* Add ferio bid adapter docs

* fix: add missing required param

* docs: add featuretv bidder docs

* docs: rename myfeature bidder adapter documentation

* docs: update LunamediaHB bidder adapter documentation

* fix: update pbs parameter and remove unnecessary Prebid Server Bid Params section
---
 dev-docs/bidders/ferio.md       | 31 +++++++++++++++++++++++++++
 dev-docs/bidders/lunamediahb.md | 20 +++++++++++++-----
 dev-docs/bidders/myfeature.md   | 37 +++++++++++++++++++++++++++++++++
 3 files changed, 83 insertions(+), 5 deletions(-)
 create mode 100644 dev-docs/bidders/ferio.md
 create mode 100644 dev-docs/bidders/myfeature.md

diff --git a/dev-docs/bidders/ferio.md b/dev-docs/bidders/ferio.md
new file mode 100644
index 0000000000..4ba0ad93fe
--- /dev/null
+++ b/dev-docs/bidders/ferio.md
@@ -0,0 +1,31 @@
+---
+layout: bidder
+title: Ferio
+description: Ferio Prebid Bidder Adapter
+biddercode: ferio
+gvl_id: none
+usp_supported: true
+gpp_sids: none
+schain_supported: true
+media_types: banner, video, native
+floors_supported: true
+fpd_supported: true
+userIds: all
+pbjs: true
+pbs: false
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+## Note
+
+The Ferio bidder adapter requires setup before beginning. Please contact <prebid@ferio.cloud> for more information.
+
+## Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| --------------- | ---------- | ------------------------------------ | ----------------------------------- | ---------- |
+| `publisherId` | required | Publisher ID on the Ferio platform | `'pubwZR87JRDZSf6V'` | `string` |
+| `adUnitId` | required | Ad unit ID on the Ferio platform | `'3855715c-2ceb-4ba5-a876-8c43a987f210'` | `string` |
+| `tenantId` | required | Tenant ID on the Ferio platform | `'client-pbjs'` | `string` |
diff --git a/dev-docs/bidders/lunamediahb.md b/dev-docs/bidders/lunamediahb.md
index ef6e95dd71..cb2d8ef693 100644
--- a/dev-docs/bidders/lunamediahb.md
+++ b/dev-docs/bidders/lunamediahb.md
@@ -1,7 +1,7 @@
 ---
 layout: bidder
 title: LunamediaHB
-description: Prebid Lunamedia Bidder Adapter
+description: LunamediaHB Bidder Adapter
 biddercode: lunamediahb
 usp_supported: true
 schain_supported: true
@@ -9,14 +9,24 @@ gvl_id: 998
 tcfeu_supported: true
 coppa_supported: true
 media_types: banner, video, native
+floors_supported: true
+fpd_supported: true
+userIds: all
 pbjs: true
 pbs: false
+multiformat_supported: will-bid-on-any
 sidebarType: 1
 ---
 
-### Prebid.Server Bid Params
+## Note
+
+The LunamediaHB bidder adapter is maintained by Ferio and requires setup before beginning. Please contact <prebid@ferio.cloud> for more information.
+
+### Prebid.js Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name           | Scope    | Description                                              | Example    | Type      |
-|----------------|----------|----------------------------------------------------------|------------|-----------|
-| `placementId` | required | Placement Id will be generated on Lunamedia Platform. | `'0'`        | `string` |
+| Name | Scope | Description | Example | Type |
+| --------------- | ---------- | ------------------------------------ | ----------------------------------- | ---------- |
+| `publisherId` | required | Publisher ID on the LunamediaHB platform. | `'publisher-123'` | `string` |
+| `adUnitId` | required | Ad unit ID on the LunamediaHB platform. | `'ad-unit-456'` | `string` |
+| `tenantId` | required | Tenant ID on the LunamediaHB platform. | `'tenant-789'` | `string` |
diff --git a/dev-docs/bidders/myfeature.md b/dev-docs/bidders/myfeature.md
new file mode 100644
index 0000000000..19f47c850d
--- /dev/null
+++ b/dev-docs/bidders/myfeature.md
@@ -0,0 +1,37 @@
+---
+layout: bidder
+title: MyFeature
+description: MyFeature Bidder Adapter
+biddercode: myfeature
+aliasCode: ferio
+gvl_id: none
+usp_supported: true
+gpp_sids: none
+schain_supported: true
+media_types: banner, video, native
+floors_supported: true
+fpd_supported: true
+userIds: all
+pbjs: true
+pbs: false
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+---
+
+## Note
+
+The MyFeature bidder adapter is a client-side alias of the `ferio` adapter and
+requires setup before beginning. Please contact <prebid@ferio.cloud> for more
+information.
+
+User syncs for the alias only run when the publisher enables
+`userSync.aliasSyncEnabled` via `pbjs.setConfig`.
+
+## Prebid.js Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| --------------- | ---------- | ------------------------------------ | ----------------------------------- | ---------- |
+| `publisherId` | required | Publisher ID on the Ferio platform | `'pubwZR87JRDZSf6V'` | `string` |
+| `adUnitId` | required | Ad unit ID on the Ferio platform | `'3855715c-2ceb-4ba5-a876-8c43a987f210'` | `string` |
+| `tenantId` | required | Tenant ID on the Ferio platform | `'myfeature-pbjs'` | `string` |

From aec6ce9236514af9427292cf4f68a0faad1793ca Mon Sep 17 00:00:00 2001
From: jasonc721 <jasonc721@gmail.com>
Date: Wed, 24 Jun 2026 14:42:26 -0600
Subject: [PATCH 664/665] appnexus msft bidder page - Removed the auto redirect
 from Appnexus adpater and other updates (#6639)

* Removed the auto redirect from Appnexus adpater to the MSFT adapter

* fix a link and Markdown lint errors

---------

Co-authored-by: Jason Crane <jasoncrane@microsoft.com>
---
 dev-docs/bidders/appnexus.md | 136 +++++++++++++++++------------------
 dev-docs/bidders/msft.md     |  11 ++-
 2 files changed, 76 insertions(+), 71 deletions(-)

diff --git a/dev-docs/bidders/appnexus.md b/dev-docs/bidders/appnexus.md
index 7056a78dcb..491ecab4c3 100644
--- a/dev-docs/bidders/appnexus.md
+++ b/dev-docs/bidders/appnexus.md
@@ -21,7 +21,7 @@ gvl_id: 32
 sidebarType: 1
 ---
 
-### Table of Contents
+## Table of Contents
 
 - [Table of Contents](#table-of-contents)
   - [Bid Params](#bid-params)
@@ -41,13 +41,13 @@ sidebarType: 1
 <a name="appnexus-bid-params"></a>
 
 {: .alert.alert-danger :}
-Support for the AppNexus adapter will be reduced beginning July 1, 2026, with full deprecation planned for early 2027. To maintain uninterrupted support and access to the latest features, please migrate to the [Microsoft adapter](msft.md).
+Support for the AppNexus adapter will be reduced beginning July 1, 2026, with full deprecation planned for early 2027. To maintain uninterrupted support and access to the latest features, please migrate to the [Microsoft adapter](msft.html).
 
 {: .alert.alert-danger :}
 All AppNexus (Microsoft/Xandr) placements included in a single call to `requestBids` must belong to the same parent Publisher.  If placements from two different publishers are included in the call, the AppNexus bidder will not return any demand for those placements. <br />
 *Note: This requirement does not apply to adapters that are [aliasing](/dev-docs/publisher-api-reference/aliasBidder.html) the AppNexus adapter.*
 
-#### Bid Params
+### Bid Params
 
 {: .alert.alert-danger :}
 Starting with Prebid.js version 9.0, an update was made to the `appnexusBidAdapter.js` file to remove the support for the `transformBidParams` function.  Previously this standard adapter function was used in conjunction of Prebid.js > PBS requests to modify any bid params for that bidder to the bid param format used by the PBS endpoint.  Part of the changes for 9.0 in general were to remove these functions from the client-side adapter files, in order to reduce the build size of Prebid.js for those publishers who wanted to make the PBS requests.  In the case of our adapter, we instead created a new module named `anPspParamsConverter` that would mimic behavior of the `transformBidParams` function.  There's no setup instructions needed on the Prebid.js configs, the module only needs to be included in the Prebid.js build file and it will perform the needed steps.  If you have any questions on this change, please reach out to your Microsoft representative and they can help.
@@ -58,75 +58,75 @@ To avoid breaking changes, the old 'camelCase' format is still currently support
 The table below will reflect both formats, though it's recommended to use the lower-case underscore format where possible going forward (assuming you're using a compatible version of Prebid.js).
 
 {: .table .table-bordered .table-striped }
-| Name                | Scope    | Description                                                                                                                                                                   | Example                                               | Type             |
-|---------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|------------------|
-| `placement_id` (PBS+PBJS) or `placementId` (PBJS)    | required | The placement ID from AppNexus.  You may identify a placement using the `invCode` and `member` instead of a placement ID. This parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. Legacy code can retain the `string` value. **Prebid Server requires an integer value.**                                                    | `234234`                                            | `integer`         |
-| `member`                                        | optional | The member ID  from AppNexus. Must be used with `invCode`.                                                                                                                    | `'12345'`                                             | `string`         |
-| `invCode` or `inv_code`                             | optional | The inventory code from AppNexus. Must be used with `member`.                                                                                                                 | `'abc123'`                                            | `string`         |
-| `publisherId` or `publisher_id`                    | optional | The publisher ID from AppNexus. It is used by the AppNexus end point to identify the publisher when placement id is not provided and `invCode` goes wrong. The `publisherId` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred.                                                                                                                    | `12345`                                             | `integer`         |
-| `frameworks`                                    | optional | Array of integers listing API frameworks for Banner supported by the publisher. | `[1,2]` | `array of integer` |
-| `user`                                          | optional | Object that specifies information about an external user. See [User Object](#appnexus-user-object) for details.                                                               | `user: { age: 25, gender: 0, dnt: true}`              | `object`         |
-| `allowSmallerSizes` or `allow_smaller_sizes`               | optional | If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`.                                                         | `true`                                                | `boolean`        |
-| `usePaymentRule` (PBJS) or `use_pmt_rule` (PBS+PBJS) | optional | If `true`, Appnexus will return net price to Prebid.js after publisher payment rules have been applied.                                                                       | `true`                                                | `boolean`        |
-| `keywords`                                      | optional | A set of key-value pairs applied to all ad slots on the page.  Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the page level. Each tag can have up to 100 additional key/value pairs defined. Values can be empty. See [Passing Keys Without Values](#appnexus-no-value) below for examples. If you want to pass keywords for all adUnits, see [Auction Level Keywords](#appnexus-auction-keywords) for an example. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an AppNexus account manager. | `keywords: { genre: ['rock', 'pop'] }`                | `object`         |
-| `video`                                         | optional | Object containing video targeting parameters.  See [Video Object](#appnexus-video-object) for details.                                                                        | `video: { playback_method: ['auto_play_sound_off'] }` | `object`         |
-| `app`                                           | optional | Object containing mobile app parameters.  See the [App Object](#appnexus-app-object) for details.                                                                      | `app : { id: 'app-id'}`                               | `object`         |
-| `reserve`                                       | optional | Sets a floor price for the bid that is returned. If floors have been configured in the AppNexus Console, those settings will override what is configured here unless 'Reserve Price Override' is checked. See [Microsoft Learn](https://learn.microsoft.com/en-us/xandr/monetize/create-a-floor-rule)                | `0.90`                                                | `float`          |
-| `position`                                      | optional | Identify the placement as above or below the fold.  Allowed values: Unknown: `unknown`; Above the fold: `above`; Below the fold: `below`                                      | `'above'`                                               | `string`        |
-| `trafficSourceCode` or `traffic_source_code`         | optional | Specifies the third-party source of this impression.                                                                                                                          | `'my_traffic_source'`                                 | `string`         |
-| `supplyType` or `supply_type`                      | optional | Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app`                                                                        | `'web'`                                               | `string`         |
-| `pubClick` or `pub_click`                         | optional | Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using AppNexus click tracking properly.                                  | `'http://click.adserver.com/'`                        | `string`         |
-| `extInvCode` or `ext_inv_code`                      | optional | Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged.                           | `'10039'`                                             | `string`         |
-| `externalImpId` or `external_imp_id`                   | optional | Specifies the unique identifier of an externally generated auction.                                                                                                           | `'bacbab02626452b097f6030b3c89ac05'`                  | `string`         |
-| `generate_ad_pod_id`                            | optional | Signal to AppNexus to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS.  | `true`                                                | `boolean`        |
+|Name|Scope|Description|Example|Type|
+|---|---|---|---|---|
+|`placement_id` (PBS+PBJS) or `placementId` (PBJS)|required|The placement ID from AppNexus. You may identify a placement using the `invCode` and `member` instead of a placement ID. This parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred. Legacy code can retain the `string` value. **Prebid Server requires an integer value.**|`234234`|`integer`|
+|`member`|optional|The member ID from AppNexus. Must be used with `invCode`.|'12345'|`string`|
+|`invCode` or `inv_code`|optional|The inventory code from AppNexus. Must be used with `member`.|'abc123'|`string`|
+|`publisherId` or `publisher_id`|optional|The publisher ID from AppNexus. It is used by the AppNexus end point to identify the publisher when placement id is not provided and `invCode` goes wrong. The `publisherId` parameter can be either a `string` or `integer` for Prebid.js, however `integer` is preferred.|12345|`integer`|
+|`frameworks`|optional|Array of integers listing API frameworks for Banner supported by the publisher.|[1,2]|`array of integer`|
+|`user`|optional|Object that specifies information about an external user. See [User Object](#appnexus-user-object) for details.|user: { age: 25, gender: 0, dnt: true }|`object`|
+|`allowSmallerSizes` or `allow_smaller_sizes`|optional|If `true`, ads smaller than the values in your ad unit's `sizes` array will be allowed to serve. Defaults to `false`.|true|`boolean`|
+|`usePaymentRule` (PBJS) or `use_pmt_rule` (PBS+PBJS)|optional|If `true`, Appnexus will return net price to Prebid.js after publisher payment rules have been applied.|true|`boolean`|
+|`keywords`|optional|A set of key-value pairs applied to all ad slots on the page. Mapped to [buy-side segment targeting](https://learn.microsoft.com/en-us/xandr/monetize/segment-targeting) (login required). A maximum of 100 key/value pairs can be defined at the page level. Each tag can have up to 100 additional key/value pairs defined. Values can be empty. See [Passing Keys Without Values](#appnexus-no-value) below for examples. If you want to pass keywords for all adUnits, see [Auction Level Keywords](#appnexus-auction-keywords) for an example. Note that to use keyword with the Prebid Server adapter, that feature must be enabled for your account by an AppNexus account manager.|keywords: { genre: ['rock', 'pop'] }|`object`|
+|`video`|optional|Object containing video targeting parameters. See [Video Object](#appnexus-video-object) for details.|video: { playback_method: ['auto_play_sound_off'] }|`object`|
+|`app`|optional|Object containing mobile app parameters. See the [App Object](#appnexus-app-object) for details.|app : { id: 'app-id' }|`object`|
+|`reserve`|optional|Sets a floor price for the bid that is returned. If floors have been configured in the AppNexus Console, those settings will override what is configured here unless 'Reserve Price Override' is checked. See [Microsoft Learn](https://learn.microsoft.com/en-us/xandr/monetize/create-a-floor-rule)|0.90|`float`|
+|`position`|optional|Identify the placement as above or below the fold. Allowed values: Unknown: `unknown`; Above the fold: `above`; Below the fold: `below`|'above'|`string`|
+|`trafficSourceCode` or `traffic_source_code`|optional|Specifies the third-party source of this impression.|'my_traffic_source'|`string`|
+|`supplyType` or `supply_type`|optional|Indicates the type of supply for this placement. Possible values are `web`, `mobile_web`, `mobile_app`|'web'|`string`|
+|`pubClick` or `pub_click`|optional|Specifies a publisher-supplied URL for third-party click tracking. This is just a placeholder into which the publisher can insert their own click tracker. This parameter should be used for an unencoded tracker. This parameter is expected to be the last parameter in the URL. Please note that the click tracker placed in this parameter will only fire if the creative winning the auction is using AppNexus click tracking properly.|[http://click.adserver.com/](http://click.adserver.com/)|`string`|
+|`extInvCode` or `ext_inv_code`|optional|Specifies predefined value passed on the query string that can be used in reporting. The value must be entered into the system before it is logged.|'10039'|`string`|
+|`externalImpId` or `external_imp_id`|optional|Specifies the unique identifier of an externally generated auction.|'bacbab02626452b097f6030b3c89ac05'|`string`|
+|`generate_ad_pod_id`|optional|Signal to AppNexus to split impressions by ad pod and add unique ad pod id to each request. Specific to long form video endpoint only. Supported by Prebid Server, not Prebid JS.|true|`boolean`|
 
 <a name="appnexus-video-object"></a>
 
-#### Video Object
+### Video Object
 
 For details on how these video params work with the params set in the adUnit.mediaTypes.video object, see [Video Bid params and Video MediaTypes params](#appnexus-video-params) section below.
 
 {: .table .table-bordered .table-striped }
-| Name              | Description                                                                                                                                                                                                                                  | Type             |
-|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
-| `minduration` | Integer that defines the minimum video ad duration in seconds. | `integer` |
-| `maxduration` | Integer that defines the maximum video ad duration in seconds. | `integer` |
-|`context` | A string that indicates the type of video ad requested.  Allowed values: `"pre_roll"`; `"mid_roll"`; `"post_roll"`; `"outstream"`; `"in-banner"`, `"in-feed"`, `"interstitial"`, `"accompanying_content_pre_roll"`, `"accompanying_content_mid_roll"`, `"accompanying_content_post_roll"`. | `string` |
-| `skippable` | Boolean which, if `true`, means the user can click a button to skip the video ad.  Defaults to `false`. | `boolean` |
-|`skipoffset`| Integer that defines the number of seconds until an ad can be skipped.  Assumes `skippable` setting was set to `true`. | `integer` |
-| `playback_method` | A string that sets the playback method supported by the publisher.  Allowed values: `"auto_play_sound_on"`; `"auto_play_sound_off"`; `"click_to_play"`; `"mouse_over"`; `"auto_play_sound_unknown"`. | `string` |
-| `frameworks` | Array of integers listing API frameworks supported by the publisher.  Allowed values: None: `0`; VPAID 1.0: `1`; VPAID 2.0: `2`; MRAID 1.0: `3`; MRAID 2.0: `4`; ORMMA: `5`; OMID 1.0 `6`. | `Array<integer>` |
+|Name|Description|Type|
+|---|---|---|
+|`minduration`|Integer that defines the minimum video ad duration in seconds.|`integer`|
+|`maxduration`|Integer that defines the maximum video ad duration in seconds.|`integer`|
+|`context`|A string that indicates the type of video ad requested. Allowed values: "pre_roll"; "mid_roll"; "post_roll"; "outstream"; "in-banner", "in-feed", "interstitial", "accompanying_content_pre_roll", "accompanying_content_mid_roll", "accompanying_content_post_roll".|`string`|
+|`skippable`|Boolean which, if `true`, means the user can click a button to skip the video ad. Defaults to `false`.|`boolean`|
+|`skipoffset`|Integer that defines the number of seconds until an ad can be skipped. Assumes `skippable` setting was set to `true`.|`integer`|
+|`playback_method`|A string that sets the playback method supported by the publisher. Allowed values: "auto_play_sound_on"; "auto_play_sound_off"; "click_to_play"; "mouse_over"; "auto_play_sound_unknown".|`string`|
+|`frameworks`|Array of integers listing API frameworks supported by the publisher. Allowed values: None: `0`; VPAID 1.0: `1`; VPAID 2.0: `2`; MRAID 1.0: `3`; MRAID 2.0: `4`; ORMMA: `5`; OMID 1.0 `6`.|`Array<integer>`|
 
 <a name="appnexus-user-object"></a>
 
-#### User Object
+### User Object
 
 {: .table .table-bordered .table-striped }
-| Name              | Description                                                                                                                     | Example                                                                  | Type             |
-|-------------------|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|------------------|
-| `age`             | The age of the user.                                                                                                            | `35`                                                                     | `integer`        |
-| `externalUid` or `external_uid`    | Specifies a string that corresponds to an external user ID for this user.                                                       | `'1234567890abcdefg'`                                                    | `string`         |
-| `segments`        | Specifies the segments to which the user belongs.                                                                               | `[1, 2]`                                                                 | `Array<integer>` |
-| `gender`          | Specifies the gender of the user.  Allowed values: Unknown: `0`; Male: `1`; Female: `2`                                         | `1`                                                                      | `integer`        |
-| `dnt`             | Do not track flag.  Indicates if tracking cookies should be disabled for this auction                                           | `true`                                                                   | `boolean`        |
-| `language`        | Two-letter ANSI code for this user's language.                                                                                  | `EN`                                                                     | `string`         |
+|Name|Description|Example|Type|
+|---|---|---|---|
+|`age`|The age of the user.|`35`|`integer`|
+|`externalUid` or `external_uid`|Specifies a string that corresponds to an external user ID for this user.|'1234567890abcdefg'|`string`|
+|`segments`|Specifies the segments to which the user belongs.|[1, 2]|`Array<integer>`|
+|`gender`|Specifies the gender of the user. Allowed values: Unknown: `0`; Male: `1`; Female: `2`|1|`integer`|
+|`dnt`|Do not track flag. Indicates if tracking cookies should be disabled for this auction|true|`boolean`|
+|`language`|Two-letter ANSI code for this user's language.|EN|`string`|
 
 <a name="appnexus-app-object"></a>
 
-#### App Object
+### App Object
 
 AppNexus supports using prebid within a mobile app's webview. If you are interested in using an SDK, please see [Prebid Mobile]({{site.baseurl}}/prebid-mobile/prebid-mobile.html) instead.
 
 {: .table .table-bordered .table-striped }
-| Name              | Description                                                                                                                     | Example                                                                  | Type             |
-|-------------------|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|------------------|
-| `id`              | The App ID.                                                                                                                     | `'B1O2W3M4AN.com.prebid.webview'`                                        | `string`         |
-| `device_id`       | Object that contains the advertising identifiers of the user (`idfa`, `aaid`, `md5udid`, `sha1udid`, or `windowsadid`).         | `{ aaid: "38400000-8cf0-11bd-b23e-10b96e40000d" }`                       | `object`         |
-| `geo`             | Object that contains the latitude (`lat`) and longitude (`lng`) of the user.                                                    | `{ lat: 40.0964439, lng: -75.3009142 }`                                  | `object`         |
+|Name|Description|Example|Type|
+|---|---|---|---|
+|`id`|The App ID.|'B1O2W3M4AN.com.prebid.webview'|`string`|
+|`device_id`|Object that contains the advertising identifiers of the user (`idfa`, `aaid`, `md5udid`, `sha1udid`, or `windowsadid`).|{ aaid: "38400000-8cf0-11bd-b23e-10b96e40000d" }|`object`|
+|`geo`|Object that contains the latitude (`lat`) and longitude (`lng`) of the user.|{ lat: 40.0964439, lng: -75.3009142 }|`object`|
 
 <a name="custom-targeting-keys"></a>
 
-#### Custom Targeting keys
+### Custom Targeting keys
 
 AppNexus returns custom keys that can be sent to the adserver through bidderSettings: buyerMemberId, dealPriority, and dealCode. The following snippet demonstrates how to add these custom keys as key-value pairs.
 
@@ -158,7 +158,7 @@ pbjs.bidderSettings = {
 
 <a name="appnexus-video-params"></a>
 
-#### Video Bid params and Video MediaTypes params
+### Video Bid params and Video MediaTypes params
 
 It is possible to have setup video params within the adUnit's AppNexus bid object as well as in the adUnit's `mediaTypes.video` object.  In this case, there is a set of logic that the AppNexus bid adapter follows to resolve which values should be passed along to the ad server request.  Generally speaking, the adapter prefers the values from bid param video object over the mediaTypes video object, in order to preserve historical setups.  So for instance, if the playbackmethod field was set in both locations, then the bid params `playback_method` would be chosen over the mediaTypes `playbackmethod`.  If there are different fields set between the two locations and they don't overlap, then the `mediaTypes.video` params would be included along with the bid params.
 
@@ -168,7 +168,7 @@ If you want to transition from video bid params to use the `mediaTypes.video` pa
 
 <a name="appnexus-auction-keywords"></a>
 
-#### Auction Level Keywords
+### Auction Level Keywords
 
 It's possible to pass a set of keywords for the whole request, rather than a particular adUnit.  Though they would apply to all adUnits (which include the appnexus bidder) in an auction, these keywords can work together with the bidder level keywords (if for example you want to have specific targeting for a particular adUnit).
 
@@ -187,7 +187,7 @@ Like in the bidder.params.keywords, the values here can be empty.  Please see th
 
 <a name="appnexus-no-value"></a>
 
-#### Passing Keys Without Values
+### Passing Keys Without Values
 
 It's possible to use the `keywords` parameter to define keys that do not have any associated values. Keys with empty values can be created in Prebid.js and can also be sent through Prebid Server to AppNexus. The following are examples of sending keys with empty values:
 
@@ -211,7 +211,7 @@ keywords: {
 
 <a name="appnexus-fpd"></a>
 
-#### First Party Data
+### First Party Data
 
 Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).
 
@@ -221,22 +221,22 @@ PBS/PSP supports all first party data fields: site, user, segments, and imp-leve
 
 <a name="appnexus-amp"></a>
 
-#### User Sync in AMP
+### User Sync in AMP
 
 If you are syncing user id's with Prebid Server and are using AppNexus' managed service, see [AMP Implementation Guide cookie-sync instructions](/dev-docs/show-prebid-ads-on-amp-pages.html#user-sync) for details.
 
-<a name="appnexus-debug-auction"></a>
-
-#### Mobile App Display Manager Version
+### Mobile App Display Manager Version
 
 The AppNexus endpoint expects `imp.displaymanagerver` to be populated for mobile app sources
 requests, however not all SDKs will populate this field. If the `imp.displaymanagerver` field
 is not supplied for an `imp`, but `request.app.ext.prebid.source`
 and `request.app.ext.prebid.version` are supplied, the adapter will fill in a value for
-`diplaymanagerver`. It will concatenate the two `app` fields as `<source>-<version>` fo fill in
+`displaymanagerver`. It will concatenate the two `app` fields as `<source>-<version>` to fill in
 the empty `displaymanagerver` before sending the request to AppNexus.
 
-#### Debug Auction
+<a name="appnexus-debug-auction"></a>
+
+### Debug Auction
 
 {: .alert.alert-danger :}
 Enabling the AppNexus Debug Auction feature should only be done for diagnosing the AppNexus auction. Do not enable this feature in a production setting where it may impact users.
@@ -250,14 +250,14 @@ To understand what is happening behind the scenes during an auction, you can ena
 To view the results of the debug auction, add the `pbjs_debug=true` query string parameter and open your browser's developer console.
 
 {: .table .table-bordered .table-striped }
-| Name              | Description                                                     | Example               | Type             |
-|-------------------|-----------------------------------------------------------------|-----------------------|------------------|
-| `enabled`         | Toggle the debug auction to occur                               | `true`                | `boolean`        |
-| `dongle`          | Your account's unique debug password.                           | `QWERTY`              | `string`         |
-| `member_id`       | The ID of the member running the debug auction                  | `958`                 | `integer`        |
-| `debug_timeout`   | The timeout for the debug auction results to be returned        | `3000`                | `integer`        |
-
-#### Prebid Server Test Request
+|Name|Description|Example|Type|
+|---|---|---|---|
+|`enabled`|Toggle the debug auction to occur|`true`|`boolean`|
+|`dongle`|Your account's unique debug password.|`QWERTY`|`string`|
+|`member_id`|The ID of the member running the debug auction|`958`|`integer`|
+|`debug_timeout`|The timeout for the debug auction results to be returned|`3000`|`integer`|
+
+### Prebid Server Test Request
 
 The following test parameters can be used to verify that Prebid Server is working properly with the
 server-side Appnexus adapter. This example includes an `imp` object with an Appnexus test placement ID and sizes
diff --git a/dev-docs/bidders/msft.md b/dev-docs/bidders/msft.md
index 7ac9299287..457e9d171d 100644
--- a/dev-docs/bidders/msft.md
+++ b/dev-docs/bidders/msft.md
@@ -2,8 +2,6 @@
 layout: bidder
 title: Microsoft
 description: Prebid Microsoft Bidder Adaptor
-redirect_from: 
-- /dev-docs/bidders/appnexus.html
 biddercode: msft
 media_types: banner, video, native
 tcfeu_supported: true
@@ -116,7 +114,14 @@ If you are migrating from the AppNexus bid adapter and your Ad Server Line Items
 
 If you are migrating from the AppNexus bid adapter, the setup for Native adUnits now require the use of the Prebid.js ORTB Native setup.  The Microsoft Bid Adapter **no longer offers support** to the legacy Prebid.js Native adUnit setup.  
 
-Requests using that legacy approach will **NOT** work and will need to be converted to the equivalent values in the adUnit.  This change is made to better align with Prebid.js and many other Bid Adapters that support Native in an ORTB context.
+Requests using that legacy approach will NOT work and will need to be converted to the equivalent values in the adUnit. This change is made to better align with Prebid.js and many other Bid Adapters that support Native in an ORTB context.
+
+In addition, all Native requests must follow the OpenRTB Native 1.2 specification and explicitly include eventtrackers, with at least:
+
+- Event Type 1 (Impression)
+- Event Type 2 (Viewable MRC / Viewability)
+
+This ensures proper tracking, measurement alignment, and compatibility with Microsoft demand expectations. Implementations that do not include these eventtrackers may lead to limited demand or reporting gaps.
 
 Please refer to the [Prebid.js Native Implementation Guide](https://docs.prebid.org/prebid/native-implementation.html) if you need additional information to implement the Native ORTB setup.
 

From fabd039095fc0192fe89977d01a56228d55be1bf Mon Sep 17 00:00:00 2001
From: kazutoshi-uekawa-muneee
 <114455471+kazutoshi-uekawa-muneee@users.noreply.github.com>
Date: Thu, 25 Jun 2026 15:08:28 +0900
Subject: [PATCH 665/665] docs: add imuid userId support to UNIQUEST adapters
 (#6635)

* docs: add imuid userIds to Uniquest adapters

* fix: resolve markdownlint errors in UNIQUEST adapter docs
---
 dev-docs/bidders/uniquest.md       | 12 +++++++-----
 dev-docs/bidders/uniquestWidget.md | 14 ++++++++------
 2 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/dev-docs/bidders/uniquest.md b/dev-docs/bidders/uniquest.md
index c82f8a45b2..913a378c74 100644
--- a/dev-docs/bidders/uniquest.md
+++ b/dev-docs/bidders/uniquest.md
@@ -23,14 +23,16 @@ dsa_supported: false
 fpd_supported: false
 multiformat_supported: none
 privacy_sandbox: none
+userIds: imuid
 ---
 
-### Registration
-To use this bidder you will need with UNIQUEST. For further information, Please contact us at <prebid_info@muneee.co.jp>.
+## Registration
+To use this bidder you will need to work with UNIQUEST. For further information, Please contact us at <prebid_info@muneee.co.jp>.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name | Scope    | Description | Example  | Type     |
-|-------|----------|---------------------------|----------|----------|
+
+| Name  | Scope    | Description                 | Example      | Type     |
+|-------|----------|-----------------------------|--------------|----------|
 | `sid` | required | The AdUnit ID from UNIQUEST | `'SID00001'` | `string` |
diff --git a/dev-docs/bidders/uniquestWidget.md b/dev-docs/bidders/uniquestWidget.md
index bdfd798484..50d26c0839 100644
--- a/dev-docs/bidders/uniquestWidget.md
+++ b/dev-docs/bidders/uniquestWidget.md
@@ -2,7 +2,7 @@
 layout: bidder
 title: UNIQUEST Widget
 description: Prebid UNIQUEST Widget Bidder Adapter
-biddercode : uniquest_widget
+biddercode: uniquest_widget
 pbjs: true
 media_types: banner
 sidebarType: 1
@@ -23,14 +23,16 @@ dsa_supported: false
 fpd_supported: false
 multiformat_supported: none
 privacy_sandbox: none
+userIds: imuid
 ---
 
-### Registration
-To use this bidder you will need with UNIQUEST Widget. For further information, Please contact us at <prebid_info@muneee.co.jp>.
+## Registration
+To use this bidder you will need to work with UNIQUEST Widget. For further information, Please contact us at <prebid_info@muneee.co.jp>.
 
-### Bid Params
+## Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name | Scope    | Description | Example  | Type     |
-|-------|----------|---------------------------|----------|----------|
+
+| Name  | Scope    | Description                    | Example      | Type     |
+|-------|----------|--------------------------------|--------------|----------|
 | `wid` | required | The Ad ID from UNIQUEST Widget | `'WID00001'` | `string` |