[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  
Summary: [Ctors](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#pubctors) \| [Methods](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#pubmethods) \| [Inherited Methods](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#inhmethods)  

# FrequencyCapFilters.Builder


`
public
static
final

class
FrequencyCapFilters.Builder
`


`

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


`

`


`

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

<br />

*** ** * ** ***

Builder for creating [FrequencyCapFilters](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters) objects.

## Summary

|                                                                 ### Public constructors                                                                 ||
|------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#Builder())`() ` |

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                ### Public methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ||
|-----------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[FrequencyCapFilters](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters)                 | ` `[build](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#build())`() ` Builds and returns a [FrequencyCapFilters](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters) instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ` `[FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | ` `[setKeyedFrequencyCapsForClickEvents](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForClickEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>))`(`[List](https://developer.android.com/reference/java/util/List)`<`[KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap)`> keyedFrequencyCapsForClickEvents) ` Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_CLICK](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_CLICK) event type.                          |
| ` `[FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | ` `[setKeyedFrequencyCapsForImpressionEvents](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForImpressionEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>))`(`[List](https://developer.android.com/reference/java/util/List)`<`[KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap)`> keyedFrequencyCapsForImpressionEvents) ` Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_IMPRESSION) event type. |
| ` `[FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | ` `[setKeyedFrequencyCapsForViewEvents](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForViewEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>))`(`[List](https://developer.android.com/reference/java/util/List)`<`[KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap)`> keyedFrequencyCapsForViewEvents) ` Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_VIEW](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_VIEW) event type.                               |
| ` `[FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | ` `[setKeyedFrequencyCapsForWinEvents](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder#setKeyedFrequencyCapsForWinEvents(java.util.List<android.adservices.common.KeyedFrequencyCap>))`(`[List](https://developer.android.com/reference/java/util/List)`<`[KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap)`> keyedFrequencyCapsForWinEvents) ` Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_WIN](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_WIN) event type.                                    |

| ### 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 Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public Builder ()
```

<br />

<br />

## Public methods

### build

[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public FrequencyCapFilters build ()
```

Builds and returns a [FrequencyCapFilters](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters) instance.

No more than 20 frequency cap filters may be associated with a single ad. If more
total filters than the limit have been set, an [IllegalArgumentException](https://developer.android.com/reference/java/lang/IllegalArgumentException) will be
thrown.

<br />

|                                                                                   Returns                                                                                   ||
|----------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| [FrequencyCapFilters](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters) | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForClickEvents

[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForClickEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForClickEvents)
```

Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_CLICK](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_CLICK) event type.

See [FrequencyCapFilters.getKeyedFrequencyCapsForClickEvents()](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForClickEvents()) for more information.

<br />

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

|                                                                                           Returns                                                                                           ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| [FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForImpressionEvents

[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForImpressionEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForImpressionEvents)
```

Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_IMPRESSION) event type.

See [FrequencyCapFilters.getKeyedFrequencyCapsForImpressionEvents()](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForImpressionEvents()) for more information.

<br />

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

|                                                                                           Returns                                                                                           ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| [FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForViewEvents

[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForViewEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForViewEvents)
```

Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_VIEW](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_VIEW) event type.

See [FrequencyCapFilters.getKeyedFrequencyCapsForViewEvents()](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForViewEvents()) for more information.

<br />

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

|                                                                                           Returns                                                                                           ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| [FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | This value cannot be `null`. <br /> |

### setKeyedFrequencyCapsForWinEvents

[**Added in Android UpsideDownCakePrivacySandbox**](https://developer.android.com/preview)  

```
public FrequencyCapFilters.Builder setKeyedFrequencyCapsForWinEvents (List<KeyedFrequencyCap> keyedFrequencyCapsForWinEvents)
```

Sets the list of [KeyedFrequencyCap](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/KeyedFrequencyCap) objects that will filter on the [FrequencyCapFilters.AD_EVENT_TYPE_WIN](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#AD_EVENT_TYPE_WIN) event type.

See [FrequencyCapFilters.getKeyedFrequencyCapsForWinEvents()](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters#getKeyedFrequencyCapsForWinEvents()) for more information.

<br />

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

|                                                                                           Returns                                                                                           ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| [FrequencyCapFilters.Builder](https://developer.android.com/design-for-safety/privacy-sandbox/reference/adservices/common/FrequencyCapFilters.Builder) | This value cannot be `null`. <br /> |