From c2b710d1fd319d4f8c4c266f58e315bff3221137 Mon Sep 17 00:00:00 2001 From: bgorsline Date: Wed, 2 Apr 2025 16:18:44 -0400 Subject: [PATCH] adding static floor enforcement scenario --- dev-docs/modules/floors.md | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/dev-docs/modules/floors.md b/dev-docs/modules/floors.md index 839bfdcd88..c9733c289d 100644 --- a/dev-docs/modules/floors.md +++ b/dev-docs/modules/floors.md @@ -58,9 +58,9 @@ Notes: * [Prebid Floor Service Providers](/dev-docs/modules/floors.html#floors-providers) * [Transcript of this video](/dev-docs/floors-video-overview.html) -### Simple Static Floors +### Simple Static Floor Signaling -Some publishers just want to set a simple static floor. Please don't use this module for that. This module should only be used when you need to vary the floor by mediatype, size, etc. Here's how you can set static floors on each Prebid adunit: +Some publishers just want to set a simple static floor and don't need enforcement. Please don't use this module for that. This module should only be used when you need to vary the floor by mediatype, size, etc. Here's how you can signal static floors on each Prebid adunit: ```javascript pbjs.addAdUnits({ @@ -78,6 +78,37 @@ pbjs.addAdUnits({ }); ``` +### Simple Static Floor Enforcement + +If you need a static floor signal and also want to enforce that static floor, here's the quick start: + +```javascript + var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { sizes: [[300,250],[300,600]] } + }, + floors: { + currency: 'USD', + schema: { + delimiter: '|', + fields: [ 'mediaType' ] + }, + values: { + '*': 1.00 // enter your static floor here + } + }, + bids: [ + ... + ] + } + ]; +``` + +{: .alert.alert-warning :} +Prebid does not recommend setting static floors. They are blunt tools and you'll forget to update them. + ## How it Works There are several places where the Floor module changes the behavior of the Prebid.js auction process. Below is a diagram describing the general flow of the client-side Price Floors Module: