廣告預先載入 (Beta 版)

廣告預先載入是 Google Mobile Ads Flutter Plugin 中由 Google 管理的廣告載入功能，可代您管理廣告載入和快取。廣告預先載入功能需要您調整廣告載入的管理方式。如要使用廣告預先載入功能提升成效，請停用自訂快取，並將這項工作交給 Google Mobile Ads Flutter Plugin。

與手動載入廣告相比，廣告預先載入有下列優點：

  • 參照管理：保留已載入的廣告，您不必維護參照，直到準備好顯示廣告為止。
  • 自動重新載入：從快取中提取廣告時，系統會自動載入新廣告。
  • 代管重試：使用指數輪詢，自動重試失敗的要求。
  • 到期處理：在廣告到期前 (通常是一小時後) 自動重新整理。
  • 快取最佳化：如果快取大小大於一，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 的廣告，請呼叫 destroy 並傳入預先載入 ID。如要停止所有預先載入器的預先載入作業，請呼叫 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。