To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

FrequencyCap

AI-generated Key Takeaways

Frequency caps limit how often an ad is shown to a user within a specific timeframe.
The number of impressions is a required field for setting a frequency cap.
The time unit (e.g., daily, weekly) is also a required field for defining the frequency cap period.

A rule specifying the maximum number of times an ad can be shown to a user over a particular time period.

Fields

Fields
`impressions`	`int32` Required. The number of impressions, inclusive.
`time_unit`	`FrequencyCapTimeUnit` Required. The type of time unit.

int32

Required. The number of impressions, inclusive.

Required. The type of time unit.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-10 UTC.