广告预加载（Alpha 版）

请选择平台： Android 新 Android iOS Unity

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

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

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

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

前提条件

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

开始预加载广告

如需开始预加载广告，请调用 Preload()。每个预加载 ID 只能调用此方法一次。建议您在应用会话开始时调用该方法。调用 Preload() 后，Google Mobile Ads Unity Plugin 会自动预加载广告，并重试针对这些预加载 ID 的失败请求。

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

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

预加载缓存限制

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

  • 默认限制：Google Mobile Ads Unity Plugin 最多可在内存中保存 6 个预加载的广告。此限制适用于所有格式和预加载 ID。
  • 建议每个预加载 ID 保留 2 或 3 个缓冲区空间。
new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
    BufferSize = 5
};