Guides Reference Download Samples Support

GoogleMobileAds Framework Reference

Functions

The following functions are available globally.

Adaptive Sizes

  • Returns a GADAdSize with the given width and a Google-optimized height to create a banner ad. The size returned has an aspect ratio similar to that of kGADAdSizeBanner, suitable for anchoring near the top or bottom of your app. The height is never larger than 15% of the device’s portrait height and is always between 50-90 points. This function always returns the same height for any width / device combination.

    Declaration

    Swift

    func GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth(_ width: CGFloat) -> GADAdSize

    Objective-C

    extern GADAdSize GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width)

  • Returns a GADAdSize with the given width and a Google-optimized height to create a banner ad. The size returned is suitable for use in a banner ad anchored near the top or bottom of your app, similar to use of kGADAdSizeBanner. The height is never larger than 15% of the devices’s landscape height and is always between 50-90 points. This function always returns the same height for any width / device combination.

    Declaration

    Swift

    func GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(_ width: CGFloat) -> GADAdSize

    Objective-C

    extern GADAdSize
GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width)

  • Returns a GADAdSize with the given width and a Google-optimized height. This is a convenience function to return GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth or GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth based on the current interface orientation. This function must be called on the main queue.

    Declaration

    Swift

    func GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(_ width: CGFloat) -> GADAdSize

    Objective-C

    extern GADAdSize
GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(CGFloat width)

Custom Sizes

  • Returns a custom GADAdSize for the provided CGSize. Use this only if you require a non-standard size. Otherwise, use one of the standard size constants above.

    Declaration

    Swift

    func GADAdSizeFromCGSize(_ size: CGSize) -> GADAdSize

    Objective-C

    extern GADAdSize GADAdSizeFromCGSize(CGSize size)

  • Returns a custom GADAdSize that spans the full width of the application in portrait orientation with the height provided.

    Declaration

    Swift

    func GADAdSizeFullWidthPortraitWithHeight(_ height: CGFloat) -> GADAdSize

    Objective-C

    extern GADAdSize GADAdSizeFullWidthPortraitWithHeight(CGFloat height)

  • Returns a custom GADAdSize that spans the full width of the application in landscape orientation with the height provided.

    Declaration

    Swift

    func GADAdSizeFullWidthLandscapeWithHeight(_ height: CGFloat) -> GADAdSize

    Objective-C

    extern GADAdSize GADAdSizeFullWidthLandscapeWithHeight(CGFloat height)

Convenience Functions

  • Returns YES if the two GADAdSizes are equal, otherwise returns NO.

    Declaration

    Swift

    func GADAdSizeEqualToSize(_ size1: GADAdSize, _ size2: GADAdSize) -> Bool

    Objective-C

    extern BOOL GADAdSizeEqualToSize(GADAdSize size1, GADAdSize size2)

  • Returns a CGSize for the provided a GADAdSize constant. If the GADAdSize is unknown, returns CGSizeZero.

    Declaration

    Swift

    func CGSizeFromGADAdSize(_ size: GADAdSize) -> CGSize

    Objective-C

    extern CGSize CGSizeFromGADAdSize(GADAdSize size)

  • Returns YES if |size| is one of the predefined constants or is a custom GADAdSize generated by GADAdSizeFromCGSize.

    Declaration

    Swift

    func IsGADAdSizeValid(_ size: GADAdSize) -> Bool

    Objective-C

    extern BOOL IsGADAdSizeValid(GADAdSize size)

  • Returns YES if |size| is a fluid ad size.

    Declaration

    Swift

    func GADAdSizeIsFluid(_ size: GADAdSize) -> Bool

    Objective-C

    extern BOOL GADAdSizeIsFluid(GADAdSize size)

  • Returns a NSString describing the provided GADAdSize.

    Declaration

    Swift

    func NSStringFromGADAdSize(_ size: GADAdSize) -> String

    Objective-C

    extern NSString *_Nonnull NSStringFromGADAdSize(GADAdSize size)

  • Returns an NSValue representing the GADAdSize.

    Declaration

    Swift

    func NSValueFromGADAdSize(_ size: GADAdSize) -> NSValue

    Objective-C

    extern NSValue *_Nonnull NSValueFromGADAdSize(GADAdSize size)

  • Returns a GADAdSize from an NSValue. Returns kGADAdSizeInvalid if the value is not a GADAdSize.

    Declaration

    Swift

    func GADAdSizeFromNSValue(_ value: NSValue) -> GADAdSize

    Objective-C

    extern GADAdSize GADAdSizeFromNSValue(NSValue *_Nonnull value)

  • Returns the closest valid ad size from possibleAdSizes as compared to |original|. The selected size must be smaller than or equal in size to the original. The selected size must also be within a configurable fraction of the width and height of the original. If no valid size exists, returns kGADAdSizeInvalid.

    Declaration

    Swift

    func GADClosestValidSizeForAdSizes(_ original: GADAdSize, _ possibleAdSizes: [NSValue]) -> GADAdSize

    Objective-C

    extern GADAdSize
GADClosestValidSizeForAdSizes(GADAdSize original,
                              NSArray<NSValue *> *_Nonnull possibleAdSizes)