קהל בהתאמה אישית

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
android.adservices.customaudience.CustomAudience


מייצג את המידע שדרוש לקהל בהתאמה אישית לצורך השתתפות בבחירת מודעות.

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

סיכום

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

class CustomAudience.Builder

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

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

שדות

public static final Creator<CustomAudience> CREATOR

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

boolean equals(Object o)

הפונקציה בודקת אם שני אובייקטים מסוג CustomAudience מכילים את אותו מידע.

Instant getActivationTime()

כשיוצרים את האובייקט CustomAudience, אפשר להגדיר זמן הפעלה אופציונלי בעתיד, כדי להציג הפעלה מאוחרת.

List<AdData> getAds()

הרשימה הזו של AdData אובייקטים היא רשימה מלאה ומלאה של המודעות שיהיו הוצגו על ידי CustomAudience במהלך בחירת המודעה.

Uri getBiddingLogicUri()

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

AdTechIdentifier getBuyer()

הקונה מזוהה על ידי דומיין בתבנית "buyerexample.com".

Uri getDailyUpdateUri()

ה-URI הזה מפנה לשרת שמופעל על ידי הקונה, שמארח מטא-נתונים מעודכנים של בידינג ונתוני מודעות מעודכנים שישמשו בתהליך בחירת המודעות במכשיר.

Instant getExpirationTime()

אחרי שמועד התפוגה עובר, קהל בהתאמה אישית לא עומד יותר בדרישות לקבלת דוחות בכל יום. עדכונים לגבי נתוני מודעות או בידינג, או השתתפות בתהליך בחירת המודעות.

String getName()

השם של הקהל בהתאמה אישית הוא מחרוזת שרירותית שמסופקת על ידי הבעלים והקונה בזמן היצירה של האובייקט CustomAudience.

TrustedBiddingData getTrustedBiddingData()

נתוני בידינג מהימנים מורכבים מ-URI שמפנה לשרת מהימן של הקונים נתוני בידינג ורשימת מפתחות לשליחת שאילתות לשרת.

AdSelectionSignals getUserBiddingSignals()

אותות לבידינג של משתמשים מסופקים על ידי הקונים כדי שהקונים יוכלו להשתמש בהם JavaScript במהלך בחירת המודעה בסביבת הפעלה מבודדת.

int hashCode()

מחזירה את הגיבוב של נתוני האובייקט CustomAudience.

void writeToParcel(Parcel dest, int flags)

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

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

שדות

CREATOR

public static final Creator<CustomAudience> CREATOR

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

שווה ל-

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

נוסף ברמת API 34
public int hashCode ()

מחזירה את הגיבוב של נתוני האובייקט CustomAudience.

החזרות
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