Chunks Used in Chat #29

**Introduction** An interstitial ad is a full-screen ad that covers the entire interface of the game. To better control the player experience, Game Server offers different configuration settings. **Table of Contents** * * * # 1. Enabling Interstitial Overrides Inside Interstitials, you can enable overrides separately for particular placements. Placement overrides are available for the following settings: - Restrictions for Newcomers. - Frequency Restrictions - Back-to-back frequency restriction - Impression Restrictions  When selecting an interstitial to add to your override, you’ll be presented with all the placements available. This list does not depend on the placement bank selected for the interstitial (if any).

**How does the logic of Overrides in Interstitials work?** Let’s assume we have 7 players and 4 Interstitials Placement Banks, each of them with a set of placements inside: .jpg?version=1&modificationDate=1728379257509&cacheVersion=1&api=v2&width=772&height=608) Now, we’d like to establish a set of overrides for different placement banks. Some overrides will also have Placement overrides or some restrictions for newcomers.  We’ve set 4 overrides, with different priorities, and we’ve assigned players to them using rules. As we can see, Overrides 3 and 4, and Base Config include specific overrides for placements and restrictions for newcomers. .jpg?version=1&modificationDate=1728379257525&cacheVersion=1&api=v2&width=772&height=405) With this configuration, each player will receive different overrides with specific settings when they start the game:  Now, we’ll go into detail about why each player receives that configuration:  * * * # 2. Impression Restrictions You can determine the value for impression restrictions by applying the identical formula used in[CPM Floor Calculations](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3705274372/Interstitials+Configuration#Setting-the-CPM-Floor). 1. First, navigate to **Ad Config \> Interstitials** , and enable the **Impression Restrictions** setting. 2. Fill in the fields following the information listed in the Impressions Restrictions table below. 3. If required, you can set up overrides for specific ad placements by selecting Overrides. Then, click the particular placement and select the required settings.  | **Impression Restrictions** | | **Field Name** | **Description** | **Validations** | | **Min CPM Type** | Select the way you want to define the Bidding Floor | - Type: Dropdown: Static, Formula - Default: Static | | **Static CPM Configuration. Fallback CPM Value** | Specify a fallback floor value to be sent for interstitial bidding. | - Type: Float - Default: Empty | | **Static CPM Configuration. Use Percentiles** | Enable to use percentile for CPM floor value. | - Type: Boolean - Default: False | | **Static CPM Configuration.CPM Percentile Configs** | Select the relevant config from the dropdown. Refer to this [User Guide](/wiki/spaces/KB/pages/4244537368/CPM+Percentile+Configuration) to learn to configure the CPM Percentiles. | - Type: Multi-select Dropdown - Options: List of available configs (with display priority) - Mandatory if Use Percentiles = True | | **Static CPM Configuration.If No Matching Configuration** | Select the relevant option if no matching config is available. | - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles = True | | **Static CPM Configuration. If no Percentile available** | Select the relevant option if no percentile is available. | - Type: Dropdown - Options: Return fallback value, Return nothing - Mandatory if Use Percentiles = True | | **Formula Parameters. Formula Type** | Defines the type for calculating the formula. | Type: Dropdown with the following options: - Median - Average - Default: Median | | **Use successful ad requests only** | Enable if you want to use only successful ad requests for calculation. | - Type: Boolean - Default: OFF - Available if type = formula | | **Min ad requests to apply formula** | This field is used to provide minimum number of interstitials which should be taken into account to calculate formula | - Type: Integer - Mandatory if “Formula” is selected in “Bidding floor type” - Default: Empty - Min 1 - Max: 50 - Must be less than the value provided in the setting “Ad requests to apply formula to“ | | **Ad requests to apply formula to** | This field is used to provide maximum number of interstitials which should be taken into account to calculate formula | - Type: Integer - Mandatory if “Formula is selected in “Bidding floor type” - Default: Empty - Min 1 - Max: 50 | | **Percentage coefficient** | Specify the multiplier to minimise the Bid floor. | - Mandatory if “Formula” is selected in “Bidding floor type” - Min: more than 0 - Max: 2 - Max number of characters after comma = 2 - Incase multiplier results in `max_interstitials.cpm_floor` value with more than 2 characters after comma, GS rounds off the result using math rules. - (e.g. if we have as a result value 1,234 -\> round to 1.23 but if 1.235 -\> round to 1.24) | | **If insufficient ad requests** | Defines the system behaviour when there is insufficient data for calculation. If “Return static value“ is selected, GS will send value from “Static floor CPM“. If “Return nothing“ is selected, GS won’t send any value. | Dropdown with the list of options provided below: - Return fallback value - Return nothing - Default: Return fallback value | **Setting the CPM Floor** Game Server provides two types of validations for Bidding Floor Type. - Static - Formula **Choosing a Bidding Floor Type** There are two options for defining the CPM floor: **A. Static CPM Floor** - **Definition** : Sends a fixed CPM value to the client, which is forwarded to the mediation system (e.g., Max, Google, or Meta). - **How to Configure** : - **Behaviour** : The same CPM value will always be used for bidding. **B. Formula-Based CPM Floor** - **Definition** : Dynamically calculates the CPM floor using the following formula: - If **Median** is selected in the Formula type dropdown field: _interstitial\_cpm\_floor = Median (most recent **N** CPM values) \* **K** _ - If **Average** is selected in the Formula type dropdown field: _interstitial\_cpm\_floor = Average (most recent **N** CPM values) \* **K** _ This formula allows you to determine the number of CPMs stored ( **N** ). If the number of CPMs is lower than **X** (Minimum number of events required for calculation), Game Server won’t return anything, or will return a static value as determined by the settings.  **Determining N for Each Ad Unit** - N represents the number of most recent CPM values retrieved from a bucket for median calculation. - **How is N Defined?** - **Handling Fewer Events than N** : - **Minimum Number of Events:** - **Behaviour for Insufficient Events (Fewer than X)**: - **Multiplier K:** - **Use successful ad requests only:** Enable/Check if you want to use only successful ad requests for calculation. - **Use static in case of failed requests:** Enable/Check in case you want to send static value instead of formula calculation when a number of latest requests have failed. if static is selected for fallback value and Percentile is enabled, the system will firstly check if it is possible to use the static CPM based on percentiles. If yes, than the value is obtained from there. If no, the system will use the fallback value OR nothing. In case of nothing usually the system sends 0.0 as floor. - **Number of failed requests:** Specify number of latest failed requests. If this number is reached, static value will be used instead of formula calculation. For detailed information on how Analytics Buckets work, refer to this [User Guide](https://tripledotstudios.atlassian.net/wiki/x/BIBUAQE). # 3. Frequency Restrictions To better control the user experience for the players, you can enable frequency restrictions for interstitials with **conditions**. Conditions are included inside sections, which allow you to nest sets of restrictions and combine them to target players more accurately. The conditions in Frequency Restrictions use the basic AND/OR operators. There are two configuration type options available: - Config Based on Network - Standard Config For each of the above config types, there are 2 options: - _ **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 - _ **Custom** _ **: Min count allowed between interstitials:** The ad will be shown only if the required number of particular points in the game is passed since the latest successful impression.   1. Enable the **Frequency Restrictions** setting by clicking on the  **[green + sign]**. 2. Fill in the fields following the information listed in the table below. 3. If required, you can set up overrides for specific ad placements by selecting Overrides. Then, click the particular placement and select the required settings. | **Time-Based Frequency Restrictions** | | **Field Name** | **Description** | **Comments** |

**14.1 Creating a new Interstitial Placement** 1. To create a new Interstitial Placement, click the green **[New]** button on the upper right side of the screen.  2. Assign a name and a unique key to it. 3. Click **[Save]** when you’re done.  ## **14.2 Creating a new Interstitial Placement Bank ** Once you’ve created your Interstitial Placements, it’s time to put them together into a Bank. The goal of the bank is to put all the placements together and assign a probability to each of them appearing when the player reaches the placement.  1. To create a new Interstitial Placement Bank, click the green **[New]** button on the upper right side of the screen. 2. Assign a name to your placement.  3. Under Placements, select a placement and click **[Add Placement]**. The new placements will appear below. 4. Under Interstitial Probability, assign a number to determine the probability of the player receiving the ad once they reach the placement. **How does probability work?** Probability is limited from 0 to 1, where 0 = 0% and 1 = 100%. For instance, if you’d like to set up a 50% of probability of the player receiving the placement, type in 0,50. 1. Click **[Save]** to finish the configuration of the Placement Bank.  If you delete a placement, you can undo it by using the the **Undo button** 🔄 * * *