Skip to content

Rewarded

Rewarded ads allow users to choose to watch a fullscreen advertisement in exchange for a clearly defined in-application reward.

They are best suited to optional reward opportunities such as extra currency, additional lives, temporary bonuses, or another attempt after failure. The user should understand what reward will be granted before the ad is shown.

The general initialization and loading workflow is described in Basic Usage. This page focuses on rewarded-specific behavior and reward handling.

Reward Handling

Grant the reward only from On Reward Earned.

This callback confirms that the native advertising SDK reported the reward and provides:

  • Amount — the numeric reward amount configured for the Ad Unit in AdMob.
  • Reward Type — the reward name configured for the Ad Unit in AdMob.

Use these values directly or map them to your own gameplay reward system.

Important

Do not grant the reward from On Started, On Completed, or a fullscreen event.

On Completed only confirms that the ad was closed or finished displaying. It does not confirm that the reward was earned.

The reward callback and the completion callback are independent. Depending on the native ad flow, On Reward Earned may be received before the ad closes.

Your reward logic should therefore handle the reward once and should not depend on a specific callback order.

User Choice

Rewarded ads should be presented as an optional action initiated by the user.

Before showing the ad, clearly communicate:

  • that an advertisement will be shown;
  • what reward the user will receive;
  • which action starts the ad.

If no rewarded ad is ready, do not block the user or remove an already earned gameplay benefit. Disable the reward action, show that the ad is unavailable, or allow the user to continue without the optional reward.

Loading and Reuse

A rewarded ad must be loaded before it can be shown.

Wait for On Loaded before calling Show Rewarded. You can also use Is Rewarded Ready when the application needs to check whether an ad is currently available.

A loaded rewarded ad can be shown only once. After it has been displayed, a new ad must be loaded before the next reward opportunity.

Load rewarded ads in advance so that the user does not need to wait after selecting the reward option.

Note

A successful load does not guarantee that the ad will remain available indefinitely. Check the current state before showing if there may be a long delay between loading and display.

Display Options

Auto Reload automatically requests another rewarded ad with the same Ad Unit ID after the current ad is closed. When disabled, load the next ad manually.

Immersive Mode requests fullscreen presentation with system interface elements hidden where supported. Its exact behavior depends on the platform and device.

Auto Reload only prepares the next ad. It does not display another rewarded ad automatically or grant another reward.

Callbacks and Events

The rewarded show function provides several callbacks:

  • On Started — the ad began displaying.
  • On Completed — the ad was closed or finished displaying.
  • On Reward Earned — the native SDK reported that the reward was earned.
  • On Failure — the ad could not be shown.
  • On Event — reports click and impression events through EFullScreenAdEventType.

Use On Started and On Completed when the application needs to pause and restore gameplay, audio, input, or other systems around the fullscreen ad.

If On Failure is triggered, do not grant the reward. Restore the application state and allow the user to retry later if appropriate.

Application State

A rewarded ad temporarily takes control of the screen.

Before showing it, consider pausing:

  • active gameplay;
  • timers that should not progress while the ad is visible;
  • player input;
  • game audio, when appropriate.

Restore the required state from both On Completed and On Failure.

Keep reward delivery separate from application state restoration. The application may need to resume even when no reward was earned.

For a reliable rewarded implementation:

  1. Define the reward clearly before presenting the option.
  2. Load the ad before the reward opportunity becomes available.
  3. Wait for On Loaded or verify Is Rewarded Ready.
  4. Show the ad only after a deliberate user action.
  5. Grant the reward once, and only from On Reward Earned.
  6. Restore the application state from both On Completed and On Failure.
  7. Load the next ad manually or enable Auto Reload.

Do not make essential progression depend exclusively on the availability of a rewarded ad.

For exact function signatures and callback parameters, see AdMob API.

For fullscreen events and error values, see Enumerations.

For official Android and iOS demo Ad Unit IDs, see Testing.