FrequencyCap

Einstellungen, mit denen festgelegt wird, wie oft einem Nutzer in einem bestimmten Zeitraum dieselbe Anzeige präsentiert wird.

JSON-Darstellung
{
  "unlimited": boolean,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer,
  "maxImpressions": integer,
  "maxViews": integer
}
Felder
unlimited

boolean

Gibt an, ob unbegrenztes Frequency Capping angewendet wird. Wenn dieses Feld auf true gesetzt ist, sind die verbleibenden Felder für das Frequency Capping nicht anwendbar.

timeUnit

enum (TimeUnit)

Die Zeiteinheit, in der das Frequency Capping angewendet wird.

Erforderlich, wenn unlimited den Wert false hat.

timeUnitCount

integer

Die Anzahl der timeUnit, die das Frequency Capping angewendet wird.

Erforderlich, wenn unlimited den Wert false hat. Die folgenden Einschränkungen gelten basierend auf dem Wert von timeUnit:

  • TIME_UNIT_LIFETIME: Dieses Feld wird nur ausgegeben und hat den Standardwert 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

Maximale Häufigkeit, mit der einem Nutzer in diesem Zeitraum 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 eine Anzeige in diesem Zeitraum anklicken oder sie vollständig ansehen kann, bis sie nicht mehr für ihn ausgeliefert wird. Muss größer als 0 sein.

Gilt nur für YouTube- und Partner-Ressourcen.

Erforderlich, wenn unlimited den Wert false hat und maxImpressions nicht festgelegt ist.