From 2ab06ec178fd4110b8fe32cf58606b0af56aa5a2 Mon Sep 17 00:00:00 2001 From: Pratik Chavan Date: Tue, 25 Feb 2025 16:37:38 -0500 Subject: [PATCH 1/3] Update imds adapter to advertising to reflect the ownership change --- dev-docs/bidders/advertising.md | 111 +++++++++++++++++++++++++++++++ dev-docs/bidders/imds.md | 12 +++- dev-docs/bidders/synacormedia.md | 6 +- 3 files changed, 123 insertions(+), 6 deletions(-) create mode 100644 dev-docs/bidders/advertising.md diff --git a/dev-docs/bidders/advertising.md b/dev-docs/bidders/advertising.md new file mode 100644 index 0000000000..4cd85c2b47 --- /dev/null +++ b/dev-docs/bidders/advertising.md @@ -0,0 +1,111 @@ +--- +layout: bidder +title: Advertising.com +description: Prebid Advertising.com Bidder Adapter +pbjs: true +pbs: true +biddercode: advertising +tcfeu_supported: false +usp_supported: true +userIds: all +media_types: banner, video +coppa_supported: false +gpp_supported: true +schain_supported: true +dchain_supported: false +safeframes_ok: true +pbs_app_supported: true +deals_supported: false +floors_supported: true +fpd_supported: false +ortb_blocking_supported: false +multiformat_supported: will-bid-on-any +prebid_member: false +gvl_id: none +sidebarType: 1 +--- + +### Note + +The Advertising.com bidder adapter requires setup and approval from Advertising.com. Please reach out to your account manager for more information and to start using it. + +### Configuration + +Advertising.com requires that `iframe` is used for user syncing. + +Example configuration: + +```javascript +pbjs.setConfig({ + userSync: { + filterSettings: { + iframe: { + bidders: '*', // represents all bidders + filter: 'include' + } + } + } +}); +``` + +### DFP Video Creative +To use video, setup a `VAST redirect` creative within Google Ad Manager with the following VAST tag URL: + +If using the new `advertising` adapter with x9.x or later: + +```text +https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%% +``` + +If using the legacy `imds` adapter with x8.x or later: + +```text +https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%% +``` + +If using the legacy `synacormedia` adapter with v7.x or earlier: + +```text +https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_synacormedia%%&AUCTION_PRICE=%%PATTERN:hb_pb_synacormedia%% +``` + +### Bid params + +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | +| ---- | ----- | ----------- | ------- | ---- | +| `seatId` | required | The seat ID from Advertising.com. This will be the same for all ad units. | `'prebid'` | `string` | +| `tagId` | required | The placement ID or tag ID from Advertising.com. | `'demo1'` | `string` | +| `placementId` | optional | Legacy parameter replaced by `tagId` | `'demo1'` | `string` | +| `bidfloor` | optional | Legacy parameter for floor price for the request. Replaced by [Price Floors Module](/dev-docs/modules/floors.html) | `0.1` | `float` | + +### Example Ad Unit + +```javascript +var adUnits = [{ + "code": "test-div", + "mediaTypes": { + "video": { + "pos": 1, + "playerSize": [300, 250], + "context": "instream", + "mimes": ["video/mp4"], + "protocols": [2, 3, 5, 6, 7, 8], + "playbackmethod": [2], + "skip": 0, + "minduration": 15, + "maxduration": 30, + "startdelay": 0, + "linearity": 1 + } + }, + "bids": [{ + "bidder": "advertising", + "params": { + "seatId": "prebid", + "tagId": "demo1", + "bidfloor": 0.20 + } + }] +}] +``` diff --git a/dev-docs/bidders/imds.md b/dev-docs/bidders/imds.md index f526d56702..06aa7c1fd2 100644 --- a/dev-docs/bidders/imds.md +++ b/dev-docs/bidders/imds.md @@ -1,7 +1,7 @@ --- layout: bidder title: iMedia Digital Services (iMDS) -description: Prebid iMedia Digital Services Bidder (iMDS) Adapter +description: Prebid iMedia Digital Services Bidder (iMDS) Adapter (replaced by "Advertising.com") pbjs: true pbs: true biddercode: imds @@ -27,7 +27,7 @@ sidebarType: 1 ### Note -The iMedia Digital Services bidder adapter requires setup and approval from iMedia Digital Services. Please reach out to your account manager for more information and to start using it. +The iMedia Digital Services (iMDS) bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using a bidder code of `advertising`. Please update your implementation accordingly. This bidder adapter requires setup and approval from Advertising.com. Please reach out to your account manager for more information and to start using it. ### Configuration @@ -51,7 +51,13 @@ pbjs.setConfig({ ### DFP Video Creative To use video, setup a `VAST redirect` creative within Google Ad Manager with the following VAST tag URL: -If using the new `imds` adapter with x8.x or later: +If using the new `advertising` adapter with x9.x or later: + +```text +https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%% +``` + +If using the legacy `imds` adapter with x8.x or later: ```text https://track.technoratimedia.com/openrtb/tags?ID=%%PATTERN:hb_uuid_imds%%&AUCTION_PRICE=%%PATTERN:hb_pb_imds%% diff --git a/dev-docs/bidders/synacormedia.md b/dev-docs/bidders/synacormedia.md index 29bab594b6..b695ac0dd7 100644 --- a/dev-docs/bidders/synacormedia.md +++ b/dev-docs/bidders/synacormedia.md @@ -1,7 +1,7 @@ --- layout: bidder title: Synacor Media -description: Prebid Synacor Media Bidder Adapter (replaced by "imds") +description: Prebid Synacor Media Bidder Adapter (replaced by "Advertising.com") pbjs: true pbs: true biddercode: synacormedia @@ -22,9 +22,9 @@ multiformat_supported: will-bid-on-any prebid_member: false gvl_id: none sidebarType: 1 -pbjs_version_notes: use imds after 8.0 +pbjs_version_notes: use imds after 8.0 and advertising after 9.0 --- ### Note -The Synacor Media bidder adapter has been renamed to the [iMedia Digital Services (iMDS)](/dev-docs/bidders/imds.html) adapter, using an bidder code of `imds`. Please update your implementation accordingly. +The Synacor Media bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using an bidder code of `advertising`. Please update your implementation accordingly. \ No newline at end of file From 19bba15fc08e49b47f3894106b0e28f5e3c15ea1 Mon Sep 17 00:00:00 2001 From: Pratik Chavan Date: Tue, 18 Mar 2025 14:13:15 -0400 Subject: [PATCH 2/3] Add newline char to synacormedia docs --- dev-docs/bidders/synacormedia.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/synacormedia.md b/dev-docs/bidders/synacormedia.md index b695ac0dd7..fde13bf0cd 100644 --- a/dev-docs/bidders/synacormedia.md +++ b/dev-docs/bidders/synacormedia.md @@ -27,4 +27,4 @@ pbjs_version_notes: use imds after 8.0 and advertising after 9.0 ### Note -The Synacor Media bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using an bidder code of `advertising`. Please update your implementation accordingly. \ No newline at end of file +The Synacor Media bidder adapter has been renamed to the [Advertising.com](/dev-docs/bidders/advertising.html) adapter, using an bidder code of `advertising`. Please update your implementation accordingly. From 5b2927e0d7e72eb8722e13f2a030989d39c0a685 Mon Sep 17 00:00:00 2001 From: Pratik Chavan Date: Tue, 27 May 2025 12:12:57 -0400 Subject: [PATCH 3/3] Add aliasCode advertising to imds and synacormedia adapter and update version notes on both --- dev-docs/bidders/imds.md | 2 ++ dev-docs/bidders/synacormedia.md | 3 ++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/dev-docs/bidders/imds.md b/dev-docs/bidders/imds.md index 06aa7c1fd2..d7af519f32 100644 --- a/dev-docs/bidders/imds.md +++ b/dev-docs/bidders/imds.md @@ -5,6 +5,7 @@ description: Prebid iMedia Digital Services Bidder (iMDS) Adapter (replaced by " pbjs: true pbs: true biddercode: imds +aliasCode: advertising tcfeu_supported: false usp_supported: true userIds: all @@ -23,6 +24,7 @@ multiformat_supported: will-bid-on-any prebid_member: false gvl_id: none sidebarType: 1 +pbjs_version_notes: use advertising after 10.0 --- ### Note diff --git a/dev-docs/bidders/synacormedia.md b/dev-docs/bidders/synacormedia.md index fde13bf0cd..bd4a7e7b1b 100644 --- a/dev-docs/bidders/synacormedia.md +++ b/dev-docs/bidders/synacormedia.md @@ -5,6 +5,7 @@ description: Prebid Synacor Media Bidder Adapter (replaced by "Advertising.com") pbjs: true pbs: true biddercode: synacormedia +aliasCode: advertising tcfeu_supported: false usp_supported: true userIds: all @@ -22,7 +23,7 @@ multiformat_supported: will-bid-on-any prebid_member: false gvl_id: none sidebarType: 1 -pbjs_version_notes: use imds after 8.0 and advertising after 9.0 +pbjs_version_notes: use imds after 8.0 and advertising after 10.0 --- ### Note