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

FrequencyCapKey

AI-generated Key Takeaways

Frequency cap keys are a group of fields used for frequency caps, with no more than one frequency cap allowed per key.
The key includes fields for the cap's level, the event type it applies to, the time unit, and the duration in time units.

A group of fields used as keys for a frequency cap. There can be no more than one frequency cap with the same key.

Fields
`level`	`FrequencyCapLevel` The level on which the cap is to be applied (for example, ad group ad, ad group). The cap is applied to all the entities of this level.
`event_type`	`FrequencyCapEventType` The type of event that the cap applies to (for example, impression).
`time_unit`	`FrequencyCapTimeUnit` Unit of time the cap is defined at (for example, day, week).
`time_length`	`int32` Number of time units the cap lasts.

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.