Blog Studio Go to console

GoogleMobileAds Framework Reference

GADCustomEventBannerDelegate

@protocol GADCustomEventBannerDelegate <NSObject>

Call back to this delegate in your custom event. You must call customEventBanner:didReceiveAd: when there is an ad to show, or customEventBanner:didFailAd: when there is no ad to show. Otherwise, if enough time passed (several seconds) after the SDK called the requestBannerAd: method of your custom event, the mediation SDK will consider the request timed out, and move on to the next ad network.

  • Your Custom Event object must call this when it receives or creates an ad view.

    Declaration

    Objective-C

    - (void)customEventBanner:(nonnull id<GADCustomEventBanner>)customEvent
             didReceiveAd:(nonnull UIView *)view;

  • Your Custom Event object must call this when it fails to receive or create the ad view. Pass along any error object sent from the ad network’s SDK, or an NSError describing the error. Pass nil if not available.

    Declaration

    Objective-C

    - (void)customEventBanner:(nonnull id<GADCustomEventBanner>)customEvent
                didFailAd:(nullable NSError *)error;

  • Your Custom Event object should call this when the user touches or clicks the ad to initiate an action. When the SDK receives this callback, it reports the click back to the mediation server.

    Declaration

    Objective-C

    - (void)customEventBannerWasClicked:
    (nonnull id<GADCustomEventBanner>)customEvent;

  • The rootViewController that you set in GADBannerView. Use this UIViewController to show a modal view when a user taps on the ad.

    Declaration

    Objective-C

    @property (readonly, nonatomic)
    UIViewController *_Nonnull viewControllerForPresentingModalView;

  • Your Custom Event should call this when the user taps an ad and a modal view appears.

    Declaration

    Objective-C

    - (void)customEventBannerWillPresentModal:
    (nonnull id<GADCustomEventBanner>)customEvent;

  • Your Custom Event should call this when the user dismisses the modal view and the modal view is about to go away.

    Declaration

    Objective-C

    - (void)customEventBannerWillDismissModal:
    (nonnull id<GADCustomEventBanner>)customEvent;

  • Your Custom Event should call this when the user dismisses the modal view and the modal view has gone away.

    Declaration

    Objective-C

    - (void)customEventBannerDidDismissModal:
    (nonnull id<GADCustomEventBanner>)customEvent;

  • Your Custom Event should call this method when a user action will result in App switching.

    Declaration

    Objective-C

    - (void)customEventBannerWillLeaveApplication:
    (nonnull id<GADCustomEventBanner>)customEvent;

Deprecated