FrequencyCap

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 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 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 in diesem Zeitraum dieselbe Anzeige präsentiert werden darf. 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, die ein Nutzer in diesem Zeitraum ausführen kann, bevor 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.