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<AdTechIdentifierAdSelectionSignals> perBuyerSignals)

広告選択時に各購入者が提供するシグナルを設定します。

AdSelectionConfig.Builder setSeller(AdTechIdentifier seller)

販売者 ID を設定します。

AdSelectionConfig.Builder setSellerSignals(AdSelectionSignals sellerSignals)

広告選択結果の変更に使用するシグナルを設定します。

AdSelectionConfig.Builder setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri)

クリエイティブ固有のリアルタイム ソースとなるセルサイドの信頼できるシグナルの URI エンドポイントを設定します 情報を取得できます。

継承されるメソッド

パブリック コンストラクタ

Builder

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public Builder ()

パブリック メソッド

build

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig build ()

AdSelectionConfig インスタンスを作成します。

戻り値
AdSelectionConfig この値が null になることはありません。

例外
NullPointerException いずれかの必須パラメータが null の場合

setAdSelectionSignals

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

広告選択の入札生成時に購入者に提供するシグナルを設定します。

設定されていない場合、デフォルトで空の JSON が使用されます。

詳しくは、AdSelectionConfig.getAdSelectionSignals() をご覧ください。

パラメータ
adSelectionSignals AdSelectionSignals: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。

setCustomAudienceBuyers

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)

許可された購入者のリストを設定します。

詳しくは、AdSelectionConfig.getCustomAudienceBuyers() をご覧ください。

パラメータ
customAudienceBuyers List: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。

setDecisionLogicUri

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

広告選択プロセスで使用する決定ロジックの取得に使用する URI を設定します。判断 URI は、次の 2 つのスキーマのいずれかにできます。

  • HTTPS: HTTPS URI は、ホストが seller と一致する絶対 URI にする必要があります。
  • 広告選択(事前構築済み): 広告選択サービスの URI は、ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> 形式に従います。 FLEDGE は、ネットワーク呼び出しを必要とせずに、適切な JS スクリプトを生成します。

    利用可能な事前構築済みスクリプト:

    • highest-bid-winsscoreAdsreportResult): この JS は、スコアリングのための最も高い入札単価の広告を選択します。対象 レポート用の場合、指定された URI は render_uribid でパラメータ化されます。この事前構築済みパラメータを使用するには、以下のパラメータが必要です。 <ph type="x-smartling-placeholder">
        </ph>
      • reportingUrl: 作成される基本レポート URI 後で render_uribid でパラメータ化

      例: ベース レポート 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

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setPerBuyerSignals (Map<AdTechIdentifierAdSelectionSignals> perBuyerSignals)

広告選択時に各購入者が提供するシグナルを設定します。

設定しない場合、デフォルトは空のマップになります。

詳しくは、AdSelectionConfig.getPerBuyerSignals() をご覧ください。

パラメータ
perBuyerSignals Map: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。

setSeller

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

販売者 ID を設定します。

詳しくは、AdSelectionConfig.getSeller() をご覧ください。

パラメータ
seller AdTechIdentifier: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。

setSellerSignals

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

広告選択結果の変更に使用するシグナルを設定します。

設定されていない場合、デフォルトは空の JSON です。

詳しくは、AdSelectionConfig.getSellerSignals() をご覧ください。

パラメータ
sellerSignals AdSelectionSignals: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。

setTrustedScoringSignalsUri

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加
public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

クリエイティブ固有のリアルタイム ソースとなるセルサイドの信頼できるシグナルの URI エンドポイントを設定します 情報を取得できます。

Uri#EMPTY が渡されると、ネットワーク呼び出しはスキップされ、AdSelectionSignals.EMPTY が広告選択に渡されます。

詳しくは、AdSelectionConfig.getTrustedScoringSignalsUri() をご覧ください。

パラメータ
trustedScoringSignalsUri Uri: この値を null にすることはできません。

戻り値
AdSelectionConfig.Builder この値が null になることはありません。