ReportEventRequest

public class ReportEventRequest
extends Object

java.lang.Object
android.adservices.adselection.ReportEventRequest


בקשה של אובייקט שעוטף את הארגומנטים הנדרשים לדיווח על אירוע מודעה.

סיכום

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

class ReportEventRequest.Builder

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

קבועים

int FLAG_REPORTING_DESTINATION_BUYER

int FLAG_REPORTING_DESTINATION_SELLER

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

long getAdSelectionId()

הפונקציה מחזירה את הפרמטר adSelectionId, המזהה הראשי של תהליך בחירת המודעה.

String getData()

מחזירה את הנתונים של אירועי המודעה.

InputEvent getInputEvent()

הפונקציה מחזירה את אירוע הקלט שמשויך לאינטראקציה של המשתמש.

String getKey()

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

int getReportingDestinations()

מחזירה את שדה הביטים של יעדי הדיווח שאליהם צריך לדווח (הקונה, בית העסק או שניהם).

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

קבועים

FLAG_REPORTING_DESTINATION_BUYER

public static final int FLAG_REPORTING_DESTINATION_BUYER

ערך קבוע: 2 (0x00000002)

FLAG_REPORTING_DESTINATION_SELLER

public static final int FLAG_REPORTING_DESTINATION_SELLER

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

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

getAdSelectionId

public long getAdSelectionId ()

הפונקציה מחזירה את הפרמטר adSelectionId, המזהה הראשי של תהליך בחירת המודעה.

החזרות
long

getData

public String getData ()

מחזירה את הנתונים של אירועי המודעה.

לאחר בחירת המודעה, הנתונים האלה נוצרים על ידי המתקשר. לאחר מכן, המתקשר יוכל להתקשר אל AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver). הנתונים האלה יצורפו בבקשת POST אל reportingUri שרשום ב-registerAdBeacon.

הגודל של String#getBytes() בפורמט UTF-8 צריך להיות קטן מ-64KB.

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

getInputEvent

public InputEvent getInputEvent ()

הפונקציה מחזירה את אירוע הקלט שמשויך לאינטראקציה של המשתמש.

השדה הזה הוא null, שמייצג אירוע view, או מכיל אובייקט InputEvent, שמייצג אירוע קליק.

החזרות
InputEvent

מקש getKey

public String getKey ()

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

השדה הזה ישמש לאחזור reportingUri המשויכים ל-eventKey שנרשמו ב-registerAdBeacon לאחר בחירת המודעה.

השדה הזה צריך להיות תואם במדויק לערך eventKey שרשום ב-registerAdBeacon. פרטים ספציפיים על registerAdBeacon זמינים ב תיעוד של AdSelectionManager#reportImpression

מפתח האירוע (כשבודקים את מערך הבייטים שלו באמצעות String#getBytes()) בפורמט UTF-8 לא יכול לחרוג מ-40 בייטים. כל מפתח שחורגים מהמגבלה הזו לא יירשם במהלך השיחה עם registerAdBeacon.

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

getReportingDestinations

public int getReportingDestinations ()

מחזירה את שדה הביטים של יעדי הדיווח שאליהם צריך לדווח (הקונה, בית העסק או שניהם).

כדי ליצור את שדה הביטים הזה, צריך להציב אופרטור ברמת הסיביות של | בין כל reportingDestination שרוצים לדווח עליו. לדוגמה, כדי לדווח רק לקונה, מגדירים את השדה ReportingDestinations אל FLAG_REPORTING_DESTINATION_BUYER לצורך דיווח רק ל- מפיץ, יש להגדיר את השדה ReportingDestinations לערך FLAG_REPORTING_DESTINATION_SELLER בתור לדווח גם לקונים וגם למוכרים, להגדיר את השדה ReportingDestinations (יעדים לדיווח) FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER

החזרות
int הערך הוא 0 או שילוב של FLAG_REPORTING_DESTINATION_SELLER ו-FLAG_REPORTING_DESTINATION_BUYER