已在 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。

设置广告过滤器

在 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。