AdSelectionConfig
public
final
class
AdSelectionConfig
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.adselection.AdSelectionConfig |
Chứa cấu hình của quá trình lựa chọn quảng cáo.
Các thực thể của lớp này do SDK tạo để cung cấp dưới dạng đối số cho các phương thức AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver)
và AdSelectionManager#reportImpression
trong AdSelectionManager
.
Tóm tắt
Lớp lồng ghép | |
---|---|
class |
AdSelectionConfig.Builder
Trình tạo cho đối tượng |
Hằng số kế thừa |
---|
Các trường | |
---|---|
public
static
final
Creator<AdSelectionConfig> |
CREATOR
|
Phương thức công khai | |
---|---|
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. |
boolean
|
equals(Object o)
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. |
AdSelectionSignals
|
getAdSelectionSignals()
|
List<AdTechIdentifier>
|
getCustomAudienceBuyers()
|
Uri
|
getDecisionLogicUri()
|
Map<AdTechIdentifier, AdSelectionSignals>
|
getPerBuyerSignals()
|
AdTechIdentifier
|
getSeller()
|
AdSelectionSignals
|
getSellerSignals()
|
Uri
|
getTrustedScoringSignalsUri()
|
int
|
hashCode()
Trả về một giá trị mã băm cho đố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
public static final Creator<AdSelectionConfig> CREATOR
Phương thức công khai
describeContents
public 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. Ví dụ: nếu đối tượng có chứa chỉ số mô tả tệp trong dữ liệu đầu ra của writeToParcel(android.os.Parcel, int)
, thì giá trị trả về của phương thức này phải bao gồm bit CONTENTS_FILE_DESCRIPTOR
.
Giá trị trả về | |
---|---|
int |
một bitmask cho biết một tập hợp các kiểu đối tượng đặc biệt do bản sao đối tượng Parcelable này kết hợp.
Giá trị sẽ là 0 hoặc CONTENTS_FILE_DESCRIPTOR |
equals
public boolean equals (Object o)
Cho biết liệu một số đối tượng khác có "bằng" đối tượng này hay không.
Phương thức equals
triển khai mối quan hệ
tương đương trên các tệp tham chiếu đối tượng không có giá trị null:
- Phản hồi: đối với mọi giá trị tham chiếu không có giá trị null
x
,x.equals(x)
sẽ trả vềtrue
. - Đó là đối xứng: đối với mọi giá trị tham chiếu không có giá trị null
x
vày
,x.equals(y)
sẽ trả vềtrue
nếu và chỉ khiy.equals(x)
trả vềtrue
. - Giá trị này là tạm thời: đối với mọi giá trị tham chiếu không có giá trị null
x
,y
, vàz
, nếux.equals(y)
trả vềtrue
vày.equals(z)
trả vềtrue
, sau đóx.equals(z)
sẽ trả vềtrue
. - Giá trị này nhất quán: đối với mọi giá trị tham chiếu không có giá trị null
x
vày
, nhiều lệnh gọix.equals(y)
sẽ trả về một cách nhất quántrue
hoặc trả về nhất quánfalse
, miễn là không có thông tin nào được sử dụng trong thông tin so sánhequals
trên các đối tượng được sửa đổi. - Đối với mọi giá trị tham chiếu không có giá trị null
x
,x.equals(null)
sẽ trả vềfalse
.
Phương thức equals
cho loại Object
triển khai
mối quan hệ tương đương có thể phân biệt nhiều nhất trên các đối tượng;
tức là đối với mọi giá trị tham chiếu không có giá trị null x
và
y
, phương thức này trả về true
nếu và chỉ
khi x
và y
tham chiếu đến cùng một đối tượng
(x == y
có giá trị true
).
Xin lưu ý rằng thông thường, bạn cần phải ghi đè phương thức hashCode
bất cứ khi nào phương thức này bị ghi đè, để duy trì
hợp đồng chung cho phương thức hashCode
, trong đó nêu rõ
rằng các đối tượng bằng nhau phải có mã băm bằng nhau.
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 . |
getAdSelectionSignals
public AdSelectionSignals getAdSelectionSignals ()
Giá trị trả về | |
---|---|
AdSelectionSignals |
JSON trong đối tượng AdSelectionSignals, được tìm nạp từ AdSelectionConfig và được logic JS tìm nạp từ DSP sử dụng, đại diện cho các tín hiệu được cung cấp cho người mua tham gia trong quá trình lựa chọn quảng cáo và báo cáo.
Giá trị này không được là null . |
getCustomAudienceBuyers
public List<AdTechIdentifier> getCustomAudienceBuyers ()
Giá trị trả về | |
---|---|
List<AdTechIdentifier> |
danh sách người mua đối tượng tuỳ chỉnh mà SSP cho phép tham gia vào quá trình lựa chọn quảng cáo. Giá trị này không được là null . |
getdecisionLogicUri
public Uri getDecisionLogicUri ()
Giá trị trả về | |
---|---|
Uri |
URI dùng để truy xuất mã JS chứa hàm scoreAd của bên bán/SSP được dùng trong quá trình lựa chọn và báo cáo quảng cáo. Giá trị này không được là null . |
getPerBuyerSignals
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()
Giá trị trả về | |
---|---|
Map<AdTechIdentifier, AdSelectionSignals> |
Bản đồ của người mua và AdSelectionSignals, được tìm nạp từ AdSelectionConfig và được logic JS tìm nạp từ DSP, đại diện cho mọi thông tin mà mỗi người mua sẽ cung cấp trong quá trình lựa chọn quảng cáo cho người tham gia (chẳng hạn như giá thầu sàn, loại lựa chọn quảng cáo, v.v.)
Giá trị này không được là null . |
getSeller
public AdTechIdentifier getSeller ()
Giá trị trả về | |
---|---|
AdTechIdentifier |
một AdTechIdentifier của người bán, ví dụ: "www.example-ssp.com". Giá trị này không được là null . |
getSellerSignals
public AdSelectionSignals getSellerSignals ()
Giá trị trả về | |
---|---|
AdSelectionSignals |
JSON trong đối tượng AdSelectionSignals, do SSP cung cấp và được logic JS tìm nạp từ SSP sử dụng, đại diện cho mọi thông tin mà SSP dùng trong quá trình tính điểm quảng cáo để tinh chỉnh kết quả của quá trình lựa chọn quảng cáo (ví dụ: kiểm tra tính an toàn thương hiệu, quảng cáo theo bối cảnh bị loại trừ).
Giá trị này không được là null . |
getTrustedScoringSignalsUri
public Uri getTrustedScoringSignalsUri ()
Giá trị trả về | |
---|---|
Uri |
Điểm cuối URI của tín hiệu đáng tin cậy bên bán mà từ đó thông tin cụ thể về mẫu quảng cáo theo thời gian thực có thể được tìm nạp.
Giá trị này không được là null . |
hashCode
public int hashCode ()
Trả về một giá trị mã băm cho đối tượng. Phương thức này được
hỗ trợ vì lợi ích của bảng băm, chẳng hạn như các bảng do
HashMap
cung cấp.
Hợp đồng chung của hashCode
là:
- Bất cứ khi nào được gọi trên cùng một đối tượng nhiều lần trong quá trình
thực thi một ứng dụng Java, phương thức
hashCode
phải luôn trả về cùng một số nguyên, miễn là không sử dụng thông tin nào trongequals
các phép so sánh trên đối tượng được sửa đổi. Số nguyên này không nhất thiết phải từ một lần thực thi của một ứng dụng đến lần thực thi khác của cùng một ứng dụng. - Nếu có hai đối tượng bằng nhau theo phương thức
equals(Object)
, thì việc gọi phương thứchashCode
trên một trong hai đối tượng phải tạo ra một kết quả số nguyên. - Điều đó là không bắt buộc nếu phương thức
equals(java.lang.Object)
không giống nhau đối với hai đối tượng, khi đó phương thứchashCode
sẽ được gọi trên một trong hai đối tượng phải tạo ra kết quả số nguyên riêng biệt. Tuy nhiên, người lập trình cần lưu ý rằng việc tạo kết quả số nguyên riêng biệt cho các đối tượng không bằng nhau có thể cải thiện hiệu suất của bảng băm.
Thực tế, phương thức hashCode mà loại Object
xác định cũng trả về số nguyên riêng cho các đối tượng riêng biệt. (hashCode có thể được hoặc không được triển khai dưới dạng một hàm nào đó về địa chỉ bộ nhớ của đối tượng tại thời điểm cụ thể.)
Giá trị trả về | |
---|---|
int |
một giá trị mã băm cho đối tượng này. |
writeToParcel
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 |