GoogleMobileAds Framework Reference

Classes

The following classes are available globally.

  • The view that displays Ad Manager banner ads.

    To request this ad type using GADAdLoader, you need to pass kGADAdLoaderAdTypeDFPBanner (seeGADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. If yourequest this ad type, your delegate must conform to the DFPBannerAdLoaderDelegate protocol.

    Declaration

    Swift

    classDFPBannerView:GADBannerView

  • Custom rendered ad. Your application renders the ad.

    Declaration

    Swift

    classDFPCustomRenderedAd:NSObject

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

    Declaration

    Swift

    classDFPInterstitial:GADInterstitial

  • Displays AdChoices content.

    If a GADAdChoicesView is set on GADNativeAppInstallAdView or GADNativeContentAdView prior tocalling -setNativeAppInstallAd: or -setNativeContentAd:, AdChoices content will render insidethe GADAdChoicesView. By default, AdChoices is placed in the top right corner ofGADNativeAppInstallAdView and GADNativeContentAdView.

    Declaration

    Swift

    classGADAdChoicesView:UIView

  • Ad loader options base class. See each ad type’s header for available GADAdLoaderOptionssubclasses.

    Declaration

    Swift

    classGADAdLoaderOptions:NSObject

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

    Declaration

    Swift

    classGADAdLoader:NSObject

  • Reward information for GADRewardBasedVideoAd ads.

    Declaration

    Swift

    classGADAdReward:NSObject

  • Provides audio and video notifications and configurations management.

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

    Declaration

    Swift

    classGADAudioVideoManager:NSObject

  • The view that displays banner ads. A minimum implementation to get an ad from within aUIViewController class is:

      // Create and setup the ad view, specifying the size and origin at {0, 0}.  GADBannerView *adView = [[GADBannerView alloc] initWithAdSize:kGADAdSizeBanner];  adView.rootViewController = self;  adView.adUnitID = @ID created when registering your app;  // Place the ad view onto the screen.  [self.view addSubview:adView];  // Request an ad without any additional targeting information.  [adView loadRequest:[GADRequest request]];

    Declaration

    Swift

    classGADBannerView:UIView

  • Represents a correlation between multiple ads. Set an instance of this object on multiple ads toindicate they are being used in a common context.

    Declaration

    Swift

    classGADCorrelator:NSObject

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

    Declaration

    Swift

    classGADCustomEventExtras:NSObject,GADAdNetworkExtras

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

    Declaration

    Swift

    classGADCustomEventRequest:NSObject

  • The consumable in-app purchase item that has been purchased by the user. The purchase flow ishandled by the Google Mobile Ads SDK.Instances of this class are created and passed to your in-app purchase delegate after the userhas successfully paid for a product. Your code must correctly deliver the product to the userand then call the didCompletePurchase method to finish the transaction.

    Declaration

    Swift

    classGADDefaultInAppPurchase:NSObject

  • The in-app purchase item to be purchased with the purchase flow handled by you, theapplication developer.Instances of this class are created and passed to your GADInAppPurchaseDelegate object whenusers click a buy button. It is important to report the result of the purchase back to the SDKin order to track metrics about the transaction.

    Declaration

    Swift

    classGADInAppPurchase:NSObject

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

    Declaration

    Swift

    classGADAdapterStatus:NSObject,NSCopying

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

    Declaration

    Swift

    classGADInitializationStatus:NSObject,NSCopying

  • An interstitial ad. This is a full-screen advertisement shown at natural transition points inyour application such as between game levels or news stories.

    Declaration

    Swift

    classGADInterstitial:NSObject

  • Provides media content information. Interact with instances of this class on the main queueonly.

    Declaration

    Swift

    classGADMediaContent:NSObject

  • Displays native ad media content.

    To display media content in GADUnifiedNativeAdView instances, add a GADMediaView subview,assign the native ad view’s mediaView property, and set the native ad’s mediaContent property tothe 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 viewdisplays 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 isempty.

    Declaration

    Swift

    classGADMediaView:UIView

  • Google Mobile Ads SDK settings.

    Declaration

    Swift

    classGADMobileAds:NSObject

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

    Declaration

    Swift

    classGADMultipleAdsAdLoaderOptions:GADAdLoaderOptions

  • Native ad base class. All native ad types are subclasses of this class.

    Declaration

    Swift

    classGADNativeAd:NSObject

  • Native app install ad. To request this ad type, you need to passkGADAdLoaderAdTypeNativeAppInstall (see GADAdLoaderAdTypes.h) to the |adTypes| parameter inGADAdLoader’s initializer method. If you request this ad type, your delegate must conform tothe GADNativeAppInstallAdLoaderDelegate protocol.

    Declaration

    Swift

    classGADNativeAppInstallAd:GADNativeAd

  • Base class for app install ad views. Your app install ad view must be a subclass of this classand must call superclass methods for all overriden methods.

    Declaration

    Swift

    classGADNativeAppInstallAdView:UIView

  • Native content ad. To request this ad type, you need to pass kGADAdLoaderAdTypeNativeContent(see GADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. Ifyou request this ad type, your delegate must conform to the GADNativeContentAdLoaderDelegateprotocol.

    Declaration

    Swift

    classGADNativeContentAd:GADNativeAd

  • Base class for content ad views. Your content ad view must be a subclass of this class and mustcall superclass methods for all overriden methods.

    Declaration

    Swift

    classGADNativeContentAdView:UIView

  • Native custom template ad. To request this ad type, you need to passkGADAdLoaderAdTypeNativeCustomTemplate (see GADAdLoaderAdTypes.h) to the |adTypes| parameterin GADAdLoader’s initializer method. If you request this ad type, your delegate must conform tothe GADNativeCustomTemplateAdLoaderDelegate protocol.

    Declaration

    Swift

    classGADNativeCustomTemplateAd:GADNativeAd

  • The view that displays native ads. A minimum implementation to get an ad from within aUIViewController class is:

      // Create and setup the ad view, specifying the size and origin at {0, 0}.  GADNativeExpressAdView *adView =      [[GADNativeExpressAdView alloc] initWithAdSize:kGADAdSizeBanner];  adView.rootViewController = self;  adView.adUnitID = @ID created when registering your app;  // Place the ad view onto the screen.  [self.view addSubview:adView];  // Request an ad without any additional targeting information.  [adView loadRequest:[GADRequest request]];

    Declaration

    Swift

    classGADNativeExpressAdView:UIView

  • Specifies optional parameters for ad requests.

    Declaration

    Swift

    classGADRequest:NSObject,NSCopying

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

    Declaration

    Swift

    classGADRequestConfiguration:NSObject

  • Represents the error generated due to invalid request parameters.

    Declaration

    Swift

    classGADRequestError:NSError

  • The GADRewardBasedVideoAd class is used for requesting and presenting a reward based video ad.This class isn’t thread safe.

    Declaration

    Swift

    classGADRewardBasedVideoAd:NSObject

  • The GADRewardedAd class is used for requesting and presenting a rewarded ad.

    Declaration

    Swift

    classGADRewardedAd:NSObject

  • 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 GADSearchRequest ad request object to hold the search query and other search data. 3) Call GADSearchBannerView’s -loadRequest: method with the GADSearchRequest object.

    Declaration

    Swift

    classGADSearchBannerView:GADBannerView

  • Options for server-to-server verification callbacks for a rewarded ad.

    Declaration

    Swift

    classGADServerSideVerificationOptions:NSObject,NSCopying

  • Unified native ad. To request this ad type, pass kGADAdLoaderAdTypeUnifiedNative(see GADAdLoaderAdTypes.h) to the |adTypes| parameter in GADAdLoader’s initializer method. Ifyou request this ad type, your delegate must conform to the GADUnifiedNativeAdLoaderDelegateprotocol.

    Declaration

    Swift

    classGADUnifiedNativeAd:NSObject

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

    Declaration

    Swift

    classGADUnifiedNativeAdView:UIView

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

    Declaration

    Swift

    classGADVideoController:NSObject

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

    Declaration

    Swift

    classGADMediatedNativeAdNotificationSource:NSObject

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

    Declaration

    Swift

    classGADMediatedUnifiedNativeAdNotificationSource:NSObject

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

    Declaration

    Swift

    classGADMediationAdConfiguration:NSObject

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

    Declaration

    Swift

    classGADRTBRequestParameters:NSObject

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2021-03-03 UTC.