Merge branch 'prebid:master' into master

dev-docs/bidder-adaptor.md

@@ -371,8 +371,8 @@ There are a number of important values that a publisher expects to be handled in
 | Parameter | Description                                   | Example               |
 | ----- | ------------ | ---------- |
 | Ad Server Currency | If your endpoint supports responding in different currencies, read this value. | config.getConfig('currency.adServerCurrency') |
-| Bidder Timeout | Use if your endpoint needs to know how long the page is allowing the auction to run. | config.getConfig('bidderTimeout'); |
-| COPPA | If your endpoint supports the Child Online Privacy Protection Act, you should read this value. | config.getConfig('coppa'); |
+| Bidder Timeout | Use if your endpoint needs to know how long the page is allowing the auction to run. | bidderRequest.timeout; |
+| COPPA | If your endpoint supports the Child Online Privacy Protection Act, you should read this value. | bidderRequest.ortb2.regs.coppa; |
 | First Party Data | The publisher, as well as a number of modules, may provide [first party data](/features/firstPartyData.html) (e.g. page type). | bidderRequest.ortb2; validBidRequests[].ortb2Imp|
 | Floors | Adapters that accept a floor parameter must also support the [floors module](https://docs.prebid.org/dev-docs/modules/floors.html) | [`bidRequest.getFloor()`](/dev-docs/modules/floors.html#bid-adapter-interface) |
 | Page URL and referrer | Instead of building your own function to find the page location, domain, or referrer, look in the standard bidRequest location. | bidderRequest.refererInfo.page |

dev-docs/bidders/adbutler.md

@@ -0,0 +1,27 @@
+---
+layout: bidder
+title: AdButler
+description: AdButler Bid Adapter
+biddercode: adbutler
+pbjs: true
+sidebarType: 1
+media_types: banner
+safeframes_ok: true
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+---
+
+### Bid params
+
+{: .table .table-bordered .table-striped }
+
+| Name        | Scope    | Description                                                                                                  | Example                       | Type          |
+|-------------|----------|--------------------------------------------------------------------------------------------------------------|-------------------------------|---------------|
+| `accountID` | required | Account ID                                                                                                   | `'181556'`                    | `string`      |
+| `zoneID`    | required | Zone ID                                                                                                      | `'705374'`                    | `string`      |
+| `domain`    | optional | Ad serving domain (set if using custom domains)                                                              | `'servedbyadbutler.com'`      | `string`      |
+| `keyword`   | optional | Keyword(s) used for custom targeting                                                                         | `'green,orange'`              | `string`      |
+| `minCPM`    | optional | Minimum CPM value to accept                                                                                  | `'1.00'`                      | `string`      |
+| `maxCPM`    | optional | Maximum CPM value to accept                                                                                  | `'5.00'`                      | `string`      |
+| `extra`     | optional | Other ad request parameters [(API Docs)](https://www.adbutler.com/docs/api/#tag/AdServe/paths/~1adserve/get) | `{ _abdk: { bird: "duck" } }` | `object`      |

dev-docs/bidders/adnuntius.md

@@ -24,6 +24,7 @@ sidebarType: 1
 |-------------|----------|----------------------------------------------------------------------|----------|----------|
 | `auId` | required | The ad unit ID `'0000000000072345'` leading zeros can be omitted. | `'0000000000072345'` | `string` |
 | `network` | optional | Used if you want to make requests to multiple networks in adnuntius. | `'adnuntius'` | `string`|
+| `userId` | optional | Allows you to set a specific user id in the request. | `'userId'` | `string`|
 | `targeting` | optional | Targeting to be sent through to adnuntius with the request. | `{ c: ['prebids'] }` | `string`|
 | `maxDeals` | optional | The maximum number of deal bids to include. Default 0. | `1` | `Integer` |
 | `bidType` | optional | Whether to use `grossBid` or `netBid` from the server response as the cpm bid. Default is `grossBid`. | `grossBid` | `string` |
@@ -52,6 +53,7 @@ Here's an example of sending targeting information about categories to adnuntius
             "params": {
                 "auId": "8b6bc",
                 "network": "adnuntius",
+                "userId": "<USERID>",
                 "targeting": {
                     "c": ["prebids"]
                 }

dev-docs/bidders/adstir.md

@@ -23,7 +23,9 @@ sidebarType: 1
 
 ### Note
 
-The adstir Bidding adapter requires setup before beginning. Please contact us at [[email protected]](mailto:[email protected])
+The adstir Bidding adapter is available from Prebid.js version 8.24.0 and above.
+
+It requires setup before beginning. Please contact us at [[email protected]](mailto:[email protected])
 
 ### Bid Params
 

dev-docs/bidders/aja.md

@@ -8,7 +8,7 @@ biddercode: aja
 media_types: banner
 tcfeu_supported: false
 floors_supported: false
-schain_supported: false
+schain_supported: true
 dchain_supported: false
 usp_supported: false
 gpp_supported: false

dev-docs/bidders/blockthrough.md

@@ -0,0 +1,94 @@
+---
+layout: bidder
+title: Blockthrough
+description: Prebid BT Bidder Adapter
+biddercode: blockthrough
+gvl_id: 815
+usp_supported: true
+coppa_supported: false
+gpp_sids: usp
+schain_supported: true
+dchain_supported: false
+userId: pubProvidedId, id5Id, criteo, sharedId, identityLink, unifiedId, userId
+media_types: banner
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: true
+multiformat_supported: will-not-bid
+ortb_blocking_supported: false
+sidebarType: 1
+---
+
+### Note
+
+The BT Bid Adapter makes requests to the BT Server which supports OpenRTB.
+
+Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html). The BT adapter requires setup and approval from the Blockthrough team. Please reach out to [[email protected]](mailto:[email protected]) for more information.
+
+### Prebid JS
+
+#### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| -------- | -------- | --------------------------- | ------- | --------- |
+| `bidderCode` | required | Bidder configuration. Could configure several bidders this way. | `bidderA: {publisherId: 55555}` | `object` |
+
+#### Bid Config
+
+Make sure to set required orgID, websiteID values received after approval using `pbjs.setBidderConfig`.
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| ----------- | -------- | ---------------------------------- | ------------------ | --------- |
+| `orgID` | required | A unique ID for your organization provided by the Blockthrough team. | `4829301576428910` | `string` |
+| `websiteID` | required | A unique ID for your site provided by the Blockthrough team. | `5654012389765432` | `string` |
+
+#### Example
+
+```javascript
+pbjs.setBidderConfig({
+  bidders: ['blockthrough'],
+  config: {
+    ortb2: {
+      site: {
+        ext: {
+          blockthrough: {
+            orgID: '4829301576428910',
+            websiteID: '5654012389765432',
+          },
+        },
+      },
+    },
+  },
+});
+```
+
+#### AdUnits configuration example
+
+```javascript
+var adUnits = [
+  {
+    code: 'banner-div-1',
+    mediaTypes: {
+      banner: {
+        sizes: [[728, 90]],
+      },
+    },
+    bids: [
+      {
+        bidder: 'blockthrough',
+        params: {
+          bidderA: {
+            publisherId: 55555,
+          },
+          bidderB: {
+            zoneId: 12,
+          },
+        },
+      },
+    ],
+  },
+];
+```

dev-docs/bidders/bwx.md

@@ -0,0 +1,26 @@
+---
+layout: bidder
+title: BoldwinX
+description: BoldwinX Bidder Adapter
+biddercode: bwx
+media_types: banner, video, native
+coppa_supported: true
+tcfeu_supported: false
+usp_supported: true
+prebid_member: false
+pbjs: false
+pbs: true
+schain_supported: true
+floors_supported: true
+multiformat_supported: will-bid-on-any
+sidebarType: 1
+safeframes_ok: true
+---
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name        | Scope    | Description                   | Example                            | Type      |
+|-------------|----------|-------------------------------|------------------------------------|-----------|
+| `pid`       | required | unique placement ID           | `aa8210e2013wc095fe9dba67981040b0` | `string`  |
+| `env`       | optional | Environment name              | `bwx-stage`                        | `string`  |

dev-docs/bidders/kimberlite.md

@@ -0,0 +1,34 @@
+---
+layout: bidder
+title: Kimberlite
+description: Prebid Kimberlite Bidder Adapter
+biddercode: kimberlite
+tcfeu_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+gpp_supported: false
+schain_supported: false
+dchain_supported: false
+media_types: banner
+safeframes_ok: false
+deals_supported: true
+floors_supported: true
+pbjs: true
+pbs: false
+prebid_member: false
+multiformat_supported: will-not-bid
+ortb_blocking_supported: partial
+sidebarType: 1
+---
+
+### Note
+
+The Kimberlite Bidding adapter requires setup. Please contact us at <[email protected]>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description           | Example   | Type      |
+|---------------|----------|-----------------------|-----------|-----------|
+| `placementId` | required | Placement ID          | `'123'`     | `string`  |

dev-docs/bidders/lucead.md

@@ -0,0 +1,32 @@
+---
+layout: bidder
+title: Lucead adapter
+description: Prebid Lucead Bidder Adapter
+biddercode: lucead
+tcfeu_supported: false
+gvl_id: none
+usp_supported: false
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+media_types: banner
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+pbjs: true
+pbs: false
+prebid_member: true/false
+ortb_blocking_supported: false
+privacy_sandbox: paapi
+sidebarType: 1
+---
+### Note
+
+The Lucead Bidding adapter requires setup before beginning. Please contact us at [[email protected]](mailto:[email protected]).
+
+### Bid Params
+
+| Name          | Scope    | Description           | Example   | Type      |
+|---------------|----------|-----------------------|-----------|-----------|
+| `placementId` | required | Placement id          | `'11111'` | `string`  |

dev-docs/bidders/oms.md

@@ -3,7 +3,7 @@ layout: bidder
 title: Online Media Solutions
 description: Prebid Online Media Solutions(OMS) Bidder Adapter
 tcfeu_supported: false
-pbjs: false
+pbjs: true
 pbs: true
 biddercode: oms
 prebid_member: false
@@ -14,14 +14,25 @@ schain_supported: true
 userIds: id5Id, identityLink, pubProvidedId
 pbs_app_supported: true
 sidebarType: 1
+gvl_id: 883
 ---
 ### Note
 
 The bidder requires setup before usage. Please get in touch with our team at <[email protected]> to get started.
 
-### Bid Params
+### Prebid.JS Bid Params
 
 {: .table .table-bordered .table-striped }
+
+| Name | Scope | Description | Example | Type |
+| ---- | ----- | ----------- | ------- | ---- |
+| `publisherId`       | required | Unique publisher ID  | `12345` | `integer` |
+| `bidFloor`    | optional | The minimum bid value desired      | `1.23`  | `float` |
+
+### Prebid Server Bid Params
+
+{: .table .table-bordered .table-striped }
+
 | Name | Scope | Description | Example | Type |
 |---------------|----------|---------------------|---------------|----------|
 | `pid` | required | Unique publisher ID | `'12345'` | `string` |

dev-docs/bidders/onetag.md

@@ -14,6 +14,8 @@ userIds: britepoolId, criteo, id5Id, identityLink, liveIntentId, netId, parrable
 schain_supported: true
 floors_supported: true
 sidebarType: 1
+coppa_supported: true
+privacy_sandbox: topics
 ---
 
 

dev-docs/bidders/pubmatic.md

@@ -9,6 +9,7 @@ usp_supported: true
 coppa_supported: true
 gpp_supported: true
 schain_supported: true
+dchain_supported: true
 floors_supported: true
 userIds: all
 prebid_member: true

dev-docs/bidders/rise.md

@@ -9,7 +9,9 @@ media_types: banner, video
 schain_supported: true
 coppa_supported: true
 pbs: true
+pbs_app_supported: true
 tcfeu_supported: true
+gpp_supported: true
 usp_supported: true
 floors_supported: true
 userIds: all

dev-docs/bidders/rixengine.md

@@ -0,0 +1,51 @@
+---
+layout: bidder
+title: RixEngine
+description: Prebid RixEngine Bidder Adapter
+biddercode: rixengine
+tcfeu_supported: false
+coppa_supported: true
+schain_supported: false
+media_types: banner
+safeframes_ok: false
+deals_supported: false
+pbjs: false
+pbs: false
+pbs_app_supported: false
+prebid_member: true
+userIds: sharedId
+sidebarType: 0
+multiformat_supported: false
+---
+
+### Note
+
+The RixEngine Bidding adapter requires setup before beginning. Please contact the RixEngine team <[email protected]>.
+
+### Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name    | Scope    | Description                                                                 | Example     | Type     |
+|---------|----------|-----------------------------------------------------------------------------|-------------|----------|
+| endpoint| required |The endpoint created on RixEngine platform, please get them from the platform| [http://demo.svr.rixengine.com/rtb](http://demo.svr.rixengine.com/rtb) | string   |
+| sid     | required |The sid created on RixEngine platform, please get them from the platform     | '36540'                                     | string   |
+| token   | required |The token created on RixEngine platform, please get them from the platform   | '1e05a767930d7d96ef6ce16318b4ab99'          | string   |
+
+### Test Parameters
+
+```javascript
+var adUnits = [
+{
+    sizes: [
+        [300, 250] // a display size
+    ],     
+    bids: [{
+      bidder: 'rixengine',
+      params: {
+        endpoint: 'http://demo.svr.rixengine.com/rtb', // required
+        token: '1e05a767930d7d96ef6ce16318b4ab99', // required
+        sid: '36540', // required
+      }
+    }]
+}];
+```

dev-docs/bidders/seedingAlliance.md

@@ -28,4 +28,5 @@ sidebarType: 1
 | Name        | Scope    | Description          | Example            | Type      |
 |-------------|----------|----------------------|--------------------|-----------|
 | `adUnitId`  | required | ID of the Ad Unit    | `8ao`              | `string`  |
+| `accountId` | optional | Your identifier for the account (Prebid Server only) | `12345` | `string`  |
 | `url`       | optional | URL from the Page    | `example.tld`      | `string`  |