AdData

public final class AdData
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.common.AdData


Hiển thị dữ liệu cụ thể cho một quảng cáo cần thiết cho việc lựa chọn và hiển thị quảng cáo.

Tóm tắt

Các lớp lồng ghép

class AdData.Builder

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

Hằng số kế thừa

Các trường

public static final Creator<AdData> CREATOR

Phương thức công khai

boolean equals(Object o)

Kiểm tra xem 2 đối tượng AdData có chứa thông tin giống nhau hay không.

Set<Integer> getAdCounterKeys()

Lấy tập hợp các khoá dùng để đếm sự kiện.

AdFilters getAdFilters()

Lấy tất cả AdFilters được liên kết với quảng cáo.

String getAdRenderId()

Lấy mã nhận dạng hiển thị quảng cáo cho các phiên đấu giá phía máy chủ.

String getMetadata()

Lấy siêu dữ liệu quảng cáo của người mua dùng trong quá trình lựa chọn quảng cáo.

Uri getRenderUri()

Lấy URI trỏ đến thành phần hiển thị của quảng cáo.

int hashCode()

Trả về hàm băm cho dữ liệu của đối tượng AdData.

String toString()

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

void writeToParcel(Parcel dest, int flags)

Làm phẳng đối tượng này thành một Gói (Parcel).

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

Trường

CREATOR

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public static final Creator<AdData> CREATOR

Phương thức công khai

equals

Đã thêm vào API cấp 34
public boolean equals (Object o)

Kiểm tra xem 2 đối tượng AdData có chứa thông tin giống nhau hay không.

Tham số
o Object: đối tượng tham chiếu cần so sánh.

Giá trị trả về
boolean true nếu đối tượng này giống với đối số obj; nếu không thì false.

getAdCounterKeys

public Set<Integer> getAdCounterKeys ()

Lấy tập hợp các khoá dùng để đếm sự kiện.

Bạn chỉ có thể liên kết tối đa 10 khoá bộ đếm quảng cáo với một quảng cáo.

Các khoá và số lượng trên mỗi khoá được dùng trong tính năng lọc giới hạn tần suất trong quá trình lựa chọn quảng cáo để loại những quảng cáo được liên kết khỏi quá trình đặt giá thầu.

Lưu ý rằng bạn có thể ghi đè các khoá này cùng với các quảng cáo và dữ liệu đặt giá thầu khác cho một đối tượng tuỳ chỉnh trong quá trình cập nhật hằng ngày của đối tượng tuỳ chỉnh đó.

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

getAdFilters

public AdFilters getAdFilters ()

Lấy tất cả AdFilters được liên kết với quảng cáo.

Nếu đáp ứng hoặc vượt quá, các bộ lọc sẽ ngăn quảng cáo được liên kết tham gia vào quá trình lựa chọn quảng cáo. Đây là các tham số không bắt buộc và nếu giá trị là null thì nghĩa là không có bộ lọc nào áp dụng cho quảng cáo này.

Giá trị trả về
AdFilters

getAdRenderId

public String getAdRenderId ()

Lấy mã nhận dạng hiển thị quảng cáo cho các phiên đấu giá phía máy chủ.

Mã nhận dạng hiển thị quảng cáo sẽ được thu thập cho mỗi AdData khi yêu cầu đấu giá phía máy chủ được nhận.

Mọi AdData không có mã nhận dạng hiển thị quảng cáo sẽ không đủ điều kiện tham gia phiên đấu giá phía máy chủ.

Giá trị trả về
String Giá trị này có thể là null.

getMetadata

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public String getMetadata ()

Lấy siêu dữ liệu quảng cáo của người mua dùng trong quá trình lựa chọn quảng cáo.

Siêu dữ liệu phải là một đối tượng JSON hợp lệ được chuyển đổi tuần tự dưới dạng một chuỗi. Siêu dữ liệu thể hiện thông tin đặt giá thầu cho từng quảng cáo sẽ được dùng trong quá trình lựa chọn quảng cáo khi tạo giá thầu và được dùng trong logic JavaScript của người mua (logic này được thực thi trong một môi trường riêng biệt).

Nếu siêu dữ liệu không phải là đối tượng JSON hợp lệ mà JS của người mua có thể tiêu thụ, thì quảng cáo đó sẽ không đủ điều kiện để lựa chọn quảng cáo.

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

getRenderUri

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public Uri getRenderUri ()

Lấy URI trỏ đến thành phần hiển thị của quảng cáo. URI phải dùng HTTPS.

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

hashCode

Đã thêm vào API cấp 34
public int hashCode ()

Trả về hàm băm của dữ liệu đối tượng AdData.

Giá trị trả về
int một giá trị mã băm cho đối tượng này.

toString

Đã thêm vào API cấp 34
public String toString ()

Trả về một chuỗi đại diện của đối tượng. Nhìn chung, phương thức toString sẽ trả về một chuỗi "đại diện bằng văn bản" cho đối tượng này. Kết quả trình bày phải ngắn gọn nhưng đầy đủ thông tin để người đọc dễ đọc. Tất cả các lớp con đều nên ghi đè phương thức này.

Phương thức toString dành cho lớp Object trả về một chuỗi bao gồm tên của lớp mà trong đó đối tượng là một thực thể, ký tự ký hiệu '@' và giá trị biểu thị mã băm của đối tượng ở dạng thập lục phân chưa ký. Nói cách khác, phương thức này sẽ trả về một chuỗi bằng giá trị của:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Giá trị trả về
String một giá trị biểu thị đối tượng ở dạng chuỗi.

writeToParcel

Đã thêm vào API cấp 34
public void writeToParcel (Parcel dest,
                int flags)

Làm phẳng đối tượng này thành một Gói (Parcel).

Tham số
dest Parcel: Giá trị này không được là null.

flags int: Cờ bổ sung về cách viết đối tượng. Có thể là 0 hoặc Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Giá trị có thể là 0 hoặc tổ hợp Parcelable.PARCELABLE_WRITE_RETURN_VALUE và android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES