GoogleMobileAds Framework Reference

  • GADBannerViewDelegate provides delegate methods for receiving GADBannerView state change messages, including ad request status and ad click lifecycle.

  • Key methods include notifications for successful ad reception, ad request failure, ad impression recording, and ad click recording.

  • The delegate also handles notifications related to the presentation and dismissal of a full screen view in response to an ad click.

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;