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,
  "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, auf die die Frequency Cap angewendet wird.

Erforderlich, wenn unlimited den Wert false hat.

timeUnitCount

integer

Die Anzahl der timeUnit, für die das Frequency Capping aktiv sein soll.

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

Optional. 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.

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

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