From d8d992a2314c16f7a535592ce6911bd9088b5950 Mon Sep 17 00:00:00 2001 From: Demetrio Girardi Date: Wed, 13 Aug 2025 11:52:52 -0700 Subject: [PATCH] Add notes on schain and prebid 10 --- dev-docs/modules/schain.md | 3 ++- dev-docs/pb10-notes.md | 7 +++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/dev-docs/modules/schain.md b/dev-docs/modules/schain.md index 777cd2d3e1..b394d20b48 100644 --- a/dev-docs/modules/schain.md +++ b/dev-docs/modules/schain.md @@ -28,7 +28,8 @@ Two modes are supported: ## How to Use the Module {: .alert.alert-warning :} -**Prebid 10 :** You don't need to add the schain module explicitly starting from Prebid 10. +Since Prebid 10, schain is treated as first party data: this module just copies `schain.config` into `ortb2.source.ext.schain`. You may provide it (or `ortb2.source.schain`) directly, removing the need for this module. +Note that bidder-specific first party data is merged with global first party data, while up until Prebid 9 bidder-specific schains override the global schain. The simplest way to upgrade to 10 is to avoid using both. First, build the schain module into your Prebid.js package: diff --git a/dev-docs/pb10-notes.md b/dev-docs/pb10-notes.md index c1026b2447..20fa95ba27 100644 --- a/dev-docs/pb10-notes.md +++ b/dev-docs/pb10-notes.md @@ -92,6 +92,13 @@ The following modules have been removed from Prebid.js as part of the 10.0 relea * Tests now target Chrome 109 as the minimum version. `not dead` was added to the babel target. * **The `pbYield` helper was added and greedy rendering is disabled by default.** +## `Schain` is now first party data + +* Publishers should provide schain as first party data in `ortb2.source.schain` or `ortb2.source.ext.schain`. +* The schain module is no longer necessary and has been updated to simply copy `schain` configuration into first party data; it will be removed in the future. +* Adapters should look for schain in `ortb2.source.ext.schain`. +* Like all first party data, **bidder-specific schains are now merged with the global schain**, where previously they would replace it. Publishers setting both global and bidder-specific schains will need to make changes; the simplest way to address this is to use only bidder-specific schains. + ## API Changes * The `ADPOD` mediatype has received a deprecation warning.