Studio sull'impatto

Crea ed esegui un esperimento per misurare l'efficienza della tua campagna Facebook. Determina qual è la strategia pubblicitaria più efficace per l'azienda. Consulta Studio sulle inserzioni, Riferimento.

Quando crei uno studio sull'impatto, formi un gruppo di test casuale composto da account del Centro gestione account che visualizzano le tue inserzioni e un gruppo di controllo che non le vede.

Puoi condividere in modo sicuro i dati di conversione della tua campagna pubblicitaria con Facebook usando i pixel di Facebook o App Events. Facebook determina l'aumento delle conversioni generato dalla tua campagna. Confrontiamo il numero di conversioni, gli account del Centro gestione account che le hanno effettuate e i ricavi delle vendite disponibili tra gruppi di test e gruppi di controllo.

Configurazione degli studi

Configura uno studio con uno o più gruppi, chiamati celle. Quando configuri uno studio, Facebook suddivide il pubblico in modo casuale per le tue inserzioni e assegna gli account del Centro gestione account al gruppo di test o al gruppo di controllo. Al termine di uno studio, Facebook calcola la differenza tra i gruppi di test e i gruppi di controllo in modo che tu possa valutare l'impatto delle tue inserzioni di Facebook in relazione ai tuoi obiettivi di business.

Per configurare uno studio, effettua una chiamata POST:

'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Puoi configurare uno studio con un solo gruppo di test per capire come le inserzioni di Facebook generano un aumento dei risultati. Puoi anche configurare uno studio con più gruppi di test per stabilire qual è l'approccio pubblicitario più efficace per il tuo pubblico.

Esempio - Configurare uno studio sull'impatto con un gruppo di test

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Per creare un nuovo studio, devi indicare quanto segue:

Creazione di un gruppo di test

Per iniziare, determina quanti account del Centro gestione account ricevono le tue inserzioni e quanti no. Devi creare un gruppo di test quando configuri lo studio; passa una lista di oggetti JSON in cells sotto ad_studies. Consulta Cella dello studio sulle inserzioni, Riferimento. Un gruppo di test contiene le seguenti informazioni.

Esempio - Leggere gruppi di test in uno studio

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'

Esempio - Aggiornare o modificare le informazioni sulle celle e le percentuali di esposizione e di controllo indicando l'ID cella in cells

curl \
  -F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Esempio - Leggere tutti gli studi creati in ad_studies per l'azienda

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Puoi anche vedere tutti gli studi associati al tuo account pubblicitario effettuando una richiesta GET su {ad-account-ID/include_all_studies=true} con il tuo token d'accesso.

Configurazione di più gruppi di test

Configura uno studio con più gruppi di test o utenti di Facebook. In questo modo, potrai misurare l'impatto incrementale delle diverse strategie di Facebook sugli obiettivi di business, ad esempio l'uso di diverse opzioni di targetizzazione delle inserzioni. Per configurare uno studio con più gruppi di test, fornisci una lista dei gruppi di test in cells.

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

control_percentage determina l'esclusione per ogni gruppo di test in relazione alla popolazione totale. Ad esempio, supponiamo che tu esegua uno studio con due gruppi di test: nel gruppo A la percentuale di esposizione è del 50% e quella di controllo del 20%, mentre nel gruppo B la percentuale di esposizione è del 20% e quella di controllo del 10%. Da ciò deriva che circa il 28,6% o 20%/70% della popolazione del gruppo A è rappresentato da utenti di controllo, mentre per la popolazione del gruppo B questa percentuale è di circa il 33,3% o 10%/30%.

In genere, la somma delle percentuali di esposizione e di controllo nei gruppi di test deve essere pari a 100. In alcuni casi d'uso specifici può essere inferiore a 100, ad esempio, quando tre gruppi di test sono divisi equamente al 33%.

Puoi aggiornare, aggiungere e rimuovere gruppi di test in uno studio.

• Per aggiornare un gruppo di test esistente, fai riferimento al suo ID in un gruppo di test.
• Per aggiungere un nuovo gruppo di test, fornisci un nuovo oggetto per il gruppo di test.
• Per rimuovere un gruppo di test, è sufficiente ometterlo dalle cells quando aggiorni lo studio:

curl \
  -F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Definizione degli obiettivi pubblicitari

Definisci gli obiettivi pubblicitari che desideri misurare e la modalità di trasferimento dei dati sulle conversioni a Facebook. Uno studio sull'impatto richiede la presenza di almeno un obiettivo. Non puoi modificare gli obiettivi dopo l'inizio dello studio. Consulta Obiettivo degli studi sulle inserzioni, Riferimento.

Esempio - Creare e aggiungere l'obiettivo CONVERSIONS a uno studio

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Se usi CONVERSIONS e la tua origine degli eventi è il pixel di Facebook o l'app mobile, devi fornire una lista dei nomi degli eventi che desideri acquisire per l'obiettivo. Facebook potrà quindi creare report con i risultati in base a questi eventi di conversione specifici.

Creazione di un obiettivo

Crea un obiettivo trasferendo una lista di objectives di oggetti JSON quando crei un nuovo studio. Gli obiettivi contengono le seguenti informazioni:

Uno studio può anche avere più obiettivi. Il risultato sarà aggregato in base agli obiettivi. Ecco un esempio di studio con più obiettivi.

curl \
  -F 'name="another study"' \
  -F 'description="description of another study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond  objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Puoi aggiornare, aggiungere e rimuovere gli obiettivi in uno studio al livello dello studio in modo simile a come modifichi i gruppi di test. Per aggiornare un obiettivo esistente, fai riferimento al suo ID nell'oggetto objectives. Per aggiungere un nuovo obiettivo, fornisci un nuovo oggetto per l'obiettivo. Per rimuovere un obiettivo, omettilo dal parametro objectives quando lo aggiorni.

Esempio - Aggiornare le origini di misurazione applications dell'obiettivo e rimuovere le origini di misurazione adspixels

curl \
  -F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Esempio - Leggere gli obiettivi per uno studio

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Creazione di report

Recupero degli obiettivi

Gli obiettivi di uno studio vengono definiti durante la configurazione dello studio stesso. Consulta la guida alla configurazione per capire come definire gli obiettivi del tuo studio.

Puoi leggere gli obiettivi creati per uno studio effettuando una chiamata GET al segmento objectives dello studio.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Recupero dei risultati

Per recuperare i risultati per un obiettivo, puoi effettuare una chiamata GET al nodo dell'obiettivo specificando results nel parametro dei campi. Il campo last_updated_results ti indicherà anche l'ultimo aggiornamento dei dati restituiti per questo obiettivo specifico.

Esempio di risposta mostrato come JSON analizzato per semplificare la lettura.

Comando:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

I dati restituiti sono un oggetto JSON, contenente stringhe di valori e nomi delle metriche. Consulta il Glossario delle metriche sull'aumento di Facebook.

Con acquirenti:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"buyers_control_raw_scaled":37672.615701199,
	"buyers_exposed":30085.482427228,
	"buyers_frequentist_pValue":0.00064950107027983,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961,
	"buyers_test":40732.369934386,
	"buyers_control_scaled":41990.129061459,
	"buyers_incremental":-1257.7591270729,
	"buyers_notExposed":36617.935710157,
	"buyers_confidence":0.19318944031404,
	"buyers_multicell_confidence":null,
	"buyers_incremental_lower":-2905.5296282828,
	"buyers_incremental_upper":426.25813050358,
	"buyers_multicell_rank":null,
	"buyers_incremental_share":-0.041806181107957,
	"buyers_CPiB":-20.718593440578}"
	  ],
	  "id": "<objective_id>"
}

Senza acquirenti:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961}"
	  ],
	  "id": "<objective_id>"
}

Risultati dettagliati

Oltre a recuperare i risultati per ciascun obiettivo, puoi scegliere di ottenere risultati dettagliati fornendo il parametro breakdowns.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Queste sono le dimensioni dei dettagli disponibili:

I risultati restituiscono diversi oggetti JSON nell'array in base ai dettagli disponibili. Ad esempio, se viene fornito l'elemento cell_id, i risultati sono suddivisi in base al numero di celle dello studio. Puoi indicare uno o più dettagli; tuttavia, la combinazione dei dettagli deve contenere almeno 100 conversioni dai gruppi di test e di controllo combinati affinché vengano mostrati i risultati.

{
  "id": "<STUDY_OBJECTIVE_ID>",
  "results": [
  {
    "cell_id": "<CELL_ID1>",
    ...
    Default fields where the values are specific to the <CELL_ID1> breakdown
    ...
  },
  {
    "cell_id": "<CELL_ID2>",
    ...
    Default fields where the values are specific to the <CELL_ID2> breakdown
    ...
  }],
}

Risultati per una data specifica

Se desideri ottenere i risultati di studi relativi a una data specifica, puoi indicare quella data nella chiamata API. Tieni presente che la chiamata restituisce lo stesso risultato che restituirebbe se facessi la stessa chiamata in quella specifica data senza includere il campo relativo alla data. La data non deve essere precedente agli ultimi 30 giorni.

curl -G \
      -d 'access_token=<ACCESS_TOKEN>' \
      'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'