Filtri della specifica di valutazione

Nelle regole basate sulla programmazione, è possibile usare tipi di campi di filtro più avanzati.

Campi di insight con prefissi

Puoi impostare tipi specifici di prefissi per i filtri di insight. Sono simili ai prefissi impostati per i filtri di metadati per eseguire filtri multilivello.

Puoi impostare un prefisso a livello di oggetto su un filtro per sfruttare i filtri multilivello di insight. Ad esempio, una regola dell'inserzione può essere filtrata in base alle prestazioni del gruppo di inserzioni o della campagna pubblicitaria. In un filtro puoi anche specificare i prefissi della finestra di attribuzione e del valore temporale predefinito. Questo è usato per sovrascrivere la finestra di attribuzione e il valore temporale predefinito della regola per il filtro specifico.

Utilizzo

I prefissi sono facoltativi. Un campo può avere:

  • un prefisso a livello di oggetto;
  • un prefisso della finestra di attribuzione;
  • un prefisso del valore temporale predefinito.

Puoi avere tutte le opzioni sopra, nessuna di esse o una qualsiasi combinazione, purché tu le mantenga in quest'ordine. Il campo deve avere il seguente formato:

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

Di seguito sono riportati esempi di campi di insight con prefissi corretti ed errati. Sono inoltre forniti esempi di campi di metadati con prefissi corretti ed errati, per mostrare quali filtri di metadati sono supportati.

Esempi per il campo di insight spent
Esempi con uso corretto

adset.yesterday_spent: importo totale speso al livello del gruppo di inserzioni ieri

adset.yesterday_spent: importo totale speso al livello del gruppo di inserzioni

yesterday_spent: importo totale speso ieri

campaign.28d_view_1d_click:lifetime_results: risultati totali al livello del gruppo di inserzioni per tutta la sua durata, con la finestra di attribuzione di 28 giorni dalla visualizzazione e 1 giorno dal clic

campaign.lifetime_spent: importo totale speso al livello della campagna pubblicitaria per tutta la sua durata

Esempi con uso non corretto

lifetime_campaign.spent: i prefissi dei valori temporali predefiniti non possono precedere i prefissi al livello di oggetto

lifetime_today_spent: non possono esserci due prefissi di valori temporali predefiniti

ad.adset.spent: non possono esserci due prefissi al livello di oggetto

yesterday.adset_spent: delimitatore errato


Esempi di campo di metadati daily_budget
Esempi con uso corretto

adset.daily_budget: budget giornaliero del gruppo di inserzioni

daily_budget: budget giornaliero

Esempi con uso non corretto

yesterday_daily_budget: non è possibile usare i prefissi dei valori temporali predefiniti sui campi dei metadati

ad.daily_budget: le inserzioni non hanno un budget giornaliero

Prefissi al livello di oggetto

PrefissoTipo di oggettoValido sui tipi di oggetto

ad.

Ad

Ad

adset.

Ad Set

Ad, Ad Set

campaign.

Campagna

Ad, Ad Set, Campaign

Prefissi della finestra di attribuzione

Prefisso della finestra di attribuzione Descrizione

account_default:

Usa l'impostazione della finestra di attribuzione a livello di account

default:

La finestra di attribuzione predefinita di Facebook è di 1 giorno dalla visualizzazione, 28 giorni dal clic

inline:

Solo attribuzione in linea (0 giorni dalla visualizzazione, 0 giorni dal clic)

1d_view:

1 giorno dalla visualizzazione, 0 giorni dal clic

7d_view:

7 giorni dalla visualizzazione, 0 giorni dal clic

28d_view:

28 giorni dalla visualizzazione, 0 giorni dal clic

1d_click:

0 giorni dalla visualizzazione, 1 giorno dal clic

7d_click:

0 giorni dalla visualizzazione, 7 giorni dal clic

28d_click:

0 giorni dalla visualizzazione, 28 giorni dal clic

1d_view_1d_click:

1 giorno dalla visualizzazione, 1 giorno dal clic

7d_view_1d_click:

7 giorni dalla visualizzazione, 1 giorno dal clic

28d_view_1d_click:

28 giorni dalla visualizzazione, 1 giorno dal clic

1d_view_7d_click:

1 giorno dalla visualizzazione, 7 giorni dal clic

7d_view_7d_click:

7 giorni dalla visualizzazione, 7 giorni dal clic

28d_view_7d_click:

28 giorni dalla visualizzazione, 7 giorni dal clic

7d_view_28d_click:

7 giorni dalla visualizzazione, 28 giorni dal clic

28d_view_28d_click:

28 giorni dalla visualizzazione, 28 giorni dal clic

Prefissi valori temporali predefiniti

Questa lista è uguale a quella dei valori temporali predefiniti validi, ma trasformata in minuscolo e associata a un delimitatore.

Prefisso Descrizione

lifetime_

Vita dell'oggetto

today_

Il giorno corrente a partire dalla mezzanotte nel fuso orario dell'account pubblicitario

last_2_days_

YESTERDAY e TODAY

last_3_days_

Ultimi 2 giorni completi e TODAY

last_7_days_

Ultimi 6 giorni completi e TODAY

last_14_days_

Ultimi 13 giorni completi e TODAY

last_28_days_

Ultimi 27 giorni completi e TODAY

last_30_days_

Ultimi 29 giorni completi e TODAY

this_month_

Questo mese, compreso TODAY

this_week_mon_today_

Questa settimana usando lunedì come primo giorno della settimana, compreso TODAY

this_week_sun_today

Questa settimana usando domenica come primo giorno della settimana, compreso TODAY

yesterday_

Il giorno completo precedente, escluso TODAY

last_2d_

Ultimi 2 giorni completi, escluso TODAY

last_3d_

Ultimi 3 giorni completi, escluso TODAY

last_7d_

Ultimi 7 giorni completi, escluso TODAY

last_14d_

Ultimi 14 giorni completi, escluso TODAY

last_28d_

Ultimi 28 giorni completi, escluso TODAY

last_30d_

Ultimi 30 giorni completi, escluso TODAY

last_nd_14_8_

Dagli ultimi 14 giorni fino agli ultimi 7 giorni, per ROAS

last_nd_30_8_

Dagli ultimi 30 giorni fino agli ultimi 7 giorni, per ROAS

last_nd_60_8_

Dagli ultimi 60 giorni fino agli ultimi 7 giorni, per ROAS

last_nd_120_8_

Dagli ultimi 120 giorni fino agli ultimi 7 giorni, per ROAS

last_nd_180_8_

Dagli ultimi 180 giorni fino agli ultimi 7 giorni, per ROAS

last_nd_lifetime_8_

Dal valore totale fino agli ultimi 7 giorni, per ROAS

last_nd_60_29_

Dagli ultimi 60 giorni fino agli ultimi 28 giorni, per ROAS

last_nd_120_20_

Dagli ultimi 120 giorni fino agli ultimi 28 giorni, per ROAS

last_nd_180_29_

Dagli ultimi 180 giorni fino agli ultimi 28 giorni, per ROAS

last_nd_lifetime_29_

Dal valore totale fino agli ultimi 28 giorni, per ROAS

Aggregazione

Puoi aggregare alcuni campi di insight su più oggetti pubblicitari. Questo ti consente di creare filtri sulle metriche rispetto a un sottoinsieme specifico di oggetti pubblicitari. Ad esempio, la copertura totale su più inserzioni o il numero totale di clic su diversi gruppi di inserzioni.

Mentre alcune metriche come clicks vengono calcolate con una semplice somma, altre metriche come reach vengono calcolate in modo diverso. Poiché reach si basa su impression uniche, gli utenti duplicati vengono rimossi nell'aggregazione su più oggetti pubblicitari.

Utilizzo

Un campo aggregato ha questa struttura: aggregate({ field }). Il field può contenere prefissi di finestra di attribuzione e valore temporale predefinito. L'insieme di oggetti pubblicitari da aggregare è determinato da un altro campo di filtro obbligatorio, aggregation_id.

Esempio di campi aggregati

Esempi con uso corretto

aggregate(reach)

aggregate(lifetime_reach)

Esempi con uso non corretto

aggregate(daily_budget)

aggregate(adset.reach)

Filtro ID aggregazione

Il filtro aggregation_id specifica quali oggetti pubblicitari aggregare. Come valore, supporta solo l'operatore IN e una lista di ID. Gli ID possono essere di inserzioni, gruppi di inserzioni o campagne pubblicitarie, ma tutti devono essere dello stesso livello di oggetto.

Esempio di filtro aggregation_id

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

Campi supportati

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

Campi di formula

Puoi impostare semplici espressioni aritmetiche come campo. Ad esempio, questo può essere utilizzato per trovare il rapporto tra due campi numerici.

Funziona sui campi di insight e su un sottoinsieme di campi di metadati numerici. Di seguito è riportata la lista completa supportata.

Utilizzo

Un campo di formula consiste di campi o costanti e operatori sintatticamente corretti separati da spazi. Supporta gli operatori +-* e /. Puoi aggiungere costanti, ad esempio per pesare campi specifici o che agiscano come offset.

In questo caso ai campi puoi aggiungere prefissi validi a livello di oggetto e di valore temporale predefinito.

Al momento in una formula sono consentiti al massimo 6 campi non contenenti costanti. Il numero di costanti utilizzabili è illimitato.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

Esempio di formule

Esempi con uso corretto

today_spent / adset.daily_budget: spesa percentuale giornaliera

clicks / adset.clicks: rapporto tra clic e clic del gruppo di inserzioni

today_impressions / yesterday_impressions: rapporto tra il numero di impression odierne e il numero di impression di ieri

today_impressions / aggregate(today_impressions): rapporto tra il numero di impression odierne e un numero aggregato di impression

(adset.spent - spent): sono accettate le parentesi; quando si ricevono formule nelle risposte API, è possibile metterle tra parentesi

Esempi con uso non corretto

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per: non è consentito usare più di 6

today_impressions/yesterday_impressions: i termini devono essere separati da uno spazio

Campi di metadati numerici validi

CampoValido sui tipi di oggetto

bid_amount

Ad, Adset

daily_budget

Adset

lifetime_budget

Adset

spend_cap

Campagna