FrequencyCap

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

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

boolean

Se o limite de frequência ilimitado é aplicado. Quando esse campo é definido como true, os demais campos de limite de frequência não são relevantes.

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 vai durar.

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

  • TIME_UNIT_MONTHS: precisa ser 1
  • TIME_UNIT_WEEKS: precisa ser entre 1 e 4
  • TIME_UNIT_DAYS: precisa ser entre 1 e 6
  • TIME_UNIT_HOURS: precisa ser entre 1 e 23
  • TIME_UNIT_MINUTES: precisa ser entre 1 e 59
maxImpressions

integer

É o número máximo de vezes que um usuário pode ver o mesmo anúncio 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 assistir um anúncio por completo durante esse período até que ele não seja mais veiculado para essa pessoa. Precisa ser maior que 0.

Aplicável apenas aos recursos do YouTube e parceiros.

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