Merge branch 'prebid:master' into master

Author: DeepthiNeeladri

dev-docs/analytics/agma.md

@@ -0,0 +1,33 @@
+---
+layout: analytics
+title: agma
+description: agma Analytics Adapter
+modulecode: agma
+tcfeu_supported: true
+usp_supported: false
+coppa_supported: false
+prebid_member: false
+gvl_id: 1122
+---
+
+#### Analytics Options
+
+{: .table .table-bordered .table-striped }
+| Name         | Scope              | Description                                                                                                                 | Example                                                                             | Type             |
+|-------------|---------|--------------------|-----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|------------------|
+| code | required  | Provided by agma | `'my-code'`  | string |
+
+### Example Configuration
+
+```javascript
+pbjs.enableAnalytics({
+    provider: 'agma',
+    options: {
+        code: 'provided-by-agma'    // change to the code you received from agma
+    }
+});
+```
+
+#### Registration
+
+Please contact [team-internet@agma-mmc.de](mailto:team-internet@agma-mmc.de) for signup.

dev-docs/bidders/connatix.md

@@ -57,3 +57,24 @@ var adUnits = [
   // Define more ad units here if necessary
 ];
 ```
+
+### Configuration
+
+To maximize revenue efficiency, please enable ```iframe``` user syncing.
+
+Connatix strongly recommends enabling user syncing through iFrames. This functionality improves DSP user match rates and increases the bid rate and bid price. Make sure to call `pbjs.setConfig()` only once. This configuration is optional in Prebid, but required by Connatix.
+
+#### Example configuration
+
+```js
+pbjs.setConfig({
+  userSync: {
+    filterSettings: {
+      iframe: {
+        bidders: ['connatix'],
+        filter: 'include'
+      }
+    }
+  }
+});
+```

dev-docs/bidders/ix.md

@@ -392,11 +392,16 @@ pbjs.addAdUnits({
 
 ## Protected Audience API support
 
-**Before you begin:** You must have Google Ad Manager and the [fledgeForGpt](/dev-docs/modules/fledgeForGpt.html) module.
+**Before you begin:**
+
+* You must have Google Ad Manager and the [fledgeForGpt](/dev-docs/modules/fledgeForGpt.html) module.
+* You must be using Prebid.js version 8.18.0 or later.
 
 Follow these steps to configure your Prebid.js to specify that your ad slots are enabled for [Protected Audience](https://github.com/WICG/turtledove/blob/main/FLEDGE.md) auctions:
-1. Build the `fledgeForGpt` module in your Prebid.js configuration by adding `fledgeForGpt` to the list of modules that you are already using. For more information about the module, see Prebid's [Fledge (Protected Audience) for GPT Module](/dev-docs/modules/fledgeForGpt.html) documentation.
-2. Enable all ad units to use the `fledgeForGpt` module in your prebid.js configuration. Index recommends that you do this in the global level configuration by using the `defaultForSlots` parameter with a value of `1`. <br />
+
+1. Confirm that you have opted in to use the Protected Audience API in your Google Ad Manager configuration. For more information about how to opt-in, see Google's documentation on [Protected Audience API and Ad Manager after Chrome GA](https://support.google.com/admanager/answer/13627134?hl=en&ref_topic=12264880&sjid=10591375417866092080-NA).
+2. Build the `fledgeForGpt` module in your Prebid.js configuration by adding `fledgeForGpt` to the list of modules that you are already using. For more information about the module, see Prebid's [Fledge (Protected Audience) for GPT Module](/dev-docs/modules/fledgeForGpt.html) documentation.
+3. Enable all ad units to use the `fledgeForGpt` module in your prebid.js configuration. You can do this in the global-level configuration, bidder level, or ad-unit level. For more information about the configurations, see Prebid's [Fledge (Protected Audience) for GPT Module](/dev-docs/modules/fledgeForGpt.html) documentation. Index recommends that you do this in the global-level configuration by using the `defaultForSlots` parameter with a value of `1`. <br />
 **Note:** If you are using the `fledgeForGpt.bidders[]`, make sure that you add `ix` to the list of bidders.<br />
 The following shows an example of the configuration done at the global level:
 
@@ -411,6 +416,20 @@ pbjs.que.push(function() {
 });
 ```
 
+The following shows an example of the configuration done at the ad-unit level:
+
+```javascript
+pbjs.addAdUnits({
+    code: "my-adunit-div",
+    // other config here
+    ortb2Imp: {
+        ext: {
+            ae: 1
+        }
+    }
+});
+```
+
 <a name="bid-request-parameters"></a>
 
 ## Bid request parameters

dev-docs/publisher-api-reference/setConfig.md

@@ -16,6 +16,7 @@ Core config:
 * [Debugging](#setConfig-Debugging)
 * [Device Access](#setConfig-deviceAccess)
 * [Bidder Timeouts](#setConfig-Bidder-Timeouts)
+* [Enable sharing of transaction IDs](#setConfig-enableTIDs)
 * [Max Requests Per Origin](#setConfig-Max-Requests-Per-Origin)
 * [Disable Ajax Timeout](#setConfig-Disable-Ajax-Timeout)
 * [Set Timeout Buffer](#setConfig-timeoutBuffer)
@@ -99,6 +100,16 @@ Note that it's possible for the timeout to be triggered later than expected, lea
 With a busy page load, bids can be included in the auction even if the time to respond is greater than the timeout set by Prebid.js.  However, we do close the auction immediately if the threshold is greater than 200ms, so you should see a drop off after that period.
 For more information about the asynchronous event loop and `setTimeout`, see [How JavaScript Timers Work](https://johnresig.com/blog/how-javascript-timers-work/).
 
+<a id="setConfig-enableTIDs"></a>
+
+#### Enable sharing of transaction IDs
+
+Prebid generates unique IDs for both auctions and ad units within auctions; these can be used by DSPs to correlate requests from different sources, which is useful for many applications but also a potential privacy concern. Since version 8 they are disabled by default (see [release notes](/dev-docs/pb8-notes.html)), and can be re-enabled with `enableTIDs`:
+
+```javascript
+pbjs.setConfig({ enableTIDs: true });
+```
+
 #### Max Requests Per Origin
 
 <a name="setConfig-Max-Requests-Per-Origin"></a>

prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md

@@ -168,6 +168,8 @@ if $.id contains "{{UUID}}", replace that macro with a random value
 
 ##### request.source.tid
 
+PBS-Go - this will change once [issue 2727](https://github.com/prebid/prebid-server/issues/2727) is implemented to link the transmitTid activity.
+
 ```text
 if source.tid is not set:
    set source.tid to a random UUID
@@ -176,6 +178,16 @@ if host config auto_gen_source_tid (Go) / generate-storedrequest-bidrequest-id (
 if $.source.tid contains "{{UUID}}", replace that macro with a random value
 ```
 
+PBS-Java
+
+```text
+if source.tid is not set and the transmitTid activity is allowed:
+   set source.tid to a random UUID
+if host config generate-storedrequest-bidrequest-id config is true and the transmitTid activity is allowed
+    if the storedrequest is from AMP or from a top-level stored request (ext.prebid.storedrequest), then replace any existing $.source.tid with a random value
+if $.source.tid contains "{{UUID}}", replace that macro with a random value
+```
+
 ##### request.imp[].id
 
 ```text
@@ -186,6 +198,8 @@ if host config generate-storedrequest-bidrequest-id config is true
 
 ##### request.imp[].ext.tid
 
+PBS-Go - this will change once [issue 2727](https://github.com/prebid/prebid-server/issues/2727) is implemented to link the transmitTid activity.
+
 ```text
 if imp[n].ext.tid is not set:
        set imp[n].ext.tid to a randomly generated UUID
@@ -194,6 +208,17 @@ if imp[n].ext.tid is not set:
 if $.imp[n].ext.tid contains "{{UUID}}", replace that macro with a random value
 ```
 
+PBS-Java
+
+```text
+for each imp:
+   if imp[n].ext.tid is not set and the transmitTid activity is allowed:
+       set imp[n].ext.tid to a randomly generated UUID
+   if host config generate-storedrequest-bidrequest-id config is true and the transmitTid activity is allowed
+       if the storedrequest is from AMP or from a top-level stored request (ext.prebid.storedrequest), then replace any existing $.imp[n].ext.tid with a random value
+  if $.imp[n].ext.tid contains "{{UUID}}", replace that macro with a random value
+```
+
 #### Expiration
 
 The `imp[].exp` field is an "Advisory as to the number of seconds that may elapse
@@ -906,6 +931,18 @@ To be deprecated for `request.imp[].rwdd` introduced in OpenRTB 2.6.
 Rewarded video is a way to incentivize users to watch ads by giving them 'points' for viewing an ad. A Prebid Server
 client can declare a given adunit as eligible for rewards by declaring `imp.ext.prebid.is_rewarded_inventory:1`.
 
+##### Create Transaction ID
+
+The request can contain the global `createtid` flag to control the `transmitTid` [Activity Control](/prebid-server/features/pbs-activitycontrols.html).
+
+```text
+ext.request.createtid: false
+```
+
+If the value is `false`, the `transmitTid` activity is overridden to "denied", which means bid adapters will not get unique transaction IDs. If not specified, then the value of the transmitTid activity for the account is used. The overall default value it `true`, which translates to "allow" the generation of TIDs.
+
+See the [endpoint documentation on IDs](/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.html#ids) for details on how PBS creates the various IDs including transaction IDs.
+
 ##### Debug Flag
 
 The OpenRTB `test` flag has a special meaning that bidders may react to: they may not perform a normal auction, or may not pay for test requests.
@@ -1734,6 +1771,7 @@ The Prebid SDK version comes from:
 | ext<wbr>.prebid<wbr>.server | additional Prebid Server metadata | object | yes |
 | ext<wbr>.prebid<wbr>.pbs.endpoint | additional Prebid Server metadata | string | yes |
 | ext<wbr>.prebid<wbr>.floors | PBS floors data | object | no |
+| ext<wbr>.prebid<wbr>.createtid | Ties to the transmitTid activity. If false, transmitTid is denied. | boolean | no |
 | ext<wbr>.prebid<wbr>.returnallbidstatus | If true, PBS returns [ext.seatnonbid](#seat-non-bid) with details about bidders that didn't bid. | boolean | no |
 | ext<wbr>.prebid<wbr>.analytics | Arguments that can be passed through to individual analytics adapters | object | no |
 | imp<wbr>.ext<wbr>.ae | If 1, signals bid adapters that Fledge auction config is accepted on the response. (ae stands for auction environment) | integer | yes |

prebid-server/features/pbs-activitycontrols.md

@@ -189,6 +189,7 @@ Here's the list of the 'potentially restricted activities' that Prebid Server co
 | `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 or EIDs to their endpoint. (Note: this differs from Prebid.js where these are separate activities.) | User FPD and EIDs are hidden from the adapter or module: `user.data`, `user.ext.data`, `user.{id, buyeruid, yob, gender}`, `user.eids`, `device.{device.ifa, macsha1, macmd5, dpidsha1, dpidmd5, didsha1, didmd5}` |
 | `transmitPreciseGeo` | A bid adapter, analytics adapter, or module wants to access and/or transmit precise geolocation data to their endpoint | 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. |
+| `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. |
 
 <a id="rules"></a>