# Interstitial

{% hint style="info" %}
There are some advertisement settings in the `playgama-bridge-config.json` file

[playgama-bridge-config](https://wiki.playgama.com/playgama/sdk/playgama-bridge-config "mention")
{% endhint %}

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.

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2Fb8FOyxlUQSMSL9Rj1IBL%2FScreenshot%202025-07-25%20at%2010.06.33%E2%80%AFAM.png?alt=media&#x26;token=7858bbec-a7d5-4a74-b783-88fad00a0f79" alt=""><figcaption></figcaption></figure>

#### Minimum Interval Between Displays <a href="#minimum-interval-between-displays" id="minimum-interval-between-displays"></a>

Set the minimum time interval between interstitial ad displays to comply with platform requirements and improve user experience. Default value is 60 seconds.&#x20;

```javascript
PlaygamaBridge::MinimumDelayBetweenInterstitial()
```

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.

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FF9DcBy93Ro4aCSsvjgHq%2FScreenshot%202025-01-21%20at%2012.59.13.png?alt=media&#x26;token=6f7e97f4-39ee-4693-bc11-bc70cf728cfe" alt=""><figcaption></figcaption></figure>

#### <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F9BooaofCI33U9Np5oeif%2FFrame%203%20(1).png?alt=media&#x26;token=0750b56a-a069-4759-bda9-29951f06cd30" alt="" data-size="line"> Interstitial State <a href="#interstitial-state" id="interstitial-state"></a>

{% hint style="warning" %}
Check the `Interstitial State` at the start of the game, and if the ad is `opened`, perform the necessary actions (mute sounds/pause the game/etc.).
{% endhint %}

Track the state of the interstitial ad (loading, opened, closed, failed) to manage ad display and user experience.

```javascript
PlaygamaBridge::InterstitialState()
```

Current state of the interstitial ad. Possible values: `loading`, `opened`, `closed`, `failed`.

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FxDagmRXfvdFfVS8z53FY%2FScreenshot%202025-01-21%20at%2013.06.51.png?alt=media&#x26;token=251e5d69-16d0-4a1c-80f6-f575ee83f49e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
React to changes in ad state. For example, mute the game sound when `opened` and unmute when `closed` or `failed`.
{% endhint %}

#### <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F9BooaofCI33U9Np5oeif%2FFrame%203%20(1).png?alt=media&#x26;token=0750b56a-a069-4759-bda9-29951f06cd30" alt="" data-size="line"> Show Ad <a href="#show-a-d" id="show-a-d"></a>

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

* Placement (optional)

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FrUWzhlzz3fzfQSgoAY4m%2FScreenshot%202025-05-28%20at%2011.35.40%E2%80%AFAM.png?alt=media&#x26;token=68d28cbd-b863-4eb4-84a7-f0fd2b78473c" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Do not call `Show Interstitial` method at the start of the game. On platforms where this is allowed, the ad will be shown automatically.
{% endhint %}
