GoogleMobileAds Framework Reference

Classes

The following classes are available globally.

• GADAdChoicesView

  Displays AdChoices content.

  If a GADAdChoicesView is set on GADNativeAdView prior to calling -setNativeAd:, AdChoices content will render inside the GADAdChoicesView. By default, AdChoices is placed in the top right corner of GADNativeAdView.

  Declaration

  Swift

  class GADAdChoicesView : UIView

  Objective-C

  @interface GADAdChoicesView : UIView

• GADAdLoader

  Loads ads. See GADAdLoaderAdTypes.h for available ad types.

  Declaration

  Swift

  class GADAdLoader : NSObject

  Objective-C

  @interface GADAdLoader : NSObject

• GADAdLoaderOptions

  Ad loader options base class. See each ad type’s header for available GADAdLoaderOptions subclasses.

  Declaration

  Swift

  class GADAdLoaderOptions : NSObject

  Objective-C

  @interface GADAdLoaderOptions : NSObject

• GADAdReward

  Ad reward information.

  Declaration

  Swift

  class GADAdReward : NSObject

  Objective-C

  @interface GADAdReward : NSObject

• GADAdValue

  The monetary value earned from an ad.

  Declaration

  Swift

  class GADAdValue : NSObject, NSCopying

  Objective-C

  @interface GADAdValue : NSObject <NSCopying>

App Open Ad

• GADAppOpenAd

  An app open ad. Used to monetize app load screens.

  Declaration

  Swift

  class GADAppOpenAd : NSObject, GADFullScreenPresentingAd

  Objective-C

  @interface GADAppOpenAd : NSObject <GADFullScreenPresentingAd>

• GADAudioVideoManager

  Provides audio and video notifications and configurations management.

  Don’t create an instance of this class and use the one available from GADMobileAds sharedInstance’s audioVideoManager.

  Declaration

  Swift

  class GADAudioVideoManager : NSObject

  Objective-C

  @interface GADAudioVideoManager : NSObject

• GADBannerView

  A view that displays banner ads. See https://developers.google.com/admob/ios/banner to get started.

  Declaration

  Swift

  class GADBannerView : UIView

  Objective-C

  @interface GADBannerView : UIView

• GADCustomEventExtras

  Create an instance of this class to set additional parameters for each custom event object. The additional parameters for a custom event are keyed by the custom event label. These extras are passed to your implementation of GADCustomEventBanner or GADCustomEventInterstitial.

  Declaration

  Swift

  class GADCustomEventExtras : NSObject, GADAdNetworkExtras

  Objective-C

  @interface GADCustomEventExtras : NSObject <GADAdNetworkExtras>

• GADCustomEventRequest

  Specifies optional ad request targeting parameters that are provided by the publisher and are forwarded to custom events for purposes of populating an ad request to a 3rd party ad network.

  Declaration

  Swift

  class GADCustomEventRequest : NSObject

  Objective-C

  @interface GADCustomEventRequest : NSObject

• GADCustomNativeAd

  Custom native ad. To request this ad type, you need to pass GADAdLoaderAdTypeCustomNative (see GADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. If you request this ad type, your delegate must conform to the GADCustomNativeAdLoaderDelegate protocol.

  Declaration

  Swift

  class GADCustomNativeAd : NSObject

  Objective-C

  @interface GADCustomNativeAd : NSObject

• GADDebugOptionsViewController

  Displays debug options to the user.

  Declaration

  Swift

  class GADDebugOptionsViewController : UIViewController

  Objective-C

  @interface GADDebugOptionsViewController : UIViewController

• GADDisplayAdMeasurement

  Measurement used for display custom native ad formats.

  Declaration

  Swift

  class GADDisplayAdMeasurement : NSObject

  Objective-C

  @interface GADDisplayAdMeasurement : NSObject

• GADDynamicHeightSearchRequest

  Use to configure Custom Search Ad (CSA) ad requests. A dynamic height search banner can contain multiple ads and the height is set dynamically based on the ad contents. Cross-reference the property sections and properties with the official reference document: https://developers.google.com/custom-search-ads/docs/reference

  Declaration

  Swift

  class GADDynamicHeightSearchRequest : GADRequest

  Objective-C

  @interface GADDynamicHeightSearchRequest : GADRequest

• GADExtras

  Ad network extras sent to Google networks.

  Declaration

  Swift

  class GADExtras : NSObject, GADAdNetworkExtras

  Objective-C

  @interface GADExtras : NSObject <GADAdNetworkExtras>

• GADAdapterStatus

  An immutable snapshot of a mediation adapter’s initialization status.

  Declaration

  Swift

  class GADAdapterStatus : NSObject, NSCopying

  Objective-C

  @interface GADAdapterStatus : NSObject <NSCopying>

• GADInitializationStatus

  An immutable snapshot of the Google Mobile Ads SDK’s initialization status, categorized by mediation adapter.

  Declaration

  Swift

  class GADInitializationStatus : NSObject, NSCopying

  Objective-C

  @interface GADInitializationStatus : NSObject <NSCopying>

• GADInterstitialAd

  An interstitial ad. This is a full-screen advertisement shown at natural transition points in your application such as between game levels or news stories. See https://developers.google.com/admob/ios/interstitial to get started.

  Declaration

  Swift

  class GADInterstitialAd : NSObject, GADFullScreenPresentingAd

  Objective-C

  @interface GADInterstitialAd : NSObject <GADFullScreenPresentingAd>

• GADMediaContent

  Provides media content information. Interact with instances of this class on the main queue only.

  Declaration

  Swift

  class GADMediaContent : NSObject

  Objective-C

  @interface GADMediaContent : NSObject

• GADMediaView

  Displays native ad media content.

  To display media content in GADNativeAdView instances, add a GADMediaView subview, assign the native ad view’s mediaView property, and set the native ad’s mediaContent property to the media view.

  If the native ad contains video content, the media view displays the video content.

  If the native ad doesn’t have video content and image loading is enabled, the media view displays the first image from the native ad’s |images| property.

  If the native ad doesn’t have video content and image loading is disabled, the media view is empty.

  Declaration

  Swift

  class GADMediaView : UIView

  Objective-C

  @interface GADMediaView : UIView

• GADMobileAds

  Google Mobile Ads SDK settings.

  Declaration

  Swift

  class GADMobileAds : NSObject

  Objective-C

  @interface GADMobileAds : NSObject

• GADMultipleAdsAdLoaderOptions

  Ad loader options for requesting multiple ads. Requesting multiple ads in a single request is currently only available for native app install ads and native content ads.

  Declaration

  Swift

  class GADMultipleAdsAdLoaderOptions : GADAdLoaderOptions

  Objective-C

  @interface GADMultipleAdsAdLoaderOptions : GADAdLoaderOptions

• GADMuteThisAdReason

  Reason for muting the ad.

  Declaration

  Swift

  class GADMuteThisAdReason : NSObject

  Objective-C

  @interface GADMuteThisAdReason : NSObject

• GADNativeAd

  Native ad. To request this ad type, pass GADAdLoaderAdTypeNative (see GADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. If you request this ad type, your delegate must conform to the GADNativeAdLoaderDelegate protocol.

  Declaration

  Swift

  class GADNativeAd : NSObject

  Objective-C

  @interface GADNativeAd : NSObject

Unified Native Ad View

• GADNativeAdView

  Base class for native ad views. Your native ad view must be a subclass of this class and must call superclass methods for all overridden methods.

  Declaration

  Swift

  class GADNativeAdView : UIView

  Objective-C

  @interface GADNativeAdView : UIView

• GADNativeAdCustomClickGestureOptions

  Ad loader options for custom click gestures. Available for allowlisted publishers only. These options will be ignored for publishers not allowlisted.

  Declaration

  Swift

  class GADNativeAdCustomClickGestureOptions : GADAdLoaderOptions

  Objective-C

  @interface GADNativeAdCustomClickGestureOptions : GADAdLoaderOptions

• GADNativeAdImage

  Native ad image.

  Declaration

  Swift

  class GADNativeAdImage : NSObject

  Objective-C

  @interface GADNativeAdImage : NSObject

• GADNativeAdImageAdLoaderOptions

  Ad loader options for native ad image settings.

  Declaration

  Swift

  class GADNativeAdImageAdLoaderOptions : GADAdLoaderOptions

  Objective-C

  @interface GADNativeAdImageAdLoaderOptions : GADAdLoaderOptions

• GADNativeAdMediaAdLoaderOptions

  Ad loader options for native ad media settings.

  Declaration

  Swift

  class GADNativeAdMediaAdLoaderOptions : GADAdLoaderOptions

  Objective-C

  @interface GADNativeAdMediaAdLoaderOptions : GADAdLoaderOptions

• GADNativeAdViewAdOptions

  Ad loader options for configuring the view of native ads.

  Declaration

  Swift

  class GADNativeAdViewAdOptions : GADAdLoaderOptions

  Objective-C

  @interface GADNativeAdViewAdOptions : GADAdLoaderOptions

• GADNativeMuteThisAdLoaderOptions

  Mute This Ad options.

  Declaration

  Swift

  class GADNativeMuteThisAdLoaderOptions : GADAdLoaderOptions

  Objective-C

  @interface GADNativeMuteThisAdLoaderOptions : GADAdLoaderOptions

• GADQueryInfo

  Query info used in requests.

  Declaration

  Swift

  class GADQueryInfo : NSObject

  Objective-C

  @interface GADQueryInfo : NSObject

• GADRequest

  Specifies optional parameters for ad requests.

  Declaration

  Swift

  class GADRequest : NSObject, NSCopying

  Objective-C

  @interface GADRequest : NSObject <NSCopying>

• GADRequestConfiguration

  Request configuration. The settings in this class will apply to all ad requests.

  Declaration

  Swift

  class GADRequestConfiguration : NSObject

  Objective-C

  @interface GADRequestConfiguration : NSObject

• GADAdNetworkResponseInfo

  Response metadata for an individual ad network in an ad response.

  Declaration

  Swift

  class GADAdNetworkResponseInfo : NSObject

  Objective-C

  @interface GADAdNetworkResponseInfo : NSObject

• GADResponseInfo

  Information about a response to an ad request.

  Declaration

  Swift

  class GADResponseInfo : NSObject

  Objective-C

  @interface GADResponseInfo : NSObject

• GADRewardedAd

  A rewarded ad. Rewarded ads are ads that users have the option of interacting with in exchange for in-app rewards.

  Declaration

  Swift

  class GADRewardedAd : NSObject, GADAdMetadataProvider, GADFullScreenPresentingAd

  Objective-C

  @interface GADRewardedAd
      : NSObject <GADAdMetadataProvider, GADFullScreenPresentingAd>

• GADRewardedInterstitialAd

  A rewarded interstitial ad. Rewarded Interstitial ads are full screen ads that can be presented without user-opt in and allow you to reward the user with in-app items.

  Declaration

  Swift

  class GADRewardedInterstitialAd : NSObject, GADAdMetadataProvider, GADFullScreenPresentingAd

  Objective-C

  @interface GADRewardedInterstitialAd
      : NSObject <GADAdMetadataProvider, GADFullScreenPresentingAd>

• GADSearchBannerView

  A view that displays search ads. To show search ads: 1) Create a GADSearchBannerView and add it to your view controller’s view hierarchy. 2) Create a GADDynamicHeightSearchRequest object to hold the search query and other search data. 3) Call GADSearchBannerView’s -loadRequest: method with the GADDynamicHeightSearchRequest object.

  Declaration

  Swift

  class GADSearchBannerView : GADBannerView

  Objective-C

  @interface GADSearchBannerView : GADBannerView

• GADServerSideVerificationOptions

  Options for server-side verification callbacks for a rewarded ad.

  Declaration

  Swift

  class GADServerSideVerificationOptions : NSObject, NSCopying

  Objective-C

  @interface GADServerSideVerificationOptions : NSObject <NSCopying>

• GADVideoController

  The video controller class provides a way to get the video metadata and also manages video content of the ad rendered by the Google Mobile Ads SDK. You don’t need to create an instance of this class. When the ad rendered by the Google Mobile Ads SDK loads video content, you may be able to get an instance of this class from the rendered ad object.

  Declaration

  Swift

  class GADVideoController : NSObject

  Objective-C

  @interface GADVideoController : NSObject

• GADVideoOptions

  Video ad options.

  Declaration

  Swift

  class GADVideoOptions : GADAdLoaderOptions

  Objective-C

  @interface GADVideoOptions : GADAdLoaderOptions

• GAMBannerView

  The view that displays Ad Manager banner ads.

  To request this ad type using GADAdLoader, you need to pass GADAdLoaderAdTypeGAMBanner (see GADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. If you request this ad type, your delegate must conform to the GAMBannerAdLoaderDelegate protocol.

  Declaration

  Swift

  class GAMBannerView : GADBannerView

  Objective-C

  @interface GAMBannerView : GADBannerView

• GAMBannerViewOptions

  Ad loader options for banner ads.

  Declaration

  Swift

  class GAMBannerViewOptions : GADAdLoaderOptions

  Objective-C

  @interface GAMBannerViewOptions : GADAdLoaderOptions

• GAMInterstitialAd

  Google Ad Manager interstitial ad, a full-screen advertisement shown at natural transition points in your application such as between game levels or news stories.

  Declaration

  Swift

  class GAMInterstitialAd : GADInterstitialAd

  Objective-C

  @interface GAMInterstitialAd : GADInterstitialAd

• GAMRequest

  Specifies optional parameters for ad requests.

  Declaration

  Swift

  class GAMRequest : GADRequest

  Objective-C

  @interface GAMRequest : GADRequest

• GADMediatedUnifiedNativeAdNotificationSource

  Notifies the Google Mobile Ads SDK about the events performed by adapters. Adapters may perform some action (e.g. opening an in app browser or opening the iTunes store) when handling methods in GADMediatedUnifiedNativeAd. Adapters in such case should notify the Google Mobile Ads SDK by calling the relevant methods from this class.

  Declaration

  Swift

  class GADMediatedUnifiedNativeAdNotificationSource : NSObject

  Objective-C

  @interface GADMediatedUnifiedNativeAdNotificationSource : NSObject

• GADMediationAdConfiguration

  Provided by the Google Mobile Ads SDK for the adapter to render the ad. Contains 3PAS and other ad configuration information.

  Declaration

  Swift

  class GADMediationAdConfiguration : NSObject

  Objective-C

  @interface GADMediationAdConfiguration : NSObject

• GADMediationAppOpenAdConfiguration

  App open ad configuration.

  Declaration

  Swift

  class GADMediationAppOpenAdConfiguration : GADMediationAdConfiguration

  Objective-C

  @interface GADMediationAppOpenAdConfiguration : GADMediationAdConfiguration

• GADMediationBannerAdConfiguration

  Banner ad configuration.

  Declaration

  Swift

  class GADMediationBannerAdConfiguration : GADMediationAdConfiguration

  Objective-C

  @interface GADMediationBannerAdConfiguration : GADMediationAdConfiguration

• GADMediationInterstitialAdConfiguration

  Interstitial ad configuration.

  Declaration

  Swift

  class GADMediationInterstitialAdConfiguration : GADMediationAdConfiguration

  Objective-C

  @interface GADMediationInterstitialAdConfiguration : GADMediationAdConfiguration

• GADMediationNativeAdConfiguration

  Native ad configuration.

  Declaration

  Swift

  class GADMediationNativeAdConfiguration : GADMediationAdConfiguration

  Objective-C

  @interface GADMediationNativeAdConfiguration : GADMediationAdConfiguration

• GADMediationRewardedAdConfiguration

  Rewarded ad configuration.

  Declaration

  Swift

  class GADMediationRewardedAdConfiguration : GADMediationAdConfiguration

  Objective-C

  @interface GADMediationRewardedAdConfiguration : GADMediationAdConfiguration

• GADMediationCredentials

  Mediation configuration set by the publisher on the AdMob UI.

  Declaration

  Swift

  class GADMediationCredentials : NSObject

  Objective-C

  @interface GADMediationCredentials : NSObject

• GADMediationServerConfiguration

  Third party SDK configuration.

  Declaration

  Swift

  class GADMediationServerConfiguration : NSObject

  Objective-C

  @interface GADMediationServerConfiguration : NSObject

• GADRTBMediationSignalsConfiguration

  Mediation configuration for a particular ad request.

  Declaration

  Swift

  class GADRTBMediationSignalsConfiguration : NSObject

  Objective-C

  @interface GADRTBMediationSignalsConfiguration : NSObject

• GADRTBRequestParameters

  Request parameters provided by the publisher and Google Mobile Ads SDK.

  Declaration

  Swift

  class GADRTBRequestParameters : NSObject

  Objective-C

  @interface GADRTBRequestParameters : NSObject

• GADAppOpenSignalRequest

  An app open signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADAppOpenSignalRequest : GADSignalRequest

  Objective-C

  @interface GADAppOpenSignalRequest : GADSignalRequest

• GADBannerSignalRequest

  A banner signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADBannerSignalRequest : GADSignalRequest

  Objective-C

  @interface GADBannerSignalRequest : GADSignalRequest

• GADInterstitialSignalRequest

  An interstitial signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADInterstitialSignalRequest : GADSignalRequest

  Objective-C

  @interface GADInterstitialSignalRequest : GADSignalRequest

• GADNativeSignalRequest

  A native signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADNativeSignalRequest : GADSignalRequest

  Objective-C

  @interface GADNativeSignalRequest : GADSignalRequest

• GADRewardedInterstitialSignalRequest

  A rewarded interstitial signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADRewardedInterstitialSignalRequest : GADSignalRequest

  Objective-C

  @interface GADRewardedInterstitialSignalRequest : GADSignalRequest

• GADRewardedSignalRequest

  A rewarded signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADRewardedSignalRequest : GADSignalRequest

  Objective-C

  @interface GADRewardedSignalRequest : GADSignalRequest

• GADSignal

  A signal that can be used as input in a server-to-server ad request.

  Declaration

  Swift

  class GADSignal : NSObject

  Objective-C

  @interface GADSignal : NSObject

• GADSignalRequest

  A signal request that can be used as input in server-to-server signal generation.

  Declaration

  Swift

  class GADSignalRequest : NSObject, NSCopying

  Objective-C

  @interface GADSignalRequest : NSObject <NSCopying>