GoogleMobileAds Framework Reference

GADBannerViewDelegate

@protocol GADBannerViewDelegate <NSObject>

Delegate methods for receiving GADBannerView state change messages such as ad request status and ad click lifecycle.

Ad Request Lifecycle Notifications

  • Tells the delegate that an ad request successfully received an ad. The delegate may want to add the banner view to the view hierarchy if it hasn’t been added yet.

    Declaration

    Swift

    @MainActor optional func bannerViewDidReceiveAd(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewDidReceiveAd:(nonnull GADBannerView *)bannerView;

  • Tells the delegate that an ad request failed. The failure is normally due to network connectivity or ad availability (for example, no fill).

    Declaration

    Swift

    @MainActor optional func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: any Error)

    Objective-C

    - (void)bannerView:(nonnull GADBannerView *)bannerView
    didFailToReceiveAdWithError:(nonnull NSError *)error;

  • Tells the delegate that an impression has been recorded for an ad.

    Declaration

    Swift

    @MainActor optional func bannerViewDidRecordImpression(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewDidRecordImpression:(nonnull GADBannerView *)bannerView;

  • Tells the delegate that a click has been recorded for the ad.

    Declaration

    Swift

    @MainActor optional func bannerViewDidRecordClick(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewDidRecordClick:(nonnull GADBannerView *)bannerView;

Click-Time Lifecycle Notifications

  • Tells the delegate that a full screen view will be presented in response to the user clicking on an ad. The delegate may want to pause animations and time sensitive interactions.

    Declaration

    Swift

    @MainActor optional func bannerViewWillPresentScreen(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewWillPresentScreen:(nonnull GADBannerView *)bannerView;

  • Tells the delegate that the full screen view will be dismissed.

    Declaration

    Swift

    @MainActor optional func bannerViewWillDismissScreen(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewWillDismissScreen:(nonnull GADBannerView *)bannerView;

  • Tells the delegate that the full screen view has been dismissed. The delegate should restart anything paused while handling bannerViewWillPresentScreen:.

    Declaration

    Swift

    @MainActor optional func bannerViewDidDismissScreen(_ bannerView: GADBannerView)

    Objective-C

    - (void)bannerViewDidDismissScreen:(nonnull GADBannerView *)bannerView;