InterstitialAdPreloader

Kotlin |Java

public final class InterstitialAdPreloader

---

ตัวโหลดล่วงหน้าสำหรับโฆษณาคั่นระหว่างหน้า

สรุป

เมธอดสาธารณะ
static boolean	destroy(String preloadId) หยุดการโหลดล่วงหน้าสำหรับ preloadId ที่ระบุและทำลายโฆษณาที่โหลดล่วงหน้าทั้งหมดที่เกี่ยวข้อง
static void	destroyAll() หยุดการโหลดล่วงหน้าและทำลายโฆษณาที่โหลดล่วงหน้าสำหรับการกำหนดค่าการโหลดล่วงหน้าทั้งหมด
static @Nullable PreloadConfiguration	getConfiguration(String preloadId) เลิกใช้เมธอดนี้แล้ว ไม่มีการแทนที่
static Map<String, PreloadConfiguration>	getConfigurations() เลิกใช้เมธอดนี้แล้ว ไม่มีการแทนที่
static int	getNumAdsAvailable(String preloadId) แสดงผลจำนวนโฆษณาที่พร้อมใช้งานสำหรับรหัสการโหลดล่วงหน้าที่ระบุ
static boolean	isAdAvailable(String preloadId) กำหนดว่ามีโฆษณาอย่างน้อย 1 รายการสำหรับ preloadId ที่ระบุหรือไม่
static @Nullable InterstitialAd	pollAd(String preloadId) แสดงโฆษณาที่โหลดล่วงหน้าจาก start หรือ start และนำออกจากแคช
static boolean	start(String preloadId, PreloadConfiguration preloadConfiguration) เริ่มโหลดโฆษณาล่วงหน้าสำหรับ preloadId และ PreloadConfiguration ที่ระบุ
static boolean	start(     String preloadId,     PreloadConfiguration preloadConfiguration,     PreloadCallbackV2 preloadCallback ) เริ่มโหลดโฆษณาล่วงหน้าสำหรับ preloadId, PreloadConfiguration และ

เมธอดสาธารณะ

ทำลาย

public static boolean destroy(String preloadId)

หยุดการโหลดล่วงหน้าสำหรับ preloadId ที่ระบุและทำลายโฆษณาที่โหลดล่วงหน้าทั้งหมดที่เกี่ยวข้อง

พารามิเตอร์
String preloadId	รหัสการโหลดล่วงหน้าของการกำหนดค่าที่จะทำลาย

การคืนสินค้า
boolean	true หากมีการทำลายการกำหนดค่าการโหลดล่วงหน้าที่ใช้งานอยู่ แสดงผล false หากไม่มีการกำหนดค่าการโหลดล่วงหน้าที่ใช้งานอยู่สำหรับ preloadId ที่ระบุ

destroyAll

public static void destroyAll()

หยุดการโหลดล่วงหน้าและทำลายโฆษณาที่โหลดล่วงหน้าสำหรับการกำหนดค่าการโหลดล่วงหน้าทั้งหมด

getConfiguration

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

เลิกใช้เมธอดนี้แล้ว

ไม่มีการแทนที่

แสดงโฆษณาคั่นระหว่างหน้าที่PreloadConfigurationเชื่อมโยงกับ preloadIdนี้ หรือแสดงค่าว่างหากไม่มี

พารามิเตอร์
String preloadId	รหัสการโหลดล่วงหน้าที่ลิงก์กับการกำหนดค่านี้

การคืนสินค้า
@Nullable PreloadConfiguration	PreloadConfiguration สำหรับรหัสการโหลดล่วงหน้าที่ระบุ หรือ null หากไม่มีการกำหนดค่าสำหรับรหัสการโหลดล่วงหน้าที่ระบุ

getConfigurations

public static Map<String, PreloadConfiguration> getConfigurations()

เลิกใช้เมธอดนี้แล้ว

ไม่มีการแทนที่

แสดงแผนที่ของโฆษณาคั่นระหว่างหน้าทั้งหมด PreloadConfiguration โดยมีคีย์เป็นรหัสการโหลดล่วงหน้าที่เชื่อมโยง

การคืนสินค้า
Map<String, PreloadConfiguration>	การกำหนดค่าโฆษณาคั่นระหว่างหน้า หรือแผนที่ว่างเปล่าหากไม่มีตัวโหลดล่วงหน้า

getNumAdsAvailable

public static int getNumAdsAvailable(String preloadId)

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

พารามิเตอร์
String preloadId	รหัสการโหลดล่วงหน้าเพื่อตรวจสอบความพร้อมใช้งาน

การคืนสินค้า
int	จำนวนโฆษณาที่พร้อมแสดงสำหรับรหัสการโหลดล่วงหน้าที่ระบุ

isAdAvailable

public static boolean isAdAvailable(String preloadId)

กำหนดว่ามีโฆษณาอย่างน้อย 1 รายการสำหรับ preloadId ที่ระบุหรือไม่

พารามิเตอร์
String preloadId	รหัสการโหลดล่วงหน้าเพื่อตรวจสอบความพร้อมใช้งาน

การคืนสินค้า
boolean	true หากมีโฆษณาสำหรับรหัสการโหลดล่วงหน้าที่ระบุ false มิฉะนั้น

pollAd

public static @Nullable InterstitialAd pollAd(String preloadId)

แสดงโฆษณาที่โหลดล่วงหน้าจาก start หรือ start และนำออกจากแคช

โปรดทราบว่าโฆษณาที่แสดงอาจเป็นโฆษณาใดก็ได้ที่โหลดไว้ล่วงหน้าสำหรับ preloadId ระบบไม่รับประกันว่าลำดับที่แสดงจะตรงกับลำดับของเหตุการณ์ onAdPreloaded

พารามิเตอร์
String preloadId	รหัสการโหลดล่วงหน้าของโฆษณา

การคืนสินค้า
@Nullable InterstitialAd	โฆษณาคั่นระหว่างหน้าสำหรับรหัสการโหลดล่วงหน้าที่ระบุ หรือ null หากไม่มีโฆษณา

start

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

เริ่มโหลดโฆษณาล่วงหน้าสำหรับ preloadId และ PreloadConfiguration ที่ระบุ

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

หากมีการเริ่ม PreloadConfiguration ด้วย preloadId แล้ว เมธอดนี้จะไม่มีผลและแสดงผล false

พารามิเตอร์
String preloadId	ตัวระบุสตริงสำหรับ PreloadConfiguration นี้ ใช้ตัวระบุนี้เมื่อเรียก pollAd เพื่อรับโฆษณาสำหรับการกำหนดค่านี้
PreloadConfiguration preloadConfiguration	การกำหนดค่าสำหรับการโหลดโฆษณาล่วงหน้า

การคืนสินค้า
boolean	true หากการโหลดล่วงหน้าเริ่มต้นขึ้น false หาก preloadId อยู่ระหว่างการใช้งาน

start

public static boolean start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

เริ่มโหลดโฆษณาล่วงหน้าสำหรับ preloadId, PreloadConfiguration และ

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

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

หาก PreloadConfiguration เริ่มต้นด้วย preloadId ที่ระบุแล้ว เมธอดนี้จะไม่ดำเนินการใดๆ และจะแสดง false จะไม่มีการดำเนินการใดๆ และจะแสดงผล false

พารามิเตอร์
String preloadId	สตริงที่ระบุ PreloadConfiguration นี้อย่างไม่ซ้ำกัน ใช้ตัวระบุนี้เมื่อเรียก pollAd เพื่อดึงโฆษณาที่โหลดล่วงหน้าสำหรับการกำหนดค่านี้
PreloadConfiguration preloadConfiguration	การกำหนดค่าที่กำหนดวิธีโหลดโฆษณาล่วงหน้า
PreloadCallbackV2 preloadCallback	Callback ที่จะเรียกใช้เมื่อความพร้อมใช้งานของโฆษณาเปลี่ยนแปลงสำหรับ PreloadConfiguration ที่ระบุ

การคืนสินค้า
boolean	true หากการโหลดล่วงหน้าเริ่มต้นขึ้น false หาก preloadId อยู่ระหว่างการใช้งาน