คำขอรายงานเหตุการณ์

public class ReportEventRequest
extends Object

java.lang.Object
android.adservices.adselection.ReportEventRequest


ขอ Object ห่ออาร์กิวเมนต์ที่จำเป็นซึ่งจำเป็นต่อการรายงานเหตุการณ์โฆษณา

สรุป

ชั้นเรียนที่ซ้อนกัน

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

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