Categorie di azioni di conversione

Questa guida fornisce un elenco dei diversi tipi di azioni di conversione che puoi creare utilizzando l'API Google Ads e informazioni su come questi tipi di azioni di conversione vengono mappati nell'interfaccia web di Google Ads.

Conversioni offline

Avviso: a partire dal 15 giugno 2026, UploadClickConversion non andranno a buon fine se il token sviluppatore non ha inviato in precedenza richieste per caricare le conversioni offline o le conversioni avanzate per i lead. Utilizza invece l'API Data Manager API . Per maggiori dettagli, consulta la sezione Funzionalità deprecate .

Le conversioni offline ti aiutano a monitorare gli eventi di conversione che si verificano al di fuori del mondo online, ad esempio in ufficio, nella sede dell'attività commerciale o per telefono.

La tabella seguente mostra i parametri API equivalenti ConversionActionType da utilizzare per ogni origine nell'interfaccia web di Google Ads e un link alla documentazione per ogni tipo di azione di conversione specifica:

Tipo di azione di conversione	Origine di Google Ads	Guida alla configurazione dell'API
UPLOAD_CLICKS	Monitorare le conversioni da clic e le conversioni avanzate per i lead	Utilizzare l'API Data Manager
UPLOAD_CALLS	Monitorare le conversioni generate dalle chiamate	Guida all'importazione delle conversioni di chiamata
STORE_SALES	Monitorare le conversioni per le vendite in negozio	Guida all'importazione delle conversioni per le vendite in negozio

Conversioni online (sul sito web)

Una conversione sul sito web ti consente di monitorare le azioni sul sito web, come le vendite online, i clic sui link, le visualizzazioni di pagina e le registrazioni.

Per monitorare le conversioni sul tuo sito web, devi creare un ConversionAction con il ConversionActionType impostato su WEBPAGE, e aggiungere uno snippet di codice chiamato tag alla pagina di conversione del tuo sito web.

Il ConversionAction comprende diversi tipi di conversioni sul sito web, che si distinguono all'interno dell'API per il type campo in ogni TagSnippet elencato nel campo tag_snippets di un ConversionAction.

Un TagSnippet fornisce il codice di monitoraggio che deve essere incluso nel tuo sito web per monitorare le azioni di conversione. Le conversioni sul sito web e clic sul numero di telefono richiedono event_snippet, che deve essere inserito nelle pagine web che indicano un'azione di conversione, ad esempio una pagina di conferma del pagamento o di invio del modulo per i lead, e global_site_tag, che deve essere installato su ogni pagina del tuo sito web. Puoi recuperare entrambi di questi attributi con il ConversionActionService. Per saperne di più su come aggiungere tag alle pagine, consulta il nostro Centro assistenza.

La tabella seguente mostra i parametri API equivalenti da utilizzare per ogni origine nell'interfaccia web di Google Ads:

Tipo di codice di monitoraggio	Origine di Google Ads
WEBPAGE	Sito web, Sito web (Google Analytics (GA4))
WEBPAGE_ONCLICK	Sito web, Sito web (Google Analytics (GA4))
CLICK_TO_CALL	Clic su numero di telefono

Nota: WEBPAGE e WEBPAGE_ONCLICK hanno le stesse origini di Sito web. La differenza sta nell'opzione Snippet di evento nell'interfaccia web. WEBPAGE corrisponde a Caricamento pagina per questa opzione, mentre WEBPAGE_ONCLICK corrisponde a Clic. Consulta questo articolo del Centro assistenza per maggiori informazioni.

Conversioni app

Una conversione da app ti consente di monitorare le installazioni di app mobile o gli acquisti in-app da Google Play Store.

La tabella seguente mostra i parametri API equivalenti ConversionActionType da utilizzare per ogni origine nell'interfaccia web di Google Ads:

Tipo di azione di conversione	Origine di Google Ads
GOOGLE_PLAY_DOWNLOAD	Google Play > Installazioni
GOOGLE_PLAY_IN_APP_PURCHASE	Google Play > Acquisti in-app

Per monitorare altre azioni di app mobile utilizzando le proprietà Google Analytics 4 o l'analisi delle app di terze parti, consulta Tipi di azioni di conversione aggiuntivi.

Nota: se specifichi anche il campo category, impostalo su DOWNLOAD solo se il tipo di conversione è GOOGLE_PLAY_DOWNLOAD.

Conversioni di chiamata

Il monitoraggio delle conversioni di chiamata ti consente di monitorare le chiamate dagli annunci, le chiamate a un numero sul tuo sito web e i clic sui numeri sui siti mobile.

La tabella seguente mostra i parametri API equivalenti ConversionActionType da utilizzare per ogni origine nell'interfaccia web di Google Ads:

Tipo di azione di conversione	Origine di Google Ads
AD_CALL	Chiamate da annunci che utilizzano le estensioni di chiamata o annunci di sola chiamata
WEBSITE_CALL	Chiamate a un numero di telefono sul tuo sito web
CLICK_TO_CALL	Clic su un numero nel tuo sito web per dispositivi mobili

AD_CALL

Un'azione di conversione AD_CALL viene visualizzata come una conversione Chiamate dagli annunci nell'interfaccia web di Google Ads. Dopo aver creato l'azione di conversione AD_CALL, specifica il relativo nome risorsa nel campo call_conversion_action quando crei un CallAsset. Gli asset di chiamata ti consentono di mostrare un numero di telefono direttamente negli annunci.

Una chiamata viene segnalata come conversione se dura più di una durata specificata. Il valore predefinito è 60 secondi.

WEBSITE_CALL

Un'azione di conversione WEBSITE_CALL viene visualizzata come una conversione Chiamate da un sito web nell' interfaccia web di Google Ads.

A differenza di AD_CALL, questo tracker richiede l'aggiunta di event_snippet e global_site_tag al tuo sito web per recuperare il numero di inoltro dinamico di Google per il monitoraggio delle chiamate sui numeri elencati sul tuo sito web. Inoltre, devi configurare un asset di chiamata e collegarlo a livello di cliente, campagna o gruppo di annunci.

CLICK_TO_CALL

Un'azione di conversione CLICK_TO_CALL viene visualizzata come una conversione Clic sul numero nel tuo sito web per dispositivi mobili nell' interfaccia web di Google Ads.

Il CLICK_TO_CALL tipo differisce dal AD_CALL tipo in quanto non monitora le chiamate effettive. Al contrario, CLICK_TO_CALL monitora solo i clic su un numero di telefono da un dispositivo mobile. Questa opzione è utile quando non puoi utilizzare un numero di inoltro di Google per monitorare le chiamate.

Conversioni avanzate

Avviso: a partire dal 15 giugno 2026, UploadClickConversion non andranno a buon fine se il token sviluppatore non ha inviato in precedenza richieste per caricare le conversioni offline o le conversioni avanzate per i lead. Utilizza invece l'API Data Manager API . Per maggiori dettagli, consulta la sezione Funzionalità deprecate .

Le conversioni avanzate ti aiutano a migliorare l'accuratezza della misurazione delle conversioni integrando i tag di conversione esistenti con dati sulle conversioni proprietari, come indirizzo email, nome, indirizzo di casa e numero di telefono.

La tabella seguente mostra i parametri API equivalenti da utilizzare per ogni tipo di conversione avanzata:

Tipo di azione di conversione	Tipo di conversione avanzata	Guida alla configurazione dell'API
UPLOAD_CLICKS	Conversioni avanzate per i lead Migliorano la misurazione delle transazioni offline provenienti da un lead o da un visitatore del sito web	Utilizzare l'API Data Manager
WEBPAGE	Conversioni avanzate per il web Migliorano la misurazione delle conversioni online	Guida alla configurazione dell'API

Tipi di azioni di conversione aggiuntivi

L'API Google Ads rende disponibili nei report altri tipi di azioni di conversione, ma potrebbe limitare o vietare la creazione o la modifica di queste azioni.

Conversioni SKAdNetwork

Se pubblichi campagne per app per iOS e hai implementato SKAdNetwork, puoi accedere ai dati di SKAdNetwork forniti a Google a livello di Customer e Campaign utilizzando le seguenti risorse:

Campo report	Descrizione
metrics.sk_ad_network_installs	Il numero di installazioni segnalate da Apple. Questa metrica può essere segmentata solo in base a una combinazione qualsiasi di segments.sk_ad_network_conversion_value e segmenti relativi alla data.
metrics.sk_ad_network_total_conversions	Il numero totale di conversioni, incluse le installazioni e altri tipi di conversioni segnalate da Apple. Questa metrica può essere segmentata solo in base ai segmenti relativi a SKAdNetwork e ai segmenti relativi alla data.
segments.sk_ad_network_ad_event_type	Il tipo di evento che si è verificato per una determinata conversione.
segments.sk_ad_network_attribution_credit	Come viene attribuito il merito per una determinata conversione.
segments.sk_ad_network_fine_conversion_value	Il valore di una conversione segnalata da Apple. Questo segmento non può essere applicato a metriche diverse da metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions, e può essere combinato solo con segmenti relativi alla data. Se Apple segnala un valore di 0, viene restituito un valore di 0, altrimenti non viene restituito alcun valore. Controlla la presenza del campo per distinguere tra i due casi.
segments.sk_ad_network_coarse_conversion_value	Il valore approssimativo per una singola conversione.
segments.sk_ad_network_postback_sequence_index	La posizione del postback, in sequenza, per una determinata conversione.
segments.sk_ad_network_source_app.sk_ad_network_source_app_id	L'ID app in cui è stato mostrato l'annuncio che ha generato l'installazione attraverso la rete pubblicitaria di iOS StoreKit.
segments.sk_ad_network_source_domain	Il sito web in cui è stato mostrato l'annuncio che ha generato l'installazione attraverso la rete pubblicitaria di iOS StoreKit. Un valore nullo indica che questo segmento non è applicabile, ad esempio, una campagna non per iOS, o non era presente in alcun postback inviato da Apple.
segments.sk_ad_network_source_type	Il tipo di origine in cui è stato mostrato l'annuncio che ha generato l'installazione attraverso la rete pubblicitaria di iOS StoreKit. Un valore nullo indica che questo segmento non è applicabile, ad esempio, campagna non per iOS, o che né il dominio di origine né l'app di origine erano presenti in alcun postback inviato da Apple.
segments.sk_ad_network_user_type	Il tipo di utente che ha generato una determinata conversione.
segments.sk_ad_network_redistributed_fine_conversion_value	I valori di conversione in questo segmento includono i valori nulli che sono stati ridistribuiti ai valori di conversione. Questo segmento rappresenta la somma dei valori di conversione precisi osservati restituiti da Apple e dei valori nulli modellati da Google.
segments.sk_ad_network_version	La versione dell'API della rete pubblicitaria di iOS StoreKit utilizzata.

Google Analytics

Le conversioni da una proprietà Google Analytics collegata hanno uno dei seguenti type valori:

• Conversione della proprietà GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  Puoi anche recuperare l'ID proprietà GA4, il nome della proprietà e il nome dell'evento da the google_analytics_4_settings campo.

Puoi apportare le seguenti modifiche a una conversione della proprietà GA4:

• Importa la conversione dalla proprietà GA4 nel tuo account Google Ads modificando il campo status da HIDDEN a ENABLED.
• Modifica i campi primary_for_goal e category per indicare in che modo deve influire sulle offerte e sui report di Google Ads.
• Aggiorna name o value_settings.
• Rimuovi la conversione dal tuo account Google Ads utilizzando un'operazione remove.

Qualsiasi tentativo di modificare altri attributi di una conversione GA4 importata o qualsiasi attributo di una conversione Universal Analytics importata genera un errore MUTATE_NOT_ALLOWED. Puoi apportare queste modifiche solo utilizzando l'interfaccia utente di Google Ads.

Firebase e analisi delle app di terze parti

Per importare le conversioni di analisi delle app di terze parti o di Firebase, modifica lo status dello ConversionAction da HIDDEN a ENABLED utilizzando il metodo mutate di ConversionActionService. L'aggiornamento di app_id non è supportato per queste azioni di conversione.

• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Vendite in negozio: importazione nell'azione di conversione con report

Sebbene non sia possibile creare STORE_SALES o STORE_SALES_DIRECT_UPLOAD azioni di conversione utilizzando l'API Google Ads, l'API supporta l'importazione delle vendite in negozio.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

Tipi di azioni di conversione di sola lettura

I seguenti tipi di azioni di conversione sono di sola lettura nell'API Google Ads e vengono forniti a scopo di report.

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• LEAD_FORM_SUBMIT
• SALESFORCE
• SEARCH_ADS_360
• SMART_CAMPAIGN_AD_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
• SMART_CAMPAIGN_MAP_DIRECTIONS
• SMART_CAMPAIGN_TRACKED_CALLS
• STORE_VISITS
• WEBPAGE_CODELESS

Sconosciuto

Se il tuo account Google Ads include altri tipi di azioni di conversione, potresti notare che le query e i report restituiscono azioni di conversione in cui il ConversionAction.type è UNKNOWN. L'API non supporta la gestione di queste azioni di conversione, ma le restituisce nei report per fornire risultati completi per le metriche di conversione chiave come metrics.conversions e metrics.conversions_value.