Merge branch 'master' of https://github.com/DimaIntentIQ/prebid.github.io

Author: DimaIntentIQ

_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:

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,
         };

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>
 
@@ -83,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. |
 
@@ -221,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

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'
+    }
+  }]);
+});
+```

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:

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: {...},
@@ -511,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"`                           |
@@ -720,6 +725,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: {