คำขอรายงานเหตุการณ์
public
class
ReportEventRequest
extends Object
| java.lang.Object | |
| ↳ | android.adservices.adselection.ReportEventRequest |
ขอ Object ห่ออาร์กิวเมนต์ที่จำเป็นซึ่งจำเป็นต่อการรายงานเหตุการณ์โฆษณา
สรุป
ชั้นเรียนที่ซ้อนกัน | |
|---|---|
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 KB
| คิกรีเทิร์น | |
|---|---|
String |
ค่านี้ต้องไม่เป็น null |
getInputEvent
public InputEvent getInputEvent ()
แสดงผลเหตุการณ์อินพุตที่เชื่อมโยงกับการโต้ตอบของผู้ใช้
ช่องนี้เป็น null ซึ่งแสดงถึงเหตุการณ์ view หรือมีออบเจ็กต์ InputEvent ที่แสดงเหตุการณ์ click
| คิกรีเทิร์น | |
|---|---|
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 ()
แสดงผลบิตฟิลด์ของปลายทางการรายงานที่จะรายงาน (ผู้ซื้อ ผู้ขาย หรือทั้ง 2 อย่าง)
หากต้องการสร้างบิตฟิลด์นี้ ให้วางโอเปอเรเตอร์บิตไวส์ | ระหว่าง reportingDestination แต่ละรายการที่ต้องการรายงาน ตัวอย่างเช่น หากต้องการรายงานต่อผู้ซื้อเท่านั้น ให้ตั้งค่า
การรายงานปลายทางไปยัง 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 |