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

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

AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

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

---

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

מכונות של המחלקה הזו נוצרות על ידי ערכות SDK שיסופקו כארגומנטים ל-methods 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() תיאור סוגי העצמים המיוחדים שכלולים בחבילה הזו הייצוגים המשולבים של המכונה.
boolean	equals(Object o) מציין אם אובייקט אחר הוא "שווה ל" הזה.
AdSelectionSignals	getAdSelectionSignals()
List<AdTechIdentifier>	getCustomAudienceBuyers()
Uri	getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals>	getPerBuyerSignals()
AdTechIdentifier	getSeller()
AdSelectionSignals	getSellerSignals()
Uri	getTrustedScoringSignalsUri()
int	hashCode() מחזירה ערך גיבוב (hash) של האובייקט.
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

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

public static final Creator<AdSelectionConfig> CREATOR

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

תיאור התוכן

נוסף ברמת API 34

public int describeContents ()

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

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

שווה ל-

נוסף ברמת 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.

getAdSelectionSignals

נוסף ברמת API 34
זמין גם בתוספים 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 שמכיל את פונקציית ציון המודעה של המוכר/SSP שבה נעשה שימוש בתהליך בחירת המודעות והדיווח עליהן הערך הזה לא יכול להיות null.

getPerBuyerSignals

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

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

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

getSeller

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

public AdTechIdentifier getSeller ()

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

getSellerSignals

נוסף ברמת API 34
זמין גם בתוספים 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 ()

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

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

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

עד כמה שהדבר מעשי באופן סביר, שיטת ה-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