prebid.js 5.19.0 → 5.20.0

package/modules/otmBidAdapter.md

@@ -1,36 +1,37 @@
 # Overview
 
-Module Name: OTM Bidder Adapter
-Module Type: Bidder Adapter
-Maintainer: ?
+**Module Name**: OTM Bidder Adapter
+**Module Type**: Bidder Adapter  
+**Maintainer**: e.kretsu@otm-r.com
 
 # Description
 
-You can use this adapter to get a bid from otm-r.com.
+OTM Bidder Adapter for Prebid.js. About: https://otm-r.com
 
-About us : http://otm-r.com
+Use `otm` as bidder:
 
+# Params
+- `tid` required, specific id AdUnit slot.
+- `domain` optional, specific custom domain.
+- `bidfloor` optional.
 
-# Test Parameters
-```javascript
-    var adUnits = [
-        {
-            code: 'div-otm-example',
-            sizes: [[320, 480]],
-            bids: [
-                {
-                    bidder: "otm",
-                    params: {
-                        tid: "99",
-                        bidfloor: 20
-                    }
-                }
-            ]
-        }
-    ];
+## AdUnits configuration example
 ```
+    var adUnits = [{
+      code: 'your-slot', //use exactly the same code as your slot div id.
+      mediaTypes: {
+          banner: {
+              sizes: [[320, 480]]
+          }
+      },
+      bids: [{
+        bidder: 'otm',
+        params: { 
+            tid: 'XXXXX',
+            domain: 'specific custom domain, if needed',
+            bidfloor: 20
+        }
+      }]
+    }];
 
-Where:
-
-* tid - A tag id (should have low cardinality)
-* bidfloor - Floor price
+```

package/modules/outbrainBidAdapter.js

@@ -40,6 +40,7 @@ export const spec = {
     const publisher = setOnAny(validBidRequests, 'params.publisher');
     const bcat = setOnAny(validBidRequests, 'params.bcat');
     const badv = setOnAny(validBidRequests, 'params.badv');
+    const eids = setOnAny(validBidRequests, 'userIdAsEids')
     const cur = CURRENCY;
     const endpointUrl = config.getConfig('outbrain.bidderUrl');
     const timeout = bidderRequest.timeout;
@@ -105,6 +106,10 @@ export const spec = {
       deepSetValue(request, 'regs.coppa', config.getConfig('coppa') & 1)
     }
 
+    if (eids) {
+      deepSetValue(request, 'user.ext.eids', eids);
+    }
+
     return {
       method: 'POST',
       url: endpointUrl,

package/modules/playwireBidAdapter.md

@@ -0,0 +1,61 @@
+# Overview
+
+Module Name: Playwire Bidder Adapter
+Module Type: Bidder Adapter
+Maintainer: grid-tech@themediagrid.com
+
+# Description
+
+Module that connects to Grid demand source to fetch bids.
+The adapter is GDPR compliant and supports banner and video (instream and outstream).
+
+# Test Parameters
+```
+    var adUnits = [
+           {
+               code: 'test-div',
+               sizes: [[300, 250]],
+               bids: [
+                   {
+                       bidder: "playwire",
+                       params: {
+                           uid: '1',
+                           bidFloor: 0.5
+                       }
+                   }
+               ]
+           },{
+               code: 'test-div',
+               sizes: [[728, 90]],
+               bids: [
+                   {
+                       bidder: "playwire",
+                       params: {
+                           uid: 2,
+                           keywords: {
+                               brandsafety: ['disaster'],
+                               topic: ['stress', 'fear']
+                           }
+                       }
+                   }
+               ]
+           },
+           {
+               code: 'test-div',
+               sizes: [[728, 90]],
+               mediaTypes: { video: {
+                   context: 'instream',
+                   playerSize: [728, 90],
+                   mimes: ['video/mp4']
+               },
+               bids: [
+                   {
+                       bidder: "playwire",
+                       params: {
+                           uid: 11
+                       }
+                   }
+               ]
+          }
+       ];
+```

package/modules/rtdModule/index.js

@@ -42,10 +42,10 @@
  * @function?
  * @summary modify bid request data
  * @name RtdSubmodule#getBidRequestData
- * @param {SubmoduleConfig} config
- * @param {UserConsentData} userConsent
  * @param {Object} reqBidsConfigObj
  * @param {function} callback
+ * @param {SubmoduleConfig} config
+ * @param {UserConsentData} userConsent
  */
 
 /**

package/modules/sonobiBidAdapter.js

@@ -83,8 +83,15 @@ export const spec = {
       'lib_name': 'prebid',
       'lib_v': '$prebid.version$',
       'us': 0,
+
     };
 
+    const fpd = config.getConfig('ortb2');
+
+    if (fpd) {
+      payload.fpd = JSON.stringify(fpd);
+    }
+
     if (config.getConfig('userSync') && config.getConfig('userSync').syncsPerBidder) {
       payload.us = config.getConfig('userSync').syncsPerBidder;
     }

package/modules/sortableBidAdapter.js

@@ -227,6 +227,7 @@ export const spec = {
           rv.ext[partner] = params;
         });
       }
+      rv.ext.gpid = deepAccess(bid, 'ortb2Imp.ext.data.pbadslot');
       return rv;
     });
     const gdprConsent = bidderRequest && bidderRequest.gdprConsent;

package/modules/teadsBidAdapter.js

@@ -190,6 +190,8 @@ function buildRequestObject(bid) {
   const reqObj = {};
   let placementId = getValue(bid.params, 'placementId');
   let pageId = getValue(bid.params, 'pageId');
+  const impressionData = deepAccess(bid, 'ortb2Imp.ext.data');
+  const gpid = deepAccess(impressionData, 'pbadslot') || deepAccess(impressionData, 'adserver.adslot');
 
   reqObj.sizes = getSizes(bid);
   reqObj.bidId = getBidIdParameter('bidId', bid);
@@ -199,6 +201,7 @@ function buildRequestObject(bid) {
   reqObj.adUnitCode = getBidIdParameter('adUnitCode', bid);
   reqObj.auctionId = getBidIdParameter('auctionId', bid);
   reqObj.transactionId = getBidIdParameter('transactionId', bid);
+  if (gpid) { reqObj.gpid = gpid; }
   return reqObj;
 }
 

package/modules/trustxBidAdapter.js

@@ -429,9 +429,10 @@ function addSegments(name, segName, segments, data, bidConfigName) {
   if (segments && segments.length) {
     data.push({
       name: name,
-      segment: segments.map((seg) => {
-        return {name: segName, value: seg};
-      })
+      segment: segments
+        .map((seg) => seg && (seg.id || seg))
+        .filter((seg) => seg && (typeof seg === 'string' || typeof seg === 'number'))
+        .map((seg) => ({ name: segName, value: seg.toString() }))
     });
   } else if (bidConfigName) {
     const configData = config.getConfig('ortb2.user.data');
@@ -445,9 +446,10 @@ function addSegments(name, segName, segments, data, bidConfigName) {
     if (segData && segData.length) {
       data.push({
         name: name,
-        segment: segData.map((seg) => {
-          return {name: segName, value: seg};
-        })
+        segment: segData
+          .map((seg) => seg && (seg.id || seg))
+          .filter((seg) => seg && (typeof seg === 'string' || typeof seg === 'number'))
+          .map((seg) => ({ name: segName, value: seg.toString() }))
       });
     }
   }

package/modules/ventesBidAdapter.js

@@ -0,0 +1,370 @@
+import {registerBidder} from '../src/adapters/bidderFactory.js';
+import {BANNER, NATIVE, VIDEO} from '../src/mediaTypes.js';
+import {convertCamelToUnderscore, isStr, isArray, isNumber, isPlainObject, replaceAuctionPrice} from '../src/utils.js';
+import find from 'core-js-pure/features/array/find.js';
+import includes from 'core-js-pure/features/array/includes.js';
+
+const BID_METHOD = 'POST';
+const BIDDER_URL = 'http://13.234.201.146:8088/va/ad';
+const FIRST_PRICE = 1;
+const NET_REVENUE = true;
+const TTL = 10;
+const USER_PARAMS = ['age', 'externalUid', 'segments', 'gender', 'dnt', 'language'];
+const DEVICE_PARAMS = ['ua', 'geo', 'dnt', 'lmt', 'ip', 'ipv6', 'devicetype'];
+const APP_DEVICE_PARAMS = ['geo', 'device_id']; // appid is collected separately
+const DOMAIN_REGEX = new RegExp('//([^/]*)');
+
+function groupBy(values, key) {
+  const groups = values.reduce((acc, value) => {
+    const groupId = value[key];
+
+    if (!acc[groupId]) acc[groupId] = [];
+    acc[groupId].push(value);
+
+    return acc;
+  }, {});
+
+  return Object
+    .keys(groups)
+    .map(id => ({id, key, values: groups[id]}));
+}
+
+function validateMediaTypes(mediaTypes, allowedMediaTypes) {
+  if (!isPlainObject(mediaTypes)) return false;
+  if (!allowedMediaTypes.some(mediaType => mediaType in mediaTypes)) return false;
+
+  if (isBanner(mediaTypes)) {
+    if (!validateBanner(mediaTypes.banner)) return false;
+  }
+  return true;
+}
+
+function isBanner(mediaTypes) {
+  return isPlainObject(mediaTypes) && isPlainObject(mediaTypes.banner);
+}
+
+function validateBanner(banner) {
+  return isPlainObject(banner) &&
+    isArray(banner.sizes) &&
+    (banner.sizes.length > 0) &&
+    banner.sizes.every(validateMediaSizes);
+}
+
+function validateMediaSizes(mediaSize) {
+  return isArray(mediaSize) &&
+    (mediaSize.length === 2) &&
+    mediaSize.every(size => (isNumber(size) && size >= 0));
+}
+
+function hasUserInfo(bid) {
+  return !!bid.params.user;
+}
+
+function validateParameters(parameters, adUnit) {
+  if (!(parameters.placementId)) {
+    return false;
+  }
+  if (!(parameters.publisherId)) {
+    return false;
+  }
+
+  return true;
+}
+
+function extractSiteDomainFromURL(url) {
+  if (!url || !isStr(url)) return null;
+
+  const domain = url.match(DOMAIN_REGEX);
+
+  if (isArray(domain) && domain.length === 2) return domain[1];
+
+  return null;
+}
+
+function generateSiteFromAdUnitContext(bidRequests, adUnitContext) {
+  if (!adUnitContext || !adUnitContext.refererInfo) return null;
+
+  const domain = extractSiteDomainFromURL(adUnitContext.refererInfo.referer);
+  const publisherId = bidRequests[0].params.publisherId;
+
+  if (!domain) return null;
+
+  return {
+    page: adUnitContext.refererInfo.referer,
+    domain: domain,
+    name: domain,
+    publisher: {
+      id: publisherId
+    }
+  };
+}
+
+function validateServerRequest(serverRequest) {
+  return isPlainObject(serverRequest) &&
+    isPlainObject(serverRequest.data) &&
+    isArray(serverRequest.data.imp)
+}
+
+function createServerRequestFromAdUnits(adUnits, bidRequestId, adUnitContext) {
+  return {
+    method: BID_METHOD,
+    url: BIDDER_URL,
+    data: generateBidRequestsFromAdUnits(adUnits, bidRequestId, adUnitContext),
+    options: {
+      contentType: 'application/json',
+      withCredentials: false,
+    }
+  }
+}
+
+function generateBidRequestsFromAdUnits(bidRequests, bidRequestId, adUnitContext) {
+  const userObjBid = find(bidRequests, hasUserInfo);
+  let userObj = {};
+  if (userObjBid) {
+    Object.keys(userObjBid.params.user)
+      .filter(param => includes(USER_PARAMS, param))
+      .forEach((param) => {
+        let uparam = convertCamelToUnderscore(param);
+        if (param === 'segments' && isArray(userObjBid.params.user[param])) {
+          let segs = [];
+          userObjBid.params.user[param].forEach(val => {
+            if (isNumber(val)) {
+              segs.push({'id': val});
+            } else if (isPlainObject(val)) {
+              segs.push(val);
+            }
+          });
+          userObj[uparam] = segs;
+        } else if (param !== 'segments') {
+          userObj[uparam] = userObjBid.params.user[param];
+        }
+      });
+  }
+
+  const deviceObjBid = find(bidRequests, hasDeviceInfo);
+  let deviceObj;
+  if (deviceObjBid && deviceObjBid.params && deviceObjBid.params.device) {
+    deviceObj = {};
+    Object.keys(deviceObjBid.params.device)
+      .filter(param => includes(DEVICE_PARAMS, param))
+      .forEach(param => deviceObj[param] = deviceObjBid.params.device[param]);
+    if (!deviceObjBid.hasOwnProperty('ua')) {
+      deviceObj.ua = navigator.userAgent;
+    }
+    if (!deviceObjBid.hasOwnProperty('language')) {
+      deviceObj.language = navigator.language;
+    }
+  } else {
+    deviceObj = {};
+    deviceObj.ua = navigator.userAgent;
+    deviceObj.language = navigator.language;
+  }
+  const appDeviceObjBid = find(bidRequests, hasAppInfo);
+  let appIdObj;
+  if (appDeviceObjBid && appDeviceObjBid.params && appDeviceObjBid.params.app && appDeviceObjBid.params.app.id) {
+    Object.keys(appDeviceObjBid.params.app)
+      .filter(param => includes(APP_DEVICE_PARAMS, param))
+      .forEach(param => appDeviceObjBid[param] = appDeviceObjBid.params.app[param]);
+  }
+
+  const payload = {}
+  payload.id = bidRequestId
+  payload.at = FIRST_PRICE
+  payload.cur = ['USD']
+  payload.imp = bidRequests.reduce(generateImpressionsFromAdUnit, [])
+  payload.site = generateSiteFromAdUnitContext(bidRequests, adUnitContext)
+  payload.device = deviceObj
+  if (appDeviceObjBid && payload.site != null) {
+    payload.app = appIdObj;
+  }
+  payload.user = userObj
+  // payload.regs = getRegulationFromAdUnitContext(adUnitContext)
+  // payload.ext = generateBidRequestExtension()
+
+  return payload
+}
+
+function generateImpressionsFromAdUnit(acc, adUnit) {
+  const {bidId, mediaTypes, params} = adUnit;
+  const {placementId} = params;
+  const pmp = {};
+
+  if (placementId) pmp.deals = [{id: placementId}]
+
+  const imps = Object
+    .keys(mediaTypes)
+    .reduce((acc, mediaType) => {
+      const data = mediaTypes[mediaType];
+      const impId = `${bidId}`;
+
+      if (mediaType === 'banner') return acc.concat(generateBannerFromAdUnit(impId, data, params));
+    }, []);
+
+  return acc.concat(imps);
+}
+
+function generateBannerFromAdUnit(impId, data, params) {
+  const {position, placementId} = params;
+  const pos = position || 0;
+  const pmp = {};
+  const ext = {placementId};
+
+  if (placementId) pmp.deals = [{id: placementId}]
+
+  return data.sizes.map(([w, h]) => ({id: `${impId}`, banner: {format: [{w, h}], w, h, pos}, pmp, ext, tagid: placementId}));
+}
+
+function validateServerResponse(serverResponse) {
+  return isPlainObject(serverResponse) &&
+    isPlainObject(serverResponse.body) &&
+    isStr(serverResponse.body.cur) &&
+    isArray(serverResponse.body.seatbid);
+}
+
+function seatBidsToAds(seatBid, bidResponse, serverRequest) {
+  return seatBid.bid
+    .filter(bid => validateBids(bid))
+    .map(bid => generateAdFromBid(bid, bidResponse));
+}
+
+function validateBids(bid) {
+  if (!isPlainObject(bid)) return false;
+  if (!isStr(bid.impid)) return false;
+  if (!isStr(bid.crid)) return false;
+  if (!isNumber(bid.price)) return false;
+  if (!isNumber(bid.w)) return false;
+  if (!isNumber(bid.h)) return false;
+  if (!bid.adm) return false;
+  if (bid.adm) {
+    if (!isStr(bid.adm)) return false;
+  }
+  return true;
+}
+
+const VAST_REGEXP = /VAST\s+version/;
+
+function getMediaType(adm) {
+  const videoRegex = new RegExp(VAST_REGEXP);
+
+  if (videoRegex.test(adm)) {
+    return VIDEO;
+  }
+
+  const markup = safeJSONparse(adm.replace(/\\/g, ''));
+
+  if (markup && isPlainObject(markup.native)) {
+    return NATIVE;
+  }
+
+  return BANNER;
+}
+
+function safeJSONparse(...args) {
+  try {
+    return JSON.parse(...args);
+  } catch (_) {
+    return undefined;
+  }
+}
+
+function generateAdFromBid(bid, bidResponse) {
+  const mediaType = getMediaType(bid.adm);
+  const base = {
+    requestId: bid.impid,
+    cpm: bid.price,
+    currency: bidResponse.cur,
+    ttl: TTL,
+    creativeId: bid.crid,
+    mediaType: mediaType,
+    netRevenue: NET_REVENUE
+  };
+
+  if (bid.adomain) {
+    base.meta = { advertiserDomains: bid.adomain };
+  }
+
+  const size = getSizeFromBid(bid);
+  const creative = getCreativeFromBid(bid);
+
+  return {
+    ...base,
+    height: size.height,
+    width: size.width,
+    ad: creative.markup,
+    adUrl: creative.markupUrl,
+    // vastXml: isVideo && !isStr(creative.markupUrl) ? creative.markup : null,
+    // vastUrl: isVideo && isStr(creative.markupUrl) ? creative.markupUrl : null,
+    renderer: creative.renderer
+  };
+}
+
+function getSizeFromBid(bid) {
+  if (isNumber(bid.w) && isNumber(bid.h)) {
+    return { width: bid.w, height: bid.h };
+  }
+  return { width: null, height: null };
+}
+
+function getCreativeFromBid(bid) {
+  const shouldUseAdMarkup = !!bid.adm;
+  const price = bid.price;
+  return {
+    markup: shouldUseAdMarkup ? replaceAuctionPrice(bid.adm, price) : null,
+    markupUrl: !shouldUseAdMarkup ? replaceAuctionPrice(bid.nurl, price) : null
+  };
+}
+
+function hasDeviceInfo(bid) {
+  if (bid.params) {
+    return !!bid.params.device
+  }
+}
+
+function hasAppInfo(bid) {
+  if (bid.params) {
+    return !!bid.params.app
+  }
+}
+
+const venavenBidderSpec = {
+  code: 'ventes',
+  supportedMediaTypes: [BANNER],
+  isBidRequestValid(adUnit) {
+    const allowedBidderCodes = [this.code];
+
+    return isPlainObject(adUnit) &&
+      allowedBidderCodes.indexOf(adUnit.bidder) !== -1 &&
+      isStr(adUnit.adUnitCode) &&
+      isStr(adUnit.bidderRequestId) &&
+      isStr(adUnit.bidId) &&
+      validateMediaTypes(adUnit.mediaTypes, this.supportedMediaTypes) &&
+      validateParameters(adUnit.params, adUnit);
+  },
+  buildRequests(bidRequests, bidderRequest) {
+    if (!bidRequests) return null;
+
+    return groupBy(bidRequests, 'bidderRequestId').map(group => {
+      const bidRequestId = group.id;
+      const adUnits = groupBy(group.values, 'bidId').map((group) => {
+        const length = group.values.length;
+        return length > 0 && group.values[length - 1]
+      });
+
+      return createServerRequestFromAdUnits(adUnits, bidRequestId, bidderRequest)
+    });
+  },
+  interpretResponse(serverResponse, serverRequest) {
+    if (!validateServerRequest(serverRequest)) return [];
+    if (!validateServerResponse(serverResponse)) return [];
+
+    const bidResponse = serverResponse.body;
+
+    return bidResponse.seatbid
+      .filter(seatBid => isPlainObject(seatBid) && isArray(seatBid.bid))
+      .reduce((acc, seatBid) => acc.concat(seatBidsToAds(seatBid, bidResponse, serverRequest)), []);
+  }
+};
+
+registerBidder(venavenBidderSpec);
+
+export {venavenBidderSpec as spec};

package/modules/ventesBidAdapter.md

@@ -0,0 +1,94 @@
+---
+layout: bidder
+title: ventes
+description: Prebid ventes Bidder Adapter
+pbjs: false
+biddercode: ventes
+gdpr_supported: false
+usp_supported: false
+media_types: banner
+coppa_supported: false
+schain_supported: false
+dchain_supported: false
+prebid_member: false
+---
+
+### BidParams
+{: .table .table-bordered .table-striped }
+| Name            | Scope    | Description                                		 | Example                      		| Type          |
+|-----------------|----------|-----------------------------------------------------------|----------------------------------------------|---------------|
+| `placementId`   | required | Placement ID from Ventes Avenues 			 | `'VA-062-0013-0183'` 			| `string`	|
+| `publisherId`   | required | Publisher ID from Ventes Avenues 			 | `'VA-062'` 					| `string`	|
+| `user`          | optional | Object that specifies information about an external user. | `user: { age: 25, gender: 0, dnt: true}` 	| `object`	|
+| `app`           | required | Object containing mobile app parameters.  		 | `app : { id: 'app-id'}`			| `object`	|
+| `device`        | required | Object containing device info mandatory for mobile devices| `device : { ifa: 'device-id'}`	        | `object`	|
+
+#### User Object
+
+{: .table .table-bordered .table-striped }
+| Name              | Description 										| Example		| Type             	|
+|-------------------|-------------------------------------------------------------------------------------------|-----------------------|-----------------------|
+| `age`             | The age of the user.									| `35`			| `integer`		|
+| `externalUid`     | Specifies a string that corresponds to an external user ID for this user. 		| `'1234567890abcdefg'`	| `string` 		|
+| `segments`        | Specifies the segments to which the user belongs.						| `[1, 2]` 		| `Array<integer>`	|
+| `gender`          | Specifies the gender of the user.  Allowed values: Unknown: `0`; Male: `1`; Female: `2`	| `1` 			| `integer`		|
+| `dnt`             | Do not track flag.  Indicates if tracking cookies should be disabled for this auction	| `true`  	 	| `boolean`		|
+| `language`        | Two-letter ANSI code for this user's language.						| `EN`			| `string`		|
+
+
+### Ad Unit Setup for Banner through mobile devices
+```javascript
+var adUnits = [
+{
+  code: 'test-hb-ad-11111-1',
+  mediaTypes: {
+    banner: {  
+      sizes: [
+          [300, 250]
+      ]
+    }   
+  }, 
+  bids: [{
+    bidder: 'ventes',
+    params: {
+        placementId: 'VA-062-0013-0183',
+        publisherId: '5cebea3c9eea646c7b623d5e',
+        IABCategories: "['IAB1', 'IAB5']",
+        device:{
+          ip: '123.145.167.189',
+          ifa:"AEBE52E7-03EE-455A-B3C4-E57283966239",
+        },
+        app: {
+          id: "agltb3B1Yi1pbmNyDAsSA0FwcBiJkfIUDA",
+          name: "Yahoo Weather",
+          bundle: 'com.kiloo.subwaysurf',
+          storeurl: 'https://play.google.com/store/apps/details?id=com.kiloo.subwaysurf&hl=en',
+          domain: 'somoaudience.com',
+        } 
+    }
+  }]
+ }
+]
+```
+
+### Ad Unit Setup for Banner through Websites
+```javascript
+var adUnits = [
+{
+  code: 'test-hb-ad-11111-1',
+  mediaTypes: {
+    banner: {  
+      sizes: [
+          [300, 250]
+      ]
+    }   
+  }, 
+  bids: [{
+    bidder: 'ventes',
+    params: {
+        placementId: 'VA-002-0007-0799',
+        publisherId: '5cebea3c9eea646c7b623d5e',
+    }
+  }]
+ }
+]