在 API 级别 34 中添加
也在广告服务扩展 4 中添加

摘要： 嵌套类 | 继承的常量 | 字段 | 方法 | 继承的方法

AdData

public final class AdData
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.common.AdData

---

表示广告选择和呈现所需的广告专属数据。

总结

嵌套类
class	AdData.Builder AdData 对象的构建器。

继承的常量
从 android.os.Parcelable 接口继承 int CONTENTS_FILE_DESCRIPTOR 与 describeContents() 一起使用的描述符位：表示 Parcelable 对象的扁平化表示中包含一个文件描述符。 int PARCELABLE_WRITE_RETURN_VALUE 与 writeToParcel(Parcel, int) 一起使用的标志：要写入的对象是一个返回值，该值是“Parcelable someFunction()”“void someFunction(out Parcelable)”或“void someFunction(inout Parcelable)”等函数的结果。

字段
public static final Creator<AdData>	CREATOR

公共方法
boolean	equals(Object o) 检查两个 AdData 对象是否包含相同的信息。
Set<Integer>	getAdCounterKeys() 获取用于统计事件的一组键。
AdFilters	getAdFilters() 获取与广告关联的所有 AdFilters。
String	getAdRenderId() 获取服务器竞价的广告呈现 ID。
String	getMetadata() 获取在广告选择流程中使用的买方广告元数据。
Uri	getRenderUri() 获取指向广告呈现素材资源的 URI。
int	hashCode() 返回 AdData 对象的数据的哈希值。
String	toString() 返回对象的字符串表示。
void	writeToParcel(Parcel dest, int flags) 将此对象展平为一个地块。

继承的方法
继承自 java.lang.Object 类 Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示某个其他对象是否“等于”此对象。 void finalize() 当垃圾回收功能确定对某个对象没有更多引用时，由垃圾回收器针对该对象调用该方法。 final Class<?> getClass() 返回此 Object 的运行时类。 int hashCode() 返回对象的哈希代码值。 final void notify() 唤醒正在等待此对象的监控器的单个线程。 final void notifyAll() 唤醒正在等待此对象的监控器的所有线程。 String toString() 返回对象的字符串表示。 final void wait(long timeoutMillis, int nanos) 导致当前线程进入等待状态，直到其被唤醒（通常在收到通知或被中断时），或者实际经过了一定的时间为止。 final void wait(long timeoutMillis) 导致当前线程进入等待状态，直到其被唤醒（通常在收到通知或被中断时），或者实际经过了一定的时间为止。 final void wait() 导致当前线程处于等待状态，直到其被唤醒（通常在收到通知或被中断时）。
继承自 android.os.Parcelable 接口 abstract int describeContents() 描述此 Parcelable 实例的编排表示法中包含的特殊对象的种类。 abstract void writeToParcel(Parcel dest, int flags) 将此对象展平为一个地块。

字段

CREATOR

在 API 级别 34 中添加
也在广告服务扩展 4 中添加

public static final Creator<AdData> CREATOR

公共方法

equals

在 API 级别 34 中引入

public boolean equals (Object o)

检查两个 AdData 对象是否包含相同的信息。

参数
o	Object：用来进行比较的参照对象。

返回值
boolean	如果此对象与 obj 参数相同，则返回 true，否则返回 false。

getAdCounterKeys

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public Set<Integer> getAdCounterKeys ()

获取用于统计事件的一组键。

一个广告最多可以关联 10 个广告计数器键。

在广告选择过程中，频次上限过滤会使用每个键的键和计数，以阻止相关广告提交至出价。

请注意，在自定义受众群体的每日更新期间，这些键可能会与自定义受众群体的广告和其他出价数据一起被覆盖。

开球回攻次数
Set<Integer>	此值不能为 null。

getAdFilters

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public AdFilters getAdFilters ()

获取与广告关联的所有 AdFilters。

如果达到或超出过滤器，则关联的广告不会参与广告选择。过滤条件是可选的，如果 null 指定不应用于此广告的过滤条件。

开球回攻次数
AdFilters

getAdRenderId

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public String getAdRenderId ()

获取服务器竞价的广告呈现 ID。

收到服务器竞价请求时，系统会针对每个 AdData 收集广告呈现 ID。

任何没有广告呈现 ID 的AdData都无法参与服务器端竞价。

开球回攻次数
String	此值可以为 null。

getMetadata

在 API 级别 34 中添加
也在广告服务扩展 4 中添加

public String getMetadata ()

获取在广告选择流程中使用的买方广告元数据。

元数据应为已序列化为字符串的有效 JSON 对象。元数据表示广告专有出价信息，将在广告选择期间的出价生成过程中使用，并用在买方 JavaScript 逻辑（在隔离的执行环境中执行）中。

如果元数据不是买方 JS 可使用的有效 JSON 对象，广告就不符合广告选择条件。

返回
String	此值不能为 null。

getRenderUri

在 API 级别 34 中添加
也在广告服务扩展 4 中添加

public Uri getRenderUri ()

获取指向广告呈现素材资源的 URI。URI 必须使用 HTTPS。

开球回攻次数
Uri	此值不能为 null。

hashCode

在 API 级别 34 中引入

public int hashCode ()

返回 AdData 对象数据的哈希值。

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

toString

在 API 级别 34 中引入

public String toString ()

返回对象的字符串表示。通常，toString 方法会返回一个“以文本形式表示”此对象的字符串。结果应该是一个简洁但信息丰富，并且便于阅读的字符串表示。建议所有子类都覆盖此方法。

类 Object 的 toString 方法会返回一个字符串，其中包含类的名称（相应对象是此类的实例）、字符“@”，以及此对象哈希代码的无符号十六进制表示。也就是说，此方法所返回的字符串等于以下公式的值：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

开球回攻次数
String	对象的字符串表示。

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 的组合