已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
摘要： 构造函数 | 方法 | 继承的方法

AdSelectionConfig.Builder

public static final class AdSelectionConfig.Builder
extends Object

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

AdSelectionConfig 对象的构建器。

摘要

公共构造函数

Builder()

公共方法

AdSelectionConfig build()

构建 AdSelectionConfig 实例。

AdSelectionConfig.Builder setAdSelectionSignals(AdSelectionSignals adSelectionSignals)

设置在广告选择出价生成期间向买方提供的信号。

AdSelectionConfig.Builder setCustomAudienceBuyers(List<AdTechIdentifier> customAudienceBuyers)

设置允许的买方列表。

AdSelectionConfig.Builder setDecisionLogicUri(Uri decisionLogicUri)

设置用于提取决策逻辑以用于广告选择流程的 URI。

AdSelectionConfig.Builder setPerBuyerSignals(Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)

设置每个买方在广告选择期间提供的信号。

AdSelectionConfig.Builder setSeller(AdTechIdentifier seller)

设置卖方标识符。

AdSelectionConfig.Builder setSellerSignals(AdSelectionSignals sellerSignals)

设置用于修改广告选择结果的信号。

AdSelectionConfig.Builder setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri)

设置卖方可信信号的 URI 端点，该信号可实时从这些信号中 可提取的信息。

继承的方法

公共构造函数

Builder

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public Builder ()

公共方法

build

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig build ()

构建 AdSelectionConfig 实例。

返回
AdSelectionConfig 此值不能为 null。
抛出
NullPointerException 如果任何必需参数为 null

setAdSelectionSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

设置在广告选择出价生成期间向买方提供的信号。

如果未设置，则默认为空 JSON。

如需了解详情，请参阅 AdSelectionConfig.getAdSelectionSignals()。

参数
adSelectionSignals AdSelectionSignals：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setCustomAudienceBuyers

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)

设置允许的买方列表。

如需了解详情，请参阅 AdSelectionConfig.getCustomAudienceBuyers()。

参数
customAudienceBuyers List：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setDecisionLogicUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

设置用于提取决策逻辑以用于广告选择流程的 URI。判定 URI 可以是以下两种架构之一：

  • HTTPS：HTTPS URI 必须是绝对 URI，其中主机与 seller 匹配
  • 广告选择预构建：广告选择服务 URI 遵循 ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> 格式。 FLEDGE 无需调用网络即可生成相应的 JS 脚本。

    可用的预构建脚本：

    • highest-bid-wins（针对 scoreAds 和 reportResult）：此 JS 会选择出价最高的广告进行评分。对于 系统会使用 render_uri 和 bid 参数化给定 URI。如需使用此预构建版本，您需要提供以下参数： <ph type="x-smartling-placeholder">
        </ph>
      • reportingUrl：将创建的基础报告 URI 稍后使用 render_uri 和 bid 参数化

      例如：如果您的基本报告网址为“https://www.ssp.com”之后，ad-selection-prebuilt://ad-selection/highest-bid-wins/?reportingUrl=https://www.ssp.com

如需了解详情，请参阅 AdSelectionConfig.getDecisionLogicUri()。

参数
decisionLogicUri Uri：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setPerBuyerSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setPerBuyerSignals (Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)

设置每个买方在广告选择期间提供的信号。

如果未设置，则默认为空映射。

如需了解详情，请参阅 AdSelectionConfig.getPerBuyerSignals()。

参数
perBuyerSignals Map：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setSeller

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

设置卖方标识符。

如需了解详情，请参阅 AdSelectionConfig.getSeller()。

参数
seller AdTechIdentifier：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setSellerSignals

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

设置用于修改广告选择结果的信号。

如果未设置，则默认为空 JSON。

如需了解详情，请参阅 AdSelectionConfig.getSellerSignals()。

参数
sellerSignals AdSelectionSignals：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。

setTrustedScoringSignalsUri

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入 
public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

设置卖方可信信号的 URI 端点，该信号可实时从这些信号中 可提取的信息。

如果传递了 Uri#EMPTY，则会跳过网络调用，并将 AdSelectionSignals.EMPTY 传递给广告选择。

如需了解详情，请参阅 AdSelectionConfig.getTrustedScoringSignalsUri()。

参数
trustedScoringSignalsUri Uri：此值不能为 null。
返回值
AdSelectionConfig.Builder 此值不能为 null。