Interstitial

There are some advertisement settings in the playgama-bridge-config.json file

Playgama Bridge Config

Interstitial ads typically appear during transitions in the game, such as level loading or after game over.

Is Interstitial Supported

Check if the platform supports displaying interstitial ads.

bridge.advertisement.isInterstitialSupported

Minimum Interval Between Displays

Set the minimum time interval between interstitial ad displays to comply with platform requirements and improve user experience.

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

bridge.advertisement.setMinimumDelayBetweenInterstitial(30)

There should be time intervals between interstitial ad displays. For convenience, this SDK includes a built-in timer mechanism between ad displays. You just need to specify the required interval, and you can call the ad display method as often as you like.

Interstitial State

Check the interstitialState at the start of the game, and if the ad is opened, perform the necessary actions (mute sounds/pause the game/etc.).

Track the state of the interstitial ad to manage ad display and user experience.

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;
    }    
}

React to changes in ad state. For example, mute the game sound when opened and unmute when closed and failed.

Show Interstitial

Display an interstitial ad at appropriate moments, such as during level transitions or game over screens.

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

Do not call showInterstitial() method at the start of the game. On platforms where this is allowed, the ad will be shown automatically.