> For the complete documentation index, see [llms.txt](https://wiki.playgama.com/playgama/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.playgama.com/playgama/bridge-sdk/api/advertisement.md).

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

## Recommended integration order

1. [**Interstitial**](/playgama/bridge-sdk/api/advertisement/interstitial.md) — **required**. Hook into level transitions and game-over screens.
2. [**Rewarded**](/playgama/bridge-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/bridge-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/bridge-sdk/api/advertisement/advanced-banners.md) — use when default banner placement is not flexible enough.
5. [**AdBlock detection**](/playgama/bridge-sdk/api/advertisement/adblock.md) — optional, useful for fallback messaging.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wiki.playgama.com/playgama/bridge-sdk/api/advertisement.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.