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

סיכום: קבועים | שיטות | שיטות שעברו בירושה

MeasurementManager

public class MeasurementManager
extends Object

java.lang.Object
↳	android.adservices.measurement.MeasurementManager

---

MeasurementManager מספק ממשקי API לניהול רישומי מקור ולהפעלת הרשמות.

סיכום

קבועים
int	MEASUREMENT_API_STATE_DISABLED המצב הזה מציין שממשקי ה-API למדידה לא זמינים.
int	MEASUREMENT_API_STATE_ENABLED המצב הזה מציין שממשקי ה-API למדידה מופעלים.

שיטות ציבוריות
void	deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback) מחיקת הרשמות קודמות.
static MeasurementManager	get(Context context) שיטת היצרן ליצירת מכונה של MeasurementManager.
void	getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback) קבלת הסטטוס של Measurement API.
void	registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback) רישום מקור ייחוס (לחיצה או צפייה).
void	registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback) רישום מקורות שיוך(קליק או צפייה) מהקשר של אפליקציה.
void	registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback) רושמים טריגר (המרה).
void	registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback) רישום מקור שיוך(קליק או צפייה) מהקשר באינטרנט.
void	registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback) רישום טריגר שיוך (Attribution) (קליק או צפייה) מהקשר באינטרנט.

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

מהכיתה 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() גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.

קבועים

MEASUREMENT_API_STATE_DISABLED

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

public static final int MEASUREMENT_API_STATE_DISABLED

המצב הזה מציין שממשקי ה-API למדידה לא זמינים. הפעלתן תוביל UnsupportedOperationException

ערך קבוע: 0 (0x00000000)

MEASUREMENT_API_STATE_enabled

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

public static final int MEASUREMENT_API_STATE_ENABLED

המצב הזה מציין שממשקי ה-API למדידה מופעלים.

ערך קבוע: 1 (0x00000001)

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

מחיקת רישומים

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

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

מחיקת הרשמות קודמות. אם המחיקה תסתיים בהצלחה, הערך OutcomeReceiver.onResult(R) של הקריאה החוזרת יופעל עם הערך null. במקרה של כשל, Exception הוא נשלח דרך OutcomeReceiver#onError של הקריאה החוזרת. הצלחה וגם כישלון המשוב יבוצע בExecutor שסופק.

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

מקבלים

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

public static MeasurementManager get (Context context)

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

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

החזרות
MeasurementManager	מופע של MeasurementManager הערך הזה לא יכול להיות null.

getMeasurementApiStatus

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

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

קבלת הסטטוס של Measurement API.

הערך Integer של הקריאה החוזרת הוא אחד מהערכים MeasurementApiState.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

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

רישום מקור

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

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

רישום מקור ייחוס (לחיצה או צפייה).
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

פרמטרים
attributionSource	Uri: הפלטפורמה מנפיקה בקשה ל-URI הזה כדי לאחזר מטא-נתונים המשויך למקור השיוך. המטא-נתונים של המקור מאוחסנים במכשיר, כך יכול להתאים אותו לטריגרים עתידיים. הערך הזה לא יכול להיות null.
inputEvent	InputEvent: אובייקט InputEvent (לאירוע מסוג קליק) או ערך null (לתצוגה מפורטת) אירוע).
executor	Executor: משמש את הקריאה החוזרת (callback) לשליחת תוצאות. הערך הזה יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
callback	OutcomeReceiver: מיועד להודיע באופן אסינכרוני על תוצאת ה-API. הערך הזה יכול להיות null.

קליעות
IllegalArgumentException	אם הסכימה של attributionSource היא לא HTTPS

רישום מקור

נוסף ב-Android UpsideDownCakePrivacySandbox
זמין גם בתוספים 4 לשירותי מודעות

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

רישום מקורות שיוך(קליק או צפייה) מהקשר של אפליקציה. ה-API הזה לא יעובד כל כתובות האתרים להפניה מחדש, יש לספק את כל כתובות האתרים לרישום.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

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

רישום טריגר

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

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

רושמים טריגר (המרה).
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

פרמטרים
trigger	Uri: ה-API מנפיק בקשה ל-URI הזה לאחזור מטא-נתונים שמשויכים אל על הטריגר. המטא-נתונים של הטריגר מאוחסנים במכשיר ואפשר להתאים אותם מקורות בתהליך השיוך. הערך הזה לא יכול להיות null.
executor	Executor: משמש את הקריאה החוזרת (callback) לשליחת תוצאות. הערך הזה יכול להיות null. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות Executor, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש Context.getMainExecutor() אם לא, צריך לציין Executor ששולח לשרשור מתאים.
callback	OutcomeReceiver: מיועד להודיע באופן אסינכרוני על תוצאת ה-API. הערך הזה יכול להיות null.

קליעות
IllegalArgumentException	אם הסכימה של trigger היא לא HTTPS

רישום WebSource

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

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

רישום מקור שיוך(קליק או צפייה) מהקשר באינטרנט. ה-API הזה לא יעבד לכתובות אתר אחרות, יש לספק את כל כתובות האתרים לרישום. לפחות אחד מ- יש לספק פרמטרים של appDestination או webDestination. אם הרישום הפעולה בוצעה בהצלחה, OutcomeReceiver#onResult של callback הופעל עם null. לחשבון במקרה של כשל, Exception נשלח דרך OutcomeReceiver.onError(E) של callback. גם משוב על הצלחה וגם משוב על כשלים מתבצעים Executor
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

פרמטרים
request	WebSourceRegistrationRequest: בקשה לרישום מקור הערך הזה לא יכול להיות null.
executor	Executor: משמש את הקריאה החוזרת (callback) לשליחת תוצאות. הערך הזה יכול להיות null.
callback	OutcomeReceiver: מיועד להודיע באופן אסינכרוני על תוצאת ה-API. הערך הזה יכול להיות null.

רישום WebTrigger

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

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

רישום טריגר שיוך (Attribution) (קליק או צפייה) מהקשר באינטרנט. ה-API הזה לא יעובד כל כתובות האתרים להפניה מחדש, יש לספק את כל כתובות האתרים לרישום. אם הרישום הפעולה בוצעה בהצלחה, OutcomeReceiver#onResult של callback הופעל עם null. לחשבון במקרה של כשל, Exception נשלח דרך OutcomeReceiver.onError(E) של callback. גם משוב על הצלחה וגם משוב על כשלים מתבצעים Executor
נדרש AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

פרמטרים
request	WebTriggerRegistrationRequest: הפעלה של בקשת הרשמה הערך הזה לא יכול להיות null.
executor	Executor: משמש את הקריאה החוזרת לשליחת תוצאות הערך הזה יכול להיות null.
callback	OutcomeReceiver: מיועד להודיע באופן אסינכרוני על תוצאת ה-API הערך הזה יכול להיות null.