GoogleMobileAds Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
GADCustomEventInterstitialDelegate
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
@protocol GADCustomEventInterstitialDelegate <NSObject>
Call back to this delegate in your custom event. You must call
customEventInterstitialDidReceiveAd: when there is an ad to show, or
customEventInterstitial:didFailAd: when there is no ad to show. Otherwise, if enough time passed
(several seconds) after the SDK called the requestInterstitialAdWithParameter: method of your
custom event, the mediation SDK will consider the request timed out, and move on to the next ad
network.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event object must call this when it receives or creates an interstitial ad.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event object must call this when it fails to receive or create the ad. Pass along
any error object sent from the ad network’s SDK, or an NSError describing the error. Pass nil if
not available.
Declaration
Objective-C
- (void)customEventInterstitial:
(nonnull id<GADCustomEventInterstitial>)customEvent
didFailAd:(nullable NSError *)error;
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event object should call this when the user touches or “clicks” the ad to initiate
an action. When the SDK receives this callback, it reports the click back to the mediation
server.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event should call this when the interstitial is being displayed.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event should call this when the interstitial is about to be dismissed.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Your Custom Event should call this when the interstitial has been dismissed.
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Deprecated. Use customEventInterstitialDidReceiveAd:.
Declaration
Objective-C
- (void)customEventInterstitial:
(nonnull id<GADCustomEventInterstitial>)customEvent
didReceiveAd:(nonnull NSObject *)ad;
-
Deprecated
Use GADMediationInterstitialAdEventDelegate instead.
Deprecated. No replacement.
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\u003eGADCustomEventInterstitialDelegate\u003c/code\u003e is deprecated and developers should use \u003ccode\u003eGADMediationInterstitialAdEventDelegate\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003eThis delegate handles callbacks for custom events in interstitial ads, such as receiving, failing to receive, clicking, presenting, and dismissing ads.\u003c/p\u003e\n"],["\u003cp\u003eKey methods include \u003ccode\u003ecustomEventInterstitialDidReceiveAd:\u003c/code\u003e, \u003ccode\u003ecustomEventInterstitial:didFailAd:\u003c/code\u003e, \u003ccode\u003ecustomEventInterstitialWasClicked:\u003c/code\u003e, \u003ccode\u003ecustomEventInterstitialWillPresent:\u003c/code\u003e, and \u003ccode\u003ecustomEventInterstitialDidDismiss:\u003c/code\u003e, all of which are deprecated.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated methods like \u003ccode\u003ecustomEventInterstitial:didReceiveAd:\u003c/code\u003e and \u003ccode\u003ecustomEventInterstitialWillLeaveApplication:\u003c/code\u003e have either been replaced or have no replacement.\u003c/p\u003e\n"]]],["The `GADCustomEventInterstitialDelegate` is deprecated in favor of `GADMediationInterstitialAdEventDelegate`. When implementing a custom event, it should call `customEventInterstitialDidReceiveAd:` if an ad is available or `customEventInterstitial:didFailAd:` if not. Upon user interaction, methods like `customEventInterstitialWasClicked:` are called. For display transitions, `customEventInterstitialWillPresent:`, `customEventInterstitialWillDismiss:`, and `customEventInterstitialDidDismiss:` are triggered. The `customEventInterstitial:didReceiveAd:` and `customEventInterstitialWillLeaveApplication:` are also deprecated.\n"],null,["GADCustomEventInterstitialDelegate \nDeprecated\n\nUse GADMediationInterstitialAdEventDelegate instead. \n\n @protocol GADCustomEventInterstitialDelegate \u003cNSObject\u003e\n\nCall back to this delegate in your custom event. You must call\ncustomEventInterstitialDidReceiveAd: when there is an ad to show, or\ncustomEventInterstitial:didFailAd: when there is no ad to show. Otherwise, if enough time passed\n(several seconds) after the SDK called the requestInterstitialAdWithParameter: method of your\ncustom event, the mediation SDK will consider the request timed out, and move on to the next ad\nnetwork.\n- `\n ``\n ``\n `\n\n [-customEventInterstitialDidReceiveAd:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialDidReceiveAd:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event object must call this when it receives or creates an interstitial ad. \n\n Declaration \n Swift \n\n func customEventInterstitialDidReceiveAd(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialDidReceiveAd:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitial:didFailAd:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitial:didFailAd:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event object must call this when it fails to receive or create the ad. Pass along\n any error object sent from the ad network's SDK, or an NSError describing the error. Pass nil if\n not available. \n\n Declaration \n Swift \n\n func customEventInterstitial(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html, didFailAd error: (any Error)?)\n\n Objective-C \n\n - (void)customEventInterstitial:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent\n didFailAd:(nullable NSError *)error;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitialWasClicked:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialWasClicked:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event object should call this when the user touches or \"clicks\" the ad to initiate\n an action. When the SDK receives this callback, it reports the click back to the mediation\n server. \n\n Declaration \n Swift \n\n func customEventInterstitialWasClicked(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialWasClicked:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitialWillPresent:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialWillPresent:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event should call this when the interstitial is being displayed. \n\n Declaration \n Swift \n\n func customEventInterstitialWillPresent(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialWillPresent:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitialWillDismiss:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialWillDismiss:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event should call this when the interstitial is about to be dismissed. \n\n Declaration \n Swift \n\n func customEventInterstitialWillDismiss(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialWillDismiss:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitialDidDismiss:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialDidDismiss:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Your Custom Event should call this when the interstitial has been dismissed. \n\n Declaration \n Swift \n\n func customEventInterstitialDidDismiss(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialDidDismiss:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;\n\n[Deprecated](#/Deprecated)\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitial:didReceiveAd:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitial:didReceiveAd:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Deprecated. Use customEventInterstitialDidReceiveAd:. \n\n Declaration \n Swift \n\n func customEventInterstitial(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html, didReceiveAd ad: NSObject)\n\n Objective-C \n\n - (void)customEventInterstitial:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent\n didReceiveAd:(nonnull NSObject *)ad;\n\n- `\n ``\n ``\n `\n\n [-customEventInterstitialWillLeaveApplication:](#/c:objc(pl)GADCustomEventInterstitialDelegate(im)customEventInterstitialWillLeaveApplication:)`\n ` \n Deprecated\n\n Use GADMediationInterstitialAdEventDelegate instead. \n Deprecated. No replacement. \n\n Declaration \n Swift \n\n func customEventInterstitialWillLeaveApplication(_ customEvent: any ../Protocols/GADCustomEventInterstitial.html)\n\n Objective-C \n\n - (void)customEventInterstitialWillLeaveApplication:\n (nonnull id\u003c../Protocols/GADCustomEventInterstitial.html\u003e)customEvent;"]]