# Advertisement

Use ads to monetize the game across supported platforms. **Interstitial integration is required**: every game must show interstitial ads at natural breakpoints to qualify for platform revenue share. Other formats are optional additions.

{% hint style="warning" %}
Never show ads in the middle of active gameplay. Show them at natural pauses: level transitions, map changes, game over, or return to menu.
{% endhint %}

## Which format to use

| Format                                                                      | Status      | When to show                                | Player choice  |
| --------------------------------------------------------------------------- | ----------- | ------------------------------------------- | -------------- |
| [**Interstitial**](/playgama/sdk/api/advertisement/interstitial.md)         | Required    | Level transitions, game over, menu→gameplay | Automatic      |
| [**Rewarded**](/playgama/sdk/api/advertisement/rewarded.md)                 | Recommended | Player opts in for an in-game reward        | Opt-in         |
| [**Banner**](/playgama/sdk/api/advertisement/banner.md)                     | Recommended | Idle screens (menu, lobby, pause)           | Always visible |
| [**Advanced Banners**](/playgama/sdk/api/advertisement/advanced-banners.md) | Recommended | Custom banner placements with extra control | Always visible |
| [**AdBlock detection**](/playgama/sdk/api/advertisement/adblock.md)         | Optional    | Detect and react to blocked ads             | n/a            |

## Recommended integration order

1. [**Interstitial**](/playgama/sdk/api/advertisement/interstitial.md) — **required**. Hook into level transitions and game-over screens.
2. [**Rewarded**](/playgama/sdk/api/advertisement/rewarded.md) — add reward-for-watching loops: extra life, double coins, hint, skip. This usually has the highest eCPM because players opt in.
3. [**Banner**](/playgama/sdk/api/advertisement/banner.md) — fill idle screens. Start with `isBannerSupported`/`bannerState` to avoid layout glitches on platforms that don't support banners.
4. [**Advanced Banners**](/playgama/sdk/api/advertisement/advanced-banners.md) — use when default banner placement is not flexible enough.
5. [**AdBlock detection**](/playgama/sdk/api/advertisement/adblock.md) — optional, useful for fallback messaging.


---

# 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/api/advertisement.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.
