Configuring Ads in Game Server

KB
Version 126
Updated 3 months ago
5 chunks
View in Confluence

Content


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

image-20241030-132500.png

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 .

  • 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 to read more.

  3. Click the [green + sign](blue star) 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 rulesin this guide.

  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.

Adding User Groups

In managing ad configurations, ensuring targeted and optimised ad experiences across diverse user segments is essential. Previously, to cater to these unique needs, the monetisation and product teams had to create multiple overrides for each setting, making it difficult to manage and review configurations across various segments.

To streamline this process, a new feature called User Groups has been introduced.
User Groups allow you to define multiple configurations for a single setting in one centralised location, with flexibility to assign different values for each user segment.
In this section, you’ll learn how to create, edit, and manage User Groups within the Base Ads Configuration settings. You will also understand how priorities are defined between user groups, overrides, and experiments.
This feature gives you the ability to add rules for each group, assign priority levels, and control the exact ad experience tailored to various user segments, all from a single interface.

Understanding User Groups in Configuration Priority

In the configuration hierarchy, User Groups serve as an intermediate layer, positioned between Overrides and Base Configurations.
Here’s how they function and their role in the priority system:

Priority Order

  • Overrides : Highest priority. Overrides take precedence over all other settings, ensuring that specific configurations are applied when explicitly defined.

  • User Groups : Second priority. User Groups provide a flexible layer that allows configurations to be tailored for specific subsets of users.

  • Base Configurations : Lowest priority. Base Configurations act as the default settings, applying when neither Overrides nor User Groups are applicable.

The User Groups will only apply if no Overrides or higher-priority settings (like experiments) are present.

How User Groups Apply

  1. When a user matches a set of defined rules and there are no Overrides or Experiments that take precedence, the system checks which User Group the user belongs to.

  2. The settings from this User Group will then be applied, based on the specific configuration associated with that group.

Resolving Conflicts When a User Belongs to Multiple Groups

  • If a user qualifies for multiple User Groups (i.e., matches the rules of more than one group), the system will select the setting from the group with the highest priority.

  • Priorities are set as numeric values, with higher numbers indicating higher priority (e.g., a group with priority 100 will override a group with priority 50).

User Groups and Availability

User Groups impact _ Live/Test Availability _: User Groups configurations are applied to settings that are both live and test, meaning they affect both the active and inactive configurations.

To configure a user group:

  1. Navigate to Base Ads Configuration
  • Go to the Edit Base Ads Configuration.

image-20241030-155555.png 1. Access User Groups for a Setting

  • In each ad setting tab, there will be a User Groups button next to each setting, displaying the number of user groups created.

  • Click the User Groups button for the desired setting (e.g., "Placement Bank" for Rewarded Videos) to open the User Group configuration page for that specific setting.

  1. Edit User Groups Page Overview
    A list of user groups is displayed, each with its assigned priority.
  • You will also see a list of user groups created for this setting, each with specific priority.
    In the Edit User Groups page, configurations are prioritised from highest to lowest.

  • This means that a configuration with priority 10 is ranked higher than one with priority 1.

  • With higher-priority groups (those with larger numbers) taking precedence over lower-priority groups.
    This structure ensures that configurations are enforced according to their designated importance, impacting the LIVE availability and usage displayed for each group.

  1. Adding User Groups
  • Click on the Add User Group button to create a new group.

  • Assign a unique Name for the new user group. Each user group is sorted by priority, with the highest priority at the top.

  • Add details like Status (Active/Inactive), Labels , Notes , and any configuration for settings in the group. (These are optional)

  1. Setting Rules for User Groups
  • Define at least one rule for each user group.

  • Add more rules by clicking on Add Rule , or organise rules with AND/OR conditions for more complex configurations.

  1. User Group Management Options. You can duplicate, delete, reorder and expand/collapse the user groups.

image-20241030-162205.png 1. Saving Changes

  • After configuring or modifying user groups, click Save to apply the changes. This will return you to the Base Ads Configuration page.

  • If you click Cancel , you will be redirected back to the Base Ads Configuration page without saving changes.
    Activity Log

  • Use the Activity Log button at the top of the Edit User Groups page to view the history of changes for the selected ad configuration and user groups.

  1. Viewing ‘In Use’ Configurations
    To make navigation easier, there is a “Jump to Configuration” link.
    This allows you to quickly view the associated configurations for a User Group.

image-20241105-111753.png

  • When archiving a setting, ensure that it is not used in any user group. The system will validate this automatically to prevent errors.

User Groups in Audience Groups

User Groups allow configurations to be tailored for specific segments within Audience Groups.

Perform the following steps for creating user groups in audience groups:

  1. Click Audience Groups.

Accessing User Groups for a new Audience Group

When configuring a new Audience Group for the first time in Ads Configuration , user groups cannot be set up immediately. Upon enabling a setting, the User Groups button appears next to it but remains inactive. Hovering over the button displays a tooltip: "User groups will be available after the audience group is saved." To proceed with configuring user groups, the Audience Group must first be saved. This ensures that all configurations are properly initialised before assigning user groups.

Accessing User Groups for an Existing Audience Group

When an audience group has already been configured as an Ads Config audience group, managing user groups becomes accessible within the settings. Upon opening the audience group, users will see a User Groups button next to each previously enabled setting, allowing for further configuration. If a new setting is enabled, the User Groups button remains disabled until the audience group is successfully saved with the updated setting.

Perform the following steps to configure a user group:

  1. Click Edit to configure the Audience Group.

  2. Enable the relevant setting. For each enabled setting , a "User Groups" button appears

  3. If the setting was enabled previously, the user groups button is active and can be configured.

  4. If the setting was just enabled , the button is inactive until saved. Once an Audience Group is saved , User Groups can be configured.

  5. Configure the setting and save the Audience group. The User Groups button is now enabled.

Adding a New User Group

  1. Click [+Add User Group].

  2. Enter User Group Details: Name, Status, Availability, and optional details like Labels and Notes.

  3. Define Rules for the User Group.

image-20250312-165841.png

Managing User Groups.

You can reorder, duplicate and delete the user groups.

image-20250312-170024.png


Validation & Restrictions

Cannot disable a setting if User Groups exist. Can disable a setting only if no User Groups are present


Settings List

In the table below, you’ll find all settings available in Base Ad Config and their descriptions. Click on the expand to open the list.

 Fields in Ads Config

Find here detailed information on the types of ads and its requirements.

| ### Rewarded Videos Rewarded videos are a type of incentivised advertising that rewards players for watching a promotional video. |

| Field Name | Description | Comments |

| Placement Bank | Bank with the list of rewarded video placements.  | Type: Dropdown with placement banks as options. |

| Overall Rewarded Video Limit | The total limit of rewarded videos a player can watch. | - Type: Integer |

| Overall Rewarded Video Limit Reset Time | The number of hours (after midnight device time) to reset this limit.  | - Type: Integer |

| Bidding floor CPM for rewarded videos | Floor value to be sent to MAX for rewarded video bidding. | - Type: Float - Bidding floor CPM for rewarded videos is available from tripledot-platform-ads 1.3.0 |

| Consecutive Google Ads Limit | A counter for the number of consecutive Google ads shown, so that you can control when we stop sending requests to the Google Direct auction and show the MAX ad currently in the cache. | - Type: Integer - Consecutive Google Ads Limit is available from tripledot-platform-ads 2.5 |

| Enable interstitial instead of rewarded video | If the toggle is ON, rewarded video can be replaced with interstitials in case there is no cashed rewarded videos or the price for interstitial is higher than rewarded video. | - Type: Integer |

| MAX Rewarded Videos Ad Units | This setting allows you to manage and optimise rewarded videos ad units for the MAX ad platform. By configuring these units, you can control the delivery and behaviour of rewarded videos. | This setting is described in detail here. |

| Ad Slots Bank | Select from the list of predefined Ad Slots banks. | - Type: Dropdown with the pre-configured options. |

| Rewarded Videos Request Throttling | Maximum memory in MBs to be allocated for loading the videos | - Type: Integer |

| ### Settings Available in both Rewarded Videos and Interstitial Tabs |

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

| Google Postbid IDs and Google Postbid Requests Limit Counter |

| 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. | Post bidding typically refers to bidding for an ad placement after an initial bid request. |

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

| Google Postbid Requests Limit Counter | The Google Postbid Requests Limit Counter field sets a maximum number of requests that can be sent to Google Postbid before an ad is shown. | This number resets once a MAX ad is displayed. Google Postbid Requests Limit counter Google Postbid Requests Limit Counter is available from tripledot-platform-ads 2.5.0 |

| ### Interstitials An interstitial ad is a full-screen ad that covers the entire interface of the game. |

| Field Name | Description | Comments |

| Placement Bank | Bank with the list of interstitials placements  | |

| Restrictions for Newcomers (Interstitials Setting) |

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

| Frequency Restrictions (Interstitials Setting) |

| Config Type | - Config Based on Network - Standard Config | |

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

| 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 (Interstitials Setting) |

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

| Back-to-back frequency restriction (Interstitials Setting) |

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

| Impression Restriction (Interstitials Setting) |

| Minimum CPM value. Min CPM Type | Minimum CPM value that an interstitial ad should have in order to be shown. There are 2 options: - Static , where you determine a set value in dollars - Formula , where a formula based on the past 50 collected events calculates the bidding floor. | - Default: Static - If Static is selected, Game Server will display only the field “Static floor CPM“ - If Formula is selected, an additional list of parameters for formula is displayed in sub-group called “ Formula parameters “. The settings are the same that are used in Setting the CPM Floor. |

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

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

| Google Postbid Requests Limit Counter | The Google Postbid Requests Limit Counter field sets the maximum number of requests that can be sent to Google Postbid before an ad is shown. | This number resets once a MAX ad is displayed. Google Postbid Requests Limit counter Google Postbid Requests Limit Counter is available from tripledot-platform-ads 2.5.0 |


Chunks 5

1
* * * ### Introduction In this article, you’ll learn how to configure advertisements inside Gam...
Vectorized

* * *

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

![](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20230726-115556.png?version=3&modificationDate=1729856158611&cacheVersion=1&api=v2&width=476&height=182)

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

![](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20230222-105843.png?version=3&modificationDate=1729856160327&cacheVersion=1&api=v2&width=442&height=217) ![image-20241030-132500.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20241030-132500.png?version=1&modificationDate=1730294704911&cacheVersion=1&api=v2&width=777&height=463)

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]**![(blue star)](/wiki/s/1531367987/6452/1cc5da61c751f60a4fe1a8d36b307dac58e244ea/_/images/icons/emoticons/star_blue.png) 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.

![](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/65d487d3-218e-44b0-809c-a3082d3335da.png?version=3&modificationDate=1729856166154&cacheVersion=1&api=v2&width=844&height=514)

Vector dimensions: 1536
2
Adding User Groups In managing ad configurations, ensuring targeted and optimised ad experiences...
Vectorized

Adding User Groups

In managing ad configurations, ensuring targeted and optimised ad experiences across diverse user segments is essential. Previously, to cater to these unique needs, the monetisation and product teams had to create multiple overrides for each setting, making it difficult to manage and review configurations across various segments.

To streamline this process, a new feature called **User Groups** has been introduced.
User Groups allow you to define multiple configurations for a single setting in one centralised location, with flexibility to assign different values for each user segment.
In this section, you’ll learn how to create, edit, and manage User Groups within the **Base Ads Configuration** settings. You will also understand how priorities are defined between user groups, overrides, and experiments.
This feature gives you the ability to add rules for each group, assign priority levels, and control the exact ad experience tailored to various user segments, all from a single interface.

### **Understanding User Groups in Configuration Priority**

In the configuration hierarchy, **User Groups** serve as an intermediate layer, positioned between **Overrides** and **Base Configurations**.
Here’s how they function and their role in the priority system:

**Priority Order**

- **Overrides** : Highest priority. Overrides take precedence over all other settings, ensuring that specific configurations are applied when explicitly defined.

- **User Groups** : Second priority. User Groups provide a flexible layer that allows configurations to be tailored for specific subsets of users.

- **Base Configurations** : Lowest priority. Base Configurations act as the default settings, applying when neither Overrides nor User Groups are applicable.

The **User Groups** will only apply if no Overrides or higher-priority settings (like experiments) are present.

**How User Groups Apply**

1. When a user matches a set of defined rules and there are **no Overrides or Experiments** that take precedence, the system checks which User Group the user belongs to.

2. The settings from this User Group will then be applied, based on the specific configuration associated with that group.

**Resolving Conflicts When a User Belongs to Multiple Groups**

- If a user qualifies for multiple User Groups (i.e., matches the rules of more than one group), the system will select the setting from the **group with the highest priority**.

- Priorities are set as numeric values, with **higher numbers indicating higher priority** (e.g., a group with priority 100 will override a group with priority 50).

**User Groups and Availability**

**User Groups impact** _ **Live/Test Availability** _: User Groups configurations are applied to settings that are both live and test, meaning they affect both the active and inactive configurations.

To configure a user group:

1. Navigate to Base Ads Configuration

- Go to the **Edit Base Ads Configuration**.

![image-20241030-155555.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20241030-155555.png?version=1&modificationDate=1730303759555&cacheVersion=1&api=v2&width=777&height=328)
1. Access User Groups for a Setting

- In each ad setting tab, there will be a **User Groups** button next to each setting, displaying the number of user groups created.

- Click the **User Groups** button for the desired setting (e.g., "Placement Bank" for Rewarded Videos) to open the User Group configuration page for that specific setting.

1. Edit User Groups Page Overview
A list of user groups is displayed, each with its assigned priority.

- You will also see a list of user groups created for this setting, each with specific priority.
In the _Edit User Groups_ page, configurations are prioritised from **highest to lowest**.

- This means that a configuration with **priority 10** is ranked higher than one with **priority 1**.

- With higher-priority groups (those with larger numbers) taking precedence over lower-priority groups.
This structure ensures that configurations are enforced according to their designated importance, impacting the _LIVE_ availability and usage displayed for each group.

1. Adding User Groups

- Click on the **Add User Group** button to create a new group.

- Assign a unique **Name** for the new user group. Each user group is sorted by priority, with the highest priority at the top.

- Add details like **Status** (Active/Inactive), **Labels** , **Notes** , and any configuration for settings in the group. (These are optional)

1. Setting Rules for User Groups

- Define at least one rule for each user group.

- Add more rules by clicking on **Add Rule** , or organise rules with **AND/OR** conditions for more complex configurations.

1. User Group Management Options. You can duplicate, delete, reorder and expand/collapse the user groups.

![image-20241030-162205.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20241030-162205.png?version=1&modificationDate=1730305329456&cacheVersion=1&api=v2&width=777&height=381)
1. Saving Changes

- After configuring or modifying user groups, click **Save** to apply the changes. This will return you to the **Base Ads Configuration** page.

- If you click **Cancel** , you will be redirected back to the **Base Ads Configuration** page without saving changes.
Activity Log

- Use the **Activity Log** button at the top of the **Edit User Groups** page to view the history of changes for the selected ad configuration and user groups.

1. Viewing ‘In Use’ Configurations
To make navigation easier, there is a “Jump to Configuration” link.
This allows you to quickly view the associated configurations for a User Group.

![image-20241105-111753.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20241105-111753.png?version=1&modificationDate=1730805477472&cacheVersion=1&api=v2&width=777&height=497)

- When archiving a setting, ensure that it is not used in any user group. The system will validate this automatically to prevent errors.

## **User Groups in Audience Groups**

User Groups allow configurations to be tailored for specific segments within Audience Groups.

Perform the following steps for creating user groups in audience groups:

1. Click **Audience Groups**.

### **Accessing User Groups for a new Audience Group**

When configuring a new **Audience Group** for the first time in **Ads Configuration** , user groups cannot be set up immediately. Upon enabling a setting, the **User Groups** button appears next to it but remains inactive. Hovering over the button displays a tooltip: _"User groups will be available after the audience group is saved."_ To proceed with configuring user groups, the **Audience Group must first be saved**. This ensures that all configurations are properly initialised before assigning user groups.

### **Accessing User Groups for an Existing Audience Group**

When an audience group has already been configured as an Ads Config audience group, managing user groups becomes accessible within the settings. Upon opening the audience group, users will see a **User Groups** button next to each previously enabled setting, allowing for further configuration. If a new setting is enabled, the **User Groups** button remains disabled until the audience group is successfully saved with the updated setting.

Perform the following steps to configure a user group:

1. Click **Edit** to configure the **Audience Group**.

2. Enable the relevant setting. For each **enabled setting** , a **"User Groups"** button appears

3. If the setting was enabled previously, the user groups button is active and can be configured.

4. If the **setting was just enabled** , the button is **inactive until saved.** Once an Audience Group is **saved** , User Groups can be configured.

5. Configure the setting and save the Audience group. The **User Groups** button is now enabled.

### **Adding a New User Group**

1. Click **[+Add User Group]**.

2. Enter User Group Details: Name, Status, Availability, and optional details like Labels and Notes.

3. Define Rules for the User Group.

![image-20250312-165841.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20250312-165841.png?version=1&modificationDate=1741798724976&cacheVersion=1&api=v2&width=777&height=511)
### **Managing User Groups.**

You can reorder, duplicate and delete the user groups.

![image-20250312-170024.png](https://tripledotstudios.atlassian.net/wiki/download/thumbnails/2765029415/image-20250312-170024.png?version=1&modificationDate=1741798828546&cacheVersion=1&api=v2&width=777&height=538)
* * *

### **Validation & Restrictions**

**Cannot disable a setting if User Groups exist. Can disable a setting only if no User Groups are present**

* * *

Vector dimensions: 1536
3
Settings List In the table below, you’ll find all settings available in Base Ad Config and their...
Vectorized

Settings List

In the table below, you’ll find all settings available in Base Ad Config and their descriptions. Click on the expand to open the list.

 Fields in Ads Config

Find [here](/wiki/spaces/QA/pages/323878913/Types+of+ads+and+its+requirements) detailed information on the types of ads and its requirements.

| ### **Rewarded Videos** Rewarded videos are a type of incentivised advertising that rewards players for watching a promotional video. |

| **Field Name** | **Description** | **Comments** |

| **Placement Bank** | Bank with the list of rewarded video placements.  | Type: Dropdown with placement banks as options. |

| **Overall Rewarded Video Limit** | The total limit of rewarded videos a player can watch. | - Type: Integer |

| **Overall Rewarded Video Limit Reset Time** | The number of hours (after midnight device time) to reset this limit.  | - Type: Integer |

| **Bidding floor CPM for rewarded videos** | Floor value to be sent to MAX for rewarded video bidding. | - Type: Float - **Bidding floor CPM for rewarded videos** is available from tripledot-platform-ads 1.3.0 |

| **Consecutive Google Ads Limit** | A counter for the number of consecutive Google ads shown, so that you can control when we stop sending requests to the Google Direct auction and show the MAX ad currently in the cache. | - Type: Integer - **Consecutive Google Ads Limit** is available from tripledot-platform-ads 2.5 |

| **Enable interstitial instead of rewarded video** | If the toggle is ON, rewarded video can be replaced with interstitials in case there is no cashed rewarded videos or the price for interstitial is higher than rewarded video. | - Type: Integer |

| **MAX Rewarded Videos Ad Units** | This setting allows you to manage and optimise rewarded videos ad units for the MAX ad platform. By configuring these units, you can control the delivery and behaviour of rewarded videos. | This setting is described in [detail here](/wiki/spaces/KB/pages/4304109569/Setting+up+Ad+Units#MAX-Rewarded-Videos-Ad-Units). |

| **Ad Slots Bank** | Select from the list of predefined Ad Slots banks. | - Type: Dropdown with the pre-configured options. |

| **Rewarded Videos Request Throttling** | Maximum memory in MBs to be allocated for loading the videos | - Type: Integer |

| ### **Settings Available in both Rewarded Videos and Interstitial Tabs** |

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

| **Google Postbid IDs and Google Postbid Requests Limit Counter** |

| **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. | Post bidding typically refers to bidding for an ad placement after an initial bid request. |

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

| **Google Postbid Requests Limit Counter** | The **Google Postbid Requests Limit Counter** field sets a maximum number of requests that can be sent to Google Postbid before an ad is shown. | This number resets once a MAX ad is displayed. **Google Postbid Requests Limit counter** Google Postbid Requests Limit Counter is available from tripledot-platform-ads 2.5.0 |

| ### **Interstitials** An interstitial ad is a full-screen ad that covers the entire interface of the game. |

| **Field Name** | **Description** | **Comments** |

| **Placement Bank** | Bank with the list of interstitials placements  | |

| **Restrictions for Newcomers (Interstitials Setting)** |

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

| **Frequency Restrictions (Interstitials Setting)** |

| **Config Type** | - Config Based on Network - Standard Config | |

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

| **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 (Interstitials Setting)** |

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

| **Back-to-back frequency restriction (Interstitials Setting)** |

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

| **Impression Restriction (Interstitials Setting)** |

| **Minimum CPM value. Min CPM Type** | Minimum CPM value that an interstitial ad should have in order to be shown. There are 2 options: - **Static** , where you determine a set value in dollars - **Formula** , where a formula based on the past 50 collected events calculates the bidding floor. | - Default: Static - If **Static** is selected, Game Server will display only the field “Static floor CPM“ - If **Formula** is selected, an additional list of parameters for formula is displayed in sub-group called “ **Formula parameters** “. The settings are the same that are used in [Setting the CPM Floor](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3682861062/Copy+of+Configuring+Ads+in+Game+Server#Setting-the-CPM-Floor). |

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

Vector dimensions: 1536
4
| **Minimum CPM value. Static Floor CPM** | Specify a static value for the Bidding Floor CPM. | -...
Vectorized

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

Vector dimensions: 1536
5
| **Max Postbid CPM Floor Multiplier** | Define the upper limit of the CPM floor multiplier when ...
Vectorized

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

| **Google Postbid Requests Limit Counter** | The **Google Postbid Requests Limit Counter** field sets the maximum number of requests that can be sent to Google Postbid before an ad is shown. | This number resets once a MAX ad is displayed. **Google Postbid Requests Limit counter** Google Postbid Requests Limit Counter is available from tripledot-platform-ads 2.5.0 |

* * *

Vector dimensions: 1536

Details

Confluence ID
2765029415
Space Key
Version
126
Created
November 06, 2025 at 11:34 AM
Last Updated
November 06, 2025 at 11:34 AM
Last Modified (Confluence)
September 10, 2025 at 09:55 AM
Content Size
34.1 KB

Labels

ads
user-manual