Ab dem 8. September 2025 muss für jede neue Werbebuchung angegeben werden, ob Werbung mit politischen Inhalten in der Europäischen Union (EU) ausgeliefert wird. Display & Video 360 API- und SDF-Uploads ohne entsprechende Erklärungen schlagen fehl. Weitere Informationen dazu, wie Sie Ihre Integration aktualisieren, um diese Erklärung abzugeben, finden Sie auf unserer Seite zur Einstellung.
Gibt an, ob unbegrenztes Frequency Capping angewendet wird. Wenn dieses Feld auf true gesetzt ist, können die verbleibenden Frequency Capping-Felder nicht angewendet werden.
Die Anzahl der timeUnit für das Frequency Capping.
Erforderlich, wenn unlimited den Wert false hat. Je nach Wert von timeUnit gelten die folgenden Einschränkungen:
TIME_UNIT_LIFETIME: Dieses Feld dient nur der Ausgabe und hat standardmäßig den Wert „1“.
TIME_UNIT_MONTHS – muss zwischen 1 und 2 liegen
TIME_UNIT_WEEKS – muss zwischen 1 und 4 liegen
TIME_UNIT_DAYS – muss zwischen 1 und 6 liegen
TIME_UNIT_HOURS – muss zwischen 1 und 23 liegen
TIME_UNIT_MINUTES – muss zwischen 1 und 59 liegen
maxImpressions
integer
Die maximale Häufigkeit, mit der einem Nutzer innerhalb dieses Zeitraums dieselbe Anzeige präsentiert wird. Muss größer als 0 sein.
Erforderlich, wenn unlimited den Wert false hat und maxViews nicht festgelegt ist.
maxViews
integer
Die maximale Häufigkeit, mit der ein Nutzer in diesem Zeitraum auf eine Anzeige klickt oder sie vollständig ansieht, bis sie für ihn nicht mehr ausgeliefert wird. Muss größer als 0 sein.
[null,null,["Zuletzt aktualisiert: 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. |"]]