Banner/MREC Ads

To integrate Banner/MREC 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 IASDK module on the client side, and declare properties, for example:

Objective-C

@property (nonatomic, strong) IAAdSpot *adSpot;
@property (nonatomic, strong) IAViewUnitController*viewUnitController;
@property (nonatomic, strong) IAMRAIDContentController*mraidContentController;

Optionally, create the 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, 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 = 10; 
}];

Initializing the MRAID Content Controller

Initialize the IAMRAIDContentController:

Objective-C

IAMRAIDContentController *mraidContentController =
[IAMRAIDContentController build: ^(id<IAMRAIDContentControllerBuilderh>  _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;

Declaring Your View Controller

Declare that your view controller conforms to the IAMRAIDContentDelegate protocol:

Objective-C

@interface YourViewController () <IAMRAIDContentDelegate>

For more information, see HTML/MRAID Delegate Protocols.

Initializing the View Unit Controller

Initialize the IAViewUnitController:

Objective-C

IAViewUnitController *viewUnitController = [IAViewUnitController
    build:^(id<IAViewUnitControllerBuilder> _Nonnull builder) {
      builder.unitDelegate = self;
      // all the required content controllers should be added to the desired
      // unit controller:
      [builder addSupportedContentController:self.mraidContentController];
    }];

self.viewUnitController = viewUnitController;
// the View Unit Controller should be retained by a client side;

Declaring Your View Controller

Declare that your view controller conforms to the IAUnitDelegate protocol:

Objective-C

@interface YourViewController () <IAUnitDelegate, IAMRAIDContentDelegate>

For more information, see Unit Content Delegate Protocols.

Initializing the Placement

Initialize the IAAdSpot and pass your adRequest object:

Objective-C

IAAdSpot *adSpot = [IAAdSpot build:^(id<IAAdSpotBuilder>  _Nonnull builder) {
    builder.adRequest = adRequest; 
    // pass here the ad request object;    
    // all the supported (by a client side) unit controllers,
    // (in this case - view unit controller) should be added to the desired ad spot:     
    [builder addSupportedUnitController:self.viewUnitController];
}];

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 showAdInParentView: to fetch the ad:

Objective-C

// declare a weak property, because of block:
__weak typeof(self) weakSelf = self;

[self.adSpot fetchAdWithCompletion:^(IAAdSpot* _Nullable adSpot,
                                     IAAdModel* _Nullable adModel,
                                     NSError* _Nullable error) {
  if (error) {
    NSLog(@"Failed to get an ad: %@\n", error);
  } else {
    if (adSpot.activeUnitController == weakSelf.viewUnitController) {
      [weakSelf.viewUnitController showAdInParentView:weakSelf.view];
    }
  }
}];

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 the 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];
          }
        }
      }];