NativeAd
abstract class NativeAd
מודעה מותאמת של Google.
סיכום
סוגים מוטמעים |
|---|
abstract class NativeAd.AdChoicesInfoמידע על שיוך. |
abstract class NativeAd.Imageנכס תמונה של מודעה מותאמת. |
interface NativeAd.OnNativeAdLoadedListenerהגדרת ממשק לקריאה חוזרת שתופעל כשמודעה מותאמת תיטען בהצלחה. |
interface NativeAd.UnconfirmedClickListenerממשק מאזין שאפליקציות יכולות להשתמש בו כדי לקבל אירועים של קליקים לא מאומתים כשמשתמשים בתכונה 'אישור קליקים'. |
בוני אובייקטים ציבוריים |
|---|
NativeAd() |
פונקציות גלויות לכולם |
|
|---|---|
abstract Unit |
המערכת מבטלת קליק שלא אושר ושנרשם קודם במודעה. |
abstract Unit |
destroy()הפונקציה הזו מוחקת את אובייקט המודעה. |
abstract Unit |
הפונקציה הזו הוצאה משימוש. שימוש בכתובת |
abstract NativeAd.AdChoicesInfo? |
מחזירה את המידע על שיוך המודעה ל-AdChoices. |
abstract String? |
מחזירה טקסט שמזהה את המפרסם. |
abstract String? |
getBody()הפונקציה מחזירה את הטקסט של תוכן ההודעה. |
abstract String? |
מחזירה את הקריאה לפעולה של המודעה (למשל, 'קנייה' או 'התקנה'). |
abstract Bundle! |
הפונקציה מחזירה חבילה של נכסים נוספים שמשויכים למודעה המותאמת. |
abstract String? |
הפונקציה מחזירה את הכותרת הראשית של הטקסט. |
abstract NativeAd.Image? |
getIcon()מחזירה תמונה קטנה שמזהה את המפרסם. |
abstract (Mutable)List<NativeAd.Image!>! |
מחזירה רשימה של תמונות גדולות. |
abstract MediaContent? |
מחזירה את |
abstract (Mutable)List<MuteThisAdReason!>! |
הפונקציה מחזירה את הסיבות להשתקת המודעה הזו שזמינות למודעה. |
abstract Long |
מחזירה את מזהה מיקום המודעה של |
abstract String? |
getPrice()למודעות לגבי אפליקציות, הפונקציה מחזירה מחרוזת שמייצגת את העלות של האפליקציה. |
abstract ResponseInfo? |
מחזירה את האובייקט |
abstract Double? |
במודעות לגבי אפליקציות, הערך שמוחזר הוא דירוג בכוכבים מ-0 עד 5 שמייצג את מספר הכוכבים שהאפליקציה קיבלה בחנות שבה היא מוצעת. |
abstract String? |
getStore()במודעות לקידום אפליקציות, הפונקציה מחזירה את שם החנות שמציעה את האפליקציה להורדה. |
abstract Boolean |
הפונקציה הזו הוצאה משימוש. כשמטעינים מודעה באמצעות |
abstract Boolean |
הפונקציה מחזירה |
abstract Unit |
muteThisAd(muteThisAdReason: MuteThisAdReason!)השתקה פרוגרמטית של המודעה הזו. |
abstract Unit |
performClick(clickData: Bundle!)צריך להפעיל את הפונקציה הזו כשמשתמש לוחץ על המודעה. |
abstract Unit |
הפונקציה הזו הוצאה משימוש. Google Mobile Ads SDK עכשיו עוקב אחרי תנועות מותאמות אישית של קליקים באמצעות כיוון תנועת הקליק שנדרש ב- |
abstract Boolean |
recordImpression(impressionData: Bundle!)צריך להפעיל את הפונקציה הזו כשהמודעה מוצגת בפעם הראשונה. |
abstract Unit |
reportTouchEvent(touchEventData: Bundle!)צריך להפעיל את הפונקציה הזו כשמתרחש אירוע מגע במודעה. |
abstract Unit |
setMuteThisAdListener(listener: MuteThisAdListener!)מגדיר את |
abstract Unit |
setOnPaidEventListener(listener: OnPaidEventListener?)רושמים קריאה חוזרת שתופעל כשהמערכת מעריכה שהמודעה הזו הניבה הכנסות. |
abstract Unit |
setPlacementId(placementId: Long)מגדיר מזהה של מיקום מודעה עבור המודעה המותאמת. |
abstract Unit |
מגדיר את UnconfirmedClickListener למודעה. |
בוני אובייקטים ציבוריים
פונקציות גלויות לכולם
cancelUnconfirmedClick
abstract fun cancelUnconfirmedClick(): Unit
המערכת מבטלת קליק שלא אושר ושנרשם קודם במודעה.
כיבוי סופי
abstract fun destroy(): Unit
הפונקציה הזו מוחקת את אובייקט המודעה. אסור לקרוא לשיטות אחרות באובייקט המודעה אחרי הקריאה ל-
destroy.
enableCustomClickGesture
abstract funenableCustomClickGesture(): Unit
ההגדרה הזו מאפשרת לבעלי תוכן דיגיטלי לדווח על קליקים באמצעות מחוות בהתאמה אישית עבור NativeAd. כדי להשתמש בשיטה הזו, יחידת המודעות צריכה להיכלל ברשימת ההיתרים.
כברירת מחדל, ה-SDK עוקב אחרי קליקים על תצוגות של נכסים. אם קוראים לשיטה הזו, ה-SDK לא יעקוב יותר אחרי קליקים על NativeAd. צריך להפעיל את הפונקציה הזו לפני הצגת המודעה.
getAdChoicesInfo
abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?
מחזירה את המידע על שיוך המודעה ל-AdChoices.
getAdvertiser
abstract fun getAdvertiser(): String?
מחזירה טקסט שמזהה את המפרסם. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getBody
abstract fun getBody(): String?
הפונקציה מחזירה את הטקסט של תוכן ההודעה. האפליקציות נדרשות להציג את הנכס הזה.
getCallToAction
abstract fun getCallToAction(): String?
מחזירה את הקריאה לפעולה של המודעה (למשל, 'קנייה' או 'התקנה'). הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getExtras
abstract fun getExtras(): Bundle!
הפונקציה מחזירה חבילה של נכסים נוספים שמשויכים למודעה המותאמת. אם למודעה של שותף גישור יש נכסים בנוסף לנכסים הרגילים (מחיר, חנות וכו'), אפשר להגדיר אותם באמצעות קריאה לשיטה ב-setExtras, ואפשר לאחזר אותם באמצעות השיטה הזו. בתהליך שלא כולל תיווך, הפונקציה מחזירה חבילה ריקה.
getHeadline
abstract fun getHeadline(): String?
הפונקציה מחזירה את הכותרת הראשית של הטקסט. האפליקציות נדרשות להציג את הנכס הזה.
getIcon
abstract fun getIcon(): NativeAd.Image?
מחזירה תמונה קטנה שמזהה את המפרסם. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getImages
abstract fun getImages(): (Mutable)List<NativeAd.Image!>!
מחזירה רשימה של תמונות גדולות. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getMediaContent
abstract fun getMediaContent(): MediaContent?
מחזירה את MediaContent שמשויך למודעה הזו.
getMuteThisAdReasons
abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!
הפונקציה מחזירה את הסיבות להשתקת המודעה הזו שזמינות למודעה. משתמשים בתיאור הטקסט מהסיווג כדי להציג אותו למשתמש.
getPrice
abstract fun getPrice(): String?
למודעות לגבי אפליקציות, הפונקציה מחזירה מחרוזת שמייצגת את העלות של האפליקציה. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getResponseInfo
abstract fun getResponseInfo(): ResponseInfo?
מחזירה את האובייקט ResponseInfo של המודעה שנטענה. הפונקציה מחזירה null עד שהמודעה נטענת בהצלחה.
getStarRating
abstract fun getStarRating(): Double?
במודעות לגבי אפליקציות, הערך שמוחזר הוא דירוג בכוכבים מ-0 עד 5 שמייצג את מספר הכוכבים שהאפליקציה קיבלה בחנות שבה היא מוצעת. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
getStore
abstract fun getStore(): String?
במודעות לקידום אפליקציות, הפונקציה מחזירה את שם החנות שמציעה את האפליקציה להורדה. לדוגמה, Google Play. הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.
isCustomClickGestureEnabled
abstract funisCustomClickGestureEnabled(): Boolean
ההגדרה מציינת אם אפשר לדווח על קליקים באמצעות תנועות מותאמות אישית של קליקים. כדי להוסיף את יחידת המודעות לרשימת ההיתרים של התכונה הזו, צריך לפנות למנהל החשבון.
isCustomMuteThisAdEnabled
abstract fun isCustomMuteThisAdEnabled(): Boolean
הפונקציה מחזירה true אם אפשר להשתיק את המודעה הזו באופן פרוגרמטי. אפשר להשתמש בsetRequestCustomMuteThisAd כדי לבקש הטמעה מותאמת אישית של התכונה 'השתקת המודעה הזו'.
muteThisAd
abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit
השתקה פרוגרמטית של המודעה הזו.
| פרמטרים | |
|---|---|
muteThisAdReason: MuteThisAdReason! |
הסיבה להשתקה שנבחרה על ידי המשתמש. קבלת סיבות להשתקה מ- |
performClick
abstract fun performClick(clickData: Bundle!): Unit
צריך להפעיל את הפונקציה הזו כשמשתמש לוחץ על המודעה. כדי להשתמש ב-API הזה, צריך להוסיף את יחידת המודעות לרשימת ההיתרים. השיטה הזו מיועדת רק לבעלי תוכן דיגיטלי שמשתמשים בפלאגין Unity.
| פרמטרים | |
|---|---|
clickData: Bundle! |
חבילה של סביבת האפליקציה כשמתרחש הקליק. פרטים על אופן בניית נתוני הקליקים |
recordCustomClickGesture
abstract funrecordCustomClickGesture(): Unit
הדוח מציג קליקים על NativeAd באמצעות תנועת קליק מותאמת אישית. כדי להשתמש בשיטה הזו, יחידת המודעות צריכה להיכלל ברשימת ההיתרים.
צריך לקרוא ל-enableCustomClickGesture לפני הקריאה לשיטה הזו.
recordImpression
abstract fun recordImpression(impressionData: Bundle!): Boolean
צריך להפעיל את הפונקציה הזו כשהמודעה מוצגת בפעם הראשונה. כדי להשתמש ב-API הזה, צריך להוסיף את יחידת המודעות לרשימת ההיתרים.
| פרמטרים | |
|---|---|
impressionData: Bundle! |
חבילה של סביבת האפליקציה בזמן החשיפה. פרטים על אופן בניית נתוני הקליקים |
| החזרות | |
|---|---|
Boolean |
true אם הרשמת החשיפה נרשמה בהצלחה |
reportTouchEvent
abstract fun reportTouchEvent(touchEventData: Bundle!): Unit
צריך להפעיל את הפונקציה הזו כשמתרחש אירוע מגע במודעה. כדי להשתמש ב-API הזה, צריך להוסיף את יחידת המודעות לרשימת ההיתרים. אם אתם רוצים להשתמש בתכונה הזו, אתם יכולים לפנות למנהל החשבון שלכם.
| פרמטרים | |
|---|---|
touchEventData: Bundle! |
חבילה של קואורדינטות ומשך של אירוע מגע. דוגמה לייצוג JSON של חבילת touchEventData: { "x": "100", // The x-coordinate of the touch event relative to the window. "y": "50", // The y-coordinate of the touch event relative to the window. "duration_millis": "500", // The amount of milliseconds the user pressed on the asset. } |
setMuteThisAdListener
abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit
מגדיר את MuteThisAdListener של המודעה.
setOnPaidEventListener
abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit
רושמים קריאה חוזרת שתופעל כשהמערכת מעריכה שהמודעה הזו הניבה הכנסות.
setPlacementId
abstract fun setPlacementId(placementId: Long): Unit
מגדיר מזהה של מיקום מודעה עבור המודעה המותאמת.
כדי לוודא שמזהה מיקום המודעה הזה ייכלל בדוחות, צריך להפעיל את השיטה הזו לפני שמשייכים את המודעה לרכיב NativeAdView.
| פרמטרים | |
|---|---|
placementId: Long |
מספר שלם ארוך שמופיע בממשק המשתמש של AdMob למיקום המודעה שהוגדר. |
setUnconfirmedClickListener
abstract fun setUnconfirmedClickListener(
listener: NativeAd.UnconfirmedClickListener!
): Unit
מגדיר את UnconfirmedClickListener למודעה.