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

Hằng số

FLAG_REPORTING_DESTINATION_BUYER

public static final int FLAG_REPORTING_DESTINATION_BUYER

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

FLAG_REPORTING_DESTINATION_SELLER

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_SELLERFLAG_REPORTING_DESTINATION_BUYER