# 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%2Fwm94jOwE0b3VvGzMqZdg%2FScreenshot%202025-07-25%20at%2010.02.50%E2%80%AFAM.png?alt=media&#x26;token=3d2b11e0-2979-4a85-bb9b-7f193e0fa3e9" 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.

```javascript
// Default value = 60 seconds
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%2FtQp7CaeMFmBK28wwDIP6%2FScreenshot%202024-10-17%20at%206.34.55%E2%80%AFPM.png?alt=media&#x26;token=df2b0fa4-988d-40de-afa6-1af6ece2331e" 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%2FozIHANKQY9x7lht5xEXP%2FScreenshot%202024-10-17%20at%206.36.21%E2%80%AFPM.png?alt=media&#x26;token=83f2eb44-0ba9-4f13-bd96-a6607314928f" 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%2FzsCZOMnb7AJoLRXcItLJ%2FScreenshot%202025-05-28%20at%2011.26.49%E2%80%AFAM.png?alt=media&#x26;token=861a5ac8-30c9-4844-882c-f6bd3e663bd2" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.playgama.com/playgama/sdk/engines/construct-3/advertising/interstitial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.