From 1b22864e820d98af8378a188a10b83ebcdded331 Mon Sep 17 00:00:00 2001 From: Shuhao Zhang Date: Tue, 7 Jul 2026 14:26:10 -0400 Subject: [PATCH] Equativ Bid Adapter: map placementuuid to plcmtuuid --- modules/equativBidAdapter.d.ts | 2 +- modules/equativBidAdapter.js | 3 ++- modules/equativBidAdapter.md | 4 ++-- test/spec/modules/equativBidAdapter_spec.js | 6 +++--- 4 files changed, 8 insertions(+), 7 deletions(-) diff --git a/modules/equativBidAdapter.d.ts b/modules/equativBidAdapter.d.ts index 11809655eac..a080d96b2ca 100644 --- a/modules/equativBidAdapter.d.ts +++ b/modules/equativBidAdapter.d.ts @@ -6,7 +6,7 @@ export interface EquativBidderParams { networkId?: number; /** * Placement identifier used to source inventory. - * Preferred way to identify inventory. When provided, it takes precedence + * Forwarded as `imp.ext.bidder.plcmtuuid`. When provided, it takes precedence * over the deprecated `siteId`, `pageId` and `formatId` parameters. */ placementuuid?: string; diff --git a/modules/equativBidAdapter.js b/modules/equativBidAdapter.js index 70ff9b38703..7bfaff4c301 100644 --- a/modules/equativBidAdapter.js +++ b/modules/equativBidAdapter.js @@ -210,8 +210,9 @@ export const converter = ortbConverter({ // `placementuuid` is the preferred way to identify inventory. When it is // provided it takes precedence over the `siteId`, `pageId` and // `formatId` parameters, which are kept only to support the ramp-up period. + // SSB expects this value in the OpenRTB extension as `plcmtuuid`. const bidder = placementuuid - ? { placementuuid } + ? { plcmtuuid: placementuuid } : { ...(siteId && { siteId }), ...(pageId && { pageId }), ...(formatId && { formatId }) }; if (Object.keys(bidder).length) { mergeDeep(imp.ext, { bidder }); diff --git a/modules/equativBidAdapter.md b/modules/equativBidAdapter.md index 40c8484f926..526f4e4722d 100644 --- a/modules/equativBidAdapter.md +++ b/modules/equativBidAdapter.md @@ -45,7 +45,7 @@ var adUnits = [ | Name | Scope | Description | Type | |-----------------|----------|------------------------------------------------------------------------------------------------------|----------| | `networkId` | optional | Equativ network id. Mandatory unless `ortb2.(site\|app\|dooh).publisher.id` is set. | `number` | -| `placementuuid` | optional | Placement identifier used to source inventory. Preferred way to identify inventory; takes precedence over `siteId`/`pageId`/`formatId` when both are provided. | `string` | +| `placementuuid` | optional | Placement identifier used to source inventory. Preferred way to identify inventory; forwarded as `imp.ext.bidder.plcmtuuid` and takes precedence over `siteId`/`pageId`/`formatId` when both are provided. | `string` | | `siteId` | optional | **Deprecated.** Equativ site id. Use `placementuuid` instead. Kept only to support the ramp-up. | `number` | | `pageId` | optional | **Deprecated.** Equativ page id. Use `placementuuid` instead. Kept only to support the ramp-up. | `number` | -| `formatId` | optional | **Deprecated.** Equativ format id. Use `placementuuid` instead. Kept only to support the ramp-up. | `number` | \ No newline at end of file +| `formatId` | optional | **Deprecated.** Equativ format id. Use `placementuuid` instead. Kept only to support the ramp-up. | `number` | diff --git a/test/spec/modules/equativBidAdapter_spec.js b/test/spec/modules/equativBidAdapter_spec.js index 7cd9ed95c13..1b0825366fe 100644 --- a/test/spec/modules/equativBidAdapter_spec.js +++ b/test/spec/modules/equativBidAdapter_spec.js @@ -292,14 +292,14 @@ describe('Equativ bid adapter tests', () => { expect(request.data.imp[0].ext.bidder).to.be.undefined; }); - it('should add ext.bidder with placementuuid to imp object when placementuuid is defined', () => { + it('should add ext.bidder with plcmtuuid to imp object when placementuuid is defined', () => { const bidRequests = [ { ...DEFAULT_BANNER_BID_REQUESTS[0], params: { placementuuid: 'abc-123' } }, ]; const bidderRequest = { ...DEFAULT_BANNER_BIDDER_REQUEST, bids: bidRequests }; const request = spec.buildRequests(bidRequests, bidderRequest)[0]; expect(request.data.imp[0].ext.bidder).to.deep.equal({ - placementuuid: 'abc-123', + plcmtuuid: 'abc-123', }); }); @@ -313,7 +313,7 @@ describe('Equativ bid adapter tests', () => { const bidderRequest = { ...DEFAULT_BANNER_BIDDER_REQUEST, bids: bidRequests }; const request = spec.buildRequests(bidRequests, bidderRequest)[0]; expect(request.data.imp[0].ext.bidder).to.deep.equal({ - placementuuid: 'abc-123', + plcmtuuid: 'abc-123', }); });