Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

廣告預先載入 (Alpha 版)

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

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

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

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

必要條件

繼續進行本教學課程前，請先完成下列項目：

安裝 Google Mobile Ads SDK 13.3.0 以上版本。如需舊版開發人員資源，請參閱 11.12.0 - 12.2.0，但我們建議使用 13.3.0 以上版本，並遵循本指南操作。
設定 Google Mobile Ads SDK。

選用：下載並執行廣告預先載入範例應用程式。

匯入 Beta 版標頭

如要使用廣告預先載入功能，請匯入 Beta 版標頭：

Swift

import GoogleMobileAds_Private

Objective-C

#import <GoogleMobileAds/GoogleMobileAds_Beta.h>

開始預先載入廣告

如要開始預先載入廣告，請呼叫 preload()。每個預先載入 ID 只能呼叫這個方法一次。建議您在應用程式工作階段開始時呼叫這個方法。呼叫 preload() 後，Google Mobile Ads SDK 會自動預先載入廣告，並重試這些預先載入 ID 的失敗要求。

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

Swift

private func startPreloading(adUnitID: String) {
  // Start the preloading initialization process.
  let request = Request()
  let interstitialConfig = PreloadConfigurationV2(adUnitID: adUnitID, request: request)
  InterstitialAdPreloader.shared.preload(
    for: adUnitID, configuration: interstitialConfig, delegate: self)
}

Objective-C

- (void)startPreloadingWithAdUnitID:(NSString *)adUnitID {
  // Start the preloading initialization process.
  GADRequest *request = [GADRequest request];
  GADPreloadConfigurationV2 *interstitialConfig = [[GADPreloadConfigurationV2 alloc] initWithAdUnitID:adUnitID request:request];

  [GADInterstitialAdPreloader.sharedInstance preloadForPreloadID:adUnitID
                                                       configuration:interstitialConfig
                                                            delegate:self];
}

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

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

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

Swift

private func showInterstitialAd(adUnitID: String) {
  // Verify that the preloaded ad is available before polling.
  guard isInterstitialAvailable(adUnitID: adUnitID) else {
    print("Preloaded interstitial ad is not available.")
    return
  }

  // Polling returns the next available ad and load another ad in the background.
  let ad = InterstitialAdPreloader.shared.ad(with: adUnitID)

  // Interact with the ad object as needed.
  print("Interstitial ad response info: \(String(describing: ad?.responseInfo))")
  ad?.paidEventHandler = { (value: AdValue) in
    print("Interstitial ad paid event: \(value.value), \(value.currencyCode)")
  }

  ad?.fullScreenContentDelegate = self
  ad?.present(from: self)
}

Objective-C

- (void)showInterstitialAdWithAdUnitID:(NSString *)adUnitID {
  // Verify that the preloaded ad is available before polling.
  if (![self isInterstitialAvailableWithAdUnitID:adUnitID]) {
    NSLog(@"Preloaded interstitial ad is not available.");
    return;
  }

  // Getting the preloaded ad loads another ad in the background.
  GADInterstitialAd *ad = [GADInterstitialAdPreloader.sharedInstance adWithPreloadID:adUnitID];

  // Interact with the ad object as needed.
  NSLog(@"Interstitial ad response info: %@", ad.responseInfo);
  ad.paidEventHandler = ^(GADAdValue *_Nonnull value) {
    NSLog(@"Interstitial ad paid event: %@ %@ ", value.value, value.currencyCode);
  };
  ad.fullScreenContentDelegate = self;
  [ad presentFromRootViewController:self];
}

取得預先載入廣告的中繼資料

如要取得預先載入的廣告中繼資料，可以查詢廣告的回應資訊物件。這個程序可讓您檢查廣告的中繼資料，而不必從快取中移除廣告。

以下範例會從回應資訊物件中，查詢預先載入廣告的中繼資料：

Swift

private func getInterstitialAdResponseInfo(preloadID: String) {
  // Get the response info for the preloaded ad.
  if let responseInfo = InterstitialAdPreloader.shared.adResponseInfo(withPreloadID: preloadID) {
    print("Ad response ID: \(responseInfo.responseID)")
  }
}

Objective-C

- (void)getInterstitialAdResponseInfoWithPreloadID:(NSString *)preloadID {
  // Get the response info for the preloaded ad.
  GADResponseInfo *responseInfo =
      [GADInterstitialAdPreloader.sharedInstance
          adResponseInfoWithPreloadID:preloadID];
  if (responseInfo) {
    NSLog(@"Ad response ID: %@", responseInfo.responseID);
  }
}

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

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

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

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

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

Swift

private func isInterstitialAvailable(adUnitID: String) -> Bool {
  // Verify that an ad is available before polling.
  return InterstitialAdPreloader.shared.isAdAvailable(with: adUnitID)
}

Objective-C

- (BOOL)isInterstitialAvailableWithAdUnitID:(NSString *)adUnitID {
  // Verify that an ad is available before polling.
  return [GADInterstitialAdPreloader.sharedInstance isAdAvailableWithPreloadID:adUnitID];
}

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

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

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

不要呼叫 preload()。
除非廣告會立即顯示，否則請避免呼叫 adWithPreloadID()。

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

Swift

func adAvailable(forPreloadID preloadID: String, responseInfo: ResponseInfo) {
  // This callback indicates that an ad is available for the specified configuration.
  // No action is required here, but updating the UI can be useful in some cases.
  print("Ad preloaded successfully for ad preload ID: \(preloadID)")
}

func adsExhausted(forPreloadID preloadID: String) {
  // This callback indicates that all the ads for the specified configuration have been
  // consumed and no ads are available to show. No action is required here, but updating
  // the UI can be useful in some cases.
  // [Important] Don't call AdPreloader.shared.preload or AdPreloader.shared.ad
  // from adsExhausted.
  print("Ad exhausted for ad preload ID: \(preloadID)")
}

func adFailedToPreload(forPreloadID preloadID: String, error: Error) {
  print(
    "Ad failed to load with ad preload ID: \(preloadID), Error: \(error.localizedDescription)"
  )
}

Objective-C

- (void)adAvailableForPreloadID:(nonnull NSString *)preloadID responseInfo:(nonnull GADResponseInfo *)responseInfo {
  // This callback indicates that an ad is available for the specified configuration.
  // No action is required here, but updating the UI can be useful in some cases.
  NSLog(@"Ad preloaded successfully for ad unit ID: %@", preloadID);
}

- (void)adsExhaustedForPreloadID:(nonnull NSString  *)preloadID {
  // This callback indicates that all the ads for the specified configuration have been
  // consumed and no ads are available to show. No action is required here, but updating
  // the UI can be useful in some cases.
  // [Important] Don't call [GAD<Format>AdPreloader preloadForPreloadID:] or
  // [GAD<Format>AdPreloader adWithPreloadID:] from adsExhaustedForPreloadID.
  NSLog(@"Ad exhausted for ad preload ID: %@", preloadID);
}

- (void)adFailedToPreloadForPreloadID:(nonnull NSString  *)preloadID error:(nonnull NSError *)error {
  NSLog(@"Ad failed to load with ad preload ID: %@, Error: %@", preloadID, error.localizedDescription);
}

停止預先載入廣告

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

設定緩衝區大小

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

預先載入快取限制

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

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

Swift

let preloadConfig = PreloadConfigurationV2(adUnitID: "/21775744923/example/rewarded")
preloadConfig.bufferSize = 3

Objective-C

GADPreloadConfigurationV2 *preloadConfig =
    [[GADPreloadConfigurationV2 alloc] initWithAdUnitID:@"/21775744923/example/rewarded"];
preloadConfig.bufferSize = 3;

廣告預先載入 (Alpha 版) 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

必要條件

匯入 Beta 版標頭

Swift

Objective-C

開始預先載入廣告

Swift

Objective-C

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

Swift

Objective-C

取得預先載入廣告的中繼資料

Swift

Objective-C

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

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

Swift

Objective-C

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

Swift

Objective-C

停止預先載入廣告

設定緩衝區大小

預先載入快取限制

Swift

Objective-C

廣告預先載入 (Alpha 版)