Merge master

_includes/mobile/rewarded-server-side-configuration.md

@@ -1,3 +1,5 @@
+<!-- markdownlint-disable MD041 -->
+
 ##### 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.  
@@ -7,6 +9,7 @@ Configuration of rewarded ad unit can be done by defining the Prebid Server [pas
 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 }
+<!-- markdownlint-disable MD060 -->
 | 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> | 
@@ -26,7 +29,38 @@ Prebid SDK will search for a particular `rwdd` object in `$.seatbid.bid.ext.preb
 | `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"` | 
+<!-- markdownlint-enable MD060 -->
+
+Publishers can also supply the same impression-level configuration from the app with the ad unit's `setImpORTBConfig()` method. This is useful when a bidder does not return `rwdd` and the app needs to replace the default 120-second end-card completion time. Pass the `ext.prebid.passthrough` portion of the impression, for example:
+
+```json
+{
+  "ext": {
+    "prebid": {
+      "passthrough": [
+        {
+          "type": "prebidmobilesdk",
+          "rwdd": {
+            "completion": {
+              "video": {
+                "endcard": {
+                  "time": 15
+                }
+              }
+            },
+            "close": {
+              "postrewardtime": 0,
+              "action": "closebutton"
+            }
+          }
+        }
+      ]
+    }
+  }
+}
+```
 
+Serialize this object as JSON and pass it to `RewardedAdUnit.setImpORTBConfig()`. Prebid Server returns the passthrough data with the bid, where the SDK reads the `rwdd` configuration.
 
 An example of an impression-level stored request:
 

dev-docs/analytics/eightpod.md

@@ -0,0 +1,25 @@
+---
+layout: analytics
+title: 8pod
+description: 8pod Analytics Adapter
+modulecode: eightpodAnalyticsAdapter
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+prebid_member: false
+gvl_id: none
+enable_download: false
+---
+
+## Configuration
+
+```javascript
+pbjs.enableAnalytics({
+  provider: 'eightpod'
+});
+```
+
+Use the lowercase provider code `eightpod` to match adapter registration.
+
+### Disclosure
+The adapter subscribes to events from 8pod's ad unit when the bidWon event fires for each ad slot and sends supported ad unit events to Tealium from the rendered ad frame.

dev-docs/analytics/nexx360.md

@@ -0,0 +1,46 @@
+---
+layout: analytics
+title: Nexx360
+description: Nexx360 Analytics Adapter
+modulecode: nexx360Analytics
+prebid_member: false
+tcfeu_supported: false
+usp_supported: false
+coppa_supported: false
+---
+
+## About
+
+The Nexx360 Analytics Adapter reports Prebid.js auction activity to the Nexx360
+monitoring platform for reporting and troubleshooting. It tracks the auction
+lifecycle — auction init, bid requests, bid responses, and bid timeouts (batched
+per auction) — and sends bid wins and ad-render outcomes as they happen. For
+Nexx360 server-side demand, it also reports a per-auction server-auction summary.
+
+Sampling is applied server-side by the Nexx360 collector, so the adapter sends
+all events and exposes no client-side sampling option. The adapter does not read
+or write browser storage.
+
+## Analytics Options
+
+{: .table .table-bordered .table-striped }
+| Name | Scope | Description | Example | Type |
+| ------ | ------- | ------------- | --------- | ------ |
+| publisherId | required | Your Nexx360 publisher identifier | `'1067'` | string |
+| endpoint | optional | Collector endpoint URL. Defaults to `https://monitoring.nexx360.io`. | `'https://monitoring.nexx360.io'` | string |
+| abTestLabel | optional | A/B test variant label, attached to every event so analytics can be sliced by test arm | `'variantA'` | string |
+
+## Example Configuration
+
+```javascript
+pbjs.enableAnalytics({
+    provider: 'nexx360Analytics',
+    options: {
+        publisherId: 'your-publisher-id'
+    }
+});
+```
+
+## Registration
+
+Please contact [tech@nexx360.io](mailto:tech@nexx360.io) to obtain your Nexx360 publisher credentials.

dev-docs/bidders/SMB.md

@@ -0,0 +1,31 @@
+---
+layout: bidder
+title: SMB
+description: SMB Bidder Adapter
+biddercode: SMB
+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`.

dev-docs/bidders/adbix.md

@@ -0,0 +1,41 @@
+---
+layout: bidder
+title: Adbix
+description: Prebid Adbix Bidder Adapter
+pbjs: true
+pbs: false
+biddercode: adbix
+media_types: banner
+coppa_supported: false
+tcfeu_supported: false
+usp_supported: false
+schain_supported: true
+dchain_supported: false
+safeframes_ok: true
+deals_supported: true
+floors_supported: true
+fpd_supported: true
+userId: none
+sidebarType: 1
+---
+
+## Registration
+
+To use the Adbix bidder you will need a valid publisher ID and placement ID from Adbix. For further information, please contact <admin@adbix.net>.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                         | Example            | Type      |
+|---------------|----------|-------------------------------------|--------------------|-----------|
+| `publisherId` | required | Adbix publisher identifier          | `'test-publisher'` | `string`  |
+| `placementId` | required | Adbix placement identifier          | `'test-300x250'`   | `string`  |
+| `test`        | optional | Enables the Adbix test response     | `true`             | `boolean` |
+
+## User Sync
+
+User sync is recommended to improve match rates and monetization. The adapter registers an image user-sync request when image/pixel syncing is enabled by the publisher. The auction continues to work when image user syncing is disabled.
+
+## Privacy
+
+For information about Adbix privacy practices, see: <https://adbix.net/privacy-policy.php>

dev-docs/bidders/adkernel.md

@@ -4,7 +4,7 @@ title: AdKernel
 description: Prebid AdKernel Bidder Adaptor
 biddercode: adkernel
 tcfeu_supported: true
-dsa_supported: false
+dsa_supported: true
 gvl_id: 14
 usp_supported: true
 coppa_supported: true
@@ -27,14 +27,14 @@ privacy_sandbox: no
 sidebarType: 1
 ---
 
-### Note
+## Note
 
 The Adkernel Bidding adaptor requires setup and approval before beginning. Please reach out to <prebid@adkernel.com> for more details
 
 ### Bid Params
 
 {: .table .table-bordered .table-striped }
-| Name     | Scope    | Description           | Example                   | Type     |
-|----------|----------|-----------------------|---------------------------|----------|
-| `host`   | required | Ad network's RTB host | `'cpm.metaadserving.com'` | `string` |
-| `zoneId` | required | RTB zone id           | `30164`                 | `integer` |
+|Name|Scope|Description|Example|Type|
+|---|---|---|---|---|
+|`host`|required|Ad network's RTB host|`'cpm.metaadserving.com'`|`string`|
+|`zoneId`|required|RTB zone id|`30164`|`integer`|

dev-docs/bidders/adswag.md

@@ -0,0 +1,140 @@
+---
+layout: bidder
+title: Adswag
+description: Prebid Adswag Bidder Adapter
+biddercode: adswag
+media_types: banner, video, audio
+multiformat_supported: will-bid-on-any
+tcfeu_supported: true
+dsa_supported: true
+gvl_id: 1417
+usp_supported: false
+gpp_sids: tcfeu
+userId: all
+coppa_supported: false
+schain_supported: true
+dchain_supported: false
+prebid_member: false
+floors_supported: true
+fpd_supported: true
+ortb_blocking_supported: false
+safeframes_ok: true
+deals_supported: false
+pbjs: true
+pbs: true
+pbs_app_supported: true
+privacy_sandbox: no
+sidebarType: 1
+---
+
+## Note
+
+Maintainer contact: [prebid@adswag.ai](mailto:prebid@adswag.ai)
+
+Adswag bids in **EUR** on every bid. Publishers whose ad-server currency is
+not EUR should include the Prebid
+[currency module](https://docs.prebid.org/dev-docs/modules/currency.html).
+
+Outstream video units get an Adswag renderer attached automatically: nothing
+is downloaded unless an Adswag outstream bid wins, and a publisher-supplied
+`renderer` overrides it per Prebid convention.
+
+Audio requires the `FEATURES.AUDIO` build flag and `mimes`; Prebid has no
+built-in audio renderer, so hand the returned VAST to your audio player.
+
+From `ortb2.user` only extended identifiers (`user.eids` / `user.ext.eids`)
+are forwarded, gated on consent; other `user` first-party data is not sent.
+
+## Bid Params
+
+{: .table .table-bordered .table-striped }
+| Name          | Scope    | Description                                                                                  | Example               | Type     |
+|---------------|----------|----------------------------------------------------------------------------------------------|-----------------------|----------|
+| `publisherId` | required | Adswag publisher id (issued at onboarding). Resolves the canonical publisher at the edge.    | `"pub-nl-news-1"`     | `string` |
+| `placementId` | optional | Explicit placement override. Omit to let Adswag discover the placement from GPID/adUnitCode. | `"plc-homepage-mrec"` | `string` |
+| `bidFloor`    | optional | Static floor (EUR) used only when the Prebid Price Floors module is not configured.          | `0.50`                | `number` |
+| `video`       | optional | Overrides for `mediaTypes.video` ad-unit params (Prebid video-params convention).            | `{ maxduration: 15 }` | `object` |
+
+## Video params
+
+Standard Prebid video params are read from `mediaTypes.video` (with
+`params.video` overrides); `mimes` is required. The endpoint consumes
+`mimes`, `minduration`, `maxduration`, `protocols`, `playerSize` (as
+`w`/`h`), `plcmt` (derived from `context` when not set explicitly),
+`linearity`, `skip` and `skipafter`.
+
+## Example ad units
+
+```javascript
+var adUnits = [
+  {
+    code: "div-gpt-ad-homepage-mrec",
+    mediaTypes: {
+      banner: {
+        sizes: [[300, 250], [300, 600]]
+      }
+    },
+    ortb2Imp: {
+      ext: { gpid: "/1234/homepage#mrec" }
+    },
+    bids: [
+      {
+        bidder: "adswag",
+        params: {
+          publisherId: "pub-nl-news-1"
+        }
+      }
+    ]
+  },
+  {
+    code: "video-player-1",
+    mediaTypes: {
+      video: {
+        context: "instream",
+        playerSize: [[640, 480]],
+        mimes: ["video/mp4"],
+        minduration: 5,
+        maxduration: 30,
+        protocols: [2, 3, 7, 8]
+      }
+    },
+    ortb2Imp: {
+      ext: { gpid: "/1234/article#player" }
+    },
+    bids: [
+      {
+        bidder: "adswag",
+        params: {
+          publisherId: "pub-nl-news-1"
+        }
+      }
+    ]
+  },
+  {
+    code: "audio-slot-1",
+    mediaTypes: {
+      audio: {
+        mimes: ["audio/mpeg", "audio/mp4"],
+        minduration: 10,
+        maxduration: 30,
+        protocols: [2, 3, 7, 8]
+      }
+    },
+    bids: [
+      {
+        bidder: "adswag",
+        params: {
+          publisherId: "pub-nl-news-1"
+        }
+      }
+    ]
+  }
+];
+```
+
+## Privacy / consent / identity
+
+Consentless traffic is served contextually: no identifiers are read,
+written, or forwarded. Enabling user syncs is recommended (registered via
+`getUserSyncs`, one iframe or image sync per auction on `ev.adswag.ai`,
+honoring your `userSync` configuration and GDPR/GPP/USP consent).