Yêu cầu sự kiện báo cáo

public class ReportEventRequest
extends Object

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

Yêu cầu đối tượng gói các đối số bắt buộc cần có để báo cáo một sự kiện quảng cáo.

Tóm tắt

Lớp lồng ghép

class ReportEventRequest.Builder

Trình tạo cho các đối tượng ReportEventRequest. 

Hằng số

int FLAG_REPORTING_DESTINATION_BUYER

int FLAG_REPORTING_DESTINATION_SELLER

Phương thức công khai

long getAdSelectionId()

Trả về adSelectionId, giá trị nhận dạng chính của quy trình lựa chọn quảng cáo.

String getData()

Trả về dữ liệu sự kiện quảng cáo.

InputEvent getInputEvent()

Trả về sự kiện đầu vào liên quan đến hoạt động tương tác của người dùng.

String getKey()

Trả về khoá sự kiện, loại sự kiện quảng cáo cần báo cáo.

int getReportingDestinations()

Trả về trường bit của đích sẽ nhận báo cáo (người mua, người bán hoặc cả hai).

Phương thức kế thừa

Object clone()

Tạo và trả về một bản sao của đối tượng này.

boolean equals(Object obj)

Cho biết liệu một đối tượng nào đó khác có "bằng" đối tượng này hay không.

void finalize()

Được trình thu gom rác gọi trên một đối tượng khi tính năng thu thập rác xác định rằng không có tham chiếu nào khác đến đối tượng.

final Class<?> getClass()

Trả về lớp thời gian chạy của Object này.

int hashCode()

Trả về một giá trị mã băm cho đối tượng.

final void notify()

Đánh thức một luồng duy nhất đang chờ trên màn hình của đối tượng này.

final void notifyAll()

Đánh thức tất cả các luồng đang chờ trên màn hình của đối tượng này.

String toString()

Trả về một chuỗi đại diện của đối tượng.

final void wait(long timeoutMillis, int nanos)

Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua.

final void wait(long timeoutMillis)

Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua.

final void wait()

Yêu cầu luồng hiện tại phải đợi cho đến khi được đánh thức, thường là bằng cách thông báo hoặc gây gián đoạn.

Hằng số

FLAG_REPORTING_DESTINATION_BUYER

Đã thêm vào UpsideDownCakePrivacySandbox của Android 
public static final int FLAG_REPORTING_DESTINATION_BUYER

Giá trị không đổi: 2 (0x00000002)

FLAG_REPORTING_DESTINATION_SELLER

Đã thêm vào UpsideDownCakePrivacySandbox của Android 
public static final int FLAG_REPORTING_DESTINATION_SELLER

Giá trị không đổi: 1 (0x00000001)

Phương thức công khai

getAdSelectionId

public long getAdSelectionId ()

Trả về adSelectionId, giá trị nhận dạng chính của quy trình lựa chọn quảng cáo.

Giá trị trả về
long

getData

public String getData ()

Trả về dữ liệu sự kiện quảng cáo.

Sau khi lựa chọn quảng cáo, dữ liệu này sẽ được tạo bởi phương thức gọi. Sau đó, phương thức gọi có thể gọi cho AdSelectionManager.reportEvent(ReportEventRequest, Executor, OutcomeReceiver). Dữ liệu này sẽ được đính kèm trong yêu cầu POST vào reportingUri đã đăng ký trong registerAdBeacon.

Kích thước của String#getBytes() ở định dạng UTF-8 phải dưới 64KB.

Giá trị trả về
String Giá trị này không được là null.

getInputEvent

public InputEvent getInputEvent ()

Trả về sự kiện đầu vào liên quan đến hoạt động tương tác của người dùng.

Trường này là null, đại diện cho sự kiện xem hoặc có đối tượng InputEvent, đại diện cho sự kiện lượt nhấp.

Giá trị trả về
InputEvent

lấy khoá

public String getKey ()

Trả về khoá sự kiện, loại sự kiện quảng cáo cần báo cáo.

Trường này sẽ được dùng để tìm nạp reportingUri liên kết với eventKey đã đăng ký trong registerAdBeacon sau khi lựa chọn quảng cáo.

Trường này phải hoàn toàn khớp với eventKey đã đăng ký trong registerAdBeacon. Bạn có thể xem thông tin cụ thể về registerAdBeacon tại tài liệu về AdSelectionManager#reportImpression

Khoá sự kiện (khi kiểm tra mảng byte bằng String#getBytes()) ở định dạng UTF-8 không được vượt quá 40 byte. Mọi khoá vượt quá hạn mức này sẽ không được đăng ký trong cuộc gọi registerAdBeacon.

Giá trị trả về
String Giá trị này không được là null.

getReportingDestinations

public int getReportingDestinations ()

Trả về trường bit của đích sẽ nhận báo cáo (người mua, người bán hoặc cả hai).

Để tạo trường bit này, hãy đặt toán tử bitwise | giữa mỗi reportingDestination sẽ nhận báo cáo. Ví dụ: để chỉ báo cáo cho người mua, hãy đặt trường ReportingDestinations đến FLAG_REPORTING_DESTINATION_BUYER Để chỉ báo cáo cho người bán, đặt trường reportingDestinations thành FLAG_REPORTING_DESTINATION_SELLER để báo cáo cho cả người mua và người bán, hãy đặt trường reportingDestinations thành FLAG_REPORTING_DESTINATION_BUYER | FLAG_REPORTING_DESTINATION_SELLER

Giá trị trả về
int Giá trị là 0 hoặc tổ hợp FLAG_REPORTING_DESTINATION_SELLER và FLAG_REPORTING_DESTINATION_BUYER