Ausführungsspezifikation

Die execution_spec einer Regel bestimmt die Handlung, die auf alle Objekte angewendet wird, die die Prüfung bestehen. Zeitplan- und Trigger-basierte Regeln unterstützen unterschiedliche Handlungen. Handlungen werden unter execution_type aufgeführt.

Ausführungsart	Beschreibung
`NOTIFICATION`	Sendet eine Benachrichtigung mit Symbol an dendie Erstellerin dieser Regel oder an die in `user_ids` angegebene Liste von Nutzerinnen, wenn diese Option festgelegt wurde. Unterstützte Prüfungsarten:*`SCHEDULE`, `TRIGGER`
`PAUSE`	Pausiert die Objekte. Unterstützte Prüfungsarten:`SCHEDULE`, `TRIGGER`
`UNPAUSE`	Hebt die Pausierung der Objekte auf. Unterstützte Prüfungsarten:`SCHEDULE`, `TRIGGER`
`CHANGE_BUDGET`	Ändert die Budgets auf Basis einer definierten `change_spec`. Dies gilt nur für Anzeigengruppen. Unterstützte Prüfungsarten:`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	Ändert die Budgets auf Basis einer definierten `change_spec`. Dies gilt nur für Anzeigenkampagnen. Unterstützte Prüfungsarten:`SCHEDULE`
`CHANGE_BID`	Ändert die Gebote auf Basis einer definierten `change_spec`. Dies gilt nur für Anzeigengruppen. Unterstützte Prüfungsarten:`SCHEDULE`
`ROTATE`	Pausiert die aktuell aktive Werbeanzeige und aktiviert die Werbeanzeige mit der nächsten ID in der Anzeigengruppe. Benötigt einen `id`-Filter von Anzeigengruppen und einen `entity_type`-Filter von einer Anzeige. Unterstützte Prüfungsarten:`SCHEDULE`
`REBALANCE_BUDGET`	Pausiert die Objekte, die die Prüfungskriterien erfüllen, und gleicht ihr Budget basierend auf einer definierten `rebalance_spec` mit den restlichen Objekten neu aus. Dies gilt nur für Anzeigengruppen. Unterstützte Prüfungsarten:`SCHEDULE`
`PING_ENDPOINT`	Sendet über Webhooks einen Ping an das Abonnement der App. Unter „Trigger-basierte Regeln“ findest du weitere Informationen zur Einrichtung. Unterstützte Prüfungsarten:`TRIGGER`

`execution_options`

Um einige dieser Handlungen auszuführen, musst du möglicherweise zusätzliche Informationen angeben. Die execution_spec stellt ein optionales execution_options-Array zur Verfügung, um diese weiteren Parameter angeben zu können. Das Array enthält eine Liste mit execution_option-Objekten, die Wörterbücher mit den Schlüsseln field, value und operator sind, genauso wie filter-Objekte der Prüfungsspezifikation.

Für Trigger-basierte Regeln sind keine Ausführungsoptionen erforderlich.

Unten findest du unterstützte Ausführungsoptionen und erfährst, welche execution_type-Werte sie unterstützen und wie sie zu strukturieren sind. Derzeit ist der einzige Operator, der für alle Optionen unterstützt wird, EQUAL.

Ausführungsoptionsfeld	Beschreibung
`user_ids`*	Empfängerinnen einer Benachrichtigung mit Symbol für `NOTIFICATION` oder Empfängerinnen von Zusammenfassungs-E-Mails für zeitplanbasierte Regeln für jeden `execution_type`. Unterstützte Ausführungsarten: JEDER `execution_type`, der von zeitplanbasierten Regeln unterstützt wird Wert (Beispiel):`array ([123, 456])`
`change_spec`	Gibt `amount`, `limit`, `unit` und `target_field` an. Als Wörterbuch für die unterstützten Arten erforderlich. Wenn `target_field` vorhanden ist, wird das Gebot oder Budget anhand des Unterschieds zwischen dem aktuellen Wert des Zielfelds und dem in `amount` angegebenen Zielwert skaliert. Das `target_field` muss ein gültiger Insights-Filter sein. Unterstützte Ausführungsarten:`CHANGE_BUDGET`, `CHANGE_BID` Wert (Beispiel):Beispiele für Werbeanzeigenregel – Änderungsspezifikation
`rebalance_spec`	Unterstützt verschiedene Optionen, die bestimmen, wie Budgets neu gewichtet werden. Nähere Informationen findest du im Beispiel. Unterstützte Ausführungsarten:`REBALANCE_BUDGET` Wert (Beispiel):Anzeigenregeln für die Neugewichtung des Budgets
`execution_count_limit`	Gibt an, wie oft eine Budget-/Gebotsänderung für jedes Werbeanzeigenobjekt aufgrund der Regel maximal ausgeführt wird. Wird nichts angegeben, gilt standardmäßig keine Beschränkung. Unterstützte Ausführungsarten:`CHANGE_BUDGET`, `CHANGE_BID` Wert (Beispiel): int (123)
`action_frequency`	Gibt die Mindestanzahl an Minuten an, nach der dieselbe Handlung für ein Objekt auf Grundlage einer Regel ausgeführt werden kann. Wenn der Wert beispielsweise `10080` für eine `CHANGE_BUDGET`-Regel ist und das Budget für Objekt A gerade durch diese Regel erhöht wurde, erhöht diese Regel das Budget für Objekt A mindestens eine Woche lang nicht, selbst wenn Objekt A die Regelprüfung während dieser Woche besteht. Unterstützte Ausführungsarten:`CHANGE_BUDGET`, `CHANGE_BID` Wert (Beispiel): int (123)

`user_ids`

Wenn für zeitplanbasierte Regelnuser_ids angegeben werden:

Wir generieren täglich eine E-Mail mit einer Zusammenfassung der von der Regel in den letzten 24 Stunden durchgeführten Handlungen.
Wir senden die Informationen an die unter user_ids aufgelisteten Nutzer*innen.
Die E-Mail wird unter Verwendung der Zeitzone des Werbekontos um 12.30 Uhr gesendet.

Diese Zusammenfassungs-E-Mail umfasst die Benachrichtigungen für alle Regeln, die die jeweiligen Nutzer*innen abonniert haben. Wenn keine der abonnierten Regeln eine Handlung ausführt, erhält der*die Nutzer*in keine E-Mail für diesen Tag.