FrequencyCap

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

Representação JSON
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": 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 é 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: esse campo é somente de saída e vai ser definido como 1 por padrão.
  • 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 é false e maxViews não está definido.

maxViews

integer

Opcional. É o número máximo de vezes que um usuário pode clicar ou visualizar um anúncio durante esse período até que ele não seja mais veiculado. Precisa ser maior que 0.

Aplicável apenas aos recursos do YouTube e dos parceiros.

Obrigatório quando unlimited é false e maxImpressions não está definido.