# GADNativeAd


    @interface GADNativeAd : NSObject

Native ad. To request this ad type, pass GADAdLoaderAdTypeNative
(see GADAdLoaderAdTypes.h) to the \|adTypes\| parameter in GADAdLoader's initializer method. If
you request this ad type, your delegate must conform to the GADNativeAdLoaderDelegate
protocol.
[## Must be displayed if available](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/Must-be-displayed-if-available)

- `


  ### [headline](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)headline)


  ` Headline.

  #### Declaration

  Swift

      var headline: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *headline;

[## Recommended to display](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/Recommended-to-display)

- `


  ### [callToAction](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)callToAction)


  ` Text that encourages user to take some action with the ad. For example "Install".

  #### Declaration

  Swift

      var callToAction: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *callToAction;

- `


  ### [icon](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)icon)


  ` Icon image.

  #### Declaration

  Swift

      var icon: NativeAdImage? { get }

  Objective-C

      @property (nonatomic, strong, readonly, nullable) https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAdImage.html *icon;

- `


  ### [body](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)body)


  ` Description.

  #### Declaration

  Swift

      var body: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *body;

- `


  ### [images](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)images)


  ` Array of GADNativeAdImage objects.

  #### Declaration

  Swift

      var images: [NativeAdImage]? { get }

  Objective-C

      @property (nonatomic, strong, readonly, nullable) NSArray<https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAdImage.html *> *images;

- `


  ### [starRating](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)starRating)


  ` App store rating (0 to 5).

  #### Declaration

  Swift

      @NSCopying var starRating: NSDecimalNumber? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSDecimalNumber *starRating;

- `


  ### [store](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)store)


  ` The app store name. For example, "App Store".

  #### Declaration

  Swift

      var store: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *store;

- `


  ### [price](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)price)


  ` String representation of the app's price.

  #### Declaration

  Swift

      var price: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *price;

- `


  ### [advertiser](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)advertiser)


  ` Identifies the advertiser. For example, the advertiser's name or visible URL.

  #### Declaration

  Swift

      var advertiser: String? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSString *advertiser;

- `


  ### [mediaContent](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)mediaContent)


  ` Media content. Set the associated media view's mediaContent property to this object to display
  this content.

  #### Declaration

  Swift

      var mediaContent: MediaContent { get }

  Objective-C

      @property (nonatomic, readonly, nonnull) https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADMediaContent.html *mediaContent;

[## Other properties](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/Other-properties)

- `


  ### [delegate](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)delegate)


  ` Optional delegate to receive state change notifications.

  #### Declaration

  Swift

      weak var delegate: (any NativeAdDelegate)? { get set }

  Objective-C

      @property (nonatomic, weak, nullable) id<https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Protocols/GADNativeAdDelegate.html> delegate;

- `


  ### [rootViewController](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)rootViewController)


  ` Reference to a root view controller that is used by the ad to present full screen content after
  the user interacts with the ad. The root view controller is most commonly the view controller
  displaying the ad.

  #### Declaration

  Swift

      weak var rootViewController: UIViewController? { get set }

  Objective-C

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

- `


  ### [extraAssets](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)extraAssets)


  ` Dictionary of assets which aren't processed by the receiver.

  #### Declaration

  Swift

      var extraAssets: [String : Any]? { get }

  Objective-C

      @property (nonatomic, copy, readonly, nullable) NSDictionary<NSString *, id> *extraAssets;

- `


  ### [responseInfo](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)responseInfo)


  ` Information about the ad response that returned the ad.

  #### Declaration

  Swift

      var responseInfo: ResponseInfo { get }

  Objective-C

      @property (nonatomic, readonly, nonnull) https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADResponseInfo.html *responseInfo;

- `


  ### [placementID](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)placementID)


  ` An identifier for a placement in reporting. This property must be set prior to associating the
  ad with a GADNativeAdView.

  #### Declaration

  Swift

      var placementID: Int64 { get set }

  Objective-C

      @property (nonatomic) int64_t placementID;

- `


  ### [customMuteThisAdAvailable](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)customMuteThisAdAvailable)


  ` Indicates whether custom Mute This Ad is available for the native ad.

  #### Declaration

  Swift

      var isCustomMuteThisAdAvailable: Bool { get }

  Objective-C

      @property (nonatomic, readonly, getter=isCustomMuteThisAdAvailable) BOOL customMuteThisAdAvailable;

- `


  ### [muteThisAdReasons](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)muteThisAdReasons)


  ` An array of Mute This Ad reasons used to render customized mute ad survey. Use this array to
  implement your own Mute This Ad feature only when customMuteThisAdAvailable is YES.

  #### Declaration

  Swift

      var muteThisAdReasons: [MuteThisAdReason]? { get }

  Objective-C

      @property (nonatomic, readonly, nullable) NSArray<https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADMuteThisAdReason.html *> *muteThisAdReasons;

- `


  ### [-muteThisAdWithReason:](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(im)muteThisAdWithReason:)


  ` Reports the mute event with the mute reason selected by user. Use nil if no reason was selected.
  Call this method only if customMuteThisAdAvailable is YES.

  #### Declaration

  Swift

      func muteThisAd(with reason: MuteThisAdReason?)

  Objective-C

      - (void)muteThisAdWithReason:(nullable https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADMuteThisAdReason.html *)reason;

[## Deprecated](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/Deprecated)

- `


  ### [paidEventHandler](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)paidEventHandler)


  ` Deprecated

  Use \[GADNativeAdDelegate nativeAd:didRecordPaidEventWithAdValue:\] instead.
  Called when the ad is estimated to have earned money. Available for allowlisted accounts only.

  #### Declaration

  Swift

      var paidEventHandler: https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Type-Definitions.html#/c:GADAdValue.h@T@GADPaidEventHandler? { get set }

  Objective-C

      @property (nonatomic, copy, nullable) https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Type-Definitions.html#/c:GADAdValue.h@T@GADPaidEventHandler paidEventHandler;

[## ConfirmedClick](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/ConfirmedClick)

- `


  ### [unconfirmedClickDelegate](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)unconfirmedClickDelegate)


  ` Unconfirmed click delegate.

  #### Declaration

  Swift

      weak var unconfirmedClickDelegate: (any NativeAdUnconfirmedClickDelegate)? { get set }

  Objective-C

      @property (nonatomic, weak, nullable) id<https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Protocols/GADNativeAdUnconfirmedClickDelegate.html> unconfirmedClickDelegate;

- `


  ### [-registerClickConfirmingView:](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(im)registerClickConfirmingView:)


  ` Registers a view that will confirm the click.

  #### Declaration

  Swift

      func registerClickConfirmingView(_ view: UIView?)

  Objective-C

      - (void)registerClickConfirmingView:(nullable UIView *)view;

- `


  ### [-cancelUnconfirmedClick](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(im)cancelUnconfirmedClick)


  ` Cancels the unconfirmed click. Call this method when the user fails to confirm the click.
  Calling this method causes the SDK to stop tracking clicks on the registered click confirming
  view and invokes the -nativeAdDidCancelUnconfirmedClick: delegate method. If no unconfirmed
  click is in progress, this method has no effect.

  #### Declaration

  Swift

      func cancelUnconfirmedClick()

  Objective-C

      - (void)cancelUnconfirmedClick;

[## CustomClickGesture](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/CustomClickGesture)

- `


  ### [customClickGestureEnabled](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(py)customClickGestureEnabled)


  ` Indicates whether the custom click gestures feature can be used.

  #### Declaration

  Swift

      var isCustomClickGestureEnabled: Bool { get }

  Objective-C

      @property (nonatomic, readonly, getter=isCustomClickGestureEnabled) BOOL customClickGestureEnabled;

- `


  ### [-enableCustomClickGestures](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(im)enableCustomClickGestures)


  ` Enables custom click gestures. Must be called before the ad is associated with an ad view.
  Available for allowlisted accounts only.

  #### Declaration

  Swift

      func enableCustomClickGestures()

  Objective-C

      - (void)enableCustomClickGestures;

- `


  ### [-recordCustomClickGesture](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd#/c:objc(cs)GADNativeAd(im)recordCustomClickGesture)


  ` Records a click triggered by a custom click gesture.

  #### Declaration

  Swift

      func recordCustomClickGesture()

  Objective-C

      - (void)recordCustomClickGesture;