Interstitials Configuration
Chunk #0
**Introduction**
An interstitial ad is a full-screen ad that covers the entire interface of the game. To better control the player experience, Game Server offers different configuration settings.
**Table of Contents**
* * *
# 1. Enabling Interstitial Overrides
Inside Interstitials, you can enable overrides separately for particular placements.
Placement overrides are available for the following settings:
- Restrictions for Newcomers.
- Frequency Restrictions
- Back-to-back frequency restriction
- Impression Restrictions
When selecting an interstitial to add to your override, you’ll be presented with all the placements available. This list does not depend on the placement bank selected for the interstitial (if any).
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** |