此页面由 Cloud Translation API 翻译。

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