מכסת תדרים

public final class KeyedFrequencyCap
extends Object implements Parcelable

java.lang.Object
↳ android.adservices.common.KeyedFrequencyCap

מכסת תדירות למפתח ספציפי של מונה מודעות.

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

סיכום

מחלקות מקוננות

class KeyedFrequencyCap.Builder

Builder ליצירת אובייקטים של KeyedFrequencyCap. 

קבועים שעברו בירושה

שדות

public static final Creator<KeyedFrequencyCap> CREATOR

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

boolean equals(Object o)

הפונקציה בודקת אם האובייקטים KeyedFrequencyCap מכילים את אותו מידע.

int getAdCounterKey()

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

Duration getInterval()

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

int getMaxCount()

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

int hashCode()

מחזירה את הגיבוב של נתוני האובייקט KeyedFrequencyCap.

String toString()

מחזירה ייצוג במחרוזת של האובייקט.

void writeToParcel(Parcel dest, int flags)

יש לשטח את האובייקט ל-Parcel

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

שדות

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

שווה ל-

public boolean equals (Object o)

הפונקציה בודקת אם האובייקטים KeyedFrequencyCap מכילים את אותו מידע.

פרמטרים
o Object: אובייקט ההפניה שאליו תשוו.
החזרות
boolean true אם האובייקט הזה זהה ל-obj ארגומנט; אחרת, false.

getAdCounterKey

public int getAdCounterKey ()

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

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

החזרות
int הערך הזה לא יכול להיות null.

getInterval

public Duration getInterval ()

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

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

החזרות
Duration הערך הזה לא יכול להיות null.

getMaxCount

public int getMaxCount ()

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

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

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

החזרות
int

קוד גיבוב (hashCode)

public int hashCode ()

מחזירה את הגיבוב של נתוני האובייקט KeyedFrequencyCap.

החזרות
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