נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

סיכום: כיתות בתצוגת עץ | קבועים שעוברים בירושה | שדות | שיטות | שיטות שעוברות בירושה

AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.adselection.AdSelectionConfig

---

מידע על ההגדרות של תהליך בחירת המודעות.

ערכים של הכיתה הזו נוצרים על ידי ערכות SDK כדי לספק אותם כארגומנטים לשיטות AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) ו-AdSelectionManager#reportImpression ב-AdSelectionManager.

סיכום

כיתות בתצוגת עץ
class	AdSelectionConfig.Builder ה-builder של אובייקט AdSelectionConfig.

קבועים שעברו בירושה
מהממשק 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<AdSelectionConfig>	CREATOR

שיטות ציבוריות
int	describeContents() תיאור הסוגים של אובייקטים מיוחדים שמכילים את הייצוג המארגן של מופע ה-Parcelable הזה.
boolean	equals(Object o) מציין אם אובייקט אחר הוא 'שווה' לאובייקט הזה.
AdSelectionSignals	getAdSelectionSignals()
List<AdTechIdentifier>	getCustomAudienceBuyers()
Uri	getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals>	getPerBuyerSignals()
AdTechIdentifier	getSeller()
AdSelectionSignals	getSellerSignals()
Uri	getTrustedScoringSignalsUri()
int	hashCode() הפונקציה מחזירה ערך של קוד גיבוב לאובייקט.
void	writeToParcel(Parcel dest, int flags) משטחים את האובייקט הזה ל-Parcel.

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

שדות

CREATOR

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

public static final Creator<AdSelectionConfig> CREATOR

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

תיאור התוכן

נוספה ב-רמת API 34

public int describeContents ()

צריך לתאר את סוגי האובייקטים המיוחדים שכלולים בייצוג המתואם של המכונה הזו של Parcelable. לדוגמה, אם האובייקט יכלול מתאר קובץ בפלט של writeToParcel(android.os.Parcel, int), הערך המוחזר של ה-method הזה חייב לכלול את הביט CONTENTS_FILE_DESCRIPTOR.

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

שווה ל-

נוספה ב-רמת API 34

public boolean equals (Object o)

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

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

• היא רפליקטיבית: לכל ערך הפניה שהוא לא null x, x.equals(x) צריך להחזיר true.
• היא סימטרית: לערכי הפניה שאינם null 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.
• היא עקבית: לכל ערכי ההפניה x ו-y שאינם null, מספר הפעמים שהקריאה ל-x.equals(y) מחזירה את הערך true או את הערך false תמיד זהה, בתנאי שלא בוצעו שינויים במידע שמשמש להשוואות של equals באובייקטים.
• לכל ערך הפניה x שאינו null, הפונקציה x.equals(null) אמורה להחזיר את הערך false.

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

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

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

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

getAdSelectionSignals

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

public AdSelectionSignals getAdSelectionSignals ()

החזרות
AdSelectionSignals	קובץ JSON באובייקט AdSelectionSignals, שאוחזר מ-AdSelectionConfig ונצרך על ידי לוגיקת ה-JS שאוחזרה מ-DSP, מייצג אותות שניתנים לקונים שמשתתפים בתהליכי בחירת המודעות והדיווח. הערך לא יכול להיות null.

getCustomAudienceBuyers

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

public List<AdTechIdentifier> getCustomAudienceBuyers ()

החזרות
List<AdTechIdentifier>	רשימה של קונים של קהלים מותאמים אישית שמותר להם להשתתף בתהליך בחירת המודעות על ידי ה-SSP. הערך לא יכול להיות null.

getDecisionLogicUri

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

public Uri getDecisionLogicUri ()

החזרות
Uri	ה-URI שמשמש לאחזור קוד ה-JS שמכיל את פונקציית scoreAd של המוכר/ה-SSP שנעשה בה שימוש במהלך תהליכי בחירת המודעות והדיווח. הערך לא יכול להיות null.

getPerBuyerSignals

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

החזרות
Map<AdTechIdentifier, AdSelectionSignals>	מפה של קונים ו-AdSelectionSignals, שאוחזרה מ-AdSelectionConfig ונצרכת על ידי הלוגיקה של ה-JS שאוחזרה מה-DSP, שמייצגת את כל המידע שכל קונה יספק למשתתפים במהלך בחירת המודעה (כמו סכום מינימום להצעת מחיר, סוג בחירת המודעה וכו'). הערך לא יכול להיות null.

getSeller

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

public AdTechIdentifier getSeller ()

החזרות
AdTechIdentifier	מזהה AdTechIdentifier של בית העסק, לדוגמה www.example-ssp.com. הערך הזה לא יכול להיות null.

getSellerSignals

נוספה ב-רמת API 34
מופיעה גם ב-Ad Services Extensions 4

public AdSelectionSignals getSellerSignals ()

החזרות
AdSelectionSignals	קובץ JSON באובייקט AdSelectionSignals, שסופק על ידי ה-SSP ונצרך על ידי הלוגיקה של ה-JS שאוחזרה מה-SSP, מייצג את כל המידע שה-SSP השתמש בו בתהליך הניקוד של המודעות כדי לשנות את התוצאות של תהליך בחירת המודעות (למשל, בדיקות של בטיחות המותג, מודעות לפי הקשר שהוחרגו). הערך לא יכול להיות null.

getTrustedScoringSignalsUri

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

public Uri getTrustedScoringSignalsUri ()

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

hashCode

נוספה ב-רמת API 34

public int hashCode ()

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

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

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

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

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

WriteToParcel

נוספה ב-רמת API 34

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