Skip to content

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() is false, 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