FrequencyCap

Impostazioni che controllano il numero di volte in cui un utente può essere visualizzato con 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. Se questo campo è impostato su true, gli altri 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 che durerà la quota limite.

Obbligatorio quando unlimited è false. In base al valore di timeUnit si applicano le seguenti limitazioni:

  • TIME_UNIT_LIFETIME: questo campo è solo di output e verrà impostato su 1 per impostazione predefinita
  • TIME_UNIT_MONTHS - deve essere compreso tra 1 e 2
  • TIME_UNIT_WEEKS - deve essere compreso tra 1 e 4
  • TIME_UNIT_DAYS - deve essere compreso tra 1 e 6
  • TIME_UNIT_HOURS - deve essere compreso tra 1 e 23
  • TIME_UNIT_MINUTES - deve essere compreso tra 1 e 59
maxImpressions

integer

Il numero massimo di volte in cui è possibile mostrare lo stesso annuncio a un utente durante questo periodo. Deve essere maggiore di 0.

Obbligatorio quando unlimited è false e maxViews non è impostato.

maxViews

integer

Numero massimo di volte in cui un utente può eseguire il clickthrough o visualizzare per intero un annuncio durante questo periodo fino a quando non viene più pubblicato. Deve essere maggiore di 0.

Valido solo per le risorse di YouTube e partner.

Obbligatorio quando unlimited è false e maxImpressions non è impostato.