NativeAd

public abstract class NativeAd


מודעה מותאמת של Google.

סיכום

סוגים מוטמעים

public abstract class NativeAd.AdChoicesInfo

מידע על שיוך.

public abstract class NativeAd.Image

נכס תמונה של מודעה מותאמת.

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

ממשק מאזין שאפליקציות יכולות להשתמש בו כדי לקבל אירועים של קליקים לא מאומתים כשמשתמשים בתכונה 'אישור קליקים'.

בוני אובייקטים ציבוריים

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

abstract void

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

abstract void

הפונקציה הזו מוחקת את אובייקט המודעה.

abstract void

השיטה הזו הוצאה משימוש.

שימוש בכתובת enableCustomClickGestureDirection.

abstract @Nullable NativeAd.AdChoicesInfo

מחזירה את המידע על שיוך המודעה ל-AdChoices.

abstract @Nullable String

מחזירה טקסט שמזהה את המפרסם.

abstract @Nullable String

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

abstract @Nullable String

מחזירה את הקריאה לפעולה של המודעה (למשל, 'קנייה' או 'התקנה').

abstract Bundle

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

abstract @Nullable String

הפונקציה מחזירה את הכותרת הראשית של הטקסט.

abstract @Nullable NativeAd.Image

מחזירה תמונה קטנה שמזהה את המפרסם.

abstract List<NativeAd.Image>

מחזירה רשימה של תמונות גדולות.

abstract @Nullable MediaContent

מחזירה את MediaContent שמשויך למודעה הזו.

abstract List<MuteThisAdReason>

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

abstract long

מחזירה את מזהה מיקום המודעה של NativeAd.

abstract @Nullable String

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

abstract @Nullable ResponseInfo

מחזירה את האובייקט ResponseInfo של המודעה שנטענה.

abstract @Nullable Double

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

abstract @Nullable String

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

abstract boolean

השיטה הזו הוצאה משימוש.

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

abstract boolean

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

abstract void
muteThisAd(MuteThisAdReason muteThisAdReason)

השתקה פרוגרמטית של המודעה הזו.

abstract void
performClick(Bundle clickData)

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

abstract void

השיטה הזו הוצאה משימוש.

‫Google Mobile Ads SDK עכשיו עוקב אחרי תנועות מותאמות אישית של קליקים באמצעות כיוון תנועת הקליק שנדרש ב-enableCustomClickGestureDirection.

abstract boolean
recordImpression(Bundle impressionData)

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

abstract void
reportTouchEvent(Bundle touchEventData)

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

abstract void

מגדיר את MuteThisAdListener של המודעה.

abstract void

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

abstract void
setPlacementId(long placementId)

מגדיר מזהה של מיקום מודעה עבור המודעה המותאמת.

abstract void

מגדיר את UnconfirmedClickListener למודעה.

בוני אובייקטים ציבוריים

NativeAd

public NativeAd()

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

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

כיבוי סופי

public abstract void destroy()

הפונקציה הזו מוחקת את אובייקט המודעה. אסור לקרוא לשיטות אחרות באובייקט המודעה אחרי הקריאה ל- destroy.

enableCustomClickGesture

public abstract void enableCustomClickGesture()

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

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

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

מחזירה את המידע על שיוך המודעה ל-AdChoices.

getAdvertiser

public abstract @Nullable String getAdvertiser()

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

getBody

public abstract @Nullable String getBody()

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

getCallToAction

public abstract @Nullable String getCallToAction()

מחזירה את הקריאה לפעולה של המודעה (למשל, 'קנייה' או 'התקנה'). הצגת הנכס הזה באפליקציות היא לא חובה, אבל מומלצת.

getExtras

public abstract Bundle getExtras()

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

getHeadline

public abstract @Nullable String getHeadline()

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

getIcon

public abstract @Nullable NativeAd.Image getIcon()

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

getImages

public abstract List<NativeAd.ImagegetImages()

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

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

מחזירה את MediaContent שמשויך למודעה הזו.

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

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

getPlacementId

public abstract long getPlacementId()

מחזירה את מזהה מיקום המודעה של NativeAd.

getPrice

public abstract @Nullable String getPrice()

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

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

מחזירה את האובייקט ResponseInfo של המודעה שנטענה. הפונקציה מחזירה null עד שהמודעה נטענת בהצלחה.

getStarRating

public abstract @Nullable Double getStarRating()

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

getStore

public abstract @Nullable String getStore()

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

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

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

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

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

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

השתקה פרוגרמטית של המודעה הזו.

פרמטרים
MuteThisAdReason muteThisAdReason

הסיבה להשתקה שנבחרה על ידי המשתמש. קבלת סיבות להשתקה מ-getMuteThisAdReasons. משתמשים בnull כדי להשתיק את המודעה הזו עם סיבת ברירת המחדל.

performClick

public abstract void performClick(Bundle clickData)

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

פרמטרים
Bundle clickData

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

recordCustomClickGesture

public abstract void recordCustomClickGesture()

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

צריך לקרוא ל-enableCustomClickGesture לפני הקריאה לשיטה הזו.

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

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

פרמטרים
Bundle impressionData

חבילה של סביבת האפליקציה בזמן החשיפה. פרטים על אופן בניית נתוני הקליקים Bundle זמינים במאמר NativeAdConstants.

החזרות
boolean

true אם הרשמת החשיפה נרשמה בהצלחה

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

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

פרמטרים
Bundle touchEventData

חבילה של קואורדינטות ומשך של אירוע מגע.

דוגמה לייצוג 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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

מגדיר את MuteThisAdListener של המודעה.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

מגדיר מזהה של מיקום מודעה עבור המודעה המותאמת.

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

פרמטרים
long placementId

מספר שלם ארוך שמופיע בממשק המשתמש של AdMob למיקום המודעה שהוגדר.

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

מגדיר את UnconfirmedClickListener למודעה.