Configuring Ads in Game Server
Chunk #0
* * *
### Introduction
In this article, you’ll learn how to configure advertisements inside Game Server. Ads are A/B testable and can be configured following the logic used in Game Settings.
**Table of Contents**
* * *
## Ads Configuration
In Ads Configurations, you’ll find the basic settings required to serve ads into the game, and they are used to distribute the settings to players using rules and overrides.
Configurations work very much alike [Game Settings](/wiki/spaces/KB/pages/2580021328/Game+Settings+Configuration), and in the main page you’ll find 3 main areas:
- Base Config
- New (to create overrides)
- A list of overrides, with their priority, status, labels, availability and rules applied
**What does** _ **Override Used** _ **mean?**
_Override Used_ is a counter displays the number of times data from an override has been sent to a user within a 24-hour period, resetting at midnight UTC for accurate tracking every day.
## Ads Base Config
Base Config is the main configuration that includes all basic ads settings that are common for all users. Base Config is always Live, does not have rules, and has a priority of zero by default. Within the Base Config, you'll find the core game settings for each application, organized under various tabs. The number displayed next to each tab title indicates how many settings re enabled in that category.
While the Base Config is fully editable, if you need to apply specific values for a targeted group of users, you'll need to create an Override to customise the settings for that audience.
### **Accessing & Editing Ads Base Config**
To access Ads Base Config, navigate to Ads \> Configuration, and click **[Base Config]**.
 
Amazon Ads settings previously located under Game Settings are now available in **Ads Config** section (within the "General" tab). This ensures all ad package settings are maintained in one place for easier access and management.
**Migration Details**
- **Base Config Migration:**
All listed below Amazon settings have been migrated to Ads Config Base config.
- **Override Migration (Triple Tile only)**:
Settings from the Game Settings override in Triple Tile have been transferred to the Ads Config override in the same app.
These settings are marked as enabled in the Ads Config override to preserve the same behaviour.
You will now find the following Amazon Ads settings under:
**Ads Config → General Tab**
| **Platform** | **Setting Key** |
| --- | --- |
| iOS | `ads_amazon_ios_sdk_key` |
| iOS | `ads_amazon_ios_interstitial_id` |
| iOS | `ads_amazon_ios_banner_id` |
| iOS | `ads_amazon_ios_leaderboard_id` |
| Android | `ads_amazon_android_sdk_key` |
| Android | `ads_amazon_android_interstitial_id` |
| Android | `ads_amazon_android_banner_id` |
| Android | `ads_amazon_android_leaderboard_id` |
* * *
## Creating an Override
In order to send specific settings to sets of users, you can create an override for Ads Configuration. Overrides allow you to customise the advertisement experience for certain sets of users determined by rules.
- Overrides will **only** be applied to a user if the user complies with a set of rules that you will set up to differentiate groups of users. However, if the 2 overrides apply to different settings, the user can receive both overrides depending on the rules defined in each of them.
- Read more about overrides [](/wiki/spaces/KB/pages/2580021328/Game+Settings+Configuration#What-are-Overrides?).
- You can duplicate an existing override using the blue duplicate button.
1. To create an Override, navigate to **Ads \> Configuration** and click the green **[New]** button.
2. Assign a name, status, priority and availability to your Override. You can also add a label that will help you to organise and manage Ad Configs in Game Server easily. Start At/End At fields are optional, and allow you to create overrides scheduled to go live. Click [here](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3682861062#About-Start-At%2FEnd-At) to read more.
3. Click the **[green + sign]** to enable the fields and edit the configurations for your override. The edited configurations will appear marked with a blue number next to each tab.
At least one field and one rule should be enabled in the override.
1. Add the relevant rules for your override. Rules are necessary to segment players and distribute the override to them, and target different sets of users depending on their attributes. Learn more about rules[in this guide](https://tripledotstudios.atlassian.net/l/cp/osgQ0TAC).
2. Once you’re done, click the blue **[Save]** on the upper right corner and your override will be complete.
#### About Start At/End At
Start At/End At are 2 **optional** fields allow you to create overrides that are scheduled to go live (ie. become active) in the future to avoid having to set the status of the override manually to Active. Please note, however, that when Game Server reaches the **End At** date, the system does **not** automatically revert the status of the override.
Below you can find a diagram that explains the logic for Start Date.
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** |
Interstitials Configuration
Chunk #4
| **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** |
| **Initial starting CPM floor value** | Set up initial CPM floor for newcomers | - Type: Float - Mandatory - Default: 1.0 - Min: more than 0 |
| **Change type** | Selecting static or multiplier change type | Dropdown with the list of the following values: - Static - Multiplier - Default: Static |
| **Reduction value** | Specify Static value or Multiplier for which CPM floor for newcomers should be reduced after each Ad\_Check | - Type: Float - Default: empty - Mandatory - If **Change type** = Static, these validations should be applied - If **Change type** = Multiplier, these validations should be applied |
| **Applies for first N Ad\_Checks** | Specify the number of Ad\_Checks for which Newcomers CPM floor restriction should work | - Type: Integer - Default: empty - Mandatory - Min: 1 |
# 12. Network Ranking multiplier
Set up a network-specific Ad Ranking multiplier (independent of mediation) using the new “Network ranking multiplier” grouped setting, allowing multiple configurable sections.
| **Field Name** | **Description** | **Comments** |
| **Networks** | Specify the list of networks for which you want to set Ranking multiplier | Multi-select dropdown with the list of networks. |
| **Ranking multiplier** | Provide Ranking multiplier which should be applied to selected networks | - Type: Float - Mandatory if the section is added - Default: empty - Min: 0.0 |
# 13. **Enable DT Postbid POC**
| **Field Name** | **Description** | **Comments** |
| **Enable DT Postbid POC** | Boolean flag to enable Digital Turbine Postbid POC | Default: False. Allows enabling for some users for testing purposes. |
# 14. Interstitial Placements & Interstitial Placement Banks
Placements allow you to identify all the keys used for unique interstitial ad placements in different game features.
Interstitial Placements are used in Interstitial Placement Banks, which are a collection of placements where you can assign a probability for the placement to appear.
In the home page of Interstitial Placements you can see which interstitials placements exist, along with their keys and if they’re being used in any bank currently.
