广告预加载（Alpha 版）

广告预加载是 Google Mobile Ads SDK 中的一项由 Google 管理的广告加载功能，可代表您管理广告加载和缓存。广告预加载需要更改广告加载的管理方式。如需使用广告预加载优化性能，请停用自定义缓存并将此责任委托给 Google Mobile Ads SDK。

与手动广告加载相比，广告预加载具有以下优势：

引用管理：缓存已加载的广告，因此您无需维护引用，直到准备好展示广告为止。
自动重新加载：当您从缓存中拉取广告时，会自动加载新广告。
托管重试：使用指数退避算法自动重试失败的请求。
到期处理：在广告到期之前（通常在一个小时后）自动刷新广告。
缓存优化：如果您使用的缓存大小大于 1，Google Mobile Ads SDK 会优化缓存顺序，以投放最佳广告。

本指南介绍了如何配置预加载广告、检查预加载广告的可用性以及展示预加载的广告。

前提条件

在继续学习本教程之前，您需要完成以下事项：

安装 Google Mobile Ads SDK 24.4.0 或更高版本。如需获取早期版本的开发者资源，请访问 23.6.1 - 24.3.0，但我们建议您使用 24.4.0 或更高版本，并遵循本指南。
设置 Google Mobile Ads SDK。

可选：下载并运行 Java 或 Kotlin 中的示例应用。

开始预加载广告

如需开始预加载广告，请调用 start()。请仅在应用启动时调用此方法一次。调用 start()后，Google Mobile Ads SDK会自动预加载广告，并重试预加载配置的失败请求。

以下示例演示了如何开始预加载广告：

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 会缓存广告。当您想要展示广告时，请调用 pollAd()。Google Mobile Ads SDK 会检索可用的广告，并自动预加载下一个广告。

在准备好展示广告之前，请避免调用此方法。将广告保留在缓存中可让 Google Mobile Ads SDK 自动刷新已过期的广告并执行缓存优化。

以下示例演示了如何检索和展示预加载的广告：

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()。

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 会优化缓冲区空间大小，以平衡内存消耗和广告投放延迟。如果您的应用在加载下一个广告之前展示广告，您可以设置自定义缓冲区空间，以增加内存中保留的广告数量。我们建议缓冲区大小最多为 4。

Kotlin

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

Java

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

广告预加载（Alpha 版） 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

前提条件

开始预加载广告

Kotlin

Java

获取并展示预加载的广告

Kotlin

Java

检查预加载广告的可用性

获取预加载广告的可用性

Kotlin

Java

监听预加载广告的可用性

Kotlin

Java

停止预加载广告

Kotlin

Java

设置缓冲区大小

Kotlin

Java

广告预加载（Alpha 版）