Interstitial
Learn how to add and configure an interstitial placement and implement additional features through the SDK interface.
Key features
Interstitial placements cover the app completely and are easy to integrate. Because they overlay your app, you can show them without considering how they fit with the app UI. Choose either a dialog or bottom sheet UI to suit your design.


Integration
Follow these steps to integrate an interstitial placement.
Step 1. Prepare
- Complete Getting started.
- Obtain a Unit ID for the interstitial placement (referred to below as
YOUR_INTERSTITIAL_UNIT_ID).
Step 2. Allocate and display ads
Follow these steps to allocate and display ads in an interstitial placement.
- Choose an interstitial UI type and create
BuzzInterstitial.
- Dialog UI: Set
typetodialog. - Bottom sheet UI: Set
typetobottomSheet.
-
Call
loadto allocate an ad. -
Call
presentOnViewControllerto display the ad.
import UIKit
import BuzzvilSDK
final class ViewController: UIViewController, BuzzInterstitialDelegate {
private lazy var buzzAdInterstitial = BuzzInterstitial(unitId: "YOUR_INTERSTITIAL_UNIT_ID", type: .dialog)
override func viewDidLoad() {
super.viewDidLoad()
buzzAdInterstitial.delegate = self
buzzAdInterstitial.load()
}
}
extension ViewController: BuzzInterstitialDelegate {
func BuzzInterstitialDidLoadAd(_ interstitial: BuzzInterstitial) {
// 할당된 광고가 있으면 호출됩니다.
// Interstitial 광고를 화면에 표시합니다.
interstitial.present(on: self)
}
func BuzzInterstitialDidFail(toLoadAd interstitial: BuzzInterstitial, withError error: Error) {
// 할당된 광고가 없으면 호출됩니다.
}
func BuzzInterstitialDidDismiss(_ viewController: UIViewController) {
// Interstitial 지면이 종료되면 호출됩니다.
// 필요에 따라 추가 기능을 구현하세요.
}
}
@import BuzzvilSDK;
@interface ViewController () <BuzzInterstitialDelegate>
@property (nonatomic, strong, readonly) BuzzInterstitial *buzzAdInterstitial;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
_buzzAdInterstitial = [[BuzzInterstitial alloc] initWithUnitId:@"YOUR_INTERSTITIAL_UNIT_ID" type:BuzzInterstitialTypeDialog];
_buzzAdInterstitial.delegate = self;
[_buzzAdInterstitial load];
}
#pragma mark - BuzzInterstitialDelegate
- (void)BuzzInterstitialDidLoadAd:(BuzzInterstitial *)interstitial {
// 할당된 광고가 있으면 호출됩니다.
// Interstitial 광고를 화면에 표시합니다.
[interstitial presentOnViewController:self];
}
- (void)BuzzInterstitialDidFailToLoadAd:(BuzzInterstitial *)interstitial withError:(NSError *)error {
// 할당된 광고가 없으면 호출됩니다.
}
- (void)BuzzInterstitialDidDismiss:(UIViewController *)viewController {
// Interstitial 지면이 종료되면 호출됩니다.
// 필요에 따라 추가 기능을 구현하세요.
}
@end
Change the BuzzBenefit entry point UI color
The interstitial placement includes a UI element that directs users to BenefitHub. Clicking this entry point opens BenefitHub.

The primary colors of the interstitial placement follow the global theme. See Global theme for details.

Step 3. Test the basic integration
After completing the basic integration, check that ads are allocated and displayed correctly. Also verify that clicking the BenefitHub entry point opens BenefitHub.
Additional features
Set the number of ads
A bottom sheet interstitial can display up to five ads from a single ad request.
The number of ads can be configured on Buzzvil's server without code changes. To display multiple ads, send your preferred number to your Buzzvil representative at help@buzzvil.com.
