# Extra Feature module Should you require a specific configuration for your tagId, you can utilize the Extra Feature module. The feature is accessible at the tagID level via the "Extra Feature" box. Once selected, you can input your code. The following options are available: ```typescript export type ExtraFeatures = { auctionForcedPrice?: { cpm: number, currency: 'EUR' | 'USD', }, auctionFixedPrice?: { cpm: number currency: 'EUR' | 'USD', }, sspFixedPrice?: { [K in SspList]?: { cpm: number currency: 'EUR' | 'USD', } }, formatRestriction?: { [K in SspList]?: Mediatype[] }, appnexusPmtRule?: boolean, stailaPmtRule?: boolean, sspAdjustment?: { [K in SspList]?: number }, dealidAdjustment?: Record, dealidFixedPrice?: Record, videoPlcmtOverride?: number, videoOverride?: { mimes?: string[], minduration?: number, maxduration?: number, protocols?: number[], protocol?: number, w?: number, h?: number, startdelay?: number, linearity?: number, skip?: number, skipmin?: number, skipafter?: number, sequence?: number, battr?: number[], maxextended?: number, minbitrate?: number, maxbitrate?: number, boxingallowed?: number, playbackmethod?: number[], playbackend?: number, placement?: number, plcmt?: number, delivery?: number[], pos?: number, api?: number[], companiontype?: number[], }, sspFloorPrice?: { [K in SspList]?: { cpm: number, currency: 'EUR' | 'USD', } }, countryFloorPrice?: Record, floorPerCountryPerSsp?: { [country: string]: { [K in SspList]?: { cpm: number, currency: 'EUR' | 'USD', } } }, sspCountryWhitelist?: { [K in SspList]?: string[] }, sspCountryBlacklist?: { [K in SspList]?: string[] }, sspDomainWhitelist?: { [K in SspList]?: string[] }, sspDomainBlacklist?: { [K in SspList]?: string[] }, schain?: { [K in SspList]?: { asi: string, sid: string } }, }; ``` *** ## Feature Descriptions ### Price Adjustment Features #### auctionForcedPrice **Purpose:** Forces a specific CPM price for all winning bids in the auction, regardless of the actual bid price. **Behavior:** * Overrides ALL other price adjustments (account, site, SSP adjustments) * The final price is set to the specified CPM value, converted to the bid currency * Bids are always eligible after adjustment (no minimum threshold check) * Has the highest priority among all price adjustment features **Example:** ```json {"auctionForcedPrice":{"cpm":100,"currency":"USD"}} ``` This sets all winning bids to $100 CPM regardless of the original bid price. *** #### auctionFixedPrice **Purpose:** Sets a fixed ceiling price for all winning bids in the auction. **Behavior:** * Overrides other price adjustments (account, site, SSP adjustments) * The final price is set to the specified CPM value * **Bid eligibility check:** If the adjustment would increase the bid price (i.e., original bid is lower than fixed price), the bid becomes ineligible * Lower priority than `auctionForcedPrice` and `dealidFixedPrice` **Example:** ```json {"auctionFixedPrice":{"cpm":5,"currency":"EUR"}} ``` All winning bids will be priced at €5 CPM. Bids originally below €5 will be rejected. *** #### sspFixedPrice **Purpose:** Sets a fixed price for bids from a specific SSP partner. **Behavior:** * Applies on top of other adjustments (account, site, SSP, stored request adjustments) * The fixed price is multiplied with existing adjustments * **Bid eligibility check:** If the final adjusted price is lower than the SSP fixed price, the bid is rejected * Only affects the specified SSP partner(s) * Lower priority than `auctionForcedPrice`, `auctionFixedPrice`, and `dealidFixedPrice` **Example:** ```json {"sspFixedPrice":{"criteo":{"cpm":3,"currency":"EUR"}}} ``` Sets a €3 CPM fixed price specifically for Criteo bids. *** #### sspAdjustment **Purpose:** Applies a multiplier adjustment to bids from a specific SSP partner. **Behavior:** * The bid price is multiplied by the adjustment value * Value of `0.8` means the bid is reduced by 20% * Value of `1.2` means the bid is increased by 20% * Applied in combination with account-level and site-level CPM adjustments **Example:** ```json {"sspAdjustment":{"criteo":0.8}} ``` Reduces all Criteo bids by 20%. *** #### dealidAdjustment **Purpose:** Applies a multiplier adjustment to bids with a specific deal ID. **Behavior:** * When a bid contains a matching deal ID, the adjustment multiplier is applied * Works similarly to `sspAdjustment` but targets specific deals * Value of `0.9` means the bid is reduced by 10% **Example:** ```json {"dealidAdjustment":{"testdealid":0.9}} ``` Reduces bids with deal ID "testdealid" by 10%. *** #### dealidFixedPrice **Purpose:** Sets a fixed price for bids with a specific deal ID. **Behavior:** * Overrides other price adjustments when the bid contains a matching deal ID * **Bid eligibility check:** If the fixed price would increase the bid (original bid is lower), the bid becomes ineligible * Higher priority than `auctionFixedPrice` but lower than `auctionForcedPrice` **Example:** ```json {"dealidFixedPrice":{"testdealid":{"cpm":3,"currency":"EUR"}}} ``` Sets a €3 CPM fixed price for bids with deal ID "testdealid". *** ### Floor Price Features #### sspFloorPrice **Purpose:** Sets a minimum bid floor price for a specific SSP partner. **Behavior:** * Sets the `bidfloor` value sent in the OpenRTB request to the specified SSP * The floor price is converted to USD before being sent * Takes priority over the default position bidfloor * Only affects outgoing requests to the specified SSP(s) **Example:** ```json {"sspFloorPrice":{"criteo":{"cpm":3,"currency":"EUR"}}} ``` Sets a €3 floor price for requests sent to Criteo. *** #### countryFloorPrice **Purpose:** Sets a minimum bid floor price based on the user's country. **Behavior:** * Uses the user's geo-located country (ISO 3166-1 alpha-2 code) * If the user is in a matching country, the position's bidfloor is overridden * The floor price is converted to USD * Applies to all SSPs for that position **Example:** ```json {"countryFloorPrice":{"FR":{"cpm":3,"currency":"EUR"},"DE":{"cpm":2.5,"currency":"EUR"}}} ``` Sets a €3 floor for users in France and €2.50 for users in Germany. *** #### floorPerCountryPerSsp **Purpose:** Sets minimum bid floor prices on a per-country, per-SSP basis — combining the country targeting of `countryFloorPrice` with the SSP specificity of `sspFloorPrice`. **Behavior:** * Uses the user's geo-located country (ISO 3166-1 alpha-2 code) * If the user's country matches a key in the configuration, the SSP-specific floor prices for that country are applied * Overrides any existing `sspFloorPrice` values for the matching SSPs * Countries not present in the configuration are unaffected * Floor prices are converted to USD before being sent in the bid request **Example:** ```json { "floorPerCountryPerSsp": { "FR": { "smartadserver": { "cpm": 5, "currency": "EUR" }, "rubicon": { "cpm": 3.5, "currency": "EUR" } }, "US": { "smartadserver": { "cpm": 6, "currency": "USD" }, "rubicon": { "cpm": 4.5, "currency": "USD" } } } } ``` For users in France, Smartadserver will receive a €5 floor and Rubicon a €3.50 floor. For users in the US, those floors are $6 and $4.50 respectively. SSPs not listed under a country are sent no floor from this feature. *** ### SSP Restriction Features #### formatRestriction **Purpose:** Restricts which media types an SSP can bid on for this position. **Behavior:** * If the position's mediatype is NOT in the allowed list, the SSP is blocked with status `FORMATBLOCKED` * Available mediatypes: `"banner"`, `"video"`, `"audio"`, `"native"` * If no restriction is defined for an SSP, all formats are allowed **Example:** ```json {"formatRestriction":{"appnexus":["video","audio"]}} ``` AppNexus will only be called for video and audio positions. Banner and native requests will be blocked. *** #### sspCountryWhitelist **Purpose:** Restricts an SSP to only receive requests from users in specific countries. **Behavior:** * Uses the user's geo-located country (ISO 3166-1 alpha-2 code) * If the user's country is NOT in the whitelist, the SSP is blocked with status `GEOBLOCKED` * Country codes must be uppercase (e.g., "FR", "US", "DE") * If the whitelist is empty or not defined, no country restriction is applied **Example:** ```json {"sspCountryWhitelist":{"criteo":["FR","ES","DE"]}} ``` Criteo will only be called for users in France, Spain, or Germany. *** #### sspCountryBlacklist **Purpose:** Blocks an SSP from receiving requests from users in specific countries. **Behavior:** * Uses the user's geo-located country (ISO 3166-1 alpha-2 code) * If the user's country IS in the blacklist, the SSP is blocked with status `GEOBLOCKED` * Country codes must be uppercase (e.g., "FR", "US", "DE") * If the blacklist is empty or not defined, no country restriction is applied **Example:** ```json {"sspCountryBlacklist":{"criteo":["RU","CN"]}} ``` Criteo will be blocked for users in Russia or China. *** #### sspDomainWhitelist **Purpose:** Restricts an SSP to only receive requests from specific domains. **Behavior:** * If the request domain is NOT in the whitelist, the SSP is blocked with status `DOMAINBLOCKED` * Supports wildcard matching with `*.` prefix for subdomains * Domain matching ignores `www.` prefix (e.g., "example.com" matches "[www.example.com](http://www.example.com)") * Wildcard example: `"*.example.com"` matches `"sub.example.com"` and `"example.com"` **Example:** ```json {"sspDomainWhitelist":{"criteo":["example.com","*.partner.net"]}} ``` Criteo will only be called for requests from example.com or any subdomain of partner.net. *** #### sspDomainBlacklist **Purpose:** Blocks an SSP from receiving requests from specific domains. **Behavior:** * If the request domain IS in the blacklist, the SSP is blocked with status `DOMAINBLOCKED` * Supports wildcard matching with `*.` prefix for subdomains * Domain matching ignores `www.` prefix * Wildcard example: `"*.blocked.com"` blocks `"sub.blocked.com"` and `"blocked.com"` **Example:** ```json {"sspDomainBlacklist":{"criteo":["competitor.com","*.spam.net"]}} ``` Criteo will be blocked for requests from competitor.com or any subdomain of spam.net. *** ### Partner-Specific Features #### appnexusPmtRule / stailaPmtRule **Purpose:** Enables Publisher-Managed Targeting (PMT) rules for AppNexus/Xandr requests. **Behavior:** * When set to `true`, the `use_pmt_rule: true` flag is added to the AppNexus bid request * This enables AppNexus PMT rules configured in the AppNexus console * Both `appnexusPmtRule` and `stailaPmtRule` have the same effect (legacy naming) * Either flag being `true` will enable the PMT rule **Example:** ```json {"appnexusPmtRule":true} ``` or ```json {"stailaPmtRule":true} ``` *** #### videoPlcmtOverride **Purpose:** Overrides the video placement type (plcmt) value in OpenRTB video requests. **Behavior:** * Sets the `video.plcmt` field in the OpenRTB bid request * Valid values according to OpenRTB 2.6: * `1` = In-Stream (Pre/Mid/Post-roll) * `2` = Accompanying Content * `3` = Interstitial * `4` = No Content/Standalone **Example:** ```json {"videoPlcmtOverride":1} ``` Forces all video requests for this position to be marked as in-stream pre/mid/post-roll. *** #### videoOverride **Purpose:** Overrides or augments any field in the OpenRTB video object sent to SSPs, without needing to change the underlying tagId configuration. **Behavior:** * Only applies to positions that have a video object * All fields are optional — only the fields you specify are overridden; all others retain their original values * The override is applied to all SSPs bidding on the position * Uses a shallow merge, so specifying an array field (e.g. `mimes`) replaces the entire array rather than appending to it **Fields:** | Field | Type | Description | | ---------------- | --------- | ------------------------------------------------------------------------------------------------------- | | `mimes` | string\[] | Content MIME types (e.g. `["video/mp4"]`) | | `minduration` | number | Minimum video ad duration in seconds | | `maxduration` | number | Maximum video ad duration in seconds | | `protocols` | number\[] | Supported VAST protocols (2=VAST2, 3=VAST3, 5=VAST2 Wrapper, 6=VAST3 Wrapper, 7=VAST4, 8=VAST4 Wrapper) | | `w` | number | Video player width in pixels | | `h` | number | Video player height in pixels | | `startdelay` | number | Start delay in seconds (0=pre-roll, -1=generic mid-roll, -2=generic post-roll) | | `linearity` | number | Linearity (1=linear/in-stream, 2=non-linear/overlay) | | `skip` | number | Whether the ad is skippable (0=no, 1=yes) | | `skipmin` | number | Minimum duration before skip is allowed (seconds) | | `skipafter` | number | Seconds after which the ad becomes skippable | | `minbitrate` | number | Minimum bitrate in kbps | | `maxbitrate` | number | Maximum bitrate in kbps | | `playbackmethod` | number\[] | Playback methods (1=auto-play sound on, 2=auto-play sound off, 3=click-to-play, 4=mouse-over) | | `plcmt` | number | Video placement (1=In-Stream, 2=Accompanying Content, 3=Interstitial, 4=No Content/Standalone) | | `pos` | number | Ad position on page (0=unknown, 4=above fold, 8=below fold) | | `api` | number\[] | Supported APIs (2=VPAID2, 6=OMID1) | **Example:** ```json { "videoOverride": { "mimes": ["video/mp4"], "maxduration": 30, "skip": 1, "skipmin": 5, "skipafter": 15, "plcmt": 1, "playbackmethod": [2] } } ``` This forces the position to only accept MP4 video, caps duration at 30 seconds, marks it as skippable after 15 seconds, sets the placement to in-stream, and requires auto-play with sound off. *** ### Supply Chain Features #### schain **Purpose:** Adds a per-SSP supply chain (schain) node to the bid request at the tagId level. **Behavior:** * Appends an additional schain node to the supply chain sent to the specified SSP(s) * The node is added **after** the site-level schain node (most granular last) * **Independent of site-level schain exclusion** — even if an SSP is excluded from the site schain, the extraFeatures schain node will still be included * Duplicate nodes are automatically deduplicated by `asi` * The `hp` (hosted/published) field is automatically set to `1` **Example:** ```json {"schain":{"appnexus":{"asi":"publisher.com","sid":"12345"}}} ``` This adds a supply chain node with `asi: "publisher.com"` and `sid: "12345"` to all bid requests sent to AppNexus for this tagId. **Multiple SSPs:** ```json {"schain":{"appnexus":{"asi":"publisher.com","sid":"12345"},"criteo":{"asi":"reseller.com","sid":"67890"}}} ``` Different schain nodes can be configured per SSP partner. *** ## Priority Order When multiple price adjustment features are configured, they are evaluated in this priority order (highest first): 1. **auctionForcedPrice** - Always sets the exact price, overrides everything 2. **dealidFixedPrice** - Applied if bid has matching deal ID 3. **auctionFixedPrice** - Applied if no forced price or deal fixed price 4. **sspFixedPrice** - Applied in combination with other adjustments 5. **Basic adjustments** (account, site, SSP, stored request, deal adjustments) - Applied multiplicatively *** ## Examples ### Combining Multiple Features You can combine multiple features in a single JSON configuration: ```json { "sspFloorPrice": {"criteo": {"cpm": 2, "currency": "EUR"}}, "sspCountryWhitelist": {"criteo": ["FR", "DE", "ES"]}, "sspAdjustment": {"appnexus": 0.9} } ``` This configuration: * Sets a €2 floor price for Criteo * Only calls Criteo for users in France, Germany, or Spain * Reduces all AppNexus bids by 10% ### Complex Geo-Targeting Setup ```json { "countryFloorPrice": { "US": {"cpm": 5, "currency": "USD"}, "GB": {"cpm": 3, "currency": "EUR"}, "FR": {"cpm": 2.5, "currency": "EUR"} }, "sspCountryBlacklist": { "rubicon": ["CN", "RU"], "appnexus": ["IN"] } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.nexx360.io/general-configuration/extra-feature-module.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.