Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Tải trước quảng cáo (Alpha)

Tính năng tải trước quảng cáo là một tính năng tải quảng cáo do Google quản lý trong Google Mobile Ads SDK Tính năng này quản lý việc tải và lưu quảng cáo vào bộ nhớ đệm thay cho bạn. Tính năng tải trước quảng cáo yêu cầu bạn thay đổi cách quản lý việc tải quảng cáo. Để tối ưu hoá hiệu suất bằng tính năng tải trước quảng cáo, hãy tắt tính năng lưu vào bộ nhớ đệm tuỳ chỉnh và uỷ quyền trách nhiệm đó cho Google Mobile Ads SDK.

Tính năng tải trước quảng cáo mang lại những lợi ích sau so với tính năng tải quảng cáo thủ công:

Quản lý tham chiếu: giữ quảng cáo đã tải để bạn không phải duy trì các tham chiếu cho đến khi sẵn sàng hiển thị quảng cáo.
Tự động tải lại: tự động tải một quảng cáo mới khi bạn lấy một quảng cáo ra khỏi bộ nhớ đệm.
Quản lý việc thử lại: tự động thử lại các yêu cầu không thành công bằng thuật toán thời gian đợi luỹ thừa.
Xử lý thời gian hết hạn: tự động làm mới quảng cáo trước khi quảng cáo hết hạn (thường là sau một giờ).
Tối ưu hoá bộ nhớ đệm: Nếu bạn sử dụng bộ nhớ đệm có kích thước lớn hơn một, Google Mobile Ads SDK tối ưu hoá thứ tự bộ nhớ đệm để phân phối quảng cáo tốt nhất.

Hướng dẫn này trình bày cách định cấu hình quảng cáo tải trước, kiểm tra tính sẵn có của quảng cáo tải trước và hiển thị quảng cáo đã tải trước.

Điều kiện tiên quyết

Trước khi tiếp tục hướng dẫn này, bạn cần hoàn tất các mục sau:

Cài đặt Google Mobile Ads SDK phiên bản 13.3.0 trở lên. Tài nguyên dành cho nhà phát triển đối với các phiên bản trước đó có tại 11.12.0 – 12.2.0, nhưng bạn nên sử dụng phiên bản 13.3.0 trở lên và làm theo hướng dẫn này trong tương lai.
Thiết lập Google Mobile Ads SDK.

Không bắt buộc: Tải xuống và chạy ứng dụng ví dụ về tính năng tải trước quảng cáo.

Nhập tiêu đề bản thử nghiệm

Để sử dụng tính năng tải trước quảng cáo, hãy nhập tiêu đề bản thử nghiệm:

Swift

import GoogleMobileAds_Private

Objective-C

#import <GoogleMobileAds/GoogleMobileAds_Beta.h>

Bắt đầu tải trước quảng cáo

Để bắt đầu tải trước quảng cáo, hãy gọi preload(). Chỉ gọi phương thức này một lần cho mỗi mã tải trước. Bạn nên gọi phương thức này khi phiên hoạt động của ứng dụng bắt đầu. Sau khi bạn gọi preload(), Google Mobile Ads SDK sẽ tự động tải trước quảng cáo và thử lại các yêu cầu không thành công đối với những mã tải trước đó.

Ví dụ sau đây bắt đầu tải trước quảng cáo:

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];
}

Nhận và hiển thị quảng cáo đã tải trước

Khi sử dụng tính năng tải trước quảng cáo, Google Mobile Ads SDK sẽ giữ quảng cáo đã lưu vào bộ nhớ đệm. Khi bạn muốn hiển thị một quảng cáo, hãy gọi adWithPreloadID(). Google Mobile Ads SDK truy xuất quảng cáo hiện có và tự động tải trước quảng cáo tiếp theo ở chế độ nền.

Ví dụ sau đây truy xuất và hiển thị một quảng cáo đã tải trước:

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];
}

Nhận siêu dữ liệu quảng cáo đã tải trước

Để nhận siêu dữ liệu quảng cáo đã tải trước, bạn có thể tra cứu đối tượng thông tin phản hồi của quảng cáo. Quá trình này cho phép bạn kiểm tra siêu dữ liệu của quảng cáo mà không cần xoá quảng cáo đó khỏi bộ nhớ đệm.

Ví dụ sau đây tra cứu siêu dữ liệu của quảng cáo đã tải trước từ đối tượng thông tin phản hồi:

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);
  }
}

Kiểm tra tính sẵn có của quảng cáo tải trước

Để kiểm tra tính sẵn có của quảng cáo, hãy chọn một trong những cách sau:

Nhận thông tin về tính sẵn có của quảng cáo tải trước
Theo dõi thông tin về tính sẵn có của quảng cáo tải trước

Nhận thông tin về tính sẵn có của quảng cáo đã tải trước

Ví dụ sau đây kiểm tra tính sẵn có của quảng cáo:

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];
}

Theo dõi thông tin về tính sẵn có của quảng cáo đã tải trước

Đăng ký các sự kiện tải trước để được thông báo khi quảng cáo tải trước thành công, không tải trước được hoặc bộ nhớ đệm quảng cáo đã cạn kiệt.

Các sự kiện tải trước được dùng cho mục đích phân tích. Trong các lệnh gọi lại sự kiện tải trước:

Không gọi preload().
Tránh gọi adWithPreloadID() trừ phi quảng cáo sẽ được hiển thị ngay lập tức.

Ví dụ sau đây đăng ký các sự kiện quảng cáo:

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);
}

Ngừng tải trước quảng cáo

Nếu không cần hiển thị lại quảng cáo cho một mã tải trước trong phiên hoạt động, bạn có thể ngừng tải trước quảng cáo. Để ngừng tải trước quảng cáo cho một mã tải trước cụ thể, hãy gọi stopPreloadingAndRemoveAdsForPreloadID() bằng một mã tải trước. Để ngừng tải trước cho tất cả trình tải trước, hãy gọi stopPreloadingAndRemoveAllAds().

Đặt dung lượng bộ nhớ đệm

Dung lượng bộ nhớ đệm kiểm soát số lượng quảng cáo đã tải trước được giữ trong bộ nhớ. Theo mặc định, Google tối ưu hoá kích thước bộ đệm để cân bằng mức tiêu thụ bộ nhớ và độ trễ phân phát quảng cáo. Nếu ứng dụng của bạn hiển thị quảng cáo trước khi quảng cáo tiếp theo được tải, bạn có thể đặt dung lượng bộ nhớ đệm tuỳ chỉnh để tăng số lượng quảng cáo được giữ trong bộ nhớ. Bạn nên đặt dung lượng bộ nhớ đệm là 2 hoặc 3.

Giới hạn bộ nhớ đệm tải trước

Google Mobile Ads SDK áp dụng giới hạn trên toàn ứng dụng đối với tổng số quảng cáo đã tải trước trên tất cả các đơn vị quảng cáo và mã tải trước:

Giới hạn mặc định: Google Mobile Ads SDK giữ tối đa 6 quảng cáo đã tải trước trong bộ nhớ. Giới hạn này được chia sẻ trên tất cả các định dạng và mã tải trước.
Bạn nên giữ dung lượng bộ nhớ đệm là 2 hoặc 3 cho mỗi mã tải trước.

Swift

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

Objective-C

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

Tải trước quảng cáo (Alpha) Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Điều kiện tiên quyết

Nhập tiêu đề bản thử nghiệm

Swift

Objective-C

Bắt đầu tải trước quảng cáo

Swift

Objective-C

Nhận và hiển thị quảng cáo đã tải trước

Swift

Objective-C

Nhận siêu dữ liệu quảng cáo đã tải trước

Swift

Objective-C

Kiểm tra tính sẵn có của quảng cáo tải trước

Nhận thông tin về tính sẵn có của quảng cáo đã tải trước

Swift

Objective-C

Theo dõi thông tin về tính sẵn có của quảng cáo đã tải trước

Swift

Objective-C

Ngừng tải trước quảng cáo

Đặt dung lượng bộ nhớ đệm

Giới hạn bộ nhớ đệm tải trước

Swift

Objective-C

Tải trước quảng cáo (Alpha)