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.
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.
