MediationBannerAdapter

Kotlin |Java

interface MediationBannerAdapter : MediationAdapter

อแดปเตอร์สำหรับเครือข่ายโฆษณาของบุคคลที่สามที่รองรับโฆษณาแบนเนอร์

วงจรการใช้งานทั่วไปของอแดปเตอร์คือการเรียกใช้ requestBannerAd เพียงครั้งเดียว ในขั้นตอนนี้ อะแดปเตอร์ควรร้องขอโฆษณาจากเครือข่ายโฆษณาและรายงานต่อ Listener ใน onAdLoaded หรือ onAdFailedToLoad คำขอที่ตามมาจะดำเนินการด้วยอินสแตนซ์ใหม่ของอแดปเตอร์ เมื่อสิ้นสุดวงจรการใช้งาน เราจะพยายามอย่างเต็มที่ในการโทรหา onDestroy แต่ไม่รับประกันว่าจะโทรได้ โปรดทราบว่า requestBannerAd จะเรียกใช้ใน UI เธรด ดังนั้นข้อควรระวังมาตรฐานทั้งหมดในการเขียนโค้ดในเธรดนั้นจึงมีผล โดยเฉพาะอย่างยิ่ง โค้ดไม่ควรเรียกใช้เมธอดที่บล็อก

คาดว่าอแดปเตอร์จะแสดงเหตุการณ์ผ่าน MediationBannerListener ที่ส่งในการเรียก requestBannerAd พารามิเตอร์ทั้งหมดที่จำเป็นในการส่งคำขอโฆษณาควรส่งในพารามิเตอร์ serverParameters, MediationAdRequest และ mediationExtras

อแดปเตอร์ควรพยายามปิดใช้การรีเฟรชโฆษณาอัตโนมัติในฝั่งไคลเอ็นต์ ระบบอาจไม่สนใจโฆษณาที่รีเฟรช ไม่แสดง และนับอย่างไม่ถูกต้อง

สรุป

ฟังก์ชันสาธารณะ
`View!`	`getBannerView()` แสดงผล `View` ที่แสดงผลเพื่อแสดงโฆษณาได้
`Unit`	`requestBannerAd( context: Context!, listener: MediationBannerListener!, serverParameters: Bundle!, adSize: AdSize!, mediationAdRequest: MediationAdRequest!, mediationExtras: Bundle? )` เรียกใช้โดยไลบรารีสื่อกลางเพื่อขอโฆษณาแบนเนอร์จากอแดปเตอร์

ฟังก์ชันที่รับช่วง

จาก com.google.android.gms.ads.mediation.MediationAdapter

`Unit`	`onDestroy()` ฉีกการควบคุมอะแดปเตอร์
`Unit`	`onPause()` เรียกใช้เมื่อแอปพลิเคชันเรียกใช้ `onPause` ใน `com.google.android.gms.ads.AdView`
`Unit`	`onResume()` เรียกใช้เมื่อแอปพลิเคชันเรียกใช้ `onResume` ใน `com.google.android.gms.ads.AdView`

ฟังก์ชันสาธารณะ

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!`	`Context` ของ AdView ซึ่งจะมี View แบนเนอร์ เราขอแนะนำให้ใช้ `android.app.Activity`
`listener: MediationBannerListener!`	Listener ไปยังอแดปเตอร์ที่มี Callback สำหรับเหตุการณ์ต่างๆ
`serverParameters: Bundle!`	พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากำหนดในฝั่งเซิร์ฟเวอร์สื่อกลาง
`adSize: AdSize!`	ขนาดของโฆษณาที่จะดึงข้อมูล ขนาดโฆษณาที่แสดงควรมีขนาดใกล้เคียงกับขนาดที่ระบุในพารามิเตอร์นี้มากที่สุด หากไม่รองรับขนาดโฆษณานี้ คำขอควรล้มเหลวและควรเรียกใช้ onAdFailedToLoad
`mediationAdRequest: MediationAdRequest!`	พารามิเตอร์ทั่วไปสำหรับผู้เผยแพร่โฆษณารายนี้ใช้เมื่อส่งคำขอโฆษณา
`mediationExtras: Bundle?`	พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากำหนดตามคำขอ