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..fde13bf0cd 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.