AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig

包含广告选择流程的配置信息。

此类的实例由 SDK 创建，作为 AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) 和 AdSelectionManager#reportImpression 方法在 AdSelectionManager 中的参数提供。

摘要

嵌套类

类 AdSelectionConfig.Builder

AdSelectionConfig 对象的构建器。 

继承常量

字段

public static final Creator<AdSelectionConfig> CREATOR

公共方法

int describeContents()

描述此 Parcelable 实例的封送表示形式中包含的特殊对象的种类。
boolean equals(Object o)

指示某个其他对象是否与此对象“相等”。
AdSelectionSignals getAdSelectionSignals()
List<AdTechIdentifier> getCustomAudienceBuyers()
Uri getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals()
AdTechIdentifier getSeller()
AdSelectionSignals getSellerSignals()
Uri getTrustedScoringSignalsUri()
int hashCode()

返回对象的哈希码值。
void writeToParcel(Parcel dest, int flags)

将此对象展平到 Parcel 中。

继承方法

字段

CREATOR

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public static final Creator<AdSelectionConfig> CREATOR

公共方法

describeContents

添加于 API 级别 34
public int describeContents ()

描述此 Parcelable 实例的封送表示形式中包含的特殊对象的种类。例如，如果对象将在 writeToParcel(android.os.Parcel, int) 的输出中包含文件描述符，则此方法的返回值必须包含 CONTENTS_FILE_DESCRIPTOR 位。

返回值
int 一个位掩码，指示此 Parcelable 对象实例封送的特殊对象类型的集合。值为 0 或 CONTENTS_FILE_DESCRIPTOR

equals

添加于 API 级别 34
public boolean equals (Object o)

指示某个其他对象是否与此对象“相等”。

equals 方法在非 null 对象引用上实现了等价关系

  • 它是 自反的：对于任何非 null 引用值 x，x.equals(x) 应返回 true。
  • 它是 对称的：对于任何非 null 引用值 x 和 y，x.equals(y) 应返回 true 当且仅当 y.equals(x) 返回 true。
  • 它是 传递的：对于任何非 null 引用值 x、y 和 z，如果 x.equals(y) 返回 true 且 y.equals(z) 返回 true，则 x.equals(z) 应返回 true。
  • 它是一致的：对于任何非 null 引用值 x 和 y，多次调用 x.equals(y) 总是返回 true 或总是返回 false，前提是对象上的 equals 比较中使用的信息未被修改。
  • 对于任何非 null 引用值 x，x.equals(null) 应返回 false。

类 Object 的 equals 方法在对象上实现了最严格的等价关系；也就是说，对于任何非 null 引用值 x 和 y，此方法返回 true 当且仅当 x 和 y 指向同一对象 (x == y 的值为 true)。

请注意，通常在重写此方法时，必须重写 hashCode 方法，以维护 hashCode 方法的一般契约，该契约规定相等的对象必须具有相等的哈希码。

参数
o Object：用于比较的引用对象。
返回值
boolean 如果此对象与 obj 参数相同，则为 true；否则为 false。

getAdSelectionSignals

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public AdSelectionSignals getAdSelectionSignals ()

返回值
AdSelectionSignals AdSelectionSignals 对象中的 JSON，从 AdSelectionConfig 中获取并由从 DSP 获取的 JS 逻辑使用，表示在广告选择和报告流程中提供给参与买方的信号。此值不能为 null。

getCustomAudienceBuyers

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public List<AdTechIdentifier> getCustomAudienceBuyers ()

返回值
List<AdTechIdentifier> SSP 允许参与广告选择流程的自定义受众买方列表。此值不能为 null。

getDecisionLogicUri

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public Uri getDecisionLogicUri ()

返回值
Uri 用于检索包含在广告选择和报告流程中使用的卖方/SSP scoreAd 函数的 JS 代码的 URI。此值不能为 null。

getPerBuyerSignals

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

返回值
Map<AdTechIdentifier, AdSelectionSignals> 买方和 AdSelectionSignals 的 Map，从 AdSelectionConfig 中获取并由从 DSP 获取的 JS 逻辑使用，表示每个买方在广告选择过程中向参与方提供的任何信息（例如最低出价、广告选择类型等）。此值不能为 null。

getSeller

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public AdTechIdentifier getSeller ()

返回值
AdTechIdentifier 卖方的 AdTechIdentifier，例如“www.example-ssp.com”。此值不能为 null。

getSellerSignals

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public AdSelectionSignals getSellerSignals ()

返回值
AdSelectionSignals AdSelectionSignals 对象中的 JSON，由 SSP 提供并由从 SSP 获取的 JS 逻辑使用，表示 SSP 在广告评分流程中用于调整广告选择流程结果的任何信息（例如品牌安全检查、排除的上下文广告）。此值不能为 null。

getTrustedScoringSignalsUri

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public Uri getTrustedScoringSignalsUri ()

返回值
Uri 用于获取创意特定实时信息的卖方信任信号的 URI 端点。此值不能为 null。

hashCode

添加于 API 级别 34
public int hashCode ()

返回对象的哈希码值。此方法受 HashMap 等哈希表的支持。

hashCode 的一般契约是

  • 在 Java 应用的执行过程中，无论何时在同一对象上多次调用 hashCode 方法，它都必须始终返回相同的整数，前提是对象上的 equals 比较中使用的信息未被修改。此整数不必在同一应用的两次不同执行之间保持一致。
  • 如果根据 equals(Object) 方法两个对象相等，则在两个对象上调用 hashCode 方法必须产生相同的整数结果。
  • 并非强制要求如果根据 equals(java.lang.Object) 方法两个对象不相等，则在两个对象上调用 hashCode 方法必须产生不同的整数结果。但是，程序员应该意识到，对于不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理实用的范围内，类 Object 定义的 hashCode 方法对于不同的对象返回不同的整数。（hashCode 可能或不实现为对象在某个时间点的内存地址的某个函数。）

返回值
int 此对象的哈希码值。

writeToParcel

添加于 API 级别 34
public void writeToParcel (Parcel dest, 
                int flags)

将此对象展平到 Parcel 中。

参数
dest Parcel：此值不能为 null。
flags int：关于如何写入对象的附加标志。可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。值为 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE 和 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES 的组合