prebid.js 6.26.0 → 6.27.0

package/modules/taboolaBidAdapter.js

@@ -0,0 +1,265 @@
+'use strict';
+
+import {registerBidder} from '../src/adapters/bidderFactory.js';
+import {BANNER} from '../src/mediaTypes.js';
+import {config} from '../src/config.js';
+import {getWindowSelf, getWindowTop} from '../src/utils.js'
+import {getStorageManager} from '../src/storageManager.js';
+
+const BIDDER_CODE = 'taboola';
+const GVLID = 42;
+const CURRENCY = 'USD';
+export const END_POINT_URL = 'http://hb.bidder.taboola.com/TaboolaHBOpenRTBRequestHandlerServlet';
+const USER_ID = 'user-id';
+const STORAGE_KEY = `taboola global:${USER_ID}`;
+const COOKIE_KEY = 'trc_cookie_storage';
+
+/**
+ *  extract User Id by that order:
+ * 1. local storage
+ * 2. first party cookie
+ * 3. rendered trc
+ * 4. new user set it to 0
+ */
+export const userData = {
+  storageManager: getStorageManager({gvlid: GVLID, bidderCode: BIDDER_CODE}),
+  getUserId: () => {
+    const {getFromLocalStorage, getFromCookie, getFromTRC} = userData;
+
+    try {
+      return getFromLocalStorage() || getFromCookie() || getFromTRC();
+    } catch (ex) {
+      return 0;
+    }
+  },
+  getFromCookie() {
+    const {cookiesAreEnabled, getCookie} = userData.storageManager;
+    if (cookiesAreEnabled()) {
+      const cookieData = getCookie(COOKIE_KEY);
+      const userId = userData.getCookieDataByKey(cookieData, USER_ID);
+      if (userId) {
+        return userId;
+      }
+    }
+  },
+  getCookieDataByKey(cookieData, key) {
+    const [, value = ''] = cookieData.split(`${key}=`)
+    return value;
+  },
+  getFromLocalStorage() {
+    const {hasLocalStorage, localStorageIsEnabled, getDataFromLocalStorage} = userData.storageManager;
+
+    if (hasLocalStorage() && localStorageIsEnabled()) {
+      return getDataFromLocalStorage(STORAGE_KEY);
+    }
+  },
+  getFromTRC() {
+    return window.TRC ? window.TRC.user_id : 0;
+  }
+}
+
+export const internal = {
+  getPageUrl: (refererInfo = {}) => {
+    if (refererInfo.canonicalUrl) {
+      return refererInfo.canonicalUrl;
+    }
+
+    if (config.getConfig('pageUrl')) {
+      return config.getConfig('pageUrl');
+    }
+
+    try {
+      return getWindowTop().location.href;
+    } catch (e) {
+      return getWindowSelf().location.href;
+    }
+  },
+  getReferrer: (refererInfo = {}) => {
+    if (refererInfo.referer) {
+      return refererInfo.referer;
+    }
+
+    try {
+      return getWindowTop().document.referrer;
+    } catch (e) {
+      return getWindowSelf().document.referrer;
+    }
+  }
+}
+
+export const spec = {
+  supportedMediaTypes: [BANNER],
+  gvlid: GVLID,
+  code: BIDDER_CODE,
+  isBidRequestValid: (bidRequest) => {
+    return !!(bidRequest.sizes &&
+              bidRequest.params &&
+              bidRequest.params.publisherId &&
+              bidRequest.params.tagId);
+  },
+  buildRequests: (validBidRequests, bidderRequest) => {
+    const [bidRequest] = validBidRequests;
+    const {refererInfo, gdprConsent = {}, uspConsent} = bidderRequest;
+    const {publisherId} = bidRequest.params;
+    const site = getSiteProperties(bidRequest.params, refererInfo);
+    const device = {ua: navigator.userAgent};
+    const imps = getImps(validBidRequests);
+    const user = {
+      buyeruid: userData.getUserId(gdprConsent, uspConsent),
+      ext: {}
+    };
+    const regs = {
+      coppa: 0,
+      ext: {}
+    };
+
+    if (gdprConsent.gdprApplies) {
+      user.ext.consent = bidderRequest.gdprConsent.consentString;
+      regs.ext.gdpr = 1;
+    }
+
+    if (uspConsent) {
+      regs.ext.us_privacy = uspConsent;
+    }
+
+    if (config.getConfig('coppa')) {
+      regs.coppa = 1
+    }
+
+    const ortb2 = config.getConfig('ortb2') || {
+      badv: [],
+      bcat: []
+    };
+
+    const request = {
+      id: bidderRequest.auctionId,
+      imp: imps,
+      site,
+      device,
+      source: {fd: 1},
+      tmax: bidderRequest.timeout,
+      bcat: ortb2.bcat,
+      badv: ortb2.badv,
+      user,
+      regs
+    };
+
+    const url = [END_POINT_URL, publisherId].join('/');
+
+    return {
+      url,
+      method: 'POST',
+      data: JSON.stringify(request),
+      bids: validBidRequests,
+      options: {
+        withCredentials: false
+      },
+    };
+  },
+  interpretResponse: (serverResponse, {bids}) => {
+    if (!bids) {
+      return [];
+    }
+
+    const {bidResponses, cur: currency} = getBidResponses(serverResponse);
+
+    if (!bidResponses) {
+      return [];
+    }
+
+    return bids.map((bid, id) => getBid(bid.bidId, currency, bidResponses[id])).filter(Boolean);
+  },
+};
+
+function getSiteProperties({publisherId, bcat = []}, refererInfo) {
+  const {getPageUrl, getReferrer} = internal;
+  return {
+    id: publisherId,
+    name: publisherId,
+    domain: window.location.host,
+    page: getPageUrl(refererInfo),
+    ref: getReferrer(refererInfo),
+    publisher: {
+      id: publisherId
+    },
+    content: {
+      language: navigator.language
+    }
+  }
+}
+
+function getImps(validBidRequests) {
+  return validBidRequests.map((bid, id) => {
+    const {tagId, bidfloor = null, bidfloorcur = CURRENCY} = bid.params;
+
+    return {
+      id: id + 1,
+      banner: getBanners(bid),
+      tagid: tagId,
+      bidfloor,
+      bidfloorcur,
+    };
+  });
+}
+
+function getBanners(bid) {
+  return getSizes(bid.sizes);
+}
+
+function getSizes(sizes) {
+  return {
+    format: sizes.map(size => {
+      return {
+        w: size[0],
+        h: size[1]
+      }
+    })
+  }
+}
+
+function getBidResponses({body}) {
+  if (!body) {
+    return [];
+  }
+
+  const {seatbid, cur} = body;
+
+  if (!seatbid.length || !seatbid[0].bid) {
+    return [];
+  }
+
+  return {
+    bidResponses: seatbid[0].bid,
+    cur
+  };
+}
+
+function getBid(requestId, currency, bidResponse) {
+  if (!bidResponse) {
+    return;
+  }
+
+  const {
+    price: cpm, crid: creativeId, adm: ad, w: width, h: height, adomain: advertiserDomains, meta = {}
+  } = bidResponse;
+
+  if (advertiserDomains && advertiserDomains.length > 0) {
+    meta.advertiserDomains = advertiserDomains
+  }
+
+  return {
+    requestId,
+    ttl: 360,
+    mediaType: BANNER,
+    cpm,
+    creativeId,
+    currency,
+    ad,
+    width,
+    height,
+    meta,
+    netRevenue: false
+  };
+}
+
+registerBidder(spec);

package/modules/taboolaBidAdapter.md

@@ -0,0 +1,49 @@
+# Overview
+
+```
+Module Name: Taboola Adapter
+Module Type: Bidder Adapter
+Maintainer: prebid@taboola.com
+```
+
+# Description
+
+Module that connects to Taboola bidder to fetch bids.
+- Supports `display` format
+- Uses `OpenRTB` standard
+
+The Taboola Bidding adapter requires setup before beginning. Please contact us on prebid@taboola.com
+
+# Test Display Parameters
+``` javascript
+ var adUnits = [{
+  code: 'your-unit-container-id',
+  mediaTypes: {
+    banner: {
+      sizes: [[300, 250], [300,600]]
+    }
+  },
+  bids: [{
+    bidder: 'taboola',
+    params: {
+      tagId: 'tester-placement', // Placement Name
+      publisherId: 'tester-pub', // your-publisher-id
+      bidfloor: 0.25, // Optional - default is null
+      bcat: ['IAB1-1'], // Optional - default is []
+      badv: ['example.com']  // Optional - default is []
+    }
+  }]
+}];
+```
+
+# Parameters
+
+| Name           | Scope    | Description                                             | Example                    | Type         |
+|----------------|----------|---------------------------------------------------------|----------------------------|--------------|
+| `tagId`        | required | Tag ID / Placement Name <br>(as provided by Taboola)    | `'Below The Article'`      | `String`     |
+| `publisherId`  | required | Alphabetic Publisher ID <br>(as provided by Taboola)    | `'acme-publishing'`        | `String`     |
+| `bcat`         | optional | List of blocked advertiser categories (IAB)             | `['IAB1-1']`               | `Array`      |
+| `badv`         | optional | Blocked Advertiser Domains                              | `'example.com'`            | `String Url` |
+| `bidfloor`     | optional | CPM bid floor                                           | `0.25`                     | `Integer`    |
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prebid.js",
-  "version": "6.26.0",
+  "version": "6.27.0",
   "description": "Header Bidding Management Library",
   "main": "src/prebid.js",
   "scripts": {

package/src/AnalyticsAdapter.js

@@ -3,6 +3,10 @@ import { ajax } from './ajax.js';
 import { logMessage, _each } from './utils.js';
 import * as events from './events.js'
 
+export const _internal = {
+  ajax
+};
+
 const {
   EVENTS: {
     AUCTION_INIT,
@@ -61,7 +65,7 @@ export default function AnalyticsAdapter({ url, analyticsType, global, handler }
   }
 
   function _callEndpoint({ eventType, args, callback }) {
-    ajax(url, callback, JSON.stringify({ eventType, args }));
+    _internal.ajax(url, callback, JSON.stringify({ eventType, args }));
   }
 
   function _enqueue({ eventType, args }) {

package/src/adloader.js

@@ -10,7 +10,8 @@ const _approvedLoadExternalJSList = [
   'adagio',
   'browsi',
   'brandmetrics',
-  'justtag'
+  'justtag',
+  'akamaidap'
 ]
 
 /**

package/test/mocks/analyticsStub.js

@@ -0,0 +1,13 @@
+import {_internal} from '../../src/AnalyticsAdapter.js';
+
+before(() => {
+  // stub out analytics networking to avoid random events polluting the global xhr mock
+  disableAjaxForAnalytics();
+})
+
+export function disableAjaxForAnalytics() {
+  sinon.stub(_internal, 'ajax').callsFake(() => null);
+}
+export function enableAjaxForAnalytics() {
+  _internal.ajax.restore();
+}

package/test/mocks/xhr.js

@@ -1,3 +1,4 @@
+import {getUniqueIdentifierStr} from '../../src/utils.js';
 
 export let server = sinon.createFakeServer();
 export let xhr = global.XMLHttpRequest;
@@ -7,3 +8,24 @@ beforeEach(function() {
   server = sinon.createFakeServer();
   xhr = global.XMLHttpRequest;
 });
+
+const bid = getUniqueIdentifierStr().substring(4);
+let fid = 0;
+
+/* eslint-disable */
+afterEach(function () {
+  if (this?.currentTest?.state === 'failed') {
+    const prepend = (() => {
+      const preamble = `[Failure ${bid}-${fid++}]`;
+      return (s) => s.split('\n').map(s => `${preamble} ${s}`).join('\n');
+    })();
+
+
+    console.log(prepend(`XHR mock state after failure (for test '${this.currentTest.fullTitle()}'): ${server.requests.length} requests`))
+    server.requests.forEach((req, i) => {
+      console.log(prepend(`Request #${i}:`));
+      console.log(prepend(JSON.stringify(req, null, 2)));
+    })
+  }
+});
+/* eslint-enable */

package/test/spec/AnalyticsAdapter_spec.js

@@ -2,6 +2,7 @@ import { expect } from 'chai';
 import * as events from 'src/events.js';
 import CONSTANTS from 'src/constants.json';
 import { server } from 'test/mocks/xhr.js';
+import {disableAjaxForAnalytics, enableAjaxForAnalytics} from '../mocks/analyticsStub.js';
 
 const REQUEST_BIDS = CONSTANTS.EVENTS.REQUEST_BIDS;
 const BID_REQUESTED = CONSTANTS.EVENTS.BID_REQUESTED;
@@ -25,6 +26,9 @@ FEATURE: Analytics Adapters API
     AND an  \`example\` instance of \`AnalyticsAdapter\`\n`, () => {
   let adapter;
 
+  before(enableAjaxForAnalytics);
+  after(disableAjaxForAnalytics);
+
   beforeEach(function () {
     adapter = new AnalyticsAdapter(config);
   });