バナーおよびMREC広告

次のセクションでは、バナーまたはMREC広告をロードし、表示または非表示にする方法について説明します。

バナーまたはMRECのローディング

以下のコードは、広告ユニットID、希望する広告表示位置、バナーの場合は希望する背景色を使用して、バナーまたはミディアムレクタングル（MREC）広告をロードする方法を示したものです。MAXは自動的に広告のサイズを調整します。

バナー
MRECs

final String _banner_ad_unit_ID = Platform.isAndroid ? "«Android-banner-ad-unit-ID»" : "«iOS-banner-ad-unit-ID»";

function initializeBannerAds()
{
  // MAX automatically sizes banners to 320×50 on phones and 728×90 on tablets
  AppLovinMAX.createBanner(_banner_ad_unit_ID, AdViewPosition.bottomCenter);
}

final String _mrec_ad_unit_ID = Platform.isAndroid ? "«Android-MREC-ad-unit-ID»" : "«iOS-MREC-ad-unit-ID»";

public void initializeMRecAds()
{
  // MAX sizes MRECs to 300×250 on phones and tablets
  AppLovinMAX.createMRec(_mrec_ad_unit_ID, AdViewPosition.bottomCenter);
}

バナーの表示

バナーを表示するには、showBanner()を呼び出します。

AppLovinMAX.showBanner(_banner_ad_unit_ID);

バナーを非表示にするには、hideBanner()を呼び出します。

AppLovinMAX.hideBanner(_banner_ad_unit_ID);

ウィジェットのメソッド

ウィジェットツリーでバナーやミディアムレクタングル広告（MREC）を直接レンダリングできます。

バナー
MRECs

final String _ad_unit_ID = Platform.isAndroid ? "«Android-ad-unit-ID»" : "«iOS-ad-unit-ID»";
MaxAdView(
  adUnitId: _ad_unit_ID,
  adFormat: AdFormat.banner,
  listener: AdViewAdListener(onAdLoadedCallback: (ad) {
    ⋮
  }, onAdLoadFailedCallback: (adUnitId, error) {
    ⋮
  }, onAdClickedCallback: (ad) {
    ⋮
  }, onAdExpandedCallback: (ad) {
    ⋮
  }, onAdCollapsedCallback: (ad) {
    ⋮
  })
)

final String _ad_unit_ID = Platform.isAndroid ? "«Android-ad-unit-ID»" : "«iOS-ad-unit-ID»";
MaxAdView(
  adUnitId: _ad_unit_ID,
  adFormat: AdFormat.mrec,
  listener: AdViewAdListener(onAdLoadedCallback: (ad) {
    ⋮
  }, onAdLoadFailedCallback: (adUnitId, error) {
    ⋮
  }, onAdClickedCallback: (ad) {
    ⋮
  }, onAdExpandedCallback: (ad) {
    ⋮
  }, onAdCollapsedCallback: (ad) {
    ⋮
  })
)

広告のプリロード

Flutter プラグインバージョン 3.11.1 では、MaxAdViewをマウントする前に、プラットフォームウィジェットに広告をプリロードできます。プリロードした広告ユニットIDでMaxAdViewをマウントすると、プリロードしたプラットフォームウィジェットでMaxAdViewが構成され、広告を素早く表示できるようになります。

Flutterプラグインバージョン4.1.0では、このプリロード機能で複数のMaxAdViewインスタンスをサポートできるようになりました。 preloadWidgetAdView()メソッドはAdViewIdを返します。これは、MaxAdViewのマウントでプリロードした広告を指定する際に使用できます。

バナー
MRECs

AppLovinMAX.preloadWidgetAdView(«ad-unit-ID», AdFormat.banner)
  .then((adViewId) {
    print('Started preloading a banner ad $(adViewId) for ${«ad-unit-ID»}');
  });

AppLovinMAX.preloadWidgetAdView(«ad-unit-ID», AdFormat.mrec)
  .then((adViewId) => {
    print('Started preloading a MREC ad $(adViewId) for ${«ad-unit-ID»}');
  });

MaxAdViewをマウントするときにAdViewIdを指定できます。

バナー
MRECs

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.banner,
  adViewId: «ad-view-ID»,
  listener: AdViewAdListener(onAdLoadedCallback: (ad) {
    print('Banner widget ad (${ad.adViewId}) loaded from ${ad.networkName}');
  }))

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.mrec,
  adViewId: «ad-view-ID»,
  listener: AdViewAdListener(onAdLoadedCallback: (ad) {
    print('MREC widget ad (${ad.adViewId}) loaded from ${ad.networkName}');
  }))

MaxAdViewをアンマウントしても、プリロードされたプラットフォームウィジェットは破棄されません。キャッシュされて、次のマウントで再利用されます。リソースを解放するには、不要なプラットフォームウィジェットを手動で破棄する必要があります。

バナー
MRECs

AppLovinMAX.destroyWidgetAdView(«ad-view-ID»)
  .then((_) {
    print('Destroyed the preloaded banner ad');
  });

AppLovinMAX.destroyWidgetAdView(«ad-view-ID»)
  .then((_) {
    print('Destroyed the preloaded MREC ad');
  });

AdViewIdを使用せずにMaxAdViewをマウントすると、コンポーネントが動的に広告をロードします。この場合、MaxAdViewをアンマウントすると自動的に破棄され、再利用はできません。

完全な実装例については、AppLovin-MAX-Flutter GitHubプロジェクトのサンプルアプリを参照してください。

アダプティブバナー

自動更新の停止と開始

広告を非表示にする場合や手動で更新する場合など、自動更新を停止したいときは以下のコードを使用します。

AppLovinMAX.showBanner(«ad-unit-ID»);
AppLovinMAX.stopBannerAutoRefresh(«ad-unit-ID»);

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.banner,
  isAutoRefreshEnabled: false,
  ⋮

AppLovinMAX.showMRec(«ad-unit-ID»);
AppLovinMAX.stopMRecAutoRefresh(«ad-unit-ID»);

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.mrec,
  isAutoRefreshEnabled: false,
  ⋮

以下のコードで、広告の自動更新を開始します。

AppLovinMAX.startBannerAutoRefresh(«ad-unit-ID»);

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.banner,
  isAutoRefreshEnabled: true,
  ⋮

AppLovinMAX.startMRecAutoRefresh(«ad-unit-ID»);

MaxAdView(
  adUnitId: «ad-unit-ID»,
  adFormat: AdFormat.mrec,
  isAutoRefreshEnabled: true,
  ⋮

ご利用規約 | プライバシー | EULA | DMCA | Cookie設定