广告选择配置

public final class AdSelectionConfig
extends Object implements Parcelable

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

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

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

总结

嵌套类

class 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)

将此对象展平为一个地块。

继承的方法

字段

CREATOR

在 API 级别 34 中添加
也在广告服务扩展 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，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应返回 true。
  • 该方法具有传递性：对于任何非 null 引用值 x、y 和 z，如果 x.equals(y) 返回 true 且 y.equals(z) 返回 true，则 x.equals(z) 应返回 true。
  • 该方法具有一致性：对于任何非 null 引用值 x 和 y，多次调用 x.equals(y) 时，只要没有修改对象的 equals 比较中使用的任何信息，就会一致地返回 true 或 false。
  • 对于任何非 null 引用值 x，x.equals(null) 应返回 false。

Object 类的 equals 方法可对对象实现最具辨别性的等价关系；也就是说，对于任何非 null 引用值 x 和 y，当且仅当 x 和 y 引用同一对象时，此方法才会返回 true（x == y 时值为 true）。

请注意，一般而言，每次替换此方法时，都需要替换 hashCode 方法，以便维持 hashCode 方法的通用协定，该协定规定相等的对象必须具有相等的哈希代码。

参数
o Object：用来进行比较的参照对象。
返回值
boolean 如果此对象与 obj 参数相同，则返回 true，否则返回 false。

getAdSelectionSignals

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public AdSelectionSignals getAdSelectionSignals ()

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

getCustomAudienceBuyers

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public List<AdTechIdentifier> getCustomAudienceBuyers ()

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

getDecisionLogicUri

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public Uri getDecisionLogicUri ()

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

getPerBuyerSignals

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

开球回攻次数
Map<AdTechIdentifier, AdSelectionSignals> 买方与 AdSelectionSignals 的映射，从 AdSelectionConfig 提取并由从 DSP 提取的 JS 逻辑使用，表示每个买方在广告选择期间向参与者提供的所有信息（例如出价下限、广告选择类型等） 此值不能为 null。

getSeller

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public AdTechIdentifier getSeller ()

开球回攻次数
AdTechIdentifier 卖方的 AdTechIdentifier，例如“www.example-ssp.com”。此值不能为 null。

getSellerSignals

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public AdSelectionSignals getSellerSignals ()

开球回攻次数
AdSelectionSignals AdSelectionSignals 对象中的 JSON（由 SSP 提供并由从 SSP 提取的 JS 逻辑使用）表示 SSP 在广告评分流程中为调整广告选择流程的结果（例如，品牌保障检查、排除的内容相关广告）使用的任何信息。 此值不能为 null。

getTrustedScoringSignalsUri

在 API 级别 34 中添加
也在广告服务扩展 4 中添加 
public Uri getTrustedScoringSignalsUri ()

开球回攻次数
Uri 卖方可信信号的 URI 端点，可从中提取广告素材专有的实时信息。 此值不能为 null。

hashCode

在 API 级别 34 中引入 
public int hashCode ()

返回对象的哈希代码值。之所以支持此方法，是为了支持哈希表（例如由 HashMap 提供的表）。

hashCode 的通用协定如下：

  • 每当在 Java 应用执行期间在同一个对象上多次调用该方法时，只要没有修改对象的 equals 比较中使用的任何信息，hashCode 方法都必须始终返回相同的整数。在应用的不同执行之间，此整数无需保持一致。
  • 如果根据 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 的组合