FrequencyCap

Paramètres qui déterminent 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
}
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 de validité 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 généré qu'en sortie 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ù 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.

TimeUnit

Unités de temps possibles.

Enums
TIME_UNIT_UNSPECIFIED La valeur d'unité de temps n'est pas spécifiée ou est inconnue dans cette version.
TIME_UNIT_LIFETIME La limite de la fréquence d'exposition sera appliquée pendant toute la durée de vie de l'élément de campagne.
TIME_UNIT_MONTHS La limite de la fréquence d'exposition sera appliquée à un nombre de mois.
TIME_UNIT_WEEKS La limite de la fréquence d'exposition sera appliquée à un certain nombre de semaines.
TIME_UNIT_DAYS La limite de la fréquence d'exposition est appliquée à un nombre de jours.
TIME_UNIT_HOURS La limite de la fréquence d'exposition sera appliquée à un nombre d'heures.
TIME_UNIT_MINUTES La limite de la fréquence d'exposition est appliquée à un nombre de minutes.