GoogleMobileAds Framework Reference

AI-generated Key Takeaways

• The GADMAdNetworkConnector protocol facilitates communication between ad network adapters and the Google Mobile Ads SDK.

• Adapters use the connector to get information like ad volume and preferred view controllers for presenting ads.

• The GADMAdNetworkConnector protocol includes callbacks to inform the Google Mobile Ads SDK about ad events, like receiving an ad or an ad click.

• Several older methods of the GADMAdNetworkConnector are now deprecated and should no longer be used.

GADMAdNetworkConnector

@protocol GADMAdNetworkConnector <GADMediationAdRequest>

Ad network adapters interact with the mediation SDK using an object that implements the GADMAdNetworkConnector protocol. The connector object can be used to obtain necessary information for ad requests, and to call back to the mediation SDK on ad request returns and user interactions.

• -viewControllerForPresentingModalView

  When you need to show a landing page or any other modal view, such as when a user clicks or when your Ads SDK needs to show an interstitial, use this method to obtain a UIViewController that you can use to show your modal view. Call the -presentViewController:animated:completion: method of the returned UIViewController.

  Declaration

  Swift

  func viewControllerForPresentingModalView() -> UIViewController!

  Objective-C

  - (UIViewController *)viewControllerForPresentingModalView;

• -adVolume

  Returns the preferred ad volume as a fraction of system volume (0.0 to 1.0).

  Declaration

  Swift

  func adVolume() -> Float

  Objective-C

  - (float)adVolume;

• -adMuted

  Returns whether the ad should be muted.

  Declaration

  Swift

  func adMuted() -> Bool

  Objective-C

  - (BOOL)adMuted;

Adapter Callbacks

• -adapter:didFailAd:

  Tells the connector that the adapter failed to receive an ad.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, didFailAd error: (any Error)!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter didFailAd:(NSError *)error;

• -adapter:didReceiveAdView:

  Tells the connector that the adapter received a banner ad.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, didReceiveAdView view: UIView!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter
      didReceiveAdView:(UIView *)view;

• -adapterDidReceiveInterstitial:

  Tells the connector that the adapter received an interstitial.

  Declaration

  Swift

  func adapterDidReceiveInterstitial(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterDidReceiveInterstitial:(id<GADMAdNetworkAdapter>)adapter;

• -adapter:didReceiveMediatedUnifiedNativeAd:

  Tells the connector that the adapter has received a unified mediated native ad. mediatedUnifiedNativeAd is used by the Google Mobile Ads SDK to construct a unified native ad object.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, didReceive mediatedUnifiedNativeAd: (any MediatedUnifiedNativeAd)!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter
      didReceiveMediatedUnifiedNativeAd:
          (id<GADMediatedUnifiedNativeAd>)mediatedUnifiedNativeAd;

Ad events

• -adapterDidGetAdClick:

  Tells the connector that the adapter recorded a user click.

  Declaration

  Swift

  func adapterDidGetAdClick(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterDidGetAdClick:(id<GADMAdNetworkAdapter>)adapter;

• -adapterWillPresentFullScreenModal:

  Tells the connector that the adapter will present a full screen modal.

  Declaration

  Swift

  func adapterWillPresentFullScreenModal(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterWillPresentFullScreenModal:(id<GADMAdNetworkAdapter>)adapter;

• -adapterWillDismissFullScreenModal:

  Tells the connector that the adapter will dismiss a full screen modal.

  Declaration

  Swift

  func adapterWillDismissFullScreenModal(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterWillDismissFullScreenModal:(id<GADMAdNetworkAdapter>)adapter;

• -adapterDidDismissFullScreenModal:

  Tells the connector that the adapter dismissed a full screen modal.

  Declaration

  Swift

  func adapterDidDismissFullScreenModal(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterDidDismissFullScreenModal:(id<GADMAdNetworkAdapter>)adapter;

• -adapterWillPresentInterstitial:

  Tells the connector that the adapter will present an interstitial.

  Declaration

  Swift

  func adapterWillPresentInterstitial(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterWillPresentInterstitial:(id<GADMAdNetworkAdapter>)adapter;

• -adapterWillDismissInterstitial:

  Tells the connector that the adapter will dismiss an interstitial.

  Declaration

  Swift

  func adapterWillDismissInterstitial(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterWillDismissInterstitial:(id<GADMAdNetworkAdapter>)adapter;

• -adapterDidDismissInterstitial:

  Tells the connector that the adapter did dismiss an interstitial.

  Declaration

  Swift

  func adapterDidDismissInterstitial(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterDidDismissInterstitial:(id<GADMAdNetworkAdapter>)adapter;

Deprecated

• -adapter:didReceiveInterstitial:

  Deprecated

  Use -adapterDidReceiveInterstitial:.

  Deprecated. Use -adapterDidReceiveInterstitial:.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, didReceiveInterstitial interstitial: NSObject!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter
      didReceiveInterstitial:(NSObject *)interstitial;

• -adapter:clickDidOccurInBanner:

  Deprecated

  Use -adapterDidGetAdClick:.

  Deprecated. Use -adapterDidGetAdClick:.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, clickDidOccurInBanner view: UIView!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter
      clickDidOccurInBanner:(UIView *)view;

• -adapter:didFailInterstitial:

  Deprecated

  Use -adapter:didFailAd:

  Deprecated. Use -adapter:didFailAd:.

  Declaration

  Swift

  func adapter(_ adapter: (any GADMAdNetworkAdapter)!, didFailInterstitial error: (any Error)!)

  Objective-C

  - (void)adapter:(id<GADMAdNetworkAdapter>)adapter
      didFailInterstitial:(NSError *)error;

• -adapterWillLeaveApplication:

  Deprecated

  Deprecated. No replacement.

  Deprecated. No replacement.

  Declaration

  Swift

  func adapterWillLeaveApplication(_ adapter: (any GADMAdNetworkAdapter)!)

  Objective-C

  - (void)adapterWillLeaveApplication:(id<GADMAdNetworkAdapter>)adapter;