# CustomAudience.Builder

Added in[API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  
Summary:[Ctors](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder#pubctors)\|[Methods](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder#inhmethods)  

# CustomAudience.Builder

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/adservices/customaudience/CustomAudience.Builder "View this page in Kotlin")\|Java

`
public
static
final

class
CustomAudience.Builder
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|----------------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.adservices.customaudience.CustomAudience.Builder |

<br />

*** ** * ** ***

Builder for[CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience)objects.

## Summary

|                                                     ### Public constructors                                                      ||
|-------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder#Builder())`() ` |

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

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in[Ad Services Extensions 4](https://developer.android.com/sdkExtensions)  

```
public Builder ()
```

<br />

<br />

## Public methods

### build

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

```
public CustomAudience build ()
```

Builds an instance of a[CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience).

<br />

|                                                                    Returns                                                                     ||
|------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience) | This value cannot be`null`. <br /> |

|                                                                            Throws                                                                             ||
|--------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| [NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException)         | if any non-null parameter is null                     |
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if the expiration time occurs before activation time  |
| [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) | if the expiration time is set before the current time |

### setActivationTime

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

```
public CustomAudience.Builder setActivationTime (Instant activationTime)
```

Sets the time, truncated to milliseconds, after which the[CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience)will serve ads.

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

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

<br />

|                          Parameters                          ||
|------------------|--------------------------------------------|
| `activationTime` | `Instant`: This value may be`null`. <br /> |

|                                                              Returns                                                               ||
|----------------------------------------------------------------------------------------------------------------------------|--------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | <br /> |

### setAds

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

```
public CustomAudience.Builder setAds (List<AdData> ads)
```

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

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

<br />

|                   Parameters                   ||
|-------|-----------------------------------------|
| `ads` | `List`: This value may be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setAuctionServerRequestFlags

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

```
public CustomAudience.Builder setAuctionServerRequestFlags (int auctionServerRequestFlags)
```

Sets the bitfield of auction server request flags.

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

<br />

|                                                                                                                                                                           Parameters                                                                                                                                                                           ||
|-----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `auctionServerRequestFlags` | `int`: Value is either`0`or a combination of android.adservices.customaudience.CustomAudience.FLAG_AUCTION_SERVER_REQUEST_DEFAULT, and[CustomAudience.FLAG_AUCTION_SERVER_REQUEST_OMIT_ADS](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience#FLAG_AUCTION_SERVER_REQUEST_OMIT_ADS) <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setBiddingLogicUri

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

```
public CustomAudience.Builder setBiddingLogicUri (Uri biddingLogicUri)
```

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

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

<br />

|                          Parameters                          ||
|-------------------|-------------------------------------------|
| `biddingLogicUri` | `Uri`: This value cannot be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setBuyer

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

```
public CustomAudience.Builder setBuyer (AdTechIdentifier buyer)
```

Sets the buyer[AdTechIdentifier](https://developer.android.com/reference/android/adservices/common/AdTechIdentifier).

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

<br />

|                           Parameters                            ||
|---------|--------------------------------------------------------|
| `buyer` | `AdTechIdentifier`: This value cannot be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setComponentAds

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

```
public CustomAudience.Builder setComponentAds (List<ComponentAdData> componentAds)
```

Sets the components ads served by the custom audience.

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

<br />

|                         Parameters                         ||
|----------------|--------------------------------------------|
| `componentAds` | `List`: This value cannot be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setDailyUpdateUri

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

```
public CustomAudience.Builder setDailyUpdateUri (Uri dailyUpdateUri)
```

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

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

<br />

|                         Parameters                          ||
|------------------|-------------------------------------------|
| `dailyUpdateUri` | `Uri`: This value cannot be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setExpirationTime

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

```
public CustomAudience.Builder setExpirationTime (Instant expirationTime)
```

Sets the time, truncated to milliseconds, after which the[CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience)should be removed.

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

<br />

|                          Parameters                          ||
|------------------|--------------------------------------------|
| `expirationTime` | `Instant`: This value may be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setName

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

```
public CustomAudience.Builder setName (String name)
```

Sets the[CustomAudience](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience)object's name.

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

<br />

|                      Parameters                      ||
|--------|----------------------------------------------|
| `name` | `String`: This value cannot be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setPriority

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

```
public CustomAudience.Builder setPriority (double priority)
```

Sets the priority for this custom audience.

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

<br />

|         Parameters          ||
|------------|-----------------|
| `priority` | `double` <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setTrustedBiddingData

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

```
public CustomAudience.Builder setTrustedBiddingData (TrustedBiddingData trustedBiddingData)
```

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

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

<br />

|                                 Parameters                                  ||
|----------------------|-------------------------------------------------------|
| `trustedBiddingData` | `TrustedBiddingData`: This value may be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |

### setUserBiddingSignals

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

```
public CustomAudience.Builder setUserBiddingSignals (AdSelectionSignals userBiddingSignals)
```

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

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

<br />

|                                 Parameters                                  ||
|----------------------|-------------------------------------------------------|
| `userBiddingSignals` | `AdSelectionSignals`: This value may be`null`. <br /> |

|                                                                            Returns                                                                             ||
|----------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [CustomAudience.Builder](https://developer.android.com/reference/android/adservices/customaudience/CustomAudience.Builder) | This value cannot be`null`. <br /> |