דף זה תורגם על ידי Cloud Translation API.

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

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

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

public final class CustomAudience
extends Object implements Parcelable

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

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

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

סיכום

מחלקות מקוננות
`class`	`CustomAudience.Builder` Builder ל-`CustomAudience` אובייקטים.

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

מהממשק 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<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

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

מהכיתה


        
          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<CustomAudience> CREATOR

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

שווה ל-

נוסף ברמת API 34

public boolean equals (Object o)

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

פרמטרים
`o`	`Object`: אובייקט ההפניה שאליו תשוו.

החזרות
`boolean`	`true` אם האובייקט הזה זהה ל-obj ארגומנט; אחרת, `false`.

getactivateTime

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

public Instant getActivationTime ()

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

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

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

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

החזרות
`Instant`	חותמת הזמן `Instant`, שנקצרה לאלפיות השנייה, שאחריה הקהל פעיל הערך הזה יכול להיות `null`.

getAds

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

public List<AdData> getAds ()

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

אם לא צוין אחרת, או אם תצוין רשימה ריקה, השדה CustomAudience לא להשתתף בבחירת מודעות עד שתספק רשימה חוקית של מודעות דרך העדכון היומי עבור הקהל בהתאמה אישית.

החזרות
`List<AdData>`	`List` מתוך `AdData` אובייקטים שמייצגים מודעות שמוצגות כרגע על ידי קהל בהתאמה אישית הערך הזה לא יכול להיות `null`.

getBiddingLogicUri

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

public Uri getBiddingLogicUri ()

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

החזרות
`Uri`	ה-URI לאחזור לוגיקת הבידינג של הקונה הערך הזה לא יכול להיות `null`.

getBuyer

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

public AdTechIdentifier getBuyer ()

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

החזרות
`AdTechIdentifier`	`AdTechIdentifier` שמכיל את דומיין הקונה של הקהל המותאם אישית הערך הזה לא יכול להיות `null`.

getDailyUpdateUri

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

public Uri getDailyUpdateUri ()

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

החזרות
`Uri`	ה-URI של העדכון היומי של הקהל בהתאמה אישית הערך הזה לא יכול להיות `null`.

getExpirationTime

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

public Instant getExpirationTime ()

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

אם לא יצוין זמן תפוגה עם יצירת CustomAudience, תפוגת התוקף ברירת המחדל היא 60 ימים ממועד ההפעלה.

התוקף המקסימלי הוא 60 יום מההפעלה הראשונית.

החזרות
`Instant`	חותמת הזמן `Instant`, שנקצרה לאלפיות השנייה, שאחריה צריך להסיר קהל הערך הזה יכול להיות `null`.

getName

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

public String getName ()

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

החזרות
`String`	שם המחרוזת של הקהל בהתאמה אישית הערך הזה לא יכול להיות `null`.

getTrustBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

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

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

החזרות
`TrustedBiddingData`	אובייקט `TrustedBiddingData` שמכיל את שיטת הבידינג המהימנה של הקהל המותאם אישית רוחב פס הערך הזה יכול להיות `null`.

getUserBiddingSignals

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

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