iOS Ad Units Integration

Before You Start Make Sure:

• App and Placement set up on Publisher Portal
• SDK is installed
• SDK is initialized
• Each Ad request has “Testing” status which enables  it to test integrations.

Interscroller is a new ad unit, which combines the best elements of both Infeed and Interstitial ad units, in order to provide a unique, engaging user experience.

Interscroller enables you to insert an advertisement inside your app’s feed, while displaying ad-content in a fullscreen, in order to command higher CPM payouts.

The best performance can be reached using reveal effect and customizing colors of visible view-elements.

Interscroller ad unit supports both Video and Display (Static and Rich-Media) ad formats over portrait orientations.

• Display and Rich Media ad size = 320×480
• VAST Vertical Video ad size = 360×640

Interscroller is designed to be inserted into a UITableView or UIScrollView. Each Interscroller is associated with an UIView.

Interscroller loading process is handled in a different way than the other ad units:

DIOPlacement *placement = [[DIOController sharedInstance] placementWithId:@"YOUR_PLACEMENT_ID"];
DIOAdRequest *request = [placement newAdRequest];
DIOInterscrollerContainer container = [DIOInterscrollerContainer alloc] init];
[container loadWithAdRequest:request completionHandler:^(DIOAd *ad){
    // Success
} errorHandler:^(NSError *error) {
    // Failure
}];

The main difference is that you don’t have to wait to receive a DIOAd object in order to access the InterscrollerUIView. In order to do so, use [container view]. See the example:

   // TableView integration
UIView *view = [self.container view];
view.translatesAutoresizingMaskIntoConstraints = NO;
if (cell.contentView.subviews.count > 0) 
       [cell.contentView.subviews[0] removeFromSuperview];
[cell.contentView addSubview:view];
[self.container setConstraintForIndexPath:indexPath];


   // ScrollView integration
UIView *view = [self.container view];
[self.adsView addSubview:view];
[self.container setConstraintForScrollView];
view.translatesAutoresizingMaskIntoConstraints = NO;

// Recommended to set Interscroller height and/or top offset before request 
//to avoid any issues with dynamic UI elements
DIOPlacement *placement = [[DIOController sharedInstance] placementWithId:
                                                          self.placementId];

((DIOInterscrollerPlacement*)placement).interscrollerSize = 
                                             self.scrollView.frame.size.height;
((DIOInterscrollerPlacement*)placement).interscrollerOffset = [INT OFFSET];

Important: Do not try to set additional constraints to ad’s view or cell content view.

When the UITableView requires the height of the row containing the Interscroller, you should return the UITableViewAutomaticDimension.

By default, the header and footer of a Interscroller use dark gray for background color and white for text. Also we recommend to change default background color to your custom, usually app main theme color. This can be changed as follows:

((DIOInterscrollerPlacement*)placement).headerBackgrounColor = [UIColor...];
((DIOInterscrollerPlacement*)placement).headerColor = [UIColor...];
((DIOInterscrollerPlacement*)placement).footerBackgrounColor = [UIColor...];
((DIOInterscrollerPlacement*)placement).footerColor = [UIColor...];
((DIOInterscrollerPlacement*)placement).mainBackgrounColor = [UIColor...];

Default Interscroller height usually equal to table height. If you use any UI elements which can overlap ad’s view you may want to customise Interscroller height and top offset:

((DIOInterscrollerPlacement*)placement).interscrollerSize = YOUR_HEIGHT;
((DIOInterscrollerPlacement*)placement).interscrollerOffset = [YOUR_OFFSET];

You also can customise ad unit look and behaviour to improve UX:

((DIOInterscrollerPlacement*)placement).dynamicHeader = @YES;
((DIOInterscrollerPlacement*)placement).showHeader = NO;
((DIOInterscrollerPlacement*)placement).reveal = NO;
((DIOInterscrollerPlacement*)placement).showTapHint = NO;

In order to control Interscroller behavior in case of switching between screens:

• Call [ad finish] to stop the ad and release the resources associated with it.
• Call [ad leave] to pause the video ad.
• Call [ad reenter] to resume the video ad.

In order to detect if Interscroller was clicked, subscribe to the <DIOAdClickDelegate> protocol and then define yourself as a delegate via:

ad.clickDelegate = self;

Finally, implement the following to be notified whenever relevant:

- (void)onAdClicked:(DIOAd*)ad;

Check the Sample App for a fully working example.

#import <DIOSDK/DIOHeadlineContainer.h>

#import <DIOSDK/DIOHeadlineView.h>
...

@property (nonatomic, strong) DIOHeadlineContainer *container;
@property (nonatomic, strong) DIOAd *ad;

DIOPlacement *placement = [[DIOController sharedInstance] 
                              placementWithId:@"<YOU_PLACEMENT_ID>"];

DIOAdRequest *request = [placement newAdRequest];

self.container = [[DIOHeadlineContainer alloc] init];

[self.container loadWithAdRequest:request completionHandler:^(DIOAd *ad){

    self.ad = ad; // Success

} errorHandler:^(NSError *error) {

    // Failure

}];

DIOHeadlineView *view = (DIOHeadlineView*)
                                            [self.container view];

if (!view.detached) {
    // Add to cell
}

[(DIOHeadlineView*)[self.container view] height];

((DIOHeadlinePlacement*)placement).backgroundColor = [UIColor...];
((DIOHeadlinePlacement*)placement).backgroundColorSnap = [UIColor...];
((DIOHeadlinePlacement*)placement).color = [UIColor...];
((DIOHeadlinePlacement*)placement).colorSnap = [UIColor...];

headlinePlacement.title = @"Some custom title
headlinePlacement.buttonText = @"Click me";
headlinePlacement.headlineMode = YES;
headlinePlacement.allowSwipeOff = NO;
headlinePlacement.showAdvertiser = YES;
headlinePlacement.headlineModeDuration = 25; //integer value

self.ad.clickDelegate = self;

- (void)onAdClicked:(DIOAd*)ad;

[ad showAdFromViewController:self eventHandler:^(DIOAdEvent event){
    switch (event) {
        case DIOAdEventOnShown:
            // integration code
            break;
        case DIOAdEventOnFailedToShow:
            // integration code
            break;
        case DIOAdEventOnClicked:
            // integration code
            break;
        case DIOAdEventOnClosed:
            // integration code
            break;
        case DIOAdEventOnAdCompleted:
            // integration code
            break;
        case DIOAdEventOnMuted:            
            // integration code            
            break;        
        case DIOAdEventOnUnmuted:            
            // integration code            
            break; 
    }
}];

    interstitialPlacement.skippableIn = 10;  // video setting (max value will be applied: skippableIn or video duration)
    interstitialPlacement.closeButtonDelay = 12;  //display setting

[ad view];

[[ad view] height];

((DIOInFeedPlacement*)placement).fullWidth = YES;

((DIOInFeedPlacement*)placement).framed = YES;

((DIOInFeedPlacement*)placement).showTimer = NO;

ad.clickDelegate = self;

- (void)onAdClicked:(DIOAd*)ad;

[ad view];

ad.clickDelegate = self;

- (void)onAdClicked:(DIOAd*)ad;

[ad view];

ad.clickDelegate = self;

- (void)onAdClicked:(DIOAd*)ad;