MediationBannerAdapter
interface MediationBannerAdapter : MediationAdapter
อะแดปเตอร์สําหรับเครือข่ายโฆษณาของบุคคลที่สามที่รองรับโฆษณาแบนเนอร์
วงจรชีวิตของอะแดปเตอร์โดยทั่วไปคือการเรียก requestBannerAd เพียงครั้งเดียว เมื่อถึงจุดนี้ ตัวแปลงควรขอโฆษณาจากเครือข่ายโฆษณาและรายงานไปยัง Listener ผ่าน onAdLoaded หรือ onAdFailedToLoad คำขอต่อๆ ไปจะใช้อินสแตนซ์ใหม่ของอะแดปเตอร์ เมื่อสิ้นสุดวงจร จะมีการพยายามเรียก onDestroy อย่างสุดความสามารถ แต่เราไม่รับประกัน โปรดทราบว่า requestBannerAd เรียกใช้ในเธรด UI ดังนั้นข้อควรระวังมาตรฐานทั้งหมดในการเขียนโค้ดในเธรดนั้นจะมีผล โดยเฉพาะอย่างยิ่ง โค้ดไม่ควรเรียกใช้เมธอดการบล็อก
คาดว่าอะแดปเตอร์จะแสดงเหตุการณ์ผ่าน MediationBannerListener ที่ส่งในคอล requestBannerAd พารามิเตอร์ทั้งหมดที่จําเป็นสําหรับส่งคําขอโฆษณาควรส่งผ่านในพารามิเตอร์ serverParameters, MediationAdRequest และ mediationExtras
อะแดปเตอร์ควรพยายามปิดใช้การรีเฟรชโฆษณาอัตโนมัติในฝั่งไคลเอ็นต์ ระบบอาจละเว้น ไม่ได้แสดง และนับโฆษณาที่รีเฟรชอย่างไม่ถูกต้อง
สรุป
ฟังก์ชันสาธารณะ |
|
|---|---|
View! |
แสดงผล |
Unit |
requestBannerAd(ไลบรารีสื่อกลางเรียกใช้เพื่อขอโฆษณาแบนเนอร์จากอะแดปเตอร์ |
ฟังก์ชันที่รับช่วงมา |
|---|
ฟังก์ชันสาธารณะ
getBannerView
fun getBannerView(): View!
แสดงผล View ที่แสดงโฆษณาได้
ค่านี้ต้องไม่เท่ากับ Null หลังจากการเรียกใช้ requestBannerAd และก่อนการเรียกใช้ onDestroy แต่อาจไม่มีค่าในบางครั้ง
requestBannerAd
fun requestBannerAd(
context: Context!,
listener: MediationBannerListener!,
serverParameters: Bundle!,
adSize: AdSize!,
mediationAdRequest: MediationAdRequest!,
mediationExtras: Bundle?
): Unit
ไลบรารีสื่อกลางเรียกใช้เพื่อขอโฆษณาแบนเนอร์จากอะแดปเตอร์
หากคำขอสำเร็จ ระบบจะเรียกใช้เมธอด onAdLoaded
หากคำขอไม่สำเร็จ ระบบจะเรียกใช้เมธอด onAdFailedToLoad ใน listener พร้อมสาเหตุข้อผิดพลาดที่เหมาะสม
ระบบจะเรียกใช้เมธอดนี้ในเธรด UI ดังนั้นข้อควรระวังมาตรฐานทั้งหมดในการเขียนโค้ดในเธรดดังกล่าวจะมีผล โดยเฉพาะอย่างยิ่ง รหัสไม่ควรเรียกใช้เมธอดการบล็อก
| พารามิเตอร์ | |
|---|---|
context: Context! |
|
listener: MediationBannerListener! |
Listener ไปยังอะแดปเตอร์ที่มี Callback สําหรับเหตุการณ์ต่างๆ |
serverParameters: Bundle! |
พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากําหนดไว้ฝั่งเซิร์ฟเวอร์สื่อกลาง |
adSize: AdSize! |
ขนาดของโฆษณาที่จะดึงข้อมูล ขนาดโฆษณาที่แสดงผลควรมีขนาดใกล้เคียงกับขนาดที่ระบุไว้ในพารามิเตอร์นี้มากที่สุด หากระบบไม่รองรับขนาดโฆษณานี้ คำขอควรดำเนินการไม่สำเร็จและควรเรียก onAdFailedToLoad |
mediationAdRequest: MediationAdRequest! |
พารามิเตอร์ทั่วไปสำหรับผู้เผยแพร่โฆษณารายนี้ที่จะใช้เมื่อส่งคําขอโฆษณา |
mediationExtras: Bundle? |
พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากําหนดในแต่ละคําขอ |