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.

In order to get Interscroller UIView use:

[ad view];

Then insert the view into your ad’s placeholder or directly into the cell content view. See the example:

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


   // ScrollView integration
UIView *view = [self.ad view];
[self.adsView addSubview:view];


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

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

By default, the header of a Interscroller uses 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).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).headerText = @"Sponsored";
((DIOInterscrollerPlacement*)placement).dynamicHeader = @YES; 
((DIOInterscrollerPlacement*)placement).showHeader = NO;
((DIOInterscrollerPlacement*)placement).reveal = NO;
((DIOInterscrollerPlacement*)placement).showTapHint = NO;
((DIOInterscrollerPlacement*)placement).headerText = @"Custom header";
((DIOInterscrollerPlacement*)placement).headerFont = [UIFont boldSystemFontOfSize:24];

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.

Check the Sample App for a fully working example.

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

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

[ad view];

[[ad view] height];

((DIOVideoAd*)ad).ctaText = @"Custom Text";

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

((DIOInFeedPlacement*)placement).customWidth = 150;

DIOInFeedPlacement* inFeedPlacement = (DIOInFeedPlacement*)placement;
//customize UI
inFeedPlacement.frameBackgroundInfeedColor = UIColor.cyanColor;
inFeedPlacement.frameBackgroundHeadlineColor = UIColor.purpleColor;
inFeedPlacement.ctaButtonInfeedColor = UIColor.orangeColor;
inFeedPlacement.ctaButtonHeadlineColor = UIColor.blueColor;
inFeedPlacement.ctaButtonContourInfeedColor = UIColor.redColor;
inFeedPlacement.ctaButtonContourHeadlineColor = UIColor.systemTealColor;
inFeedPlacement.ctaButtonTextInfeedColor = UIColor.darkGrayColor;
inFeedPlacement.ctaButtonTextHeadlineColor = UIColor.brownColor;
inFeedPlacement.adLabelTextInfeedColor = UIColor.blueColor;
inFeedPlacement.adLabelTextHeadlineColor = UIColor.greenColor;
inFeedPlacement.bottomLineColor = UIColor.blackColor;
inFeedPlacement.ctaButtonTextFont =[UIFont systemFontOfSize:24];
inFeedPlacement.adLabelTextFont =[UIFont systemFontOfSize:6];
inFeedPlacement.advertiserNameFont =  [UIFont systemFontOfSize:6];
inFeedPlacement.advertiserNameHeadlineColor =  UIColor.blueColor;
  // end customize UI

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

[ad view];

[ad view];

Here you can find working sample code for quick and easy integration.

Follow the link.

1. Add the adapter to your project:

target 'YourProjectName' do
 pod 'GAM-DIO-Adapter', '4.4.3'
end

Or manually download source and add required files from “DIOAdapterGoogleAds” to your project.

Optionally you can add GAM Adapter using SPM. Enter the repository URL: https://github.com/displayio/iOSMediationAdapters and choose GAM-DIO-Adapter product to be added to your target.

Follow our guide to install and initialize DisplayIO SDK.

B. GAM Setup Guide

1. Navigate to “Admin” in your Google Ad Manager account

While in Admin create a “New Company” in the “Companies” section.
Choose type “Other company”, input the name “DisplayIO Custom Network” and turn on the “Mediation” toggle.

2. Create a New Yield Group

Select “Banner” for any inline or infeed ad unit or “Interstitial” for full screen ads.
Full Ad Unit Mapping Guide:

	display.io	GAM
	Interscroller	Banner
	Headline	Banner
	Interstitial	Interstitial
	Infeed	Banner
	Medium Rectangle	Banner
	Banner	Banner

3. Add Yield Partner
Add DisplayIO as a yield partner in the Yield Group.
Then link the created Yield Group to the ad unit you wish GAM to mediate.
If you require more instruction on this please consult this Google Ad Manager reference or reach out to your display.io integration support specialist.

4. Add Yield Partner to Yield Group

Basic Inputs

Integration Type: “Custom Event”
Platform: “iOS”
Status: “Active”
Default CPM: “100” (This number is just a placeholder, please consult your Display.io Account Manager for correct rate)

Additional Yield Partner Details

Define Custom Class Name:
DIOCustomEvent

Parameter:
Define JSON formatted string and replace parameters <APP_ID> and <PLACEMENT_ID>.

Both ID’s can be found in your display.io account or requested from your integration manager.

For Example:
{"appID" : "6494", "placementID" : "6430"}

5. Create a new ad unit

Specify the newly created DisplayIO network as a source and ensure the auto-refreshing option is disabled. Set DisplayIO network as priority over all other sources including Google.

6. Traffic Ad Unit
Follow the Banner or Interstitial tutorials in order to get ads from Google Ad Manager.

7.  Use Adaptive Banner tutorial to implement Interscroller ad unit.

//Interscroller requires full width banner view
GADAdSize adSize = GADCurrentOrientationInlineAdaptiveBannerAdSizeWithWidth(self.view.frame.size.width);
self.bannerView = [[GAMBannerView alloc] initWithAdSize:adSize];

C. Advanced Ad Unit Customization

1. Customizing the user experience of Interscroller 

Interscroller contains a ‘reveal’ or parallax user experience when scrolled. This is set to “True” by default and it is recommended to maintain this experience.

However you can chose to turn off these behaviors using the following method

For example:
{"appID" : "6494", "placementID" : "6430", "isReveal" : false , "showHeader" : false, "showTapHint" : false}

2. Customize Interscroller on placement level

To customize Interscroller ad unit on placement level retrieve Placement object after DIO SDK initialization:

DIOPlacement *placement = [[DIOController sharedInstance] placementWithId:@"YOUR_PLACEMENT_ID"];

   #import <DIOSDK/DIOController.h>
   #import "DIOCustomEvent.h"

    //example of how to add a custom ad request to GAM request
    DIOAdRequest *dioAdRequest = [[DIOAdRequest alloc] init];
    [dioAdRequest setUserId:@"some user id"];
    DIOCustomEvent *customEventExtras = [[DIOCustomEvent alloc] init];
    [customEventExtras setExtras:@{DIO_AD_REQUEST: dioAdRequest} forLabel:DIO_CUSTOM_EVENT];
    [request registerAdNetworkExtras: customEventExtras]; //must be set before call request ad

iOS AdMob Mediation Adapter supports all display.io Ad Units.

AdMob/ display.io ad units mapping:

	display.io	AdMob
	Interscroller	Banner
	Interstitial	Interstitial
	Infeed	Banner
	Medium Rectangle	Banner
	Banner	Banner

To set it up:

1. Add the adapter to your project:

target 'YourProjectName' do
 pod 'GAM-DIO-Adapter', '4.4.3'
end

Or download source and add required files from “Classes” to your project.

2. Create a Google AdMob account and register an app

3. Use Quick Start guide to setup AdMob SDK

4a. Interstitial: create a mediation group for Interstitial / iOS

• Add an ad unit;
• Cancel Real-time eCPM for Admob network;
• Add custom event: In “Class Name” enter DIOInterstitialAdapter and in “Parameter” enter the relevant Placement ID.

4b. Banner: create a mediation group for Banner / iOS

• Add an ad unit;
• Cancel Real-time eCPM for Admob network;
• Add custom event: In “Class Name” enter DIOBannerAdapter and in “Parameter” enter the relevant Placement ID.

4c. Medium Rectangle: create a mediation group for Banner / iOS

• Add an ad unit;
• Cancel Real-time eCPM for Admob network;
• Add custom event: In “Class Name” enter DIOMediumRectangleAdapter and in “Parameter” enter the relevant Placement ID.

4d. Infeed: create a mediation group for Infeed/ iOS

• Add an ad unit;
• Cancel Real-time eCPM for Admob network;
• Add custom event: In “Class Name” enter DIOInFeedAdapter and in “Parameter” enter the relevant Placement ID.

4e. Interscroller: create a mediation group for Interscroller/ iOS

• Add an ad unit;
• Cancel Real-time eCPM for Admob network;
• Add custom event: In “Class Name”enter DIOInterscrollerAdapter and in “Parameter” enter the relevant Placement ID.

5. Disable the automatic-refresh in AdMob ad unit settings (under advanced settings).

6. Initialize DIO SDK and start AdMob SDK:

[[DIOController sharedInstance] initializeWithProperties:nil appId:@"<YOUR APP ID>" completionHandler:^{
 // DIO initialized
 [[GADMobileAds sharedInstance] startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status){
 // GAD started
 }];
} errorHandler:^(NSError *error) {
 // Failure
}];

6a. Get Interstitial ads from AdMob based on tutorial.

6b. Get Banner ads from AdMob based on tutorial.

6c. Get Medium Rectangle ads from AdMob based on tutorial

6d. Get Infeed ads from AdMob based on the following:

#import <GoogleMobileAds/GoogleMobileAds.h>
#import <DIOSDK/DIOController.h>
@interface TableViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GADBannerView *bannerView;
@end

@implementation TableViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    self.navigationController.navigationBar.translucent = NO;    

    [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"Cell1"];
    [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"Cell2"];

    self.bannerView = [[GADBannerView alloc] initWithAdSize:kGADAdSizeMediumRectangle];
    self.bannerView.delegate = self;
    self.bannerView.adUnitID = @"<YOUR_AD_UNIT_ID>";
    self.bannerView.rootViewController = self;

    dispatch_async(dispatch_get_main_queue(), ^{
        GADRequest *request = [GADRequest request];
        request.testDevices = @[kGADSimulatorID];
        [self.bannerView loadRequest:request];
    });
}

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    [[DIOController sharedInstance] finishAllAds];
}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
  return 30;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    if (indexPath.row == 15) {
        UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"Cell1" forIndexPath:indexPath];
        cell.selectionStyle = UITableViewCellSelectionStyleNone;   

        if (cell.contentView.subviews.count > 0) [cell.contentView.subviews[0] removeFromSuperview];
        [cell.contentView addSubview:self.bannerView];        

        self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
        [cell.contentView.leadingAnchor constraintEqualToAnchor:self.bannerView.leadingAnchor].active = YES;
        [cell.contentView.trailingAnchor constraintEqualToAnchor:self.bannerView.trailingAnchor].active = YES;
        [cell.contentView.topAnchor constraintEqualToAnchor:self.bannerView.topAnchor].active = YES;
        [cell.contentView.bottomAnchor constraintEqualToAnchor:self.bannerView.bottomAnchor].active = YES;
      
        return cell;
    }    

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"Cell2" forIndexPath:indexPath];
    cell.selectionStyle = UITableViewCellSelectionStyleNone;
    cell.textLabel.text = @"Simple Cell";  

    return cell;
}

/*
 * For infeed, use the following:
 */

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    if (indexPath.row == 15) {
        CGFloat ratio = 300 / 250.0;     

        if (CGRectGetHeight(self.tableView.frame) < CGRectGetWidth(self.tableView.frame)) {
            return CGRectGetHeight(self.tableView.frame) / ratio;
        } else {
            return CGRectGetWidth(self.tableView.frame) / ratio;
        }
    }
   
    return UITableViewAutomaticDimension;
}

@end

6e. Get Interscroller ads from AdMob based on the following:

UITablevView integration:

#import "InterscrollerViewController.h"
#import <GoogleMobileAds/GoogleMobileAds.h>
#import <DIOSDK/DIOController.h>
#import <DIOSDK/DIOInterscrollerView.h>
#import "DIOInterscrollerAdapter.h"

@interface InterscrollerViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GADBannerView *bannerView;
@end

@implementation InterscrollerViewController

DIOInterscrollerView *dioView;

- (void)viewDidLoad {
    [super viewDidLoad];
    self.navigationController.navigationBar.translucent = NO;
    [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"Cell1"];
    [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"Cell2"];
    
    self.bannerView = [[GADBannerView alloc] initWithAdSize:kGADAdSizeMediumRectangle];
    self.bannerView.delegate = self;
    self.bannerView.adUnitID = @"ca-app-pub-1186601170998955/8184589468";
    self.bannerView.rootViewController = self;

    dispatch_async(dispatch_get_main_queue(), ^{
        GADRequest *request = [GADRequest request];
        [self.bannerView loadRequest:request];
    });
}

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    [[DIOController sharedInstance] finishAllAds];
}

- (void)bannerViewDidReceiveAd:(nonnull GADBannerView *)bannerView{
    dioView = [DIOInterscrollerAdapter getInterscrollerViewForTableView:bannerView
                                            withInterscrollerSize:CGSizeMake(self.view.frame.size.width, self.view.frame.size.height)
                                            withBaseSize:kGADAdSizeMediumRectangle];
}

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
    return 1;
}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return 39;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    if (indexPath.row > 0 && indexPath.row % 20 == 0) {
        UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"Cell1" forIndexPath:indexPath];
        cell.selectionStyle = UITableViewCellSelectionStyleNone;
        [cell.contentView addSubview:self.bannerView];
        [cell.contentView.leadingAnchor constraintEqualToAnchor:self.bannerView.leadingAnchor].active = YES;
        [cell.contentView.trailingAnchor constraintEqualToAnchor:self.bannerView.trailingAnchor].active = YES;
        [cell.contentView.topAnchor constraintEqualToAnchor:self.bannerView.topAnchor].active = YES;
        [cell.contentView.bottomAnchor constraintEqualToAnchor:self.bannerView.bottomAnchor].active = YES;
        return cell;
    }

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"Cell2" forIndexPath:indexPath];
    cell.selectionStyle = UITableViewCellSelectionStyleNone;
    cell.textLabel.text = @"Simple Cell";
    return cell;
}

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    return UITableViewAutomaticDimension;
}

@end

UIScrollView integration:

@implementation InterscrollerScrollViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    self.navigationController.navigationBar.translucent = NO;
    self.bannerView = [[GADBannerView alloc] initWithAdSize:kGADAdSizeMediumRectangle];
    self.bannerView.delegate = self;
    self.bannerView.adUnitID = @"ca-app-pub-1186601170998955/8184589468";
    self.bannerView.rootViewController = self;
    [self.adsView addSubview:self.bannerView];

    dispatch_async(dispatch_get_main_queue(), ^{
        GADRequest *request = [GADRequest request];
        [self.bannerView loadRequest:request];
    });
}

- (void) viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    [[DIOController sharedInstance] finishAllAds];
}

- (void)bannerViewDidReceiveAd:(nonnull GADBannerView *)bannerView{
        self.dioView = [DIOInterscrollerAdapter getInterscrollerViewForScrollView:bannerView
                                               withInterscrollerSize:CGSizeMake(self.scrollView.frame.size.width, self.scrollView.frame.size.height)
                                                        withBaseSize:kGADAdSizeMediumRectangle];
}

- (void)close:(id)sender {
    [self dismissViewControllerAnimated:YES completion:nil];
}

@end

In order to stop Infeed or Interscroller ads, and release all the resources associated with it (for example when leaving the screen) call:

[[DIOController sharedInstance] finishAllAds];