FrequencyCap

As 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,
  "maxViews": integer
}
Campos
unlimited

boolean

Define se é aplicado um limite de frequência ilimitado. Quando este 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 vai durar.

Obrigatório quando unlimited for false. As seguintes restrições são aplicadas com base no valor de timeUnit:

  • TIME_UNIT_LIFETIME: este campo é apenas para saída e assume 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 for false e maxViews não estiver definido.

maxViews

integer

O número máximo de vezes que um usuário pode clicar ou visualizar completamente um anúncio durante esse período até que ele deixe de ser exibido para ele. Precisa ser maior que 0.

Aplicável apenas aos recursos do YouTube e parceiros.

Obrigatório quando unlimited for false e maxImpressions não estiver definido.