Interstitial integration for Flutter

Prerequisites

• Ensure that you have correctly integrated the LevelPlay Flutter Plug-in into your app.
• Ensure that you initialize the SDK using LevelPlay Initialization API.
• Find the AdUnitID in LevelPlay dashboard.

Create Interstitial and Register to Events

onInitSuccess

final LevelPlayInterstitialAd _interstitialAd = LevelPlayInterstitialAd(adUnitId: [YOUR_AD_UNIT]);@overridevoid initState() {    super.initState();    _interstitialAd.setListener(this);}

Set Interstitial Listener

LevelPlayInterstitialAdListener

• The recommended best practice is to set the listener before loading the interstitial ad.
• Each interstitial ad must have its own listener implementation.
• Callbacks run on the main thread.

  @overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {  // Provided when the ad is successfully loaded}@overridevoid onAdLoadFailed(LevelPlayAdError error) {  // Provided when the ad fails to load. Ad Unit information is included}@overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {  // Provided when the ad is displayed. This is equivalent to an impression}@overridevoid onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {  // Provided when the ad fails to be displayed}@overridevoid onAdClicked(LevelPlayAdInfo adInfo) {  // Provided when the user clicks on the ad}@overridevoid onAdClosed(LevelPlayAdInfo adInfo) {  // Provided when the ad is closed}@overridevoid onAdInfoChanged(LevelPlayAdInfo adInfo) {  // Provided when the ad info is updated. Available when another ad has loaded, and includes a higher CPM/Rate}

Load Interstitial Ad

loadAd

_interstitialAd.loadAd();

Show Interstitial Ad

onAdLoaded

showAd

• It is required to share Activity. 
• If using placements, pass the placement name in the showAd API as shown in the Placements section below.
• After the ad has been successfully displayed to the user, you can load another ad by repeating the loading step. 

// Show ad without placement _interstitialAd.showAd(); // Show ad with placement _interstitialAd.showAd(placement: [YOUR_PLACEMENT]);

Check Ad is Ready

showAd

• isAdReady

  : Returns true if ad was loaded successfully and ad unit is not capped, or false otherwise.

• isPlacementCapped

  : Returns true when a valid placement is capped. If the placement is not valid, or not capped, this API will return false.

// Check that ad is ready and that the placement is not capped if(_interstitialAd.isAdReady() && !LevelPlayInterstitialAd.isPlacementCapped([YOUR_PLACEMENT])) {     _interstitialAd.showAd(placement:[YOUR_PLACEMENT]); }

Placements

showAd

// Check that ad is ready and that the placement is not capped if(_interstitialAd.isAdReady() && !LevelPlayInterstitialAd.isPlacementCapped([YOUR_PLACEMENT])) {     _interstitialAd.showAd(placement:[YOUR_PLACEMENT]); }

Full Implementation Example of Interstitial Ads

// Start of the widget...final LevelPlayInterstitialAd _interstitialAd = LevelPlayInterstitialAd(adUnitId: 'YOUR_AD_UNIT_ID');  @override  void initState() {    super.initState();    _interstitialAd.setListener(this);    _interstitialAd.loadAd();  }  @override  void onAdClicked(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdClosed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdDisplayed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdInfoChanged(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdLoadFailed(LevelPlayAdError error) {    // Implement your logic here...  }  @override  void onAdLoaded(LevelPlayAdInfo adInfo) {    // Implement your logic here, for example showing the ad    _interstitialAd.showAd();  }  // Rest of the widget  // End of widget...

LevelPlay Mediation Demo App

Next steps

• Add Mediation Networks
• Rewarded Ads
• Banner Ads
• Native Ads