Flutter のバナーインテグレーション

前提条件

• LevelPlay Flutter プラグインがアプリケーションに正しく統合されていることを確認します。
• LevelPlay 初期化 API を使用して SDK を初期化していることを確認します。
• LevelPlay ダッシュボードで AdUnitID を見つけます。

バナー広告オブジェクトの作成とサイズの設定

onInitSuccess

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

バナーサイズ

• 画面幅に合わせて調整できる適応型広告サイズ（推奨）：このオプションは、デバイスタイプに応じて バナー または LeaderBOARD を返すため、"SMART" インテグレーションに置き換わります。適応型機能 (Google、Yandex) をサポートするネットワークは、最適化ロジックに基づいて高ささを返します。

  LevelPlayAdSize adSize = await LevelPlayAdSize.createAdaptiveAdSize();

• 固定幅広告サイズを使用した適応型広告サイズ:このオプションを使用すると、特定の幅を設定できます。適応型バナー特徴 (Google、Yandex) をサポートするネットワークは、指定された幅に基づく最適化ロジックに基づいて高ささを返します。他のすべてのネットワークは、指定された幅に応じたフォールバック サイズ（バナーまたは LeaderBOARD）を返します。

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

• 特定のバナーサイズ：このオプションでは、バナーサイズ（バナー、大、中）を指定できます。

  LevelPlayAdSize adSize = LevelPlayAdSize.MEDIUM_RECTANGLE;

Placements

loadAd

バナーの設定

• 推奨されるベストプラクティスは、バナー広告をロードする前にリスナーを設定することです。
• バナー広告ごとに独自のリスナーを実装する必要があります。
• コールバックはメインスレッドで実行されます。

/** バナーがロードされた後に呼び出されます。 @param adInfo 広告の情報。 */ @overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {}/** バナーのロードに失敗した後に呼び出されます。 @param error エラーに関する情報 */ @overridevoid onAdLoadFailed(LevelPlayAdError error) {}/** 画面が表示されることを通知します。 @param adInfo 広告の情報。 */ @overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {}/** 画面ディスプレイに失敗したことを通知します。 @param adInfo 広告の情報。 @param error エラーに関する情報 */ @overridevoid onAdDisplayFailed(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}/** ユーザーがバナー広告をクリックしたときに呼び出されます。 @param adInfo 広告の情報。 */ @overridevoid onAdClicked(LevelPlayAdInfo adInfo) {}/** 広告が全画面で開きます。 @param adInfo 広告の情報。 */ @overridevoid onAdExpanded(LevelPlayAdInfo adInfo) {}/** 広告が元のサイズに復元されます。 @param adInfo 広告の情報。 */ @overridevoid onAdCollapsed(LevelPlayAdInfo adInfo) {}/** ユーザーが広告をクリックし、アプリケーション外に移動した。 @param adInfo 広告の情報。 */ @overridevoid onAdLeftApplication(LevelPlayAdInfo adInfo) {}

ロードバナー広告

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

onPlatformViewCreated is called

バナー更新の一時停止と再開

• pauseAutoRefresh

  ：バナー広告の自動更新を一時停止します。

• resumeAutoRefresh

  ：バナー広告が一時停止された後、自動更新が再開されます。

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

バナー広告の破棄

destroy

LevelPlayBannerAdView

_bannerKey.currentState?.destroy();

バナー広告の完全な実装例

  // 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      子:LevelPlayBannerAdView(        key: _bannerKey,        adUnitId:'YOUR_AD_UNIT_ID',        adSize: adSize,        聞き手：これ        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 デモアプリケーション

次のステップ

• メディエーションネットワークの追加
• リワード広告
• インタースティシャル広告
• ネイティブ広告