NativeAd

Kotlin |Java

public abstract class NativeAd

---

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

סיכום

סוגי רכיבים שמוצבים בתוך רכיבים אחרים
public abstract class NativeAd.AdChoicesInfo מידע על שיוך.
public abstract class NativeAd.Image נכס תמונה של מודעה מותאמת.
public interface NativeAd.OnNativeAdLoadedListener הגדרת ממשק לקריאה חוזרת שתופעל כשמודעה מותאמת תיטען בהצלחה.
public interface NativeAd.UnconfirmedClickListener ממשק מאזין שאפליקציות יכולות להשתמש בו כדי לקבל אירועים של קליקים לא מאושרים כשמשתמשים בתכונה 'אישור קליקים'.

‫constructors ציבוריים
NativeAd()

‫methods ציבוריות
abstract void	cancelUnconfirmedClick() ביטול קליק לא מאומת שתועד בעבר עבור המודעה.
abstract void	destroy() הפונקציה משמידה את אובייקט המודעה.
abstract void	enableCustomClickGesture() הmethod הזו הוצאה משימוש. שימוש בכתובת enableCustomClickGestureDirection.
abstract @Nullable NativeAd.AdChoicesInfo	getAdChoicesInfo() מחזירה את המידע על שיוך המודעה ל-AdChoices.
abstract @Nullable String	getAdvertiser() מחזירה טקסט שמזהה את המפרסם.
abstract @Nullable String	getBody() הפונקציה מחזירה את הטקסט של תוכן ההודעה.
abstract @Nullable String	getCallToAction() מחזירה את הקריאה לפעולה של המודעה (למשל, 'קנייה' או 'התקנה').
abstract Bundle	getExtras() מחזירה חבילה של נכסים נוספים שמשויכים למודעה המותאמת.
abstract @Nullable String	getHeadline() הפונקציה מחזירה את הכותרת הראשית של הטקסט.
abstract @Nullable NativeAd.Image	getIcon() מחזירה תמונה קטנה שמזהה את המפרסם.
abstract List<NativeAd.Image>	getImages() מחזירה רשימה של תמונות גדולות.
abstract @Nullable MediaContent	getMediaContent() מחזירה את האובייקט MediaContent שמשויך למודעה הזו.
abstract List<MuteThisAdReason>	getMuteThisAdReasons() מחזירה את הסיבות להשתקת המודעה הזו שזמינות למודעה.
abstract long	getPlacementId() מחזירה את מזהה מיקום המודעה של ה-NativeAd הזו.
abstract @Nullable String	getPrice() למודעות לגבי אפליקציות, הפונקציה מחזירה מחרוזת שמייצגת את העלות של האפליקציה.
abstract @Nullable ResponseInfo	getResponseInfo() מחזירה את האובייקט ResponseInfo של המודעה שנטענה.
abstract @Nullable Double	getStarRating() במודעות לגבי אפליקציות, הפונקציה מחזירה דירוג בכוכבים מ-0 עד 5 שמייצג את מספר הכוכבים שהאפליקציה קיבלה בחנות שבה היא מוצעת.
abstract @Nullable String	getStore() במודעות לקידום אפליקציות, הפונקציה מחזירה את שם החנות שמציעה את האפליקציה להורדה.
abstract boolean	isCustomClickGestureEnabled() הmethod הזו הוצאה משימוש. כשמטעינים מודעה באמצעות enableCustomClickGestureDirection, כל המודעות שמוחזרות תומכות בתנועת קליק מותאמת אישית.
abstract boolean	isCustomMuteThisAdEnabled() מחזירה true אם אפשר להשתיק את המודעה הזו באופן פרוגרמטי.
abstract void	muteThisAd(MuteThisAdReason muteThisAdReason) השתקת המודעה הזו באופן פרוגרמטי.
abstract void	performClick(Bundle clickData) צריך להפעיל את הפונקציה הזו כשמשתמש לוחץ על המודעה.
abstract void	recordCustomClickGesture() הmethod הזו הוצאה משימוש. ‫Google Mobile Ads SDK עכשיו עוקב אחרי תנועות מותאמות אישית של קליקים באמצעות כיוון תנועת הקליק שנדרש ב-enableCustomClickGestureDirection.
abstract boolean	recordImpression(Bundle impressionData) צריך להפעיל את הפונקציה הזו כשהמודעה מוצגת בפעם הראשונה.
abstract void	reportTouchEvent(Bundle touchEventData) צריך להפעיל את הפונקציה הזו כשמתרחש אירוע מגע במודעה.
abstract void	setMuteThisAdListener(MuteThisAdListener listener) מגדירה את ה-MuteThisAdListener של המודעה.
abstract void	setOnPaidEventListener(@Nullable OnPaidEventListener listener) רושמת קריאה חוזרת שתופעל כשהמערכת תעריך שהמודעה הזו הניבה רווחים.
abstract void	setPlacementId(long placementId) מגדירה מזהה מיקום למודעה המותאמת.
abstract void	setUnconfirmedClickListener(     NativeAd.UnconfirmedClickListener listener ) מגדירה את UnconfirmedClickListener למודעה.

‫constructors ציבוריים

NativeAd

public NativeAd()

‫methods ציבוריות

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

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

כיבוי סופי

public abstract void destroy()

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

enableCustomClickGesture

public abstract void enableCustomClickGesture()

ה-method הזו הוצאה משימוש.

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

ההגדרה הזו מאפשרת לבעלי תוכן דיגיטלי לדווח על קליקים באמצעות מחוות בהתאמה אישית עבור 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.Image> getImages()

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

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

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

getMuteThisAdReasons

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

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

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()

ה-method הזו הוצאה משימוש.

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

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

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()

ה-method הזו הוצאה משימוש.

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

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

צריך להפעיל את enableCustomClickGesture לפני שמפעילים את ה-method הזו.

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)

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

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

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

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

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