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.
FrequencyCap
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Einstellungen, mit denen festgelegt wird, wie oft einem Nutzer innerhalb eines bestimmten Zeitraums dieselbe Anzeige präsentiert werden darf.
JSON-Darstellung |
{
"unlimited": boolean,
"timeUnit": enum (TimeUnit ),
"timeUnitCount": integer,
"maxImpressions": integer,
"maxViews": integer
} |
Felder |
unlimited |
boolean
Gibt an, ob ein unbegrenztes Frequency Capping angewendet wird. Wenn dieses Feld auf true festgelegt ist, sind die übrigen Felder für das Frequency Capping nicht relevant.
|
timeUnit |
enum (TimeUnit )
Die Zeiteinheit, in der das Frequency Capping angewendet wird. Erforderlich, wenn unlimited false ist.
|
timeUnitCount |
integer
Die Anzahl der timeUnit , für die das Frequency Capping aktiv sein soll. Erforderlich, wenn unlimited false ist. Je nach Wert von timeUnit gelten die folgenden Einschränkungen:
TIME_UNIT_MONTHS – muss „1“ sein
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 ein Nutzer in diesem Zeitraum dieselbe Anzeige sehen kann. Muss größer als 0 sein. Erforderlich, wenn unlimited = false und maxViews nicht festgelegt ist.
|
maxViews |
integer
Optional. Die maximale Anzahl von Klicks oder vollständigen Aufrufen einer Anzeige durch einen Nutzer in diesem Zeitraum, bis sie nicht mehr für ihn ausgeliefert wird. Muss größer als 0 sein. Gilt nur für YouTube- und Partnerressourcen. Erforderlich, wenn unlimited = false und maxImpressions nicht festgelegt ist.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]