prebid.js 5.17.0 → 6.0.0

package/modules/cwireBidAdapter.js

@@ -0,0 +1,272 @@
+import {registerBidder} from '../src/adapters/bidderFactory.js';
+import { getRefererInfo } from '../src/refererDetection.js';
+import { getStorageManager } from '../src/storageManager.js';
+import {BANNER, VIDEO} from '../src/mediaTypes.js';
+import { OUTSTREAM } from '../src/video.js';
+import {
+  isArray,
+  isNumber,
+  generateUUID,
+  parseSizesInput,
+  deepAccess,
+  getParameterByName,
+  getValue,
+  getBidIdParameter,
+  logError,
+  logWarn,
+} from '../src/utils.js';
+import { Renderer } from '../src/Renderer.js';
+import find from 'core-js-pure/features/array/find.js';
+
+// ------------------------------------
+const BIDDER_CODE = 'cwire';
+export const ENDPOINT_URL = 'https://embed.cwi.re/delivery/prebid';
+export const RENDERER_URL = 'https://cdn.cwi.re/prebid/renderer/LATEST/renderer.min.js';
+// ------------------------------------
+export const CW_PAGE_VIEW_ID = generateUUID();
+const LS_CWID_KEY = 'cw_cwid';
+const CW_GROUPS_QUERY = 'cwgroups';
+
+const storage = getStorageManager();
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param bid
+ * @returns {Array<string>}
+ */
+export function getSlotSizes(bid) {
+  return parseSizesInput(getAllMediaSizes(bid));
+}
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param bid
+ * @returns {*[]}
+ */
+export function getAllMediaSizes(bid) {
+  let playerSizes = deepAccess(bid, 'mediaTypes.video.playerSize');
+  let videoSizes = deepAccess(bid, 'mediaTypes.video.sizes');
+  let bannerSizes = deepAccess(bid, 'mediaTypes.banner.sizes');
+
+  const sizes = [];
+
+  if (isArray(playerSizes)) {
+    playerSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+
+  if (isArray(videoSizes)) {
+    videoSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+
+  if (isArray(bannerSizes)) {
+    bannerSizes.forEach((s) => {
+      sizes.push(s);
+    })
+  }
+  return sizes;
+}
+
+const getQueryVariable = (variable) => {
+  let value = getParameterByName(variable);
+  if (value === '') {
+    value = null;
+  }
+  return value;
+};
+
+/**
+ * ------------------------------------
+ * ------------------------------------
+ * @param validBidRequests
+ * @returns {*[]}
+ */
+export const mapSlotsData = function(validBidRequests) {
+  const slots = [];
+  validBidRequests.forEach(bid => {
+    const bidObj = {};
+    // get the pacement and page ids
+    let placementId = getValue(bid.params, 'placementId');
+    let pageId = getValue(bid.params, 'pageId');
+    let adUnitElementId = getValue(bid.params, 'adUnitElementId');
+    // get the rest of the auction/bid/transaction info
+    bidObj.auctionId = getBidIdParameter('auctionId', bid);
+    bidObj.adUnitCode = getBidIdParameter('adUnitCode', bid);
+    bidObj.adUnitElementId = adUnitElementId;
+    bidObj.bidId = getBidIdParameter('bidId', bid);
+    bidObj.bidderRequestId = getBidIdParameter('bidderRequestId', bid);
+    bidObj.placementId = placementId;
+    bidObj.pageId = pageId;
+    bidObj.mediaTypes = getBidIdParameter('mediaTypes', bid);
+    bidObj.transactionId = getBidIdParameter('transactionId', bid);
+    bidObj.sizes = getSlotSizes(bid);
+    slots.push(bidObj);
+  });
+
+  return slots;
+};
+
+export const spec = {
+  code: BIDDER_CODE,
+  supportedMediaTypes: [BANNER, VIDEO],
+  /**
+   * Determines whether or not the given bid request is valid.
+   *
+   * @param {BidRequest} bid The bid params to validate.
+   * @return boolean True if this is a valid bid, and false otherwise.
+   */
+  isBidRequestValid: function(bid) {
+    bid.params = bid.params || {};
+
+    // if ad unit elemt id not provided - use adUnitCode by default
+    if (!bid.params.adUnitElementId) {
+      bid.params.adUnitElementId = bid.code;
+    }
+
+    if (!bid.params.placementId || !isNumber(bid.params.placementId)) {
+      logError('placementId not provided or invalid');
+      return false;
+    }
+
+    if (!bid.params.pageId || !isNumber(bid.params.pageId)) {
+      logError('pageId not provided');
+      return false;
+    }
+
+    return true;
+  },
+
+  /**
+   * ------------------------------------
+   * Make a server request from the
+   * list of BidRequests.
+   * ------------------------------------
+   * @param {validBidRequests[]} - an array of bids
+   * @return ServerRequest Info describing the request to the server.
+   */
+  buildRequests: function(validBidRequests, bidderRequest) {
+    let slots = [];
+    let referer;
+    try {
+      referer = getRefererInfo().referer;
+      slots = mapSlotsData(validBidRequests);
+    } catch (e) {
+      logWarn(e);
+    }
+
+    let refgroups = [];
+
+    const rgQuery = getQueryVariable(CW_GROUPS_QUERY);
+    if (rgQuery !== null) {
+      refgroups = rgQuery.split(',');
+    }
+
+    const localStorageCWID = storage.localStorageIsEnabled() ? storage.getDataFromLocalStorage(LS_CWID_KEY) : null;
+
+    const payload = {
+      cwid: localStorageCWID,
+      refgroups,
+      slots: slots,
+      httpRef: referer || '',
+      pageViewId: CW_PAGE_VIEW_ID,
+    };
+
+    return {
+      method: 'POST',
+      url: ENDPOINT_URL,
+      data: payload
+    };
+  },
+
+  /**
+   * Unpack the response from the server into a list of bids.
+   *
+   * @param {ServerResponse} serverResponse A successful response from the server.
+   * @return {Bid[]} An array of bids which were nested inside the server.
+   */
+  interpretResponse: function(serverResponse, bidRequest) {
+    const bidResponses = [];
+
+    try {
+      if (typeof bidRequest.data === 'string') {
+        bidRequest.data = JSON.parse(bidRequest.data);
+      }
+      const serverBody = serverResponse.body;
+      serverBody.bids.forEach((br) => {
+        const bidReq = find(bidRequest.data.slots, bid => bid.bidId === br.requestId);
+
+        let mediaType = BANNER;
+
+        const bidResponse = {
+          requestId: br.requestId,
+          cpm: br.cpm,
+          bidderCode: BIDDER_CODE,
+          width: br.dimensions[0],
+          height: br.dimensions[1],
+          creativeId: br.creativeId,
+          currency: br.currency,
+          netRevenue: br.netRevenue,
+          ttl: br.ttl,
+          meta: {
+            advertiserDomains: br.adomains ? br.advertiserDomains : [],
+          },
+
+        };
+
+        // ------------------------------------
+        // IF BANNER
+        // ------------------------------------
+
+        if (deepAccess(bidReq, 'mediaTypes.banner')) {
+          bidResponse.ad = br.html;
+        }
+        // ------------------------------------
+        // IF VIDEO
+        // ------------------------------------
+        if (deepAccess(bidReq, 'mediaTypes.video')) {
+          mediaType = VIDEO;
+          bidResponse.vastXml = br.vastXml;
+          bidResponse.videoScript = br.html;
+          const mediaTypeContext = deepAccess(bidReq, 'mediaTypes.video.context');
+          if (mediaTypeContext === OUTSTREAM) {
+            const r = Renderer.install({
+              id: bidResponse.requestId,
+              adUnitCode: bidReq.adUnitCode,
+              url: RENDERER_URL,
+              loaded: false,
+              config: {
+                ...deepAccess(bidReq, 'mediaTypes.video'),
+                ...deepAccess(br, 'outstream', {})
+              }
+            });
+
+            // set renderer
+            try {
+              bidResponse.renderer = r;
+              bidResponse.renderer.setRender(function(bid) {
+                if (window.CWIRE && window.CWIRE.outstream) {
+                  window.CWIRE.outstream.renderAd(bid);
+                }
+              });
+            } catch (err) {
+              logWarn('Prebid Error calling setRender on newRenderer', err);
+            }
+          }
+        }
+
+        bidResponse.mediaType = mediaType;
+        bidResponses.push(bidResponse);
+      });
+    } catch (e) {
+      logWarn(e);
+    }
+
+    return bidResponses;
+  },
+}
+registerBidder(spec);

package/modules/cwireBidAdapter.md

@@ -0,0 +1,43 @@
+# Overview
+
+Module Name: C-WIRE Bid Adapter
+Module Type: Adagio Adapter
+Maintainer: dragan@cwire.ch
+
+## Description
+
+Connects to C-WIRE demand source to fetch bids.
+
+## Configuration
+
+
+Below, the list of C-WIRE params and where they can be set.
+
+| Param name | Global config | AdUnit config | Type | Required |
+| ---------- | ------------- | ------------- | ---- | ---------|
+| pageId |  | x | number | YES |
+| placementId |  | x | number | YES |
+| adUnitElementId |  | x | string | NO |
+
+### adUnit configuration
+
+```javascript
+var adUnits = [
+  {
+    code: 'target_div_id', // REQUIRED 
+    bids: [{
+      bidder: 'cwire',
+      mediaTypes: {
+        banner: {
+          sizes: [[1, 1]],
+        }
+      },
+      params: {
+        pageId: 1422,                 // required - number
+        placementId: 2211521,         // required - number
+        adUnitElementId: 'other_div', // optional, div id to write to, if not set it will default to ad unit code  
+      }
+    }]
+  }
+];
+```

package/modules/deepintentBidAdapter.js

@@ -1,13 +1,38 @@
-import { generateUUID, deepSetValue, deepAccess, isArray } from '../src/utils.js';
+import { generateUUID, deepSetValue, deepAccess, isArray, isInteger, logError, logWarn } from '../src/utils.js';
 import {registerBidder} from '../src/adapters/bidderFactory.js';
-import {BANNER} from '../src/mediaTypes.js';
+import {BANNER, VIDEO} from '../src/mediaTypes.js';
 const BIDDER_CODE = 'deepintent';
 const BIDDER_ENDPOINT = 'https://prebid.deepintent.com/prebid';
 const USER_SYNC_URL = 'https://cdn.deepintent.com/syncpixel.html';
 const DI_M_V = '1.0.0';
+export const ORTB_VIDEO_PARAMS = {
+  'mimes': (value) => Array.isArray(value) && value.length > 0 && value.every(v => typeof v === 'string'),
+  'minduration': (value) => isInteger(value),
+  'maxduration': (value) => isInteger(value),
+  'protocols': (value) => Array.isArray(value) && value.every(v => v >= 1 && v <= 10),
+  'w': (value) => isInteger(value),
+  'h': (value) => isInteger(value),
+  'startdelay': (value) => isInteger(value),
+  'placement': (value) => Array.isArray(value) && value.every(v => v >= 1 && v <= 5),
+  'linearity': (value) => [1, 2].indexOf(value) !== -1,
+  'skip': (value) => [0, 1].indexOf(value) !== -1,
+  'skipmin': (value) => isInteger(value),
+  'skipafter': (value) => isInteger(value),
+  'sequence': (value) => isInteger(value),
+  'battr': (value) => Array.isArray(value) && value.every(v => v >= 1 && v <= 17),
+  'maxextended': (value) => isInteger(value),
+  'minbitrate': (value) => isInteger(value),
+  'maxbitrate': (value) => isInteger(value),
+  'boxingallowed': (value) => [0, 1].indexOf(value) !== -1,
+  'playbackmethod': (value) => Array.isArray(value) && value.every(v => v >= 1 && v <= 6),
+  'playbackend': (value) => [1, 2, 3].indexOf(value) !== -1,
+  'delivery': (value) => [1, 2, 3].indexOf(value) !== -1,
+  'pos': (value) => [0, 1, 2, 3, 4, 5, 6, 7].indexOf(value) !== -1,
+  'api': (value) => Array.isArray(value) && value.every(v => v >= 1 && v <= 6)
+};
 export const spec = {
   code: BIDDER_CODE,
-  supportedMediaTypes: [BANNER],
+  supportedMediaTypes: [BANNER, VIDEO],
   aliases: [],
 
   // tagId is mandatory param
@@ -15,16 +40,38 @@ export const spec = {
     let valid = false;
     if (bid && bid.params && bid.params.tagId) {
       if (typeof bid.params.tagId === 'string' || bid.params.tagId instanceof String) {
-        valid = true;
+        if (bid.hasOwnProperty('mediaTypes') && bid.mediaTypes.hasOwnProperty(VIDEO)) {
+          if (bid.mediaTypes[VIDEO].hasOwnProperty('context')) {
+            valid = true;
+          }
+        } else {
+          valid = true;
+        }
       }
     }
     return valid;
   },
-  interpretResponse: function(bidResponse, request) {
+  interpretResponse: function(bidResponse, bidRequest) {
     let responses = [];
     if (bidResponse && bidResponse.body) {
-      let bids = bidResponse.body.seatbid && bidResponse.body.seatbid[0] ? bidResponse.body.seatbid[0].bid : [];
-      responses = bids.map(bid => formatResponse(bid))
+      try {
+        let bids = bidResponse.body.seatbid && bidResponse.body.seatbid[0] ? bidResponse.body.seatbid[0].bid : [];
+        if (bids) {
+          bids.forEach(bidObj => {
+            let newBid = formatResponse(bidObj);
+            let mediaType = _checkMediaType(bidObj);
+            if (mediaType === BANNER) {
+              newBid.mediaType = BANNER;
+            } else if (mediaType === VIDEO) {
+              newBid.mediaType = VIDEO;
+              newBid.vastXml = bidObj.adm;
+            }
+            responses.push(newBid);
+          });
+        }
+      } catch (err) {
+        logError(err);
+      }
     }
     return responses;
   },
@@ -73,6 +120,17 @@ export const spec = {
   }
 
 };
+function _checkMediaType(bid) {
+  let videoRegex = new RegExp(/VAST\s+version/);
+  let mediaType;
+  if (bid.adm && bid.adm.indexOf('deepintent_wrapper') >= 0) {
+    mediaType = BANNER;
+  } else if (videoRegex.test(bid.adm)) {
+    mediaType = VIDEO;
+  }
+  return mediaType;
+}
+
 function clean(obj) {
   for (let propName in obj) {
     if (obj[propName] === null || obj[propName] === undefined) {
@@ -100,16 +158,55 @@ function formatResponse(bid) {
 }
 
 function buildImpression(bid) {
-  return {
+  let impression = {};
+  impression = {
     id: bid.bidId,
     tagid: bid.params.tagId || '',
     secure: window.location.protocol === 'https' ? 1 : 0,
-    banner: buildBanner(bid),
     displaymanager: 'di_prebid',
     displaymanagerver: DI_M_V,
     ext: buildCustomParams(bid)
   };
+  if (deepAccess(bid, 'mediaTypes.banner')) {
+    impression['banner'] = buildBanner(bid);
+  }
+  if (deepAccess(bid, 'mediaTypes.video')) {
+    impression['video'] = _buildVideo(bid);
+  }
+  return impression;
 }
+
+function _buildVideo(bid) {
+  const videoObj = {};
+  const videoAdUnitParams = deepAccess(bid, 'mediaTypes.video', {});
+  const videoBidderParams = deepAccess(bid, 'params.video', {});
+  const computedParams = {};
+
+  if (Array.isArray(videoAdUnitParams.playerSize)) {
+    const tempSize = (Array.isArray(videoAdUnitParams.playerSize[0])) ? videoAdUnitParams.playerSize[0] : videoAdUnitParams.playerSize;
+    computedParams.w = tempSize[0];
+    computedParams.h = tempSize[1];
+  }
+
+  const videoParams = {
+    ...computedParams,
+    ...videoAdUnitParams,
+    ...videoBidderParams
+  };
+
+  Object.keys(ORTB_VIDEO_PARAMS).forEach(paramName => {
+    if (videoParams.hasOwnProperty(paramName)) {
+      if (ORTB_VIDEO_PARAMS[paramName](videoParams[paramName])) {
+        videoObj[paramName] = videoParams[paramName];
+      } else {
+        logWarn(`The OpenRTB video param ${paramName} has been skipped due to misformating. Please refer to OpenRTB 2.5 spec.`);
+      }
+    }
+  });
+
+  return videoObj;
+};
+
 function buildCustomParams(bid) {
   if (bid.params && bid.params.custom) {
     return {

package/modules/deepintentBidAdapter.md

@@ -8,7 +8,7 @@ Maintainer: prebid@deepintent.com
 
 # Description
 
-Deepintent currently supports the BANNER type ads through prebid js
+Deepintent currently supports the BANNER and VIDEO type ads through prebid js
 
 Module that connects to Deepintent's demand sources.
 
@@ -40,6 +40,41 @@ Module that connects to Deepintent's demand sources.
   ];
 ```
 
+# Sample Video Ad Unit
+```
+var adVideoAdUnits = [
+{
+    code: 'test-div-video',
+    mediaTypes: {
+        video: {
+            playerSize: [640, 480],           // required
+            context: 'instream'               //required
+        }
+    },
+    bids: [{
+      bidder: 'deepintent',
+      params: {
+        tagId: '1300',  // Required parameter                 // required
+        video: {
+          mimes: ['video/mp4','video/x-flv'],   // required
+          skippable: true,                      // optional
+          minduration: 5,                       // optional
+          maxduration: 30,                      // optional
+          startdelay: 5,                        // optional
+          playbackmethod: [1,3],                // optional
+          api: [ 1, 2 ],                        // optional
+          protocols: [ 2, 3 ],                  // optional
+          battr: [ 13, 14 ],                    // optional
+          linearity: 1,                         // optional
+          placement: 2,                         // optional
+          minbitrate: 10,                       // optional
+          maxbitrate: 10                        // optional
+        }
+      }
+    }]
+}]
+```
+
 ###Recommended User Sync Configuration
 
 ```javascript