Interstitials Configuration
Chunk #1
**How does the logic of Overrides in Interstitials work?**
Let’s assume we have 7 players and 4 Interstitials Placement Banks, each of them with a set of placements inside:
.jpg?version=1&modificationDate=1728379257509&cacheVersion=1&api=v2&width=772&height=608)
Now, we’d like to establish a set of overrides for different placement banks. Some overrides will also have Placement overrides or some restrictions for newcomers.
We’ve set 4 overrides, with different priorities, and we’ve assigned players to them using rules. As we can see, Overrides 3 and 4, and Base Config include specific overrides for placements and restrictions for newcomers.
.jpg?version=1&modificationDate=1728379257525&cacheVersion=1&api=v2&width=772&height=405)
With this configuration, each player will receive different overrides with specific settings when they start the game:
Now, we’ll go into detail about why each player receives that configuration:
* * *
# 2. Impression Restrictions
You can determine the value for impression restrictions by applying the identical formula used in[CPM Floor Calculations](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3705274372/Interstitials+Configuration#Setting-the-CPM-Floor).
1. First, navigate to **Ad Config \> Interstitials** , and enable the **Impression Restrictions** setting.
2. Fill in the fields following the information listed in the Impressions Restrictions table below.
3. If required, you can set up overrides for specific ad placements by selecting Overrides.
Then, click the particular placement and select the required settings.
| **Impression Restrictions** |
| **Field Name** | **Description** | **Validations** |
| **Min CPM Type** | Select the way you want to define the Bidding Floor | - Type: Dropdown: Static, Formula - Default: Static |
| **Static CPM Configuration. Fallback CPM Value** | Specify a fallback floor value to be sent for interstitial bidding. | - Type: Float - Default: Empty |
| **Static CPM Configuration. Use Percentiles** | Enable to use percentile for CPM floor value. | - Type: Boolean - Default: False |
| **Static CPM Configuration.CPM Percentile Configs** | Select the relevant config from the dropdown. Refer to this [User Guide](/wiki/spaces/KB/pages/4244537368/CPM+Percentile+Configuration) to learn to configure the CPM Percentiles. | - Type: Multi-select Dropdown - Options: List of available configs (with display priority) - Mandatory if Use Percentiles = True |
| **Static CPM Configuration.If No Matching Configuration** | Select the relevant option if no matching config is available. | - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles = True |
| **Static CPM Configuration. If no Percentile available** | Select the relevant option if no percentile is available. | - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles = True |
| **Formula Parameters. Formula Type** | Defines the type for calculating the formula. | Type: Dropdown with the following options: - Median - Average - Default: Median |
| **Use successful ad requests only** | Enable if you want to use only successful ad requests for calculation. | - Type: Boolean - Default: OFF - Available if type = formula |
| **Min ad requests to apply formula** | This field is used to provide minimum number of interstitials which should be taken into account to calculate formula | - Type: Integer - Mandatory if “Formula” is selected in “Bidding floor type” - Default: Empty - Min 1 - Max: 50 - Must be less than the value provided in the setting “Ad requests to apply formula to“ |
| **Ad requests to apply formula to** | This field is used to provide maximum number of interstitials which should be taken into account to calculate formula | - Type: Integer - Mandatory if “Formula is selected in “Bidding floor type” - Default: Empty - Min 1 - Max: 50 |
| **Percentage coefficient** | Specify the multiplier to minimise the Bid floor. | - Mandatory if “Formula” is selected in “Bidding floor type” - Min: more than 0 - Max: 2 - Max number of characters after comma = 2 - Incase multiplier results in `max_interstitials.cpm_floor` value with more than 2 characters after comma, GS rounds off the result using math rules. - (e.g. if we have as a result value 1,234 -\> round to 1.23 but if 1.235 -\> round to 1.24) |
| **If insufficient ad requests** | Defines the system behaviour when there is insufficient data for calculation. If “Return static value“ is selected, GS will send value from “Static floor CPM“. If “Return nothing“ is selected, GS won’t send any value. | Dropdown with the list of options provided below: - Return fallback value - Return nothing - Default: Return fallback value |
**Setting the CPM Floor**
Game Server provides two types of validations for Bidding Floor Type.
- Static
- Formula
**Choosing a Bidding Floor Type**
There are two options for defining the CPM floor:
**A. Static CPM Floor**
- **Definition** : Sends a fixed CPM value to the client, which is forwarded to the mediation system (e.g., Max, Google, or Meta).
- **How to Configure** :
- **Behaviour** : The same CPM value will always be used for bidding.
**B. Formula-Based CPM Floor**
- **Definition** : Dynamically calculates the CPM floor using the following formula:
- If **Median** is selected in the Formula type dropdown field:
_interstitial\_cpm\_floor = Median (most recent **N** CPM values) \* **K** _
- If **Average** is selected in the Formula type dropdown field:
_interstitial\_cpm\_floor = Average (most recent **N** CPM values) \* **K** _
This formula allows you to determine the number of CPMs stored ( **N** ). If the number of CPMs is lower than **X** (Minimum number of events required for calculation), Game Server won’t return anything, or will return a static value as determined by the settings.
**Determining N for Each Ad Unit**
- N represents the number of most recent CPM values retrieved from a bucket for median calculation.
- **How is N Defined?**
- **Handling Fewer Events than N** :
- **Minimum Number of Events:**
- **Behaviour for Insufficient Events (Fewer than X)**:
- **Multiplier K:**
- **Use successful ad requests only:** Enable/Check if you want to use only successful ad requests for calculation.
- **Use static in case of failed requests:** Enable/Check in case you want to send static value instead of formula calculation when a number of latest requests have failed. if static is selected for fallback value and Percentile is enabled, the system will firstly check if it is possible to use the static CPM based on percentiles. If yes, than the value is obtained from there. If no, the system will use the fallback value OR nothing. In case of nothing usually the system sends 0.0 as floor.
- **Number of failed requests:** Specify number of latest failed requests. If this number is reached, static value will be used instead of formula calculation.
For detailed information on how Analytics Buckets work, refer to this [User Guide](https://tripledotstudios.atlassian.net/wiki/x/BIBUAQE).
# 3. Frequency Restrictions
To better control the user experience for the players, you can enable frequency restrictions for interstitials with **conditions**. Conditions are included inside sections, which allow you to nest sets of restrictions and combine them to target players more accurately. The conditions in Frequency Restrictions use the basic AND/OR operators. There are two configuration type options available:
- Config Based on Network
- Standard Config
For each of the above config types, there are 2 options:
- _ **Time-based** _ **: minimum time allowed between interstitials:** The ad will be shown only if the required minimum time has passed since the latest successful impression
- _ **Custom** _ **: Min count allowed between interstitials:** The ad will be shown only if the required number of particular points in the game is passed since the latest successful impression.
 
1. Enable the **Frequency Restrictions** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table below.
3. If required, you can set up overrides for specific ad placements by selecting Overrides.
Then, click the particular placement and select the required settings.
| **Time-Based Frequency Restrictions** |
| **Field Name** | **Description** | **Comments** |
Interstitials Configuration
Chunk #2
 
1. Enable the **Frequency Restrictions** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table below.
3. If required, you can set up overrides for specific ad placements by selecting Overrides.
Then, click the particular placement and select the required settings.
| **Time-Based Frequency Restrictions** |
| **Field Name** | **Description** | **Comments** |
| **Time-based: minimum time allowed between interstitials** | The ad will be shown only if the required minimum time has passed since the latest successful impression | Time in seconds |
| **Add to "Min time allowed per impression" for every successful impression ** | Click to enable the ability to increase the minimum time allowed between interstitials for the player for every successful impression | Disabled by default |
| **Per impression** | Adjusts the minimum time per impression | Time in seconds |
| **Use Multiplier per impression** | Enables the use of a multiplier instead of fixed number in seconds | Type: Boolean Default: False. Disabled if **Add to "Min time allowed per impression" for every successful impression** = false |
| **Multiplier** | Value in float the time per impression is incremented by. | Type: Float Default: Empty. Disabled if **Use Multiplier per impression** = false |
| **Min value** | Adjusts the minimum time between impressions | Time in seconds |
| **Max value** | Adjusts the maximum time between impressions | Time in seconds |
| **Reset after Rewarded Video** | After every rewarded video, time between interstitials will be tracked from zero | |
| **Reset after Interstitial** | After every interstitial, time between interstitials will be tracked from zero | Enabled by default. **Reset after Interstitial** is ignored by clients with platform version older than 5.4.1 |
| **Timer Counts on App Minimisation** | This checkbox determines whether to count the time when the app is live but minimised to track time between interstitials | Disabled by default |
| **Custom Frequency Restrictions** |
| **Field Name** | **Description** | **Comments** |
| **Key** | Identification key. You can add a new key or reuse any key that already exists in Ad Config | |
| **Min count allowed between Interstitials** | The ad will be shown only if required number of particular points in game is passed since the latest successful impression | |
| **Reset after rewarded video** | After every rewarded video, time between interstitials will be tracked from zero | |
| **Reset after Interstitial** | After every interstitial, time between interstitials will be tracked from zero | Enabled by default. **Reset after Interstitial** is ignored by clients with platform version older than 5.4.1 |
| **Both Time-Based and Custom Frequency Restrictions (Only for Config Based on Network Type)** |
| **Field Name** | **Description** | **Comments** |
| **Networks** | Select between different available networks | Dropdown with a list of available networks |
| **Min time allowed between interstitials** | Minimum time to be lapsed between interstitials for the selected network | Type: Float Specify the time in seconds |
Interstitials Configuration
Chunk #3
3.1. Frequency Restrictions: Overrides
**What Are Overrides?**
Overrides allow you to define placement-specific interstitial ad frequency settings that override the global or default frequency restriction rules. This is especially useful when you want to fine-tune the ad experience per ad placement.
Each override allows you to define conditions like time-based restrictions specific to that network or placement.
**How Overrides Work**
- When overrides are enabled, they take precedence over the default config.
- You can add multiple override blocks.
- Each override can have its own logic tree with AND/OR conditions.
**When to Use Overrides**
- You want to allow more frequent ads in a low-impact placement (like between levels) but restrict them during gameplay.
- A specific network requires custom frequency rules.
- You are A/B testing ad frequency strategies for different parts of the game.
# 4. Back-to-Back Frequency Restrictions
The “Back-to-back frequency restriction” setting allows the configuration of how frequently back-to-back interstitial ads are shown.
By using a global setting and optional overrides for specific placements, this feature gives flexibility in managing ad frequency.
| **Back-to-back frequency restriction** |
| **Field Name** | **Description** | **Comments** |
| **Show Back-to-back interstitial after** | Provide number of interstitials after which Back-to-back interstitial should be shown. | If the value is set to "0," a back-to-back interstitial will be displayed after every instance. If the value is set to "1," a back-to-back interstitial will be displayed every second instance. |
1. First, navigate to **Ad Config \> Interstitials** , and enable the setting.
2. In the “Show Back-to-back Interstitial After" text box, enter an integer value.
3. If required, you can set up overrides for specific ad placements by selecting Overrides.
4. Then, click the particular placement and select the required settings.
# 5. Restrictions for Newcomers
The "Restrictions for Newcomers" setting allows you to manage how ads are shown to new users in their early sessions.
| **Restrictions for Newcomers** |
| **Field Name** | **Description** | **Comments** |
| **Enabled** | Enables the restrictions for newcomers | |
| **Relevant** | This dropdown offers 2 options: - For first session only (interstitial will appear on the first session of the game) - Through all the sessions (interstitial will appear in all sessions) | |
| **Block ** | This dropdown allows you to choose 2 options to block the interstitials: - Interstitials for first N seconds - First N interstitials | The seconds are determined in the field **Seconds** below. |
| **Seconds** | Numeric field to determine the seconds or the number of interstitials blocked for the player | |
| **Timer Counts on App Minimisation** | This field determines whether to count the time when the app is live but minimised to track time between interstitials | |
1. Enable the **Restrictions for Newcomers** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table above.
3. If required, you can set up overrides for specific ad placements by selecting Overrides.
Then, click the particular placement and select the required settings.
# 6. Pause Duration to Resume Ads
This setting allows Game Server to send a setting that defines a **"Pause duration to resume ad"**.
The goal is to specify a time gap during which an ad will be shown to a user when they minimise the game and later return to it.
Here’s how it works:
1. User Minimises the Game: When a player minimises the game (e.g., switches to another app or moves to the home screen), the timer starts tracking how long the game is minimised.
2. User Returns to the Game: When the player reopens the game after minimising it, the platform manages the timing and handles the ad display based on the settings provided by the Game Server.
3. Ad Display Based on Time Gap: If the user returns to the game within a predefined time gap (e.g., between 1 and 5 minutes), an ad will be triggered and displayed.
This time gap is configurable:
| **Pause duration to resume ad(Interstitials Setting)** |
| **Field Name** | **Description** | **Comments** |
| **Min** | Specify the minimum part of the range for the pause duration to resume ad. **Example: Pause Duration: 1-5 minutes.** Minimum part of the pause duration is 1 in this example. | - Type = Float - Empty by default |
| **Max** | Specify the maximum part of the range for the pause duration to resume ad. **Example:** **Pause Duration: 1-5 minutes.** Maximum part of the pause duration is 5 in this example. | - Type = Float - Empty by default |
1. Enable the **Pause duration to resume ad** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table above.
# 7. Placement Bank
The **Placement Bank** is a collection that stores a list of rewarded video placements. It allows you to manage and organise multiple rewarded video ad placements in one centralised location.
| **Field Name** | **Description** | **Comments** |
| **Placement Bank** | Bank with the list of rewarded video placements. | Type: Dropdown with placement banks as options. |
1. Navigate to **Ads \> Configuration \> Rewarded Videos** , and enable the **Placement Bank** field by clicking on the  **[green + sign].**
2. Click the empty text box or the down arrow on the right to open the dropdown menu.
3. Choose the appropriate placement bank for your configuration.
4. If the desired placement bank is not listed, you can add a new one by following the instructions listed in the [Interstitial Placements & Interstitial Placement Banks](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3705274372#Interstitial-Placements-%26-Interstitial-Placement-Banks) section below.
* * *
# **8. Interstitials Request Throttling**
The **Interstitials Request Throttling** setting defines the maximum number of memory to be allocated for loading the videos.
| **Field Name** | **Description** | **Comments** |
| **Interstitials Request Throttling** | Maximum memory in MBs to be allocated for loading the videos | - Type: Integer |
1. Enable the **Interstitials Request Throttling** setting by clicking on the  **[green + sign].**
2. In the field, specify the memory value.
# **9. Ad Slots Bank**
The **Ad Slots Bank** setting defines the Ad slots bank to be sent to the client.
| **Field Name** | **Description** | **Comments** |
| **Ad Slots Bank** | Select from the list of predefined Ad Slots banks. | - Type: Dropdown with the pre-configured options. |
1. Enable **Ad Slots Bank** by clicking on the  **[green + sign].**
2. From the dropdown, select the relevant option. For steps to configure the Ad Slots refer to this [User Guide](/wiki/spaces/KB/pages/3996647517/Ad+Slots+Configuration#Configuring-Ad-Slots).
# **10. Interstitials TDS Ads**
This setting allows to advertise TDS games in cases when we don't have ad from mediation platforms.
| **Field Name** | **Description** | **Comments** |
| **Interstitial TDS Ads config** | Select from the list of predefined TDS Ads. Refer to this [User Guide](/wiki/spaces/KB/pages/4307189763/TDS+Ads+and+TDS+Ad+Banks) to Configure TDS Ads. | - Type: Dropdown with the pre-configured options. - Default: None (not an option to pass validation) - Mandatory |
| **Number of seconds before “X” button appears** | Time period in seconds before the close button appears for the player to close the ad. | - Type: Integer - Default: empty - Mandatory - Min: 1 |
| **Maximum number of TDS ads per session** | Maximum number of ads the player will receive per session | - Type: Integer - Default: empty - Mandatory - Min: 0 |
# 11. Newcomers CPM floor restriction
Configure impression suppression by setting a decreasing minimum CPM floor for new users based on the number of Ad\_Checks, applied across all placements for the first N checks.
| **Field Name** | **Description** | **Comments** |