AI-generated Key Takeaways
-
GADMediationAdapter handles communication between the Google Mobile Ads SDK and third-party SDKs.
-
Adapters are initialized on a background queue and should only use the main queue for loading ads.
-
The protocol includes methods to get adapter and ad SDK versions, specify network extras, and initialize the adapter.
-
It defines methods for loading various ad formats like banner, interstitial, native, rewarded, rewarded interstitial, and app open ads, all of which are called on the main thread and require the completion handler to be called back on the main thread.
-
Loading interscroller ads is deprecated and will be removed in a future release.
GADMediationAdapter
@protocol GADMediationAdapter <NSObject>Receives messages and requests from the Google Mobile Ads SDK. Provides GMA to 3P SDK communication.
Adapters are initialized on a background queue and should avoid using the main queue until load time.
-
Returns the adapter version.
Declaration
Swift
static func adapterVersion() -> VersionNumberObjective-C
+ (GADVersionNumber)adapterVersion; -
Returns the ad SDK version.
Declaration
Swift
static func adSDKVersion() -> VersionNumberObjective-C
+ (GADVersionNumber)adSDKVersion; -
The extras class that is used to specify additional parameters for a request to this ad network. Returns Nil if the network doesn’t have publisher provided extras.
Declaration
Swift
static func networkExtrasClass() -> (any AdNetworkExtras.Type)?Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass; -
Returns an initialized mediation adapter.
Declaration
Swift
init()Objective-C
- (nonnull instancetype)init; -
Tells the adapter to set up its underlying ad network SDK and perform any necessary prefetching or configuration work. The adapter must call completionHandler once the adapter can service ad requests, or if it encounters an error while setting up.
Declaration
Swift
optional static func setUp(with configuration: MediationServerConfiguration) async throwsObjective-C
+ (void)setUpWithConfiguration: (nonnull GADMediationServerConfiguration *)configuration completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock) completionHandler; -
Asks the adapter to load a banner ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadBanner(for adConfiguration: MediationBannerAdConfiguration, completionHandler: @escaping GADMediationBannerLoadCompletionHandler)Objective-C
- (void)loadBannerForAdConfiguration: (nonnull GADMediationBannerAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationBannerLoadCompletionHandler) completionHandler; -
Asks the adapter to load an interstitial ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadInterstitial(for adConfiguration: MediationInterstitialAdConfiguration, completionHandler: @escaping GADMediationInterstitialLoadCompletionHandler)Objective-C
- (void) loadInterstitialForAdConfiguration: (nonnull GADMediationInterstitialAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationInterstitialLoadCompletionHandler) completionHandler; -
Asks the adapter to load a native ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadNativeAd(for adConfiguration: MediationNativeAdConfiguration, completionHandler: @escaping GADMediationNativeLoadCompletionHandler)Objective-C
- (void)loadNativeAdForAdConfiguration: (nonnull GADMediationNativeAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationNativeLoadCompletionHandler) completionHandler; -
Asks the adapter to load a rewarded ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadRewardedAd(for adConfiguration: MediationRewardedAdConfiguration, completionHandler: @escaping GADMediationRewardedLoadCompletionHandler)Objective-C
- (void)loadRewardedAdForAdConfiguration: (nonnull GADMediationRewardedAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationRewardedLoadCompletionHandler) completionHandler; -
Asks the adapter to load a rewarded interstitial ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadRewardedInterstitialAd(for adConfiguration: MediationRewardedAdConfiguration, completionHandler: @escaping GADMediationRewardedLoadCompletionHandler)Objective-C
- (void) loadRewardedInterstitialAdForAdConfiguration: (nonnull GADMediationRewardedAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationRewardedLoadCompletionHandler) completionHandler; -
Asks the adapter to load an app open ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadAppOpenAd(for adConfiguration: GADMediationAppOpenAdConfiguration, completionHandler: @escaping GADMediationAppOpenLoadCompletionHandler)Objective-C
- (void)loadAppOpenAdForAdConfiguration: (nonnull GADMediationAppOpenAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationAppOpenLoadCompletionHandler) completionHandler;
-
Deprecated
Interscroller mediation is no longer supported. This API will be removed in a future release.
Asks the adapter to load an interscroller ad with the provided ad configuration. The adapter must call back completionHandler with the loaded ad, or it may call back with an error. This method is called on the main thread, and completionHandler must be called back on the main thread.
Declaration
Swift
optional func loadInterscrollerAd(for adConfiguration: MediationBannerAdConfiguration, completionHandler: @escaping GADMediationInterscrollerAdLoadCompletionHandler)Objective-C
- (void) loadInterscrollerAdForAdConfiguration: (nonnull GADMediationBannerAdConfiguration *)adConfiguration completionHandler: (nonnull GADMediationInterscrollerAdLoadCompletionHandler) completionHandler;