Interstitial Ads

Interstitial Ads are loaded automatically. You can observe ad loading events by specifying the delegate:

Objective-C

BIDInterstitial *interstitial = [BIDInterstitial new];
interstitial.loadDelegate = loadDelegate;

Swift

let interstitial = BIDInterstitial()
interstitial.loadDelegate = loadDelegate

The delegate should implement the following methods:

Objective-C

#pragma mark - BIDFullscreenLoadDelegate protocol methods

- (void)didLoadAd:(BIDAdInfo*)adInfo
{
    NSLog(@"Interstitial - didLoadAd. AdInfo: %@", adView, adInfo);
}

- (void)didFailToLoadAd:(BIDAdInfo*)adInfo error:(NSError *)error
{
    NSLog(@"Interstitial - didFailToLoadAd. AdInfo: %@. Error: %@", adInfo, error);
}

Swift

//BIDFullscreenLoadDelegate protocol methods

func didLoadAd(_ adInfo: BIDAdInfo) {
    print("Interstitial - didLoadAd. AdInfo: \(adInfo)")
}
    
func didFail(toLoadAd adInfo: BIDAdInfo, error: Error) {
    print("Interstitial - didFailToLoadAd. AdInfo: \(adInfo). Error: \(error)")
}

Showing an Interstitial Ad

To show an interstitial ad, call showWithDelegate instance method of the BIDInterstitial class:

Objective-C

[interstitial showWithDelegate:theDelegate];

Swift

interstitial.show(with: theDelegate)

The delegate should implement the following methods:

Objective-C

#pragma mark - BIDInterstitialDelegate protocol mehods

//TODO: simplify this method. It should simply return the appropriate View Controller to display ad
- (UIViewController*)viewControllerForDisplayAd
{
    return viewController;
}

- (void)didDisplayAd:(BIDAdInfo*)adInfo
{
    NSLog(@"Interstitial - didDisplayAd. AdInfo: %@", adView, adInfo);
}

- (void)didClickAd:(BIDAdInfo*)adInfo
{
    NSLog(@"Interstitial - didClickAd. AdInfo: %@", adView, adInfo);
}

- (void)didHideAd:(BIDAdInfo*)adInfo
{
    NSLog(@"Interstitial - didHideAd. AdInfo: %@", adView, adInfo);
}

- (void)didFailToDisplayAd:(BIDAdInfo*)adInfo error:(NSError *)error
{
    NSLog(@"Interstitial - didFailToDisplayAd. AdInfo: %@ Error: %@", adInfo, error);
}

-(void)allNetworksDidFailToDisplayAd
{
    NSLog(@"Interstitial - allNetworksDidFailToDisplayAd");
}

Swift

//BIDInterstitialDelegate protocol mehods
    
//TODO: simplify this method. It should simply return the appropriate View Controller to display ad
func viewControllerForDisplayAd() -> UIViewController {
    return viewController;
}
    
func didDisplayAd(_ adInfo: BIDAdInfo) {
    print("Interstitial - didDisplayAd. AdInfo: \(adInfo)")
}
    
func didClickAd(_ adInfo: BIDAdInfo) {
    print("Interstitial - didClickAd. AdInfo: \(adInfo)")
}
    
func didHideAd(_ adInfo: BIDAdInfo) {
    print("Interstitial - didHideAd. AdInfo: \(adInfo)")
}
    
func didFail(toDisplayAd adInfo: BIDAdInfo, error: Error) {
    print("Interstitial - didFail toDisplayAd. AdInfo: \(adInfo). Error: \(error)")
}
    
func allNetworksDidFailToDisplayAd() {
    print("Interstitial - allNetworksDidFailToDisplayAd.")
}

Stopping and Starting Auto-Load

By default, Interstitials preload ads before any load attempt. So an Interstitial can use already preloaded ads instead of waiting on a manual load call to load new ads. To disable this feature you need to call the following method:

Objective-C

interstitial.autoload = NO;

Swift

interstitial.autoload = false

Once you disable autoload, you should load ads manually every time you need them to show:

Objective-C

[interstitial load];

Swift

interstitial.load()