lpw
2024-06-24 96fe7669fe8da0110590467e2e95ad88c0149112
commit | author | age
96fe76 1 //
L 2 //  GADBannerViewDelegate.h
3 //  Google Mobile Ads SDK
4 //
5 //  Copyright 2011 Google LLC. All rights reserved.
6 //
7
8 #import <Foundation/Foundation.h>
9
10 @class GADBannerView;
11
12 /// Delegate methods for receiving GADBannerView state change messages such as ad request status
13 /// and ad click lifecycle.
14 @protocol GADBannerViewDelegate <NSObject>
15
16 @optional
17
18 #pragma mark Ad Request Lifecycle Notifications
19
20 /// Tells the delegate that an ad request successfully received an ad. The delegate may want to add
21 /// the banner view to the view hierarchy if it hasn't been added yet.
22 - (void)bannerViewDidReceiveAd:(nonnull GADBannerView *)bannerView;
23
24 /// Tells the delegate that an ad request failed. The failure is normally due to network
25 /// connectivity or ad availablility (for example, no fill).
26 - (void)bannerView:(nonnull GADBannerView *)bannerView
27     didFailToReceiveAdWithError:(nonnull NSError *)error;
28
29 /// Tells the delegate that an impression has been recorded for an ad.
30 - (void)bannerViewDidRecordImpression:(nonnull GADBannerView *)bannerView;
31
32 /// Tells the delegate that a click has been recorded for the ad.
33 - (void)bannerViewDidRecordClick:(nonnull GADBannerView *)bannerView;
34
35 #pragma mark Click-Time Lifecycle Notifications
36
37 /// Tells the delegate that a full screen view will be presented in response to the user clicking on
38 /// an ad. The delegate may want to pause animations and time sensitive interactions.
39 - (void)bannerViewWillPresentScreen:(nonnull GADBannerView *)bannerView;
40
41 /// Tells the delegate that the full screen view will be dismissed.
42 - (void)bannerViewWillDismissScreen:(nonnull GADBannerView *)bannerView;
43
44 /// Tells the delegate that the full screen view has been dismissed. The delegate should restart
45 /// anything paused while handling bannerViewWillPresentScreen:.
46 - (void)bannerViewDidDismissScreen:(nonnull GADBannerView *)bannerView;
47
48 @end