FrequencyCap

Configurações que controlam o número de vezes que o mesmo anúncio pode ser exibido a um usuário durante determinado período.

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

boolean

Indica 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 em que o limite de frequência será aplicado.

Obrigatório quando unlimited for false.

timeUnitCount

integer

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

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

  • TIME_UNIT_LIFETIME: este campo é apenas de 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 mostrado a um usuário durante esse período. Precisa ser maior que 0.

Obrigatório quando unlimited for false.

TimeUnit

Possíveis unidades de tempo.

Enums
TIME_UNIT_UNSPECIFIED O valor da unidade de tempo não foi especificado ou é desconhecido nesta versão.
TIME_UNIT_LIFETIME O limite de frequência será aplicado a todo o período da vida útil do item de linha.
TIME_UNIT_MONTHS O limite de frequência será aplicado a um determinado número de meses.
TIME_UNIT_WEEKS O limite de frequência será aplicado a algumas semanas.
TIME_UNIT_DAYS O limite de frequência será aplicado a um número de 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.