Content
Introduction
Waterfall is the process used to get the best price for an impression of an advertisement. The Waterfall configuration allows you to optimise the delivery of ads by controlling the order in which ad networks are called to fill an ad request. The waterfall setup enables that the most valuable and relevant ads are prioritised, maximising revenue opportunities.
Table of Contents
Waterfall Settings
Request Refresh Period
The Request Refresh Period settings allow you to manage the frequency and behaviour of ad requests.
By configuring these options, you can:
Control how often ad requests are refreshed
Increase the refresh period after unsuccessful attempts,
Set limits on the maximum time between requests.
| Waterfall |
| 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 |
Navigate to Ads > Configuration > Waterfall , and enable the Request Refresh Period setting by clicking on the
[green + sign]. Fill in the fields following the information listed in the table above.
Chunks 1
**Introduction**
Waterfall is the process used to get the best price for an impression of an advertisement. The Waterfall configuration allows you to optimise the delivery of ads by controlling the order in which ad networks are called to fill an ad request. The waterfall setup enables that the most valuable and relevant ads are prioritised, maximising revenue opportunities.
**Table of Contents**
## Waterfall Settings
### Request Refresh Period
The **Request Refresh Period** settings allow you to manage the frequency and behaviour of ad requests.
By configuring these options, you can:
- Control how often ad requests are refreshed
- Increase the refresh period after unsuccessful attempts,
- Set limits on the maximum time between requests.
| **Waterfall** |
| **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 |
1. Navigate to **Ads \> Configuration \> Waterfall** , and enable the **Request Refresh Period** setting by clicking on the  **[green + sign]**.
2. Fill in the fields following the information listed in the table above.