GADNativeExpressAdView

@interface GADNativeExpressAdView

The view that displays native ads. A minimum implementation to get an ad from within a UIViewController 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]];
  

  • 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: Any!, origin: Any!)

    Objective-C

    - (instancetype _Nullable)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: Any!)

    Objective-C

    - (instancetype _Nullable)initWithAdSize:(GADAdSize)adSize;
  • Video controller for controlling video rendered by this native express ad view.

    Declaration

    Objective-C

    @property (readonly, strong, nonatomic)
        GADVideoController *_Nonnull videoController;
  • 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

    Objective-C

    @property (readwrite, 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

    Objective-C

    @property(nonatomic, weak, GAD_NULLABLE) IBOutlet 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: Int32 { get set }

    Objective-C

    @property (assign, readwrite, 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: AnyObject! { get set }

    Objective-C

    @property (readwrite, 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 autoloadEnabled: Int32 { get set }

    Objective-C

    @property (getter=isAutoloadEnabled, assign, readwrite, 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.

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

    Declaration

    Swift

    func loadRequest(_ request: Any!)

    Objective-C

    - (void)loadRequest:(GADRequest *_Nullable)request;
  • 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

    Objective-C

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