נוסף ב-Android UpsideDownCakePrivacySandbox

סיכום: מחלקות מקוננות | קבועים שעברו בירושה | שדות | שיטות | שיטות שעברו בירושה

מכסת תדרים

public final class KeyedFrequencyCap
extends Object implements Parcelable

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

---

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

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

סיכום

מחלקות מקוננות
class	KeyedFrequencyCap.Builder Builder ליצירת אובייקטים של KeyedFrequencyCap.

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

מהממשק android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR ביט מתאר שנעשה בו שימוש עם describeContents(): מציין הייצוג הקבוע של האובייקט Parcelable כולל מתאר קובץ. int PARCELABLE_WRITE_RETURN_VALUE סימון לשימוש עם writeToParcel(Parcel, int): האובייקט שנכתב הוא ערך מוחזר, כלומר תוצאה של פונקציה כמו "Parcelable someFunction()", "void someFunction(out Parcelable)", או "void someFunction(inout Parcelable)".

שדות
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

שיטות שעברו בירושה
מהכיתה java.lang.Object Object clone() יצירה ומחזירה של עותק של האובייקט הזה. boolean equals(Object obj) מציין אם אובייקט אחר הוא "שווה ל" הזה. void finalize() שיחה מופעלת על ידי אוסף האשפה על עצם כלשהו במהלך איסוף אשפה קובע שאין יותר הפניות לאובייקט. final Class<?> getClass() הפונקציה מחזירה את המחלקה של סביבת זמן הריצה של Object. int hashCode() מחזירה ערך גיבוב (hash) של האובייקט. final void notify() הוצאת שרשור יחיד שממתין לאובייקט מעקב. final void notifyAll() פעולה זו מוציאה את כל השרשורים שממתינים למסך של האובייקט הזה. String toString() מחזירה ייצוג במחרוזת של האובייקט. final void wait(long timeoutMillis, int nanos) גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת. final void wait(long timeoutMillis) גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת. final void wait() גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.
מהממשק android.os.Parcelable abstract int describeContents() תיאור סוגי העצמים המיוחדים שכלולים בחבילה הזו הייצוגים המשולבים של המכונה. abstract void writeToParcel(Parcel dest, int flags) יש לשטח את האובייקט ל-Parcel

שדות

CREATOR

נוסף ב-Android UpsideDownCakePrivacySandbox

public static final Creator<KeyedFrequencyCap> CREATOR

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

שווה ל-

נוסף ב-Android UpsideDownCakePrivacySandbox

public boolean equals (Object o)

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

פרמטרים
o	Object: אובייקט ההפניה שאליו תשוו.

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

getAdCounterKey

נוסף ב-Android UpsideDownCakePrivacySandbox

public int getAdCounterKey ()

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

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

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

getInterval

נוסף ב-Android UpsideDownCakePrivacySandbox

public Duration getInterval ()

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

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

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

getMaxCount

נוסף ב-Android UpsideDownCakePrivacySandbox

public int getMaxCount ()

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

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

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

החזרות
int

קוד גיבוב (hashCode)

נוסף ב-Android UpsideDownCakePrivacySandbox

public int hashCode ()

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

החזרות
int	ערך קוד גיבוב (hash) של האובייקט הזה.

toString (מחרוזת)

נוסף ב-Android UpsideDownCakePrivacySandbox

public String toString ()

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

השיטה toString לכיתה Object מחזירה מחרוזת שמורכבת מהשם של המחלקה שבה האובייקט הוא מופע, התו '@' עם הסימן @, את הייצוג ההקסדצימלי הלא חתום של קוד הגיבוב של לאובייקט. במילים אחרות, השיטה הזו מחזירה מחרוזת השווה ערך של:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

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

WriteToParcel

נוסף ב-Android UpsideDownCakePrivacySandbox

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