Content
Introduction
A new feature has been introduced to support CPM floor configurations. This feature allows setting CPM floor values based on CPM percentiles. For example, the 80th percentile represents the CPM value below which 80% of impressions fall. Floors can be configured per country or per platform, cohort, and other parameters for the configuration.
New CPM Percentile Configuration Section
- A new sub-section, CPM Percentiles has been added under the Ads menu in the left sidebar.
Navigate to Ads > CPM Percentiles > Interstitials , and select the
[green + sign] to create a new entity.
List View and Available Filters
All the regular filters are available for CPM Percentile configurations.
Standard Fields for New/Edit View
Fields Descriptions
| Name | Validations | Description |
| --- | --- | --- |
| Name | - Default: Blank - Type: String - Mandatory : Yes | Specify the Name for the configuration |
| Priority | - Default: Blank - Type: Integer - Mandatory : Yes | Specify the priority of the configuration |
| Label | - Default: Blank - Type: Single-select dropdown - Mandatory : No | Select the relevant label from the available options. |
| Platform | - Default: None - Type: Single-select dropdown - Options: None, iOS, Android - Mandatory : Yes | Usage : Determines the platform used to retrieve CPM values from storage |
| CPM source country | - Default: None - Single-select dropdown - Options: - Mandatory : Yes | Usage: Defines base country to fetch CPM floor from storage |
| Additional countries to apply CPM | - Default: None - Two fields: - Mandatory : Yes | 1. Operator: Use this to define how the selected countries in the second field should be treated in the rule logic. Options: None, IN, NOT IN) 2. List of all countries excluding those already available for selection in the “CPM Source Country” field Choose one or more countries to which the CPM percentile setting should also apply (if using IN) or exclude (if using NOT IN). For the countries selected in this field, CPMs will be taken from country selected in “CPM source country” field |
| Cohort Day | - Default: Blank - Single select dropdown these options: - Mandatory : Yes | Selected Cohort range is used to define which cohort day should be used to find required CPM value from the storage. |
| Percentile | - Default: Blank - Single select dropdown with these options: - Mandatory : Yes | Selected Percentile value is used to define which Percentile value should be used to find required CPM value from the storage. |
Static CPM Configuration for MAX Interstitial Ad Unit
The Static CPM Configuration section allows you to control the behaviour of CPM floor values based on either static settings or percentile-based logic. This section is visible when configuring MAX Interstitial Ad Units, and applies to all Bidding CPM Floor Types.
Overview of Changes
Static floor CPM is renamed to Fallback CPM value.
A new configuration section, Static CPM Configuration, is introduced when the CPM floor type is set to either Static or Formula.
How CPM Floor Values Are Determined
When “Use Percentile” Is Enabled
If you enable the “Use Percentile” option, CPM floor values are dynamically selected based on percentile configurations. Here’s how it works:
Percentiles are available for Ad Slots for Interstitials / Rewarded Videos and MAX interstitials / Rewarded videos Ad Units.
The system identifies matching CPM percentile configurations using:
If multiple configurations match, the system selects the one with the highest priority.
The CPM value is retrieved from a backend storage system.
The retrieved value is sent to the client.
Fallback Behaviour
Fallback settings ensure that a CPM floor is still sent even if a percentile-based value cannot be determined.
Scenario 1: No Matching Configuration Found
If no percentile config matches the user that is the user does not match to any of selected percentile config by the following parameters: Platform, CPM Source Country, Additional Countries to apply CPM, or Cohort Day:
- The system refers to the setting: If no matching configuration.
Scenario 2: No Percentile Data Available
If percentile data is unavailable (e.g., backend storage is inaccessible or lacks data):
- The system refers to the setting: If no percentile available.
When “Use Percentile” Is Disabled
If “Use Percentile” is disabled, the system does not apply any percentile logic. Instead, the existing CPM logic is used based on either:
A static CPM value, or
A formula defined in the configuration.
New Fields in Static CPM Configuration
| Name | Validations | Description |
| Fallback CPM Value | - Default: Empty - Type: float - Mandatory | Specify a fallback floor value to be sent to Max for interstitial bidding. |
| Use Percentile | - Default: False - Type: Boolean - Mandatory if enabled | Enable to use percentile for CPM floor value. |
| CPM Percentile Configs | - Default: Blank - Multi-select Dropdown - Options: List of available configs - Mandatory if Use Percentiles is enabled | Select the relevant config from the dropdown. |
| If No Matching Configuration | - Default: Return Fallback value - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles is enabled | Select the relevant option if no matching config is available. |
| If No Percentile Available | - Default: Return Fallback value - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles is enabled | Select the relevant option if no percentile is available. |
Usage of Percentile Config in both Static and Formula Floor Types
The Percentile configuration is designed to work with both Static and Formula CPM floor types.
Static Floor Type + (Use Percentile = true)
When the floor type is set to Static and the Use Percentile option is enabled:
- The system ignores the fallback static CPM and instead follows the percentile-based logic:
Formula Floor Type + (Use Percentile = true)
When the floor type is Formula , the behaviour depends on the fallback policy defined in the formula configuration:
If “If insufficient ad requests” = “Return Fallback Value” :
If “If insufficient ad requests” = “Return nothing” :
Ad Slots Config Changes
Configuring Static CPM Floors in Ad Slots
When configuring ad slots, a Static CPM Configuration section is displayed based on your selected CPM floor type.
When Static CPM Configuration Appears
This section is shown if:
CPM Floor Type is set to Static or Formula, or
CPM Floor Type is Waterfall and Level Type is Fixed
Key Changes and Fields
Static floor CPM has been renamed to Fallback CPM value.
The configuration section includes the following fields:
The behaviour of these fields is described here.
Behaviour in Waterfall CPM Floor Type with Level Type as Multiplier
Static CPM configuration is not shown
Existing multiplier logic remains unchanged
User can still enter a CPM floor, but percentile logic is not applicable
Summary of Logic
Static CPM configuration appears for:
Percentile logic and fallback behaviour applies consistently across all applicable types
If Waterfall → Type = Multiplier, only multiplier logic is used (no percentile support)
Chunks 1
# Introduction
A new feature has been introduced to support CPM floor configurations. This feature allows setting CPM floor values based on CPM percentiles. For example, the 80th percentile represents the CPM value below which 80% of impressions fall. Floors can be configured per country or per platform, cohort, and other parameters for the configuration.
* * *
## **New CPM Percentile Configuration Section**
- A new sub-section, **CPM Percentiles** has been added under the Ads menu in the left sidebar.
Navigate to **Ads \> CPM Percentiles \> Interstitials** , and select the  **[green + sign]** to create a new entity.
### **List View and Available Filters**
All the regular filters are available for CPM Percentile configurations.
### **Standard Fields for New/Edit View**
#### **Fields Descriptions**
| **Name** | **Validations** | **Description** |
| --- | --- | --- |
| Name | - Default: Blank - Type: String - **Mandatory** : Yes | Specify the Name for the configuration |
| Priority | - Default: Blank - Type: Integer - **Mandatory** : Yes | Specify the priority of the configuration |
| Label | - Default: Blank - Type: Single-select dropdown - **Mandatory** : No | Select the relevant label from the available options. |
| Platform | - Default: None - Type: Single-select dropdown - Options: None, iOS, Android - **Mandatory** : Yes | **Usage** : Determines the platform used to retrieve CPM values from storage |
| CPM source country | - Default: None - Single-select dropdown - Options: - **Mandatory** : Yes | **Usage:** Defines base country to fetch CPM floor from storage |
| Additional countries to apply CPM | - Default: None - Two fields: - **Mandatory** : Yes | 1. Operator: Use this to define how the selected countries in the second field should be treated in the rule logic. Options: None, IN, NOT IN) 2. List of all countries excluding those already available for selection in the “CPM Source Country” field Choose one or more countries to which the CPM percentile setting should also apply (if using IN) or exclude (if using NOT IN). For the countries selected in this field, CPMs will be taken from country selected in “CPM source country” field |
| Cohort Day | - Default: Blank - Single select dropdown these options: - **Mandatory** : Yes | Selected Cohort range is used to define which cohort day should be used to find required CPM value from the storage. |
| Percentile | - Default: Blank - Single select dropdown with these options: - **Mandatory** : Yes | Selected Percentile value is used to define which Percentile value should be used to find required CPM value from the storage. |
* * *
## Static CPM Configuration for MAX Interstitial Ad Unit
The Static CPM Configuration section allows you to control the behaviour of CPM floor values based on either static settings or percentile-based logic. This section is visible when configuring MAX Interstitial Ad Units, and applies to all Bidding CPM Floor Types.
### Overview of Changes
- Static floor CPM is renamed to Fallback CPM value.
- A new configuration section, Static CPM Configuration, is introduced when the CPM floor type is set to either Static or Formula.
## How CPM Floor Values Are Determined
### When “Use Percentile” Is Enabled
If you enable the “Use Percentile” option, CPM floor values are dynamically selected based on percentile configurations. Here’s how it works:
1. Percentiles are available for Ad Slots for Interstitials / Rewarded Videos and MAX interstitials / Rewarded videos Ad Units.
2. The system identifies matching CPM percentile configurations using:
3. If multiple configurations match, the system selects the one with the highest priority.
4. The CPM value is retrieved from a backend storage system.
5. The retrieved value is sent to the client.
* * *
## Fallback Behaviour
Fallback settings ensure that a CPM floor is still sent even if a percentile-based value cannot be determined.
**Scenario 1: No Matching Configuration Found**
If no percentile config matches the user that is the user does not match to any of selected percentile config by the following parameters: **Platform, CPM Source Country, Additional Countries to apply CPM, or Cohort Day:**
- The system refers to the setting: If no matching configuration.
**Scenario 2: No Percentile Data Available**
If percentile data is unavailable (e.g., backend storage is inaccessible or lacks data):
- The system refers to the setting: If no percentile available.
* * *
### When “Use Percentile” Is Disabled
If “Use Percentile” is disabled, the system does not apply any percentile logic. Instead, the existing CPM logic is used based on either:
- A static CPM value, or
- A formula defined in the configuration.
### New Fields in Static CPM Configuration
| **Name** | **Validations** | **Description** |
| Fallback CPM Value | - Default: Empty - Type: float - Mandatory | Specify a fallback floor value to be sent to Max for interstitial bidding. |
| Use Percentile | - Default: False - Type: Boolean - Mandatory if enabled | Enable to use percentile for CPM floor value. |
| CPM Percentile Configs | - Default: Blank - Multi-select Dropdown - Options: List of available configs - Mandatory if Use Percentiles is enabled | Select the relevant config from the dropdown. |
| If No Matching Configuration | - Default: Return Fallback value - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles is enabled | Select the relevant option if no matching config is available. |
| If No Percentile Available | - Default: Return Fallback value - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles is enabled | Select the relevant option if no percentile is available. |
* * *
### Usage of Percentile Config in both Static and Formula Floor Types
The Percentile configuration is designed to work with both Static and Formula CPM floor types.
**Static Floor Type + (Use Percentile = true)**
When the floor type is set to **Static** and the **Use Percentile** option is enabled:
- The system ignores the fallback static CPM and instead follows the percentile-based logic:
**Formula Floor Type + (Use Percentile = true)**
When the floor type is **Formula** , the behaviour depends on the fallback policy defined in the formula configuration:
- **If “If insufficient ad requests” = “Return Fallback Value”** :
- **If “If insufficient ad requests” = “Return nothing”** :
* * *
## Ad Slots Config Changes
### Configuring Static CPM Floors in Ad Slots
When configuring ad slots, a Static CPM Configuration section is displayed based on your selected CPM floor type.
**When Static CPM Configuration Appears**
This section is shown if:
- CPM Floor Type is set to Static or Formula, or
- CPM Floor Type is Waterfall and Level Type is Fixed
**Key Changes and Fields**
- Static floor CPM has been renamed to Fallback CPM value.
- The configuration section includes the following fields:
The behaviour of these fields is described [here](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/4244537368/CPM+Percentile+Configuration#New-Fields-in-Static-CPM-Configuration).
* * *
### **Behaviour in Waterfall CPM Floor Type with Level Type as Multiplier**
- Static CPM configuration is not shown
- Existing multiplier logic remains unchanged
- User can still enter a CPM floor, but percentile logic is not applicable
* * *
## **Summary of Logic**
- Static CPM configuration appears for:
- Percentile logic and fallback behaviour applies consistently across all applicable types
- If Waterfall → Type = Multiplier, only multiplier logic is used (no percentile support)
* * *