广告预加载（Beta 版）

选择平台： Android iOS Unity Android（旧版）

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

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

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

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

前提条件

在继续学习本教程之前，您必须设置 Google Mobile Ads Unity Plugin。

开始预加载广告

应用启动时，请调用 Preload 方法一次。调用 Preload 方法后，Google Mobile Ads Unity Plugin 会自动预加载广告，并重试预加载配置的失败请求。

以下示例开始预加载广告：

var preloadConfiguration = new PreloadConfiguration
{
    AdUnitId = "AD_UNIT_ID",
    Request = new AdRequest(),
};

// Start the preloading initialization process after MobileAds.Initialize().
InterstitialAdPreloader.Preload(
    // The Preload ID can be any unique string to identify this configuration.
    "AD_UNIT_ID",
    preloadConfiguration);

获取并展示预加载的广告

使用广告预加载时，Google Mobile Ads Unity Plugin 会存储缓存的广告。 当您想要展示广告时，请调用 DequeueAd。 Google Mobile Ads Unity Plugin 会检索可用的广告，并在后台自动预加载 下一个广告。

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

以下示例检索并展示了预加载的广告：

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

if (ad != null)
{
    // [Optional] Interact with the ad object as needed.
    ad.OnAdPaid += (AdValue value) =>
    {
        Debug.Log($"Ad paid: {value.CurrencyCode} {value.Value}");
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
    };

    // Do not hold onto preloaded ads, always show a preloaded ad immediately.
    ad.Show();
}

检查预加载广告的可用性

如需检查广告的可用性，请选择以下选项之一：

获取预加载广告的可用性

以下示例检查了广告的可用性：

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable("AD_UNIT_ID");

监听预加载广告的可用性

注册预加载事件，以便在广告预加载成功、预加载失败或广告缓存耗尽时收到通知。

预加载事件旨在用于分析。在预加载事件回调中：

  • 请勿调用 Preload。
  • 除非广告会立即展示，否则请避免调用 DequeueAd。

以下示例注册了广告事件：


void StartPreloadWithCallbacks()
{
    var preloadConfiguration = new PreloadConfiguration
    {
        AdUnitId = "AD_UNIT_ID",
        Request = new AdRequest(),
    };

    // Start the preloading initialization process after MobileAds.Initialize().
    InterstitialAdPreloader.Preload(
        // The Preload ID can be any unique string to identify this configuration.
        "AD_UNIT_ID",
        preloadConfiguration,
        onAdPreloaded,
        onAdFailedToPreload,
        onAdsExhausted);
}

void onAdPreloaded(string preloadId, ResponseInfo responseInfo)
{
    Debug.Log($"Preload ad configuration {preloadId} was preloaded.");
}

void onAdFailedToPreload(string preloadId, AdError adError)
{
    string errorMessage = $"Preload ad configuration {preloadId} failed to " +
                          $"preload with error : {adError.GetMessage()}.";
    Debug.Log(errorMessage);
}

void onAdsExhausted(string preloadId)
{
    Debug.Log($"Preload ad configuration {preloadId} was exhausted");
    // [Important] Don't call Preload() or DequeueAd() from onAdsExhausted.
}

停止预加载广告

如果您不需要在会话中再次展示具有预加载 ID 的广告，则可以停止预加载广告。如需停止预加载具有特定预加载 ID 的广告，请使用预加载 ID 调用 Destroy。如需停止预加载所有预加载器，请调用 DestroyAll。

InterstitialAdPreloader.Destroy("AD_UNIT_ID");
InterstitialAdPreloader.DestroyAll();

设置缓冲区大小

缓冲区大小控制着内存中存储的预加载广告数量。默认情况下，Google 会优化缓冲区大小，以平衡内存消耗和广告投放延迟时间。如果您的应用在加载下一个广告之前展示广告，您可以设置自定义缓冲区空间，以增加内存中存储的广告数量。

new PreloadConfiguration
{
    AdUnitId = "AD_UNIT_ID",
    Request = new AdRequest(),
    BufferSize = 3
};

预加载缓存限制

Google Mobile Ads Unity Plugin 对所有广告单元和预加载 ID 的预加载广告总数强制执行应用级限制：

  • 默认限制：Google Mobile Ads Unity Plugin 最多在内存中存储 6 个预加载广告。 此限制适用于所有格式和预加载 ID。
  • 我们建议每个预加载 ID 的缓冲区空间保持为 2 或 3。