Specifica di valutazione

Lo scopo principale della evaluation_spec di una regola è determinare gli oggetti su cui la regola dovrebbe eseguire la sua azione. L'evaluation_type determina il tipo di metodo di valutazione e ha le seguenti opzioni:

L'evaluation_spec contiene un array filters, che consente di restringere ulteriormente la lista di oggetti corrispondenti. Ad esempio, puoi costruire filtri sui metadati di inserzioni, gruppi di inserzioni e campagne pubblicitarie e sulle metriche di insight. Tutti i filtri sono valutati insieme usando l'operatore AND.

L'array filters contiene una lista di oggetti del filtro. Questi oggetti sono dizionari con chiavi di field, value e operator:

Ogni filtro ha una lista di operatori logici supportati. Di seguito sono riportati gli operatori logici supportati nelle regole SCHEDULE e TRIGGER:

L'evaluation_spec richiede un trigger per il tipo di valutazione TRIGGER. L'attivazione contiene un tipo e una specifica di filtro sottostante. La specifica del filtro può essere field, value e operator.

L'attivazione determina dinamicamente se dobbiamo valutare o meno una regola e puoi averne solo una. Consulta Regole basate sull'attivazione per maggiori dettagli.

Di seguito sono definiti alcuni filtri speciali e gruppi generali di filtri che puoi usare.

Filtri speciali

time_preset

Il filtro time_preset determina il periodo di tempo durante il quale aggreghiamo le metriche di insight. Al momento, consentiamo solo un time_preset. Si applica a tutti i filtri delle statistiche nella regola, compreso quello usato per l'attivazione, se presente.

L'unico operatore supportato per time_preset è EQUAL ed è obbligatorio se è presente qualsiasi filtro di insight o attivazione. Le regole basate sull'attivazione supportano solo i valori temporali predefiniti che includono TODAY, perché questa esegue una valutazione in tempo reale.

I valori temporali predefiniti per le regole possono comportarsi in modo diverso dalle altre interfacce. Alcuni dei valori temporali predefiniti qui includono i dati odierni. Questo perché tali dati sono fondamentali per le regole che vengono eseguite più spesso di una volta al giorno. Per altre interfacce, un valore predefinito di LAST_N_DAYS generalmente non include i dati odierni. Consulta le descrizioni seguenti per maggiori dettagli.

{
  "field": "time_preset",
  "value": "TODAY",
  "operator": "EQUAL"
}

attribution_window

Il filtro attribution_window determina la finestra di registrazione su cui sono aggregate le metriche degli insight. Per maggiori informazioni, consulta la documentazione di Insights sulle finestre di attribuzione.

Attualmente, consentiamo solo una attribution_window, applicata a tutti i filtri delle statistiche nella regola. L'unico operatore supportato per attribution_window è EQUAL ed è supportato solo da regole basate sulla programmazione.

Che sia specificato o meno, l'unico value consentito per la attribution_window è ACCOUNT_DEFAULT.

{
  "field": "attribution_window",
  "value": "ACCOUNT_DEFAULT",
  "operator": "EQUAL"
}

Filtri dei metadati

Con i filtri dei metadati, puoi filtrare gli oggetti in base allo stato attuale dei loro campi metadati. Questi supportano anche il filtro multilivello, il che significa che puoi usare i prefissi per applicare un filtro dei metadati sull'elemento genitore o nonno di un oggetto. Questa operazione non interessa altri filtri. I filtri degli insight continuano a essere applicati all'oggetto normale.

Ad esempio, se vuoi una regola che si applichi ai gruppi di inserzioni di campagne pubblicitarie il cui obiettivo è WEBSITE_CLICKS, puoi includere due filtri:

 "filters" : [
  {
    "field": "entity_type",
    "value": "ADSET",
    "operator": "EQUAL",
  },
  {
    "field": "campaign.objective",
    "value": "WEBSITE_CLICKS",
    "operator": "EQUAL"
  }
]

Filtri dei metadati supportati dalle regole basate su attivazione e programmazione

Filtri dei metadati supportati solo dalle regole basate sulla programmazione

entity_type e id

Per ogni regola del tipo di valutazione SCHEDULE o TRIGGER, devi specificare un filtro entity_type o id.

Quando specifichi un filtro entity_type, determini un livello di oggetto dinamico per cui applicare la regola. Ad esempio, se entity_type è AD, tale regola valuta automaticamente ogni nuova inserzione aggiunta all'account pubblicitario. Ciò avviene indipendentemente da quando crei la regola. Specificando un filtro id, la regola si applica solo ad una lista statica di oggetti.

Quando specifichi un filtro idsenza prefisso, calcoliamo automaticamente il livello dell'oggetto per il quale applicare la regola. Ad esempio, se vuoi applicare una regola alle inserzioni [123, 456], hai bisogno di un un soloid campo filtro, del valore [123, 456] e dell'operatore IN. In questo caso, entity_type non è necessario, poiché hai fornito una lista statica iniziale di oggetti e possiamo calcolare il livello dell'oggetto da questi oggetti.

Puoi usare entity_type e id in combinazione con il filtro multilivello. Ad esempio, se vuoi una regola che si applichi a tutte le inserzioni in alcuni gruppi di inserzioni specificati, puoi avere un filtro entity_type di AD e un filtro adset.id con i gruppi di inserzioni specificati.

Per impostazione predefinita, se non specifichi un filtro effective_status, viene aggiunto implicitamente un filtro effective_status al momento della valutazione della regola.

Per tutti i tipi di esecuzione che agiscono su oggetti attivi, questo filtro predefinito ha l'operatore IN e il valore ['ACTIVE', 'PENDING_REVIEW']. Ciò significa che la regola valuta solo gli oggetti che hanno o avranno una pubblicazione attiva. Per i tipi di esecuzione che non agiscono su oggetti attivi (UNPAUSE), viene aggiunto questo filtro con operatore NOT_IN e valore ['DELETED', 'ARCHIVED']. Il filtro predefinito è un'ottimizzazione interna per i nostri tipi di esecuzione.

Filtri di insight

Valutiamo i filtri di insight rispetto ai valori correnti restituiti dall'API Insights per un dato time_preset. Questi filtri si applicano direttamente alla lista o al livello degli oggetti e non supportano il filtro multilivello. Tutti i filtri di insight supportano gli operatori seguenti: GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE.

Per una descrizione di ognuno dei campi sottostanti, consulta Documentazione dell'API Insights. Tutti questi filtri sono supportati da regole basate sulla programmazione.

Di seguito è riportata una lista di filtri di insight e viene indicato se sono supportati da regole basate sull'attivazione:

Filtri avanzati

Puoi personalizzare e ricavare campi avanzati in base ai filtri di insight e metadati riportati sopra. Per maggiori informazioni, consulta Filtri avanzati della specifica di valutazione.

I filtri avanzati supportano gli operatori seguenti: GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE. Sono supportati solo da regole basate sulla programmazione.

Per alcuni dei filtri avanzati più comunemente usati, è supportato un alias come filtro: