custom endpoint (prebid#13612)

Author: khang-vu-ttd

modules/ttdBidAdapter.js

@@ -14,7 +14,7 @@ import { getConnectionType } from '../libraries/connectionInfo/connectionUtils.j
  * @typedef {import('../src/adapters/bidderFactory.js').UserSync} UserSync
  */
 
-const BIDADAPTERVERSION = 'TTD-PREBID-2025.04.25';
+const BIDADAPTERVERSION = 'TTD-PREBID-2025.07.15';
 const BIDDER_CODE = 'ttd';
 const BIDDER_CODE_LONG = 'thetradedesk';
 const BIDDER_ENDPOINT = 'https://direct.adsrvr.org/bid/bidder/';
@@ -283,6 +283,10 @@ function video(bid) {
 }
 
 function selectEndpoint(params) {
+  if (params.customBidderEndpoint) {
+    return params.customBidderEndpoint
+  }
+
   if (params.useHttp2) {
     return BIDDER_ENDPOINT_HTTP2;
   }
@@ -337,6 +341,12 @@ export const spec = {
       return false;
     }
 
+    if (bid.params.customBidderEndpoint &&
+        (!bid.params.customBidderEndpoint.startsWith('https://') || !bid.params.customBidderEndpoint.endsWith('/bid/bidder/'))) {
+      utils.logWarn(BIDDER_CODE + ': if params.customBidderEndpoint is provided, it must start with https:// and end with /bid/bidder/');
+      return false;
+    }
+
     const mediaTypesBanner = utils.deepAccess(bid, 'mediaTypes.banner');
     const mediaTypesVideo = utils.deepAccess(bid, 'mediaTypes.video');
 

modules/ttdBidAdapter.md

@@ -54,6 +54,7 @@ The Trade Desk bid adapter supports Banner and Video.
                             banner: {
                                 expdir: [1, 3]
                             },
+                            customBidderEndpoint: 'https://customBidderEndpoint/bid/bidder/',
                         }
                     }
                 ]
@@ -109,7 +110,8 @@ The Trade Desk bid adapter supports Banner and Video.
                             supplySourceId: 'supplier',
                             publisherId: '1427ab10f2e448057ed3b422',
                             placementId: '/1111/home#header',
-                            bidfloor: 0.45
+                            bidfloor: 0.45,
+                            customBidderEndpoint: 'https://customBidderEndpoint/bid/bidder/',
                         }
                     }
                 ]

test/spec/modules/ttdBidAdapter_spec.js

@@ -99,6 +99,24 @@ describe('ttdBidAdapter', function () {
         bid.params.bidfloor = 3.01;
         expect(spec.isBidRequestValid(bid)).to.equal(true);
       });
+
+      it('should return false if customBidderEndpoint is provided and does not start with https://', function () {
+        const bid = makeBid();
+        bid.params.customBidderEndpoint = 'customBidderEndpoint/bid/bidder/';
+        expect(spec.isBidRequestValid(bid)).to.equal(false);
+      });
+
+      it('should return false if customBidderEndpoint is provided and does not end with /bid/bidder/', function () {
+        const bid = makeBid();
+        bid.params.customBidderEndpoint = 'https://customBidderEndpoint/bid/bidder';
+        expect(spec.isBidRequestValid(bid)).to.equal(false);
+      });
+
+      it('should return true if customBidderEndpoint is provided that starts with https:// and ends with /bid/bidder/', function () {
+        const bid = makeBid();
+        bid.params.customBidderEndpoint = 'https://customBidderEndpoint/bid/bidder/';
+        expect(spec.isBidRequestValid(bid)).to.equal(true);
+      });
     });
 
     describe('banner', function () {
@@ -306,11 +324,18 @@ describe('ttdBidAdapter', function () {
       expect(url).to.equal('https://direct.adsrvr.org/bid/bidder/supplier');
     });
 
+    it('sends bid requests to the correct http2 endpoint', function () {
+      const bannerBidRequestsWithHttp2Endpoint = deepClone(baseBannerBidRequests);
+      bannerBidRequestsWithHttp2Endpoint[0].params.useHttp2 = true;
+      const url = testBuildRequests(bannerBidRequestsWithHttp2Endpoint, baseBidderRequest).url;
+      expect(url).to.equal('https://d2.adsrvr.org/bid/bidder/supplier');
+    });
+
     it('sends bid requests to the correct custom endpoint', function () {
       const bannerBidRequestsWithCustomEndpoint = deepClone(baseBannerBidRequests);
-      bannerBidRequestsWithCustomEndpoint[0].params.useHttp2 = true;
+      bannerBidRequestsWithCustomEndpoint[0].params.customBidderEndpoint = 'https://customBidderEndpoint/bid/bidder/';
       const url = testBuildRequests(bannerBidRequestsWithCustomEndpoint, baseBidderRequest).url;
-      expect(url).to.equal('https://d2.adsrvr.org/bid/bidder/supplier');
+      expect(url).to.equal('https://customBidderEndpoint/bid/bidder/supplier');
     });
 
     it('sends publisher id', function () {