طلب الإبلاغ عن الحدث
public
class
ReportEventRequest
extends Object
java.lang.Object | |
↳ | android.adservices.adsselect.ReportEventRequest |
كائن طلب يشمل الوسيطات المطلوبة واللازمة للإبلاغ عن حدث إعلان.
ملخّص
الصفوف المتداخلة | |
---|---|
class |
ReportEventRequest.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 |
الحصول على البيانات
public String getData ()
تعرِض بيانات حدث الإعلان.
بعد اختيار الإعلان، يتولّى المتصل إنشاء هذه البيانات. ويمكن للمتصل بعد ذلك الاتصال برقم AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver)
. سيتم إرفاق هذه البيانات في طلب POST إلى reportingUri
المسجَّل في registerAdBeacon
.
يجب أن يكون حجم String#getBytes()
بتنسيق UTF-8
أقل من 64 كيلوبايت.
الركلات المردودة | |
---|---|
String |
لا يمكن أن تكون هذه القيمة null . |
getInputEvent
public InputEvent getInputEvent ()
تعرض حدث الإدخال المرتبط بتفاعل المستخدم.
هذا الحقل إما null
، ويمثّل حدث عرض، أو يتضمّن عنصر InputEvent
يمثّل حدث النقر.
الركلات المردودة | |
---|---|
InputEvent |
الحصول على مفتاح
public String getKey ()
يعرض مفتاح الحدث، وهو نوع حدث الإعلان المطلوب الإبلاغ عنه.
سيتم استخدام هذا الحقل لجلب reportingUri
المرتبط بـ eventKey
المسجَّل في registerAdBeacon
بعد اختيار الإعلان.
يجب أن يتطابق هذا الحقل تمامًا مع الحقل "eventKey
" المسجَّل في "registerAdBeacon
". يمكن الاطّلاع على تفاصيل محدّدة حول registerAdBeacon
في المستندات الخاصة بالموقع الإلكتروني AdSelectionManager#reportImpression
.
يجب ألا يتجاوز مفتاح الحدث (عند فحص مصفوفة البايت الخاصة به باستخدام String#getBytes()
) بتنسيق UTF-8
40 بايت. ولن يتم تسجيل أي مفتاح يتجاوز هذا الحدّ الأقصى
أثناء مكالمة registerAdBeacon
.
الركلات المردودة | |
---|---|
String |
لا يمكن أن تكون هذه القيمة null . |
الحصول على تقارير Destinations
public int getReportingDestinations ()
يتم عرض حقل البت لوجهات إعداد التقارير التي سيتم إعداد التقارير إليها (المشتري أو البائع أو كليهما).
لإنشاء حقل بت هذا، ضع عامل تشغيل |
على البت بين كل reportingDestination
ليتم إرسال التقرير إليه. على سبيل المثال، لإعداد تقارير إلى المشتري فقط، اضبط
حقل إعداد التقارير الوجهة على FLAG_REPORTING_DESTINATION_BUYER
لتقديم تقارير
للبائع فقط، اضبط حقل "الوجهات" إعداد التقارير على FLAG_REPORTING_DESTINATION_SELLER
.
ولإعداد تقارير لكل من المشترين والبائعين، اضبط حقل إعداد التقارير "الوجهات" على FLAG_REPORTING_DESTINATION_BUYER
| FLAG_REPORTING_DESTINATION_SELLER
الركلات المردودة | |
---|---|
int |
القيمة هي 0 أو مجموعة من FLAG_REPORTING_DESTINATION_SELLER وFLAG_REPORTING_DESTINATION_BUYER . |