À partir du
8 septembre 2025, chaque nouvelle ligne devra indiquer si elle diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et les appels à l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour savoir comment mettre à jour votre intégration afin d'effectuer cette déclaration, consultez notre
page sur les abandons de compatibilité.
FrequencyCap
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 une limite de 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_MONTHS : doit être défini sur 1
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 false et que maxImpressions n'est pas défini.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# FrequencyCap\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v4/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v4/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v4/FrequencyCap#FIELDS.max_impressions) is not set. |"]]