Turn your Playables into revenue with YouTube's built-in monetization.

1. [Understand](https://developers.google.com/youtube/gaming/playables/reference/monetization#understand_ads-based_monetization)
2. [Integrate](https://developers.google.com/youtube/gaming/playables/reference/monetization#integrate_with_ads-based_monetization)
3. [Test](https://developers.google.com/youtube/gaming/playables/reference/monetization#test_ads-based_monetization)
4. [Manage](https://developers.google.com/youtube/gaming/playables/reference/monetization#manage_ads-based_monetization)

## Understand ads-based monetization

YouTube offers built-in monetization functions for games, starting with ads. We
support three ad opportunities with your games:
Pre-roll ads Ads shown while your game is initially loading Automatic [Interstitial ads
Ads shown during a natural breakpoint within the game, such as level completion
Playables SDK](https://developers.google.com/youtube/gaming/playables/reference/monetization#integrate_interstitial_ads) [Rewarded ads
Ads that users opt into viewing in exchange for in-game items or experiences
Playables SDK](https://developers.google.com/youtube/gaming/playables/reference/monetization#integrate_rewarded_ads)

A subset of users in [Playables-eligible regions](https://support.google.com/youtube/answer/14328604) and platforms see these ad
slots.

We'll keep you updated as we continue to enhance and expand ads-based
monetization.

## Integrate with ads-based monetization

YouTube handles pre-roll ads automatically---no integration work is required on
your end.

While YouTube handles pre-roll ads automatically, you can implement interstitial
and rewarded ads in about 5 minutes using the [Playables SDK ads features](https://developers.google.com/youtube/gaming/playables/reference/sdk#ytgame.ads).

> [!TIP]
> **Tip:** **Handle errors gracefully**: Players will engage with your game across a wide range of devices and network conditions. Always implement fallback logic in your code to handle situations where an ad request fails.

### Prerequisites

Before integrating:

- Ensure you have access to the [Playables Test Suite](https://developers.google.com/youtube/gaming/playables/test_suite) to verify your integration.
- If your game uses TypeScript, ensure you have the latest [type definitions](https://www.youtube.com/playablesportal/static/youtube_ytgame_web_deploy_mpm_files/index.d.ts) to make integration easier.
- Check if [code samples](https://developers.google.com/youtube/gaming/playables/samples/oss_samples) are available that demonstrate how to integrate with YouTube Playables SDK.

### Integrate interstitial ads

Interstitial ads take just a minute to implement. Simply call
[`requestInterstitialAd()`](https://developers.google.com/youtube/gaming/playables/reference/sdk#ytgame.ads.requestInterstitialAd) at logical pauses in your gameplay, such as
**between levels** , after a "**Game Over** " screen, or during **mid-game
loading** sequences:

    try {
      await ytgame.ads.requestInterstitialAd();
      // Ad request successful
    } catch (error) {
      // Handle errors, retry logic, etc.
    }

### Integrate rewarded ads

Rewarded ads are equally quick to integrate. Call [`requestRewardedAd(id)`](https://developers.google.com/youtube/gaming/playables/reference/sdk#ytgame.ads.requestRewardedAd)
whenever a player explicitly requests a rewarded ad.

**You must select and pass a unique reward ID**. You can hard-code these IDs
directly into your game.

When creating your IDs, follow these requirements:

- **Do not** include any user data.
- **Do** use a readable string (e.g., `"100-coins-reward-12"`) or a standard UUID (e.g., `"21403813-2e22-4316-a8b2-7d4f52a6f6fb"`).

    try {
      const rewardEarned =
        await ytgame.ads.requestRewardedAd('reward-id-123');
      if (rewardEarned) {
        // Handle the earned case.
      } else {
        // Handle the not earned case.
      }
    } catch (error) {
      // Handle errors, retry logic, etc.
    }

For more information, review the [Playables SDK ads features](https://developers.google.com/youtube/gaming/playables/reference/sdk#ytgame.ads) for implementation
details and additional examples.

## Test ads-based monetization

Once you are ready, you can validate your integration using the
[Playables
Test Suite](https://developers.google.com/youtube/gaming/playables/test_suite). To learn how, follow the
[test suite
guide](https://developers.google.com/youtube/gaming/playables/reference/test_suite_guide).
[Test suite
guide](https://developers.google.com/youtube/gaming/playables/reference/test_suite_guide)

Ads are also enabled for development and staging game releases, though they are
limited to a subset of [Playables-eligible regions](https://support.google.com/youtube/answer/14328604) and platforms.

## Manage ads-based monetization

Once integrated, you can control some of these ad types for your game in
the [Playables Developer
Portal](https://www.youtube.com/playables_portal) if you need to toggle them off or on for testing or validation.
These ad types default to "on".
[Developer
Portal](https://www.youtube.com/playables_portal)

## Next steps

### Revenue sharing pilot

We are in the initial phase of Playables monetization. To get early
feedback, we are piloting revenue sharing with a select number of
Playable creators. We aim to align with the broader YouTube monetization
programs over time, enabling us to scale the number of creators who earn
from Playables monetization. We will share more information as the
program expands.

### Join the community

Want to discuss monetization, get help with your integration, or give
feedback? Join our
[Discord community](https://discord.gg/eEFBtMswKT).
[Join
Discord](https://discord.gg/eEFBtMswKT)