GoogleMobileAds Framework Reference

GADMobileAds

@interfaceGADMobileAds:NSObject

Google Mobile Ads SDK settings.

  • Returns the shared GADMobileAds instance.

    Declaration

    Objective-C

    +(nonnullGADMobileAds*)sharedInstance;

  • Disables automated in app purchase (IAP) reporting. Must be called before any IAP transaction isinitiated. IAP reporting is used to track IAP ad conversions. Do not disable reporting if youuse IAP ads.

    Declaration

    Objective-C

    +(void)disableAutomatedInAppPurchaseReporting;

  • Disables automated SDK crash reporting. If not called, the SDK records the original exceptionhandler if available and registers a new exception handler. The new exception handler onlyreports SDK related exceptions and calls the recorded original exception handler.

    Declaration

    Objective-C

    +(void)disableSDKCrashReporting;

  • The application’s audio volume. Affects audio volumes of all ads relative to other audio output.Valid ad volume values range from 0.0 (silent) to 1.0 (current device volume). Use this methodonly if your application has its own volume controls (e.g., custom music or sound effectvolumes). Defaults to 1.0.

    Declaration

    Objective-C

    @property(assign,readwrite,nonatomic)floatapplicationVolume;

  • Indicates whether the application’s audio is muted. Affects initial mute state for all ads. Usethis method only if your application has its own volume controls (e.g., custom music or soundeffect muting). Defaults to NO.

    Declaration

    Objective-C

    @property(assign,readwrite,nonatomic)BOOLapplicationMuted;

  • Manages the Google Mobile Ads SDK’s audio and video settings.

    Declaration

    Objective-C

    @property(readonly,strong,nonatomic,nonnull)GADAudioVideoManager*audioVideoManager;

  • Request configuration that is common to all requests.

    Declaration

    Objective-C

    @property(readonly,strong,nonatomic,nonnull)GADRequestConfiguration*requestConfiguration;

  • Initialization status of the ad networks available to the Google Mobile Ads SDK.

    Declaration

    Objective-C

    @property(readonly,nonatomic,nonnull)GADInitializationStatus*initializationStatus;

  • Returns YES if the current SDK version is at least |major|.|minor|.|patch|. This method can beused by libraries that depend on a specific minimum version of the Google Mobile Ads SDK to warndevelopers if they have an incompatible version.

    Available in Google Mobile Ads SDK 7.10 and onwards. Before calling this method check if theGADMobileAds’s shared instance responds to this method. Calling this method on a Google MobileAds SDK lower than 7.10 can crash the app.

    Declaration

    Objective-C

    -(BOOL)isSDKVersionAtLeastMajor:(NSInteger)majorminor:(NSInteger)minorpatch:(NSInteger)patch;

  • Starts the Google Mobile Ads SDK. Call this method as early as possible to reduce latency on thesession’s first ad request. Calls completionHandler when the GMA SDK and all mediation networksare fully set up or if set-up times out. The Google Mobile Ads SDK starts on the first adrequest if this method is not called.

    Declaration

    Objective-C

    -(void)startWithCompletionHandler:(nullableGADInitializationCompletionHandler)completionHandler;

  • Configures the SDK using the settings associated with the given application ID.

    Declaration

    Objective-C

    +(void)configureWithApplicationID:(nonnullNSString*)applicationID;

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.