MediationNativeAdapter

Kotlin |Java

public interface MediationNativeAdapter extends MediationAdapter

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

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

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

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

สรุป

เมธอดสาธารณะ
`abstract void`	`requestNativeAd( Context context, MediationNativeListener listener, Bundle serverParameters, NativeMediationAdRequest mediationAdRequest, @Nullable Bundle mediationExtras )` เรียกใช้โดยไลบรารีสื่อกลางเพื่อขอโฆษณาเนทีฟจากอแดปเตอร์

วิธีการที่รับค่ามา

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

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

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

requestNativeAd

abstract void requestNativeAd(
    Context context,
    MediationNativeListener listener,
    Bundle serverParameters,
    NativeMediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

เรียกใช้โดยไลบรารีสื่อกลางเพื่อขอโฆษณาเนทีฟจากอแดปเตอร์

หากคำขอสำเร็จ ระบบควรเรียกใช้เมธอด onAdLoaded

หากคำขอไม่สำเร็จ ควรเรียกใช้เมธอด onAdFailedToLoad ใน listener พร้อมสาเหตุของข้อผิดพลาดที่เหมาะสม

เมธอดนี้จะเรียกใช้ในเทรด UI ดังนั้นจึงต้องใช้ข้อควรระวังมาตรฐานทั้งหมดในการเขียนโค้ดในเทรดนั้น โดยเฉพาะอย่างยิ่ง โค้ดไม่ควรเรียกใช้เมธอดที่บล็อก

พารามิเตอร์
`Context context`	`Context` ของ AdView ซึ่งจะมีมุมมองเนทีฟ
`MediationNativeListener listener`	Listener สำหรับอแดปเตอร์ที่มี Callback สำหรับเหตุการณ์ต่างๆ
`Bundle serverParameters`	พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากำหนดในฝั่งเซิร์ฟเวอร์สื่อกลาง
`NativeMediationAdRequest mediationAdRequest`	พารามิเตอร์ทั่วไปสำหรับผู้เผยแพร่โฆษณารายนี้ใช้เมื่อส่งคำขอโฆษณา
`@Nullable Bundle mediationExtras`	พารามิเตอร์เพิ่มเติมที่ผู้เผยแพร่โฆษณากำหนดตามคำขอ