Interstitial

Interstitials are full-screen ads shown at natural pauses: between levels, on game over, or when returning to the menu.

Interstitial integration is required for SDK integration to be considered complete. Publishing platforms expect games to show interstitials at natural breakpoints. Without them, the game may not qualify for revenue share and can be rejected during moderation.

Do not call showInterstitial() at game start. Platforms that allow it show it automatically; calling it explicitly can result in duplicate ads.

Ad settings are stored in playgama-bridge-config.json. Use the config editor to create or update them.

Is Interstitial Supported

Check this before showing interstitial-related UI or running interstitial logic.

bridge.advertisement.isInterstitialSupported

Platform support · 26 of 28 platforms

Supports: absolute_games, bitquest, crazy_games, dlightek, facebook, game_distribution, gamepush, gamesnacks, huawei, jio_games, lagged, microsoft_store, msn, ok, playdeck, playgama, poki, portal, samsung, telegram, tiktok, vk, xiaomi, y8, yandex, youtube

Does not support: discord, reddit

Minimum Interval Between Displays

Set the minimum delay between interstitial attempts. The SDK uses this delay to prevent ads from appearing too often.

// Default value = 60 seconds
bridge.advertisement.minimumDelayBetweenInterstitial

bridge.advertisement.setMinimumDelayBetweenInterstitial(30)

// Default value = 60 seconds
Bridge.advertisement.minimumDelayBetweenInterstitial

private void Start()
{
    // Set minimum interval
    Bridge.advertisement.SetMinimumDelayBetweenInterstitial(30);
}

// Get delay, default value = 60 seconds
playgama_bridge_advertisement_minimum_delay_between_interstitial()

// Set new delay
playgama_bridge_advertisement_set_minimum_delay_between_interstitial(30)

The SDK tracks the delay internally. Set the required interval once; if you call showInterstitial() too early, Bridge waits or skips according to platform behavior instead of showing ads too frequently.

Interstitial State

Check interstitialState at game start. If the state is opened, immediately mute audio and pause gameplay (or rely on the universal platform AUDIO_STATE_CHANGED / PAUSE_STATE_CHANGED handlers — see the note below).

Track state changes to drive ad-specific logic. For muting and pausing, prefer the universal platform events described below instead of reacting to each ad state separately.

bridge.advertisement.interstitialState

Possible values: loading, opened, closed, failed.

// To track interstitial ad state changes, subscribe to the event
bridge.advertisement.on(
    bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, 
    state => console.log('Interstitial state: ', state)
)

Bridge.advertisement.interstitialState

Possible values: Loading, Opened, Closed, Failed.

// To track interstitial state changes, subscribe to the event
private void Start()
{
    Bridge.advertisement.interstitialStateChanged += OnInterstitialStateChanged;
}

private void OnInterstitialStateChanged(InterstitialState state)
{
    Debug.Log(state);
}

Bridge.advertisement.interstitial_state

Returns the current state of the interstitial ad. Possible values: loading, opened, closed, failed.

# To track interstitial state changes, connect to the signal
func _ready():
    Bridge.advertisement.connect("interstitial_state_changed", self, "_on_interstitial_state_changed")

func _on_interstitial_state_changed(state):
    print(state)

# To track interstitial state changes, connect to the signal
func _ready():
    Bridge.advertisement.connect("interstitial_state_changed", Callable(self, "_on_interstitial_state_changed"))

func _on_interstitial_state_changed(state):
    print(state)

playgama_bridge_advertisement_interstitial_state()

Possible values: loading, opened, closed, failed.

// To track interstitial ad state changes, subscribe to the event

// via Async Social Event
if async_load[? "type"] == "playgama_bridge_advertisement_interstitial_state_changed" {
    switch async_load[? "data"] {
        case "loading":
            // your logic here
            break
        case "opened":
            // your logic here
            break
        case "closed":
            // your logic here
            break
        case "failed":
            // your logic here
            break
    }
}

bridge.advertisement.interstitial_state()

Possible values: loading, opened, closed, failed.

local bridge = require("bridge.bridge")

function init(self)
	bridge.advertisement.on("interstitial_state_changed", function (_, state)
		print("Interstitial state changed: ", state)
	end)
end

bridge.advertisement.interstitialState

Possible values: loading, opened, closed, failed.

// To track interstitial ad state changes, subscribe to the event
bridge.advertisement.on(EVENT_NAME.INTERSTITIAL_STATE_CHANGED, this.onInterstitialStateChanged.bind(this));

onInterstitialStateChanged(state: INTERSTITIAL_STATE) {
    console.log("Interstitial state: ", state);
    switch (state) {
        case 'loading':
            break;
        case 'opened':
            break;
        case 'closed':
            break;
        case 'failed':
            break;
    }    
}

While the interstitial is open, the game must be muted and paused. The recommended way to handle this is once, in a single place, by subscribing to the platform AUDIO_STATE_CHANGED and PAUSE_STATE_CHANGED events instead of duplicating the logic per ad type. Bridge raises those events whenever the host requests it — interstitials, rewarded ads, browser tab switches, system pauses — so a single universal handler covers every case.

Show Interstitial

Request an interstitial at a natural pause, such as a level transition, game over screen, or return to menu.

let placement = 'test_placement' // optional
bridge.advertisement.showInterstitial(placement)

Do not call showInterstitial() at game start. Platforms that allow a start-of-game interstitial handle it automatically.

PreviousAdvertisement NextRewarded

Last updated 4 days ago

hashtagIs Interstitial Supported

hashtagMinimum Interval Between Displays

hashtagInterstitial State

hashtagShow Interstitial

Is Interstitial Supported

Minimum Interval Between Displays

Interstitial State

Show Interstitial