طلب حدث التقرير

public class ReportEventRequest
extends Object

java.lang.Object
↳	android.adservices.adselection.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()` تعرض حقل بت للوجهات لإعداد التقارير (المشتري أو البائع أو كليهما).

الطرق المكتسبة

من الصف


        
          java.lang.Object

`Object`	`clone()` تنشئ نسخة من هذا الكائن وتعرضها.
`boolean`	`equals(Object obj)` يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.
`void`	`finalize()` يتم استدعاء هذا الإجراء من قِبل خدمة تجميع البيانات المهملة على الكائن عند جمع البيانات المهملة. إلى عدم وجود مراجع أخرى للكائن.
`final Class<?>`	`getClass()` تعرض فئة بيئة التشغيل هذه لجهاز `Object`.
`int`	`hashCode()` تعرض قيمة رمز التجزئة للكائن.
`final void`	`notify()` تنشيط سلسلة محادثات واحدة بانتظار وصول هذا الكائن إلى البيانات الشاشة.
`final void`	`notifyAll()` لتنشيط جميع سلاسل المحادثات التي تنتظر شاشة هذا الكائن.
`String`	`toString()` تعرض تمثيلاً سلسلة للكائن.
`final void`	`wait(long timeoutMillis, int nanos)` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.
`final void`	`wait(long timeoutMillis)` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.
`final void`	`wait()` يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى عن طريق الإشعارات أو المقاطعة.

الثوابت

FLAG_REPORTING_ عبارات العامّة</b> / المشترين

تمت الإضافة في 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)

الطرق العامة

رقم تعريف getAdSelection

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public long getAdSelectionId ()

تعرض adSelectionId، وهو المعرّف الأساسي لعملية اختيار الإعلان.

المرتجعات
`long`

الحصول على البيانات

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public String getData ()

تعرِض بيانات حدث الإعلان.

بعد اختيار الإعلان، ينشئ المتصل هذه البيانات. ويمكن للمتصل بعد ذلك الاتصال برقم AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver). سيتم إرفاق هذه البيانات في طلب POST إلى reportingUri المسجَّل في registerAdBeacon.

يجب أن يكون حجم String#getBytes() بتنسيق UTF-8 أقل من 64 كيلوبايت.

المرتجعات
`String`	لا يمكن أن تكون هذه القيمة `null`.

الحصول على حدث

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public InputEvent getInputEvent ()

تعرِض هذه السمة حدث الإدخال المرتبط بتفاعل المستخدِم.

هذا الحقل إما null، ويمثّل حدث view، أو يحتوي على عنصر InputEvent يمثّل حدث click.

المرتجعات
`InputEvent`

الحصول على مفتاح

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public String getKey ()

يعرض مفتاح الحدث، وهو نوع حدث الإعلان المطلوب إعداد تقارير عنه.

سيتم استخدام هذا الحقل لجلب reportingUri المرتبط بـ eventKey المسجَّل في registerAdBeacon بعد اختيار الإعلان.

يجب أن يتطابق هذا الحقل تمامًا مع eventKey المسجَّل في registerAdBeacon. يمكن العثور على تفاصيل محددة حول registerAdBeacon في مستندات AdSelectionManager#reportImpression

يجب ألا يتجاوز مفتاح الحدث (عند فحص مصفوفة البايت الخاصة به باستخدام String#getBytes()) بتنسيق UTF-8 40 بايت. لن يتم تسجيل أي مفتاح يتجاوز هذا الحدّ أثناء مكالمة registerAdBeacon.

المرتجعات
`String`	لا يمكن أن تكون هذه القيمة `null`.

الحصول على الوجهات في التقارير

تمت الإضافة في Android UpsideDownCakePrivacySandbox

public int getReportingDestinations ()

تعرض حقل بت للوجهات لإعداد التقارير (المشتري أو البائع أو كليهما).

لإنشاء حقل البت هذا، ضَع عامل تشغيل على مستوى البت | بين كل reportingDestination ليتم الإبلاغ عنه. فعلى سبيل المثال، لتقديم تقرير إلى المشتري فقط، اضبط ReportingDestinations الحقل إلى FLAG_REPORTING_DESTINATION_BUYER لإعداد التقارير فقط إلى بائع، اضبط الحقل ReportingDestinations (الوجهات) على FLAG_REPORTING_DESTINATION_SELLER إلى تقرير إلى كل من المشترين والبائعين، اضبط حقل الوجهات لإعداد التقارير على FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER

المرتجعات
`int`	القيمة هي `0` أو مجموعة من `FLAG_REPORTING_DESTINATION_SELLER` و`FLAG_REPORTING_DESTINATION_BUYER`.