FrequencyCap

As configurações que controlam o número de vezes que um usuário pode ser exibido com 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

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 é false. As restrições a seguir se aplicam com base no valor de timeUnit:

  • TIME_UNIT_LIFETIME: este campo é somente saída e será padronizado como 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 é false e maxViews não está definido.

maxViews

integer

É o número máximo de vezes que um usuário pode clicar ou visualizar um anúncio por completo durante esse período até que ele deixe de ser veiculado. 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.