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 לאובייקט |
קבועים שעברו בירושה |
---|
שדות | |
---|---|
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 |
שיטות שעברו בירושה | |
---|---|
שדות
CREATOR
public static final Creator<AdSelectionConfig> CREATOR
שיטות ציבוריות
תיאור התוכן
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 . |
getAdSelectionSignals
public AdSelectionSignals getAdSelectionSignals ()
החזרות | |
---|---|
AdSelectionSignals |
JSON באובייקט AdSelectionSignals, שאוחזר מה-AdSelectionConfig ונצרכות
על ידי לוגיקת ה-JS שאוחזרה מה-DSP, מייצגת אותות שניתנו ל
את הקונים בתהליכי בחירת המודעות והדיווח.
הערך הזה לא יכול להיות null . |
getCustomAudienceBuyers
public List<AdTechIdentifier> getCustomAudienceBuyers ()
החזרות | |
---|---|
List<AdTechIdentifier> |
רשימה של קנייני קהלים בהתאמה אישית שקיבלו הרשאה מה-SSP להשתתף במודעה
תהליך בחירה
הערך הזה לא יכול להיות null . |
getDecisionLogicUri
public Uri getDecisionLogicUri ()
החזרות | |
---|---|
Uri |
ה-URI המשמש לאחזור קוד ה-JS שמכיל את פונקציית ציון המודעה של המוכר/SSP שבה נעשה שימוש
בתהליך בחירת המודעות והדיווח עליהן
הערך הזה לא יכול להיות null . |
getPerBuyerSignals
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()
החזרות | |
---|---|
Map<AdTechIdentifier, AdSelectionSignals> |
מפה של קונים ו-AdSelectionSignals, שאוחזרה מה-AdSelectionConfig
נעשה על ידי לוגיקת ה-JS שאוחזרה מה-DSP, שמייצגת כל מידע שכל אחד מהם
הקונה יספק למשתתפים במהלך בחירת המודעה (כגון סף תחתון להצעת מחיר, בחירת מודעה
וכו')
הערך הזה לא יכול להיות null . |
getSeller
public AdTechIdentifier getSeller ()
החזרות | |
---|---|
AdTechIdentifier |
מזהה AdTechIdentifier של בית העסק, לדוגמה www.example-ssp.com
הערך הזה לא יכול להיות null . |
getSellerSignals
public AdSelectionSignals getSellerSignals ()
החזרות | |
---|---|
AdSelectionSignals |
JSON באובייקט AdSelectionSignals, שסופק על ידי ה-SSP ונצרך על ידי ה-JS
הלוגיקה שאוחזרה מה-SSP, מייצגת כל מידע שבו ה-SSP משתמש במודעה
תהליך הציון לשינוי התוצאות של תהליך בחירת המודעה (למשל, הגנה על המותג
בדיקות, החרגת מודעות לפי הקשר).
הערך הזה לא יכול להיות null . |
getTrustedScoringSignalsUri
public Uri getTrustedScoringSignalsUri ()
החזרות | |
---|---|
Uri |
נקודת קצה ב-URI של אות מהימן בצד המוכר, שממנו הקריאייטיב ספציפי בזמן אמת
שאפשר לשלוף ממנו מידע.
הערך הזה לא יכול להיות null . |
קוד גיבוב (hashCode)
public int hashCode ()
מחזירה ערך גיבוב (hash) של האובייקט. השיטה הזאת
נתמך לטובת טבלאות גיבוב (hash), כמו אלה שמסופקות על ידי
HashMap
החוזה הכללי של hashCode
הוא:
- בכל פעם שהוא מופעל על אותו אובייקט יותר מפעם אחת במהלך
הרצה של אפליקציה ב-Java, ה-method
hashCode
צריך להחזיר בעקביות את אותו מספר שלם, כל עוד אין מידע שנעשה בו שימוש בהשוואות שלequals
באובייקט. המספר השלם הזה לא צריך להיות עקבי מהפעלה אחת של לביצוע אחר של אותה האפליקציה. - אם שני אובייקטים שווים לפי
equals(Object)
ואז קריאה ל-methodhashCode
בכל אחד שני האובייקטים חייבים להפיק את אותה תוצאה של מספר שלם. - לא נדרש שאם שני אובייקטים אינם שווים
בהתאם ל
equals(java.lang.Object)
ואז קריאה ל-methodhashCode
בכל אחד שני אובייקטים חייבים להניב תוצאות נפרדות של מספרים שלמים. אבל, מתכנת צריך להיות מודע לכך שהפקת תוצאות של מספרים שלמים נפרדים לאובייקטים לא שווים, עשויה לשפר את הביצועים של טבלאות גיבוב.
עד כמה שהדבר מעשי באופן סביר, שיטת ה-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 |