FrequencyCap

Paramètres permettant de contrôler le nombre de fois qu'une même annonce peut être diffusée auprès d'un utilisateur au cours d'une période donnée.

Représentation JSON
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
Champs
unlimited

boolean

Indique si la limitation de la fréquence d'exposition illimitée est appliquée. Lorsque ce champ est défini sur true, les autres champs de limite de la fréquence d'exposition ne sont pas applicables.

timeUnit

enum (TimeUnit)

Unité de temps dans laquelle la limite de la fréquence d'exposition sera appliquée.

Obligatoire lorsque unlimited est défini sur false.

timeUnitCount

integer

Durée totale de la limite de la fréquence d'exposition (timeUnit).

Obligatoire lorsque unlimited est défini sur false. Les restrictions suivantes s'appliquent en fonction de la valeur de timeUnit:

  • TIME_UNIT_LIFETIME : ce champ n'est fourni qu'en sortie et prend la valeur par défaut 1.
  • TIME_UNIT_MONTHS : doit être compris entre 1 et 2
  • TIME_UNIT_WEEKS : doit être compris entre 1 et 4
  • TIME_UNIT_DAYS : doit être compris entre 1 et 6
  • TIME_UNIT_HOURS : doit être compris entre 1 et 23
  • TIME_UNIT_MINUTES - doit être compris entre 1 et 59
maxImpressions

integer

Nombre maximal de fois qu'une même annonce peut être diffusée auprès d'un utilisateur au cours de cette période. Doit être supérieur à 0.

Obligatoire lorsque unlimited est défini sur false et que maxViews n'est pas défini.

maxViews

integer

Nombre maximal de fois où un utilisateur peut cliquer sur une annonce ou la visionner dans son intégralité au cours de cette période, jusqu'à ce qu'elle ne lui soit plus diffusée. Doit être supérieur à 0.

Cela ne s'applique qu'aux ressources YouTube et partenaires.

Obligatoire lorsque unlimited est défini sur false et que maxImpressions n'est pas défini.