FrequencyCap

As configurações que controlam o número de vezes que um usuário pode ver o mesmo anúncio em um determinado período.

Representação JSON 
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer
}
Campos
unlimited

boolean

Define se o limite de frequência ilimitado é aplicado. Quando esse campo é definido como true, os campos de limite de frequência restantes não são aplicáveis.
timeUnit

enum (TimeUnit)

A unidade de tempo na qual o limite de frequência será aplicado.

Obrigatório quando unlimited é false.
timeUnitCount

integer

O número de timeUnit que o limite de frequência durará.

Obrigatório quando unlimited é false. As restrições a seguir se aplicam com base no valor de timeUnit:

  • TIME_UNIT_LIFETIME: este campo é somente para saída, e o padrão é 1.
  • TIME_UNIT_MONTHS: precisa estar entre 1 e 2
  • TIME_UNIT_WEEKS: precisa estar entre 1 e 4
  • TIME_UNIT_DAYS: precisa estar entre 1 e 6
  • TIME_UNIT_HOURS: precisa estar entre 1 e 23
  • TIME_UNIT_MINUTES: precisa estar entre 1 e 59
maxImpressions

integer

O número máximo de vezes que o mesmo anúncio pode ser exibido a um usuário durante esse período. Precisa ser maior que 0.

Obrigatório quando unlimited é false.

TimeUnit

Unidades de tempo possíveis.

Enums
TIME_UNIT_UNSPECIFIED O valor da unidade de tempo não é especificado ou é desconhecido nesta versão.
TIME_UNIT_LIFETIME O limite de frequência será aplicado a toda a vida útil do item de linha.
TIME_UNIT_MONTHS O limite de frequência será aplicado a vários meses.
TIME_UNIT_WEEKS O limite de frequência será aplicado a um determinado número de semanas.
TIME_UNIT_DAYS O limite de frequência será aplicado a alguns dias.
TIME_UNIT_HOURS O limite de frequência será aplicado a um número de horas.
TIME_UNIT_MINUTES O limite de frequência será aplicado a alguns minutos.