คำขอรายงานเหตุการณ์
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 |