Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
FrequencyCapKey
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-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["A frequency cap uses a combination of level, event type, time unit, and time length as unique keys."],["The frequency cap limits the number of times an event (like an impression) can occur within a specific timeframe, defined by the time unit and time length."],["It's applied to all entities at the specified level, which could be an ad group or an ad group ad."],["Each frequency cap must have a unique key, preventing duplicates."]]],["Frequency caps are defined by a unique combination of key fields. The `level` field specifies where the cap is applied (e.g., ad group). The `event_type` indicates the type of event the cap restricts (e.g., impression). The `time_unit` defines the time increment (e.g., day) for the cap, and `time_length` is the number of those time units the cap spans. Each frequency cap must have a distinct set of these key fields.\n"]]
