AdSelectionConfig.Builder

public static final class AdSelectionConfig.Builder
继承自 Object

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

AdSelectionConfig 对象的 Builder。

摘要

公共构造函数

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

public Builder ()

公共方法

build

public AdSelectionConfig build ()

构建 AdSelectionConfig 实例。

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

setAdSelectionSignals

public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

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

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

有关详情，请参阅 AdSelectionConfig.getAdSelectionSignals()。

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

setCustomAudienceBuyers

public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)

设置允许的买家列表。

有关详情，请参阅 AdSelectionConfig.getCustomAudienceBuyers()。

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

setDecisionLogicUri

public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

设置用于获取广告选择过程中使用的决策逻辑的 URI。决策 URI 可以是以下两种架构之一：

  • HTTPS：HTTPS URI 必须是绝对 URI，其中主机与 seller 匹配
  • Ad Selection Prebuilt：Ad Selection Service URI 遵循 ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> 格式。FLEDGE 会生成相应的 JS 脚本，无需进行网络调用。

    可用的预构建脚本

    • highest-bid-wins（用于 scoreAds 和 reportResult）：此 JS 会选择出价最高的广告进行评分。对于报告，给定的 URI 使用 render_uri 和 bid 进行参数化。使用此预构建脚本需要以下参数：
      • reportingUrl：基本报告 URI，稍后将使用 render_uri 和 bid 进行参数化

      例如，如果你的基本报告 URL 是 "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

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

设置广告选择期间由各买家提供的信号。

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

有关详情，请参阅 AdSelectionConfig.getPerBuyerSignals()。

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

setSeller

public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

设置卖方标识符。

有关详情，请参阅 AdSelectionConfig.getSeller()。

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

setSellerSignals

public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

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

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

有关详情，请参阅 AdSelectionConfig.getSellerSignals()。

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

setTrustedScoringSignalsUri

public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

设置卖方可信信号的 URI 端点，可从中获取针对创意素材的实时信息。

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

有关详情，请参阅 AdSelectionConfig.getTrustedScoringSignalsUri()。

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