Added in API level 34
Also in Ad Services Extensions 4

Summary: Ctors | Methods | Inherited Methods

AdSelectionConfig.Builder

Kotlin |Java

public static final class AdSelectionConfig.Builder
extends Object

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

Builder for AdSelectionConfig object.

Summary

Public constructors
`Builder()`

Public methods
`AdSelectionConfig`	`build()` Builds an `AdSelectionConfig` instance.
`AdSelectionConfig.Builder`	`setAdSelectionSignals(AdSelectionSignals adSelectionSignals)` Sets the signals provided to buyers during ad selection bid generation.
`AdSelectionConfig.Builder`	`setCustomAudienceBuyers(List<AdTechIdentifier> customAudienceBuyers)` Sets the list of allowed buyers.
`AdSelectionConfig.Builder`	`setDecisionLogicUri(Uri decisionLogicUri)` Sets the URI used to fetch decision logic for use in the ad selection process.
`AdSelectionConfig.Builder`	`setPerBuyerSignals(Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)` Sets the signals provided by each buyer during ad selection.
`AdSelectionConfig.Builder`	`setPerBuyerSignedContextualAds(Map<AdTechIdentifier, SignedContextualAds> buyerSignedContextualAds)` Sets the contextual Ads corresponding to each buyer during ad selection.
`AdSelectionConfig.Builder`	`setSeller(AdTechIdentifier seller)` Sets the seller identifier.
`AdSelectionConfig.Builder`	`setSellerSignals(AdSelectionSignals sellerSignals)` Set the signals used to modify ad selection results.
`AdSelectionConfig.Builder`	`setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri)` Sets the URI endpoint of sell-side trusted signal from which creative specific realtime information can be fetched from.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

Builder

Added in API level 34
Also in Ad Services Extensions 4

public Builder ()

Public methods

build

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig build ()

Builds an AdSelectionConfig instance.

Returns
`AdSelectionConfig`	This value cannot be `null`.

Throws
`NullPointerException`	if any required params are null

setAdSelectionSignals

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

Sets the signals provided to buyers during ad selection bid generation.

If not set, defaults to the empty JSON.

See AdSelectionConfig.getAdSelectionSignals() for more details.

Parameters
`adSelectionSignals`	`AdSelectionSignals`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setCustomAudienceBuyers

Added in API level 34
Also in Ad Services Extensions 4

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

Sets the list of allowed buyers.

See AdSelectionConfig.getCustomAudienceBuyers() for more details.

Parameters
`customAudienceBuyers`	`List`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setDecisionLogicUri

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

Sets the URI used to fetch decision logic for use in the ad selection process. Decision URI could be either of the two schemas:

HTTPS: HTTPS URIs have to be absolute URIs where the host matches the seller
Ad Selection Prebuilt: Ad Selection Service URIs follow ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> format. FLEDGE generates the appropriate JS script without the need for a network call.
Available prebuilt scripts:
- highest-bid-wins for scoreAds and reportResult: This JS picks the ad with the highest bid for scoring. For reporting, the given URI is parameterized with render_uri and bid. Below parameter(s) are required to use this prebuilt:
  - reportingUrl: Base reporting uri that will be parameterized later with render_uri and bid
  Ex. If your base reporting URL is "https://www.ssp.com" then, ad-selection-prebuilt://ad-selection/highest-bid-wins/?reportingUrl=https://www.ssp.com

See AdSelectionConfig.getDecisionLogicUri() for more details.

Parameters
`decisionLogicUri`	`Uri`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setPerBuyerSignals

Added in API level 34
Also in Ad Services Extensions 4

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

Sets the signals provided by each buyer during ad selection.

If not set, defaults to an empty map.

See AdSelectionConfig.getPerBuyerSignals() for more details.

Parameters
`perBuyerSignals`	`Map`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setPerBuyerSignedContextualAds

Added in API level 35
Also in Ad Services Extensions 12

public AdSelectionConfig.Builder setPerBuyerSignedContextualAds (Map<AdTechIdentifier, SignedContextualAds> buyerSignedContextualAds)

Sets the contextual Ads corresponding to each buyer during ad selection.

If not set, defaults to an empty map.

See AdSelectionConfig.getPerBuyerSignedContextualAds() for more details.

Parameters
`buyerSignedContextualAds`	`Map`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setSeller

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

Sets the seller identifier.

See AdSelectionConfig.getSeller() for more details.

Parameters
`seller`	`AdTechIdentifier`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setSellerSignals

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

Set the signals used to modify ad selection results.

If not set, defaults to the empty JSON.

See AdSelectionConfig.getSellerSignals() for more details.

Parameters
`sellerSignals`	`AdSelectionSignals`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.

setTrustedScoringSignalsUri

Added in API level 34
Also in Ad Services Extensions 4

public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

Sets the URI endpoint of sell-side trusted signal from which creative specific realtime information can be fetched from.

If Uri.EMPTY is passed then network call will be skipped and AdSelectionSignals.EMPTY will be passed to ad selection.

See AdSelectionConfig.getTrustedScoringSignalsUri() for more details.

Parameters
`trustedScoringSignalsUri`	`Uri`: This value cannot be `null`.

Returns
`AdSelectionConfig.Builder`	This value cannot be `null`.