Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Builder

*** ** * ** ***

```
class Builder
```

|---|---|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) ||
| ↳ | [android.adservices.customaudience.CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) |

*** ** * ** ***

> [!CAUTION]
> **This class was deprecated in API level 37.**
>
> The Rubidium (Rb) Relevance APIs, including those in android.adservices.customaudience, are being deprecated. Relevance APIs have no direct replacement. Developers should stop using them, as calls will be rejected in future Android releases. Please refer to official Privacy Sandbox documentation for deprecation and roadmap details: https://privacysandbox.com/news/update-on-plans-for-privacy-sandbox-technologies/

Builder for `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` objects.

## Summary

| Public constructors ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#Builder()()` <br /> |

| Public methods ||
|---|---|
| [CustomAudience](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#build()()` Builds an instance of a `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience`. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setActivationTime(java.time.Instant)(activationTime: https://developer.android.com/reference/kotlin/java/time/Instant.html#?)` Sets the time, truncated to milliseconds, after which the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` will serve ads. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setAds(kotlin.collections.MutableList)(ads: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html<https://developer.android.com/reference/kotlin/android/adservices/common/AdData.html#!>?)` Sets the initial remarketing ads served by the custom audience. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setAuctionServerRequestFlags(kotlin.Int)(auctionServerRequestFlags: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)` Sets the bitfield of auction server request flags. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setBiddingLogicUri(android.net.Uri)(biddingLogicUri: https://developer.android.com/reference/kotlin/android/net/Uri.html#)` Sets the URI to fetch bidding logic from for use in the ad selection process. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setBuyer(android.adservices.common.AdTechIdentifier)(buyer: https://developer.android.com/reference/kotlin/android/adservices/common/AdTechIdentifier.html#)` Sets the buyer `https://developer.android.com/reference/kotlin/android/adservices/common/AdTechIdentifier.html#`. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setComponentAds(kotlin.collections.MutableList)(componentAds: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html<https://developer.android.com/reference/kotlin/android/adservices/common/ComponentAdData.html#!>)` Sets the components ads served by the custom audience. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setDailyUpdateUri(android.net.Uri)(dailyUpdateUri: https://developer.android.com/reference/kotlin/android/net/Uri.html#)` Sets the daily update URI. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setExpirationTime(java.time.Instant)(expirationTime: https://developer.android.com/reference/kotlin/java/time/Instant.html#?)` Sets the time, truncated to milliseconds, after which the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` should be removed. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setName(kotlin.String)(name: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)` Sets the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` object's name. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setPriority(kotlin.Double)(priority: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-double/index.html)` Sets the priority for this custom audience. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setTrustedBiddingData(android.adservices.customaudience.TrustedBiddingData)(trustedBiddingData: https://developer.android.com/reference/kotlin/android/adservices/customaudience/TrustedBiddingData?)` Sets the trusted bidding data to be queried and used in the ad selection process. |
| [CustomAudience.Builder](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#) | `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#setUserBiddingSignals(android.adservices.common.AdSelectionSignals)(userBiddingSignals: https://developer.android.com/reference/kotlin/android/adservices/common/AdSelectionSignals.html#?)` Sets the user bidding signals used in the ad selection process. |

## Public constructors

### Builder

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)

```
Builder()
```

## Public methods

### build

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun build(): CustomAudience
```

**Deprecated:** *Deprecated in Java.*

Builds an instance of a `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience`.

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` | This value cannot be `null`. |

| Exceptions ||
|---|---|
| `java.lang.IllegalArgumentException` | if the expiration time is set before the current time |
| `java.lang.NullPointerException` | if any non-null parameter is null |

### setActivationTime

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setActivationTime(activationTime: Instant?): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the time, truncated to milliseconds, after which the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` will serve ads.

Set to `null` in order for this `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` to be immediately active and participate in ad selection.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getActivationTime()` for more information.

| Parameters ||
|---|---|
| `activationTime` | [Instant](https://developer.android.com/reference/kotlin/java/time/Instant.html#)?: This value may be `null`. |

### setAds

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setAds(ads: MutableList<AdData!>?): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the initial remarketing ads served by the custom audience. Will be assigned with an empty list if not provided.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getAds()` for more information.

| Parameters ||
|---|---|
| `ads` | [MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)\<[AdData](https://developer.android.com/reference/kotlin/android/adservices/common/AdData.html#)!\>?: This value may be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setAuctionServerRequestFlags

Added in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 12](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setAuctionServerRequestFlags(auctionServerRequestFlags: Int): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the bitfield of auction server request flags.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getAuctionServerRequestFlags()` for more information.

| Parameters ||
|---|---|
| `auctionServerRequestFlags` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html): Value is either `0` or a combination of the following: - `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#FLAG_AUCTION_SERVER_REQUEST_OMIT_ADS:kotlin.Int` |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setBiddingLogicUri

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setBiddingLogicUri(biddingLogicUri: Uri): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the URI to fetch bidding logic from for use in the ad selection process. The URI must use HTTPS.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getBiddingLogicUri()` for more information.

| Parameters ||
|---|---|
| `biddingLogicUri` | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#): This value cannot be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setBuyer

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setBuyer(buyer: AdTechIdentifier): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the buyer `https://developer.android.com/reference/kotlin/android/adservices/common/AdTechIdentifier.html#`.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getBuyer()` for more information.

| Parameters ||
|---|---|
| `buyer` | [AdTechIdentifier](https://developer.android.com/reference/kotlin/android/adservices/common/AdTechIdentifier.html#): This value cannot be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setComponentAds

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 16](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setComponentAds(componentAds: MutableList<ComponentAdData!>): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the components ads served by the custom audience.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getComponentAds()` for more information.

| Parameters ||
|---|---|
| `componentAds` | [MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)\<[ComponentAdData](https://developer.android.com/reference/kotlin/android/adservices/common/ComponentAdData.html#)!\>: This value cannot be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setDailyUpdateUri

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setDailyUpdateUri(dailyUpdateUri: Uri): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the daily update URI. The URI must use HTTPS.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getDailyUpdateUri()` for more information.

| Parameters ||
|---|---|
| `dailyUpdateUri` | [Uri](https://developer.android.com/reference/kotlin/android/net/Uri.html#): This value cannot be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setExpirationTime

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setExpirationTime(expirationTime: Instant?): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the time, truncated to milliseconds, after which the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` should be removed.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getExpirationTime()` for more information.

| Parameters ||
|---|---|
| `expirationTime` | [Instant](https://developer.android.com/reference/kotlin/java/time/Instant.html#)?: This value may be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setName

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setName(name: String): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience` object's name.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getName()` for more information.

| Parameters ||
|---|---|
| `name` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html): This value cannot be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setPriority

Added in [API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 14](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setPriority(priority: Double): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the priority for this custom audience.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getPriority()` for further details.

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setTrustedBiddingData

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setTrustedBiddingData(trustedBiddingData: TrustedBiddingData?): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the trusted bidding data to be queried and used in the ad selection process.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getTrustedBiddingData()` for more information.

| Parameters ||
|---|---|
| `trustedBiddingData` | [TrustedBiddingData](https://developer.android.com/reference/kotlin/android/adservices/customaudience/TrustedBiddingData)?: This value may be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |

### setUserBiddingSignals

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Also in [Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Deprecated in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

```
fun setUserBiddingSignals(userBiddingSignals: AdSelectionSignals?): CustomAudience.Builder
```

**Deprecated:** *Deprecated in Java.*

Sets the user bidding signals used in the ad selection process.

See `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience#getUserBiddingSignals()` for more information.

| Parameters ||
|---|---|
| `userBiddingSignals` | [AdSelectionSignals](https://developer.android.com/reference/kotlin/android/adservices/common/AdSelectionSignals.html#)?: This value may be `null`. |

| Return ||
|---|---|
| `https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder#` | This value cannot be `null`. |