Merge branch 'master' into cleanAdtDocs

README.md

@@ -1,3 +1,5 @@
+# docs.prebid.org source
+
 This repository contains the source files for the Prebid.js documentation site at [Prebid.org](https://prebid.org).
 
 Please see the sections below for more information:
@@ -35,13 +37,13 @@ All docs are under the license shown in the `LICENSE` file in this directory.
 
 The site is hosted on GitHub pages, and uses [Jekyll](https://jekyllrb.com/) to generate the HTML. Jekyll is written in the [Ruby](https://www.ruby-lang.org/en/) language.
 
-1. follow the instructions at https://jekyllrb.com/docs/installation/ for your OS
+1. follow the instructions at [jekyllrb.com/docs/installation/](https://jekyllrb.com/docs/installation/) for your OS
 1. gem install github-pages
 1. start Jekyll as described below
 
 For CSS, the site uses Laravel Mix to build CSS from Sass (scss-flavored) source files. Under the hood Laravel Mix uses Webpack.
 
-1. follow the instructions at https://nodejs.dev to install Node.js for your OS
+1. follow the instructions at [/nodejs.dev](https://nodejs.dev) to install Node.js for your OS
 1. `npm ci` to install packages for building assets
 1. build assets as described below
 
@@ -106,6 +108,10 @@ This means an adaptor is not available to download from Prebid.org as soon as th
 
 <a name="thanks"></a>
 
+## Liquid Templating
+
+* [jekyll - check for non empty](https://michaelcurrin.github.io/dev-cheatsheets/cheatsheets/jekyll/liquid/conditionals/non-empty.html)
+
 ## Thanks
 
 Many thanks to the following people who have submitted content to Prebid.org.  We really appreciate the help!

_data/sidebar.yml

@@ -1492,7 +1492,6 @@
   sectionTitle:
   subgroup: 3
 
-
 - sbSecId: 5
   title: Modules
   link: /prebid-server/pbs-modules/
@@ -1542,6 +1541,14 @@
   sectionTitle:
   subgroup: 5
 
+- sbSecId: 5
+  title: Building a Privacy Module
+  link: /prebid-server/developers/add-a-privacy-module.html
+  isHeader: 0
+  isSectionHeader: 0
+  sectionTitle:
+  subgroup: 5
+
 - sbSecId: 5
   title: Code Reviews
   link: /prebid-server/developers/code-reviews.html

_includes/dev-docs/loads-external-javascript.md

@@ -0,0 +1,2 @@
+{: .alert.alert-warning :}
+Disclosure: This module loads external code that is not open source and has not been reviewed by Prebid.org.

_layouts/bidder.html

@@ -78,7 +78,7 @@ <h3>Features</h3>
                     <th class="pbTh">Demand Chain Support</th>
                     <td class="pbTd">{% if page.dchain_supported == true %}yes{% elsif page.dchain_supported == false %}no{% else %}check with bidder{% endif %}</td>
                     <th class="pbTh">GPP Support</th>
-                    <td class="pbTd">{% if page.gpp_supported == true %}yes{% elsif page.gpp_supported == false %}no{% else %}check with bidder{% endif %}</td>
+                    <td class="pbTd">{% if page.gpp_sids and page.gpp_sids != '' %}{{page.gpp_sids}}{% 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 %}</td>
                   </tr>
                   <tr>
                     <th class="pbTh">Supports Deals</th>
@@ -108,7 +108,7 @@ <h3>Features</h3>
                     <th class="pbTh">Safeframes OK</th>
                     <td class="pbTd">{% if page.safeframes_ok == false %}no{% elsif page.safeframes_ok == true %}yes{% else %}check with bidder{% endif %}</td>
                     <th class="pbTh"></th>
-            <td class="pbTd"></td>
+                    <td class="pbTd"></td>
                   </tr>
                 </table>
 

adops/gam-creative-banner-sbs.md

@@ -65,6 +65,9 @@ Be sure to replace BIDDERCODE with the appropriate bidder. For example, if the b
 </script>
 ```
 
+{: .alert.alert-info :}
+Note: the `mobileResize` parameter is a workaround to a bug in the Google Mobile Ads SDK. The Prebid SDK uses the existence of the "hb_size" string that's provided in %%PATTERN:TARGETINGMAP%%, but this bidder-specific version of the creative doesn't utilize the TARGETINGMAP, so the value is added here. The important part is the value that contains `hb_size:`.
+
 {: .alert.alert-danger :}
 Warning: Be sure none of the attribute names are longer than 20 characters. See [Send All Bids Key Value Pairs](/adops/send-all-vs-top-price.html#key-value-pairs) for more information.
 

adops/key-values.md

@@ -41,7 +41,7 @@ You can work with your engineers to modify the default list. See [Restricting Da
 | hb_deal | targeting | All | Target private marketplace deals | 7777777 |
 | hb_uuid | rendering | Video only | Carries the cache retrieval ID for VAST video creatives | 1111-2222-3333-4444 |
 | hb_cache_id | rendering | Banner, native, outstream; mobile app only | Carries the cache retrieval ID for mobile bids | 2222-3333-4444-5555 |
-| hb_cache_host | rendering | Banner, native, outstream; mobile app only | The host where the cached creative lives | <https://mycachehost.example.com> |
+| hb_cache_host | rendering | Banner, native, outstream; mobile app only | The host where the cached creative lives | `"https://mycachehost.example.com"` |
 | hb_cache_path | rendering | Banner, native, outstream; mobile app only | The web path where the cached creative lives | /cache |
 | hb_source | reporting | Server-to-server testing | Used to report the A/B test results for client- vs server-side performance. | s2s |
 | hb_adomain | reporting and special | All | Used to report on VAST errors, set floors on certain buyers, monitor volume from a buyer, or track down bad creatives | example.com |

adops/setting-up-prebid-video-in-freewheel.md

@@ -127,8 +127,12 @@ In order for FreeWheel SDK to send the correct Creative to the video player it n
 
 To ensure the cache URL is correct there are two macros that dynamically  populate the URL query. To confirm the dynamic URL is formatted correctly click on the URL link in the Detail field. A pop over will display with the dynamic URL.  
 
-The scheme, host, and path should read as follows:
-<https://prebid.adnxs.com/pbc/v1/cache>
+The scheme, host, and path should point to your Prebid Server cache. For instance, if you
+utilize Xandr's AppNexus cache:
+
+```text
+https://prebid.adnxs.com/pbc/v1/cache
+```
 
 The query should have one key-value items:
 

adops/setting-up-prebidjs-with-Smart-Ad-Server.md

@@ -69,5 +69,4 @@ For more details, read [here](https://support.smartadserver.com/s/article/Holist
 
 Read these articles to learn more about the available header bidding reporting:
 
-- [Holistic Dashboard](https://support.smartadserver.com/s/article/Holistic-dashboard) - provides a fast and easy overview of basic metrics by delivery channel and RTB product.
 - [Big Data Reports](https://support.smartadserver.com/s/article/Holistic-Setup#bdr) - provides full, in-depth reporting with header bidding related dimensions and metrics.

dev-docs/activity-controls.md

@@ -218,7 +218,7 @@ These are the parameters available to the condition function:
 | `componentName` | String | All activities | Name of the component; this is (depending on the type) either a bidder code, user ID or RTD submodule name, analytics provider code, or module name. |
 | `component`     | String | All activities | This is always a dot-separated concatenation of `componentType` and `componentName`; for example, with `{componentType: 'bidder', componentName: 'bidderX'}`, `component` is `'bidder.bidderX'`. |
 | `adapterCode`   | String | All activities | If `componentType` is `'bidder'`, and `componentName` is an [alias](/dev-docs/publisher-api-reference/aliasBidder.html), then `adapterCode` is the bidder code that was aliased; or identical to `componentName` if the bidder is not an alias. This is undefined when the component is not a bidder.|
-| `configName`    | String | <a id="params-fetchBids"></a> `fetchBids`    | When the Prebid Server adapter is part of an auction, this is the name given to its [s2s configuration](/dev-docs/modules/prebidServer.md), if any. |
+| `configName`    | String | <a id="params-fetchBids"></a> `fetchBids`    | When the Prebid Server adapter is part of an auction, this is the name given to its [s2s configuration](/dev-docs/modules/prebidServer.html), if any. |
 | `storageType`   | String | <a id="params-accessDevice"></a> `accessDevice` | Either `'html5'` or `'cookie'` - the device storage mechanism being accessed. |
 | `syncType`      | String | <a id="params-syncUser"></a> `syncUser`     | Either `'iframe'` or `'image'` - the type of user sync. |
 | `syncUrl`       | String | `syncUser`     | URL of the user sync. |

dev-docs/adfusion.md

@@ -0,0 +1,35 @@
+---
+layout: bidder
+title: AdFusion
+biddercode: adfusion 
+tcfeu_supported: true
+gvl_id: 844
+usp_supported: false
+coppa_supported: false
+gpp_supported: false
+schain_supported: false
+dchain_supported: false
+safeframes_ok: false
+deals_supported: true
+userId: all
+media_types: display, video
+floors_supported: true
+fpd_supported: false
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-bid-on-one
+ortb_blocking_supported: true
+sidebarType: 1
+---
+
+### Note
+
+The AdFusion Bidding adapter requires setup from the AdFusion team. Please contact us at [prebid@adfusion.pl](mailto:prebid@adfusion.pl).
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+|---------------|----------|-----------------------|-----------|-----------|
+| `accountId` | required | The account ID provided by AdFusion | `1234` | `number` |

dev-docs/adunit-reference.md

@@ -166,8 +166,9 @@ When using the Video Module, the mediaTypes.video properties get filled out auto
 * [Banner](#adUnit-banner-example)
 * [Video](#adUnit-video-example)  
   * [With the Video Module](#adUnit-video-module-example)
-  * [Instream](#adUnit-video-example-instream)  
-  * [Outstream](#adUnit-video-example-outstream)  
+  * [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)
@@ -233,7 +234,7 @@ pbjs.addAdUnits({
 
 <a name="adUnit-video-example-instream"></a>
 
-#### Instream
+#### Instream Sound-On
 
 For an example of an instream video ad unit that you handle on your own, see below. For more detailed instructions, see [Show Video Ads]({{site.baseurl}}/dev-docs/show-video-with-a-dfp-video-tag.html).
 
@@ -243,10 +244,40 @@ pbjs.addAdUnits({
     mediaTypes: {
         video: {
             context: 'instream',
+            plcmt: 1,
             playerSize: [640, 480],
             mimes: ['video/mp4'],
             protocols: [1, 2, 3, 4, 5, 6, 7, 8],
-            playbackmethod: [2],
+            playbackmethod: [5],
+            skip: 1
+        },
+    },
+    bids: [{
+        bidder: 'appnexus',
+        params: {
+            placementId: 13232361
+        }
+    }]
+});
+```
+
+<a name="adUnit-video-example-accompanying"></a>
+
+#### Player contains video content with sound off
+
+The IAB calls this scenario "Accompanying Content". Previously, this might have been called "instream with sound-off", but as of April 2023, the IAB has reclassified this scenario.
+
+```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
         },
     },
@@ -261,7 +292,9 @@ pbjs.addAdUnits({
 
 <a name="adUnit-video-example-outstream"></a>
 
-#### Outstream
+#### Standalone ad wit no video content
+
+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).
 
@@ -271,8 +304,11 @@ pbjs.addAdUnits({
     mediaTypes: {
         video: {
             context: 'outstream',
-            useCacheKey: false,
-            playerSize: [640, 480]
+            plcmt: 4,
+            playerSize: [640, 480],
+            mimes: ['video/mp4'],
+            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+            playbackmethod: [6],
         }
     },
     renderer: {
@@ -296,8 +332,12 @@ pbjs.addAdUnits({
     mediaTypes: {
         video: {
             context: 'outstream',
+            plcmt: 4,
+            playerSize: [640, 480],
+            mimes: ['video/mp4'],
+            protocols: [1, 2, 3, 4, 5, 6, 7, 8],
+            playbackmethod: [6],
             useCacheKey: true,
-            playerSize: [640, 480]
         }
     },
     renderer: {

dev-docs/analytics-ga.md

@@ -18,6 +18,8 @@ nav_section: reference
 * TOC
 {:toc }
 
+## Notice: Deleted in Prebid 8 with the deprecation of GA by Google
+
 ## Code Example
 
 ```javascript

dev-docs/analytics/adagio.md

@@ -4,8 +4,23 @@ title: Adagio
 description: Adagio Analytics Adapter
 modulecode: adagio
 prebid_member: true
+tcfeu_supported: true
+usp_supported: true
+coppa_supported: true
+gvl_id: 617
+enable_download: true
 ---
 
 #### Registration
 
-Please visit [adagio.io](https://adagio.io/) for more information.
+The Adagio Analytics adapter requires setup and approval from the Adagio team. Please reach out to <contact@adagio.io> for more information.
+
+#### Example Configuration
+
+```js
+  pbjs.que.push(function () {
+    pbjs.enableAnalytics({
+      provider: 'adagio',
+    });
+  });
+```

dev-docs/analytics/nobid.md

@@ -4,7 +4,7 @@ title: NoBid
 description: NoBid Analytics Adaptor
 modulecode: nobidAnalytics
 gvl_id: 816
-enable_download: false
+enable_download: true
 ---
 
 #### Registration

dev-docs/bidder-adaptor.md

@@ -1282,7 +1282,7 @@ registerBidder(spec);
     * If you support one or more userId modules, add `userId: (list of supported vendors)`. No default value.
     * If you support video and/or native mediaTypes add `media_types: video, native`. Note that display is added by default. If you don't support display, add "no-display" as the first entry, e.g. `media_types: no-display, native`. No default value.
     * If you support the COPPA flag, add `coppa_supported: true`. Default is false.
-    * If you support the IAB's GPP consent string, add `gpp_supported: true`. Default is false.
+    * If you support the IAB's GPP consent string, add `gpp_sids` with a comma separated list of section names, e.g. `gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp`. Default is None.
     * If you support the [supply chain](/dev-docs/modules/schain.html) feature, add `schain_supported: true`. Default is false.
     * If you support passing a demand chain on the response, add `dchain_supported: true`. Default is false.
     * If your bidder doesn't work well with safeframed creatives, add `safeframes_ok: false`. This will alert publishers to not use safeframed creatives when creating the ad server entries for your bidder. No default value.
@@ -1308,7 +1308,7 @@ tcfeu_supported: true/false
 gvl_id: none
 usp_supported: true/false
 coppa_supported: true/false
-gpp_supported: true/false
+gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp
 schain_supported: true/false
 dchain_supported: true/false
 userId: (list of supported vendors)

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
 {% 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_supported == true %}yes{% elsif page.gpp_supported == false %}no{% 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 %}
+"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}}{% 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 %}
 {% endfor %}