GoogleMobileAds Framework Reference

GADMAdNetworkAdapter

@protocol GADMAdNetworkAdapter <NSObject>

Ad network adapter protocol.

• +adapterVersion

  Returns a version string for the adapter. It can be any string that uniquely identifies the adapter’s version. For example, “1.0”, or a date such as “20110915”.

  Declaration

  Swift

  static func adapterVersion() -> String!

  Objective-C

  + (NSString *)adapterVersion;

• +networkExtrasClass

  Returns the extras class that is used by publishers to provide additional parameters to this adapter. Returns Nil if the adapter doesn’t have extra publisher provided settings.

  Declaration

  Swift

  static func networkExtrasClass() -> (any AdNetworkExtras.Type)!

  Objective-C

  + (Class<GADAdNetworkExtras>)networkExtrasClass;

• -initWithGADMAdNetworkConnector:

  Designated initializer. Adapters can and should store a weak reference to the connector. However, adapters must not keep a strong reference to the connector, as doing so creates a reference cycle and abandoned memory.

  Declaration

  Swift

  init!(gadmAdNetworkConnector connector: (any MediationAdNetworkConnector)!)

  Objective-C

  - (instancetype)initWithGADMAdNetworkConnector:
      (id<GADMAdNetworkConnector>)connector;

• -getBannerWithSize:

  Asks the adapter to initiate an asynchronous banner ad request. The adapter may act as a delegate to your SDK to listen to callbacks. If your SDK doesn’t support the given ad size, or doesn’t support banner ads, call adapter:didFailAd: on the connector.

  Declaration

  Swift

  func getBanner(with adSize: AdSize)

  Objective-C

  - (void)getBannerWithSize:(GADAdSize)adSize;

• -getInterstitial

  Asks the adapter to initiate an asynchronous interstitial ad request. The adapter may act as a delegate to your SDK to listen to callbacks. If your SDK doesn’t support interstitials, call adapter:didFailInterstitial: on the connector.

  Declaration

  Swift

  func getInterstitial()

  Objective-C

  - (void)getInterstitial;

• -stopBeingDelegate

  When called, the adapter must remove strong references to itself (e.g., delegate properties and notification observers). You should also call this method in your adapter dealloc to prevent your SDK from interacting with the deallocated adapter. This function may be called multiple times.

  Declaration

  Swift

  func stopBeingDelegate()

  Objective-C

  - (void)stopBeingDelegate;

• -presentInterstitialFromRootViewController:

  Presents an interstitial using the supplied UIViewController, by calling presentViewController:animated:completion:.

  Your interstitial should not immediately present itself when it is received. Instead, you should wait until this method is called on your adapter to present the interstitial.

  The adapter must call adapterWillPresentInterstitial: on the connector when the interstitial is about to be presented, and adapterWillDismissInterstitial: and adapterDidDismissInterstitial: when the interstitial is being dismissed.

  Declaration

  Swift

  func presentInterstitial(from rootViewController: UIViewController!)

  Objective-C

  - (void)presentInterstitialFromRootViewController:
      (UIViewController *)rootViewController;

• -getNativeAdWithAdTypes:options:

  Asks the adapter to initiate an asynchronous native ad request. |adTypes| contains the list of native ad types requested. See GADAdLoaderAdTypes.h for available ad types. |options| contains additional options configured by the publisher. See GADNativeAdImageAdLoaderOptions.h for available image options.

  On ad load success or failure, call adapter:didReceiveNativeAdDataSource:mediationDelegate or adapter:didFailAd: on the connector.

  Declaration

  Swift

  optional func getNativeAd(with adTypes: [AdLoaderAdType]!, options: [GADAdLoaderOptions]!)

  Objective-C

  - (void)getNativeAdWithAdTypes:(NSArray<GADAdLoaderAdType> *)adTypes
                         options:(NSArray<GADAdLoaderOptions *> *)options;

• -handlesUserClicks

  Indicates if the adapter handles user clicks. If the adapter returns YES, it must handle user clicks and notify the Google Mobile Ads SDK of clicks using +[GADMediatedNativeAdNotificationSource mediatedNativeAdDidRecordClick:]. If the adapter returns NO, the Google Mobile Ads SDK handles user clicks and notifies the adapter of clicks using -[GADMediatedUnifiedNativeAd didRecordClickOnAssetWithName:view:viewController:].

  Declaration

  Swift

  optional func handlesUserClicks() -> Bool

  Objective-C

  - (BOOL)handlesUserClicks;

• -handlesUserImpressions

  Indicates if the adapter handles user impressions tracking. If the adapter returns YES, the Google Mobile Ads SDK will not track user impressions and the adapter must notify the Google Mobile Ads SDK of impressions using +[GADMediatedNativeAdNotificationSource mediatedNativeAdDidRecordImpression:]. If the adapter returns NO, the Google Mobile Ads SDK tracks user impressions and notifies the adapter of impressions using -[GADMediatedUnifiedNativeAd didRecordImpression].

  Declaration

  Swift

  optional func handlesUserImpressions() -> Bool

  Objective-C

  - (BOOL)handlesUserImpressions;

• -changeAdSizeTo:

  If your ad network handles multiple ad sizes for the same banner ad, implement this method to be informed of banner size updates. Ad sizes typically change between kGADAdSizeSmartBannerPortrait and kGADAdSizeSmartBannerLandscape. If this method is not implemented, the ad is removed from the user interface when the size changes.

  Declaration

  Swift

  optional func changeAdSize(to adSize: AdSize)

  Objective-C

  - (void)changeAdSizeTo:(GADAdSize)adSize;