From 3e77b6947bf1fe4d00c5e71e0adb70d4c903efb2 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Tue, 29 Jul 2025 08:29:34 -0400 Subject: [PATCH 01/12] Update contxtful.md to enable PBS support --- dev-docs/bidders/contxtful.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index a20bd83d9c..cf70687820 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -13,7 +13,7 @@ safeframes_ok: true floors_supported: true fpd_supported: true pbjs: true -pbs: false +pbs: true pbs_app_supported: false prebid_member: true multiformar_supported: will-bid-on-any From a6f91310ff09f3957a055669e5ce2596e67880e1 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Tue, 29 Jul 2025 08:48:27 -0400 Subject: [PATCH 02/12] Add bid parameters section to Contxtful documentation --- dev-docs/bidders/contxtful.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index cf70687820..64358dfd1c 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -24,6 +24,15 @@ ortb_blocking_supported: true The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtful.com](mailto:contact@contxtful.com) +### Bid Params + +{: .table .table-bordered .table-striped } +| Name | Scope | Description | Example | Type | +|-------------|----------|------------------------------------------------------------|------------------------------|----------------------| +| `placementId` | required for Prebid and Prebid S2S | The placement identifier | `'p12345678'` | `string` | +| `customerId` | required for Prebid S2S | The customer identifier | `'DEMO123456'` | `string` | + + ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From ac8a0fad13ccc84c4518b2ef54314fc5eca3f94a Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Tue, 29 Jul 2025 08:50:52 -0400 Subject: [PATCH 03/12] Remove unnecessary blank line in Contxtful documentation --- dev-docs/bidders/contxtful.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 64358dfd1c..c373949834 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -32,7 +32,6 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf | `placementId` | required for Prebid and Prebid S2S | The placement identifier | `'p12345678'` | `string` | | `customerId` | required for Prebid S2S | The customer identifier | `'DEMO123456'` | `string` | - ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From bf671bf21dc4ae72e450c8463bfbf46cf20e9b44 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 16:57:22 -0400 Subject: [PATCH 04/12] Update Contxtful documentation to clarify required parameters --- dev-docs/bidders/contxtful.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index c373949834..8a5f6ff464 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -29,7 +29,7 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf {: .table .table-bordered .table-striped } | Name | Scope | Description | Example | Type | |-------------|----------|------------------------------------------------------------|------------------------------|----------------------| -| `placementId` | required for Prebid and Prebid S2S | The placement identifier | `'p12345678'` | `string` | +| `placementId` | required | The placement identifier | `'p12345678'` | `string` | | `customerId` | required for Prebid S2S | The customer identifier | `'DEMO123456'` | `string` | ### User Sync From c2980eca94facc75c6167ee81664efe612da03b8 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 16:58:39 -0400 Subject: [PATCH 05/12] chore: make customerId required --- dev-docs/bidders/contxtful.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 8a5f6ff464..2054833c0a 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -30,7 +30,7 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf | Name | Scope | Description | Example | Type | |-------------|----------|------------------------------------------------------------|------------------------------|----------------------| | `placementId` | required | The placement identifier | `'p12345678'` | `string` | -| `customerId` | required for Prebid S2S | The customer identifier | `'DEMO123456'` | `string` | +| `customerId` | required | The customer identifier | `'DEMO123456'` | `string` | ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From 6a8e2d3ef7665ad62763764c2233429997041c10 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 17:02:57 -0400 Subject: [PATCH 06/12] docs: add config section --- dev-docs/bidders/contxtful.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 2054833c0a..2e5e427d48 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -32,6 +32,34 @@ The Contxtful bidder adapter requires some setup. Contact us at [contact@contxtf | `placementId` | required | The placement identifier | `'p12345678'` | `string` | | `customerId` | required | The customer identifier | `'DEMO123456'` | `string` | +### Configuration + +```javascript +pbjs.setConfig({ + "contxtful":{ + "version":"v1", + "customer":"<>" + }, + "realTimeData":{ + "dataProviders":[ + { + "name":"contxtful", + "waitForIt":true, + "params":{ + "version":"v1", + "customer":"<>", + "bidders":[ + "contxtful" + ], + "adServerTargeting":true + } + } + ] + } +} +); +``` + ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From 3eb62b3b790554bba9616399cf31f3a6ea757c13 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 17:06:11 -0400 Subject: [PATCH 07/12] docs: add section First Party Data --- dev-docs/bidders/contxtful.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 2e5e427d48..ecf388a221 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -60,6 +60,15 @@ pbjs.setConfig({ ); ``` +### First Party Data + +Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported: +- `ortb2.site.*` +- `ortb2.user.*` +- `ortb2.device.*` + +AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*` + ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From dacc2ae133ed175b87f0182ba8aee87660b6965f Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 17:10:24 -0400 Subject: [PATCH 08/12] docs: add AdUnit Format client side --- dev-docs/bidders/contxtful.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index ecf388a221..be406deecf 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -69,6 +69,31 @@ Publishers should use the `ortb2` method of setting First Party Data. The follow AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*` +### AdUnit Format client side + +```javascript + var adUnitList = [ + { + code: 'AD_UNIT_NAME_HERE', + mediaTypes: { /* "<< ENTER_FORMAT_HERE >> */ }, + bids: [{ + bidder: 'contxtful', + params: { + placementId: "<>", + customerId: "<>" + } + }], + ortb2Imp: { + ext: { + data: { + divId: "<>" + } + } + } + } +] +``` + ### User Sync Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. From 23989dc3582cfbd40400e0550487624b11c439e7 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Fri, 8 Aug 2025 17:11:29 -0400 Subject: [PATCH 09/12] docs: add missing line break in First Party Data section of Contxtful documentation --- dev-docs/bidders/contxtful.md | 1 + 1 file changed, 1 insertion(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index be406deecf..09009576bf 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -63,6 +63,7 @@ pbjs.setConfig({ ### First Party Data Publishers should use the `ortb2` method of setting First Party Data. The following fields are supported: + - `ortb2.site.*` - `ortb2.user.*` - `ortb2.device.*` From 3c1a910fc2b571c796b3a792fbe4a775feab08c0 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Mon, 11 Aug 2025 13:12:16 -0400 Subject: [PATCH 10/12] docs: update User Sync section in Contxtful documentation to clarify bidder filter settings --- dev-docs/bidders/contxtful.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 09009576bf..2c8f71cab0 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -96,7 +96,8 @@ AdUnit-specific data is supported using `AdUnit.ortb2Imp.ext.*` ``` ### User Sync -Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig.html#setConfig-Configure-User-Syncing) to optimize match rate and monetization. + +Contxtful recommends enabling [User Syncing](https://docs.prebid.org/dev-docs/publisher-api-reference/setConfig#setConfig-Configure-User-Syncing) to optimize match rate and monetization. {% include dev-docs/storageAllowed.md %} @@ -106,7 +107,7 @@ pbjs.setConfig({ userSync: { filterSettings: { iframe: { - bidders: ['contxtful'], + bidders: '*', // '*' means all bidders filter: 'include' } } From 2aaaf0d8d8da46d33479c20bf9775c13823d7095 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Mon, 11 Aug 2025 13:19:30 -0400 Subject: [PATCH 11/12] docs: document "all" --- dev-docs/bidders/contxtful.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 2c8f71cab0..4d2d9d4eeb 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -121,3 +121,6 @@ pbjs.bidderSettings = { } } ``` + +Note - the `userSync.filterSettings.all` field is mutually exclusive and cannot be combined with the `userSync.filterSettings.iframe`/`userSync.filterSettings.image` fields in the `userSync` config. If the fields are used together, this will be considered an invalid config and only image pixels will be permitted. + From cc31303367b4fa35f4c811653600b45bef3bcb50 Mon Sep 17 00:00:00 2001 From: Sebastien Boisvert Date: Mon, 11 Aug 2025 13:24:31 -0400 Subject: [PATCH 12/12] docs: remove redundant blank line in Contxtful documentation --- dev-docs/bidders/contxtful.md | 1 - 1 file changed, 1 deletion(-) diff --git a/dev-docs/bidders/contxtful.md b/dev-docs/bidders/contxtful.md index 4d2d9d4eeb..930b1f1d75 100644 --- a/dev-docs/bidders/contxtful.md +++ b/dev-docs/bidders/contxtful.md @@ -123,4 +123,3 @@ pbjs.bidderSettings = { ``` Note - the `userSync.filterSettings.all` field is mutually exclusive and cannot be combined with the `userSync.filterSettings.iframe`/`userSync.filterSettings.image` fields in the `userSync` config. If the fields are used together, this will be considered an invalid config and only image pixels will be permitted. -