To discuss and provide feedback on our products, join the official AdMob Discord channel in the Google Advertising and Measurement Community server.

GoogleMobileAds Framework Reference

  • GADRewardedInterstitialAd is a full-screen ad type that rewards users with in-app items for watching, without requiring user opt-in.

  • Key properties include adUnitID, responseInfo, adReward, serverSideVerificationOptions, fullScreenContentDelegate, paidEventHandler, and placementID.

  • Rewarded interstitial ads can be loaded using an ad unit ID or a server-to-server ad response string.

  • Before presenting, you can check if the ad can be presented from a root view controller using canPresentFromRootViewController:error:.

  • The ad is presented using presentFromRootViewController:userDidEarnRewardHandler:, and a handler is executed when the user earns a reward.

GADRewardedInterstitialAd


@interface GADRewardedInterstitialAd
 : NSObject <GADAdMetadataProvider, GADFullScreenPresentingAd>

A rewarded interstitial ad. Rewarded Interstitial ads are full screen ads that can be presented without user-opt in and allow you to reward the user with in-app items.

  • The ad unit ID.

    Declaration

    Swift

    var adUnitID: String { get }

    Objective-C

    @property (nonatomic, readonly, nonnull) NSString *adUnitID;

  • Information about the ad response that returned the ad.

    Declaration

    Swift

    var responseInfo: ResponseInfo { get }

    Objective-C

    @property (nonatomic, readonly, nonnull) GADResponseInfo *responseInfo;

  • The reward earned by the user for interacting with the ad.

    Declaration

    Swift

    var adReward: AdReward { get }

    Objective-C

    @property (nonatomic, readonly, nonnull) GADAdReward *adReward;

  • Options specified for server-side user reward verification. Must be set before presenting this ad.

    Declaration

    Swift

    @NSCopying var serverSideVerificationOptions: ServerSideVerificationOptions? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) GADServerSideVerificationOptions *serverSideVerificationOptions;

  • Delegate for handling full screen content messages.

    Declaration

    Swift

    weak var fullScreenContentDelegate: (any FullScreenContentDelegate)? { get set }

    Objective-C

    @property (nonatomic, weak, nullable) id<GADFullScreenContentDelegate> fullScreenContentDelegate;

  • Called when the ad is estimated to have earned money. Available for allowlisted accounts only.

    Declaration

    Swift

    var paidEventHandler: GADPaidEventHandler? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) GADPaidEventHandler paidEventHandler;

  • An identifier for a placement in reporting. This property must be set prior to presenting the ad.

    Declaration

    Swift

    var placementID: Int64 { get set }

    Objective-C

    @property (nonatomic) int64_t placementID;

  • Loads a rewarded interstitial ad.

    Declaration

    Swift

    class func load(with adUnitID: String, request: Request?) async throws -> RewardedInterstitialAd

    Objective-C

    + (void)loadWithAdUnitID:(nonnull NSString *)adUnitID
 request:(nullable GADRequest *)request
 completionHandler:
 (nonnull GADRewardedInterstitialAdLoadCompletionHandler)
 completionHandler;

    Parameters

    adUnitID

    An ad unit ID created in the AdMob or Ad Manager UI.

    request

    An ad request object. If nil, a default ad request object is used.

    completionHandler

    A handler to execute when the load operation finishes or times out.

  • Loads a rewarded interstitial ad.

    Declaration

    Swift

    class func load(with adResponseString: String) async throws -> RewardedInterstitialAd

    Objective-C

    + (void)loadWithAdResponseString:(nonnull NSString *)adResponseString
 completionHandler:
 (nonnull GADRewardedInterstitialAdLoadCompletionHandler)
 completionHandler;

    Parameters

    adResponseString

    A server-to-server ad response string.

    completionHandler

    A handler to execute when the load operation finishes or times out.

  • Indicates whether the rewarded interstitial ad can be presented from the provided root view controller. Must be called on the main thread.

    Declaration

    Swift

    @MainActor func canPresent(from rootViewController: UIViewController?) throws

    Objective-C

    - (BOOL)canPresentFromRootViewController:
 (nullable UIViewController *)rootViewController
 error:(NSError *_Nullable *_Nullable)error;

    Return Value

    YES if the rewarded interstitial ad can be presented from the provided root view controller, NO otherwise.

  • Presents the rewarded interstitial ad. Must be called on the main thread.

    Declaration

    Swift

    @MainActor func present(from viewController: UIViewController?, userDidEarnRewardHandler: @escaping GADUserDidEarnRewardHandler)

    Objective-C

    - (void)presentFromRootViewController:
 (nullable UIViewController *)viewController
 userDidEarnRewardHandler:
 (nonnull GADUserDidEarnRewardHandler)userDidEarnRewardHandler;

    Parameters

    viewController

    A view controller to present the ad. If nil, attempts to present from the top view controller of the application’s main window.

    userDidEarnRewardHandler

    A handler to execute when the user earns a reward. adReward contains the reward information.

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 2025年08月20日 UTC.