דף זה תורגם על ידי Cloud Translation API.

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

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

מזהה מודעה

public class AdId
extends Object

java.lang.Object
↳	android.adservices.adid.AdId

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

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

למידע נוסף:

AdIdManager.getAdId(Executor, OutcomeReceiver)

סיכום

קבועים
`String`	`ZERO_OUT` `ad id` מאפס, שמוחזר כשלמשתמש יש `limited ad tracking`.

בנאים ציבוריים
`AdId(String adId, boolean limitAdTrackingEnabled)` יצירת מופע של `AdId`

שיטות ציבוריות
`boolean`	`equals(Object o)` מציין אם אובייקט אחר הוא "שווה ל" הזה.
`String`	`getAdId()` מזהה הפרסום
`int`	`hashCode()` מחזירה ערך גיבוב (hash) של האובייקט.
`boolean`	`isLimitAdTrackingEnabled()` אחזור ההגדרה של מגבלת המעקב אחרי מודעות.
`String`	`toString()` מחזירה ייצוג במחרוזת של האובייקט.

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

מהכיתה


        
          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()` גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.

קבועים

ZERO_OUT

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public static final String ZERO_OUT

ad id מאפס, שמוחזר כשלמשתמש יש limited ad tracking.

ערך קבוע: 00000000-0000-0000-0000-000000000000

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

מזהה מודעה

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

יצירת מופע של AdId

פרמטרים
`adId`	`String`: התקבל משירות הספק. הערך הזה לא יכול להיות `null`.
`limitAdTrackingEnabled`	`boolean`: ערך משירות הספק שקובע את הערך של מזהה המודעה.

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

שווה ל-

נוסף ברמת API 34

public boolean equals (Object o)

מציין אם אובייקט אחר הוא "שווה ל" הזה.

השיטה equals מטמיעים יחס שקילות בהפניות לאובייקטים שאינם אפס:

הגדרה רפלקטיבית: לכל ערך הפניה שהוא לא null x, x.equals(x) אמור לחזור true
הערך הוא סימטרי: לכל ערכי הפניה שאינם אפס x וגם y, x.equals(y) צריך להחזיר את הערך true אם ורק אם הפונקציה y.equals(x) מחזירה true.
הוא מעבר: לכל ערכי הפניה שאינם null x, y וגם z, אם x.equals(y) מחזירה true ו y.equals(z) מחזירה true, ואז x.equals(z) אמור להחזיר true.
הוא עקבי: לכל ערכי הפניה שאינם null x ו-y, מספר הפעלות של x.equals(y) מחזיר true באופן עקבי או להחזיר בעקביות false, בתנאי שלא מידע שמשמש בהשוואות של equals אובייקטים הם משתנים.
לכל ערך הפניה שהוא לא אפס, x הפונקציה x.equals(null) צריכה להחזיר את הערך false.

ה-method equals למחלקה Object מיושמת את יחס השקילות האפשריים ביותר על אובייקטים; כלומר, לכל ערכי הפניה שאינם אפסיים x וגם y, השיטה הזו מחזירה true אם ורק אם x ו-y מתייחסים לאותו אובייקט (x == y יש את הערך true).

לתשומת ליבכם: בדרך כלל יש צורך בשינוי מברירת המחדל של hashCode בכל פעם שמחליפים את השיטה, כדי לשמור על חוזה כללי ל-method hashCode, שקובעת שאובייקטים שווים חייבים להיות בעלי קודי גיבוב (hash) שווים.

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

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

מזהה מודעה

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public String getAdId ()

מזהה הפרסום

הערך של מזהה הפרסום תלוי בשילוב של isLimitAdTrackingEnabled() ו-AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

כשהמשתמש הוא limiting ad tracking, ה-API מחזיר ZERO_OUT. מצב זה מונע מהמתקשר לעקוב אחר המשתמש למטרות מונטיזציה.

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

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

קוד גיבוב (hashCode)

נוסף ברמת API 34

public int hashCode ()

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

החוזה הכללי של hashCode הוא:

בכל פעם שהוא מופעל על אותו אובייקט יותר מפעם אחת במהלך הרצה של אפליקציה ב-Java, ה-method hashCode צריך להחזיר בעקביות את אותו מספר שלם, כל עוד אין מידע שנעשה בו שימוש בהשוואות של equals באובייקט. המספר השלם הזה לא צריך להיות עקבי מהפעלה אחת של לביצוע אחר של אותה האפליקציה.
אם שני אובייקטים שווים לפי equals(Object) ואז קריאה ל-method hashCode בכל אחד שני האובייקטים חייבים להפיק את אותה תוצאה של מספר שלם.
לא נדרש שאם שני אובייקטים אינם שווים בהתאם לequals(java.lang.Object) ואז קריאה ל-method hashCode בכל אחד שני אובייקטים חייבים להניב תוצאות נפרדות של מספרים שלמים. אבל, מתכנת צריך להיות מודע לכך שהפקת תוצאות של מספרים שלמים נפרדים לאובייקטים לא שווים, עשויה לשפר את הביצועים של טבלאות גיבוב.

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

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

הפרמטר isLimitAdTrackingEnabled

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public boolean isLimitAdTrackingEnabled ()

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

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

החזרות
`boolean`

toString (מחרוזת)

נוסף ברמת API 34

public String toString ()

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

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

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

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