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

    Swift

    func customEventBanner(_ customEvent: GADCustomEventBanner, didReceiveAd view: UIView)

    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

    Swift

    func customEventBanner(_ customEvent: GADCustomEventBanner, didFailAd error: Error?)

    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

    Swift

    func customEventBannerWasClicked(_ customEvent: GADCustomEventBanner)

    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

    Swift

    var viewControllerForPresentingModalView: UIViewController { get }

    Objective-C

    @property (nonatomic, readonly, nonnull) UIViewController *viewControllerForPresentingModalView;
  • Your Custom Event should call this when the user taps an ad and a modal view appears.

    Declaration

    Swift

    func customEventBannerWillPresentModal(_ customEvent: GADCustomEventBanner)

    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

    Swift

    func customEventBannerWillDismissModal(_ customEvent: GADCustomEventBanner)

    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

    Swift

    func customEventBannerDidDismissModal(_ customEvent: GADCustomEventBanner)

    Objective-C

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