Skip to content

Video ads

Guidelines for Advertisements

Please be sure to read our advertisement guidelines, since your game will be rejected without any feedback if it doesn't follow them.

The ad module contains functionality for displaying video ads and for detecting adblockers. It can be accessed like this:;

Video ads

We support two different types of video ads: midgame and rewarded.

Midgame advertisements can happen when a user died, a level has been completed, etc.

Rewarded advertisements can be requested by the user in exchange for a reward (An additional life, a retry when the user died, a bonus starting item, extra starting health, etc.). Rewarded ads should be shown when users explicitly consent to watch an advertisement.

Midgame ad example:

const callbacks = {
  adFinished: () => console.log("End midgame ad"),
  adError: (error) => console.log("Error midgame ad", error),
  adStarted: () => console.log("Start midgame ad"),
};"midgame", callbacks);

Rewarded ad example:

const callbacks = {
  adFinished: () => console.log("End rewarded ad"),
  adError: (error) => console.log("Error rewarded ad", error),
  adStarted: () => console.log("Start rewarded ad"),
};"rewarded", callbacks);

The adError callback is also triggered if the ad is not filled.

The returned errorData object will look like this:

  "code": "unfilled", // possible "code" values: ["unfilled", "other"]
  "message": "No ad available"


Don't forget to mute the audio and pause the game when the ad starts (adStarted callback), and to unmute the audio and continue the game when the ad finishes/fails to load (adError and adFinished callbacks)

Adblock detection

You can use the code below to detect if the user has an adblocker.

const result = await;
console.log("Adblock usage fetched", result);


We require games to function even when the user has an adblock. The detection is not foolproof, and it would be very frustrating for a user not running any adblock to get a non-functional game. You can block extra content, such as custom skins, or some levels, to motivate the user to turn off their adblock. Also, keep in mind that turning off the adblock usually requires a page refresh. Make sure that the progress is saved, or the user may just decide to stop playing your game.