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 |
Banner Ads Configuration
Chunk #0
**Introduction**
A Banner is an advertisement that appears across the top or bottom of the game.
The **Banners** section provides a set of configurations to manage the display and performance of banner ads within the app. These settings allow you to control the visibility of banners in both portrait and landscape modes, define their positioning on the screen, and set minimum bidding floors for ad auctions.
**Table of Contents**
## Banner Ads Settings
The Banner Ads Settings lets you configure settings for managing banner ads, including enabling and positioning banners in both portrait and landscape modes.
### Portrait Banners
These settings allow you to control the appearance and position of banner ads when the app is viewed in portrait orientation.
1. Navigate to **Ads \> Configuration \> Banners** , and enable the **Portrait Banners** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table below.
### Landscape Banners
These settings let you configure banner ads for when the app is used in landscape orientation.
1. Navigate to **Ads \> Configuration \> Banners** , and enable the **Landscape Banners** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table below.
### Bidding floor CPM for banners
This option lets you set a minimum cost-per-thousand (CPM) bid floor for banner ads, ensuring that only ads meeting this threshold will be displayed.
1. Navigate to **Ads \> Configuration \> Banners** , and enable the **Bidding floor CPM for banners** setting by clicking on the  **[green + sign]**.
2. Fill in the field following the information listed in the table below.
| **Banners** |
| **Field Name** | **Description** | **Comments/Validations** |
| **Enable banners in portrait** | Toggle to allow banners when the device is set to 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 |
TDS Ads and TDS Ad Banks
Chunk #0
# **Introduction**
TDS Ads are used to promote Tripledot Studios games as fallback ads when no fill is received from mediation platforms. This ensures continuous ad delivery and maximises ad opportunities, even when external demand is unavailable.
To support this functionality, TDS Ads configuration section has been added to the Game Server UI.
With this feature, you can:
- Configure and manage TDS Ads used as backup creatives.
- Define CDN links for video assets and destination URLs.
- Apply labels, availability states, and usage metadata for organisation and tracking.
TDS Ads Bank allows configuring a prioritised list of TDS Ads along with serving probabilities. This helps ensure consistent ad experiences for users even in the absence of external ads.
* * *
# TDS Ads Configuration
## **Navigation**
- Go to **Ads** in the left sidebar.
- Click on **TDS Ads** to access the list view and manage TDS Ads configurations.
* * *
## **List View Overview**
When you open TDS Ads, the list view displays all existing configurations with the following columns:
| **Column Name** | **Description** |
| --- | --- |
| **ID** | Unique identifier for the TDS Ad configuration. |
| **Name** | Unique name of the TDS Ad config. |
| **Creative ID URL** | Link to the ad creative. |
| **Labels** | Optional labels/tags for categorisation. |
| **Availability** | Inherited from the associated TDS Ads Bank config. |
| **In Use** | Inherited from the associated TDS Ads Bank config. |
| **Updated at (UTC)** | Last modified timestamp. |
| **Actions** | Options to **Edit** or **Delete** the configuration. |
* * *
## **Filters Available**
You can filter the list view using the following criteria:
- **ID**
- **Name**
- **Labels**
- **Availability state** (inherited from “TDS Ads Bank”)
- **Created after** (date picker)
- **Updated after** (date picker)
- **Created by me** (personalised view)
* * *
## **Creating a New TDS Ad Configuration**
- Click **[+New]** to configure a new TDS Ad.
A new form to configure a new TDS Ad appears. Here’s how each field works:
| **Field** | **Type** | **Required** | **Description** |
| --- | --- | --- | --- |
| **Name** | Text | Yes | Unique identifier for the TDS Ad. Used for referencing and filtering. |
| **Labels** | Dropdown (multi-select) | Optional | Used for categorising or grouping ads (e.g., by campaign, platform, etc.). |
| **Creative ID URL** | Text | Yes | URL pointing to the creative (video/image) to be served. |
| **Redirect URL/onelink URL** | Text | Yes | Destination URL users are sent to after interaction (click-through). This is often a OneLink (for mobile attribution). |
* * *
## **Saving the Configuration**
- Click **Save** to create the TDS Ad config.
- Click **Cancel** to return to the list view without saving.
Once saved, the config will appear in the TDS Ads list, with all relevant metadata.
* * *
## **Editing an Existing Configuration**
- From the list view, click **Edit** from the Actions menu of an existing config to open the configuration form.
- Update the relevant fields and save the new configuration.
* * *
# TDS Ads Bank Configuration
## **Navigation**
- Go to **Ads** in the left sidebar.
- Click **TDS Ads bank** to access the list view and manage TDS Ads bank configurations.
* * *
## **List View Overview**
When you open TDS Ads bank, the list view displays all existing configurations with the following columns:
| **Column Name** | **Description** |
| --- | --- |
| **ID** | Unique identifier for the TDS Ads Bank configuration. |
| **Name** | Unique name of the TDS Ads Bank config. |
| **Labels** | Optional labels/tags for categorisation. |
| **Availability** | Inherited from Ads Config. |
| **In Use** | Inherited from Ads Config. |
| **Updated at (UTC)** | Last modified timestamp. |
| **Actions** | Options to **Edit, Duplicate,** or **Delete** the configuration. |
* * *
## **Filters Available**
You can filter the list view using the following criteria:
- **ID**
- **Name**
- **Labels**
- **Availability state** (inherited from Ads Config)
- **Created after** (date picker)
- **Updated after** (date picker)
- **Created by me** (personalised view)
* * *
## **Creating a New TDS Ads Bank Configuration**
- Click **[+New]** to configure a new TDS Ads Bank.
A new form to configure a new TDS Ads Bank appears. Here’s how each field works:
| **Field** | **Type** | **Required** | **Description** |
| --- | --- | --- | --- |
| **Name** | Text | Yes | Unique identifier for the TDS Ads Bank. Used for referencing and filtering. |
| **Labels** | Dropdown (multi-select) | Optional | Used for categorising or grouping ads banks. |
| **Show in order based on probability** | Boolean | Yes | If true, TDS Ads will be served probabilistically by defined values. If false, probability column is disabled and ignored. |
| **Redirect URL/onelink URL** | Text | Yes | Destination URL users are sent to after interaction (click-through). This is often a OneLink (for mobile attribution). |
| **Add TDS Ad** | A dropdown list of available TDS Ads configs. | Yes. At least one TDS Ad must be added. | - Nothing is pre-selected by default. - Each TDS Ad config can only be added once. - Order matters – the ads will be sent in the same order they appear in the UI. |
| **TDS Ads.Order** | Auto-configured | N/A | Determines sequence of ads served (drag to reorder) |
| **TDS Ads.Name** | Dropdown list | Yes | Name of the TDS Ad config with **Creative ID URL** in brackets |
| **TDS Ads.Probability** | Float | Required only if "Show in order based on probability" is enabled | Order based on highest probability |
| **TDS Ads.Delete** | Action button | Optional | Delete the TDS Ad from the list |
* * *
## **Saving the Configuration**
- Click **Save** to create the TDS Ads Bank config.
- Click **Cancel** to return to the list view without saving.
Once saved, the config will appear in the TDS Ads Bank list, with all relevant metadata.
* * *
## **Editing an Existing Configuration**
- From the list view, click **Edit** from the Actions menu of an existing config to open the configuration form.
- Update the relevant fields and save the new configuration.
- From the list view, you can duplicate or delete an existing Ads bank if required.
