廣告預先載入 (Beta 版)

選取平台： iOS Unity Flutter Android (舊版)

廣告預先載入是 Google Mobile Ads Flutter Plugin 中由 Google 管理的廣告載入功能，可代表您管理廣告載入和快取。如要預先載入廣告，您必須變更廣告載入的管理方式。如要使用廣告預先載入功能提升成效，請停用自訂快取，並將這項責任委派給 Google Mobile Ads Flutter Plugin。

相較於手動載入廣告，預先載入廣告具有下列優點：

  • 參照管理：保留已載入的廣告，因此您不必維護參照，直到準備好顯示廣告為止。
  • 自動重新載入：從快取中取出廣告時，系統會自動載入新廣告。
  • 管理重試：使用指數輪詢自動重試失敗的要求。
  • 到期處理：在廣告到期前 (通常是一小時後) 自動重新整理廣告。
  • 快取最佳化：如果使用的快取大小大於 1，Google Mobile Ads Flutter Plugin 會最佳化快取順序，放送成效最佳的廣告。

本指南說明如何設定預先載入廣告、檢查預先載入廣告是否可用，以及顯示預先載入廣告。

必要條件

請先設定 Google Mobile Ads Flutter Plugin，再繼續操作本教學課程。

開始預先載入廣告

應用程式啟動時，請呼叫 start 方法一次。呼叫 start 方法後，Google Mobile Ads Flutter Plugin 會自動預先載入廣告，並重試預先載入設定的失敗要求。

以下範例會開始預先載入廣告：

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: const PreloadCallback(),
);

將 _adUnitId 替換為廣告單元 ID。

取得並顯示預先載入的廣告

使用廣告預先載入功能時，Google Mobile Ads Flutter Plugin 會保留快取廣告。 如要顯示廣告，請呼叫 pollAd 方法。Google Mobile Ads Flutter Plugin 擷取可用的廣告，並在背景自動預先載入下一則廣告。

請等到準備好顯示廣告時，再呼叫 pollAd 方法。將廣告保留在快取中，可讓 Google Mobile Ads Flutter Plugin 自動重新整理 過期的廣告，並執行快取最佳化。

以下範例會擷取並顯示預先載入的廣告：

void _pollAndShowAd() async {
  final InterstitialAd? ad = await InterstitialAdPreloader.pollAd(_adUnitId);
  if (ad != null) {
    _interstitialAd = ad;
    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdImpression: (ad) {
        // Called when an impression occurs on the ad.
        debugPrint('Ad recorded an impression.');
      },
    );
    ad.onPaidEvent = (ad, valueMicros, precision, currencyCode) {
      // Called when an ad is estimated to have earned money.
      debugPrint('Ad paid: $valueMicros $currencyCode.');
    };
    // Show the ad.
    await ad.show();
  }
}

檢查預先載入廣告是否可用

如要查看廣告放送資格，請選擇下列其中一個選項：

取得預先載入廣告是否可用

以下範例會檢查廣告是否可用：

void _checkAdAvailability() async {
  final bool isAvailable = await InterstitialAdPreloader.isAdAvailable(
    _adUnitId,
  );
  debugPrint('Is ad available: $isAvailable');
}

監聽預先載入廣告是否可用

註冊預先載入事件，即可在廣告預先載入成功、預先載入失敗或廣告快取空間用盡時收到通知。

預先載入事件的目的是為了進行分析。在預先載入期間的事件回呼中：

  • 不要呼叫 start。
  • 除非廣告會立即顯示，否則請避免呼叫 pollAd。

以下範例會註冊廣告事件：

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: PreloadCallback(
    onAdPreloaded: (preloadId, responseInfo) {
      debugPrint('Ad preloaded for ID: $preloadId');
    },
    onAdFailedToPreload: (preloadId, error) {
      debugPrint('Ad failed to preload for ID: $preloadId. Error: $error');
    },
    onAdsExhausted: (preloadId) {
      debugPrint('All preloaded ads exhausted for ID: $preloadId');
    },
  ),
);

停止預先載入廣告

如果不需要在工作階段中再次顯示預先載入 ID 的廣告，可以停止預先載入廣告。如要停止預先載入特定預先載入 ID 的廣告，請使用預先載入 ID 呼叫 destroy。如要停止所有預先載入器的預先載入作業，請呼叫 destroyAll。

void _stopPreloading() async {
  await InterstitialAdPreloader.destroy(_adUnitId);
}

設定緩衝區大小

緩衝區空間會控管記憶體中預先載入的廣告數量。根據預設，Google 會調整緩衝區大小，以平衡記憶體用量和廣告放送延遲。如果應用程式會在載入下一個廣告前顯示廣告，您可以設定自訂緩衝區空間，增加記憶體中保留的廣告數量。

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(
    adUnitId: _adUnitId,
    bufferSize: 3,
  ),
  callback: const PreloadCallback(),
);

預先載入快取限制

Google Mobile Ads Flutter Plugin 會對所有廣告單元和預先載入 ID 的預先載入廣告總數，強制執行應用程式範圍的限制：

  • 預設限制：Google Mobile Ads Flutter Plugin 最多可在記憶體中保留 6 個預先載入的廣告。 這項限制適用於所有格式和預先載入 ID。
  • 建議每個預先載入 ID 的緩衝區空間都設為 2。