Specifica di esecuzione

La execution_spec di una regola determina l'azione che si applica a tutti gli oggetti che superano la valutazione. Regole basate sul programma e Regole basate sull'attivazione supportano azioni diverse. Le azioni sono elencate sotto execution_type.

Tipo di esecuzione	Descrizione
`NOTIFICATION`	Invia una notifica mostrata nella barra superiore al creatore di questa regola o l'elenco degli utenti specificato in `user_ids`, se questa opzione è fornita. Tipi di valutazione supportati:`SCHEDULE`, `TRIGGER`
`PAUSE`	Mette in pausa gli oggetti. Tipi di valutazione supportati:`SCHEDULE`, `TRIGGER`
`UNPAUSE`	Riattiva gli oggetti. Tipi di valutazione supportati:`SCHEDULE`, `TRIGGER`
`CHANGE_BUDGET`	Cambia i budget in base a una `change_spec` definita. Vale solo per i gruppi di inserzioni. Tipi di valutazioni supportati:`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	Cambia i budget in base a una `change_spec` definita. Vale solo per le campagne pubblicitarie. Tipi di valutazioni supportati:`SCHEDULE`
`CHANGE_BID`	Cambia le offerte in base a una `change_spec` definita. Vale solo per i gruppi di inserzioni. Tipi di valutazioni supportati:`SCHEDULE`
`ROTATE`	Mette in pausa l'inserzione attualmente attiva e attiva l'inserzione successiva per ID nel gruppo di inserzioni. Richiede un filtro `id` di gruppi di inserzioni e un filtro `entity_type` di un'inserzione. Tipi di valutazioni supportati:`SCHEDULE`
`REBALANCE_BUDGET`	Mette in pausa gli oggetti che corrispondono ai criteri di valutazione e riequilibra i loro budget verso il resto in base a una `rebalance_spec` definita. Vale solo per i gruppi di inserzioni. Tipi di valutazioni supportati:`SCHEDULE`
`PING_ENDPOINT`	Invia un ping all'iscrizione dell'app tramite webhook. Consulta Regole basate sull'attivazione per maggiori dettagli sulla configurazione. Tipi di valutazioni supportati:`TRIGGER`

`execution_options`

Potresti dover fornire ulteriori informazioni per eseguire alcune di queste azioni. La execution_spec fornisce un array execution_options opzionale per specificare questi parametri aggiuntivi. L'array contiene una lista di oggetti execution_option, che sono dizionari con chiavi di field, value e operator proprio come gli oggetti filter della specifica di valutazione.

Per le Regole basate sull'attivazione non sono necessarie opzioni di esecuzione.

Di seguito sono riportate le opzioni di esecuzione, i valori execution_type supportati e come strutturarle. Attualmente, l'unico operatore supportato per tutte le opzioni è EQUAL.

Campo opzioni di esecuzione	Descrizione
`user_ids`*	Destinatari di notifiche nella barra superiore per `NOTIFICATION` o destinatari di e-mail riepilogative delle Regole basate sul programma per ogni `execution_type`. Tipi di esecuzione supportati: TUTTI I `execution_type` supportati dalle Regole basate sul programma Valore (esempio):`array ([123, 456])`
`change_spec`	Specifica `amount`, `limit`, `unit` e `target_field`. Obbligatorio come dizionario per i tipi supportati. Se esiste `target_field`, la scala di offerta o budget basata sulla differenza tra il valore corrente del campo target e il valore target specificato in `amount`. Il `target_field` deve essere un filtro di insight valido. Tipi di esecuzione supportati:`CHANGE_BUDGET`, `CHANGE_BID` Valore (esempio):Esempi della specifica di modifica delle regole delle inserzioni
`rebalance_spec`	Supporta diverse opzioni che determinano come vengono riequilibrati i budget. Consulta l'esempio per maggiori dettagli. Tipi di esecuzione supportati:`REBALANCE_BUDGET` Valore (esempio):Regole delle inserzioni con riequilibrio del budget
`execution_count_limit`	Specifica il numero massimo di volte in cui viene eseguita un'azione di modifica del budget/dell'offerta per ogni singolo oggetto pubblicitario per la regola. Se non è specificato, il valore predefinito non "nessun limite". Tipi di esecuzione supportati:`CHANGE_BUDGET`, `CHANGE_BID` Valore (esempio): int (123)
`action_frequency`	Specifica la quantità minima di minuti prima che la stessa azione possa essere eseguita su un oggetto mediante una regola. Ad esempio, se il valore è `10080` per una regola `CHANGE_BUDGET` e il budget è stato appena aumentato da quella regola per l'oggetto A. Questa norma non aumenta il budget per l'oggetto A per almeno una settimana, anche se l'oggetto A supera la valutazione della regola durante quella settimana. Tipi di esecuzione supportati:`CHANGE_BUDGET`, `CHANGE_BID` Valore (esempio): int (123)

`user_ids`

Se gli user_ids sono forniti per Regole basate sul programma:

generiamo un'e-mail giornaliera per riassumere le azioni eseguite dalla tua regola nelle ultime 24 ore;
inviamo le informazioni alla lista degli utenti specificati in user_ids;
l'e-mail viene inviata alle 00:30, usando il fuso orario dell'account pubblicitario.

Quest'e-mail riassuntiva aggrega le notifiche per tutte le regole a cui ogni utente è iscritto. Se nessuna azione viene eseguita da nessuna delle regole a cui è stata effettuata l'iscrizione, l'utente non riceve alcuna e-mail per quel giorno.