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

FrequencyCapEntry

AI-generated Key Takeaways

A frequency cap rule limits how many times an ad or set of ads can be shown to a user over a specific time period.
Each frequency cap has a unique key and a defined maximum number of events allowed within a given time range.

A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.

Fields

Fields
`key`	`FrequencyCapKey` The key of a particular frequency cap. There can be no more than one frequency cap with the same key.
`cap`	`int32` Maximum number of events allowed during the time range by this cap.

The key of a particular frequency cap. There can be no more than one frequency cap with the same key.

int32

Maximum number of events allowed during the time range by this cap.

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-08-07 UTC.