廣告預先載入 (Alpha 版)

選取平台： Android (Beta 版) 新增 Android iOS Unity

廣告預先載入是 Google Mobile Ads Unity Plugin 中由 Google 管理的廣告載入功能，可代您管理廣告載入和快取。如要預先載入廣告，您必須變更廣告載入的管理方式。如要使用廣告預先載入功能提升成效，請停用自訂快取，並將這項責任委派給 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 會擷取可用的廣告，並在背景自動預先載入下一則廣告。

請在準備好顯示廣告後再呼叫這個方法。將廣告保留在快取中，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()。

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

設定緩衝區大小

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

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