GoogleMobileAds Framework Reference

GADNativeExpressAdView


@interface GADNativeExpressAdView : UIView

A view that displays native express ads.

Initialization

  • Returns an initialized GADNativeExpressAdView instance set to |adSize| and positioned at |origin| relative to its superview bounds. Returns nil if |adSize| is an invalid ad size.

    Declaration

    Swift

    init?(adSize: GADAdSize, origin: CGPoint)

    Objective-C

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

  • Returns an initialized GADNativeExpressAdView instance set to |adSize| and positioned at the top left of its superview. Returns nil if |adSize| is an invalid ad size.

    Declaration

    Swift

    init?(adSize: GADAdSize)

    Objective-C

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

  • Video controller for controlling video rendered by this native express ad view.

    Declaration

    Swift

    var videoController: GADVideoController { get }

    Objective-C

    @property (readonly, nonatomic, nonnull) GADVideoController *videoController;

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 (copy, nonatomic, nullable) NSString *adUnitID;

  • Required reference to the current root view controller. For example, the root view controller in a tab-based application would be the UITabViewController.

    Declaration

    Swift

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

    Objective-C

    @property (nonatomic, nullable) UIViewController *rootViewController;

  • Required to set this native ad view to a proper size. Never create your own GADAdSize directly. Use one of the predefined standard ad sizes (such as kGADAdSizeBanner), or create one using the GADAdSizeFromCGSize method. If you are not using mediation, 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 you are using mediation, then a new request may not be sent.

    Declaration

    Swift

    var adSize: GADAdSize { get set }

    Objective-C

    @property (nonatomic) GADAdSize adSize;

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

    Declaration

    Swift

    @IBOutlet weak var delegate: GADNativeExpressAdViewDelegate? { get set }

    Objective-C

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

  • 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 (getter=isAutoloadEnabled, nonatomic) BOOL autoloadEnabled;

  • Sets options that configure ad loading.

    Declaration

    Swift

    func setAdOptions(_ adOptions: [Any])

    Objective-C

    - (void)setAdOptions:(nonnull NSArray *)adOptions;

    Parameters

    adOptions

    An array of GADAdLoaderOptions objects. The array is deep copied and option objects cannot be modified after calling this method.

Making an Ad Request

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

    Declaration

    Swift

    func load(_ request: GADRequest?)

    Objective-C

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

Mediation

  • The name of the ad network adapter class that fetched the current ad. Returns nil while the latest ad request is in progress or if the latest ad request failed. For both standard and mediated Google AdMob ads, this method returns @“GADMAdapterGoogleAdMobAds”. For ads fetched via mediation custom events, this method returns @“GADMAdapterCustomEvents”.

    Declaration

    Swift

    weak var adNetworkClassName: NSString? { get }

    Objective-C

    @property (readonly, nonatomic, nullable) NSString *adNetworkClassName;