מכסת תדירות
public
final
class
FrequencyCapFilters
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.common.FrequencyCapFilters |
מאגר למסנני המודעות שמבוססים על מכסות תדירות.
לא ניתן לשייך יותר מ-20 מסננים של מכסת תדירות למודעה אחת.
מסננים של מכסות תדירות משלבים סוג אירוע עם רשימה של KeyedFrequencyCap
אובייקטים
כדי להגדיר אוסף של מסנני מודעות. אם תחרגו ממכסות התדירות האלה לגבי מודעה מסוימת,
המודעה תוסר מקבוצת המודעות שנשלחה אל פונקציית הבידינג של טכנולוגיית הפרסום של קונה.
סיכום
מחלקות מקוננות | |
---|---|
class |
FrequencyCapFilters.Builder
Builder ליצירת אובייקטים של |
קבועים | |
---|---|
int |
AD_EVENT_TYPE_CLICK
|
int |
AD_EVENT_TYPE_IMPRESSION
|
int |
AD_EVENT_TYPE_VIEW
|
int |
AD_EVENT_TYPE_WIN
סוג האירוע של מודעת WIN מאוכלס באופן אוטומטי בשירות Protected Audience עבור כל מודעה זוכה שמוחזרת מבחירת המודעות מסוג Protected Audience. |
קבועים שעברו בירושה |
---|
שדות | |
---|---|
public
static
final
Creator<FrequencyCapFilters> |
CREATOR
|
שיטות ציבוריות | |
---|---|
boolean
|
equals(Object o)
הפונקציה בודקת אם האובייקטים |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForClickEvents()
הפונקציה מקבלת את הרשימה של |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForImpressionEvents()
הפונקציה מקבלת את הרשימה של |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForViewEvents()
הפונקציה מקבלת את הרשימה של |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForWinEvents()
הפונקציה מקבלת את הרשימה של |
int
|
hashCode()
מחזירה את הגיבוב של נתוני האובייקט |
String
|
toString()
מחזירה ייצוג במחרוזת של האובייקט. |
void
|
writeToParcel(Parcel dest, int flags)
יש לשטח את האובייקט ל-Parcel |
שיטות שעברו בירושה | |
---|---|
קבועים
AD_EVENT_TYPE_CLICK
public static final int AD_EVENT_TYPE_CLICK
ערך קבוע: 3 (0x00000003)
AD_EVENT_TYPE_IMPRESSION
public static final int AD_EVENT_TYPE_IMPRESSION
ערך קבוע: 1 (0x00000001)
AD_EVENT_TYPE_VIEW
public static final int AD_EVENT_TYPE_VIEW
ערך קבוע: 2 (0x00000002)
AD_EVENT_TYPE_WIN
public static final int AD_EVENT_TYPE_WIN
סוג האירוע של מודעת WIN מאוכלס באופן אוטומטי בשירות Protected Audience עבור כל מודעה זוכה שמוחזרת מבחירת המודעות מסוג Protected Audience.
אין להשתמש בהם כדי לעדכן באופן ידני היסטוגרמה נגדית של מודעות.
ערך קבוע: 0 (0x00000000)
שדות
CREATOR
public static final Creator<FrequencyCapFilters> CREATOR
שיטות ציבוריות
שווה ל-
public boolean equals (Object o)
הפונקציה בודקת אם האובייקטים FrequencyCapFilters
מכילים את אותו מידע.
פרמטרים | |
---|---|
o |
Object : אובייקט ההפניה שאליו תשוו. |
החזרות | |
---|---|
boolean |
true אם האובייקט הזה זהה ל-obj
ארגומנט; אחרת, false . |
getKeyedFrequencyCapsForClickEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()
הפונקציה מקבלת את הרשימה של KeyedFrequencyCap
אובייקטים שיעברו סינון לפי סוג האירוע AD_EVENT_TYPE_CLICK
.
מכסות התדירות האלה חלות על אירועים שקשורים לקליק כפי שמפורש על ידי
פרסום דיגיטלי. אירועי קליק נספרים כאשר ה-API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
מופעל עם אירוע מסוג AD_EVENT_TYPE_CLICK
.
החזרות | |
---|---|
List<KeyedFrequencyCap> |
הערך הזה לא יכול להיות null . |
getKeyedFrequencyCapsForimpressionEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()
הפונקציה מקבלת את הרשימה של KeyedFrequencyCap
אובייקטים שיעברו סינון לפי סוג האירוע AD_EVENT_TYPE_IMPRESSION
.
מכסות התדירות האלה חלות על אירועים שקשורים לחשיפה כפי שמפוענח באמצעות פרסום דיגיטלי.
לתשומת ליבך, אירועים לא נספרים באופן אוטומטי כשמתבצעת הפעלה של AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver)
. במקום זאת, סוג האירוע AD_EVENT_TYPE_IMPRESSION
חייב
יעודכנו באמצעות ה-API של AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
.
החזרות | |
---|---|
List<KeyedFrequencyCap> |
הערך הזה לא יכול להיות null . |
getKeyedFrequencyCapsForViewEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()
הפונקציה מקבלת את הרשימה של KeyedFrequencyCap
אובייקטים שיעברו סינון לפי סוג האירוע AD_EVENT_TYPE_VIEW
.
מכסות התדירות האלה חלות על אירועים שקשורים לצפייה כפי שמפורש על ידי
פרסום דיגיטלי. אירועים מסוג צפייה נספרים כשה-API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
מופעל עם אירוע מסוג AD_EVENT_TYPE_VIEW
.
החזרות | |
---|---|
List<KeyedFrequencyCap> |
הערך הזה לא יכול להיות null . |
getKeyedFrequencyCapsForWinEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()
הפונקציה מקבלת את הרשימה של KeyedFrequencyCap
אובייקטים שיעברו סינון לפי סוג האירוע AD_EVENT_TYPE_WIN
.
מכסות התדירות האלה חלות על אירועים של מודעות שנבחרו כמנצחות במודעה בחירה. המודעות הזוכות משמשות להוספה אוטומטית של מפתחות המונה המשויכים אירוע מסוג 'זכייה'.
לתשומת ליבכם: לא ניתן לעדכן את סוג האירוע AD_EVENT_TYPE_WIN
באופן ידני באמצעות
AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
API.
החזרות | |
---|---|
List<KeyedFrequencyCap> |
הערך הזה לא יכול להיות null . |
קוד גיבוב (hashCode)
public int hashCode ()
מחזירה את הגיבוב של נתוני האובייקט FrequencyCapFilters
.
החזרות | |
---|---|
int |
ערך קוד גיבוב (hash) של האובייקט הזה. |
toString (מחרוזת)
public String toString ()
מחזירה ייצוג במחרוזת של האובייקט. באופן כללי,
ה-method toString
מחזירה מחרוזת
'ייצוג טקסטואלי' של האובייקט הזה. התוצאה צריכה
להיות ייצוג תמציתי ואינפורמטיבי, שקל לבצע
אדם לקרוא.
מומלץ שכל מחלקות המשנה יבטלו את השיטה הזו.
השיטה toString
לכיתה Object
מחזירה מחרוזת שמורכבת מהשם של המחלקה שבה
האובייקט הוא מופע, התו '@
' עם הסימן @,
את הייצוג ההקסדצימלי הלא חתום של קוד הגיבוב של
לאובייקט. במילים אחרות, השיטה הזו מחזירה מחרוזת השווה
ערך של:
getClass().getName() + '@' + Integer.toHexString(hashCode())
החזרות | |
---|---|
String |
ייצוג במחרוזת של האובייקט. |
WriteToParcel
public void writeToParcel (Parcel dest, int flags)
יש לשטח את האובייקט ל-Parcel
פרמטרים | |
---|---|
dest |
Parcel : הערך הזה לא יכול להיות null . |
flags |
int : דגלים נוספים לגבי אופן הכתיבה של האובייקט.
יכול להיות 0 או Parcelable.PARCELABLE_WRITE_RETURN_VALUE .
הערך הוא 0 או שילוב של Parcelable.PARCELABLE_WRITE_RETURN_VALUE , עם android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |