A partir del 8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Indica si se aplica o no una limitación de frecuencia ilimitada. Cuando este campo se establece en true, los campos de limitación de frecuencia restantes no son aplicables.
La cantidad de timeUnit que durará la limitación de frecuencia.
Obligatorio cuando unlimited es false. Se aplican las siguientes restricciones según el valor de timeUnit:
TIME_UNIT_LIFETIME: Este campo es solo de salida y tendrá el valor predeterminado de 1.
TIME_UNIT_MONTHS: Debe estar entre 1 y 2.
TIME_UNIT_WEEKS: Debe estar entre 1 y 4.
TIME_UNIT_DAYS: Debe estar entre 1 y 6.
TIME_UNIT_HOURS: Debe estar entre 1 y 23.
TIME_UNIT_MINUTES: Debe estar entre 1 y 59.
maxImpressions
integer
Es la cantidad máxima de veces que se puede mostrar el mismo anuncio a un usuario durante este período. Debe ser mayor que 0.
Es obligatorio cuando unlimited es false y no se configura maxViews.
maxViews
integer
Es la cantidad máxima de veces que un usuario puede hacer clic en un anuncio o verlo por completo durante este período hasta que ya no se le muestre. Debe ser mayor que 0.
Solo se aplica a los recursos de YouTube y Partners.
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eFrequencyCap settings manage how often a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings offer control over impressions and views to optimize ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eYou can limit ad exposure using time units like days, hours, or even set it as unlimited.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003emaxImpressions\u003c/code\u003e defines the maximum times a user sees an ad, while \u003ccode\u003emaxViews\u003c/code\u003e focuses on clicks or full views.\u003c/p\u003e\n"],["\u003cp\u003eSpecific restrictions and requirements apply depending on the chosen time unit and whether unlimited frequency is enabled.\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\n\n| Display \\& Video 360 API v2 has sunset.\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/v2/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/v2/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_LIFETIME` - this field is output only and will default to 1 - `TIME_UNIT_MONTHS` - must be between 1 and 2 - `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/v2/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` 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/v2/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.max_impressions) is not set. |"]]
