FrequencyCap

Paramètres qui contrôlent le nombre de fois où une même annonce peut être diffusée auprès d'un utilisateur pendant 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 s'appliquent pas.
timeUnit

enum (TimeUnit)

Unité de temps pendant laquelle la limite de la fréquence d'exposition s'applique.

Obligatoire lorsque unlimited est false.
timeUnitCount

integer

Nombre de timeUnit pendant lequel la limite de la fréquence d'exposition s'applique.

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

  • TIME_UNIT_LIFETIME : ce champ est de sortie uniquement et sa valeur par défaut est 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 où un utilisateur peut voir une même annonce au cours de cette période. Doit être supérieur à 0.

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

integer

Facultatif. Nombre maximal de fois où un utilisateur peut cliquer sur une annonce ou la voir entièrement au cours de cette période jusqu'à ce qu'elle ne lui soit plus diffusée. Doit être supérieur à 0.

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.