קהל בהתאמה אישית
public
final
class
CustomAudience
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.customaudience.CustomAudience |
מייצג את המידע שדרוש לקהל בהתאמה אישית לצורך השתתפות בבחירת מודעות.
קהל בהתאמה אישית הוא קבוצה מופשטת של משתמשים עם תחומי עניין דומים מוכחים. הזה class הוא אוסף של נתונים מסוימים שמאוחסנים במכשיר שדרושים לצורך הצגת מודעות לטרגט קהל מותאם אישית אחד.
סיכום
מחלקות מקוננות | |
---|---|
class |
CustomAudience.Builder
Builder ל- |
קבועים שעברו בירושה |
---|
שדות | |
---|---|
public
static
final
Creator<CustomAudience> |
CREATOR
|
שיטות ציבוריות | |
---|---|
boolean
|
equals(Object o)
הפונקציה בודקת אם שני אובייקטים מסוג |
Instant
|
getActivationTime()
כשיוצרים את האובייקט |
List<AdData>
|
getAds()
הרשימה הזו של |
Uri
|
getBiddingLogicUri()
פונקציה זו מחזירה את URI היעד המשמש לאחזור הלוגיקה של בידינג כאשר קהל מותאם אישית משתתף תהליך בחירת המודעות. |
AdTechIdentifier
|
getBuyer()
הקונה מזוהה על ידי דומיין בתבנית "buyerexample.com". |
Uri
|
getDailyUpdateUri()
ה-URI הזה מפנה לשרת שמופעל על ידי הקונה, שמארח מטא-נתונים מעודכנים של בידינג ונתוני מודעות מעודכנים שישמשו בתהליך בחירת המודעות במכשיר. |
Instant
|
getExpirationTime()
אחרי שמועד התפוגה עובר, קהל בהתאמה אישית לא עומד יותר בדרישות לקבלת דוחות בכל יום. עדכונים לגבי נתוני מודעות או בידינג, או השתתפות בתהליך בחירת המודעות. |
String
|
getName()
השם של הקהל בהתאמה אישית הוא מחרוזת שרירותית שמסופקת על ידי הבעלים והקונה בזמן היצירה
של האובייקט |
TrustedBiddingData
|
getTrustedBiddingData()
נתוני בידינג מהימנים מורכבים מ-URI שמפנה לשרת מהימן של הקונים נתוני בידינג ורשימת מפתחות לשליחת שאילתות לשרת. |
AdSelectionSignals
|
getUserBiddingSignals()
אותות לבידינג של משתמשים מסופקים על ידי הקונים כדי שהקונים יוכלו להשתמש בהם JavaScript במהלך בחירת המודעה בסביבת הפעלה מבודדת. |
int
|
hashCode()
מחזירה את הגיבוב של נתוני האובייקט |
void
|
writeToParcel(Parcel dest, int flags)
יש לשטח את האובייקט ל-Parcel |
שיטות שעברו בירושה | |
---|---|
שדות
CREATOR
public static final Creator<CustomAudience> CREATOR
שיטות ציבוריות
שווה ל-
public boolean equals (Object o)
הפונקציה בודקת אם שני אובייקטים מסוג CustomAudience
מכילים את אותו מידע.
פרמטרים | |
---|---|
o |
Object : אובייקט ההפניה שאליו תשוו. |
החזרות | |
---|---|
boolean |
true אם האובייקט הזה זהה ל-obj
ארגומנט; אחרת, false . |
getactivateTime
public Instant getActivationTime ()
כשיוצרים את האובייקט CustomAudience
, אפשר להגדיר זמן הפעלה אופציונלי
בעתיד, כדי להציג הפעלה מאוחרת. אם לא הוגדר שדה, CustomAudience
יופעל במועד ההצטרפות.
לדוגמה, ייתכן שקהל בהתאמה אישית למשתמשים שאינם פעילים לא יופעל עד לסף של חוסר פעילות, ובשלב זה המודעות של הקהל המותאם אישית ישתתפו במודעה תהליך בחירה, שעשוי להפנות משתמשים שאינם פעילים לאפליקציית הבעלים המקורית.
משך הזמן המקסימלי בהפעלה הוא 60 יום ממועד היצירה הראשונית.
אם צוין, זמן ההפעלה חייב להיות מיידי מוקדם יותר מזמן התפוגה.
החזרות | |
---|---|
Instant |
חותמת הזמן Instant , שנקצרה לאלפיות השנייה, שאחריה
הקהל פעיל
הערך הזה יכול להיות null . |
getAds
public List<AdData> getAds ()
הרשימה הזו של AdData
אובייקטים היא רשימה מלאה ומלאה של המודעות שיהיו
הוצגו על ידי CustomAudience
במהלך בחירת המודעה.
אם לא צוין אחרת, או אם תצוין רשימה ריקה, השדה CustomAudience
לא
להשתתף בבחירת מודעות עד שתספק רשימה חוקית של מודעות דרך העדכון היומי עבור
הקהל בהתאמה אישית.
החזרות | |
---|---|
List<AdData> |
List מתוך AdData אובייקטים שמייצגים מודעות שמוצגות כרגע על ידי
קהל בהתאמה אישית
הערך הזה לא יכול להיות null . |
getBiddingLogicUri
public Uri getBiddingLogicUri ()
פונקציה זו מחזירה את URI היעד המשמש לאחזור הלוגיקה של בידינג כאשר קהל מותאם אישית משתתף תהליך בחירת המודעות. ה-URI חייב להשתמש ב-HTTPS.
החזרות | |
---|---|
Uri |
ה-URI לאחזור לוגיקת הבידינג של הקונה
הערך הזה לא יכול להיות null . |
getBuyer
public AdTechIdentifier getBuyer ()
הקונה מזוהה על ידי דומיין בתבנית "buyerexample.com".
החזרות | |
---|---|
AdTechIdentifier |
AdTechIdentifier שמכיל את דומיין הקונה של הקהל המותאם אישית
הערך הזה לא יכול להיות null . |
getDailyUpdateUri
public Uri getDailyUpdateUri ()
ה-URI הזה מפנה לשרת שמופעל על ידי הקונה, שמארח מטא-נתונים מעודכנים של בידינג ונתוני מודעות מעודכנים שישמשו בתהליך בחירת המודעות במכשיר. ה-URI חייב להשתמש ב-HTTPS.
החזרות | |
---|---|
Uri |
ה-URI של העדכון היומי של הקהל בהתאמה אישית
הערך הזה לא יכול להיות null . |
getExpirationTime
public Instant getExpirationTime ()
אחרי שמועד התפוגה עובר, קהל בהתאמה אישית לא עומד יותר בדרישות לקבלת דוחות בכל יום. עדכונים לגבי נתוני מודעות או בידינג, או השתתפות בתהליך בחירת המודעות. הקהל בהתאמה אישית תימחק מהזיכרון עד לעדכון היומי הבא.
אם לא יצוין זמן תפוגה עם יצירת CustomAudience
, תפוגת התוקף
ברירת המחדל היא 60 ימים ממועד ההפעלה.
התוקף המקסימלי הוא 60 יום מההפעלה הראשונית.
החזרות | |
---|---|
Instant |
חותמת הזמן Instant , שנקצרה לאלפיות השנייה, שאחריה
צריך להסיר קהל
הערך הזה יכול להיות null . |
getName
public String getName ()
השם של הקהל בהתאמה אישית הוא מחרוזת שרירותית שמסופקת על ידי הבעלים והקונה בזמן היצירה
של האובייקט CustomAudience
.
החזרות | |
---|---|
String |
שם המחרוזת של הקהל בהתאמה אישית
הערך הזה לא יכול להיות null . |
getTrustBiddingData
public TrustedBiddingData getTrustedBiddingData ()
נתוני בידינג מהימנים מורכבים מ-URI שמפנה לשרת מהימן של הקונים נתוני בידינג ורשימת מפתחות לשליחת שאילתות לשרת. שימו לב שהמפתחות הם מזהים שרירותיים שישמש רק לשליחת שאילתות בשרת המהימן ללוגיקת הבידינג של הקונה במהלך הצגת המודעה בחירה.
אם לא מציינים זאת, CustomAudience
לא ישתתף בבחירת מודעות עד
נתוני בידינג מהימנים מסופקים דרך העדכון היומי עבור הקהל בהתאמה אישית.
החזרות | |
---|---|
TrustedBiddingData |
אובייקט TrustedBiddingData שמכיל את שיטת הבידינג המהימנה של הקהל המותאם אישית
רוחב פס
הערך הזה יכול להיות null . |
getUserBiddingSignals
public AdSelectionSignals getUserBiddingSignals ()
אותות לבידינג של משתמשים מסופקים על ידי הקונים כדי שהקונים יוכלו להשתמש בהם JavaScript במהלך בחירת המודעה בסביבת הפעלה מבודדת.
אם האותות בבידינג על ידי המשתמשים הם לא אובייקט JSON תקין שאפשר להשתמש בו על ידי JavaScript של הקונה, הקהל בהתאמה אישית לא יהיה כשיר לבחירת מודעה.
אם לא מציינים זאת, CustomAudience
לא ישתתף בבחירת מודעות עד
אותות לבידינג של משתמשים מסופקים דרך העדכון היומי של הקהל בהתאמה אישית.
החזרות | |
---|---|
AdSelectionSignals |
אובייקט AdSelectionSignals שמייצג את האותות לבידינג של משתמשים עבור
קהל בהתאמה אישית
הערך הזה יכול להיות null . |
קוד גיבוב (hashCode)
public int hashCode ()
מחזירה את הגיבוב של נתוני האובייקט CustomAudience
.
החזרות | |
---|---|
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 |