prebid.js 9.40.0 → 9.41.0

package/modules/raveltechRtdProvider.md

@@ -0,0 +1,61 @@
+# Raveltech RTD Module for Prebid.js
+
+## Overview
+
+```
+Module Name:  Raveltech RTD Provider
+Module Type:  RTD Provider
+Maintainer: maintainers@raveltech.io
+```
+
+The RavelTech RTD (Real-Time Data) module for Prebid.js enables publishers to integrate seamlessly with Ravel Technologies' privacy-focused solution, ensuring bidder requests are anonymized before reaching SSPs and DSPs. By leveraging the Ravel Privacy Bus, this module prevents the transmission of personally identifiable information (PII) in bid requests, strengthening privacy compliance and security.
+
+## How It Works
+
+The module operates in two modes:
+1. **Bid URL Replacement:** The module modifies the bid request URL of the configured bidders to pass through the Ravel proxy, ensuring that all IDs are anonymized.
+2. **Bid Duplication (if `preserveOriginalBid` is enabled):** The module duplicates the original bid request, sending one request as-is and another through the Ravel proxy with anonymized IDs.
+
+## Configuration
+
+To enable the Raveltech RTD module, you need to configure it with a list of bidders and specify whether to preserve the original bid request.
+For the anonymization feature to work, you also need to load a javascript in the header of your HTML page:
+```html
+<script src="https://cdn.rvlproxy.net/latest/zkad.js" async></script>
+```
+
+### Build
+```
+gulp build --modules="rtdModule,raveltechRtdProvider,appnexusBidAdapter,..."  
+```
+
+> Note that the global RTD module, `rtdModule`, is a prerequisite of the raveltech RTD module.
+
+### Parameters
+
+| Parameter           | Type    | Description |
+|--------------------|--------|-------------|
+| `bidders`         | Array  | A list of bidder codes (or their alias if an alias is used) that should have their bid requests anonymized via Ravel. |
+| `preserveOriginalBid` | Boolean | If `true`, the original bid request is preserved, and an additional bid request is sent through the Ravel proxy. If `false`, the original bid request is replaced with the Ravel-protected request. |
+
+### Example Configuration
+
+```javascript
+pbjs.setConfig({
+    realTimeData: {
+        dataProviders: [{
+            name: 'raveltech',
+            params: {
+                bidders: ['appnexus', 'rubicon'],
+                preserveOriginalBid: true
+            }
+        }]
+    }
+});
+```
+
+## Privacy Features
+
+The RavelTech RTD module allows publishers to implement the following privacy protections:
+- Personally Identifiable Information (PII) is either removed or converted into Anonymized IDs (RIDs).
+- Bid requests are routed through an anonymized proxy before reaching the SSP, ensuring IP address anonymization.

package/modules/seedtagBidAdapter.js

@@ -176,6 +176,7 @@ function buildBidResponse(seedtagBid) {
         seedtagBid && seedtagBid.adomain && seedtagBid.adomain.length > 0
           ? seedtagBid.adomain
           : [],
+      mediaType: seedtagBid.realMediaType,
     },
   };
 

package/modules/yandexBidAdapter.js

@@ -55,6 +55,7 @@ const DEFAULT_CURRENCY = 'EUR';
  */
 const SUPPORTED_MEDIA_TYPES = [BANNER, NATIVE];
 const SSP_ID = 10500;
+const ADAPTER_VERSION = '2.0.0';
 
 const IMAGE_ASSET_TYPES = {
   ICON: 1,
@@ -139,6 +140,7 @@ export const spec = {
       const queryParams = {
         'imp-id': impId,
         'target-ref': targetRef || ortb2?.site?.domain,
+        'adapter-version': ADAPTER_VERSION,
         'ssp-id': SSP_ID,
       };
 
@@ -153,6 +155,8 @@ export const spec = {
         id: impId,
         banner: mapBanner(bidRequest),
         native: mapNative(bidRequest),
+        displaymanager: 'Prebid.js',
+        displaymanagerver: '$prebid.version$',
       };
 
       const bidfloor = getBidfloor(bidRequest);

package/modules/yieldoneBidAdapter.js

@@ -119,6 +119,12 @@ export const spec = {
         payload.uid2id = uid2;
       }
 
+      // GPID
+      const gpid = deepAccess(bidRequest, 'ortb2Imp.ext.gpid');
+      if (isStr(gpid) && !isEmpty(gpid)) {
+        payload.gpid = gpid;
+      }
+
       return {
         method: 'GET',
         url: ENDPOINT_URL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prebid.js",
-  "version": "9.40.0",
+  "version": "9.41.0",
   "description": "Header Bidding Management Library",
   "main": "src/prebid.public.js",
   "exports": {
@@ -52,7 +52,7 @@
     "@wdio/cli": "^9.0.5",
     "@wdio/concise-reporter": "^8.29.0",
     "@wdio/local-runner": "^9.0.5",
-    "@wdio/mocha-framework": "^8.29.0",
+    "@wdio/mocha-framework": "^9.12.6",
     "@wdio/spec-reporter": "^8.29.0",
     "ajv": "6.12.3",
     "assert": "^2.0.0",

package/test/spec/modules/epomDspBidAdapter_spec.js

@@ -0,0 +1,73 @@
+import { expect } from 'chai';
+import { spec } from '../../../modules/epomDspBidAdapter.js';
+
+const VALID_BID_REQUEST = {
+  bidder: 'epom_dsp',
+  params: {
+    endpoint: 'https://bidder.epommarket.com/bidder/v2_5/bid?key=d0b9fb9de9dfbba694dfe75294d8e45a'
+  },
+  adUnitCode: 'ad-unit-1',
+  sizes: [[300, 250]],
+  bidId: '12345'
+};
+
+const BIDDER_REQUEST = {
+  refererInfo: { referer: 'https://example.com' },
+  gdprConsent: { consentString: 'consent_string' },
+  uspConsent: 'usp_string'
+};
+
+describe('epomDspBidAdapter', function () {
+  it('should validate a correct bid request', function () {
+    expect(spec.isBidRequestValid(VALID_BID_REQUEST)).to.be.true;
+  });
+
+  it('should reject a bid request with missing endpoint', function () {
+    const invalidBid = { ...VALID_BID_REQUEST, params: { endpoint: '' } };
+    expect(spec.isBidRequestValid(invalidBid)).to.be.false;
+  });
+
+  it('should reject a bid request with an invalid endpoint', function () {
+    const invalidBid = { ...VALID_BID_REQUEST, params: { endpoint: 'http://invalid.com' } };
+    expect(spec.isBidRequestValid(invalidBid)).to.be.false;
+  });
+
+  it('should build requests properly', function () {
+    const requests = spec.buildRequests([VALID_BID_REQUEST], BIDDER_REQUEST);
+    expect(requests).to.have.length(1);
+    expect(requests[0]).to.include.keys(['method', 'url', 'data', 'options']);
+    expect(requests[0].method).to.equal('POST');
+    expect(requests[0].url).to.equal(VALID_BID_REQUEST.params.endpoint);
+    expect(requests[0].data).to.include.keys(['referer', 'gdprConsent', 'uspConsent']);
+  });
+
+  it('should interpret response correctly', function () {
+    const SERVER_RESPONSE = {
+      body: {
+        bids: [
+          {
+            requestId: '12345',
+            cpm: 1.23,
+            currency: 'USD',
+            width: 300,
+            height: 250,
+            ad: '<div>Ad</div>',
+            creativeId: 'abcd1234',
+            ttl: 300,
+            netRevenue: true
+          }
+        ]
+      }
+    };
+
+    const result = spec.interpretResponse(SERVER_RESPONSE);
+    expect(result).to.have.length(1);
+    expect(result[0]).to.include.keys(['requestId', 'cpm', 'currency', 'width', 'height', 'ad', 'creativeId', 'ttl', 'netRevenue']);
+    expect(result[0].cpm).to.equal(1.23);
+  });
+
+  it('should return empty array for empty response', function () {
+    const result = spec.interpretResponse({ body: {} });
+    expect(result).to.be.an('array').that.is.empty;
+  });
+});

package/test/spec/modules/equativBidAdapter_spec.js

@@ -1,4 +1,4 @@
-import { converter, spec, storage } from 'modules/equativBidAdapter.js';
+import { converter, getImpIdMap, spec, storage } from 'modules/equativBidAdapter.js';
 import * as utils from '../../../src/utils.js';
 
 describe('Equativ bid adapter tests', () => {
@@ -890,6 +890,24 @@ describe('Equativ bid adapter tests', () => {
       delete response.body.seatbid;
       expect(spec.interpretResponse(response, request)).to.not.throw;
     });
+
+    it('should pass exp as ttl parameter with its value', () => {
+      const request = spec.buildRequests(
+        DEFAULT_BANNER_BID_REQUESTS,
+        DEFAULT_BANNER_BIDDER_REQUEST
+      )[0];
+
+      const response = utils.deepClone(SAMPLE_RESPONSE);
+      const bidId = 'abcd1234';
+      const impIdMap = getImpIdMap();
+
+      response.body.seatbid[0].bid[0].impid = Object.keys(impIdMap).find(key => impIdMap[key] === bidId);
+      response.body.seatbid[0].bid[0].exp = 120;
+
+      const result = spec.interpretResponse(response, request);
+
+      expect(result.bids[0]).to.have.property('ttl').that.eq(120);
+    });
   });
 
   describe('isBidRequestValid', () => {