Note

Before continuing, please ensure you have integrated the IASDKCore and IASDKVideo modules here.

Integrating Video Ads

Import the following required IASDK modules into your desired view controller:

#import <IASDKCore/IASDKCore.h>
#import <IASDKVideo/IASDKVideo.h>

Each IASDK module should be retained by the “client side”, hence their properties should be added. For example:

@property (nonatomic, strong) IAAdSpot *adSpot;
@property (nonatomic, strong) IAViewUnitController *viewUnitController;
@property (nonatomic, strong) IAVideoContentController *videoContentController;

Create the user data object for better ad targeting:

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

Note

The initialization is performed via builder block - the block runs on the same thread as it is invoked from, and is synchronous (like the enumerateObjectsUsingBlock iOS method).

As a result, the special block treatment (such as weak references, etc...) is not needed.

Next comes the ad request object initialization:

IAAdRequest *adRequest =
[IAAdRequest build:^(id<IAAdRequestBuilder>  _Nonnull builder) { 
    builder.userData = userData; // pass here the user data object, if relevant;
    builder.useSecureConnections = NO;    
    builder.spotID = @"YOUR SPOT ID";    
    builder.timeout = 10;    
    builder.keywords = @"books, music";    
    builder.autoLocationUpdateEnabled = YES;
    // builder.muteAudio = YES; // will start a non-rewarded video in mute state
}];

- IAAdRequest Class

Note

To send secure requests only, please set useSecureConnections to YES

Initialize your Video Content Controller:

IAVideoContentController *videoContentController =
[IAVideoContentController build: 
  ^(id<IAVideoContentControllerBuilder>  _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;

Declare your view controller as conforming to IAVideoContentDelegate protocol:

@interface YourViewController () <IAVideoContentDelegate>

Note

Refer to this page for a full explanation of Video Content Delegate Protocol.

Initialize the View Unit Controller:

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

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

Declare your view controller as conforming to IAUnitDelegate protocol:

@interface YourViewController () <IAUnitDelegate, IAVideoContentDelegate>

Note

Refer to this page for a full explanation of Unit Delegate Protocol.

Initialize your Ad Spot:

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;

Fetch the ad:

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

You have now finished integrating Video Ads!

You can now begin to integrate other ad types:

Note

Integrating Video Ads

Adding Properties

Creating the User Data Object

Note

Adding the Ad Request Object

Note

Initializing the Video Content Controller

Declaring your View Controller

Note

Initializing the View Unit Controller

Note

Initializing your Ad Spot

Fetching the Ad