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

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

int CONTENTS_FILE_DESCRIPTOR

Bit mô tả được dùng với describeContents(): cho biết cách biểu diễn được làm phẳng của đối tượng Parcelable bao gồm cả chỉ số mô tả tệp.

int PARCELABLE_WRITE_RETURN_VALUE

Gắn cờ để sử dụng với writeToParcel(Parcel, int): đối tượng đang được viết là một giá trị trả về. Đây là kết quả của các hàm như "Parcelable someFunction()", "void someFunction(out Parcelable)", hoặc "void someFunction(inout Parcelable)".

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 được sử 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 của dữ liệu đố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

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 chờ 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.

abstract int describeContents()

Mô tả các loại đối tượng đặc biệt có trong bản trình bày tổng hợp của thực thể Parcelable này.

abstract void writeToParcel(Parcel dest, int flags)

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

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