AdSelectionFromresultsConfig

public final class AdSelectionFromOutcomesConfig
extends Object implements Parcelable

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

מכיל את התצורה של תהליך בחירת המודעה שבוחרת מנצח מתוך רשימה נתונה של מזהים של בחירת מודעות.

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

סיכום

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

class AdSelectionFromOutcomesConfig.Builder

Builder ל-AdSelectionFromOutcomesConfig אובייקטים. 

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

שדות

public static final Creator<AdSelectionFromOutcomesConfig> CREATOR

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

int describeContents()

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

boolean equals(Object o)

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

List<Long> getAdSelectionIds()
Uri getSelectionLogicUri()
AdSelectionSignals getSelectionSignals()
AdTechIdentifier getSeller()
int hashCode()

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

void writeToParcel(Parcel dest, int flags)

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

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

שדות

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

תיאור התוכן

public int describeContents ()

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

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

שווה ל-

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.

getAdSelectionIds

public List<Long> getAdSelectionIds ()

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

getSelectionLogicUri

public Uri getSelectionLogicUri ()

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

getSelectionSignals

public AdSelectionSignals getSelectionSignals ()

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

getSeller

public AdTechIdentifier getSeller ()

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

קוד גיבוב (hashCode)

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

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