From 67d76967219f30b607b7561338ec36675c8cb88c Mon Sep 17 00:00:00 2001 From: Serhii Kolomiiets Date: Tue, 21 Nov 2023 13:58:59 +0200 Subject: [PATCH 1/2] Extended application-settings.md, section "Account properties" --- docs/application-settings.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/application-settings.md b/docs/application-settings.md index 885c836a257..9151ea27f65 100644 --- a/docs/application-settings.md +++ b/docs/application-settings.md @@ -20,6 +20,12 @@ There are two ways to configure application settings: database and file. This do the bid and log an operational warning. - `auction.events.enabled` - enables events for account if true - `auction.debug-allow` - enables debug output in the auction response. Default `true`. +- `auction.targeting.includewinners` - whether to include targeting for the winning bids in response. Default `false`. +- `auction.targeting.includebidderkeys` - whether to include targeting for the best bid from each bidder in response. Default `false`. +- `auction.targeting.includeformat` - whether to include the “hb_format” targeting key. Default `false`. +- `auction.targeting.preferdeals` - if targeting is returned and this is `true`, PBS will choose the highest value deal before choosing the highest value non-deal. Default `false`. +- `auction.targeting.alwaysincludedeals` - PBS-Java only. If true, generate `hb_ATTR_BIDDER` values for all bids that have a `dealid`. Default to `false`. +- `auction.targeting.prefix` - defines prefix for targeting keywords. Default `hb_`. May be overridden by corresponded property from bid request. - `privacy.ccpa.enabled` - enables gdpr verifications if true. Has higher priority than configuration in application.yaml. - `privacy.ccpa.channel-enabled.web` - overrides `ccpa.enforce` property behaviour for web requests type. - `privacy.ccpa.channel-enabled.amp` - overrides `ccpa.enforce` property behaviour for amp requests type. From ed8373654bb51e097d5cb5a7415f87a86e3e65af Mon Sep 17 00:00:00 2001 From: Serhii Kolomiiets Date: Tue, 28 Nov 2023 11:51:17 +0200 Subject: [PATCH 2/2] Post-review updates --- docs/application-settings.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/application-settings.md b/docs/application-settings.md index 9151ea27f65..666094f5df0 100644 --- a/docs/application-settings.md +++ b/docs/application-settings.md @@ -25,7 +25,11 @@ There are two ways to configure application settings: database and file. This do - `auction.targeting.includeformat` - whether to include the “hb_format” targeting key. Default `false`. - `auction.targeting.preferdeals` - if targeting is returned and this is `true`, PBS will choose the highest value deal before choosing the highest value non-deal. Default `false`. - `auction.targeting.alwaysincludedeals` - PBS-Java only. If true, generate `hb_ATTR_BIDDER` values for all bids that have a `dealid`. Default to `false`. -- `auction.targeting.prefix` - defines prefix for targeting keywords. Default `hb_`. May be overridden by corresponded property from bid request. +- `auction.targeting.prefix` - defines prefix for targeting keywords. Default `hb`. +Keep in mind following restrictions: + - this prefix value may be overridden by correspond property from bid request + - prefix length is limited by `auction.truncate-target-attr` + - if custom prefix may produce keywords that exceed `auction.truncate-target-attr`, prefix value will drop to default `hb` - `privacy.ccpa.enabled` - enables gdpr verifications if true. Has higher priority than configuration in application.yaml. - `privacy.ccpa.channel-enabled.web` - overrides `ccpa.enforce` property behaviour for web requests type. - `privacy.ccpa.channel-enabled.amp` - overrides `ccpa.enforce` property behaviour for amp requests type. @@ -114,6 +118,13 @@ Here's an example YAML file containing account-specific settings: enabled: true price-floors: enabled: false + targeting: + includewinners: false + includebidderkeys: false + includeformat: false + preferdeals: false + alwaysincludedeals: false + prefix: hb debug-allow: true metrics: verbosity-level: basic