Native ad is a flexible type of advertising. You can adapt the display for your UI by preparing a template.

Integration

Native AdQueue is the new native ad implementation and management tool in Appodeal SDK. You no longer need to load Native Ads manually. All you have to do is to set the AdQueue object, and it will load new items automatically.

Be careful when using AdQueue: if your app loads too many ads, but is not able to use them, the ad network can either lower the cost of each impression for you or limit your ability to load native ads.

import Appodeal
class ViewController: UIViewController {
    var adQueue : APDNativeAdQueue!
}

#import <Appodeal/Appodeal.h>
@interface YourViewController : UIViewController
@property (nonatomic, strong) APDNativeAdQueue* nativeAdQueue;
@end

Configure Native Ad Settings

In adQueue.settings you can set the following parameters for the native ads displayed in your app:

Initialize A Specific Native Ad Type

Appodeal SDK provides both static and video types of native ads.

To implement static native ads in your app, use the following code:

class ViewController: UIViewController {
    var adQueue : APDNativeAdQueue!
    override func viewDidLoad() {
        super.viewDidLoad()
        adQueue.settings.adViewClass = TemplateClass.self
        adQueue.settings.autocacheMask = [.icon, .media]
        adQueue.settings.type = .novideo
        
        adQueue.loadAd()
  }
}

- (void)viewDidLoad {
   self.nativeAdQueue = [APDNativeAdQueue new];
   self.nativeAdQueue.settings.type = APDNativeAdTypeNoVideo;
   self.nativeAdQueue.settings.adViewClass = APDDefaultNativeAdView.class;
   self.nativeAdQueue.settings.autocacheMask = APDNativeResourceAutocacheIcon | APDNativeResourceAutocacheMedia;
   [adQueue loadAd];
}

class ViewController: UIViewController {
    var adQueue : APDNativeAdQueue!
    override func viewDidLoad() {
        super.viewDidLoad()
        adQueue.settings.adViewClass = TemplateClass.self
        adQueue.settings.autocacheMask = [.icon, .media]
        adQueue.settings.type = .video
        
        adQueue.loadAd()
  }
}

#import <Appodeal/Appodeal.h>

@interface YourViewController : UIViewController

@property (nonatomic, strong) APDNativeAdQueue* nativeAdQueue;
@property (nonatomic, strong) UIView * nativeAdView;

@end 

@implementation YourViewController

- (void)viewDidLoad {
     self.nativeAdQueue = [[APDNativeAdQueue alloc] init];
     self.nativeAdQueue.settings.type = APDNativeAdTypeVideo;
     self.nativeAdQueue.settings.adViewClass = APDDefaultNativeAdView.class;
     self.nativeAdQueue.delegate = self;
     self.nativeAdQueue.settings.autocacheMask = APDNativeResourceAutocacheIcon | APDNativeResourceAutocacheMedia;
 
     [self.nativeAdQueue loadAd];
 }

 @end

There are two types of native video ads in Appodeal SDK:

• skippable - if “skippable” flag is stated, the video can be skipped after 5 seconds;
• muted - if “muted” flag is stated, the video will be played with no sound.

Caching

Native ads will start downloading when a native ad queue instance is created. You don't need to control the loading lifecycle. But if you bring some ad from ad queue, you need to have strong reference to it during the whole native ad presentation time.  Native ad doesn't have a strong reference to view and view doesn't have a strong reference on the native ad. If application loses reference to the native ad after the impression, the native ad won't be tracking any events.

Callbacks

Callbacks are used to track different events in the lifecycle of an ad, e.g., when an ad was clicked on or closed. To get them, you need to set the delegate as follows:

1. Add APDNativeAdQueueDelegate and APDNativeAdPresentationDelegate to the header file:

class YourViewController: APDNativeAdQueueDelegate, APDNativeAdPresentationDelegate { }

@interface YourViewController : UIViewController <APDNativeAdQueueDelegate, APDNativeAdPresentationDelegate>

// Loading callbacks delegate
self.adQueue.delegate = self
// Presentation callbacks delegate
self.currentAd.delegate = self

// Loading callbacks delegate
self.adQueue.delegate = self;
// Presentation callbacks delegate
self.currentAd.delegate = self;

extension MainViewController : APDNativeAdPresentationDelegate {
    func nativeAdWillLogImpression(_ nativeAd: APDNativeAd!) {}
    func nativeAdWillLogUserInteraction(_ nativeAd: APDNativeAd!) {}
}

extension MainViewController : APDNativeAdQueueDelegate {
    func adQueue(_ adQueue: APDNativeAdQueue!, failedWithError error: Error!) {}
    func adQueueAdIsAvailable(_ adQueue: APDNativeAdQueue!, ofCount count: UInt) {}
}

- (void)adQueueAdIsAvailable:(APDNativeAdQueue *)adQueue ofCount:(NSUInteger)count {
}
- (void)adQueue:(APDNativeAdQueue *)adQueue failedWithError:(NSError *)error {
}
- (void)nativeAdWillLogImpression:(APDNativeAd *)nativeAd {
}
- (void)nativeAdWillLogUserInteraction:(APDNativeAd *)nativeAd {
}

Use Custom Native Ad Templates

To use your custom templates for native ads, simply state your template class in adQueue.setting.adViewClass as follows:

adQueue.settings.adViewClass = YourNativeAdViewTemplate.self

adQueue.settings.adViewClass = YourNativeAdViewTemplate.class;

protocol APDNativeAdView {
 func titleLabel() -> UILabel
 func callToActionLabel() -> UILabel
// Optional
 func descriptionLabel() -> UILabel
 func iconView() -> UIImageView
 func mediaContainerView() -> UIView
 func contentRatingLabel() -> UILabel
 func adChoicesView() -> UIView
 func setRating(_ rating: NSNumber)
 static func nib() -> UINib
}

extension APDNativeAdView {
 func descriptionLabel() -> UILabel {}
 func iconView() -> UIImageView {}
 func mediaContainerView() -> UIView {}
 func contentRatingLabel() -> UILabel {}
 func adChoicesView() -> UIView {}
 func setRating(_ rating: NSNumber) {}
}

@protocol APDNativeAdView <NSObject>
- (nonnull UILabel *)titleLabel;
- (nonnull UILabel *)callToActionLabel;
@optional
- (nonnull UILabel *)descriptionLabel;
- (nonnull UIImageView *)iconView;
- (nonnull UIView *)mediaContainerView;
- (nonnull UILabel *)contentRatingLabel;
- (nonnull UIView *)adChoicesView;
- (void)setRating:(nonnull NSNumber *)rating;
+ (nonnull UINib *)nib;
@end

• titleLabel - container for title text;
• callToActionLabel - container for call-to-action text;
• descriptionLabel - container for description text;
• iconView - container for icon image;
• mediaContainerView - container for media files (images and video files);
• contentRatingLabel - container for showing rating of the content;
• adChoicesView - container for showing adChoice;
• rating - container for showing rating of the app;
• nib - nib-file for template.

Get All Native Ads From Native AdQueue

import UIKit
import Appodeal

class ViewController: UIViewController {
    
    @IBOutlet weak var nativeAdView: UIView!
    var nativeAdQueue: APDNativeAdQueue!
    var nativeArray: [APDNativeAd] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        nativeAdQueue = APDNativeAdQueue()
        nativeAdQueue.settings = APDNativeAdSettings.default()
        nativeAdQueue.settings.adViewClass = CustomNativeAdView.self
        nativeAdQueue.delegate = self
        nativeAdQueue.settings.autocacheMask = [.icon, .media]
        
        nativeAdQueue.loadAd()
    }
    
    @IBAction func presentNativeAd(_ sender: Any) {
        let nativeAd = nativeArray.first
        if let nativeAd = nativeAd {
            nativeAd.delegate = self
            do {
                let adView = try nativeAd.getViewForPlacement("default", withRootViewController: self)
                adView.frame = nativeAdView.bounds
                nativeAdView.addSubview(adView)
            } catch {
                print("error")
            }
        }
    }
}

extension ViewController: APDNativeAdQueueDelegate, APDNativeAdPresentationDelegate {
    func adQueueAdIsAvailable(_ adQueue: APDNativeAdQueue, ofCount count: UInt) {
        if nativeArray.count > 0 {
            return
        } else {
            nativeArray.append(contentsOf: adQueue.getNativeAds(ofCount: 1))
            nativeArray.map{( $0.delegate = self )}
        }
    }
}

#import "ViewController.h"
#import <Appodeal/Appodeal.h>
#import <Appodeal/APDNativeAdQueue.h>
#import "CustomNativeAdView.h"

@interface ViewController ()<APDNativeAdQueueDelegate, APDNativeAdPresentationDelegate>

@property (strong, nonatomic) IBOutlet UIView *nativeAdView;
@property (nonatomic, strong) APDNativeAdQueue* nativeAdQueue;

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    self.nativeAdQueue = [[APDNativeAdQueue alloc] init];

    self.nativeAdQueue.settings = [APDNativeAdSettings defaultSettings];
    self.nativeAdQueue.settings.adViewClass = [CustomNativeAdView class];
    self.nativeAdQueue.delegate = self;
    self.nativeAdQueue.settings.autocacheMask = APDNativeResourceAutocacheIcon | APDNativeResourceAutocacheMedia;

    [self.nativeAdQueue loadAd];
    [Appodeal setLogLevel:APDLogLevelVerbose];
}

- (void)presentNative:(id)sender {
    APDNativeAd * nativeAd = [[self.nativeAdQueue getNativeAdsOfCount:1] firstObject];
    nativeAd.delegate = self;
    CustomNativeAdView * adview = [nativeAd getAdViewForController:self];
    [self.nativeAdView addSubview:adview];
    adview.frame = self.nativeAdView.bounds;
}

@end

Native Ad Object

NativeAd objects have the following characteristics in Appodeal SDK. All of the fields marked as “Mandatory” must be displayed:

Common Mistakes With Native Ads

Get Predicted eCPM

This method returns the expected eCPM for the cached ad. The amount is calculated based on historical data for the current ad unit.

Appodeal.predictedEcpm(for: .nativeAd)

[Appodeal predictedEcpmForAdType: AppodealAdTypeNativeAd]; 

Check If Native Ad Is Initialized

Appodeal.isInitialized(for: .nativeAd)

[Appodeal isInitalizedForAdType: AppodealAdTypeNativeAd];

Returns true, if the Native has been initialized.