> For the complete documentation index, see [llms.txt](https://wiki.playgama.com/playgama-ad/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.playgama.com/playgama-ad/integration/banner-ad-refresh.md).

# Banner Ad Refresh

Ad refresh is the automatic reloading of a banner ad after a set time interval, serving a new ad creative to a user who is still on the page. When implemented correctly, refresh significantly increases total impressions and revenue from banner placements. When implemented incorrectly, it violates Google's policies and can result in demand restrictions or account suspension.

**Playgama manages refresh logic centrally.** Do not implement your own refresh mechanism — all refresh behavior is controlled by Playgama's ad stack.

***

## How Refresh Works

1. A banner ad is loaded and displayed on the page.
2. After a set interval, the ad slot requests a new ad.
3. A new creative is served (from the same or a different advertiser).
4. The cycle repeats as long as the user remains on the page.

Each refresh generates a new impression and a new auction — meaning each refreshed slot is an additional revenue opportunity.

***

## Google's Refresh Rules

Google AdX enforces strict rules on ad refresh. Violating them results in reduced fill, lower CPMs from AdX, or account-level restrictions.

### What Google Requires

* **Minimum refresh interval: 30 seconds.** Google will not serve on slots that refresh faster than 30 seconds. This is a hard limit — not a recommendation.
* **User must be active on the page.** Refresh must only occur when the user is actively engaged — not when the tab is in the background or the user has scrolled away from the ad.
* **Ad must be visible at time of refresh.** The ad slot must meet viewability standards at the moment it refreshes. Refreshing a hidden or off-screen ad violates policy.
* **No incentivized refresh.** You cannot encourage users to stay on the page to trigger more ad refreshes (e.g., "Keep watching to earn points").

### Prohibited Refresh Behaviors

| Behavior                                                 | Status                               |
| -------------------------------------------------------- | ------------------------------------ |
| Refresh interval under 30 seconds                        | ❌ Policy violation                   |
| Refreshing ads in background/inactive tabs               | ❌ Policy violation                   |
| Refreshing hidden or off-screen ads                      | ❌ Policy violation                   |
| Implementing your own refresh logic on top of Playgama's | ❌ Will conflict with managed refresh |
| Auto-refresh on static, non-interactive pages            | ⚠️ Requires careful implementation   |

***

## Playgama's Recommended Refresh Settings

While 30 seconds is the minimum allowed by Google, **Playgama recommends a refresh interval of 60–90 seconds** for most gaming placements.

### Why 60–90 Seconds Is Better Than 30

| Metric                     | 30s refresh | 60–90s refresh |
| -------------------------- | ----------- | -------------- |
| Impressions per session    | More        | Fewer          |
| Viewability per impression | Lower       | Higher         |
| CPM per impression         | Lower       | Higher         |
| Advertiser satisfaction    | Lower       | Higher         |
| Long-term demand quality   | Degrades    | Stable         |

Refreshing every 30 seconds floods the market with low-viewability impressions. Buyers learn this and reduce their bids. A 60–90 second interval produces higher-quality impressions that attract better bids — the net revenue is typically equal or better, with less policy risk.

***

## Viewability and Refresh

Refreshing a banner that is not in view is both a policy violation and a waste of impressions. Playgama's refresh implementation includes **viewability gating** — a refresh only fires when:

* The ad slot is at least 50% visible in the user's viewport.
* The user's tab is active (not backgrounded).
* The minimum time interval has elapsed.

This protects your inventory quality score and keeps CPMs healthy.

***

## What You Should (and Should Not) Do

**Do:**

* Place banners in visible, stable positions on the page.
* Keep the banner in the viewport during normal gameplay (e.g., below or beside the game canvas).
* Contact your account manager if you want to discuss refresh settings for your specific layout.

**Do not:**

* Implement any JavaScript-based refresh, setInterval, or slot reload on banner elements managed by Playgama.
* Move or hide banner containers after the ad has loaded.
* Request a new ad by calling `requestPageAd()` repeatedly in a loop.

***

## Frequently Asked Questions

**Can I request a faster refresh for my high-traffic site?** No. 30 seconds is Google's hard minimum and cannot be bypassed regardless of traffic volume.

**Can I disable refresh entirely?** Yes. If your game layout makes refresh unsuitable (e.g., a banner that goes off-screen during gameplay), contact your account manager to disable refresh for specific placements.

**Does refresh apply to interstitials and rewarded ads?** No. Refresh only applies to display banner placements. Interstitials and rewarded ads are triggered by game events, not time intervals.
