Rewarded Ads

To integrate Rewarded ads, ensure you have integrated the IASDKCore Libraries. Configure the ad placement and its controllers, create an Ad Request, and then fetch and display the ad.

Importing the SDK

Import the following IASDKCore module into your desired view controller:

Objective-C

#import <IASDKCore/IASDKCore.h>

Adding Properties

Retain each DT Exchange SDK entity, and declare properties for:

• adSpot (placement)

• UnitController

• videoContentController

• mraidConentController

Objective-C

@property (nonatomic, strong) IAAdSpot *adSpot;
@property (nonatomic, strong) IAFullscreenUnitController *unitController;
@property (nonatomic, strong) IAVideoContentController *videoContentController;
@property (nonatomic, strong) IAMRAIDContentController *mraidContentController;

Optionally, create an IAUserData object for better ad targeting:

Objective-C

IAUserData *userData = [IAUserData build:^(id  _Nonnull builder) 
{ 
    builder.age = 34;     
    builder.gender = IAUserGenderTypeMale;    
    builder.zipCode = @"90210";
}];
IASDKCore.sharedInstance.userData = userData;

The build: method is synchronous and runs on the same thread that it is invoked from, similar to iOS's enumerateObjectsUsingBlock. As a result, special memory management like weak references are not needed inside the block.

Set global variables for SDK bidding provided in IASDKCore shared instance:

• userData

• muteAudio

• mediationType

• debugger

Example:

Objective-C

IASDKCore.sharedInstance.userData = userData;
IASDKCore.sharedInstance.muteAudio = YES;
IASDKCore.sharedInstance.mediationType = IAMediationMax.new;
IASDKCore.sharedInstance.debugger = [IADebugger build:^(id  _Nonnull builder) {
        builder.server = @"wv.inner-active";
        builder.mockResponsePath = @"bannerresponseforci";
        builder.database = @"4321";
    }];

Creating the Ad Request Object

This step is not mandatory for SDK Bidding mediation.

Initialize an IAAdRequest and provide the spotID and a timeout value:

Objective-C

IAAdRequest *adRequest = [IAAdRequest build:^(id  _Nonnull builder) 
{ 
    builder.spotID = @"YOUR SPOT ID";    
    builder.timeout = 5;    
}];

Optionally, you can opt to mute non-rewarded interstitial ads by adding:

Objective-C

//You can also call the mute through the static object
//In both cases, the result is the same:
IASDKCore.sharedInstance().muteAudio = YES

Initializing the Video Content Controller

Initialize the IAVideoContentController:

Objective-C

IAVideoContentController *videoContentController =
    [IAVideoContentController build:^(id _Nonnull builder) {
      builder.videoContentDelegate = self;
      // A delegate should be passed in order to get video content related
      // callbacks;
    }];

self.videoContentController = videoContentController;
// The Video Content ControllerPage should be retained by a client side

Declaring Your View Controller

Declare your view controller conforms to the IAVideoContentDelegate protocol:

Objective-C

@interface YourViewController  ()<IAVideoContentDelegate

For more information, see Video Content Delegate Protocols.

Initializing the MRAID Content Controller

Initialize the IAMRAIDContentController:

Objective-C

IAMRAIDContentController *mraidContentController =
    [IAMRAIDContentController build:^(id _Nonnull builder) {
      builder.MRAIDContentDelegate = self;
      // A delegate should be passed in order to get video content related
      // callbacks;
    }];

self.mraidContentController = mraidContentController;
// The MRAID Content ControllerPage should be retained by a client side

Declare your view controller conforms to IAMRAIDContentDelegate protocol:

Objective-C

@interface YourViewController () <IAVideoContentDelegate, IAMRAIDContentDelegate> 

For more information, see HTML/MRAID Delegate Protocols.

Initializing the Full-Screen Unit Controller

Initialize the IAMFullscreenUnitController:

Objective-C

IAFullscreenUnitController *fullscreenUnitController =
    [IAFullscreenUnitController build:^(id _Nonnull builder) {
      builder.unitDelegate = self;
      // All the required content controllers should be added to the desired
      // unit controller:
      [builder addSupportedContentController:self.videoContentController];
      [builder addSupportedContentController:self.mraidContentController];
    }];
self.unitController = fullscreenUnitController;
// The Fullscreen Unit Controller should be retained by a client side;

Declaring Your View Controller

Declare your view controller conforms to IAUnitDelegate protocol:

Objective-C

@interface YourViewController () <IAVideoContentDelegate,
                                  IAMRAIDContentDelegate,
                                  IAUnitDelegate>

For more information, see Unit Content Delegate Protocols.

Initializing the Placement

Initialize the IAAdSpot (placement) and pass your adRequest object:

Objective-C

IAAdSpot *adSpot = [IAAdSpot build:^(id  _Nonnull builder) {
      builder.adRequest = adRequest; 
// pass here the ad request object;
      [builder addSupportedUnitController:self.unitController];
}];

self.adSpot = adSpot; 
// the Ad Spot should be retained by a client side;

Fetching the Ad

The way in which the ad is fetched depends on the mediation type — Waterfall or SDK Bidding.

Fetching the Ad for Waterfall

In Waterfall mediation, use fetchAdWithCompletion: and showAdAnimated: to fetch the ad:

Objective-C

// Declare a weak var, because of a retained block:
__weak typeof(self) weakSelf = self;

[self.adSpot fetchAdWithCompletion:^(IAAdSpot* _Nullable adSpot,
                                     IAAdModel* _Nullable adModel,
                                     NSError* _Nullable error) {
  if (!error) {
    [weakSelf.unitController showAdAnimated:YES completion:nil];
  }
}];

Fetching the Ad for SDK Bidding

In SDK Bidding, DT Exchange must first generate a token for the Mediation SDK to use when sending the request to server.

Generating the Token

The token can be generated upon SDK initialization.

Objective-C

NSString *biddingToken = FMPBiddingManager.sharedInstance.biddingToken;

Return type: NSString *

If an error occurs, the returned value is nil.

Loading the Ad

If DT Exchange wins the auction, load the ad with the signaldata (adm) that was received from the server:

Objective-C

[self.adSpot
    loadAdWithMarkup:adm
      withCompletion:^(IAAdSpot *_Nullable adSpot, IAAdModel *_Nullable adModel,
                       NSError *_Nullable error) {
        if (error) {
          NSLog(@"Failed to get an ad: %@\n", error);
        } else {
          // If is in-view ad unit response, show in view:
          if (adSpot.activeUnitController == weakSelf.viewUnitController) {
            [weakSelf.viewUnitController showAdInParentView:weakSelf.view];
          }
          // If is fullscreen ad unit response, show as fullscreen:
          else if (adSpot.activeUnitController == weakSelf.fsUnitController) {
            [weakSelf.fsUnitController showAdAnimated:YES completion:nil];
          }
        }
      }];

Implementing Mandatory Protocols

Implement a view controller for an ad (and other related modal screens) presentation:

Objective-C

- (UIViewController* _Nonnull)IAParentViewControllerForUnitController:
    (IAUnitController* _Nullable)unitController {
  return self;

  // In case 'self' is a UIViewController subclass;
}

Use IAAdDidReward to receive rewarded ad callbacks:

Objective-C

- (void)IAAdDidReward:(IAUnitController * _Nullable)unitController 
{
    NSLog(@"The ad did reward.");
}