AppOpenAdPreloader

public final class AppOpenAdPreloader

โปรแกรมโหลดล่วงหน้าสําหรับโฆษณาเปิดแอป

สรุป

เมธอดสาธารณะ
static boolean
destroy(String preloadId)

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

หยุดการโหลดล่วงหน้าและลบโฆษณาที่โหลดไว้ล่วงหน้าสําหรับการกําหนดค่าการโหลดล่วงหน้าทั้งหมด
static @Nullable PreloadConfiguration

แสดงโฆษณาเปิดแอป PreloadConfiguration ที่เชื่อมโยงกับ preloadId นี้ หรือแสดงค่าว่างหากไม่มี
static Map<String, PreloadConfiguration>

แสดงแผนที่ของPreloadConfigurationโฆษณาที่เปิดในแอปทั้งหมด โดยคีย์ตามรหัสการโหลดล่วงหน้าที่เกี่ยวข้อง
static int

แสดงจํานวนโฆษณาที่ใช้ได้สําหรับรหัสการโหลดล่วงหน้าที่ระบุ
static boolean
isAdAvailable(String preloadId)

ระบุว่ามีโฆษณาอย่างน้อย 1 รายการสําหรับ preloadId ที่ระบุหรือไม่
static @Nullable AppOpenAd
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 AppOpenAd pollAd(String preloadId)

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

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

พารามิเตอร์
String preloadId

รหัสการโหลดล่วงหน้าของโฆษณา
การคืนสินค้า
@Nullable AppOpenAd

โฆษณาแบบเปิดแอปสําหรับรหัสการโหลดล่วงหน้าที่ระบุ หรือ null หากไม่มีโฆษณา

เริ่มต้น

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 ใช้งานอยู่

เริ่มต้น

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 ใช้งานอยู่