FrequencyCap

Einstellungen, über die gesteuert 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
}
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 andauert.

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 ist standardmäßig 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 in diesem Zeitraum dieselbe Anzeige präsentiert wird. Muss größer als 0 sein.

Erforderlich, wenn unlimited den Wert false hat.

TimeUnit

Mögliche Zeiteinheiten.

Enums
TIME_UNIT_UNSPECIFIED Der Wert der Zeiteinheit ist nicht angegeben oder in dieser Version unbekannt.
TIME_UNIT_LIFETIME Die Frequency Cap gilt für die gesamte Laufzeit der Werbebuchung.
TIME_UNIT_MONTHS Das Frequency Capping wird auf mehrere Monate angewendet.
TIME_UNIT_WEEKS Das Frequency Capping wird auf mehrere Wochen angewendet.
TIME_UNIT_DAYS Das Frequency Capping wird auf mehrere Tage angewendet.
TIME_UNIT_HOURS Das Frequency Capping wird auf eine Anzahl von Stunden angewendet.
TIME_UNIT_MINUTES Das Frequency Capping wird auf eine Anzahl von Minuten angewendet.