การโหลดโฆษณาล่วงหน้า (อัลฟ่า)

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

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

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

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

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

ก่อนที่จะทำตามบทแนะนำ คุณต้องดำเนินการต่อไปนี้ให้เสร็จ

ติดตั้ง Google Mobile Ads SDK เวอร์ชัน 24.4.0 ขึ้นไป แหล่งข้อมูลสำหรับนักพัฒนาซอฟต์แวร์สำหรับเวอร์ชันก่อนหน้ามีอยู่ที่ 23.6.1 - 24.3.0 แต่เราขอแนะนำให้ใช้เวอร์ชัน 24.4.0 ขึ้นไปและทำตาม คำแนะนำนี้ต่อไป
ตั้งค่า Google Mobile Ads SDK

ไม่บังคับ: ดาวน์โหลดและเรียกใช้แอปตัวอย่างใน Java หรือ Kotlin

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

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

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

Kotlin

// Define a PreloadConfiguration.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").build()
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration)InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration.
PreloadConfiguration configuration = new PreloadConfiguration.Builder("AD_UNIT_ID").build();
// Start the preloading with a given preload ID, preload configuration.
InterstitialAdPreloader.start("AD_UNIT_ID", configuration);InterstitialAdPreloaderSnippets.java

แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา

รับและแสดงโฆษณาที่โหลดล่วงหน้า

เมื่อใช้การโหลดโฆษณาล่วงหน้า Google Mobile Ads SDK จะเก็บโฆษณาที่แคชไว้ เมื่อต้องการแสดงโฆษณา ให้เรียกใช้ pollAd() Google Mobile Ads SDK จะดึงโฆษณาที่พร้อมใช้งานและโหลดโฆษณาถัดไปล่วงหน้าโดยอัตโนมัติ ในเบื้องหลัง

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

ตัวอย่างต่อไปนี้จะดึงและแสดงโฆษณาที่โหลดล่วงหน้า

Kotlin

// pollAd() returns the next available ad and loads another ad in the background.
val ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID")

// [Optional] Interact with the ad as needed.
ad?.onPaidEventListener = OnPaidEventListener {
  // [Optional] Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.
}

// Show the ad immediately.
ad?.show(activity)InterstitialAdPreloaderSnippets.kt

Java

// pollAd() returns the next available ad and loads another ad in the background.
InterstitialAd ad = InterstitialAdPreloader.pollAd("AD_UNIT_ID");

if (ad != null) {
  // [Optional] Interact with the ad object as needed.
  ad.setOnPaidEventListener(
      adValue -> {
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
      });

  // Show the ad immediately.
  ad.show(activity);
}InterstitialAdPreloaderSnippets.java

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

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

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

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

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

Kotlin

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}InterstitialAdPreloaderSnippets.kt

Java

// Verify that a preloaded ad is available.
if (!InterstitialAdPreloader.isAdAvailable("AD_UNIT_ID")) {
  // No ads are available to show.
}InterstitialAdPreloaderSnippets.java

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

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

เหตุการณ์ที่โหลดล่วงหน้ามีไว้เพื่อวัตถุประสงค์ในการวิเคราะห์ ภายในแฮนเดิลเหตุการณ์ การโหลดล่วงหน้า

อย่าโทรหา start()
หลีกเลี่ยงการเรียกใช้ pollAd() เว้นแต่จะแสดงโฆษณาทันที

ตัวอย่างต่อไปนี้ลงทะเบียนสำหรับเหตุการณ์โฆษณา

Kotlin

// Define a callback to receive preload events.
val callback =
  object : PreloadCallbackV2() {
    override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo?) {
      // Called when preloaded ads are available.
    }

    override fun onAdsExhausted(preloadId: String) {
      // Called when no preloaded ads are available.
    }

    override fun onAdFailedToPreload(preloadId: String, adError: AdError) {
      // Called when preloaded ads failed to load.
    }
  }InterstitialAdPreloaderSnippets.kt

Java

// Define a callback to receive preload events.
PreloadCallbackV2 callback =
    new PreloadCallbackV2() {
      @Override
      public void onAdPreloaded(
          @NonNull String preloadId, @Nullable ResponseInfo responseInfo) {
        // Called when preloaded ads are available.
      }

      @Override
      public void onAdsExhausted(@NonNull String preloadId) {
        // Called when no preloaded ads are available.
      }

      @Override
      public void onAdFailedToPreload(@NonNull String preloadId, @NonNull AdError adError) {
        // Called when preloaded ads failed to load.
      }
    };InterstitialAdPreloaderSnippets.java

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

หากไม่ต้องการแสดงโฆษณาสำหรับรหัสการโหลดล่วงหน้าอีกในเซสชัน คุณก็หยุดโหลดโฆษณาล่วงหน้าได้ หากต้องการหยุด โหลดโฆษณาล่วงหน้าสำหรับรหัสการโหลดล่วงหน้าหนึ่งๆ ให้เรียกใช้ destroy() โดยมี รหัสการโหลดล่วงหน้า

Kotlin

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID")
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll()InterstitialAdPreloaderSnippets.kt

Java

// Stops the preloading and destroy preloaded ads.
InterstitialAdPreloader.destroy("AD_UNIT_ID");
// Stops the preloading and destroy all ads.
InterstitialAdPreloader.destroyAll();InterstitialAdPreloaderSnippets.java

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

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

Kotlin

// Define a PreloadConfiguration and buffer up to 5 preloaded ads.
val configuration = PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(5).build()InterstitialAdPreloaderSnippets.kt

Java

// Define a PreloadConfiguration and buffer up to 5 preloaded ads.
PreloadConfiguration configuration =
    new PreloadConfiguration.Builder("AD_UNIT_ID").setBufferSize(5).build();InterstitialAdPreloaderSnippets.java