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

Tóm tắt: Lớp lồng ghép | Hằng số kế thừa | Trường | Phương thức | Phương thức kế thừa

CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.customaudience.CustomAudience

---

Biểu thị các thông tin cần thiết để một đối tượng tuỳ chỉnh tham gia vào quá trình lựa chọn quảng cáo.

Đối tượng tuỳ chỉnh là một nhóm trừu tượng gồm những người dùng có mối quan tâm tương tự nhau. Lớp này gồm một số dữ liệu cần thiết được lưu trữ trên thiết bị để phân phát quảng cáo nhắm mục tiêu đến một đối tượng tuỳ chỉnh.

Tóm tắt

Lớp lồng ghép
class	CustomAudience.Builder Trình tạo cho các đối tượng CustomAudience.

Hằng số kế thừa

Từ giao diện android.os.Parcelable 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<CustomAudience>	CREATOR

Phương thức công khai
boolean	equals(Object o) Kiểm tra xem 2 đối tượng CustomAudience có chứa thông tin giống nhau hay không.
Instant	getActivationTime() Khi tạo đối tượng CustomAudience, bạn có thể tuỳ ý đặt thời gian kích hoạt trong tương lai để phân phát một yêu cầu kích hoạt bị trì hoãn.
List<AdData>	getAds() Danh sách đối tượng AdData này là một danh sách hoàn thiện và đầy đủ gồm các quảng cáo sẽ được CustomAudience này phân phát trong quá trình lựa chọn quảng cáo.
Uri	getBiddingLogicUri() Trả về URI mục tiêu dùng để tìm nạp logic đặt giá thầu khi một đối tượng tuỳ chỉnh tham gia vào quá trình lựa chọn quảng cáo.
AdTechIdentifier	getBuyer() Người mua được xác định bởi một tên miền có dạng "buyerexample.com".
Uri	getDailyUpdateUri() URI này trỏ đến một máy chủ do người mua điều hành, tại đây có lưu trữ dữ liệu đặt giá thầu được cập nhật và siêu dữ liệu quảng cáo được dùng trong quá trình lựa chọn quảng cáo trên thiết bị.
Instant	getExpirationTime() Khi thời gian hết hạn đã trôi qua, đối tượng tuỳ chỉnh sẽ không còn đủ điều kiện để cập nhật dữ liệu về quảng cáo/đặt giá thầu hằng ngày hoặc tham gia vào quá trình lựa chọn quảng cáo.
String	getName() Tên của đối tượng tuỳ chỉnh là một chuỗi tuỳ ý do chủ sở hữu và người mua cung cấp khi tạo đối tượng CustomAudience.
TrustedBiddingData	getTrustedBiddingData() Dữ liệu đặt giá thầu đáng tin cậy bao gồm URI trỏ đến máy chủ đáng tin cậy cho dữ liệu đặt giá thầu của người mua và danh sách các khoá để truy vấn máy chủ.
AdSelectionSignals	getUserBiddingSignals() Tín hiệu đặt giá thầu của người dùng do người mua tuỳ ý cung cấp sẽ được JavaScript mà người mua cung cấp sử dụng trong quá trình lựa chọn quảng cáo trong một môi trường thực thi riêng biệt.
int	hashCode() Trả về hàm băm của dữ liệu đối tượng CustomAudience.
void	writeToParcel(Parcel dest, int flags) Làm phẳng đối tượng này trong Gói.

Phương thức kế thừa
Trong lớp java.lang.Object 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.
Trong giao diện android.os.Parcelable 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<CustomAudience> 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 CustomAudience 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.

getActivationTime

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

public Instant getActivationTime ()

Khi tạo đối tượng CustomAudience, bạn có thể tuỳ ý đặt thời gian kích hoạt trong tương lai để phân phát một yêu cầu kích hoạt bị trì hoãn. Nếu bạn không đặt trường này, CustomAudience sẽ được kích hoạt tại thời điểm tham gia.

Ví dụ: đối tượng tuỳ chỉnh dành cho người dùng cũ sẽ không thể kích hoạt cho đến khi đạt đến ngưỡng không hoạt động. Tại thời điểm đó, quảng cáo của đối tượng tuỳ chỉnh sẽ tham gia vào quá trình lựa chọn quảng cáo, có khả năng chuyển hướng người dùng cũ đến ứng dụng của chủ sở hữu ban đầu.

Độ trễ tối đa khi kích hoạt là 60 ngày kể từ lần tạo đầu tiên.

Nếu được chỉ định, thời gian kích hoạt phải sớm hơn thời gian hết hạn.

Giá trị trả về
Instant	dấu thời gian Instant, được cắt ngắn thành mili giây, sau đó giá trị tuỳ chỉnh đối tượng đang hoạt động Giá trị này có thể là null.

getAds

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

public List<AdData> getAds ()

Danh sách đối tượng AdData này là một danh sách hoàn thiện và đầy đủ gồm các quảng cáo sẽ được CustomAudience này phân phát trong quá trình lựa chọn quảng cáo.

Nếu bạn không chỉ định hoặc cung cấp danh sách trống, thì CustomAudience sẽ không tham gia vào quá trình lựa chọn quảng cáo cho đến khi bạn cung cấp danh sách quảng cáo hợp lệ thông qua quá trình cập nhật hằng ngày cho đối tượng tuỳ chỉnh.

Giá trị trả về
List<AdData>	List đối tượng AdData đại diện cho quảng cáo hiện được phân phát bởi đối tượng tuỳ chỉnh Giá trị này không được là null.

getBiddingLogicUri

Đã 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 getBiddingLogicUri ()

Trả về URI mục tiêu dùng để tìm nạp logic đặt giá thầu khi một đối tượng tuỳ chỉnh tham gia vào quá trình lựa chọn quảng cáo. URI phải dùng HTTPS.

Giá trị trả về
Uri	URI để tìm nạp logic đặt giá thầu của người mua Giá trị này không được là null.

getBuyer

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

public AdTechIdentifier getBuyer ()

Người mua được xác định bởi một tên miền có dạng "buyerexample.com".

Giá trị trả về
AdTechIdentifier	AdTechIdentifier chứa miền của người mua thuộc đối tượng tuỳ chỉnh Giá trị này không được là null.

getDailyUpdateUri

Đã 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 getDailyUpdateUri ()

URI này trỏ đến một máy chủ do người mua điều hành, tại đây có lưu trữ dữ liệu đặt giá thầu được cập nhật và siêu dữ liệu quảng cáo được dùng trong quá trình lựa chọn quảng cáo trên thiết bị. URI phải dùng HTTPS.

Giá trị trả về
Uri	URI cập nhật hằng ngày của đối tượng tuỳ chỉnh Giá trị này không được là null.

getExpirationTime

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

public Instant getExpirationTime ()

Khi thời gian hết hạn đã trôi qua, đối tượng tuỳ chỉnh sẽ không còn đủ điều kiện để cập nhật dữ liệu về quảng cáo/đặt giá thầu hằng ngày hoặc tham gia vào quá trình lựa chọn quảng cáo. Sau đó, đối tượng tuỳ chỉnh sẽ bị xoá khỏi bộ nhớ trong lần cập nhật hàng ngày tiếp theo.

Nếu không cung cấp thời gian hết hạn khi tạo CustomAudience, thì thời hạn hết hạn sẽ được đặt về giá trị mặc định là 60 ngày kể từ ngày kích hoạt.

Thời gian hết hạn tối đa là 60 ngày kể từ lần kích hoạt đầu tiên.

Giá trị trả về
Instant	dấu thời gian Instant, được cắt ngắn thành mili giây, sau đó giá trị tuỳ chỉnh nên xóa đối tượng Giá trị này có thể là null.

getName

Đã 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 getName ()

Tên của đối tượng tuỳ chỉnh là một chuỗi tuỳ ý do chủ sở hữu và người mua cung cấp khi tạo đối tượng CustomAudience.

Giá trị trả về
String	tên Chuỗi của đối tượng tuỳ chỉnh Giá trị này không được là null.

getTrustedBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

Dữ liệu đặt giá thầu đáng tin cậy bao gồm URI trỏ đến máy chủ đáng tin cậy cho dữ liệu đặt giá thầu của người mua và danh sách các khoá để truy vấn máy chủ. Xin hãy lưu ý rằng các khoá là giá trị nhận dạng tuỳ ý chỉ được dùng để truy vấn máy chủ đáng tin cậy của logic đặt giá thầu của người mua trong quá trình lựa chọn quảng cáo.

Nếu bạn không chỉ định, thì CustomAudience sẽ không tham gia vào quá trình lựa chọn quảng cáo cho đến khi bạn cung cấp danh sách quảng cáo hợp lệ thông qua quá trình cập nhật hằng ngày cho đối tượng tuỳ chỉnh.

Giá trị trả về
TrustedBiddingData	đối tượng TrustedBiddingData chứa chiến lược đặt giá thầu đáng tin cậy của đối tượng tuỳ chỉnh dữ liệu Giá trị này có thể là null.

getUserBiddingSignals

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

public AdSelectionSignals getUserBiddingSignals ()

Tín hiệu đặt giá thầu của người dùng do người mua tuỳ ý cung cấp sẽ được JavaScript mà người mua cung cấp sử dụng trong quá trình lựa chọn quảng cáo trong một môi trường thực thi riêng biệt.

Nếu các tín hiệu đặt giá thầu của người dùng không phải là đối tượng JSON hợp lệ mà JS của người mua có thể sử dụng, thì đối tượng tuỳ chỉnh sẽ không đủ điều kiện để lựa chọn quảng cáo.

Nếu bạn không chỉ định, thì CustomAudience sẽ không tham gia vào quá trình lựa chọn quảng cáo cho đến khi bạn cung cấp tín hiệu đặt giá thầu của người dùng thông qua quá trình cập nhật hằng ngày cho đối tượng tuỳ chỉnh.

Giá trị trả về
AdSelectionSignals	đối tượng AdSelectionSignals đại diện cho các tín hiệu đặt giá thầu của người dùng cho đối tượng tuỳ chỉnh Giá trị này có thể 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 CustomAudience.

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

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