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 |
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_SELLER và FLAG_REPORTING_DESTINATION_BUYER |