ReportEventRequest
public
class
ReportEventRequest
extends Object
java.lang.Object | |
↳ | android.adservices.adselection.ReportEventRequest |
בקשה של אובייקט שעוטף את הארגומנטים הנדרשים לדיווח על אירוע מודעה.
סיכום
מחלקות מקוננות | |
---|---|
class |
ReportEventRequest.Builder
Builder ל- |
קבועים | |
---|---|
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 |