iOS Integration Guide

  // Import needs to be added to .h files.
@import Nexverse; // OR #import <Nexverse/Nexverse.h>

// ...existing code...

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [NexverseAdManager initialise:config :^(enum NexverseInitializationStatus status, NSError * _Nullable error) {
        switch (status) {
            case NexverseInitializationStatusSucceeded:
                NSLog(@"SDK initialised successfully.");
                break;
            case NexverseInitializationStatusFailed:
                NSLog(@"SDK initialised failed with error: %@", error.localizedDescription);
                break;
            case NexverseInitializationStatusServerStatusWarning:
                NSLog(@"SDK initialised successfully, but server status check failed with error: %@", error.localizedDescription);
                break;
            default:
                NSLog(@"Unknown error has occurred");
        }
    }];
}
  

  [[Targeting shared] setSubjectToGDPR:@1]; // or @0

// No need to set gdprConsentString if subjectToGDPR is set to false.
[[Targeting shared] setGdprConsentString:@"replace-with-actual-consent-string"];
  

  [[Targeting shared] setCoppa:@1]; // or @0
  

  [NexverseAdManager requestLocationPermissionWithCompletion:^(CLAuthorizationStatus status) {
    switch (status) {
        case kCLAuthorizationStatusAuthorizedAlways:
        case kCLAuthorizationStatusAuthorizedWhenInUse:
            NSLog(@"Location permission granted.");
            break;
        case kCLAuthorizationStatusDenied:
            NSLog(@"Location permission denied.");
            break;
        case kCLAuthorizationStatusRestricted:
            NSLog(@"Location permission restricted.");
            break;
        case kCLAuthorizationStatusNotDetermined:
            NSLog(@"Location permission not determined.");
            break;
        default:
            NSLog(@"Location permission unknown.");
            break;
    }
}];
  

  NexverseAdManager.shareGeoLocation = YES;
  

  // BannerDemoViewController.m file.

#import "BannerDemoViewController.h"
@import Nexverse;

@interface BannerDemoViewController ()

@property (nonatomic, strong) BannerView *bannerView;

@end

@implementation BannerDemoViewController

- (void)loadView {
    [super loadView];
    [self createAd];
}

- (void)createAd {
    // 1. Create a BannerView
    CGSize adSize = CGSizeMake(300, 250);
    self.bannerView = [[BannerView alloc] initWithFrame:CGRectMake(0, 0, adSize.width, adSize.height)
                                               configID:@"replace-with-actual-config-id"
                                                 adSize:adSize];

    // 2. Configure the BannerView
    self.bannerView.delegate = self;
    self.bannerView.videoEventsDelegate = self;
    self.bannerView.adFormat = AdFormat.banner; // Use AdFormat.video for video banners, for all the rest use AdFormat.banner
    self.bannerView.videoParameters.placement = PBPlacement.InBanner;
    self.bannerView.redirectionType = RedirectionTypeExternalBrowser; // defaults to RedirectionTypeInternalBrowser
    
    [self.view addSubview:self.bannerView];

    // 3. Load the banner ad
    [self.bannerView loadAd];
}

@end
  

  // Set below properties to determine whether video controls are visibile or not.
bannerView.isPlaybackButtonVisible = YES;
bannerView.isMuteButtonVisible = YES;

// If set to NO then video ad will not start the playback on load.
// playVideoAd method needs to be called to start the playback.
// Default value is YES.
bannerView.isAutoPlayOn = NO;

// Start or resume video ad
[bannerView playVideoAd];

// Pause video ad
[bannerView pauseVideoAd];

// Mute video ad
[bannerView muteVideoAd];

// Unmute video ad
[bannerView unmuteVideoAd];
  

  // BannerDemoViewController.h file.
@interface BannerDemoViewController : UIViewController <BannerViewDelegate, NexverseVideoEventsDelegate>

@end

// BannerDemoViewController.m file
@implementation BannerDemoViewController

// MARK: - BannerViewDelegate
- (UIViewController *)bannerViewPresentationController {
    /*
        Asks the delegate for a view controller instance to use for presenting modal views
        as a result of user interaction on an ad. Usual implementation may simply return self,
        if it is view controller class.
    */

    return self;
}

- (void)bannerView:(BannerView *)bannerView didReceiveAdWithAdSize:(CGSize)adSize {
    // Handle successful ad load
}

- (void)bannerView:(BannerView *)bannerView didFailToReceiveAdWith:(NSError *)error {
    // Handle ad load failure
}

- (void)bannerViewWillLeaveApplication:(BannerView *)bannerView {
    // Handle app leaving foreground
}

- (void)bannerViewWillPresentModal:(BannerView *)bannerView {
    // Handle modal presentation
}

- (void)bannerViewDidDismissModal:(BannerView *)bannerView {
    // Handle modal dismissal
}

// MARK: - NexverseVideoEventsDelegate
- (void)onVideoStart {
    // Video started
}

- (void)onVideoFirstQuartile {
    // Video played till first quartile
}

- (void)onVideoMidpoint {
    // Video played till mid point
}

- (void)onVideoThirdQuartile {
    // Video played till third quartile
}

- (void)onVideoComplete {
    // Video played till end
}

- (void)onVideoPause {
    // Video paused
}

- (void)onVideoResume {
    // Video resumed
}

- (void)onVideoMute {
    // Video muted
}

- (void)onVideoUnmute {
    // Video unmuted
}

- (void)onVideoProgressWithCurrentTime:(NSTimeInterval)currentTime
                              duration:(NSTimeInterval)duration {
    // Video playback time changed to currentTime
}

- (void)onVideoReplay {
    // Replay button tapped
}

- (void)onVideoError:(NSError * _Nullable)error {
    // Error faced while playing video
}

@end
  

  // InterstitialDemoViewController.m file.

#import "InterstitialDemoViewController.h"
@import Nexverse;

@interface InterstitialDemoViewController ()

@property (nonatomic, strong) InterstitialRenderingAdUnit *interstitialAdUnit;

@end

@implementation InterstitialDemoViewController

- (void)loadView {
    [super loadView];
    [self createAd];
}

- (void)createAd {
    // 1. Create a InterstitialRenderingAdUnit
    self.interstitialAdUnit = [[InterstitialRenderingAdUnit alloc] initWithConfigID:@"replace-with-actual-config-id"];

    // 2. Configure the InterstitialRenderingAdUnit
    // For video, use [[NSSet alloc] initWithObjects:AdFormat.video, nil];
    // For multiformat, use [[NSSet alloc] initWithObjects:AdFormat.banner, AdFormat.video, nil];
    self.interstitialAdUnit.adFormats = [[NSSet alloc] initWithObjects:AdFormat.banner, nil];
    self.interstitialAdUnit.delegate = self;
    self.interstitialAdUnit.redirectionType = RedirectionTypeExternalBrowser; // defaults to RedirectionTypeInternalBrowser
    
    // Set below properties to determine whether video controls are visibile or not.
    self.interstitialAdUnit.isPlaybackButtonVisible = YES;
    self.interstitialAdUnit.isMuteButtonVisible = YES;

    // 3. Load the interstitial ad
    // NOTE: This will just load the ad,
    // [interstitialAdUnit show] needs to be called from relevant delegate event. Check next section.
    [self.interstitialAdUnit loadAd];
}

@end
  

  
// InterstitialDemoViewController.h file.
@interface InterstitialDemoViewController : UIViewController <InterstitialAdUnitDelegate>

@end

// InterstitialDemoViewController.m file
@implementation InterstitialDemoViewController

- (void)interstitialDidReceiveAd:(InterstitialRenderingAdUnit *)interstitial {
    // Show interstitial from a viewController
    [interstitial showFrom:self];
}

- (void)interstitial:(InterstitialRenderingAdUnit *)interstitial didFailToReceiveAdWithError:(NSError *)error {
    // Handle ad load failure
}

- (void)interstitial:(InterstitialRenderingAdUnit *)interstitial didFailToShowAdWithError:(NSError *)error {
    // Handle ad show failure
}

- (void)interstitialWillPresentAd:(InterstitialRenderingAdUnit *)interstitial {
    // Handle ad presentation
}

- (void)interstitialDidDismissAd:(InterstitialRenderingAdUnit *)interstitial {
    // Handle ad dismissal
}

- (void)interstitialWillLeaveApplication:(InterstitialRenderingAdUnit *)interstitial {
    // Handle app leaving foreground
}

- (void)interstitialDidClickAd:(InterstitialRenderingAdUnit *)interstitial {
    // Handle ad click
}

@end
  

  // RewardedAdDemoViewController.m file.

#import "RewardedAdDemoViewController.h"
@import Nexverse;

@interface RewardedAdDemoViewController ()

@property (nonatomic, strong) RewardedAdUnit * rewardedAdUnit;

@end

@implementation RewardedAdDemoViewController

- (void)loadView {
    [super loadView];
    [self createAd];
}

- (void)createAd {
    // 1. Create a RewardedAdUnit
    self.rewardedAdUnit = [[RewardedAdUnit alloc] initWithConfigID:@"replace-with-actual-config-id"];
    
    // 2. Configure RewardedAdUnit
    self.rewardedAdUnit.delegate = self;
    self.rewardedAdUnit.redirectionType = RedirectionTypeExternalBrowser; // defaults to RedirectionTypeInternalBrowser
        
    // Set below properties to determine whether video controls are visibile or not.
    self.rewardedAdUnit.isPlaybackButtonVisible = YES;
    self.rewardedAdUnit.isMuteButtonVisible = YES;

    // 3. Load the rewarded ad
    // NOTE: This will just load the ad,
    // [rewardedAdUnit show] needs to be called from relevant delegate event. Check next section.
    [self.rewardedAdUnit loadAd];
}
@end
  

  // RewardedAdDemoViewController.h file.
@interface RewardedAdDemoViewController : UIViewController <RewardedAdUnitDelegate>

@end

// RewardedAdDemoViewController.m file
@implementation RewardedAdDemoViewController

- (void)rewardedAdDidReceiveAd:(RewardedAdUnit *)rewardedAd {
    // Show rewardedAd from a viewController
    if (rewardedAd.isReady) {
        [rewardedAd showFrom:self];
    }
}

- (void)rewardedAd:(RewardedAdUnit *)rewardedAd didFailToReceiveAdWithError:(NSError *)error {
    // Handle ad load failure
}

- (void)rewardedAd:(RewardedAdUnit *)rewardedAd didFailToShowAdWithError:(NSError *)error {
    // Handle ad show failure
}

- (void)rewardedAdUserDidEarnReward:(RewardedAdUnit *)rewardedAd reward:(NexverseReward *)reward {
    // Handle reward distribution
}

- (void)rewardedAdWillPresentAd:(RewardedAdUnit *)rewardedAd {
    // Handle ad presentation
}

- (void)rewardedAdDidDismissAd:(RewardedAdUnit *)rewardedAd {
    // Handle ad dismissal
}

- (void)rewardedAdWillLeaveApplication:(RewardedAdUnit *)rewardedAd {
    // Handle app leaving foreground
}

- (void)rewardedAdDidClickAd:(RewardedAdUnit *)rewardedAd {
    // Handle ad click
}

@end
  

  // NativeAdDemoViewController.h file.

#import <UIKit/UIKit.h>

@interface NativeAdDemoViewController : UIViewController

// 1. Create Native Ad UI with your interface guidelines.
@property (weak, nonatomic) IBOutlet UILabel *titleLabel;
@property (weak, nonatomic) IBOutlet UIImageView *iconView;
@property (weak, nonatomic) IBOutlet UIImageView *mainImageView;
@property (weak, nonatomic) IBOutlet UILabel *bodyLabel;
@property (weak, nonatomic) IBOutlet UIButton *callToActionButton;
@property (weak, nonatomic) IBOutlet UILabel *sponsoredLabel;

-(id)init;

@end

// NativeAdDemoViewController.m file.

#import "NativeAdDemoViewController.h"
@import Nexverse;

@interface NativeAdDemoViewController ()

@property (nonatomic) NativeAd * nativeAd;
@property (nonatomic) NativeRequest * nativeUnit;

@end

@implementation NativeAdDemoViewController

- (void)loadView {
    [super loadView];
    [self createAd];
}

- (void)createAd {
    // 2. Define all the assets required to load in native form.
    NativeAssetImage *image = [[NativeAssetImage alloc] initWithMinimumWidth:200 minimumHeight:50 required:true];
    image.type = ImageAsset.Main;

    NativeAssetImage *icon = [[NativeAssetImage alloc] initWithMinimumWidth:20 minimumHeight:20 required:true];
    icon.type = ImageAsset.Icon;

    NativeAssetTitle *title = [[NativeAssetTitle alloc] initWithLength:90 required:true];
    NativeAssetData *body = [[NativeAssetData alloc] initWithType:DataAssetDescription required:true];
    NativeAssetData *cta = [[NativeAssetData alloc] initWithType:DataAssetCtatext required:true];
    NativeAssetData *sponsored = [[NativeAssetData alloc] initWithType:DataAssetSponsored required:true];

    // Optional - Define trackers.
    NativeEventTracker * eventTracker = [[NativeEventTracker alloc] initWithEvent:EventType.Impression
                                                                          methods:@[EventTracking.Image, EventTracking.js]];
    // 3. Create a NativeRequest
    self.nativeUnit = [[NativeRequest alloc] initWithConfigId:@"replace-with-actual-config-id"
                                                       assets:@[title, icon, image, sponsored, body, cta]
                                                eventTrackers:@[eventTracker]];

    // 4. Configure the NativeRequest
    self.nativeUnit.context = ContextType.Social;
    self.nativeUnit.placementType = PlacementType.FeedContent;
    self.nativeUnit.contextSubType = ContextSubType.Social;

    // 5. Make a request to Nexverse Server
    @weakify(self);
    [self.nativeUnit fetchDemandWithCompletionBidInfo:^(PBMBidInfo * _Nonnull bidInfo) {

        // 6. Find cached native ad
        NSDictionary * targetingKeywords = bidInfo.targetingKeywords ?: @{};
        NSString * cacheId = [targetingKeywords valueForKey:@"hb_cache_id_local"];

        // 7. Create a NativeAd
        NativeAd * nativeAd = [NativeAd createWithCacheId:cacheId];

        if (nativeAd == nil) {
            return;
        }

        nativeAd.delegate = self;
        self.nativeAd.redirectionType = RedirectionTypeExternalBrowser; // defaults to RedirectionTypeInternalBrowser
        self.nativeAd = nativeAd;

        // 8. Render the native ad
        self.titleLabel.text = self.nativeAd.title;
        self.bodyLabel.text = self.nativeAd.text;
        
        // NOTE: This is a sample code to set the images from remote url.
        // Please use optimised methods or a 3rd party SDK like SDWebImage, Kingfisher, Nuke, etc. 
        [[NSURLSession.sharedSession dataTaskWithURL:[NSURL URLWithString:self.nativeAd.iconUrl] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
            dispatch_async(dispatch_get_main_queue(), ^{
                self.iconView.image = [[UIImage alloc] initWithData:data];
            });
        }] resume];

        [[NSURLSession.sharedSession dataTaskWithURL:[NSURL URLWithString:self.nativeAd.imageUrl] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
            dispatch_async(dispatch_get_main_queue(), ^{
                self.mainImageView.image = [[UIImage alloc] initWithData:data];
            });
        }] resume];

        [self.callToActionButton setTitle:self.nativeAd.callToAction forState:UIControlStateNormal];
        self.sponsoredLabel.text = self.nativeAd.sponsoredBy;

        [self.nativeAd registerViewWithView:self.view clickableViews:@[self.callToActionButton]];
    }];
}

@end
  

  // NativeAdDemoViewController.h file.
@interface NativeAdDemoViewController : UIViewController <NativeAdEventDelegate>

@end

// NativeAdDemoViewController.m file
@implementation NativeAdDemoViewController

- (UIViewController *)viewControllerForPresentationFor:(NativeAd *)ad
    /*
        Asks the delegate for a view controller instance to use for presenting modal views
        as a result of user interaction on an ad. Usual implementation may simply return self,
        if it is view controller class.
    */
    return self
}

- (void)adDidExpireWithAd:(NativeAd *)ad {
    // Handle ad expiration
}

- (void)adWasClickedWithAd:(NativeAd *)ad {
    // Handle ad click
}

- (void)adDidLogImpressionWithAd:(NativeAd *)ad {
    // Handle impression logging
}

- (void)adWillPresentModalWithAd:(NativeAd *)ad {
    // Handle modal presentation
}

- (void)adDidDismissModalWithAd:(NativeAd *)ad {
    // Handle modal dismissal
}

- (void)adWillLeaveApplicationWithAd:(NativeAd *)ad {
    // Handle app leaving foreground
}

@end