Add a new Paradocs adapter

modules/paradocsBidAdapter.js

@@ -0,0 +1,150 @@
+import * as utils from '../src/utils.js';
+import {registerBidder} from '../src/adapters/bidderFactory.js';
+import {getBidIdParameter} from '../src/utils.js';
+
+const BIDDER_CODE = 'paradocs';
+let styleParamsMap = {
+  'title.family': 'f1', // headerFont
+  'title.size': 'fs1', // headerFontSize
+  'title.weight': 'w1', // headerWeight
+  'title.style': 's1', // headerStyle
+  'title.color': 'c3', // headerColor
+  'description.family': 'f2', // descriptionFont
+  'description.size': 'fs2', // descriptionFontSize
+  'description.weight': 'w2', // descriptionWeight
+  'description.style': 's2', // descriptionStyle
+  'description.color': 'c4', // descriptionColor
+  'url.family': 'f3', // urlFont
+  'url.size': 'fs3', // urlFontSize
+  'url.weight': 'w3', // urlWeight
+  'url.style': 's3', // urlStyle
+  'url.color': 'c5', // urlColor
+  'colors.background': 'c2', // borderColor
+  'colors.border': 'c1', // borderColor
+  'colors.link': 'c6', // lnkColor
+};
+export const spec = {
+  code: BIDDER_CODE,
+  aliases: ['oas', '152media'], // short code and customer aliases
+  isBidRequestValid: function (bid) {
+    switch (true) {
+      case !('params' in bid):
+        utils.logError(bid.bidder + ': No required params');
+        return false;
+      case !(bid.params.placementId):
+        utils.logError(bid.bidder + ': No required param placementId');
+        return false;
+      case !(bid.params.requestUrl):
+        utils.logError(bid.bidder + ': No required param requestUrl');
+        return false;
+    }
+    return true;
+  },
+  buildRequests: function (validBidRequests) {
+    let bidRequest;
+    let serverRequests = [];
+    for (let i = 0; i < validBidRequests.length; i++) {
+      bidRequest = validBidRequests[i];
+      let bidRequestParams = bidRequest.params;
+      let placementId = getBidIdParameter('placementId', bidRequestParams);
+      let requestUrl = getBidIdParameter('requestUrl', bidRequestParams);
+      let referrer = getBidIdParameter('ref', bidRequestParams);
+      let location = getBidIdParameter('loc', bidRequestParams);
+      // Append location & referrer
+      if (location === '') {
+        location = utils.getWindowLocation();
+      }
+      if (referrer === '' && bidRequest && bidRequest.refererInfo) {
+        referrer = bidRequest.refererInfo.referer;
+      }
+
+      // Styles params
+      let stylesParams = getBidIdParameter('style', bidRequestParams);
+      let stylesParamsArray = {};
+      for (let currentValue in stylesParams) {
+        if (stylesParams.hasOwnProperty(currentValue)) {
+          let currentStyle = stylesParams[currentValue];
+          for (let field in currentStyle) {
+            if (currentStyle.hasOwnProperty(field)) {
+              let styleField = styleParamsMap[currentValue + '.' + field];
+              if (typeof styleField !== 'undefined') {
+                stylesParamsArray[styleField] = currentStyle[field];
+              }
+            }
+          }
+        }
+      }
+      // Custom params
+      let customParams = getBidIdParameter('customParams', bidRequestParams);
+      let customParamsArray = {};
+      for (let customField in customParams) {
+        if (customParams.hasOwnProperty(customField)) {
+          customParamsArray['c.' + customField] = customParams[customField];
+        }
+      }
+
+      // Sizes params (not supports by server, for future features)
+      let sizesParams = bidRequest.sizes;
+      let parsedSizes = utils.parseSizesInput(sizesParams);
+      let requestData = Object.assign({
+        'scid': placementId,
+        'callback_uid': utils.generateUUID(),
+        'loc': location,
+        'ref': referrer,
+        'size': parsedSizes
+      }, stylesParamsArray, customParamsArray);
+
+      serverRequests.push({
+        method: 'POST',
+        url: requestUrl,
+        data: requestData,
+        options: {withCredentials: false},
+        bidRequest: bidRequest
+      });
+    }
+    return serverRequests;
+  },
+  interpretResponse: function (serverResponse, request) {
+    let bidResponses = [];
+    if (!serverResponse || serverResponse.error) {
+      utils.logError(BIDDER_CODE + ': Server response error');
+      return bidResponses;
+    }
+
+    const serverBody = serverResponse.body;
+    if (!serverBody) {
+      utils.logError(BIDDER_CODE + ': Empty bid response');
+      return bidResponses;
+    }
+
+    const CPM = serverBody.cpm;
+    const WIDTH = serverBody.width;
+    const HEIGHT = serverBody.height;
+    const CREATIVE = serverBody.content_url;
+    const CALLBACK_UID = serverBody.callback_uid;
+    const TIME_TO_LIVE = 60;
+    const REFERER = utils.getWindowTop();
+    let bidRequest = request.bidRequest;
+    if (CPM > 0 && WIDTH > 0 && HEIGHT > 0) {
+      let bidResponse = {
+        requestId: bidRequest.bidId,
+        cpm: CPM,
+        width: WIDTH,
+        height: HEIGHT,
+        creativeId: CALLBACK_UID,
+        ttl: TIME_TO_LIVE,
+        referrer: REFERER,
+        currency: 'USD',
+        netRevenue: true,
+        adUrl: CREATIVE,
+        meta: {
+          advertiserDomains: serverBody.adomain ? serverBody.adomain : []
+        }
+      };
+      bidResponses.push(bidResponse);
+    }
+
+    return bidResponses;
+  }
+};
+registerBidder(spec);

modules/paradocsBidAdapter.md

@@ -0,0 +1,67 @@
+
+# Overview
+
+```
+Module Name: Paradocs Bidder Adapter
+Module Type: Bidder Adapter
+
+```
+
+# Description
+
+Module that connects to the Paradocs system
+
+# Test Parameters
+
+A test ad unit that will consistently return test creatives:
+
+```
+
+adUnits = [{
+    code: 'paradocs-div-id',
+    mediaTypes: {
+        banner: {
+            sizes: [[468, 60]]
+        }
+    },
+    bids: [{
+        bidder: 'paradocs',
+        params: {
+            placementId: 'ABC1234567890',
+            requestUrl: 'https://header.bidder/endpoint/url',
+            style: {
+                title: {
+                    family: "Tahoma",
+                    size: "medium",
+                    weight: "normal",
+                    style: "normal",
+                    color: "0053F9"
+                },
+                description: {
+                    family: "Tahoma",
+                    size: "medium",
+                    weight: "normal",
+                    style: "normal",
+                    color: "000000"
+                },
+                url: {
+                    family: "Tahoma",
+                    size: "medium",
+                    weight: "normal",
+                    style: "normal",
+                    color: "828282"
+                },
+                colors: {
+                    background: "ffffff",
+                    border: "E0E0E0",
+                    link: "5B99FE"
+                }
+            },
+            customParams: {
+                cacheBuster: "",
+                clickUrl: ""
+            }
+        }
+    }]
+}];
+```