All-in-One

To integrate all ad types in one integration, 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

Creating Properties

Create properties for all types of controllers and content controllers:

Objective-C

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

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 User Data Object

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.

Initializing 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 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

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 Video Content Controller

Initialize the IAMVideoContentController:

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 that the video content controller conforms to the IAVideoContentDelegate protocol:

Objective-C

Objective-C

@interface YourViewController  () <IAMRAIDContentDelegate, IAVideoContentDelegate>

For more information, see Video Content 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.videoContentController];
      [builder addSupportedContentController:self.mraidContentController];
    }];
self.viewUnitController = viewUnitController;
// the View Unit Controller should be retained by a client side;

Initializing the Full-Screen Unit Controller

Initialize the IAFullscreenUnitController:

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 the View Unit Controller and the Full Screen Unit Controller

Declare that the video content controller and full screen unit conform to the IAVideoContentDelegate protocol:

Objective-C

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

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;
  // All the supported (by a client side) unit controllers:
  [builder addSupportedUnitController:self.viewUnitController];
  [builder addSupportedUnitController:self.fsUnitController];
}];
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:completion 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 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];
    }
  }
}];

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