GoogleMobileAds Framework Reference

  • GADBannerViewDelegate provides methods to handle ad request lifecycle events, such as receiving an ad or encountering an error.

  • It includes delegate methods to track ad impressions and clicks, allowing developers to monitor ad performance.

  • The delegate also offers methods to manage the presentation and dismissal of full-screen views triggered by ad interactions.

  • These methods provide developers with control over the ad experience, including pausing and resuming app activities during ad interactions.

  • The delegate uses GADBannerView instances to relay information about specific banner ad views.

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;