FrequencyCap

Einstellungen, mit denen gesteuert wird, wie oft dieselbe Anzeige innerhalb eines bestimmten Zeitraums für einen Nutzer eingeblendet 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, können die verbleibenden Frequency Capping-Felder nicht angewendet werden.
timeUnit

enum (TimeUnit)

Die Zeiteinheit, auf die die Frequency Cap angewendet wird.

Erforderlich, wenn unlimited den Wert false hat.
timeUnitCount

integer

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 wird nur für die Ausgabe verwendet und ist standardmäßig auf 1 festgelegt.
  • 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.

TimeUnit

Mögliche Zeiteinheiten.

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