A partire dall'
8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra
pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
FrequencyCap
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Impostazioni che controllano il numero di volte in cui un utente può visualizzare lo stesso annuncio in un determinato periodo di tempo.
| Rappresentazione JSON |
{
"unlimited": boolean,
"timeUnit": enum (TimeUnit),
"timeUnitCount": integer,
"maxImpressions": integer,
"maxViews": integer
} |
| Campi |
unlimited |
boolean
Indica se viene applicata una quota limite illimitata. Quando questo campo è impostato su true, i restanti campi della quota limite non sono applicabili.
|
timeUnit |
enum (TimeUnit)
L'unità di tempo in cui verrà applicata la quota limite. Obbligatorio quando unlimited è false.
|
timeUnitCount |
integer
Il numero di timeUnit per cui sarà valida la quota limite. Obbligatorio quando unlimited è false. Si applicano le seguenti limitazioni in base al valore di timeUnit:
TIME_UNIT_MONTHS: deve essere 1TIME_UNIT_WEEKS: deve essere compreso tra 1 e 4TIME_UNIT_DAYS: deve essere compreso tra 1 e 6TIME_UNIT_HOURS: deve essere compreso tra 1 e 23TIME_UNIT_MINUTES: deve essere compreso tra 1 e 59
|
maxImpressions |
integer
Il numero massimo di volte in cui un utente può visualizzare lo stesso annuncio durante questo periodo. Deve essere maggiore di 0. Obbligatorio quando unlimited è false e maxViews non è impostato.
|
maxViews |
integer
Facoltativo. Il numero massimo di volte in cui un utente può fare clic su un annuncio o visualizzarlo completamente durante questo periodo fino a quando non viene più pubblicato per quell'utente. Deve essere maggiore di 0. Il problema riguarda solo le risorse di YouTube e dei partner. Obbligatorio quando unlimited è false e maxImpressions non è impostato.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# FrequencyCap\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v4/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v4/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_impressions) is not set. |"]]
