prebid.js 9.26.0 → 9.28.0

package/modules/blueBidAdapter.md

@@ -0,0 +1,28 @@
+# Overview
+
+Module Name: Blue Bidder Adapter
+Module Type: Bidder Adapter
+Maintainer: celsooliveira@getblue.io
+
+# Description
+
+Module that connects to Blue's demand sources.
+
+# Test Parameters
+```
+    var adUnits = [
+        {
+            code: 'banner-ad-div',
+            sizes: [[300, 250], [728, 90]],
+            bids: [
+                {
+                    bidder: 'blue',
+                    params: {
+                        publisherId: "xpto",
+                        placementId: "xpto",
+                    }
+                }
+            ]
+        }
+    ];
+```

package/modules/conceptxBidAdapter.js

@@ -5,10 +5,12 @@ import { BANNER } from '../src/mediaTypes.js';
 const BIDDER_CODE = 'conceptx';
 const ENDPOINT_URL = 'https://conceptx.cncpt-central.com/openrtb';
 // const LOG_PREFIX = 'ConceptX: ';
+const GVLID = 1340;
 
 export const spec = {
   code: BIDDER_CODE,
   supportedMediaTypes: [BANNER],
+  gvlid: GVLID,
   isBidRequestValid: function (bid) {
     return !!(bid.bidId && bid.params.site && bid.params.adunit);
   },

package/modules/consumableBidAdapter.js

@@ -33,7 +33,8 @@ export const spec = {
   /**
    * Make a server request from the list of BidRequests.
    *
-   * @param {validBidRequests[]} - an array of bids
+   * @param {validBidRequests[]} validBidRequests An array of bids
+   * @param {Object} bidderRequest The bidder's request info.
    * @return ServerRequest Info describing the request to the server.
    */
 
@@ -300,6 +301,7 @@ function retrieveAd(decision, unitId, unitName) {
 function handleEids(data, validBidRequests) {
   let bidUserIdAsEids = deepAccess(validBidRequests, '0.userIdAsEids');
   if (isArray(bidUserIdAsEids) && bidUserIdAsEids.length > 0) {
+    bidUserIdAsEids = bidUserIdAsEids.filter(e => typeof e === 'object');
     deepSetValue(data, 'user.eids', bidUserIdAsEids);
   } else {
     deepSetValue(data, 'user.eids', undefined);

package/modules/contxtfulBidAdapter.js

@@ -8,7 +8,7 @@ import {
   interpretResponse,
   getUserSyncs as getUserSyncsLib,
 } from '../libraries/teqblazeUtils/bidderUtils.js';
-import {ortbConverter} from '../libraries/ortbConverter/converter.js';
+import { ortbConverter } from '../libraries/ortbConverter/converter.js';
 
 // Constants
 const BIDDER_CODE = 'contxtful';
@@ -16,6 +16,7 @@ const BIDDER_ENDPOINT = 'prebid.receptivity.io';
 const MONITORING_ENDPOINT = 'monitoring.receptivity.io';
 const DEFAULT_NET_REVENUE = true;
 const DEFAULT_TTL = 300;
+const DEFAULT_SAMPLING_RATE = 1.0;
 const PREBID_VERSION = '$prebid.version$';
 
 // ORTB conversion
@@ -74,7 +75,7 @@ const extractParameters = (config) => {
 
 // Construct the Payload towards the Bidding endpoint
 const buildRequests = (validBidRequests = [], bidderRequest = {}) => {
-  const ortb2 = converter.toORTB({bidderRequest: bidderRequest, bidRequests: validBidRequests});
+  const ortb2 = converter.toORTB({ bidderRequest: bidderRequest, bidRequests: validBidRequests });
 
   const bidRequests = [];
   _each(validBidRequests, bidRequest => {
@@ -87,14 +88,14 @@ const buildRequests = (validBidRequests = [], bidderRequest = {}) => {
   });
   const config = pbjsConfig.getConfig();
   config.pbjsVersion = PREBID_VERSION;
-  const {version, customer} = extractParameters(config)
+  const { version, customer } = extractParameters(config)
   const adapterUrl = buildUrl({
     protocol: 'https',
     host: BIDDER_ENDPOINT,
     pathname: `/${version}/prebid/${customer}/bid`,
   });
 
-  // https://docs.prebid.org/dev-docs/bidder-adaptor.html
+  // See https://docs.prebid.org/dev-docs/bidder-adaptor.html
   let req = {
     url: adapterUrl,
     method: 'POST',
@@ -147,7 +148,18 @@ const getUserSyncs = (syncOptions, serverResponses, gdprConsent, uspConsent, gpp
 // Retrieve the sampling rate for events
 const getSamplingRate = (bidderConfig, eventType) => {
   const entry = Object.entries(bidderConfig?.contxtful?.sampling ?? {}).find(([key, value]) => key.toLowerCase() === eventType.toLowerCase());
-  return entry ? entry[1] : 0.001;
+  return entry ? entry[1] : DEFAULT_SAMPLING_RATE;
+};
+
+const logBidderError = ({ error, bidderRequest }) => {
+  if (error) {
+    let jsonReason = {
+      message: error.reason?.message,
+      stack: error.reason?.stack,
+    };
+    error.reason = jsonReason;
+  }
+  logEvent('onBidderError', { error, bidderRequest });
 };
 
 // Handles the logging of events
@@ -158,13 +170,13 @@ const logEvent = (eventType, data) => {
 
     // Get Config
     const bidderConfig = pbjsConfig.getConfig();
-    const {version, customer} = extractParameters(bidderConfig);
+    const { version, customer } = extractParameters(bidderConfig);
 
     // Sampled monitoring
     if (['onBidBillable', 'onAdRenderSucceeded'].includes(eventType)) {
       const randomNumber = Math.random();
       const samplingRate = getSamplingRate(bidderConfig, eventType);
-      if (randomNumber >= samplingRate) {
+      if (!(randomNumber <= samplingRate)) {
         return; // Don't sample
       }
     } else if (!['onTimeout', 'onBidderError', 'onBidWon'].includes(eventType)) {
@@ -205,12 +217,12 @@ export const spec = {
   buildRequests,
   interpretResponse,
   getUserSyncs,
-  onBidWon: function(bid) { logEvent('onBidWon', bid); },
-  onBidBillable: function(bid) { logEvent('onBidBillable', bid); },
-  onAdRenderSucceeded: function(bid) { logEvent('onAdRenderSucceeded', bid); },
-  onSetTargeting: function(bid) { },
-  onTimeout: function(timeoutData) { logEvent('onTimeout', timeoutData); },
-  onBidderError: function({ error, bidderRequest }) { logEvent('onBidderError', { error, bidderRequest }); },
+  onBidWon: function (bid) { logEvent('onBidWon', bid); },
+  onBidBillable: function (bid) { logEvent('onBidBillable', bid); },
+  onAdRenderSucceeded: function (bid) { logEvent('onAdRenderSucceeded', bid); },
+  onSetTargeting: function (bid) { },
+  onTimeout: function (timeoutData) { logEvent('onTimeout', timeoutData); },
+  onBidderError: logBidderError,
 };
 
 registerBidder(spec);

package/modules/contxtfulRtdProvider.js

@@ -15,6 +15,7 @@ import {
   isEmpty,
   buildUrl,
   isArray,
+  generateUUID,
 } from '../src/utils.js';
 import { loadExternalScript } from '../src/adloader.js';
 import { getStorageManager } from '../src/storageManager.js';
@@ -26,13 +27,17 @@ const MODULE = `${MODULE_NAME}RtdProvider`;
 const CONTXTFUL_HOSTNAME_DEFAULT = 'api.receptivity.io';
 const CONTXTFUL_DEFER_DEFAULT = 0;
 
+let _sm;
+function sm() {
+  return _sm ??= generateUUID();
+}
+
 const storageManager = getStorageManager({
   moduleType: MODULE_TYPE_RTD,
   moduleName: MODULE_NAME,
 });
 
 let rxApi = null;
-let isFirstBidRequestCall = true;
 
 /**
  * Return current receptivity value for the requester.
@@ -150,7 +155,7 @@ function initCustomer(config) {
 
   addConnectorEventListener(customer, config);
 
-  const loadScript = () => loadExternalScript(CONNECTOR_URL, MODULE_TYPE_RTD, MODULE_NAME);
+  const loadScript = () => loadExternalScript(CONNECTOR_URL, MODULE_TYPE_RTD, MODULE_NAME, undefined, undefined, { 'data-sm': sm() });
   // Optionally defer the loading of the script
   if (Number.isFinite(defer) && defer > 0) {
     setTimeout(loadScript, defer);
@@ -228,9 +233,6 @@ function getTargetingData(adUnits, config, _userConsent) {
  */
 function getBidRequestData(reqBidsConfigObj, onDone, config, userConsent) {
   function onReturn() {
-    if (isFirstBidRequestCall) {
-      isFirstBidRequestCall = false;
-    }
     onDone();
   }
 
@@ -245,16 +247,10 @@ function getBidRequestData(reqBidsConfigObj, onDone, config, userConsent) {
   let fromStorage = prepareBatch(bidders, (bidder) => loadSessionReceptivity(`${config?.params?.customer}_${bidder}`));
 
   let sources = [fromStorage, fromApi];
-  if (isFirstBidRequestCall) {
-    sources.reverse();
-  }
 
   let rxBatch = Object.assign(...sources);
 
-  let singlePointEvents;
-  if (isEmpty(rxBatch)) {
-    singlePointEvents = btoa(JSON.stringify({ ui: getUiEvents() }));
-  }
+  let singlePointEvents = btoa(JSON.stringify({ ui: getUiEvents() }));
 
   bidders
     .forEach(bidderCode => {
@@ -266,6 +262,7 @@ function getBidRequestData(reqBidsConfigObj, onDone, config, userConsent) {
               ext: {
                 rx: rxBatch[bidderCode],
                 events: singlePointEvents,
+                sm: sm(),
                 params: {
                   ev: config.params?.version,
                   ci: config.params?.customer,

package/modules/eplanningBidAdapter.js

@@ -4,6 +4,7 @@ import {registerBidder} from '../src/adapters/bidderFactory.js';
 import {getStorageManager} from '../src/storageManager.js';
 import {BANNER, VIDEO} from '../src/mediaTypes.js';
 import {isSlotMatchingAdUnitCode} from '../libraries/gptUtils/gptUtils.js';
+import {serializeSupplyChain} from '../libraries/schainSerializer/schainSerializer.js';
 
 const BIDDER_CODE = 'eplanning';
 export const storage = getStorageManager({bidderCode: BIDDER_CODE});
@@ -39,6 +40,7 @@ export const spec = {
     const method = 'GET';
     const dfpClientId = '1';
     const sec = 'ROS';
+    const schain = bidRequests[0].schain;
     let url;
     let params;
     const urlConfig = getUrlConfig(bidRequests);
@@ -70,7 +72,9 @@ export const spec = {
       if (pcrs) {
         params.crs = pcrs;
       }
-
+      if (schain && schain.nodes.length <= 2) {
+        params.sch = serializeSupplyChain(schain, ['asi', 'sid', 'hp', 'rid', 'name', 'domain']);
+      }
       if (referrerUrl) {
         params.fr = cutUrl(referrerUrl);
       }

package/modules/equativBidAdapter.js

@@ -143,24 +143,19 @@ export const converter = ortbConverter({
     let env = ['ortb2.site.publisher', 'ortb2.app.publisher', 'ortb2.dooh.publisher'].find(propPath => deepAccess(bid, propPath)) || 'ortb2.site.publisher';
     deepSetValue(req, env.replace('ortb2.', '') + '.id', deepAccess(bid, env + '.id') || bid.params.networkId);
 
-    if (deepAccess(bid, 'mediaTypes.video')) {
-      ['mimes', 'placement'].forEach(prop => {
-        if (!bid.mediaTypes.video[prop]) {
-          logWarn(`${LOG_PREFIX} Property "${prop}" is missing from request`, bid);
-        }
-      });
-    }
-
-    // "assets" is not included as a property to check here because the
-    // ortbConverter library checks for it already and will skip processing
-    // the request if it is missing
-    if (deepAccess(bid, 'mediaTypes.native')) {
-      ['privacy', 'plcmttype', 'eventtrackers'].forEach(prop => {
-        if (!bid.mediaTypes.native.ortb[prop]) {
-          logWarn(`${LOG_PREFIX} Property "${prop}" is missing from request.  Request will proceed, but the use of ${prop} for native requests is strongly encouraged.`, bid);
-        }
-      });
-    }
+    [
+      { path: 'mediaTypes.video', props: ['mimes', 'placement'] },
+      { path: 'ortb2Imp.audio', props: ['mimes'] },
+      { path: 'mediaTypes.native.ortb', props: ['privacy', 'plcmttype', 'eventtrackers'] },
+    ].forEach(({ path, props }) => {
+      if (deepAccess(bid, path)) {
+        props.forEach(prop => {
+          if (!deepAccess(bid, `${path}.${prop}`)) {
+            logWarn(`${LOG_PREFIX} Property "${path}.${prop}" is missing from request.  Request will proceed, but the use of "${prop}" is strongly encouraged.`, bid);
+          }
+        });
+      }
+    });
 
     const pid = storage.getCookie(PID_COOKIE_NAME);
     if (pid) {

package/modules/escalaxBidAdapter.js

@@ -84,8 +84,8 @@ export const spec = {
     const subdomain = getSubdomain();
     const endpointURL = ESCALAX_URL
       .replace(ESCALAX_SUBDOMAIN_MACRO, subdomain || ESCALAX_DEFAULT_SUBDOMAIN)
-      .replace(ESCALAX_ACCOUNT_ID_MACRO, sourceId)
-      .replace(ESCALAX_SOURCE_ID_MACRO, accountId);
+      .replace(ESCALAX_SOURCE_ID_MACRO, sourceId)
+      .replace(ESCALAX_ACCOUNT_ID_MACRO, accountId);
     const request = converter.toORTB({ bidRequests: validBidRequests, bidderRequest });
     return {
       method: 'POST',

package/modules/eskimiBidAdapter.js

@@ -232,7 +232,10 @@ function createRequest(bidRequests, bidderRequest, mediaType) {
     method: 'POST',
     url: getBidRequestUrlByRegion(),
     data: data,
-    options: {contentType: 'application/json;charset=UTF-8', withCredentials: false}
+    options: {
+      withCredentials: true,
+      contentType: 'application/json;charset=UTF-8',
+    }
   }
 }
 

package/modules/improvedigitalBidAdapter.js

@@ -6,14 +6,6 @@ import {Renderer} from '../src/Renderer.js';
 import {hasPurpose1Consent} from '../src/utils/gdpr.js';
 import {ortbConverter} from '../libraries/ortbConverter/converter.js';
 import {convertCurrency} from '../libraries/currencyUtils/currency.js';
-/**
- * See https://github.com/prebid/Prebid.js/pull/8827 for details on linting exception
- * ImproveDigital only imports after winning a bid and only if the creative cannot reach top
- * Also see https://github.com/prebid/Prebid.js/issues/11656
- */
-// eslint-disable-next-line no-restricted-imports
-import {loadExternalScript} from '../src/adloader.js';
-import { MODULE_TYPE_BIDDER } from '../src/activities/modules.js';
 
 /**
  * @typedef {import('../src/adapters/bidderFactory.js').BidRequest} BidRequest
@@ -225,7 +217,6 @@ export const CONVERTER = ortbConverter({
         renderer: ID_OUTSTREAM.createRenderer(bidRequest)
       })
     }
-    ID_RAZR.forwardBid({bidRequest, bid: bidResponse});
     return bidResponse;
   },
   overrides: {
@@ -367,61 +358,3 @@ const ID_OUTSTREAM = {
     bid.renderer.handleVideoEvent({ id, eventName });
   },
 };
-
-const ID_RAZR = {
-  RENDERER_URL: 'https://cdn.360yield.com/razr/tag.js',
-
-  forwardBid({bidRequest, bid}) {
-    if (bid.mediaType !== BANNER) {
-      return;
-    }
-
-    const cfg = {
-      prebid: {
-        bidRequest,
-        bid
-      }
-    };
-
-    const cfgStr = JSON.stringify(cfg).replace(/<\/script>/ig, '\\x3C/script>');
-    const s = `<script>window.__razr_config = ${cfgStr};</script>`;
-    // prepend RAZR config to ad markup:
-    bid.ad = s + bid.ad;
-
-    this.installListener();
-  },
-
-  installListener() {
-    if (this._listenerInstalled) {
-      return;
-    }
-
-    window.addEventListener('message', function(e) {
-      const data = e.data?.razr?.load;
-      if (!data) {
-        return;
-      }
-
-      if (e.source) {
-        data.source = e.source;
-        if (data.id) {
-          e.source.postMessage({
-            razr: {
-              id: data.id
-            }
-          }, '*');
-        }
-      }
-
-      const ns = window.razr = window.razr || {};
-      ns.q = ns.q || [];
-      ns.q.push(data);
-
-      if (!ns.loaded) {
-        loadExternalScript(ID_RAZR.RENDERER_URL, MODULE_TYPE_BIDDER, BIDDER_CODE);
-      }
-    });
-
-    this._listenerInstalled = true;
-  }
-};

package/modules/intentIqAnalyticsAdapter.js

@@ -304,7 +304,7 @@ function constructFullUrl(data) {
     '&jsver=' + VERSION +
     '&source=pbjs' +
     '&payload=' + JSON.stringify(report) +
-    '&uh=' + iiqAnalyticsAnalyticsAdapter.initOptions.clientsHints +
+    '&uh=' + encodeURIComponent(iiqAnalyticsAnalyticsAdapter.initOptions.clientsHints) +
     (gppData.gppString ? '&gpp=' + encodeURIComponent(gppData.gppString) : '');
 
   url = appendVrrefAndFui(url, iiqAnalyticsAnalyticsAdapter.initOptions.domainName);

package/modules/ixBidAdapter.js

@@ -496,6 +496,11 @@ function parseBid(rawBid, currency, bidRequest) {
   if (rawBid.ext?.dsa) {
     bid.meta.dsa = rawBid.ext.dsa
   }
+
+  if (rawBid.ext?.ibv) {
+    bid.ext = bid.ext || {}
+    bid.ext.ibv = rawBid.ext.ibv
+  }
   return bid;
 }
 
@@ -751,8 +756,9 @@ function buildRequest(validBidRequests, bidderRequest, impressions, version) {
         method: 'POST',
         url: exchangeUrl,
         data: deepClone(r),
-        option: {
+        options: {
           contentType: 'text/plain',
+          withCredentials: true
         },
         validBidRequests
       });

package/modules/jwplayerVideoProvider.js

@@ -50,6 +50,8 @@ export function JWPlayerProvider(config, jwplayer_, adState_, timeState_, callba
     VIDEO_MIME_TYPE.AAC,
     VIDEO_MIME_TYPE.HLS
   ];
+  let height = null;
+  let width = null;
 
   function init() {
     if (!jwplayer) {
@@ -92,6 +94,20 @@ export function JWPlayerProvider(config, jwplayer_, adState_, timeState_, callba
     const adConfig = config.advertising || {};
     supportedMediaTypes = supportedMediaTypes || utils.getSupportedMediaTypes(MEDIA_TYPES);
 
+    if (height === null) {
+      height = utils.getPlayerHeight(player, config);
+    }
+
+    if (width === null) {
+      width = utils.getPlayerWidth(player, config);
+    }
+
+    if (config.aspectratio && !height && !width) {
+      const size = utils.getPlayerSizeFromAspectRatio(player, config);
+      height = size.height;
+      width = size.width;
+    }
+
     const video = {
       mimes: supportedMediaTypes,
       protocols: [
@@ -102,8 +118,8 @@ export function JWPlayerProvider(config, jwplayer_, adState_, timeState_, callba
         PROTOCOLS.VAST_3_0_WRAPPER,
         PROTOCOLS.VAST_4_0_WRAPPER
       ],
-      h: player.getHeight(), // TODO does player call need optimization ?
-      w: player.getWidth(), // TODO does player call need optimization ?
+      h: height,
+      w: width,
       startdelay: utils.getStartDelay(),
       placement: utils.getPlacement(adConfig, player),
       // linearity is omitted because both forms are supported.
@@ -414,10 +430,14 @@ export function JWPlayerProvider(config, jwplayer_, adState_, timeState_, callba
         break;
 
       case PLAYER_RESIZE:
-        getEventPayload = e => ({
-          height: e.height,
-          width: e.width,
-        });
+        getEventPayload = e => {
+          height = e.height;
+          width = e.width;
+          return {
+            height,
+            width
+          };
+        };
         break;
 
       case VIEWABLE:
@@ -585,6 +605,79 @@ export const utils = {
     return jwConfig;
   },
 
+  getPlayerHeight: function(player, config) {
+    let height;
+
+    if (player.getHeight) {
+      height = player.getHeight();
+    }
+
+    // Height is undefined when player has not yet rendered
+    if (height !== undefined) {
+      return height;
+    }
+
+    return config.height;
+  },
+
+  getPlayerWidth: function(player, config) {
+    let width;
+
+    if (player.getWidth) {
+      width = player.getWidth();
+    }
+
+    // Width is undefined when player has not yet rendered
+    if (width !== undefined) {
+      return width;
+    }
+
+    // Width can be a string when aspectratio is set
+    if (typeof config.width === 'number') {
+      return config.width;
+    }
+  },
+
+  getPlayerSizeFromAspectRatio: function(player, config) {
+    const aspectRatio = config.aspectratio;
+    let percentageWidth = config.width;
+
+    if (typeof aspectRatio !== 'string' || typeof percentageWidth !== 'string') {
+      return {};
+    }
+
+    const ratios = aspectRatio.split(':');
+
+    if (ratios.length !== 2) {
+      return {};
+    }
+
+    const containerElement = player.getContainer && player.getContainer();
+    if (!containerElement) {
+      return {};
+    }
+
+    const containerWidth = containerElement.clientWidth;
+    const containerHeight = containerElement.clientHeight;
+
+    const xRatio = parseInt(ratios[0], 10);
+    const yRatio = parseInt(ratios[1], 10);
+
+    if (isNaN(xRatio) || isNaN(yRatio)) {
+      return {};
+    }
+
+    const numericWidthPercentage = parseInt(percentageWidth, 10);
+
+    const desiredWidth = containerWidth * numericWidthPercentage / 100;
+    const desiredHeight = Math.min(desiredWidth * yRatio / xRatio, containerHeight);
+
+    return {
+      height: desiredHeight,
+      width: desiredWidth
+    };
+  },
+
   getJwEvent: function(eventName) {
     switch (eventName) {
       case SETUP_COMPLETE:

package/modules/liveIntentRtdProvider.js

@@ -0,0 +1,52 @@
+/**
+ * This module adds the LiveIntent provider to the Real Time Data module (rtdModule).
+ */
+import { submodule } from '../src/hook.js';
+import {deepAccess, deepSetValue} from '../src/utils.js'
+
+/**
+ * @typedef {import('../modules/rtdModule/index.js').RtdSubmodule} RtdSubmodule
+ * @typedef {import('../modules/rtdModule/index.js').SubmoduleConfig} SubmoduleConfig
+ * @typedef {import('../modules/rtdModule/index.js').UserConsentData} UserConsentData
+ */
+
+const SUBMODULE_NAME = 'liveintent';
+const GVLID = 148;
+
+/**
+ * Init
+ * @param {Object} config Module configuration
+ * @param {UserConsentData} userConsent User consent
+ * @returns true
+ */
+const init = (config, userConsent) => {
+  return true;
+}
+
+/**
+ * onBidRequest is called for each bidder during an auction and contains the bids for that bidder.
+ *
+ * @param {Object} bidRequest
+ * @param {SubmoduleConfig} config
+ * @param {UserConsentData} userConsent
+ */
+
+function onBidRequest(bidRequest, config, userConsent) {
+  bidRequest.bids.forEach(bid => {
+    const providedSegmentsFromUserId = deepAccess(bid, 'userId.lipb.segments', [])
+    if (providedSegmentsFromUserId.length > 0) {
+      const providedSegments = { name: 'liveintent.com', segment: providedSegmentsFromUserId.map(id => ({ id })) }
+      const existingData = deepAccess(bid, 'ortb2.user.data', [])
+      deepSetValue(bid, 'ortb2.user.data', existingData.concat(providedSegments))
+    }
+  })
+}
+
+export const liveIntentRtdSubmodule = {
+  name: SUBMODULE_NAME,
+  gvlid: GVLID,
+  init: init,
+  onBidRequestEvent: onBidRequest
+};
+
+submodule('realTimeData', liveIntentRtdSubmodule);

package/modules/liveIntentRtdProvider.md

@@ -0,0 +1,45 @@
+# Overview
+
+Module Name: LiveIntent Provider
+Module Type: Rtd Provider
+Maintainer: product@liveIntent.com
+
+# Description
+
+This module extracts segments from `bidRequest.userId.lipb.segments` enriched by the userID module and
+injects them in `ortb2.user.data` array entry.
+
+Please visit [LiveIntent](https://www.liveIntent.com/) for more information.
+
+# Testing
+
+To run the example and test the Rtd provider:
+
+```sh
+gulp serve --modules=appnexusBidAdapter,rtdModule,liveIntentRtdProvider,userId,liveIntentIdSystem
+```
+
+Open chrome with this URL:
+`http://localhost:9999/integrationExamples/gpt/liveIntentRtdProviderExample.html`
+
+To run the unit test:
+```sh
+gulp test --file "test/spec/modules/liveIntentRtdProvider_spec.js"
+```
+
+# Integration
+
+```bash
+gulp build --modules=userId,liveIntentIdSystem,rtdModule,liveIntentRtdProvider
+```
+
+```javascript
+pbjs.setConfig({
+  realTimeData: {
+    dataProviders:[{
+      name: 'liveintent',
+      waitForIt: true
+    }]
+  }
+});
+```