# **Introduction**

Ad Slots improve ad monetisation by supporting a new Bidding system that works with both MAX and Google ads. This update helps track ad performance more accurately by storing recent ad impressions and calculating revenue more precisely.

You will also learn to configure Ad Slot Banks in this user guide.

 

* * *

# **Key Differences Between Ad Slots and Ad Units**

- Ad Slots are designed to support complex bidding setups by grouping all relevant settings in one place. Unlike Ad Units, which are tightly coupled to a single mediation platform, Ad Slots can accommodate rules for MAX, Meta, and Google networks.

- CPM values for Ad Slots are calculated using a dedicated storage system that tracks the latest impression events:

- Impressions from Google’s and Max’s post-bid mediation are used in Ad Slot CPM calculations.

- In summary, Ad Units are platform-specific identifiers used to serve ads whereas Ad Slots are configuration containers that manage bidding logic, CPM tracking, and data storage for one or more Ad Units.

# **Configuring Ad Slots**

Access the Ad slots as shown in the below image:

## **Settings for Each Ad Slot**

- **Name:** Specify a unique name.

- **Labels:** Select a label from the dropdown.

- **Type:** Select the type of Ad slot. Options: Interstitials or Rewarded Videos

- **Ad Ranking Multiplier:** This setting defines the relative importance of a specific ad network within the client-side ad ranking system. It accepts a floating-point value (minimum: 0.1, up to 2 decimal places).

**Behaviour:**

- Higher values increase a network’s ranking priority.

- Lower values reduce its priority.

- Actual CPM remains unchanged; this only affects which ad is shown first.

**Example:**

Assume 3 cached ads with the same CPM ($10), but different Ad Ranking Multipliers:

| Ad Slot | Multiplier | CPM | Ranking Revenue (CPM × Multiplier) |

| --- | --- | --- | --- |

| Google 1 | 2.0 | 10 | 20 |

| MAX 2 | 1.8 | 10 | 18 |

| MAX 1 | 1.5 | 10 | 15 |

**Resulting display order:**

1. **Google 1**

2. **MAX 2**

3. **MAX 1**

Even though the ranking order changes, each ad unit still has the same CPM (e.g., $10). What we manage here is the order in which networks are prioritised for ad delivery based on their adjusted CPM values.

- **Ad Unit Mediation:** Select between **MAX,** **Google or Meta**.

## **Adding Ad Units**

- Multiple Ad Units can be added per Ad Slot.


Refer to the [Settings for Each Ad Unit](/wiki/spaces/KB/pages/4304109569/Setting+up+Ad+Units#Settings-for-Each-Ad-Unit), [CPM Floor Settings](/wiki/spaces/KB/pages/4304109569/Setting+up+Ad+Units#Setting-the-CPM-Floor), and [Ad Slots Ad Units fields](/wiki/spaces/KB/pages/4304109569/Setting+up+Ad+Units#Ad-Slots-Ad-Unit-Fields) sections for more details.

## Configuring Ad Slot Banks

The Ad Slot Bank feature lets you organise and structure your ad delivery setup by grouping multiple Ad Slots under a shared configuration. You can define complex slot hierarchies and reuse them across monetisation workflows.

### **Accessing Ad Slot Bank Configurations**

To access Ad Slot Banks:

- Navigate to the **Ads** menu in the sidebar.

- Click **Ad Slot Bank** to view all existing configurations.

* * *

### **List View and Filters**

The list displays all configured Ad Slot Banks. Use it to search, filter, or modify configurations.

#### **Key Columns**

- ID

- Name

- Labels

- Availability

- In Use

- Updated At

- Actions: Edit, duplicate, or delete a configuration.

#### **Filters**

You can filter the list by:

- ID

- Name

- Labels

- Availability state

- Created after / updated after

- Created by you

* * *

### **Creating Ad Slot Bank**

- Click **[+New]** to open a configuration view.

**Configuration Fields:**

- **Name** : Enter a name for the bank.

- **Label** : Add tags to help organise or filter configs.

- **Type:** Select Interstitial or Rewarded Videos type for the Ad slot bank.

#### **Adding and Structuring Ad Slots**

Each Ad Slot Bank can contain one or more Ad Slots, with flexible nesting.

- Click **[+ Add Ad Slot]** to add an ad slot.

- From the **Ad Slot Bank 1** dropdown select the pertinent Ad slot.

- Click **[+ Add Child Section]** to add a child section to the Ad slot.
You can add up to three levels of nesting.

- Click **[+ Add Ad Slot]** to add additional ad slots.

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

| **Override refresh period** | If setting is ON, user can configure Refresh period which will be applied for selected Ad Slot. Ad Slots for which refresh period if OFF, will use setting “Request refresh period“ from tab “Waterfall“ While Configuring Ads from the Ads Config section, you can specify the request refresh period from the Waterfall tab.  The Request Refresh period is how long the game waits before attempting to request another ad after a failed attempt. | Type:Boolean - Default: False |

| **Ad Request refresh period** | Period the the game waits before attempting to request another ad after a failed attempt | - Type = Float - Empty by default - Mandatory - Min: 1.0 - Available if **Override refresh period** = true |

| **Enable increment** | Check to enable increments | Type:Boolean - Default: False - Available if **Override refresh period** = true |

| **Increment refresh period with every unsuccessful attempt X** | Specify the refresh rate to multiply in every consecutive attempt (resets on successful request) | - Type = Float - Min: 1.0 - Default: Empty - Available and sent via API if **Override refresh period** = true - Mandatory |

| **Until a max value** | The maximum value that the ad request refresh period can reach. It is equal to basic ad request refresh period if not set in Admin tool | - Type = Integer - Min: 1.0 - Default: Empty - Available and sent via API if **Override refresh period** = true - Mandatory |

#### **Rules and Guidelines**

- At least one Ad Slot is required.

- Slots are not added by default.

- Each Ad Slot must be configured manually if added (defaults are empty).

- You can nest up to 3 levels deep (4 total including root).

- Nesting can be applied to any Ad Slot, and multiple slots can exist on the same level.

- Slot names automatically reflect hierarchy (e.g., 1.1, 1.1.1, 1.1.1.1 etc.).

- Each nested slot can be deleted individually.

- A specific Ad Slot ID can only appear once per configuration.

* * *