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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["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;"]]
