GoogleMobileAds Framework Reference

GADBannerView


@interface GADBannerView : UIView

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

Initialization

  • Initializes and returns a banner view with the specified ad size and origin relative to the banner’s superview.

    Declaration

    Swift

    init(adSize: AdSize, origin: CGPoint)

    Objective-C

    - (nonnull instancetype)initWithAdSize:(GADAdSize)adSize origin:(CGPoint)origin;

  • Initializes and returns a banner view with the specified ad size placed at its superview’s origin.

    Declaration

    Swift

    init(adSize: AdSize)

    Objective-C

    - (nonnull instancetype)initWithAdSize:(GADAdSize)adSize;

Pre-Request

  • Required value created on the AdMob website. Create a new ad unit for every unique placement of an ad in your application. Set this to the ID assigned for this placement. Ad units are important for targeting and statistics.

    Example AdMob ad unit ID: @“ca-app-pub-0123456789012345/0123456789”

    Declaration

    Swift

    var adUnitID: String? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) NSString *adUnitID;

  • Reference to a root view controller that is used by the banner to present full screen content after the user interacts with the ad. If this is nil, the view controller containing the banner view is used.

    Declaration

    Swift

    @IBOutlet weak var rootViewController: UIViewController? { get set }

    Objective-C

    @property (nonatomic, weak, nullable) UIViewController *rootViewController;

  • Required to set this banner view to a proper size. Never create your own GADAdSize directly. Use one of the predefined standard ad sizes (such as GADAdSizeBanner), or create one using the GADAdSizeFromCGSize method. If not using mediation, then changing the adSize after an ad has been shown will cause a new request (for an ad of the new size) to be sent. If using mediation, then a new request may not be sent.

    Declaration

    Swift

    var adSize: AdSize { get set }

    Objective-C

    @property (nonatomic) GADAdSize adSize;

  • Optional delegate object that receives state change notifications from this GADBannerView. Typically this is a UIViewController.

    Declaration

    Swift

    @IBOutlet weak var delegate: (any BannerViewDelegate)? { get set }

    Objective-C

    @property (nonatomic, weak, nullable) id<GADBannerViewDelegate> delegate;

  • Optional delegate that is notified when creatives cause the banner to change size.

    Declaration

    Swift

    @IBOutlet weak var adSizeDelegate: (any AdSizeDelegate)? { get set }

    Objective-C

    @property (nonatomic, weak, nullable) id<GADAdSizeDelegate> adSizeDelegate;

Making an Ad Request

  • Requests an ad. The request object supplies targeting information.

    Declaration

    Swift

    func load(_ request: Request?)

    Objective-C

    - (void)loadRequest:(nullable GADRequest *)request;

  • Loads the ad and informs |delegate| of the outcome.

    Declaration

    Swift

    func load(with adResponseString: String)

    Objective-C

    - (void)loadWithAdResponseString:(nonnull NSString *)adResponseString;

  • A Boolean value that determines whether autoloading of ads in the receiver is enabled. If enabled, you do not need to call the loadRequest: method to load ads.

    Declaration

    Swift

    var isAutoloadEnabled: Bool { get set }

    Objective-C

    @property (nonatomic, assign, unsafe_unretained, readwrite,
          getter=isAutoloadEnabled) BOOL autoloadEnabled;

Response

  • Information about the ad response that returned the current ad or an error. Nil until the first ad request succeeds or fails.

    Declaration

    Swift

    var responseInfo: ResponseInfo? { get }

    Objective-C

    @property (nonatomic, readonly, nullable) GADResponseInfo *responseInfo;

  • Called when ad is estimated to have earned money. Available for allowlisted accounts only.

    Declaration

    Swift

    var paidEventHandler: GADPaidEventHandler? { get set }

    Objective-C

    @property (nonatomic, copy, nullable) GADPaidEventHandler paidEventHandler;

  • An identifier for a placement in reporting. This property must be set prior to placing the ad into a visible superview.

    Declaration

    Swift

    var placementID: Int64 { get set }

    Objective-C

    @property (nonatomic) int64_t placementID;

  • Indicates whether the last loaded ad is a collapsible banner.

    Declaration

    Swift

    var isCollapsible: Bool { get }

    Objective-C

    @property (nonatomic, readonly) BOOL isCollapsible;