MediationNativeAdapter

interface MediationNativeAdapter : MediationAdapter

מתאם לרשתות מודעות של צד שלישי שתומכות במודעות מותאמות.

מחזור החיים האופייני של מתאם הוא קריאה אחת ל-requestNativeAd. בשלב הזה, המתאם אמור לבקש מודעה מרשת המודעות ולדווח למאזין על onAdLoaded או על onAdFailedToLoad. בסוף מחזור החיים, אנחנו עושים כמיטב יכולתנו כדי לקרוא ל-onDestroy, אבל אין לנו ערובה לכך. חשוב לזכור ש-requestNativeAd נקרא בשרשור של ממשק המשתמש, ולכן חלות עליו כל אמצעי הזהירות הרגילים לכתיבה של קוד בשרשור הזה. באופן ספציפי, אסור לקוד לבצע קריאה לשיטות חסימה.

המתאם אמור לחשוף אירועים דרך MediationNativeListener שמועברים בקריאה ל-requestNativeAd. צריך להעביר את כל הפרמטרים הנדרשים לשליחת בקשה להצגת מודעה באמצעות הפרמטרים serverParameters,‏ NativeMediationAdRequest ו-mediationExtras.

מתאמים צריכים לנסות להשבית את הרענון האוטומטי של המודעות בצד הלקוח. יכול להיות שמודעות שמופעלת בהן רענון יתעלמו, לא יוצגו או ייספרו באופן שגוי.

סיכום

פונקציות ציבוריות
Unit
requestNativeAd(
    context: Context!,
    listener: MediationNativeListener!,
    serverParameters: Bundle!,
    mediationAdRequest: NativeMediationAdRequest!,
    mediationExtras: Bundle?
)

הספרייה לבחירת רשת (Mediation) קוראת ל-method הזה כדי לבקש מהמתאם מודעה מותאמת.

פונקציות שעברו בירושה
מ-com.google.android.gms.ads.mediation.MediationAdapter
Unit

הורדת הבקרה של המתאם.
Unit

הפונקציה נקראת כשהאפליקציה קוראת ל-onPause ב-.
Unit

הפונקציה נקראת כשהאפליקציה קוראת ל-onResume ב-.

פונקציות ציבוריות

requestNativeAd

fun requestNativeAd(
    context: Context!,
    listener: MediationNativeListener!,
    serverParameters: Bundle!,
    mediationAdRequest: NativeMediationAdRequest!,
    mediationExtras: Bundle?
): Unit

הספרייה לבחירת רשת (Mediation) קוראת ל-method הזה כדי לבקש מהמתאם מודעה מותאמת.

אם הבקשה מסתיימת בהצלחה, צריך לקרוא לפונקציה onAdLoaded.

אם הבקשה נכשלת, צריך להפעיל את השיטה onAdFailedToLoad ב-listener עם סיבה מתאימה לשגיאה.

השיטה הזו נקראת בשרשור של ממשק המשתמש, ולכן חלות עליה כל אמצעי הזהירות הרגילים לכתיבה של קוד בשרשור הזה. באופן ספציפי, אסור לקוד לקרוא לשיטות חסימה.

פרמטרים
context: Context!

ה-Context של AdView שיכיל את התצוגה המקורית.
listener: MediationNativeListener!

מאזין למתאם עם קריאות חוזרות (callbacks) לאירועים שונים
serverParameters: Bundle!

פרמטרים נוספים שמוגדרים על ידי בעל התוכן הדיגיטלי בצד שרת בחירת הרשת
mediationAdRequest: NativeMediationAdRequest!

פרמטרים כלליים שבעלי התוכן הדיגיטלי הזה ישתמש בהם כשישלח בקשה להצגת מודעה
mediationExtras: Bundle?

פרמטרים נוספים שהוגדרו על ידי בעל התוכן הדיגיטלי על בסיס בקשה