廣告預先載入 (Beta 版)

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

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

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

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

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

必要條件

請先設定 Google Mobile Ads SDK (Legacy)，再繼續操作本教學課程。

開始預先載入廣告

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

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

Kotlin

// Define a PreloadConfiguration.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").build()
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration)
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration.
PreloadConfiguration configuration = new PreloadConfiguration.Builder("AD_UNIT_ID").build();
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration);
InterstitialAdPreloaderSnippets.java

將 AD_UNIT_ID 替換為廣告單元 ID。

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

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

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

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

Kotlin

// pollAd() returns the next available ad and loads another ad in the background.
val ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID")

// [Optional] Interact with the ad as needed.
ad?.onPaidEventListener = OnPaidEventListener {
  // [Optional] Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.
}

// Show the ad immediately.
ad?.show(activity)
InterstitialAdPreloaderSnippets.kt

Java

// pollAd() returns the next available ad and loads another ad in the background.
InterstitialAd ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID");

if (ad != null) {
  // [Optional] Interact with the ad object as needed.
  ad.setOnPaidEventListener(
      adValue -> {
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
      });

  // Show the ad immediately.
  ad.show(activity);
}
InterstitialAdPreloaderSnippets.java

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

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

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

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

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

Kotlin

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.kt

Java

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}
InterstitialAdPreloaderSnippets.java

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

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

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

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

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

Kotlin

// Define a callback to receive preload events.
val callback =
  object : PreloadCallbackV2() {
    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo?) {
      // Called when preloaded ads are available.
    }

    override fun onAdsExhausted(preloadId: String) {
      // Called when no preloaded ads are available.
    }

    override fun onAdFailedToPreload(preloadId: String, adError: AdError) {
      // Called when preloaded ads failed to load.
    }
  }
InterstitialAdPreloaderSnippets.kt

Java

// Define a callback to receive preload events.
PreloadCallbackV2 callback =
    new PreloadCallbackV2() {
      @Override
      public void onAdPreloaded(
          @NonNull String preloadId, @Nullable ResponseInfo responseInfo) {
        // Called when preloaded ads are available.
      }

      @Override
      public void onAdsExhausted(@NonNull String preloadId) {
        // Called when no preloaded ads are available.
      }

      @Override
      public void onAdFailedToPreload(@NonNull String preloadId, @NonNull AdError adError) {
        // Called when preloaded ads failed to load.
      }
    };
InterstitialAdPreloaderSnippets.java

停止預先載入廣告

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

Kotlin

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID")
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll()
InterstitialAdPreloaderSnippets.kt

Java

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID");
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll();
InterstitialAdPreloaderSnippets.java

設定緩衝區大小

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

Kotlin

// Define a PreloadConfiguration and buffer up to 3 preloaded ads.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(3).build()
InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration and buffer up to 3 preloaded ads.
PreloadConfiguration configuration =
    new PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(3).build();
InterstitialAdPreloaderSnippets.java

預先載入快取限制

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

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

注意： 如果提高應用程式整體的上限對您的應用程式有益，請與帳戶管理員聯絡，要求提高上限。