כדי לדון במוצרים שלנו ולספק משוב, אפשר להצטרף לערוץ הרשמי של Ad Manager ב-Discord בשרת קהילת הפרסום והמדידה של Google.

דף זה תורגם על ידי Cloud Translation API.

CustomEventNative

Kotlin |Java

public interface CustomEventNative extends CustomEvent

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

מחזור החיים הרגיל של אירוע בהתאמה אישית הוא קריאה אחת של requestNativeAd. בשלב הזה, המתאם אמור ליצור מודעה מותאמת ולדווח על כך ל-onAdLoaded או ל-onAdFailedToLoad.

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

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

סיכום

שיטות ציבוריות
`abstract void`	`requestNativeAd( Context context, CustomEventNativeListener listener, @Nullable String serverParameter, NativeMediationAdRequest mediationAdRequest, @Nullable Bundle customEventExtras )` הספרייה של תהליך בחירת הרשת מפעילה את הפונקציה הזו כדי לבקש מודעת Native מהאירוע המותאם אישית.

שיטות שעברו בירושה

מ-com.google.android.gms.ads.mediation.customevent.CustomEvent

`abstract void`	`onDestroy()` הורדת הבקרה של המתאם.
`abstract void`	`onPause()` הפונקציה נקראת כשהאפליקציה קוראת ל-`pause`.
`abstract void`	`onResume()` הפונקציה נקראת כשהאפליקציה קוראת ל-`resume`.

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

requestNativeAd

abstract void requestNativeAd(
    Context context,
    CustomEventNativeListener listener,
    @Nullable String serverParameter,
    NativeMediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

הספרייה של תהליך בחירת הרשת מפעילה את הפונקציה הזו כדי לבקש מודעת Native מהאירוע המותאם אישית.

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

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

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

פרמטרים
`Context context`	השדה `Context`, שיכיל את האירוע המותאם אישית.
`CustomEventNativeListener listener`	מאזין לאירוע בהתאמה אישית עם קריאות חוזרות (callbacks) לאירועים שונים.
`@Nullable String serverParameter`	המחרוזת שמוגדרת בממשק המשתמש של בעל התוכן הדיגיטלי כפרמטר של האירוע המותאם אישית.
`NativeMediationAdRequest mediationAdRequest`	פרמטרים כלליים של טירגוט לשימוש בבקשה להצגת תצוגה מפורטת.
`@Nullable Bundle customEventExtras`	`Bundle` של פרמטרים שהוגדרו על ידי בעל התוכן הדיגיטלי על בסיס בקשה.