Report sull'impatto

Per misurare l'impatto causale delle tue campagne pubblicitarie sulla percezione del brand, sulle conversioni, sul valore di conversione e sul comportamento di ricerca organica, esegui una query sulle risorse dei report di misurazione del lift nell'API Google Ads:

  • Report sul brand lift: valuta in che modo l'esposizione annuncio influisce sulla percezione del brand in base ai tipi di misurazione dei sondaggi nell'API Google Ads v25 e versioni successive.
  • Report sul conversion lift: misura le conversioni incrementali, il valore di conversione, il costo per conversione incrementale (iCPA) e il ritorno sulla spesa pubblicitaria incrementale (iROAS) rispetto a un gruppo di controllo non esposto nell'API Google Ads v25 e versioni successive, tra cui:
  • Report sul search lift: quantifica l'aumento incrementale del volume delle query di ricerca organica su Ricerca Google e YouTube generato dall'esposizione annuncio nell'API Google Ads v26 e versioni successive.

Per i report standard sugli esperimenti A/B sulle risorse experiment e campaign, consulta Genera report sugli esperimenti.

Report sul brand lift

Per valutare in che modo le tue campagne pubblicitarie influenzano la percezione del brand nell'API Google Ads v25 e versioni successive, esegui una query sulle risorse di misurazione del brand lift dedicate.

Risorse e visualizzazioni di analisi dettagliate del brand lift

Le configurazioni, i periodi di pubblicazione e le visualizzazioni di suddivisione del brand lift sono di sola lettura nell'API Google Ads (tutti i campi sono OUTPUT_ONLY) e vengono configurati nell'interfaccia utente di Google Ads o con il tuo rappresentante di Google o il contatto GPS. Esegui query su queste risorse utilizzando il parametro customer_id dell'account (account amministratore o account secondario) proprietario dello studio.

Esegui una query sulla risorsa LiftMeasurementFlight per recuperare i metadati della pianificazione del brand lift e della raccolta dei sondaggi a livello di periodo di pubblicazione, tra cui lo stato del periodo di pubblicazione (lift_measurement_flight.status, definito dall'enum LiftMeasurementFlightStatus con i valori ENABLED per i periodi di pubblicazione attivi e STOPPED per i periodi di pubblicazione interrotti manualmente), gli intervalli di date del periodo di pubblicazione (lift_measurement_flight.start_date e lift_measurement_flight.end_date) nel fuso orario del cliente e l'avanzamento della raccolta delle risposte ai sondaggi target (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, dove 0 è uguale allo 0% e 1000000 è uguale al 100%). Per determinare se un volo ENABLED è in corso o è stato completato, confronta la data corrente nel fuso orario del cliente con lift_measurement_flight.start_date e lift_measurement_flight.end_date e verifica se response_collection_ratio_micros ha raggiunto 1000000.

Interroga la risorsa LiftMeasurementConfig per recuperare le metriche complessive del brand lift a livello di studio o interroga le seguenti risorse di suddivisione per analizzare le metriche del brand lift in dimensioni specifiche:

Includi il segmento segments.brand_lift_measurement_type per suddividere le metriche di brand lift in base al tipo di domanda del sondaggio, definito dall'enum BrandLiftMeasurementType (ad esempio RECALL o AWARENESS). Se ometti il segmento segments.brand_lift_measurement_type, l'API restituisce le metriche per un singolo tipo di misurazione selezionato automaticamente per sezione. Includi il segmento segments.date per suddividere le metriche del brand lift per data (YYYY-MM-DD). La metrica metrics.cost_per_lifted_cookie viene restituita in micro della valuta dell'account proprietario dello studio.

Nell'API Google Ads v27 e versioni successive, puoi anche selezionare il campo di sola lettura (OUTPUT_ONLY) lift_guidance (lift_guidance.outcome e lift_guidance.guidance_message, di tipo LiftGuidance) nella clausola SELECT di Google Ads Query Language (GAQL) su lift_measurement_config e sulle cinque risorse di suddivisione del brand lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender e lift_measurement_video) per ricevere l'interpretazione statistica a livello di riga. In lift_measurement_config, lift_guidance viene compilato solo quando la query seleziona o filtra anche in base alle metriche o ai segmenti di lift (viene omesso nelle query di configurazione solo dei metadati) e lift_guidance.guidance_message può contenere link Markdown incorporati (ad esempio [Learn more](https://support.google.com/...)). Non puoi filtrare o ordinare in base ai campi secondari lift_guidance nelle clausole WHERE o ORDER BY. Per le descrizioni dei valori LiftOutcomeEnum.LiftOutcome restituiti in lift_guidance.outcome, consulta Interpreta i risultati del brand lift.

Soglie di segnalabilità e risposte vuote

I report sul brand lift sono limitati dalla latenza (richiedono un ritardo della pipeline di 24-48 ore dopo l'inizio di uno studio) e limitati dalle risposte per tipo di misurazione del sondaggio (segments.brand_lift_measurement_type) per soddisfare le soglie di privacy e reportabilità statistica:

  • Tassi di risposta positivi (metrics.brand_lift_baseline_positive_response_rate* e metrics.brand_lift_exposed_positive_response_rate*): almeno 50 risposte al sondaggio nel gruppo corrispondente (esposto o non esposto).
  • Soglia di lift positivo rigorosa (studio complessivo su LiftMeasurementConfig o sezione indipendente): lift statisticamente positivo (p_value <= 0.50) con almeno 2000 risposte totali e 860 risposte per gruppo.
  • Soglia di lift positivo del segmento meno rigida (su una risorsa di suddivisione quando lo studio complessivo soddisfa la soglia rigida con lift positivo): lift statisticamente positivo (p_value <= 0.50) con almeno 500 risposte totali e 200 risposte per gruppo.
  • Soglia di lift non positivo completa (NO_SIGNIFICANT_LIFT rispetto a NOT_ENOUGH_DATA): almeno 4100 risposte totali per metrica quando non viene rilevato un lift statisticamente positivo.

Le query a LiftMeasurementConfig e alle cinque risorse di analisi del brand lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign e LiftMeasurementVideo) restituiscono una risposta vuota (results: []) anziché un errore nei seguenti casi:

  • Il parametro customer_id sottoposto a query non è presente nella lista consentita o non è proprietario dello studio.
  • I filtri per le date WHERE non rientrano nei periodi di pubblicazione valutati (lift_measurement_flight.start_date e lift_measurement_flight.end_date).
  • Lo studio o la sezione specifica relativa a dati demografici, dispositivi, campagne o video non ha soddisfatto le soglie relative al ritardo dei report di 24-48 ore e al volume delle risposte al sondaggio, anche se LiftMeasurementConfig restituisce i risultati complessivi dello studio.

Per risolvere i problemi relativi alle risposte vuote, completa i seguenti passaggi:

  1. Esegui una query su lift_measurement_flight per verificare che lift_measurement_flight.status = 'ENABLED', controlla che i filtri per le date WHERE rientrino in lift_measurement_flight.start_date e lift_measurement_flight.end_date e controlla l'avanzamento del sondaggio in lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (dove 1000000 è uguale al 100%).
  2. Esegui una query su LiftMeasurementConfig per verificare se lo studio complessivo ha generato metriche di brand lift segnalabili prima di eseguire query sulle risorse di suddivisione dimensionale.

Interpretare i risultati del brand lift

In API Google Ads v27 e versioni successive, il campo lift_guidance.outcome restituisce un valore LiftOutcomeEnum.LiftOutcome che classifica lo stato statistico di ogni riga restituita insieme a consigli di correzione leggibili in lift_guidance.guidance_message:

  • Risultati dello studio in corso (quando lift_measurement_flight.status è ENABLED e la data corrente nel fuso orario del cliente è uguale o precedente a lift_measurement_flight.end_date con lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros inferiore a 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: lo studio è in corso e sta emergendo un lift positivo preliminare.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: lo studio è in corso con un volume iniziale sufficiente e non è stato ancora rilevato un incremento statisticamente significativo.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: lo studio è in corso e sta raccogliendo attivamente le risposte iniziali al sondaggio per raggiungere le soglie dei report statistici.
  • Risultati dello studio completato (quando lift_measurement_flight.end_date è trascorso o lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros ha raggiunto 1000000):
    • POSITIVE_LIFT_DETECTED: è stato rilevato un incremento positivo statisticamente significativo per lo studio o la sezione completati.
    • NO_SIGNIFICANT_LIFT: lo studio o la sezione completati hanno raggiunto le soglie di precisione statistica (almeno 4100 risposte totali per metrica) e non è stato rilevato alcun lift positivo statisticamente significativo.
    • NOT_ENOUGH_DATA: lo studio o la sezione completati non hanno soddisfatto le soglie di risposte al sondaggio richieste per la reportabilità statistica (almeno 2000 risposte totali e 860 risposte per gruppo per un lift positivo nello studio complessivo, 500 risposte totali e 200 risposte per gruppo per un lift positivo in una sezione quando lo studio complessivo ha un lift positivo o 4100 risposte totali per metrica quando non viene rilevato un lift positivo).

Applica le seguenti linee guida quando interpreti i risultati del brand lift:

  • Periodi di pubblicazione in corso e completati (STUDY_IN_PROGRESS_*): mentre un periodo di pubblicazione dello studio ENABLED è ancora in corso (prima che trascorra lift_measurement_flight.end_date e prima che response_collection_ratio_micros raggiunga 1000000), le risposte al sondaggio e la modellazione con correzione del bias sono ancora in fase di stabilizzazione. Considera le metriche in corso come preliminari ed evita di mettere in pausa le campagne o di ridurre i budget fino al completamento del periodo di pubblicazione.
  • Impatto positivo (POSITIVE_LIFT_DETECTED): quando viene rilevato un impatto del brand positivo, esegui una query sulle risorse di suddivisione dimensionale (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign e LiftMeasurementVideo) per identificare le coorti di pubblico con un rendimento elevato ("punti di forza") e valutare la risonanza delle creatività nel funnel del brand.
  • Dati insufficienti o nessun impatto significativo (NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT): quando il volume delle risposte al sondaggio è insufficiente (meno di 4100 risposte totali per metrica senza impatto positivo o meno delle soglie di sezione rigide di 2000/860 o flessibili di 500/200 per l'impatto positivo) o non viene rilevato alcun impatto statisticamente significativo su una sezione, non considerarlo un fallimento della campagna o non escludere i segmenti di pubblico in base all'insufficienza del campione di una singola sezione. Controlla le metriche complessive dello studio su LiftMeasurementConfig, esegui query su altri valori segments.brand_lift_measurement_type oggetto del sondaggio (ad esempio RECALL o AWARENESS del funnel iniziale) e controlla le restanti dimensioni di analisi.

Esempi di query sul brand lift

Poiché i metadati dei flight e le statistiche sull'impatto risiedono su risorse separate, per eseguire query sui dettagli dei flight e sulle statistiche sul rendimento sono necessarie query GAQL separate.

Query sui dettagli del volo

Per recuperare i metadati di un periodo di pubblicazione di brand lift, ad esempio lo stato, il tipo di misurazione, le date pianificate e l'avanzamento della raccolta dei sondaggi, esegui una query sulla risorsa LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift (lift_measurement_config.lift_measurement_config_id).

Query sulle statistiche

Per recuperare le metriche di brand lift, esegui una query sulla risorsa LiftMeasurementConfig o sulla risorsa di analisi appropriata. Ad esempio, la seguente query recupera le metriche di brand lift segmentate per campagna e tipo di misurazione del brand lift dalla risorsa LiftMeasurementCampaign:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.

Report sul conversion lift

Nella versione 25 e successive dell'API Google Ads, i report sul conversion lift misurano l'impatto incrementale dei tuoi annunci sulle conversioni e sul valore di conversione. Gli studi sul conversion lift confrontano il comportamento di conversione tra un gruppo esposto (utenti idonei a visualizzare i tuoi annunci) e un gruppo di controllo non esposto (utenti a cui è stato impedito di visualizzare i tuoi annunci).

Le configurazioni, i periodi di pubblicazione e i link agli esperimenti di conversion lift sono di sola lettura nell'API Google Ads (tutti i campi sono OUTPUT_ONLY) e vengono configurati nell'interfaccia utente di Google Ads o con il tuo rappresentante di Google o il tuo contatto GPS. Esegui una query sulla risorsa lift_measurement_config utilizzando il parametro customer_id dell'account proprietario dello studio. Un account amministratore può eseguire query direttamente sugli studi sul conversion lift su più account di sua proprietà. Esegui query sugli studi di proprietà di un account secondario utilizzando il parametro customer_id dell'account secondario (facoltativamente autenticato con l'intestazione login-customer-id).

I report sul conversion lift supportano due workflow di studio, entrambi con lo stesso rilevamento di studi e periodi di pubblicazione, gli stessi intervalli di date delle istantanee cumulative e gli stessi ambiti delle azioni di conversione:

  • Report sul conversion lift autonomo: misura l'incrementalità complessiva, il costo per conversione incrementale (iCPA) e il ritorno sulla spesa pubblicitaria incrementale (iROAS) per le azioni di conversione selezionate o per tutte le azioni di conversione delle campagne misurate nello studio.
  • Report su test A/B + conversion lift: misura l'incrementalità per gruppo e i punteggi bayesiani dei vincitori tra due gruppi sperimentali concorrenti (controllo e trattamento), oltre all'incrementalità complessiva dello studio.

Per assistenza nella creazione di query valide per la risorsa lift_measurement_config, utilizza lo strumento Google Ads Query Builder.

Nella versione 27 e successive dell'API Google Ads, puoi selezionare il campo di sola lettura (OUTPUT_ONLY) lift_measurement_config.lift_guidance (lift_guidance.outcome e lift_guidance.guidance_message, di tipo LiftGuidance) nella clausola GAQL SELECT su lift_measurement_config per ricevere l'interpretazione statistica a livello di riga per le query di conversion lift autonomo e A/B + conversion lift. In lift_measurement_config, lift_guidance viene compilato solo quando la query seleziona o filtra anche in base a metriche o segmenti di lift (viene omesso nelle query di configurazione solo dei metadati) e lift_guidance.guidance_message può contenere link Markdown incorporati (ad esempio [Learn more](https://support.google.com/...)). Non puoi filtrare o ordinare in base ai campi secondari lift_guidance nelle clausole WHERE o ORDER BY. Il campo lift_guidance.outcome restituisce uno dei seguenti valori LiftOutcomeEnum.LiftOutcome:

  • Risultati dello studio in corso (quando lift_measurement_flight.status è ENABLED e la data corrente nel fuso orario del cliente è uguale o precedente a lift_measurement_flight.end_date):
    • STUDY_IN_PROGRESS_WITH_LIFT: lo studio è in corso e sta emergendo un lift positivo preliminare.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: lo studio è in corso con un volume iniziale sufficiente e non è stato ancora rilevato un incremento statisticamente significativo.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: lo studio è in corso e sta raccogliendo attivamente i dati sulle conversioni iniziali per le soglie dei report statistici.
  • Risultati dello studio completato (quando lift_measurement_flight.end_date è trascorso):
    • POSITIVE_LIFT_DETECTED: è stato rilevato un lift positivo statisticamente significativo per lo studio, il gruppo sperimentale o la sezione completati.
    • AB_WINNER_WITH_LIFT: uno studio A/B + sul conversion lift completato con un gruppo sperimentale vincente nel confronto diretto e un lift positivo statisticamente significativo rispetto al gruppo di controllo non esposto.
    • AB_WINNER_PARITY_VS_CONTROL: è stato completato uno studio A/B + sul conversion lift con un gruppo sperimentale vincente nel confronto diretto, ma in parità con il gruppo di controllo non esposto.
    • NO_SIGNIFICANT_LIFT: lo studio, il gruppo sperimentale o la sezione completati hanno soddisfatto le soglie di precisione statistica e non è stato rilevato alcun lift positivo statisticamente significativo.
    • NOT_ENOUGH_DATA: lo studio, il gruppo sperimentale o la sezione completati non hanno accumulato un numero di conversioni sufficiente per raggiungere le soglie di precisione statistica.

Scopri le configurazioni di studio e i trial

Per generare report su uno studio sul conversion lift, devi prima scoprire la configurazione di studio e la pianificazione del periodo di pubblicazione:

  1. Recupera la configurazione di studio: esegui una query sulla risorsa LiftMeasurementConfig per recuperare il nome dello studio, la percentuale di holdback (lift_measurement_config.conversion_lift_holdback_ratio_micros), le azioni di conversione monitorate (lift_measurement_config.conversion_actions) e, nell'API Google Ads v26 e versioni successive, le campagne collegate attivamente (lift_measurement_config.campaigns). Il campo conversion_lift_holdback_ratio_micros è espresso in micro, dove 1,000,000 equivale al 100% (ad esempio, 300000 rappresenta un gruppo di holdback non esposto del 30%). Se non conosci l'ID CONFIG_ID dello studio, ometti la clausola WHERE per elencare tutte le configurazioni di studio nell'account.
  2. Recupera le finestre di osservazione dei voli: esegui una query sulla risorsa LiftMeasurementFlight per trovare le date dei voli programmati (lift_measurement_flight.start_date e lift_measurement_flight.end_date) nel fuso orario del cliente. Poiché una singola risorsa LiftMeasurementConfig può raggruppare i periodi di pubblicità del brand lift (SURVEY), del conversion lift (CONVERSION) e del search lift (SEARCH), includi il campo lift_measurement_flight.lift_type nella clausola SELECT e filtra per lift_measurement_flight.lift_type = 'CONVERSION' nella clausola WHERE. I campi lift_measurement_flight.start_date e lift_measurement_flight.end_date sono ordinabili nelle clausole ORDER BY, ma non puoi filtrarli in una clausola WHERE.

La seguente query recupera la configurazione di studio (ometti il campo lift_measurement_config.campaigns nella versione 25 dell'API Google Ads, poiché questo campo richiede la versione 26 e successive dell'API Google Ads):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift (lift_measurement_config.lift_measurement_config_id).

La seguente query recupera la pianificazione del periodo di pubblicazione del conversion lift per lo studio:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift (lift_measurement_config.lift_measurement_config_id).

Nella versione 26 e successive dell'API Google Ads, puoi anche scoprire la configurazione della misurazione del lift collegata a una campagna direttamente dalla risorsa campaign eseguendo una query sul campo campaign.lift_measurement_config. La query di questo campo evita di dover fare un controllo incrociato della risorsa LiftMeasurementConfig separatamente:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

Sostituisci quanto segue:

  • CAMPAIGN_ID: l'ID intero della campagna (campaign.id).

Il campo campaign.lift_measurement_config restituisce un nome della risorsa nel formato customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Se una campagna ha partecipato a più studi sul lift, questo campo identifica la configurazione collegata più di recente (attiva o non attiva). Al contrario, il campo lift_measurement_config.campaigns elenca solo le campagne collegate attivamente.

Esegui query sugli intervalli di date degli snapshot cumulativi

I risultati del conversion lift sono strutturati come istantanee di valutazione cumulativa giornaliera a partire dalla data di inizio del periodo di pubblicazione:

Sia segments.conversion_lift_start_date che segments.conversion_lift_end_date sono campi INT64 formattati come numeri interi di 8 cifre senza virgolette e senza trattini nel formato YYYYMMDD (ad esempio, 20260501). Al contrario, i campi lift_measurement_flight.start_date e lift_measurement_flight.end_date restituiscono stringhe di date nel formato ISO 8601 YYYY-MM-DD (ad esempio, 2026-05-01). A differenza delle query di brand lift e search lift, il segmento segments.date non è compatibile con tutte le metriche e i segmenti di conversion lift. Se selezioni il segmento segments.date insieme ai segmenti di conversion lift (ad es. segments.conversion_lift_start_date) nella clausola SELECT, viene restituito un errore QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, mentre se combini segments.date con le metriche di conversion lift, viene restituito un errore QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

Lo snapshot calcolato più recente può essere in ritardo rispetto alla data di fine di un volo attivo durante l'elaborazione dei dati. Esegui sempre una query sulla risorsa lift_measurement_config per le coppie (segments.conversion_lift_start_date, segments.conversion_lift_end_date) disponibili ordinate per segments.conversion_lift_end_date DESC per identificare lo snapshot valutato più recente.

La seguente query recupera gli intervalli di date degli snapshot disponibili per uno studio:

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.

Filtra per ambito dell'azione di conversione

Il conversion lift valuta l'incrementalità in due ambiti definiti dal segmento segments.conversion_lift_included_conversion_action_types:

  • SELECTED: azioni di conversione selezionate durante la configurazione dello studio o tutte le azioni di conversione (principali) idonee per l'offerta se non sono state specificate azioni di conversione personalizzate.
  • ALL: tutte le azioni di conversione delle campagne misurate nello studio.

Quando esegui una query sulla risorsa lift_measurement_config per le metriche di conversion lift senza applicare filtri al segmento segments.conversion_lift_included_conversion_action_types, l'API restituisce due righe per sezione: una per ALL e una per SELECTED. In GAQL, qualsiasi campo di segmento non relativo alla data (e qualsiasi segmento di data dell'istantanea del conversion lift) filtrato nella clausola WHERE deve essere visualizzato anche nella clausola SELECT. In caso contrario, l'API restituisce un errore QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Quando filtri per segments.conversion_lift_included_conversion_action_types = 'SELECTED' nella clausola WHERE, includi questo segmento nella clausola SELECT.

Report sul conversion lift autonomo

Gli studi sul conversion lift autonomi misurano l'impatto incrementale dei tuoi annunci rispetto a un gruppo di controllo non esposto senza suddividere le campagne in gruppi sperimentali concorrenti.

Esegui query sul conversion lift e sull'iCPA

I report sul conversion lift mostrano le stime puntuali insieme ai limiti di confidenza unilaterali del 90% (*_p90_lower_bound e *_p90_upper_bound, che insieme formano un intervallo di affidabilità bilaterale dell'80%) e ai valori p (p_value <= 0.10 corrisponde alla significatività statistica unilaterale del 90%):

L'API omette le metriche del conversion lift nelle righe restituite nei seguenti casi:

  • La finestra di snapshot inclusiva è inferiore a 4 giorni.
  • Il volume delle conversioni osservate non scalate è inferiore alle soglie di precisione minime (meno di 65 conversioni di riferimento osservate nel gruppo di controllo o meno di 150 conversioni esposte osservate, valutate prima della scalabilità metrics.conversion_lift_baseline_conversions).
  • Il lift misurato non è positivo (metrics.incremental_conversions_p_value > 0.5 per le metriche di conversione o metrics.incremental_conversion_value_p_value > 0.5 per le metriche del valore di conversione).
  • Nell'API Google Ads v27 e versioni successive, le metriche iROAS (metrics.incremental_conversion_value_per_cost*) e le metriche del punteggio vincitore del valore di conversione (metrics.incremental_conversion_value_winner_score e metrics.incremental_conversion_value_per_cost_winner_score) vengono interrogate in uno studio configurato durante la configurazione con il conteggio delle conversioni anziché con il valore di conversione come metrica principale. Le metriche sul valore di conversione non basate sui costi (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) rimangono compilate negli studi basati sul conteggio delle conversioni come metrica principale ogni volta che è possibile generare report sul lift del valore di conversione.
  • Più righe o studi vengono aggregati perché hai omesso i campi lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date o segments.conversion_lift_included_conversion_action_types dalla clausola SELECT.

Applica le seguenti linee guida per interpretare i risultati del conversion lift autonomo:

  • Periodi di pubblicazione in corso e completati (STUDY_IN_PROGRESS_*): mentre un periodo di pubblicazione dello studio ENABLED è ancora in corso (quando la data corrente nel fuso orario del cliente è precedente o uguale a lift_measurement_flight.end_date), la modellazione delle conversioni di base e di trattamento e l'attribuzione delle conversioni ritardate sono ancora in fase di stabilizzazione. Considera le metriche in corso come preliminari ed evita di mettere in pausa le campagne o di ridurre i budget fino al completamento del periodo di pubblicazione.
  • Lift positivo (POSITIVE_LIFT_DETECTED): la metrica del conversion lift può essere inclusa nei report e lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' viene attivato ogni volta che il lift misurato è positivo (p_value <= 0.50, corrispondente a una certezza di almeno il 50% con una stima puntuale positiva, mentre p_value <= 0.10 indica una significatività statistica unilaterale del 90% dove *_p90_lower_bound >= 0) e vengono soddisfatte le soglie di precisione minime (almeno 4 giorni di istantanea, almeno 65 conversioni di riferimento non scalate e almeno 150 conversioni del gruppo esposto non scalate). Quando viene rilevato un lift positivo, esegui query sulle suddivisioni dimensionali (dati demografici, dispositivo, paese o categoria di conversione e azione di conversione) per identificare le coorti con un rendimento elevato ("punti di forza").
  • Dati insufficienti o nessun lift significativo (NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT): quando il volume di dati è insufficiente (meno di 65 conversioni di riferimento non scalate o meno di 150 conversioni del gruppo esposto non scalate) o non viene rilevato un lift statisticamente significativo in una sezione, non considerarlo un errore della campagna o escludere i segmenti di pubblico in base all'insufficienza del campione di una singola sezione. Controlla le metriche complessive dello studio ed esegui una query su segments.conversion_lift_included_conversion_action_types = 'ALL' (se SELECTED non mostra alcun lift) o sulle restanti suddivisioni dimensionali per verificare se il lift positivo è stato isolato altrove.

La seguente query recupera l'incrementalità delle conversioni complessiva, i limiti di confidenza e l'iCPA:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Esegui query sul lift del valore di conversione e sull'iROAS

Per valutare le entrate incrementali generate dalla spesa pubblicitaria, esegui query sulle metriche del valore di conversione e sulla metrica metrics.incremental_conversion_value_per_cost. Le metriche del valore di conversione non basate sul costo (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) vengono compilate ogni volta che lo studio presenta un lift del valore di conversione segnalabile, indipendentemente dal fatto che la metrica principale dello studio sia il conteggio delle conversioni o il valore di conversione. In API Google Ads v27 e versioni successive, le metriche iROAS (metrics.incremental_conversion_value_per_cost*), insieme a metrics.incremental_conversion_value_winner_score e metrics.incremental_conversion_value_per_cost_winner_score, vengono restituite solo quando lo studio è stato configurato durante la configurazione con il valore di conversione come metrica principale (e vengono omesse negli studi con conteggio delle conversioni principale):

La seguente query recupera l'incrementalità del valore di conversione, i limiti di confidenza e l'iROAS:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Segmenta i risultati per dimensione

Segmenta le metriche sulle conversioni incrementali per categoria di conversione, azione di conversione, dati demografici, dispositivo o area geografica. Quando esegui una query sulla risorsa lift_measurement_config, seleziona solo combinazioni di segmenti compatibili:

La selezione di segmenti reciprocamente incompatibili nella clausola SELECT non supera la convalida della query e restituisce un errore QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Utilizza Google Ads Query Builder per convalidare le combinazioni di segmenti in modo interattivo.

Valuta le metriche di efficienza in termini di costi (metrics.cost_per_incremental_conversion* e metrics.incremental_conversion_value_per_cost*) solo nelle righe dello studio complessivo o nelle righe segments.experiment_arm. Nelle versioni 25 e 26 dell'API Google Ads, lo schema consente di selezionare le sei metriche del rapporto di costo (metrics.cost_per_incremental_conversion, metrics.cost_per_incremental_conversion_p90_lower_bound, metrics.cost_per_incremental_conversion_p90_upper_bound, metrics.incremental_conversion_value_per_cost, metrics.incremental_conversion_value_per_cost_p90_lower_bound e metrics.incremental_conversion_value_per_cost_p90_upper_bound) con gli otto segmenti di sezioni non arm (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country e segments.country_localized_name). A partire dalla versione 27 dell'API Google Ads, la selezione di una di queste sei metriche del rapporto di costo con uno di questi otto segmenti di sezioni non arm non supera la convalida della query e restituisce un errore QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Le metriche sul valore di conversione non basate sul costo (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* e metrics.relative_conversion_value_lift*) continuano a essere supportate nei segmenti di categoria di conversione, azione di conversione, dati demografici, dispositivo e paese ogni volta che è possibile generare report sul lift del valore di conversione (indipendentemente dal fatto che la metrica principale dello studio sia il numero di conversioni o il valore di conversione).

Per valutare il lift tra le categorie di conversione definite nell'enum ConversionActionCategory (ad esempio PURCHASE, SIGNUP o SUBMIT_LEAD_FORM), segmenta i risultati in base al segmento segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Il segmento segments.conversion_action restituisce il nome della risorsa dell'azione di conversione nel formato customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Seleziona il segmento segments.conversion_action_name nella risorsa lift_measurement_config per recuperare i nomi delle azioni di conversione leggibili senza eseguire query sulla risorsa conversion_action separatamente. La seguente query segmenta le metriche di conversion lift in base all'azione di conversione, al nome dell'azione di conversione e alla categoria di conversione:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

La seguente query segmenta le metriche di conversion lift in base al segmento segments.device. Sostituisci il segmento segments.age_range o segments.gender in richieste separate per recuperare le suddivisioni demografiche (facoltativamente combinate con i segmenti della categoria di conversione o dell'azione di conversione):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Per suddividere i risultati in base alla località, includi i segmenti segments.country e segments.country_localized_name (facoltativamente combinati con i segmenti della categoria di conversione o dell'azione di conversione). Il segmento segments.country restituisce un nome risorsa costante del target geografico globale nel formato geoTargetConstants/CRITERION_ID (ad esempio, geoTargetConstants/2840 per gli Stati Uniti).

La seguente query segmenta le metriche del conversion lift in base al nome della risorsa del criterio del paese e al nome del paese localizzato:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Report su test A/B + conversion lift

Nell'API Google Ads v25 e versioni successive, gli studi A/B + conversion lift combinano un esperimento a due gruppi (che confronta le strategie di controllo e di trattamento) con la misurazione del gruppo di controllo nell'API Google Ads per valutare l'incrementalità dei singoli gruppi e calcolare i punteggi dei vincitori bayesiani. A differenza dei report sugli esperimenti diretti sulla risorsa experiment, che confrontano le metriche del traffico non corrette tra i gruppi, l'esecuzione di query sulla risorsa lift_measurement_config con il segmento segments.experiment_arm misura l'incremento di ogni gruppo rispetto a una base di riferimento di controllo non esposta.

Scopri gli esperimenti e i gruppi

Uno studio A/B + conversion lift collega una risorsa LiftMeasurementConfig a una risorsa experiment a due gruppi tramite il campo experiment.lift_measurement_config di sola lettura (OUTPUT_ONLY).

Per scoprire l'esperimento collegato e i relativi gruppi in un'unica richiesta, esegui una query sulla risorsa ExperimentArm con i campi experiment attribuiti e applica un filtro al campo experiment.lift_measurement_config. La risposta include lo stato di controllo di ogni gruppo (experiment_arm.control), la suddivisione del traffico (experiment_arm.traffic_split), le campagne collegate (experiment_arm.campaigns) e il nome della risorsa. Utilizza il valore experiment_arm.resource_name restituito (formattato come customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) per filtrare in base al segmento segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

Sostituisci quanto segue:

  • CUSTOMER_ID: l'ID cliente di 10 cifre dell'account proprietario dello studio (senza trattini).
  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.

Se inizi da un EXPERIMENT_ID noto (o vuoi elencare tutti gli esperimenti con l'impatto attivato nell'account), esegui la stessa query experiment_arm filtrata per WHERE experiment.experiment_id = EXPERIMENT_ID (o WHERE experiment.lift_measurement_config IS NOT NULL).

Esegui query sui punteggi di incrementalità e vincitore per gruppo

Per misurare l'incrementalità di ogni gruppo e valutare la probabilità statistica che un gruppo sia quello vincente, includi il segmento segments.experiment_arm nella query alla risorsa lift_measurement_config.

Le seguenti metriche del punteggio del vincitore bayesiano valutano la probabilità (da 0.0 a 1.0, con somma pari a 1.0 per entrambi i gruppi quando entrambi hanno un lift positivo da segnalare) che un determinato gruppo sia superiore:

  • metrics.incremental_conversions_winner_score: la probabilità che questo gruppo sia il vincitore per le conversioni incrementali, normalizzata in base alla suddivisione del traffico del gruppo (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: la probabilità che questo gruppo sia il vincitore per il valore di conversione incrementale, normalizzata in base alla suddivisione del traffico del gruppo (experiment_arm.traffic_split). Nell'API Google Ads v27 e versioni successive, viene compilata solo quando la metrica principale dello studio è il valore di conversione e viene omessa (non impostata) negli studi con conteggio delle conversioni principale.
  • metrics.cost_per_incremental_conversion_winner_score: la probabilità che questo gruppo sia il vincitore per il costo per conversione incrementale (iCPA più basso), normalizzato in base alla spesa.
  • metrics.incremental_conversion_value_per_cost_winner_score: la probabilità che questo gruppo sia il vincitore per il valore di conversione incrementale per costo (iROAS più elevato), normalizzato in base alla spesa. Nell'API Google Ads v27 e versioni successive, viene compilato solo quando la metrica principale dello studio è il valore di conversione e viene omesso (non impostato) negli studi con conteggio delle conversioni principale.

La seguente query recupera i punteggi di incrementalità per gruppo e i punteggi bayesiani dei vincitori per entrambi i gruppi:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

Per filtrare in base a un singolo gruppo, aggiungi AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' alla clausola WHERE, dove EXPERIMENT_ID è l'ID esperimento e ARM_ID è l'ID gruppo restituito nel campo experiment_arm.resource_name. Il segmento segments.experiment_arm supporta l'applicazione di filtri nelle clausole WHERE (=, !=, IN, NOT IN), ma non puoi utilizzarlo per l'ordinamento in una clausola ORDER BY.

Interpreta i risultati dei test A/B + conversion lift

Uno studio A/B + conversion lift valuta due ipotesi contemporaneamente: la superiorità di un gruppo rispetto all'altro (metrics.*_winner_score) e il lift causale rispetto al gruppo di controllo non esposto (metrics.incremental_* e *_p_value). Mentre un periodo di pubblicazione dello studio ENABLED è ancora in corso (STUDY_IN_PROGRESS_*, quando la data corrente nel fuso orario del cliente è precedente o uguale a lift_measurement_flight.end_date), il confronto tra i gruppi e la modellazione delle conversioni del gruppo di controllo sono ancora in fase di stabilizzazione. Considera le metriche in corso come preliminari ed evita di promuovere un gruppo sperimentale o di riallocare i budget fino al completamento del periodo di pubblicazione.

Negli studi completati, un gruppo sperimentale viene classificato come vincitore del confronto diretto quando soddisfa le soglie di precisione minime (almeno 4 giorni di istantanea, 65 conversioni di riferimento non scalate e 150 conversioni esposte non scalate), ha 0 <= p_value <= 0.50 e ottiene un punteggio di vincitore bayesiano superiore a 0.55 (> 0.55) nella metrica principale dello studio. Questa valutazione a doppia ipotesi produce due stati distinti per il vincitore (riflessi anche in lift_guidance.outcome nell'API Google Ads v27 e versioni successive):

  • Vincitore netto con incremento causale (AB_WINNER_WITH_LIFT): il gruppo vincitore supera il gruppo concorrente nel confronto diretto (winner_score > 0.55) e genera conversioni incrementali o un valore di conversione statisticamente significativi rispetto al gruppo di controllo non esposto. Promuovi o scala la strategia del gruppo vincente ed esegui query sulle suddivisioni dimensionali per esaminare le coorti con un rendimento elevato.
  • Vincitore del confronto diretto alla pari con il gruppo di controllo (AB_WINNER_PARITY_VS_CONTROL): il gruppo vincente supera il gruppo concorrente nel confronto diretto (winner_score > 0.55), ma nessuno dei due gruppi produce un incremento statisticamente significativo rispetto al gruppo di controllo non esposto al livello richiesto. Prima di aumentare la spesa per il gruppo vincente, esegui una query sulle conversioni ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') e sulle suddivisioni segments.conversion_lift_conversion_category per verificare se il lift causale positivo è stato isolato altrove.

Il risultato POSITIVE_LIFT_DETECTED si applica alle granularità delle query di test A/B + conversion lift come segue:

  • Righe dello studio con gruppi combinati (OVERALL) (query senza segments.experiment_arm): lo studio ha generato un lift positivo rispetto al gruppo di controllo non esposto (p_value <= 0.50) e nessun gruppo ha ottenuto un punteggio di vincitore diretto superiore a 0.55.
  • Righe per gruppo (segments.experiment_arm): quando un gruppo vince (winner_score > 0.55) ed entrambi i gruppi ottengono un lift positivo rispetto al gruppo di controllo, la riga del gruppo vincente restituisce AB_WINNER_WITH_LIFT, mentre la riga del gruppo non vincente restituisce POSITIVE_LIFT_DETECTED.
  • Righe di suddivisione per categoria di conversione (segments.conversion_lift_conversion_category): le righe di lift positivo restituiscono sempre POSITIVE_LIFT_DETECTED perché i punteggi dei vincitori non vengono valutati per categoria di conversione.

Quando una sezione restituisce NOT_ENOUGH_DATA o NO_SIGNIFICANT_LIFT, non mettere in pausa i gruppi o escludere i segmenti di pubblico in base all'insufficienza del campione di una singola sezione. Controlla le metriche complessive dello studio e le conversioni ALL (segments.conversion_lift_included_conversion_action_types = 'ALL').

Esegui query sui risultati di studi combinati e multipli

Se ometti il segmento segments.experiment_arm da una query sulla risorsa lift_measurement_config, l'API restituisce l'incrementalità a livello di studio aggregata per entrambi i gruppi combinati. Nelle query sui gruppi combinati, ometti le quattro metriche metrics.*_winner_score, che si applicano solo ai gruppi concorrenti e vengono omesse (lasciate non impostate) nelle righe dei gruppi combinati senza segments.experiment_arm. Utilizza le query a livello di studio in Esegui query sul conversion lift e sul CPA incrementale ed Esegui query sul lift del valore di conversione e sul ROAS incrementale.

Quando segmenti i risultati di A/B + conversion lift in base al segmento segments.experiment_arm, l'API supporta solo il segmento segments.conversion_lift_conversion_category come dimensione di suddivisione aggiuntiva. Poiché la spesa del gruppo non è attribuita a singole categorie di conversione, valuta le metriche relative alle conversioni e al lift del valore di conversione (omettendo le metriche iCPA e iROAS, che non superano la convalida della query con un errore QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE nell'API Google Ads v27 e versioni successive) quando includi il segmento segments.conversion_lift_conversion_category. I segmenti segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name e segments.date non sono compatibili con il segmento segments.experiment_arm e con le metriche metrics.*_winner_score. La selezione di uno di questi segmenti incompatibili insieme a segments.experiment_arm restituisce un errore QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (e un errore QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE se la query seleziona anche una metrica metrics.*_winner_score).

Per recuperare i risultati per più configurazioni di studio in un'unica richiesta, filtra con l'operatore IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Sostituisci quanto segue:

  • CONFIG_ID_1: l'ID intero della prima configurazione della misurazione del lift.
  • CONFIG_ID_2: l'ID intero della seconda configurazione della misurazione dell'impatto.
  • START_DATE: la data di inizio dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260501).
  • END_DATE: la data di fine dello snapshot come numero intero YYYYMMDD a 8 cifre senza virgolette (ad esempio, 20260515).

L'uguaglianza esatta delle date (= START_DATE e = END_DATE) restituisce le righe solo per gli studi che condividono esattamente la stessa finestra di snapshot. Quando esegui query su studi con date di inizio del periodo di pubblicazione o date dell'ultima istantanea valutata diverse, applica un filtro con gli operatori di intervallo (>= e <=) o ometti i filtri delle date dalla clausola WHERE, mantenendo i segmenti segments.conversion_lift_start_date e segments.conversion_lift_end_date nella clausola SELECT.

Report sul search lift

Per misurare l'aumento del volume delle query di ricerca organica generato dalle tue campagne pubblicitarie nell'API Google Ads v26 e versioni successive, esegui una query sulle risorse dei report sul search lift. Il search lift quantifica la differenza nel comportamento di ricerca del tuo brand o dei tuoi prodotti tra gli utenti esposti ai tuoi annunci e un gruppo di controllo non esposto.

Risorse e segmentazione del search lift

Esegui una query sulla risorsa SearchLiftKeywordBundle per recuperare i dettagli sui gruppi di parole chiave configurati per gli studi del search lift. La risorsa SearchLiftKeywordBundle è di sola lettura nell'API Google Ads (tutti i campi sono OUTPUT_ONLY) e i gruppi di parole chiave vengono configurati nell'interfaccia utente di Google Ads o dal tuo rappresentante di Google o dal contatto GPS. I campi disponibili per le query in GAQL sono resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) e status (SearchLiftKeywordBundleStatus) (il campo ripetuto keywords non è selezionabile nelle query GAQL).

Esegui una query sulla risorsa LiftMeasurementConfig per recuperare le metriche di search lift e le configurazioni di studio complessive.

Nell'API Google Ads v27 e versioni successive, puoi anche selezionare il campo lift_measurement_config.lift_guidance di sola lettura (OUTPUT_ONLY) (lift_guidance.outcome e lift_guidance.guidance_message, di tipo LiftGuidance) nella clausola GAQL SELECT su lift_measurement_config quando esegui query su metriche o segmenti di search lift (segments.search_lift_keyword_bundle o segments.search_property). Su lift_measurement_config, lift_guidance viene omesso nelle query di configurazione di soli metadati e lift_guidance.guidance_message può contenere link Markdown incorporati (come [Learn more](https://support.google.com/...)). Per il search lift, lift_guidance.outcome restituisce STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (certezza di almeno il 70%, p_value <= 0.30), NO_SIGNIFICANT_LIFT o NOT_ENOUGH_DATA (valutato in base a soglie di almeno 1.000.000 di impressioni complessive o 100.000 impressioni di sezioni, almeno 75 ricerche osservate e almeno 17 bucket di cookie su 20, dove un singolo gruppo di parole chiave con un rendimento insufficiente fa sì che i risultati complessivi dello studio riportino NOT_ENOUGH_DATA).

Segmenta il rendimento del search lift in base alle seguenti dimensioni:

  • segments.search_lift_keyword_bundle: segmenta in base al nome della risorsa del gruppo di parole chiave. Compatibile con i segmenti segments.search_property, segments.date e demografici (segments.device, segments.age_range e segments.gender). Ogni gruppo di parole chiave genera report sul costo e sulle impressioni totali della campagna e le parole chiave possono appartenere a più di un gruppo. Non sommare le metriche metrics.search_lift_cost_micros, metrics.search_lift_impressions o del search lift tra i gruppi di parole chiave.
  • segments.search_property: segmenta in base alla proprietà di ricerca in cui è avvenuta la ricerca, definita dall'enum SearchLiftSearchProperty (ad esempio GOOGLE_SEARCH o YOUTUBE). Il segmento segments.search_property è compatibile solo con i segmenti segments.search_lift_keyword_bundle e segments.date. La combinazione di segments.search_property con i segmenti demografici (segments.device, segments.age_range o segments.gender) non supera la convalida della query. Poiché segments.search_property suddivide le ricerche organiche successive in base al luogo in cui si sono verificate anziché a quello in cui sono stati pubblicati gli annunci, le righe segmentate per segments.search_property ripetono il costo e le impressioni a livello di campagna non suddivisi nella versione 26 dell'API Google Ads. A partire dalla versione 27 dell'API Google Ads, tutte e otto le metriche di spesa e impressioni (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* e metrics.normalized_incremental_searches_per_impression*) non sono compatibili con segments.search_property e non superano la convalida delle query con un errore QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Segmenti demografici e di date: segments.device, segments.age_range, segments.gender e segments.date.

Metriche dell'impatto sulle ricerche

La risorsa LiftMeasurementConfig fornisce metriche sul search lift per valutare le variazioni del comportamento di ricerca:

  • metrics.relative_search_lift: la differenza nel volume delle query di ricerca tra il gruppo esposto e quello di controllo, espressa come frazione delle query di ricerca nel gruppo di controllo.
  • metrics.relative_search_lift_p90_lower_bound e metrics.relative_search_lift_p90_upper_bound: i limiti di confidenza unilaterali del 90% (che insieme formano un intervallo di confidenza bilaterale dell'80%) per il search lift relativo.
  • metrics.incremental_searches_p_value: il valore p per le ricerche incrementali, che rappresenta la probabilità statistica che l'aumento osservato delle query di ricerca si sia verificato per caso.
  • metrics.search_lift_cost_micros: il costo totale (in micro) delle impressioni dell'annuncio pubblicate per questa sezione di misurazione del search lift. Incompatibile con segments.search_property nell'API Google Ads v27 e versioni successive.
  • metrics.search_lift_impressions: il numero totale di impressioni dell'annuncio pubblicate per questa sezione di misurazione del search lift. Incompatibile con segments.search_property nell'API Google Ads v27 e versioni successive.

Le seguenti metriche incrementali normalizzate, insieme ai corrispondenti limiti di confidenza unilaterali del 90% (*_p90_lower_bound e *_p90_upper_bound), vengono riportate quando il lift è statisticamente positivo:

Esempi di query per il search lift

Le seguenti query GAQL mostrano come recuperare i gruppi di parole chiave e le metriche sul rendimento di Search Lift.

Query del gruppo di parole chiave

Per recuperare i gruppi di parole chiave configurati per le misurazioni del search lift, esegui una query sulla risorsa search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

Query sulle metriche

I valori search_lift_keyword_bundle.resource_name recuperati nella query del bundle di parole chiave corrispondono ai valori restituiti nel segmento segments.search_lift_keyword_bundle nella query seguente. Per scoprire CONFIG_ID, le campagne collegate e la pianificazione dei voli per il tuo studio, segui Scopri le configurazioni di studio e i voli nelle risorse lift_measurement_config e lift_measurement_flight (filtrando i voli per lift_measurement_flight.lift_type = 'SEARCH').

La seguente query recupera le metriche del search lift segmentate per gruppo di parole chiave e proprietà di ricerca (ometti segments.search_property quando selezioni metrics.search_lift_cost_micros o metrics.search_lift_impressions):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Sostituisci quanto segue:

  • CONFIG_ID: l'ID intero della configurazione della misurazione del lift.