Test mode added for Portal Prebid Test Site (publisher simulation)

modules/startioBidAdapter.js

@@ -26,6 +26,11 @@
       imp.bidfloorcur = 'USD';
     }
 
+    const placementId = bidRequest.params?.placementId;
+    if (placementId != null) {
+      imp.tagid = String(placementId);
+    }
+
     return imp;
   },
   request(buildRequest, imps, bidderRequest, context) {
@@ -33,14 +38,19 @@
     const bidParams = context?.bidParams;
     const publisherId = bidParams?.publisherId;
     if (request?.site) {
       request.site.publisher = request.site.publisher || {};
       request.site.publisher.id = publisherId;
     } else if (request?.app) {
       request.app.publisher = request.app.publisher || {};
       request.app.publisher.id = publisherId;
     }
     request.ext = request.ext || {};
     request.ext.prebid = request.ext.prebid || {};
+    request.ext.prebid.channel = { name: 'pbjs', version: '$prebid.version$' };
+
+    if (bidParams?.testAdsEnabled) {
+      request.test = 1;
+    }
 
     const ortb = bidderRequest.ortb2;
     request.regs ??= {};
@@ -80,7 +90,7 @@
       return buildBidResponse(bid, context);
     }
 
     logError('Bid type is incorrect for bid: ', bid['id']);
   },
   context: {
     netRevenue: true,
@@ -107,6 +117,10 @@
   return !bid.ortb2Imp?.bidfloorcur || bid.ortb2Imp.bidfloorcur === 'USD';
 }
 
+function getEndpointUrl(bidRequest) {
+  return bidRequest.params?.testAdsEnabled ? `${ENDPOINT_URL}&testAdsEnabled=true` : ENDPOINT_URL;
+}
+
 export const spec = {
   code: BIDDER_CODE,
   supportedMediaTypes: [VIDEO, BANNER, NATIVE],
@@ -124,7 +138,7 @@
 
       return {
         method: METHOD,
-        url: ENDPOINT_URL,
+        url: getEndpointUrl(bidRequest),
         options: {
           contentType: 'text/plain',
           withCredentials: true,
@@ -137,7 +151,7 @@
 
   interpretResponse: ({ body }, req) => {
     if (!body || !body.seatbid || body.seatbid.length === 0) {
       return [];
     }
     return converter.fromORTB({
       response: body,
@@ -148,11 +162,11 @@
   onTimeout: (data) => { },
 
   onBidWon: (bid) => {
     if (bid.nurl) {
       const url = new URL(bid.nurl);
       url.searchParams.set('cpm', bid.cpm);
       fetch(url.toString(), { method: 'GET', keepalive: true }).catch(err =>
         logError('Error triggering win notification', err)
       );
     }
   },

test/spec/modules/startioBidAdapter_spec.js

@@ -322,6 +322,47 @@ describe('Prebid Adapter: Startio', function () {
       expect(request.imp[0].banner.battr).to.deep.equal([3, 4]);
     });
 
+    it('should advertise the prebid channel (name + version) so the endpoint can identify the version', function () {
+      const request = spec.buildRequests([DEFAULT_REQUEST_DATA], DEFAULT_BIDDER_REQUEST)[0].data;
+
+      expect(request.ext.prebid.channel).to.be.an('object');
+      expect(request.ext.prebid.channel.name).to.equal('pbjs');
+      expect(request.ext.prebid.channel.version).to.be.a('string').that.is.not.empty;
+    });
+
+    it('should map params.placementId to imp.tagid', function () {
+      let bidRequest = deepClone(DEFAULT_REQUEST_DATA);
+      bidRequest.params.placementId = 'placement-abc';
+
+      const request = spec.buildRequests([bidRequest], DEFAULT_BIDDER_REQUEST)[0].data;
+
+      expect(request.imp[0].tagid).to.equal('placement-abc');
+    });
+
+    it('should set request.test to 1 only when params.testAdsEnabled is truthy', function () {
+      let bidRequest = deepClone(DEFAULT_REQUEST_DATA);
+
+      let request = spec.buildRequests([bidRequest], DEFAULT_BIDDER_REQUEST)[0].data;
+      expect(request.test).to.not.equal(1);
+
+      bidRequest.params.testAdsEnabled = true;
+      request = spec.buildRequests([bidRequest], DEFAULT_BIDDER_REQUEST)[0].data;
+      expect(request.test).to.equal(1);
+    });
+
+    it('should append testAdsEnabled=true to the endpoint only when params.testAdsEnabled is set', function () {
+      let bidRequest = deepClone(DEFAULT_REQUEST_DATA);
+
+      let request = spec.buildRequests([bidRequest], DEFAULT_BIDDER_REQUEST)[0];
+      expect(request.url).to.include('pbc-rtb.startappnetwork.com');
+      expect(request.url).to.not.include('testAdsEnabled');
+
+      bidRequest.params.testAdsEnabled = true;
+      request = spec.buildRequests([bidRequest], DEFAULT_BIDDER_REQUEST)[0];
+      expect(request.url).to.include('pbc-rtb.startappnetwork.com');
+      expect(request.url).to.include('testAdsEnabled=true');
+    });
+
     if (FEATURES.VIDEO) {
       it('should build request for video media type', function () {
         const bidRequest = VALID_MEDIA_TYPES_REQUESTS[VIDEO][0];