FrequencyCap

Paramètres qui déterminent le nombre de fois où la 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 une limitation de la fréquence d'exposition illimitée est appliquée. Lorsque ce champ est défini sur true, les champs restants de la limite de la fréquence d'exposition ne sont pas applicables.

timeUnit

enum (TimeUnit)

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

Obligatoire lorsque unlimited est défini sur false.

timeUnitCount

integer

Nombre de "timeUnit" que la limite de la fréquence d'exposition durera.

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 est généré en sortie uniquement et sa valeur par défaut est 1.
  • TIME_UNIT_MONTHS : la valeur doit être comprise entre 1 et 2
  • TIME_UNIT_WEEKS : la valeur doit être comprise entre 1 et 4
  • TIME_UNIT_DAYS : la valeur doit être comprise entre 1 et 6
  • TIME_UNIT_HOURS : la valeur doit être comprise entre 1 et 23
  • TIME_UNIT_MINUTES : la valeur doit être comprise entre 1 et 59
maxImpressions

integer

Nombre maximal de fois qu'une même annonce peut être diffusée auprès d'un utilisateur pendant 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 qu'un utilisateur peut cliquer sur une annonce ou la voir entièrement pendant cette période jusqu'à ce qu'elle ne lui soit plus diffusée. Doit être supérieur à 0.

S'applique uniquement aux ressources YouTube et Partenaires.

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