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

public class CustomAudienceManager
extends Object

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

CustomAudienceManager מספק ממשקי API לערכות SDK של אפליקציות וערכות SDK של מודעות כדי לצרף או לצאת קהלים בהתאמה אישית.

סיכום

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

void fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

הוספת המשתמש אל CustomAudience שאוחזר מ-fetchUri.

static CustomAudienceManager get(Context context)

שיטת היצרן ליצירת מכונה של CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager()

יצירת שירות עם ממשקי API להפעלת בדיקות

void joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

הפונקציה מוסיפה את המשתמש ל-CustomAudience הנתון.

void leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

ניסיון להסיר משתמש מקהל בהתאמה אישית על ידי מחיקת כל הנתונים הקיימים של CustomAudience, שמזוהים על ידי ownerPackageName, buyer ו-name.

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

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

אחזור והצטרפותמותאם אישית

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

הוספת המשתמש אל CustomAudience שאוחזר מ-fetchUri.

ניסיון לרשום את המשתמש לקהל בהתאמה אישית עם אותו השילוב של ownerPackageName, buyer ו-name יגרום מידע שיוחלף, כולל רשימה של נתוני מודעות.

לתשומת ליבכם: אפשר להחליף לחלוטין את רשימת המודעות על ידי משימת האחזור היומית ברקע.

השיחה הזו תיכשל עם SecurityException אם

  1. ownerPackageName לא קורא לשם החבילה של האפליקציה ו/או
  2. הקונה אינו מורשה להשתמש בממשק ה-API.

השיחה הזו תיכשל עם IllegalArgumentException אם

  1. חרגת ממגבלת האחסון על ידי אפליקציית הקריאה ו/או
  2. פרמטרים של URI ב-CustomAudience הנתון לא מאומתים באמצעות קונה CustomAudience.

השיחה תיכשל עם LimitExceededException אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

הקריאה הזו תיכשל עם IllegalStateException אם אירעה שגיאה פנימית בשירות המערכת נתקלה בבעיה.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

פרמטרים
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest: הערך הזה לא יכול להיות null.
executor Executor: הערך הזה לא יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
receiver OutcomeReceiver: הערך הזה לא יכול להיות null.

מקבלים

public static CustomAudienceManager get (Context context)

שיטת היצרן ליצירת מכונה של CustomAudienceManager.

פרמטרים
context Context: Context לשימוש הערך הזה לא יכול להיות null.
החזרות
CustomAudienceManager מופע של CustomAudienceManager הערך הזה לא יכול להיות null.

getTestCustomAudienceManager

public TestCustomAudienceManager getTestCustomAudienceManager ()

יצירת שירות עם ממשקי API להפעלת בדיקות

החזרות
TestCustomAudienceManager הערך הזה לא יכול להיות null.

הצטרפות לקהל בהתאמה אישית

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

הפונקציה מוסיפה את המשתמש ל-CustomAudience הנתון.

ניסיון לרשום את המשתמש לקהל בהתאמה אישית עם אותו השילוב של ownerPackageName, buyer ו-name יגרום מידע שיוחלף, כולל רשימה של נתוני מודעות.

לתשומת ליבכם: אפשר להחליף לחלוטין את רשימת המודעות על ידי משימת האחזור היומית ברקע.

השיחה הזו תיכשל עם SecurityException אם

  1. ownerPackageName לא קורא לשם החבילה של האפליקציה ו/או
  2. הקונה אינו מורשה להשתמש בממשק ה-API.

השיחה הזו תיכשל עם IllegalArgumentException אם

  1. חרגת ממגבלת האחסון על ידי אפליקציית הקריאה ו/או
  2. פרמטרים של URI ב-CustomAudience הנתון לא מאומתים באמצעות קונה CustomAudience.

השיחה תיכשל עם LimitExceededException אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

הקריאה הזו תיכשל עם IllegalStateException אם אירעה שגיאה פנימית בשירות המערכת נתקלה בבעיה.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

פרמטרים
joinCustomAudienceRequest JoinCustomAudienceRequest: הערך הזה לא יכול להיות null.
executor Executor: הערך הזה לא יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
receiver OutcomeReceiver: הערך הזה לא יכול להיות null.

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

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

ניסיון להסיר משתמש מקהל בהתאמה אישית על ידי מחיקת כל הנתונים הקיימים של CustomAudience, שמזוהים על ידי ownerPackageName, buyer ו-name.

השיחה הזו תיכשל עם SecurityException אם

  1. ownerPackageName לא קורא לשם החבילה של האפליקציה. ו/או
  2. הקונה אינו מורשה להשתמש בממשק ה-API.

השיחה תיכשל עם LimitExceededException אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

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

פרמטרים
leaveCustomAudienceRequest LeaveCustomAudienceRequest: הערך הזה לא יכול להיות null.
executor Executor: הערך הזה לא יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
receiver OutcomeReceiver: הערך הזה לא יכול להיות null.