Me
Explain how refresh period increment works in Waterfall.
Enki
**Source:** [Waterfall Ads Configuration](https://tripledotstudios.atlassian.net/wiki/spaces/KB/pages/3705700371)
The Waterfall Request Refresh Period provides a dynamic mechanism for managing ad request retries when initial attempts fail. Let me break down how the refresh period increment works:
### Key Configuration Fields
| Field | Description | Default |
|-------|-------------|---------|
| **Ad request refresh period** | Initial time to wait before retrying an ad request | 30 seconds |
| **Enable increment** | Toggle to activate progressive refresh delays | Unchecked |
| **Increment refresh period** | Multiplication factor for each failed attempt | 5x |
| **Maximum refresh period** | Ceiling for refresh delay | 90 seconds |
### Increment Mechanism
When **Enable increment** is checked, the system follows this logic:
1. First failed attempt:
- Waits initial 30 seconds
- If no ad is loaded, will wait 30 * 5 = 150 seconds on next attempt
2. Subsequent failed attempts:
- Each failure multiplies previous wait time by 5
- Example progression: 30s → 150s → 750s
3. Ceiling Protection:
- Refresh period will never exceed 90 seconds
- Prevents exponentially long wait times
### Example Scenario
- Initial ad request fails at 0s
- First retry at 30s
- Second retry at 150s
- Third retry at 750s (capped at 90s)
### Configuration Steps
1. Navigate to **Ads > Configuration > Waterfall**
2. Enable **Request Refresh Period**
3. Check **Enable increment**
4. Set desired increment and max values
This mechanism helps optimize ad loading by progressively extending retry intervals while preventing excessive waiting times.