Video ads

Monetize your game by showing video ads at natural breakpoints — between levels, on game-over screens, or as optional rewarded ads.

Ad types

Midroll Shown at natural pauses between levels or stages

Rewarded Player-initiated — earn in-game rewards in exchange

Preroll Shown once during game load (if applicable)

Implementation

Always wrap level transitions with gameplayStop() and gameplayStart() signals:

// Request a midroll ad (e.g. between levels)
sdk.game.gameplayStop();

await sdk.ads.showMidroll({
  onComplete: () => {
    sdk.game.gameplayStart();
    startNextLevel();
  },
  onError: (err) => {
    sdk.game.gameplayStart();
    startNextLevel(); // always continue on error
  }
});

Rewarded ads

// Player taps "Watch ad for extra life"
await sdk.ads.showRewarded({
  onComplete: () => grantExtraLife(),
  onSkip: () => console.log("User skipped — no reward"),
  onError: () => console.log("Ad failed to load")
});

Always call gameplayStop() before showing an ad and gameplayStart() when the ad ends. This ensures correct timing signals for revenue attribution.