Ad Units IDs Configuration
Chunk #0
**Introduction**
The Ad Unit ID configuration system allows you to centrally manage all MAX Ad Unit IDs across your app by assigning them readable names and linking them to specific ad types and platforms. This ensures easier identification and more efficient setup of ads in your monetisation configuration.
* * *
## **New Ad Unit ID Configuration Section**
Access this section via the **Ads → Ad Unit IDs** menu.
### **List View and Available Filters**
### **Standard Fields for New/Edit View**
- Name
- Availability (Edit view only, inherited from Ads Config)
- Labels
- Notes
#### **Fields Descriptions**
| **Location** | **Name** | **Type** | **Validations** | **Hint** |
| --- | --- | --- | --- | --- |
| Ads → Ad Unit ID | Type | Dropdown (Banner, Interstitial, Rewarded Videos) | Default: Interstitial | Select type to configure ID for a specific area |
| Ads → Ad Unit ID | Platform | Dropdown (iOS, Android) | Default: iOS | - |
| Ads → Ad Unit ID | Mediation | Dropdown (MAX, Google, Meta) | Default: MAX | - |
| Ads → Ad Unit ID | Ad Unit ID | String | Mandatory, Unique | Specify ID to be used |
| Ads → Ad Unit ID | Max Analytics bucket | Integer | Mandatory for Interstitial or Rewarded video. Optional for Banners Type. | Defines which bucket should be used for CPM calculation. Default: None |
* * *
## Using Ad Unit IDs and Ad Slots in Ads Config
Once defined, Ad Unit IDs and Ad slots can be selected in ads configuration.
### **Banner ID Settings**
Configure MAX Banner IDs per platform:
- You must select an Ad Unit ID from the predefined list.
| **Location** | **Name** | **Type** | **Validations** | **Hint** |
| Ads → Ads Config → Tab Banners | MAX iOS Banner ID | Dropdown (Filtered Ad Unit IDs) | Mandatory if enabled | Specify Banner ID for iOS |
| Ads → Ads Config → Tab Banners | MAX Android Banner ID | Dropdown (Filtered Ad Unit IDs) | Mandatory if enabled | Specify Banner ID for Android |
### **Rewarded Video Ad Unit Settings**
| **Location** | **Name** | **Type** | **Validations** |
| Ads → Ads Config → Tab Rewarded Videos | MAX iOS Rewarded Videos ID | Dropdown (Filtered Ad Unit IDs) | Mandatory, Default: None |
| Ads → Ads Config → Tab Rewarded Videos | MAX Android Rewarded Videos ID | Dropdown (Filtered Ad Unit IDs) | Mandatory, Default: None |
### **Interstitial Ad Unit Settings**
| **Location** | **Name** | **Type** | **Validations** |
| Ads → Ads Config → Tab Interstitials | MAX iOS Interstitial ID | Dropdown (Filtered Ad Unit IDs) | Optional, Default: None |
| Ads → Ads Config → Tab Interstitials | MAX Android Interstitial ID | Dropdown (Filtered Ad Unit IDs) | Optional, Default: None |
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.
Configuring Ads in Game Server
Chunk #3
| **Minimum CPM value. Static Floor CPM** | Specify a static value for the Bidding Floor CPM. | - Type : Float - Default: Empty - If “Return static value“, field is selected “Static floor CPM“ is mandatory. |
| **Pause duration to resume ad(Interstitials Setting)** |
| **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 |
| **Network Ranking Multiplier** |
| **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 |
| **Newcomers CPM floor restriction** |
| **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 |
| **Ad Slots Bank** |
| **Ad Slots Bank** | Select from the list of predefined Ad Slots banks. | - Type: Dropdown with the pre-configured options. |
| **Interstitial TDS Ads** |
| **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 |
| **Interstitials Request Throttling** |
| **Interstitials Request Throttling** | Maximum memory in MBs to be allocated for loading the videos | - Type: Integer |
| **Enable DT Postbid POC** |
| **Enable DT Postbid POC** | Boolean flag to enable Digital Turbine Postbid POC | Default: False. Allows enabling for some users for testing purposes. |
| ### **Waterfall** Waterfall is the process used to get the best price for an impression of an advertisement |
| **Field Name** | **Description** | **Comments** |
| **Ad request refresh period** | This field determines how long the game waits before attempting to request another ad after a failed attempt | - Type: Integer - Default: 30 seconds |
| **Enable increment** | This checkbox enables or disables the incrementing of the refresh period in case ad requests fail. When checked, the refresh period will increase with each unsuccessful attempt. | - Type: Boolean - Default: Unchecked |
| **Increment refresh period with every unsuccessful attempt X** | Multiply the refresh rate in every consecutive attempt. This resets on a successful attempt | - Type: Integer - Default: 5 |
| **Until a max value** | Maximum value that the refresh period could reach | - Type: Integer - Default: 90 seconds |
| ### **Banners** _An advertisement that appears across the top or bottom of the game_ |
| **Field Name** | **Description** | **Comments** |
| **Enable banners in portrait** | Toggle to allow banners when the device is set on portrait mode | Type: Boolean This checkbox should be checked (enabled) if portrait banners are required in the app. |
| **Position of portrait banner on the app screen** | Position of the game screen of the banner ad in portrait mode | Type: Dropdown Default: bottom |
| **Enable banners in landscape** | Toggle to allow banners when the device is set on portrait mode | Type: Boolean This checkbox should be checked (enabled) if landscape banners are required in the app. |
| **Position of landscape banner on the app screen** | Position of the game screen of the banner ad in landscape mode | Type: Dropdown Default: bottom |
| **Bidding floor CPM for banners** | Specifies the minimum cost-per-thousand impressions (CPM) bid that is accepted for banner ad auctions. | - Type: Float - Default: Empty - Min: 0.01 - Max two characters after comma can be entered and sent |
| **Max iOS Banner ID** | Select the Banner ID config for iOS from the list. | Type: Dropdown Default: empty |
| **Max Android Banner ID** | Select the Banner ID config for Android from the list. | Type: Dropdown Default: empty |
| ### **AD Badges** |
| **Field Name** | **Description** | **Comments/Validations** |
| **AD Badges Bank** | A centralised repository where all available ad badges are stored and managed. | Type: Dropdown |
| ### **General** |
| **Field Name** | **Description** | **Comments/Validations** |
| **Ads Amazon iOS SDK key** | API key used by the iOS application to authenticate and integrate with Amazon Ads SDK | Type: String |
| **Ads Amazon Android SDK key** | API key used by the Amazon application to authenticate and integrate with Amazon Ads SDK | Type: String |
| **Max Selective Initialisation** | Boolean flag to disable selected ad networks for a defined period, managed via Ad Slot configuration. | Type: Boolean Default: False |
| **Ads Amazon iOS interstitial ID** | Unique placement ID used by the iOS app to request and display Amazon interstitial ads. | Type: String |
| **Ads Amazon Android interstitial ID** | Unique placement ID used by the Android app to request and display Amazon interstitial ads. | Type: String |
| **Ads Amazon iOS banner ID** | Unique placement ID used by the iOS app to request and display Amazon banner ads. | Type: String |
| **Ads Amazon iOS banner ID** | Unique placement ID used by the Android app to request and display Amazon banner ads. | Type: String |
| **Ads Amazon iOS leaderboard ID** | Unique placement ID used by the iOS app to request and display Amazon leaderboard ads. | Type: String |
| **Ads Amazon Android leaderboard ID** | Unique placement ID used by the Android app to request and display Amazon leaderboard ads. | Type: String |
| ### **Archived** |
| **Field Name** | **Description** | **Comments/Validations** |
| **MAX Interstitial ad units** | This setting allows you to manage and optimise interstitial ad units for the MAX ad platform. By configuring these units, you can control the delivery and behaviour of interstitial ads. | This setting is described in [detail here](/wiki/spaces/KB/pages/4304109569/Setting+up+Ad+Units#MAX-Interstitial-Ad-Units). |
| **Google Postbid IDs** | **Google Postbid Android ID:** Enter the **Postbid ID** specific to **Google Ads** for the Android platform. This ID helps configure and identify the Android app in Google's post bidding process. **Google Postbid iOS ID** : Enter the **Postbid ID** specific to **Google Ads** for the iOS platform. Like the Android ID, this iOS ID configures and identifies the iOS app in Google's post-bidding process. | Post bidding typically refers to bidding for an ad placement after an initial bid request. |
| **Postbid CPM Floor Multiplier ** |
| **Postbid CPM Floor Multiplier Type** | Select the type of CPM floor multiplier strategy. | Type: Dropdown with the following options: - **Static** : A single, fixed multiplier. - **Range** : A range of multipliers with steps. - **Waterfall** : Multiple multipliers applied in sequence. |
| **Min Postbid CPM Floor Multiplier** | Provide Minimum Postbid CPM floor Multiplier below which it can’t go down | Type: Float - Min: 0 - Max: 2 - Default: empty - Available and Mandatory only if **Postbid CPM floor Multiplier type** = Range or Static - **Max Postbid CPM Floor Multiplier** is available from tripledot-platform-ads 2.4.0 if If **Postbid CPM floor Multiplier type** = Range. |
| **CPM Multiplier Step in range** | Specify the step value between each multiplier in the range, incrementing from the minimum to the maximum. | Type: Float - Min: 0 - Max: 2 - Default: empty - Available and Mandatory only if **Postbid CPM floor Multiplier type** = Range |
| **Max Postbid CPM Floor Multiplier** | Define the upper limit of the CPM floor multiplier when the "Range" option is selected. | Type: Float - Min: 0 - Max: 2 - Default: empty - Available and Mandatory only if **Postbid CPM floor Multiplier type** = Range |
| **Initial value** | Set up initial CPM from which range will start working. | Type: Float - Optional - Default: empty - If the field is empty, Min Postbid CPM Floor Multiplier is used. - **Initial value** is available from tripledot-platform-ads 2.5 |
| **Levels. Type** | Select the type of levels for waterfall multiplier type. | Type: Dropdown with the list of following options: - Fixed - Multiplier - Default: Fixed |
| **Levels. Postbid CPM Floor** | Specify the Postbid CPM Floor Value based on the selected level type. | - Type = Float - Empty by default - Mandatory if Level is added - Min: 0.0 |