From 5ef437ad87bb4cfa7d02fcaad6ff05a09e7e413b Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Sun, 31 Aug 2025 15:10:25 +0300 Subject: [PATCH 01/11] add scalibure md file to dev-docs --- dev-docs/scalibur.md | 191 +++++++++++++++++++++++++++++++++++++++++++ package-lock.json | 2 +- package.json | 4 +- 3 files changed, 193 insertions(+), 4 deletions(-) create mode 100644 dev-docs/scalibur.md diff --git a/dev-docs/scalibur.md b/dev-docs/scalibur.md new file mode 100644 index 0000000000..d4883fc2ca --- /dev/null +++ b/dev-docs/scalibur.md @@ -0,0 +1,191 @@ +--- +layout: bidder +title: Scalibur +description: Prebid Scalibur Bidder Adapter +biddercode: scalibur +media_types: banner, video +gvlid: # Add your Global Vendor List ID if you have one +--- + +# Scalibur Bidder + +## Description + +The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertising platform. It supports both banner and video ad formats through OpenRTB 2.x protocol and provides full compliance with privacy regulations. + +**Key Features:** +- Banner and Video (instream) ad support +- OpenRTB 2.x compliant requests +- Privacy regulation compliance (GDPR, CCPA, GPP, COPPA) +- First-party data collection and storage +- User sync capabilities (iframe and image) +- Supply chain transparency (schain) +- Floor pricing support +- First Party Data (FPD) support + + +## Bid Params + +| Name | Scope | Description | Example | Type | +|---------------|----------|---------------------------------------------|------------------------|----------| +| `placementId` | required | Placement identifier provided by Scalibur | `'test-placement-123'` | `string` | + +## Test Parameters + +For testing purposes, you can use the following ad unit configurations: + +### Banner Ad Unit + +```javascript +var adUnits = [ + { + code: 'test-banner-div', + mediaTypes: { + banner: { + sizes: [[300, 250], [728, 90], [320, 50]] + } + }, + bids: [ + { + bidder: 'scalibur', + params: { + placementId: 'test-scl-placement' + } + } + ] + } +]; +``` + +### Video Ad Unit + +```javascript +var adUnits = [ + { + code: 'test-video-div', + mediaTypes: { + video: { + playerSize: [[640, 480]], + context: 'instream', + mimes: ['video/mp4'], + protocols: [2, 3, 5, 6], + minduration: 5, + maxduration: 30, + startdelay: 0, + playbackmethod: [1, 2], + api: [1, 2] + } + }, + bids: [ + { + bidder: 'scalibur', + params: { + placementId: 'test-scl-placement' // Required + } + } + ] + } +]; +``` + +### Multi-format Ad Unit + +```javascript +var adUnits = [ + { + code: 'test-multiformat-div', + mediaTypes: { + banner: { + sizes: [[300, 250], [728, 90]] + }, + video: { + context: 'instream', + playerSize: [[300, 169]], + mimes: ['video/mp4'], + protocols: [2, 3, 5, 6], + minduration: 15, + maxduration: 30 + } + }, + bids: [ + { + bidder: 'scalibur', + params: { + placementId: 'test-scl-placement' + } + } + ] + } +]; +``` + +## Privacy and Compliance +The Scalibur adapter automatically handles: +- **GDPR**: Processes TCF consent strings and applies GDPR compliance flags +- **CCPA/CPRA**: Handles US Privacy (usprivacy) strings according to CCPA requirements +- **GPP**: Supports Global Privacy Platform strings and applicable regulatory sections +- **COPPA**: Respects Children's Online Privacy Protection Act compliance settings + +Privacy parameters are automatically passed to the Scalibur platform and included in user sync URLs. +## First Party Data +The adapter supports First Party Data (FPD) in multiple ways: +- **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` data +- **AdUnit FPD**: Includes ad unit specific `ortb2Imp` data +- **Local Storage**: Generates and stores first-party identifiers for enhanced targeting + +## Supply Chain Transparency +The adapter supports the Supply Chain Object (schain) for transparency in programmatic advertising transactions, helping to combat fraud and improve trust between buyers and sellers. +## Floor Prices +The adapter respects floor prices set via: +- Prebid.js Price Floors module +- Ad unit level floor configuration +- Global floor configuration + +## User Sync +The Scalibur adapter supports user synchronization through: +- **Iframe syncs**: For enhanced matching capabilities +- **Image syncs**: For lightweight synchronization + +All privacy parameters (GDPR, CCPA, GPP) are automatically included in sync requests. + +## Configuration Example +```javascript +pbjs.que.push(function() { + pbjs.addAdUnits(adUnits); + + pbjs.setConfig({ + debug: true, + userSync: { + filterSettings: { + iframe: { + bidders: ['scalibur'], + filter: 'include' + }, + image: { + bidders: ['scalibur'], + filter: 'include' + } + } + } + }); + + pbjs.requestBids({ + timeout: 3000, + bidsBackHandler: function(bidResponses) { + // Handle bid responses + } + }); +}); +``` + +## Support +For technical support or integration assistance: +- **Email**: support@scalibur.io +- **Documentation**: Contact Scalibur Support Team + +## Notes +- The adapter requires a valid `placementId` parameter provided by Scalibur +- Video ads support instream context with standard IAB video parameters +- Banner ads support multiple sizes including standard IAB sizes +- All requests are sent via secure HTTPS endpoints +- The adapter automatically handles device detection and targeting diff --git a/package-lock.json b/package-lock.json index 4e95391780..931d670e2c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11,7 +11,7 @@ "license": "ISC", "dependencies": { "awesomplete": "^1.1.5", - "bootstrap": "^4.5.3", + "bootstrap": "^4.6.2", "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" diff --git a/package.json b/package.json index 0e5281ff3a..fb06b2e31b 100644 --- a/package.json +++ b/package.json @@ -23,11 +23,9 @@ "url": "https://github.com/AtreNet/prebid.github.io/issues" }, "homepage": "https://github.com/AtreNet/prebid.github.io#readme", - "devDependencies": { - }, "dependencies": { "awesomplete": "^1.1.5", - "bootstrap": "^4.5.3", + "bootstrap": "^4.6.2", "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" From 39c63705a95f8969d2b49f4aae55c4c1a63318df Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Sun, 31 Aug 2025 15:15:19 +0300 Subject: [PATCH 02/11] move scalibure md to bidders folder --- dev-docs/{ => bidders}/scalibur.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename dev-docs/{ => bidders}/scalibur.md (100%) diff --git a/dev-docs/scalibur.md b/dev-docs/bidders/scalibur.md similarity index 100% rename from dev-docs/scalibur.md rename to dev-docs/bidders/scalibur.md From 465cd09f76333d4d4bd1235388397649036fb136 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Sun, 31 Aug 2025 15:49:46 +0300 Subject: [PATCH 03/11] add scalibur bidder adapter doc and tested --- dev-docs/bidders/scalibur.md | 21 +++++++++++++++++++-- package-lock.json | 3 +-- 2 files changed, 20 insertions(+), 4 deletions(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index d4883fc2ca..0e8dd56e26 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -3,11 +3,28 @@ layout: bidder title: Scalibur description: Prebid Scalibur Bidder Adapter biddercode: scalibur +gvlid: 1471 media_types: banner, video -gvlid: # Add your Global Vendor List ID if you have one +tcfeu_supported: true +gpp_supported: true +usp_supported: true +coppa_supported: true +schain_supported: true +dchain_supported: false +safeframes_ok: true +deals_supported: false +floors_supported: true +fpd_supported: true +pbjs: true +pbs: false +prebid_member: false +multiformat_supported: will-bid-on-any +ortb_blocking_supported: false +userIds: all +pbs_app_supported: false --- -# Scalibur Bidder +# Scalibur Bidderkue ## Description diff --git a/package-lock.json b/package-lock.json index 931d670e2c..a1f16e692b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,8 +15,7 @@ "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" - }, - "devDependencies": {} + } }, "node_modules/awesomplete": { "version": "1.1.5", From c09feb181c33f66e7bba945c19d7228896315fae Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Sun, 31 Aug 2025 15:51:48 +0300 Subject: [PATCH 04/11] Add Scalibur bidder adapter documentation - Add complete bidder documentation with all required front matter - Configure support for GDPR, CCPA, GPP, floors, and FPD - Set GVLID to 1471 for proper GDPR compliance - Enable integration with bidders list and search functionality --- dev-docs/bidders/scalibur.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index 0e8dd56e26..da0913138a 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -24,7 +24,7 @@ userIds: all pbs_app_supported: false --- -# Scalibur Bidderkue +# Scalibur Bidder ## Description From 5643efef3fe01dffaf10e656b0146076725a2c14 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 15:25:06 +0300 Subject: [PATCH 05/11] fix scalibur md file --- dev-docs/bidders/scalibur.md | 17 ++++------------- 1 file changed, 4 insertions(+), 13 deletions(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index da0913138a..8b93215b74 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -33,7 +33,7 @@ The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertis **Key Features:** - Banner and Video (instream) ad support - OpenRTB 2.x compliant requests -- Privacy regulation compliance (GDPR, CCPA, GPP, COPPA) +- Privacy regulation compliance - First-party data collection and storage - User sync capabilities (iframe and image) - Supply chain transparency (schain) @@ -42,8 +42,8 @@ The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertis ## Bid Params - -| Name | Scope | Description | Example | Type | +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | |---------------|----------|---------------------------------------------|------------------------|----------| | `placementId` | required | Placement identifier provided by Scalibur | `'test-placement-123'` | `string` | @@ -135,15 +135,6 @@ var adUnits = [ } ]; ``` - -## Privacy and Compliance -The Scalibur adapter automatically handles: -- **GDPR**: Processes TCF consent strings and applies GDPR compliance flags -- **CCPA/CPRA**: Handles US Privacy (usprivacy) strings according to CCPA requirements -- **GPP**: Supports Global Privacy Platform strings and applicable regulatory sections -- **COPPA**: Respects Children's Online Privacy Protection Act compliance settings - -Privacy parameters are automatically passed to the Scalibur platform and included in user sync URLs. ## First Party Data The adapter supports First Party Data (FPD) in multiple ways: - **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` data @@ -163,7 +154,7 @@ The Scalibur adapter supports user synchronization through: - **Iframe syncs**: For enhanced matching capabilities - **Image syncs**: For lightweight synchronization -All privacy parameters (GDPR, CCPA, GPP) are automatically included in sync requests. +All privacy parameters are automatically included in sync requests. ## Configuration Example ```javascript From dec36a6a1f6597b405f3800b8686b8bf0f0b4ff0 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 16:21:43 +0300 Subject: [PATCH 06/11] revert package json to origin --- package-lock.json | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index a1f16e692b..28ccccea4f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11,7 +11,7 @@ "license": "ISC", "dependencies": { "awesomplete": "^1.1.5", - "bootstrap": "^4.6.2", + "bootstrap": "^4.5.3", "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" diff --git a/package.json b/package.json index fb06b2e31b..dd828ba38b 100644 --- a/package.json +++ b/package.json @@ -25,7 +25,7 @@ "homepage": "https://github.com/AtreNet/prebid.github.io#readme", "dependencies": { "awesomplete": "^1.1.5", - "bootstrap": "^4.6.2", + "bootstrap": "^4.5.3", "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" From fa913993427eac2efe2f760aef475f0174bd4de1 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 16:22:52 +0300 Subject: [PATCH 07/11] revert package json to origin --- package-lock.json | 3 ++- package.json | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/package-lock.json b/package-lock.json index 28ccccea4f..4e95391780 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,7 +15,8 @@ "bourbon": "^7.0.0", "include-media": "^1.4.9", "popper.js": "^1.16.1" - } + }, + "devDependencies": {} }, "node_modules/awesomplete": { "version": "1.1.5", diff --git a/package.json b/package.json index dd828ba38b..0e5281ff3a 100644 --- a/package.json +++ b/package.json @@ -23,6 +23,8 @@ "url": "https://github.com/AtreNet/prebid.github.io/issues" }, "homepage": "https://github.com/AtreNet/prebid.github.io#readme", + "devDependencies": { + }, "dependencies": { "awesomplete": "^1.1.5", "bootstrap": "^4.5.3", From 595aa8b33fde30cbd8db19b951c9a3bb7dedd33c Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 16:39:20 +0300 Subject: [PATCH 08/11] fix annotations --- dev-docs/bidders/scalibur.md | 62 +++++++++++++++++++++--------------- 1 file changed, 37 insertions(+), 25 deletions(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index 8b93215b74..f27450a5a5 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -31,6 +31,7 @@ pbs_app_supported: false The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertising platform. It supports both banner and video ad formats through OpenRTB 2.x protocol and provides full compliance with privacy regulations. **Key Features:** + - Banner and Video (instream) ad support - OpenRTB 2.x compliant requests - Privacy regulation compliance @@ -40,7 +41,6 @@ The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertis - Floor pricing support - First Party Data (FPD) support - ## Bid Params {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | @@ -109,47 +109,55 @@ var adUnits = [ ```javascript var adUnits = [ - { - code: 'test-multiformat-div', - mediaTypes: { - banner: { - sizes: [[300, 250], [728, 90]] - }, - video: { - context: 'instream', - playerSize: [[300, 169]], - mimes: ['video/mp4'], - protocols: [2, 3, 5, 6], - minduration: 15, - maxduration: 30 - } - }, - bids: [ - { - bidder: 'scalibur', - params: { - placementId: 'test-scl-placement' - } - } - ] - } + { + code: 'test-multiformat-div', + mediaTypes: { + banner: { + sizes: [[300, 250], [728, 90]] + }, + video: { + context: 'instream', + playerSize: [[300, 169]], + mimes: ['video/mp4'], + protocols: [2, 3, 5, 6], + minduration: 15, + maxduration: 30 + } + }, + bids: [ + { + bidder: 'scalibur', + params: { + placementId: 'test-scl-placement' + } + } + ] + } ]; ``` + ## First Party Data + The adapter supports First Party Data (FPD) in multiple ways: + - **Global FPD**: Automatically includes `pbjs.setConfig({ortb2: {...}})` data - **AdUnit FPD**: Includes ad unit specific `ortb2Imp` data - **Local Storage**: Generates and stores first-party identifiers for enhanced targeting ## Supply Chain Transparency + The adapter supports the Supply Chain Object (schain) for transparency in programmatic advertising transactions, helping to combat fraud and improve trust between buyers and sellers. + ## Floor Prices + The adapter respects floor prices set via: + - Prebid.js Price Floors module - Ad unit level floor configuration - Global floor configuration ## User Sync + The Scalibur adapter supports user synchronization through: - **Iframe syncs**: For enhanced matching capabilities - **Image syncs**: For lightweight synchronization @@ -157,6 +165,7 @@ The Scalibur adapter supports user synchronization through: All privacy parameters are automatically included in sync requests. ## Configuration Example + ```javascript pbjs.que.push(function() { pbjs.addAdUnits(adUnits); @@ -187,11 +196,14 @@ pbjs.que.push(function() { ``` ## Support + For technical support or integration assistance: + - **Email**: support@scalibur.io - **Documentation**: Contact Scalibur Support Team ## Notes + - The adapter requires a valid `placementId` parameter provided by Scalibur - Video ads support instream context with standard IAB video parameters - Banner ads support multiple sizes including standard IAB sizes From 4009cc5530bdae68a9fedaff1cec1b2bc9995f1f Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 16:42:32 +0300 Subject: [PATCH 09/11] more annotation fixes --- dev-docs/bidders/scalibur.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index f27450a5a5..584ae58f80 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -159,6 +159,7 @@ The adapter respects floor prices set via: ## User Sync The Scalibur adapter supports user synchronization through: + - **Iframe syncs**: For enhanced matching capabilities - **Image syncs**: For lightweight synchronization From 98750a8ba6a8c15fbda964186cb47c91e82c2e01 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Mon, 1 Sep 2025 16:45:05 +0300 Subject: [PATCH 10/11] more annotation fixes --- dev-docs/bidders/scalibur.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index 584ae58f80..414bf94002 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -200,7 +200,7 @@ pbjs.que.push(function() { For technical support or integration assistance: -- **Email**: support@scalibur.io +- **Email**: [support@scalibur.io](mailto:support@scalibur.io) - **Documentation**: Contact Scalibur Support Team ## Notes From 8f9cefe3b2254bcb10e0e4bbac9a6825a64723e7 Mon Sep 17 00:00:00 2001 From: Timor Bibi Date: Tue, 2 Sep 2025 10:14:07 +0300 Subject: [PATCH 11/11] fix bid params rendering --- dev-docs/bidders/scalibur.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/dev-docs/bidders/scalibur.md b/dev-docs/bidders/scalibur.md index 414bf94002..111075947e 100644 --- a/dev-docs/bidders/scalibur.md +++ b/dev-docs/bidders/scalibur.md @@ -42,9 +42,10 @@ The Scalibur Bid Adapter connects publishers to Scalibur's programmatic advertis - First Party Data (FPD) support ## Bid Params + {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | -|---------------|----------|---------------------------------------------|------------------------|----------| +|------|-------|-------------|---------|------| | `placementId` | required | Placement identifier provided by Scalibur | `'test-placement-123'` | `string` | ## Test Parameters