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,
  "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 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 é false e maxViews não está definido.

maxViews

integer

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

Aplicável somente aos recursos do YouTube e de parceiros.

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