Rewarded interstitial ads

Page Summary

Rewarded interstitial ads offer rewards for ads displayed during natural app transitions without requiring user opt-in.
Integrating rewarded interstitial ads involves loading an ad, optionally validating SSV callbacks, registering for callbacks, displaying the ad, and handling the reward event.
You must present an intro screen before displaying a rewarded interstitial ad that provides clear reward messaging and an option to skip the ad.
When presenting the ad, you need a GADUserDidEarnRewardHandler object to manage the user's reward.

Rewarded interstitial is a type of incentivized ad format that allows you offer rewards for ads that appear automatically during natural app transitions. Unlike rewarded ads, users aren't required to opt-in to view a rewarded interstitial.

Prerequisites

Before you continue, set up Google Mobile Ads SDK .

Implementation

The primary steps to integrate rewarded interstitial ads are as follows:

Load an ad
[Optional] Validate SSV callbacks
Register for callbacks
Display the ad and handle the reward event

Load an ad

Loading an ad is accomplished using the load(adUnitID:request) method on the GADRewardedInterstitialAd class.

Swift

  func 
  
 loadAdManagerRewardedInterstitialAd 
 () 
  
 async 
  
 { 
  
 do 
  
 { 
  
 rewardedInterstitialAd 
  
 = 
  
 try 
  
 await 
  
 RewardedInterstitialAd 
 . 
 load 
 ( 
  
 // Replace this ad unit ID with your own ad unit ID. 
  
 with 
 : 
  
 " adUnitID 
" 
 , 
  
 request 
 : 
  
 AdManagerRequest 
 ()) 
  
 rewardedInterstitialAd 
 ?. 
 fullScreenContentDelegate 
  
 = 
  
 self 
  
 } 
  
 catch 
  
 { 
  
 print 
 ( 
 "Rewarded ad failed to load with error: 
 \( 
 error 
 . 
 localizedDescription 
 ) 
 " 
 ) 
  
 } 
 } 
   RewardedInterstitialAdSnippets 
 . 
 swift

SwiftUI

  import 
  
 GoogleMobileAds 
 class 
  
 RewardedInterstitialViewModel 
 : 
  
 NSObject 
 , 
  
 ObservableObject 
 , 
  
 FullScreenContentDelegate 
 { 
  
 @ 
 Published 
  
 var 
  
 coins 
  
 = 
  
 0 
  
 private 
  
 var 
  
 rewardedInterstitialAd 
 : 
  
 RewardedInterstitialAd 
 ? 
  
 func 
  
 loadAd 
 () 
  
 async 
  
 { 
  
 do 
  
 { 
  
 rewardedInterstitialAd 
  
 = 
  
 try 
  
 await 
  
 RewardedInterstitialAd 
 . 
 load 
 ( 
  
 with 
 : 
  
 "ca-app-pub-3940256099942544/6978759866" 
 , 
  
 request 
 : 
  
 Request 
 ()) 
  
 rewardedInterstitialAd 
 ?. 
 fullScreenContentDelegate 
  
 = 
  
 self 
  
 } 
  
 catch 
  
 { 
  
 print 
 ( 
  
 "Failed to load rewarded interstitial ad with error: 
 \( 
 error 
 . 
 localizedDescription 
 ) 
 " 
 ) 
  
 } 
  
 } 
   RewardedInterstitialViewModel 
 . 
 swift

Objective-C

  - 
 ( 
 void 
 ) 
 loadAdManagerRewardedInterstitialAd 
  
 { 
  
 [ 
 GADRewardedInterstitialAd 
  
 loadWithAdUnitID 
 : 
 " adUnitID 
" 
  
 request 
 :[ 
 GAMRequest 
  
 request 
 ] 
  
 completionHandler 
 : 
 ^ 
 ( 
 GADRewardedInterstitialAd 
  
 * 
 ad 
 , 
  
 NSError 
  
 * 
 error 
 ) 
  
 { 
  
 if 
  
 ( 
 error 
 ) 
  
 { 
  
 NSLog 
 ( 
 @"Failed to load rewarded interstitial ad with error: %@" 
 , 
  
 error 
 . 
 localizedDescription 
 ); 
  
 return 
 ; 
  
 } 
  
 self 
 . 
 rewardedInterstitialAd 
  
 = 
  
 ad 
 ; 
  
 self 
 . 
 rewardedInterstitialAd 
 . 
 fullScreenContentDelegate 
  
 = 
  
 self 
 ; 
  
 }]; 
 } 
   RewardedInterstitialAdSnippets 
 . 
 m

Replace adUnitID with your ad unit ID.

[Optional] Validate server-side verification (SSV) callbacks

Apps that require extra data in server-side verification callbacks should use the custom data feature of rewarded ads. Any string value set on a rewarded ad object is passed to the custom_data query parameter of the SSV callback. If no custom data value is set, the custom_data query parameter value won't be present in the SSV callback.

The following code sample demonstrates how to set custom data on a rewarded interstitial ad object before requesting an ad.

Swift

  private 
  
 func 
  
 validateAdManagerServerSideVerification 
 () 
  
 async 
  
 { 
  
 do 
  
 { 
  
 rewardedInterstitialAd 
  
 = 
  
 try 
  
 await 
  
 RewardedInterstitialAd 
 . 
 load 
 ( 
  
 // Replace this ad unit ID with your own ad unit ID. 
  
 with 
 : 
  
 " adUnitID 
" 
 , 
  
 request 
 : 
  
 AdManagerRequest 
 ()) 
  
 let 
  
 options 
  
 = 
  
 ServerSideVerificationOptions 
 () 
  
 options 
 . 
 customRewardText 
  
 = 
  
 "" 
  SAMPLE_CUSTOM_DATA_STRING 
 
 "" 
  
 rewardedInterstitialAd 
 ?. 
 serverSideVerificationOptions 
  
 = 
  
 options 
  
 } 
  
 catch 
  
 { 
  
 print 
 ( 
 "Rewarded ad failed to load with error: 
 \( 
 error 
 . 
 localizedDescription 
 ) 
 " 
 ) 
  
 } 
 } 
   RewardedInterstitialAdSnippets 
 . 
 swift

Objective-C

  - 
 ( 
 void 
 ) 
 validateAdManagerServerSideVerification 
  
 { 
  
 // Replace this ad unit ID with your own ad unit ID. 
  
 [ 
 GADRewardedInterstitialAd 
  
 loadWithAdUnitID 
 : 
 " adUnitID 
" 
  
 request 
 :[ 
 GAMRequest 
  
 request 
 ] 
  
 completionHandler 
 : 
 ^ 
 ( 
 GADRewardedInterstitialAd 
  
 * 
 ad 
 , 
  
 NSError 
  
 * 
 error 
 ) 
  
 { 
  
 if 
  
 ( 
 error 
 ) 
  
 { 
  
 NSLog 
 ( 
 @"Rewarded interstitial ad failed to load with error: %@" 
 , 
  
 error 
 . 
 localizedDescription 
 ); 
  
 return 
 ; 
  
 } 
  
 self 
 . 
 rewardedInterstitialAd 
  
 = 
  
 ad 
 ; 
  
 GADServerSideVerificationOptions 
  
 * 
 options 
  
 = 
  
 [[ 
 GADServerSideVerificationOptions 
  
 alloc 
 ] 
  
 init 
 ]; 
  
 options 
 . 
 customRewardString 
  
 = 
  
 @"" 
  SAMPLE_CUSTOM_DATA_STRING 
 
 "" 
 ; 
  
 ad 
 . 
 serverSideVerificationOptions 
  
 = 
  
 options 
 ; 
  
 }]; 
 } 
   RewardedInterstitialAdSnippets 
 . 
 m

Replace SAMPLE_CUSTOM_DATA_STRING with your custom data.

Register for callbacks

To receive notifications for presentation events, you must assign the GADFullScreenContentDelegate to the fullScreenContentDelegate property of the returned ad:

Swift

  rewardedInterstitialAd 
 ?. 
 fullScreenContentDelegate 
  
 = 
  
 self  RewardedInterstitialAdSnippets 
 
 
 . 
 swift

func adDidRecordImpression ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called." ) } func adDidRecordClick ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called." ) } func adWillPresentFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called." ) } func adWillDismissFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called." ) } func adDidDismissFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called." ) // Clear the rewarded interstitial ad. rewardedInterstitialAd = nil } func ad ( _ ad : FullScreenPresentingAd , didFailToPresentFullScreenContentWithError error : Error ) { print ( " \( #function ) called with error: \( error . localizedDescription ) ." ) } RewardedInterstitialAdSnippets . swift

func adDidRecordImpression ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called" ) } func adDidRecordClick ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called" ) } func ad ( _ ad : FullScreenPresentingAd , didFailToPresentFullScreenContentWithError error : Error ) { print ( " \( #function ) called" ) } func adWillPresentFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called" ) } func adWillDismissFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called" ) } func adDidDismissFullScreenContent ( _ ad : FullScreenPresentingAd ) { print ( " \( #function ) called" ) // Clear the rewarded interstitial ad. rewardedInterstitialAd = nil } RewardedInterstitialViewModel . swift

- ( void ) adDidRecordImpression: ( id<GADFullScreenPresentingAd> ) ad { NSLog ( @"%s called" , __PRETTY_FUNCTION__ ); } - ( void ) adDidRecordClick: ( id<GADFullScreenPresentingAd> ) ad { NSLog ( @"%s called" , __PRETTY_FUNCTION__ ); } - ( void ) adWillPresentFullScreenContent: ( id<GADFullScreenPresentingAd> ) ad { NSLog ( @"%s called" , __PRETTY_FUNCTION__ ); } - ( void ) adWillDismissFullScreenContent: ( id<GADFullScreenPresentingAd> ) ad { NSLog ( @"%s called" , __PRETTY_FUNCTION__ ); } - ( void ) adDidDismissFullScreenContent: ( id<GADFullScreenPresentingAd> ) ad { NSLog ( @"%s called" , __PRETTY_FUNCTION__ ); // Clear the rewarded interstitial ad. self . rewardedInterstitialAd = nil ; } - ( void ) ad: ( id ) ad didFailToPresentFullScreenContentWithError: ( NSError * ) error { NSLog ( @"%s called with error: %@" , __PRETTY_FUNCTION__ , error . localizedDescription ); } RewardedInterstitialAdSnippets . m

func showRewardedInterstitialAd () { guard let rewardedInterstitialAd = rewardedInterstitialAd else { return print ( "Ad wasn't ready." ) } // The UIViewController parameter is an optional. rewardedInterstitialAd . present ( from : nil ) { let reward = rewardedInterstitialAd . adReward print ( "Reward received with currency \( reward . amount ) , amount \( reward . amount . doubleValue ) " ) // TODO: Reward the user. } } RewardedInterstitialAdSnippets . swift

var rewardedInterstitialBody : some View { // ... } . onChange ( of : showAd , perform : { newValue in if newValue { viewModel . showAd () } } ) RewardedInterstitialContentView . swift

func showAd () { guard let rewardedInterstitialAd = rewardedInterstitialAd else { return print ( "Ad wasn't ready." ) } rewardedInterstitialAd . present ( from : nil ) { let reward = rewardedInterstitialAd . adReward print ( "Reward amount: \( reward . amount ) " ) self . addCoins ( reward . amount . intValue ) } } RewardedInterstitialViewModel . swift

- ( void ) showRewardedInterstitialAd { [ self . rewardedInterstitialAd presentFromRootViewController : self userDidEarnRewardHandler : ^ { GADAdReward * reward = self . rewardedInterstitialAd . adReward ; NSString * rewardMessage = [ NSString stringWithFormat : @"Reward received with " @"currency %@ , amount %ld" , reward . type , [ reward . amount longValue ]]; NSLog ( @"%@" , rewardMessage ); // TODO: Reward the user. }]; } RewardedInterstitialAdSnippets . m

Next steps

Learn more about user privacy .

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-04-01 UTC.

Rewarded interstitial ads Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Prerequisites

Implementation

Load an ad

Swift

SwiftUI

Objective-C

[Optional] Validate server-side verification (SSV) callbacks

Swift

Objective-C

Register for callbacks

Swift

SwiftUI

Objective-C

Swift

SwiftUI

Objective-C

Display the ad and handle the reward event

Swift

SwiftUI

Objective-C

Examples on GitHub

Next steps

Rewarded interstitial ads