Merge branch 'master' into master

duancg · web-flow · commit ea519d016aa5 · 2025-03-17T09:16:46.000-07:00
diff --git 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/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`  |
diff --git 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/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
 
diff --git 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. |
diff --git 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.
