GoogleMobileAds Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
GAMInterstitialAd
Google Ad Manager interstitial ad, a full-screen advertisement shown at natural
transition points in your application such as between game levels or news stories.
-
Optional delegate that is notified when creatives send app events.
Declaration
Swift
weak var appEventDelegate: (any AppEventDelegate)? { get set }
-
Loads an interstitial ad.
Declaration
Swift
class func load(with adUnitID: String, request: AdManagerRequest?) async throws -> AdManagerInterstitialAd
Parameters
adUnitID
|
An ad unit ID created in the 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.
|
-
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.
[null,null,["Last updated 2025-08-20 UTC."],[[["\u003cp\u003e\u003ccode\u003eGAMInterstitialAd\u003c/code\u003e is a Google Ad Manager class used to display full-screen interstitial ads at natural transition points in an app.\u003c/p\u003e\n"],["\u003cp\u003eLoading an interstitial ad is achieved by calling \u003ccode\u003eload(withAdManagerAdUnitID:request:)\u003c/code\u003e and providing the ad unit ID and an optional \u003ccode\u003eGAMRequest\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eThe optional \u003ccode\u003eappEventDelegate\u003c/code\u003e property allows you to receive notifications when ad creatives send app events.\u003c/p\u003e\n"],["\u003cp\u003eThe method \u003ccode\u003eloadWithAdUnitID:request:completionHandler:\u003c/code\u003e is unavailable and undocumented for \u003ccode\u003eGAMInterstitialAd\u003c/code\u003e.\u003c/p\u003e\n"]]],["GAMInterstitialAd displays full-screen ads at app transition points. It uses an optional `appEventDelegate` to receive notifications from creatives. Ads are loaded using `loadWithAdManagerAdUnitID:request:completionHandler:` by providing an ad unit ID, an optional ad request, and a completion handler. Another method `loadWithAdUnitID:request:completionHandler:` is unavailable and undocumented. The primary loading method is asynchronous in Swift.\n"],null,["# GoogleMobileAds Framework Reference\n\nGAMInterstitialAd\n=================\n\n\n @interface GAMInterstitialAd : ../Classes/GADInterstitialAd.html\n\nGoogle Ad Manager interstitial ad, a full-screen advertisement shown at natural\ntransition points in your application such as between game levels or news stories.\n- `\n ``\n ``\n `\n\n ### [appEventDelegate](#/c:objc(cs)GAMInterstitialAd(py)appEventDelegate)\n\n `\n ` \n Optional delegate that is notified when creatives send app events. \n\n #### Declaration\n\n Swift \n\n weak var appEventDelegate: (any AppEventDelegate)? { get set }\n\n Objective-C \n\n @property (nonatomic, weak, nullable) id\u003c../Protocols/GADAppEventDelegate.html\u003e appEventDelegate;\n\n- `\n ``\n ``\n `\n\n ### [+loadWithAdManagerAdUnitID:request:completionHandler:](#/c:objc(cs)GAMInterstitialAd(cm)loadWithAdManagerAdUnitID:request:completionHandler:)\n\n `\n ` \n Loads an interstitial ad. \n\n #### Declaration\n\n Swift \n\n class func load(with adUnitID: String, request: AdManagerRequest?) async throws -\u003e AdManagerInterstitialAd\n\n Objective-C \n\n + (void)loadWithAdManagerAdUnitID:(nonnull NSString *)adUnitID\n request:(nullable ../Classes/GAMRequest.html *)request\n completionHandler:\n (nonnull ../Type-Definitions.html#/c:GAMInterstitialAd.h@T@GAMInterstitialAdLoadCompletionHandler)\n completionHandler;\n\n #### Parameters\n\n |---------------------------|---------------------------------------------------------------------|\n | ` `*adUnitID*` ` | An ad unit ID created in the Ad Manager UI. |\n | ` `*request*` ` | An ad request object. If nil, a default ad request object is used. |\n | ` `*completionHandler*` ` | A handler to execute when the load operation finishes or times out. |\n\n- `\n ``\n ``\n `\n\n ### [+loadWithAdUnitID:request:completionHandler:](#/c:objc(cs)GAMInterstitialAd(cm)loadWithAdUnitID:request:completionHandler:)\n\n `\n ` \n Unavailable \n Undocumented \n\n #### Declaration\n\n Objective-C \n\n + (void)loadWithAdUnitID:(nonnull NSString *)adUnitID\n request:(nullable ../Classes/GADRequest.html *)request\n completionHandler:\n (nonnull ../Type-Definitions.html#/c:GADInterstitialAd.h@T@GADInterstitialAdLoadCompletionHandler)completionHandler;"]]