FrequencyCap

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
}
Campi
unlimited

boolean

Indica se viene applicata una quota limite illimitata. Se 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 che durerà la quota limite.

Obbligatorio quando unlimited è false. In base al valore dell'attributo timeUnit, si applicano le seguenti limitazioni:

  • TIME_UNIT_LIFETIME: questo campo viene generato solo dall'output e il valore predefinito sarà 1.
  • 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 un utente può visualizzare lo stesso annuncio durante questo periodo. Deve essere maggiore di 0.

Obbligatorio quando unlimited è false.

TimeUnit

Possibili unità di tempo.

Enum
TIME_UNIT_UNSPECIFIED Il valore dell'unità di tempo non è specificato o è sconosciuto in questa versione.
TIME_UNIT_LIFETIME La quota limite verrà applicata all'intera durata dell'elemento pubblicitario.
TIME_UNIT_MONTHS La quota limite verrà applicata a un determinato numero di mesi.
TIME_UNIT_WEEKS La quota limite verrà applicata a un determinato numero di settimane.
TIME_UNIT_DAYS La quota limite verrà applicata a un determinato numero di giorni.
TIME_UNIT_HOURS La quota limite verrà applicata a un determinato numero di ore.
TIME_UNIT_MINUTES La quota limite verrà applicata a un determinato numero di minuti.