Districtm Dmx adding Coppa support

modules/districtmDMXBidAdapter.js

@@ -103,6 +103,10 @@ export const spec = {
       dmxRequest.source.ext.schain = schain || {}
     } catch (e) {}
     let tosendtags = bidRequest.map(dmx => {
+      if (dmx.params.coppa) {
+        dmxRequest.regs = dmxRequest.regs || {};
+        dmxRequest.regs.coppa = dmx.params.coppa;
+      }
       var obj = {};
       obj.id = dmx.bidId;
       obj.tagid = String(dmx.params.dmxid);

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,8 @@ const bidRequest = [{
   'bidder': 'districtmDMX',
   'params': {
     'dmxid': 100001,
-    'memberid': 100003
+    'memberid': 100003,
+    'coppa': 1
   },
   'adUnitCode': 'div-gpt-ad-12345678-1',
   'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
@@ -53,6 +54,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 +78,8 @@ const bidderRequest = {
     'bidder': 'districtmDMX',
     'params': {
       'dmxid': 100001,
-      'memberid': 100003
+      'memberid': 100003,
+      'coppa': 1,
     },
     'adUnitCode': 'div-gpt-ad-12345678-1',
     'transactionId': 'f6d13fa6-ebc1-41ac-9afa-d8171d22d2c2',
@@ -420,6 +438,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 +566,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 +576,14 @@ 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)
+      expect(bidr.regs.coppa).to.be.equal(1)
+    })
+    it(`test should not contain COPPA`, function() {
+      const bidr = JSON.parse(buildRequestResultsNoCoppa.data)
+      expect(bidr.regs).to.be.equal(undefined)
+    })
     it(`the function should return array length of 1`, function () {
       expect(buildRequestResults.data).to.be.a('string');
     });