Configuring Ads in Game Server
Chunk #2
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 |
Rewarded Videos Configuration
Chunk #0
**Introduction**
Rewarded videos are a type of incentivised advertising that rewards players for watching a promotional video.
**Table of Contents**
Rewarded Videos Configuration
Chunk #1
1. Rewarded Videos Settings
The **Rewarded Videos Settings** section provides a comprehensive set of configurations to optimize the use and management of rewarded video ads. These settings allow you to control various aspects of rewarded videos, from limiting how many videos a user can view, to setting up bidding floors and ad placements.
### 1.1 Placement Bank
The **Placement Bank** is a collection that stores a list of rewarded video placements. It allows you to manage and organise multiple rewarded video ad placements in one centralised location.
| **Field Name** | **Description** | **Comments** |
| **Placement Bank** | Bank with the list of rewarded video placements. | Type: Dropdown with placement banks as options. |
1. Navigate to **Ads \> Configuration \> Rewarded Videos** , and enable the **Placement Bank** field by clicking on the  **[green + sign].**
2. Click the empty text box or the down arrow on the right to open the dropdown menu.
3. Choose the appropriate placement bank for your configuration.
4. If the desired placement bank is not listed, you can add a new one by following the instructions listed in the [Rewarded Video Placements & Rewarded Video Placement Banks](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/edit-v2/3705405454?draftShareId=5d3a47fe-fa1d-47e5-8c66-1807189ea81d#Rewarded-Video-Placements-%26-Rewarded-Video-Placement-Banks) section below.
### 1.2 Overall Rewarded Video Limit
The **Overall Rewarded Video Limit** setting allows you to specify the maximum number of rewarded video ads a user can view within a given session or time frame.
| **Field Name** | **Description** | **Comments** |
| **Overall Rewarded Video Limit** | The total limit of rewarded videos a player can watch. | - Type: Integer |
1. Enable the **Overall Rewarded Video Limit** field by clicking on the  **[green + sign].**
2. In the field, enter the desired maximum number of rewarded videos a player can view.
### 1.3 Overall Rewarded Video Limit Reset Time
The **Overall Rewarded Video Reset Time** defines the interval, in hours, after which the count of rewarded videos a player can watch is reset.
The reset occurs based on the number of hours specified in this field, starting from midnight according to the device’s local time.
| **Field Name** | **Description** | **Comments** |
| **Overall Rewarded Video Limit Reset** | The number of hours (after midnight device time) to reset this limit. | - Type: Integer |
1. Enable the **Overall Rewarded Video Limit Reset** field by clicking on the  **[green + sign].**
2. In the field, enter the desired number of hours post midnight of the player's device time to reset the rewarded video limit.
### **1.4 Enable interstitial instead of rewarded video**
This setting allows you to enable interstitial ads in place of rewarded videos.
When this checkbox is selected, interstitial ads will be displayed to players instead of the usual rewarded video ads.
| **Field Name** | **Description** | **Comments** |
| **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 |
1. Enable the **Enable interstitial instead of rewarded video** field by clicking on the  **[green + sign].**
2. Select the checkbox to display interstitial ads instead of rewarded videos.
3. Leave the checkbox unselected to display the rewarded videos.
### 1.5 Google Postbid IDs
The **Google Postbid IDs** setting allows you to optimise post-bidding ad requests.
The Postbid IDs for Android and iOS identify your app within Google's post bidding system.
| **Field Name** | **Description** | **Comments** |
| **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. | |
1. Enable the **Google Postbid IDs** field by clicking on the  **[green + sign].**
2. Fill in the fields following the information listed in the table above.
### 1.6 Consecutive Google Ads Limit
This setting implements a counter to track the number of consecutive Google ads displayed.
By specifying this count, you can effectively manage when to halt requests to the Google Direct auction and instead display the MAX ad currently available in the cache.
| **Field Name** | **Description** | **Comments** |
| **Consecutive Google Ads Limit** | A counter for the number of consecutive Google ads shown, so that you can control when to 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 |
1. Enable the **Consecutive** **Google Ads Limit** field by clicking on the  **[green + sign].**
2. In the field, specify the number of consecutive Google ads to be displayed.
### **1.7 Google Postbid Requests Limit counter**
The **Google Postbid Requests Limit Counter** sets a configurable maximum number of requests before an ad is shown.
| **Field Name** | **Description** | **Comments** |
| **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 |
1. Enable the **Google Postbid Requests Limit Counter** field by clicking on the  **[green + sign].**
2. In the field, specify the maximum number of requests to be sent to Google Postbid before an ad is shown.
