New PubProvided Id UserId Submodule

integrationExamples/gpt/userId_example.html

@@ -134,6 +134,31 @@
                 // },
                 userSync: {
                     userIds: [{
+                        name: "pubProvided",
+                        params: {
+                            eids: [{
+                                source: "example.com",
+                                uids:[{
+                                    id: "value read from cookie or local storage",
+                                    ext: {
+                                    }
+                                }]
+                            },{
+                                source: "id-partner.com",
+                                uids:[{
+                                    id: "value read from cookie or local storage"
+                                }]
+                            }],
+                            eidsFunction: function() {
+                                return [{
+                                    source: "provider.com",
+                                    uids: [{
+                                        id: "value read from cookie or local storage"
+                                    }]
+                                }]
+                            }
+                        }
+                    },{
                         name: "unifiedId",
                         params: {
                             partner: "prebid",

modules/pubProvidedSystem.js

@@ -0,0 +1,53 @@
+/**
+ * This module adds Publisher Provided ids support to the User ID module
+ * The {@link module:modules/userId} module is required.
+ * @module modules/pubProvidedSystem
+ * @requires module:modules/userId
+ */
+
+import {submodule} from '../src/hook.js';
+import * as utils from '../src/utils.js';
+
+const MODULE_NAME = 'pubProvided';
+
+/** @type {Submodule} */
+export const pubProvidedSubmodule = {
+  /**
+   * used to link submodule with config
+   * @type {string}
+   */
+  name: MODULE_NAME,
+
+  /**
+   * decode the stored id value for passing to bid request
+   * @function
+   * @param {string} value
+   * @returns {{pubProvided: array}} or undefined if value doesn't exists
+   */
+  decode(value) {
+    const res = value ? {pubProvided: value} : undefined;
+    utils.logInfo('PubProvided: Decoded value ' + JSON.stringify(res));
+    return res;
+  },
+
+  /**
+   * performs action to obtain id and return a value.
+   * @function
+   * @param {SubmoduleParams} [configParams]
+   * @returns {{id: array}}
+   */
+  getId(configParams) {
+    let res = [];
+    if (utils.isArray(configParams.eids)) {
+      res = res.concat(configParams.eids);
+    }
+    if (typeof configParams.eidsFunction === 'function') {
+      res = res.concat(configParams.eidsFunction());
+    }
+    res.forEach(id => id.type = 'pubProvided');
+    return {id: res};
+  }
+};
+
+// Register submodule for userId
+submodule('userId', pubProvidedSubmodule);

modules/rubiconBidAdapter.js

@@ -251,7 +251,7 @@ export const spec = {
       const eids = utils.deepAccess(bidderRequest, 'bids.0.userIdAsEids');
       if (eids && eids.length) {
         // filter out unsupported id systems
-        utils.deepSetValue(data, 'user.ext.eids', eids.filter(eid => ['adserver.org', 'pubcid.org', 'liveintent.com', 'liveramp.com', 'sharedid.org'].indexOf(eid.source) !== -1));
+        utils.deepSetValue(data, 'user.ext.eids', eids.filter(eid => ['adserver.org', 'pubcid.org', 'liveintent.com', 'liveramp.com', 'sharedid.org'].indexOf(eid.source) !== -1 || eid.type === 'pubProvided'));
 
         // liveintent requires additional props to be set
         const liveIntentEid = find(data.user.ext.eids, eid => eid.source === 'liveintent.com');
@@ -538,6 +538,12 @@ export const spec = {
       if (sharedId) {
         data['eid_sharedid.org'] = `${sharedId.uids[0].id}^${sharedId.uids[0].atype}^${sharedId.uids[0].ext.third}`;
       }
+      const pubProvidedIds = bidRequest.userIdAsEids.filter(eid => eid.type === 'pubProvided');
+      if (pubProvidedIds) {
+        pubProvidedIds.forEach(pubProvidedId => {
+          data[`${pubProvidedId.source}_id`] = pubProvidedId.uids[0].id;
+        });
+      }
     }
 
     // set ppuid value from config value

modules/userId/eids.js

@@ -182,9 +182,13 @@ export function createEidsArray(bidRequestUserId) {
   let eids = [];
   for (const subModuleKey in bidRequestUserId) {
     if (bidRequestUserId.hasOwnProperty(subModuleKey)) {
-      const eid = createEidObject(bidRequestUserId[subModuleKey], subModuleKey);
-      if (eid) {
-        eids.push(eid);
+      if (subModuleKey === 'pubProvided') {
+        eids = eids.concat(bidRequestUserId['pubProvided']);
+      } else {
+        const eid = createEidObject(bidRequestUserId[subModuleKey], subModuleKey);
+        if (eid) {
+          eids.push(eid);
+        }
       }
     }
   }

test/spec/modules/eids_spec.js

@@ -237,8 +237,42 @@ describe('eids array generation for known sub-modules', function() {
       }]
     });
   });
+  it('PubProvided', function() {
+    const userId = {
+      pubProvided: [{
+        source: 'example.com',
+        type: 'pubProvided',
+        uids: [{
+          id: 'value read from cookie or local storage',
+          ext: {}
+        }]
+      }, {
+        source: 'id-partner.com',
+        type: 'pubProvided',
+        uids: [{
+          id: 'value read from cookie or local storage'
+        }]
+      }]
+    };
+    const newEids = createEidsArray(userId);
+    expect(newEids.length).to.equal(2);
+    expect(newEids[0]).to.deep.equal({
+      source: 'example.com',
+      type: 'pubProvided',
+      uids: [{
+        id: 'value read from cookie or local storage',
+        ext: {}
+      }]
+    });
+    expect(newEids[1]).to.deep.equal({
+      source: 'id-partner.com',
+      type: 'pubProvided',
+      uids: [{
+        id: 'value read from cookie or local storage'
+      }]
+    });
+  });
 });
-
 describe('Negative case', function() {
   it('eids array generation for UN-known sub-module', function() {
     // UnknownCommonId