NextRoll ID System: add new ID submodule

modules/.submodules.json

@@ -16,6 +16,7 @@
  "zeotapIdPlusIdSystem",
  "haloIdSystem",
  "quantcastIdSystem",
+ "nextrollIdSystem",
  "idxIdSystem",
  "fabrickIdSystem",
  "verizonMediaIdSystem",

modules/nextrollIdSystem.js

@@ -0,0 +1,50 @@
+/**
+ * This module adds Nextroll ID to the User ID module
+ * The {@link module:modules/userId} module is required
+ * @module modules/nextrollIdSystem
+ * @requires module:modules/userId
+ */
+
+import { deepAccess } from '../src/utils.js';
+import { submodule } from '../src/hook.js';
+import { getStorageManager } from '../src/storageManager.js';
+
+const NEXTROLL_ID_LS_KEY = 'dca0.com';
+const KEY_PREFIX = 'AdID:'
+
+export const storage = getStorageManager();
+
+/** @type {Submodule} */
+export const nextrollIdSubmodule = {
+ /**
+ * used to link submodule with config
+ * @type {string}
+ */
+ name: 'nextrollId',
+
+ /**
+ * decode the stored id value for passing to bid requests
+ * @function
+ * @return {{nextrollId: string} | undefined}
+ */
+ decode(value) {
+ return value;
+ },
+
+ /**
+ * performs action to obtain id and return a value.
+ * @function
+ * @param {SubmoduleConfig} [config]
+ * @returns {{id: {nextrollId: string} | undefined}}
+ */
+ getId(config) {
+ const key = KEY_PREFIX + deepAccess(config, 'params.partnerId', 'undefined');
+ const dataString = storage.getDataFromLocalStorage(NEXTROLL_ID_LS_KEY) || '{}';
+ const data = JSON.parse(dataString);
+ const idValue = deepAccess(data, `${key}.value`);
+
+ return { id: idValue ? {nextrollId: idValue} : undefined };
+ }
+};
+
+submodule('userId', nextrollIdSubmodule);

modules/userId/eids.js

@@ -152,6 +152,12 @@ const USER_IDS_CONFIG = {
  atype: 1
  },
 
+ // nextroll
+ 'nextrollId': {
+ source: 'nextroll.com',
+ atype: 1
+ },
+
  // IDx
  'idx': {
  source: 'idx.lat',

modules/userId/eids.md

@@ -119,6 +119,14 @@ userIdAsEids = [
  }]
  },
 
+ {
+ source: 'nextroll.com',
+ uids: [{
+ id: 'some-random-id-value',
+ atype: 1
+ }]
+ },
+
  {
  source: 'audigent.com',
  uids: [{

modules/userId/userId.md

@@ -158,7 +158,12 @@ pbjs.setConfig({
  expires: 90, // Expiration in days
  refreshInSeconds: 8*3600 // User Id cache lifetime in seconds, defaulting to 'expires'
  },
- }, {
+ }, {
+ name: 'nextrollId',
+ params: {
+ partnerId: "1009", // Set your real NextRoll partner ID here for production
+ }
+ }, {
  name: 'criteo',
  storage: { // It is best not to specify this parameter since the module needs to be called as many times as possible
  type: 'html5',

test/spec/modules/nextrollIdSystem_spec.js

@@ -0,0 +1,56 @@
+import { nextrollIdSubmodule, storage } from 'modules/nextrollIdSystem.js';
+
+const LS_VALUE = `{
+ "AdID":{"id":"adid","key":"AdID"},
+ "AdID:1002": {"id":"adid","key":"AdID:1002","value":"id_value"}}`;
+
+describe('NextrollId module', function () {
+ let sandbox = sinon.sandbox.create();
+ let hasLocalStorageStub;
+ let getLocalStorageStub;
+
+ beforeEach(function() {
+ hasLocalStorageStub = sandbox.stub(storage, 'hasLocalStorage');
+ getLocalStorageStub = sandbox.stub(storage, 'getDataFromLocalStorage');
+ });
+
+ afterEach(function () {
+ sandbox.restore();
+ })
+
+ const testCases = [
+ {
+ expect: {
+ id: {nextrollId: 'id_value'},
+ },
+ params: {partnerId: '1002'},
+ localStorage: LS_VALUE
+ },
+ {
+ expect: {id: undefined},
+ params: {partnerId: '1003'},
+ localStorage: LS_VALUE
+ },
+ {
+ expect: {id: undefined},
+ params: {partnerId: ''},
+ localStorage: LS_VALUE
+ },
+ {
+ expect: {id: undefined},
+ params: {partnerId: '102'},
+ localStorage: undefined
+ },
+ {
+ expect: {id: undefined},
+ params: undefined,
+ localStorage: undefined
+ }
+ ]
+ testCases.forEach(
+ (testCase, i) => it(`getId() (TC #${i}) should return the nextroll id if it exists`, function () {
+ getLocalStorageStub.withArgs('dca0.com').returns(testCase.localStorage);
+ const id = nextrollIdSubmodule.getId({params: testCase.params});
+ expect(id).to.be.deep.equal(testCase.expect);
+ }))
+});