Banner 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 Banner Ad Object and Set Size

onInitSuccess

final GlobalKey<LevelPlayBannerAdViewState> _bannerKey = GlobalKey<LevelPlayBannerAdViewState>();@overrideWidget build(BuildContext context) {     return SizedBox(          width: _adSize.width.toDouble(),          height: _adSize.height.toDouble(),          child: LevelPlayBannerAdView(            key: _bannerKey,            adUnitId: [YOUR_AD_UNIT_ID],            adSize: [YOUR_AD_SIZE],            listener: [YOUR_LISTENER],            placementName: [YOUR_PLACEMENT], // optional            onPlatformViewCreated:[YOUR_LOAD_BANNER_METHOD] // optional          ),        );}

Banner Sizes

• Adaptive ad size that adjusts to the screen width (recommended): This option replaces the “SMART” integration, as it will return BANNER or LEADERBOARD according to the device type. Networks that support adaptive features (Google, Yandex) will return a height based on their optimization logic.

  LevelPlayAdSize adSize = await LevelPlayAdSize.createAdaptiveAdSize();

• Adaptive ad size using fixed width ad size: This option allows you to set a specific width. Networks that support adaptive- banner feature (Google, Yandex) will return a height based on their optimization logic based on the provided width. All other networks will return the fallback size (either BANNER or LEADERBOARD) according to the width provided.

  LevelPlayAdSize adSize = await LevelPlayAdSize.createAdaptiveAdSize(width: 400);

• Specific banner size: This option allows you to set specifically a banner size: banner, large, medium.

  LevelPlayAdSize adSize = LevelPlayAdSize.MEDIUM_RECTANGLE;

Placements

loadAd

Set Banner Listener

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

/** Called after a banner has been loaded. @param adInfo The info of the ad. */ @overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {}/** Called after a banner has failed to load. @param error The information about the error. */ @overridevoid onAdLoadFailed(LevelPlayAdError error) {}/** Notifies the screen is displayed. @param adInfo The info of the ad. */ @overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {}/** Notifies the screen failed to display. @param adInfo The info of the ad. @param error The information about the error.  */ @overridevoid onAdDisplayFailed(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}/** Invokes when the user clicks on the banner ad. @param adInfo The info of the ad. */ @overridevoid onAdClicked(LevelPlayAdInfo adInfo) {}/** Ad is opened on full screen. @param adInfo The info of the ad. */ @overridevoid onAdExpanded(LevelPlayAdInfo adInfo) {}/** Ad is restored to its original size. @param adInfo The info of the ad. */ @overridevoid onAdCollapsed(LevelPlayAdInfo adInfo) {}/** User pressed on the ad and was navigated out of the app. @param adInfo The info of the ad. */ @overridevoid onAdLeftApplication(LevelPlayAdInfo adInfo) {}

Load Banner Ad

// Load the banner ad _bannerKey.currentState?.loadAd();

onPlatformViewCreated is called

Pause and Resume Banner Refresh

• pauseAutoRefresh

  : pauses auto refresh of the banner ad.

• resumeAutoRefresh

  : resumes auto refresh of the banner ad after it has been paused.

// Pause refresh _bannerKey.currentState?.pauseAutoRefresh(); // Resume refresh _bannerKey.currentState?.resumeAutoRefresh();

Destroy Banner Ad

destroy

LevelPlayBannerAdView

_bannerKey.currentState?.destroy();

Full Implementation Example of Banner Ads

  // Start of the widget...  final _bannerKey = GlobalKey<LevelPlayBannerAdViewState>();  final adSize = LevelPlayAdSize.BANNER;  @override  Widget build(BuildContext context) {    return SizedBox(      width: adSize.width.toDouble(), // Get actual banner layout width size      height: adSize.height.toDouble(), // Get actual banner layout height size      child: LevelPlayBannerAdView(        key: _bannerKey,        adUnitId: 'YOUR_AD_UNIT_ID',        adSize: adSize,        listener: this,        placementName: 'YOUR_PLACEMENT',        onPlatformViewCreated: () {	// In this implementation we call loadAd on the key,            // it is also possible to store the LevelPlayBannerAdView widget            // in a variable and call loadAd on it as described above in the docs.          _bannerKey.currentState?.loadAd();         },      ),    );  }  @override  void onAdClicked(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdCollapsed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdDisplayFailed(LevelPlayAdInfo adInfo, LevelPlayAdError error) {    // Implement your logic here...  }  @override  void onAdDisplayed(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdExpanded(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdLeftApplication(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  @override  void onAdLoadFailed(LevelPlayAdError error) {    // Implement your logic here...  }  @override  void onAdLoaded(LevelPlayAdInfo adInfo) {    // Implement your logic here...  }  // End of widget...

LevelPlay Mediation Demo App

Next steps

• Add Mediation Networks
• Rewarded Ads
• Interstitial Ads
• Native Ads