lpw
2024-06-24 96fe7669fe8da0110590467e2e95ad88c0149112
commit | author | age
96fe76 1 //
L 2 //  GADCustomEventInterstitialDelegate.h
3 //  Google Mobile Ads SDK
4 //
5 //  Copyright 2012 Google LLC. All rights reserved.
6 //
7
8 #import <Foundation/Foundation.h>
9 #import <GoogleMobileAds/GoogleMobileAdsDefines.h>
10
11 @protocol GADCustomEventInterstitial;
12
13 /// Call back to this delegate in your custom event. You must call
14 /// customEventInterstitialDidReceiveAd: when there is an ad to show, or
15 /// customEventInterstitial:didFailAd: when there is no ad to show. Otherwise, if enough time passed
16 /// (several seconds) after the SDK called the requestInterstitialAdWithParameter: method of your
17 /// custom event, the mediation SDK will consider the request timed out, and move on to the next ad
18 /// network.
19 GAD_DEPRECATED_MSG_ATTRIBUTE("Use GADMediationInterstitialAdEventDelegate instead.")
20 @protocol GADCustomEventInterstitialDelegate <NSObject>
21
22 /// Your Custom Event object must call this when it receives or creates an interstitial ad.
23 - (void)customEventInterstitialDidReceiveAd:(nonnull id<GADCustomEventInterstitial>)customEvent;
24
25 /// Your Custom Event object must call this when it fails to receive or create the ad. Pass along
26 /// any error object sent from the ad network's SDK, or an NSError describing the error. Pass nil if
27 /// not available.
28 - (void)customEventInterstitial:(nonnull id<GADCustomEventInterstitial>)customEvent
29                       didFailAd:(nullable NSError *)error;
30
31 /// Your Custom Event object should call this when the user touches or "clicks" the ad to initiate
32 /// an action. When the SDK receives this callback, it reports the click back to the mediation
33 /// server.
34 - (void)customEventInterstitialWasClicked:(nonnull id<GADCustomEventInterstitial>)customEvent;
35
36 // When you call any of the following methods, the call will be propagated back to the
37 // GADInterstitialDelegate that you implemented and passed to GADInterstitial.
38
39 /// Your Custom Event should call this when the interstitial is being displayed.
40 - (void)customEventInterstitialWillPresent:(nonnull id<GADCustomEventInterstitial>)customEvent;
41
42 /// Your Custom Event should call this when the interstitial is about to be dismissed.
43 - (void)customEventInterstitialWillDismiss:(nonnull id<GADCustomEventInterstitial>)customEvent;
44
45 /// Your Custom Event should call this when the interstitial has been dismissed.
46 - (void)customEventInterstitialDidDismiss:(nonnull id<GADCustomEventInterstitial>)customEvent;
47
48 #pragma mark Deprecated
49
50 /// Deprecated. Use customEventInterstitialDidReceiveAd:.
51 - (void)customEventInterstitial:(nonnull id<GADCustomEventInterstitial>)customEvent
52                    didReceiveAd:(nonnull NSObject *)ad
53     GAD_DEPRECATED_MSG_ATTRIBUTE("Use customEventInterstitialDidReceiveAd:.");
54
55 /// Deprecated. No replacement.
56 - (void)customEventInterstitialWillLeaveApplication:
57     (nonnull id<GADCustomEventInterstitial>)customEvent
58     GAD_DEPRECATED_MSG_ATTRIBUTE("Deprecated. No replacement.");
59
60 @end