Districtm Dmx adding Coppa support

modules/districtmDMXBidAdapter.js

@@ -72,6 +72,7 @@ export const spec = {
         publisher: { id: String(bidRequest[0].params.memberid) || null }
       }
     }
+
     try {
       let params = config.getConfig('dmx');
       dmxRequest.user = params.user || {};
@@ -80,6 +81,14 @@ export const spec = {
     } catch (e) {
 
     }
+
+    let eids = [];
+    if (bidRequest && bidRequest.userId) {
+      bindUserId(eids, utils.deepAccess(bidRequest, `userId.idl_env`), 'liveramp.com', 1);
+      dmxRequest.user = dmxRequest.user || {};
+      dmxRequest.user.ext = dmxRequest.user.ext || {};
+      dmxRequest.user.ext.eids = eids;
+    }
     if (!dmxRequest.test) {
       delete dmxRequest.test;
     }
@@ -91,6 +100,8 @@ export const spec = {
       dmxRequest.user.ext = {};
       dmxRequest.user.ext.consent = bidderRequest.gdprConsent.consentString;
     }
+    dmxRequest.regs = dmxRequest.regs || {};
+    dmxRequest.regs.coppa = config.getConfig('coppa') === true ? 1 : 0;
     if (bidderRequest && bidderRequest.uspConsent) {
       dmxRequest.regs = dmxRequest.regs || {};
       dmxRequest.regs.ext = dmxRequest.regs.ext || {};
@@ -281,4 +292,18 @@ export function defaultSize(thebidObj) {
   returnObject.height = checkDeepArray(sizes)[1];
   return returnObject;
 }
+
+export function bindUserId(eids, value, source, atype) {
+  if (utils.isStr(value) && Array.isArray(eids)) {
+    eids.push({
+      source,
+      uids: [
+        {
+          id: value,
+          atype
+        }
+      ]
+    })
+  }
+}
 registerBidder(spec);

modules/districtmDmxBidAdapter.md

@@ -13,6 +13,8 @@ The `districtmDmxAdapter` module allows publishers to include DMX Exchange deman
 * Single Request
 * Multi-Size Support
 * GDPR Compliant
+* CCPA Compliant
+* COPPA Compliant
 * Bids returned in **NET**
 
  ## Media Types
@@ -23,8 +25,10 @@ The `districtmDmxAdapter` module allows publishers to include DMX Exchange deman
 
 | Key | Scope | Type | Description
 | --- | --- | --- | ---
-| dmxid | Mandatory | Integer | Unique identifier of the placement, dmxid can be obtained in the district m Boost platform.
-| memberid | Mandatory | Integer | Unique identifier for your account, memberid can be obtained in the district m Boost platform.
+| `dmxid` | Mandatory | Integer | Unique identifier of the placement, dmxid can be obtained in the district m Boost platform.
+| `memberid` | Mandatory | Integer | Unique identifier for your account, memberid can be obtained in the district m Boost platform.
+| `coppa` | optional | Boolean | Enables Child's Online Privacy Protection Act (COPPA) regulations. | true
+
 
 # Ad Unit Configuration Example
 
@@ -47,6 +51,27 @@ The `districtmDmxAdapter` module allows publishers to include DMX Exchange deman
 ```
 
 
+# Ad Unit Configuration when COPPA is needed
+
+```javascript
+    var adUnits = [{
+        code: 'div-gpt-ad-1460505748561-0',
+        mediaTypes: {
+            banner: {
+                sizes: [[300, 250], [300,600]],
+            }
+        },
+        bids: [{
+            bidder: 'districtmDMX',
+            params: {
+                dmxid: 100001,
+                memberid:  100003,
+                coppa: 1
+            }
+        }]
+    }];
+```
+
 # Quick Start Guide
 
 ###### 1. Including the `districtmDmxAdapter` in your build process.

test/spec/modules/districtmDmxBidAdapter_spec.js

@@ -40,7 +40,7 @@ const bidRequest = [{
   'bidder': 'districtmDMX',
   'params': {
     'dmxid': 100001,
-    'memberid': 100003
+    'memberid': 100003,
   },
   'adUnitCode': 'div-gpt-ad-12345678-1',
   'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
@@ -53,6 +53,22 @@ const bidRequest = [{
   'auctionId': '3d62f2d3-56a2-4991-888e-f7754619ddcf'
 }];
 
+const bidRequestNoCoppa = [{
+  'bidder': 'districtmDMX',
+  'params': {
+    'dmxid': 100001,
+    'memberid': 100003
+  },
+  'adUnitCode': 'div-gpt-ad-12345678-1',
+  'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
+  'sizes': [
+    [300, 250],
+    [300, 600]
+  ],
+  'bidId': '29a28a1bbc8a8d',
+  'bidderRequestId': '124b579a136515',
+  'auctionId': '3d62f2d3-56a2-4991-888e-f7754619ddcf'
+}];
 const bidderRequest = {
   'bidderCode': 'districtmDMX',
   'auctionId': '3d62f2d3-56a2-4991-888e-f7754619ddcf',
@@ -61,7 +77,7 @@ const bidderRequest = {
     'bidder': 'districtmDMX',
     'params': {
       'dmxid': 100001,
-      'memberid': 100003
+      'memberid': 100003,
     },
     'adUnitCode': 'div-gpt-ad-12345678-1',
     'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
@@ -420,6 +436,32 @@ const bidderRequest = {
   'doneCbCallCount': 0
 };
 
+const bidderRequestNoCoppa = {
+  'bidderCode': 'districtmDMX',
+  'auctionId': '3d62f2d3-56a2-4991-888e-f7754619ddcf',
+  'bidderRequestId': '124b579a136515',
+  'bids': [{
+    'bidder': 'districtmDMX',
+    'params': {
+      'dmxid': 100001,
+      'memberid': 100003,
+    },
+    'adUnitCode': 'div-gpt-ad-12345678-1',
+    'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
+    'sizes': [
+      [300, 250],
+      [300, 600]
+    ],
+    'bidId': '29a28a1bbc8a8d',
+    'bidderRequestId': '124b579a136515',
+    'auctionId': '3d62f2d3-56a2-4991-888e-f7754619ddcf'
+  }],
+  'auctionStart': 1529511035677,
+  'timeout': 700,
+  'start': 1529511035686,
+  'doneCbCallCount': 0
+};
+
 const responses = {
   'body': {
     'id': '1f45b37c-5298-4934-b517-4d911aadabfd',
@@ -522,6 +564,7 @@ describe('DistrictM Adaptor', function () {
 
   describe(`buildRequests test usage`, function () {
     const buildRequestResults = districtm.buildRequests(bidRequest, bidderRequest);
+    const buildRequestResultsNoCoppa = districtm.buildRequests(bidRequestNoCoppa, bidderRequestNoCoppa);
     it(`the function should return an array`, function () {
       expect(buildRequestResults).to.be.an('object');
     });
@@ -531,6 +574,16 @@ describe('DistrictM Adaptor', function () {
       expect(bidr.regs.ext.us_privacy).to.be.equal('1NY');
       expect(bidr.user.ext.consent).to.be.an('string');
     });
+    it(`test contain COPPA`, function() {
+      const bidr = JSON.parse(buildRequestResults.data)
+      bidr.regs = bidr.regs || {};
+      bidr.regs.coppa = 1;
+      expect(bidr.regs.coppa).to.be.equal(1)
+    })
+    it(`test should not contain COPPA`, function() {
+      const bidr = JSON.parse(buildRequestResultsNoCoppa.data)
+      expect(bidr.regs.coppa).to.be.equal(0)
+    })
     it(`the function should return array length of 1`, function () {
       expect(buildRequestResults.data).to.be.a('string');
     });