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

摘要： 构造函数 | 方法 | 继承的方法

AdData.Builder

public static final class AdData.Builder
extends Object

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

---

AdData 对象的构建器。

总结

公共构造函数
Builder()

公共方法
AdData	build() 构建 AdData 对象。
AdData.Builder	setAdCounterKeys(Set<Integer> adCounterKeys) 设置用于统计事件的一组键。
AdData.Builder	setAdFilters(AdFilters adFilters) 设置与广告关联的所有 AdFilters。
AdData.Builder	setAdRenderId(String adRenderId) 为服务器竞价设置广告呈现 ID 如需了解详情，请参阅 AdData#getAdRenderId()。
AdData.Builder	setMetadata(String metadata) 设置在广告选择流程中使用的买方广告元数据。
AdData.Builder	setRenderUri(Uri renderUri) 设置指向广告呈现素材资源的 URI。

继承的方法

继承自 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() 导致当前线程处于等待状态，直到其被唤醒（通常在收到通知或被中断时）。

公共构造函数

Builder

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

public Builder ()

公共方法

build

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

public AdData build ()

构建 AdData 对象。

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

抛出
NullPointerException	如果在构建时有任何必需参数为 null

setAdCounterKeys

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public AdData.Builder setAdCounterKeys (Set<Integer> adCounterKeys)

设置用于统计事件的一组键。

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

如需了解详情，请参阅 AdData.getAdCounterKeys()。

参数
adCounterKeys	Set：此值不能为 null。

开球回攻次数
AdData.Builder	此值不能为 null。

setAdFilters

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public AdData.Builder setAdFilters (AdFilters adFilters)

设置与广告关联的所有 AdFilters。

如需了解详情，请参阅 AdData.getAdFilters()。

参数
adFilters	AdFilters：此值可以为 null。

开球回攻次数
AdData.Builder	此值不能为 null。

setAdRenderId

在 Android UpsideDownCakePrivacySandbox 中添加的功能

public AdData.Builder setAdRenderId (String adRenderId)

为服务器竞价设置广告呈现 ID

如需了解详情，请参阅 AdData#getAdRenderId()。

参数
adRenderId	String：此值可以为 null。

开球回攻次数
AdData.Builder	此值不能为 null。

setMetadata

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

public AdData.Builder setMetadata (String metadata)

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

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

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

如需了解详情，请参阅 AdData.getMetadata()。

参数
metadata	String：此值不能为 null。

开球回攻次数
AdData.Builder	此值不能为 null。

setRenderUri

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

public AdData.Builder setRenderUri (Uri renderUri)

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

如需了解详情，请参阅 AdData.getRenderUri()。

参数
renderUri	Uri：此值不能为 null。

开球回攻次数
AdData.Builder	此值不能为 null。