MediationNativeAdapter

public interface MediationNativeAdapter extends MediationAdapter

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

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

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

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

סיכום

שיטות ציבוריות
abstract void
requestNativeAd(
    Context context,
    MediationNativeListener listener,
    Bundle serverParameters,
    NativeMediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

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

שיטות שעברו בירושה
מ-com.google.android.gms.ads.mediation.MediationAdapter
abstract void

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

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

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

שיטות ציבוריות

requestNativeAd

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

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

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

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

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

פרמטרים
Context context

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

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

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

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

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