طلب الإبلاغ عن الحدث

public class ReportEventRequest
extends Object

java.lang.Object
↳ android.adservices.adsselect.ReportEventRequest

كائن طلب يشمل الوسيطات المطلوبة واللازمة للإبلاغ عن حدث إعلان.

ملخّص

الصفوف المتداخلة

class ReportEventRequest.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

مضاف في Android UpsideDownCakePrivacySandbox 
public static final int FLAG_REPORTING_DESTINATION_BUYER

القيمة الثابتة: 2 (0x00000002)

FLAG_REPORTING_destination_seller

مضاف في Android UpsideDownCakePrivacySandbox 
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.