การโหลดโฆษณาล่วงหน้า (เบต้า)

เลือกแพลตฟอร์ม: Android iOS Unity Android (เดิม)

การโหลดโฆษณาล่วงหน้าเป็นฟีเจอร์การโหลดโฆษณาที่ Google จัดการใน Google Mobile Ads SDK ซึ่ง จะจัดการการโหลดและการแคชโฆษณาในนามของคุณ การโหลดโฆษณาล่วงหน้ากำหนดให้คุณต้องเปลี่ยนวิธีจัดการการโหลดโฆษณา หากต้องการเพิ่มประสิทธิภาพโดยใช้การโหลดโฆษณาล่วงหน้า ให้ปิดใช้การแคชที่กำหนดเองและมอบความรับผิดชอบนั้นให้กับ Google Mobile Ads SDK

การโหลดโฆษณาล่วงหน้ามีข้อดีดังต่อไปนี้เมื่อเทียบกับการโหลดโฆษณาด้วยตนเอง

  • การจัดการการอ้างอิง: เก็บโฆษณาที่โหลดไว้เพื่อให้คุณไม่ต้องดูแลการอ้างอิงจนกว่าจะพร้อมแสดงโฆษณา
  • การโหลดซ้ำอัตโนมัติ: โหลดโฆษณาใหม่โดยอัตโนมัติเมื่อคุณนำโฆษณาออกจากแคช
  • การลองใหม่ที่จัดการโดยระบบ: ลองส่งคำขอที่ล้มเหลวซ้ำโดยอัตโนมัติโดยใช้ Exponential Backoff
  • การจัดการการหมดอายุ: รีเฟรชโฆษณาโดยอัตโนมัติก่อนที่โฆษณาจะหมดอายุ (โดยปกติคือหลังจากผ่านไป 1 ชั่วโมง)
  • การเพิ่มประสิทธิภาพแคช: หากคุณใช้แคชขนาดใหญ่กว่า 1 Google Mobile Ads SDK เพิ่มประสิทธิภาพลำดับแคชเพื่อแสดงโฆษณาที่ดีที่สุด

คู่มือนี้ครอบคลุมการกำหนดค่าโฆษณาที่โหลดล่วงหน้า การตรวจสอบความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า และการแสดงโฆษณาที่โหลดล่วงหน้า

ข้อกำหนดเบื้องต้น

คุณต้องตั้งค่าGoogle Mobile Ads SDKก่อนที่จะทำตามบทแนะนำนี้

เริ่มโหลดโฆษณาล่วงหน้า

เมื่อแอปเริ่มต้น ให้เรียกใช้เมธอด preload 1 ครั้ง หลังจาก เรียกใช้เมธอด preload แล้ว Google Mobile Ads SDK จะโหลดโฆษณาล่วงหน้าโดยอัตโนมัติ และลองส่งคำขอที่ล้มเหลวสำหรับการกำหนดค่าที่โหลดล่วงหน้าซ้ำ

ตัวอย่างต่อไปนี้แสดงการเริ่มโหลดโฆษณาล่วงหน้า

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:(nonnull 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 จะดึงโฆษณาที่พร้อมใช้งานและโหลด โฆษณาถัดไปล่วงหน้าโดยอัตโนมัติในเบื้องหลัง

หลีกเลี่ยงการเรียกใช้เมธอด 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 loads 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:(nonnull 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.responseInfo(
    with: preloadID)
  {
    print("Ad response ID: \(responseInfo.responseIdentifier ?? "")")
  }
}

Objective-C

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

ตรวจสอบความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า

หากต้องการตรวจสอบความพร้อมใช้งานของโฆษณา ให้เลือกตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

รับความพร้อมใช้งานของโฆษณาที่โหลดล่วงหน้า

ตัวอย่างต่อไปนี้แสดงการตรวจสอบความพร้อมใช้งานของโฆษณา

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:(nonnull 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.
  // Don't call InterstitialAdPreloader.shared.preload or
  // InterstitialAdPreloader.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.
  // 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);
}

หยุดโหลดโฆษณาล่วงหน้า

หากไม่จำเป็นต้องแสดงโฆษณาสำหรับรหัสการโหลดล่วงหน้าอีกในเซสชัน คุณก็หยุดโหลดโฆษณาล่วงหน้าได้ หากต้องการหยุดโหลดโฆษณาล่วงหน้าสำหรับรหัสการโหลดล่วงหน้าที่เฉพาะเจาะจง ให้เรียกใช้ stopPreloadingAndRemoveAdsForPreloadID พร้อมรหัสการโหลดล่วงหน้า หากต้องการหยุดโหลดล่วงหน้าสำหรับตัวโหลดล่วงหน้าทั้งหมด ให้เรียกใช้ stopPreloadingAndRemoveAllAds

ตั้งค่าขนาดบัฟเฟอร์

ขนาดบัฟเฟอร์จะควบคุมจำนวนโฆษณาที่โหลดล่วงหน้าที่เก็บไว้ในหน่วยความจำ โดยค่าเริ่มต้น Google จะเพิ่มประสิทธิภาพขนาดบัฟเฟอร์เพื่อปรับสมดุลการใช้หน่วยความจำและเวลาในการตอบสนองในการแสดงโฆษณา หากแอปแสดงโฆษณาก่อนที่จะโหลดโฆษณาถัดไป คุณสามารถตั้งค่าขนาดบัฟเฟอร์ที่กำหนดเองเพื่อเพิ่มจำนวนโฆษณาที่เก็บไว้ในหน่วยความจำ

Swift

let preloadConfig = PreloadConfigurationV2(adUnitID: "ca-app-pub-3940256099942544/1712485313")
preloadConfig.bufferSize = 3

Objective-C

GADPreloadConfigurationV2 *preloadConfig =
    [[GADPreloadConfigurationV2 alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/1712485313"];
preloadConfig.bufferSize = 3;

ขีดจำกัดแคชการโหลดล่วงหน้า

Google Mobile Ads SDK กำหนดขีดจำกัดทั่วทั้งแอปสำหรับจำนวนโฆษณาที่โหลดล่วงหน้าทั้งหมด ในหน่วยโฆษณาและรหัสการโหลดล่วงหน้าทั้งหมด:

  • ขีดจำกัดเริ่มต้น: Google Mobile Ads SDK จะเก็บโฆษณาที่โหลดล่วงหน้าไว้ในหน่วยความจำได้สูงสุด 6 รายการ ขีดจำกัดนี้ใช้ร่วมกันในทุกรูปแบบและรหัสการโหลดล่วงหน้า
  • เราขอแนะนำให้เก็บขนาดบัฟเฟอร์ไว้ที่ 2 หรือ 3 รายการต่อรหัสการโหลดล่วงหน้า