Advertisement requirements
AI Summary
A short gist of this page, generated for you.
Powered by AI. Summaries can miss nuance — when in doubt, read the page.
Ads pay the bills — but bad ad placement kills retention. Funox monitors ad experience closely and may disable ads on games that break these rules.
#Interstitial ads
Shown with commercialBreak().
Allowed:
- Between levels
- After death or game over
- On map or world transitions
- Other natural breakpoints outside active gameplay
Not allowed:
- During active gameplay
- On navigation buttons (settings, shop, menu)
- More than once every 3 minutes
#What the game must do around an ad
The SDK does not pause your game for you. Before you call commercialBreak() or rewardedBreak():
- Mute all in-game audio.
- Pause the game state. No timers, no AI, no scoring.
- Block input to the game.
When the promise settles — whether an ad was shown or not:
- Unmute audio.
- Resume the game.
javascript
pauseGame(); // stop the loop, mute audio
FunOxSDK.commercialBreak()
.catch(function () { /* treat a failure like "no ad shown" */ })
.then(function () {
resumeGame();
});#Rewarded ads
Rewarded ads are player-initiated — they are offered, never forced. They are shown with rewardedBreak().
- Use rewarded ads for non-essential boosts: extra lives, coin doublers, cosmetic skins.
- Always provide a non-ad alternative, such as earning coins through gameplay.
- The "continue without watching" option must be the same size, font and color as the "watch ad" button.
- Show a video icon on the rewarded button so the player knows what to expect.
- Do not chain several ads into one reward.
- Do not offer the same rewarded ad immediately after one was watched — add a timer.
#Out-of-lives ads
Allowed, with care:
- Not after every death — add a cooldown.
- Never combined with an interstitial on the same screen.
- If no ad is available, let the player retry later.
#Reward delivery
- Grant the reward only when the result has
completed: true. - In every other case do not grant it. Show a friendly fallback such as "Try again in a moment".
javascript
FunOxSDK.rewardedBreak('extra_life').then(function (result) {
if (result.completed) {
grantExtraLife();
} else {
showMessage('Watch the full ad to get your reward!');
}
});#When no ad is shown
An ad is not always available, and players with ad blockers will never see one. In those cases the ad calls resolve with shown: false.
- Players must be able to play the full base game without ads.
- Never block gameplay because an ad did not show.
- Hide or disable a rewarded button when
isRewardedAdAvailable()isfalse, rather than leaving it visibly broken.
#Summary
| Ad type | During gameplay? | How often | Notes |
|---|---|---|---|
| Interstitial | No | At most once every 3 minutes | Natural breakpoints only |
| Rewarded | No — offered outside gameplay | Your own timer per feature | Always optional |