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.
Scegliere il tipo di azione di conversione corretto
Per selezionare il tipo di azione di conversione e la guida alla configurazione corretti per la tua integrazione, segui questo percorso decisionale:
Dove si verifica l'evento di conversione?
- Nel mondo offline (ad esempio nel tuo ufficio, nella sede della tua attività o per telefono): vai al passaggio 2.
- Direttamente sul tuo sito web (ad esempio acquisti sul sito web, registrazioni, o invii di moduli): vai al passaggio 3.
- All'interno di un'app mobile: vai al passaggio 4.
- Durante una telefonata effettuata direttamente dagli annunci: utilizza Chiamate dagli
annunci (
AD_CALL) (utilizzandoCallAsset).
Conversioni offline:
- Si tratta di una telefonata?
- Sì: utilizza Importazione delle conversioni di chiamata (
UPLOAD_CALLS) per monitorare i risultati delle chiamate.
- Sì: utilizza Importazione delle conversioni di chiamata (
- Si tratta di una vendita in un negozio fisico?
- Sì: utilizza Conversioni per le vendite in negozio (
STORE_SALES).
- Sì: utilizza Conversioni per le vendite in negozio (
- Si tratta di una vendita offline o di una progressione dei lead derivante da una visita al sito web?
- Sì: utilizza Conversioni avanzate per i lead tramite l'API Data
Manager.
(Nota: il caricamento delle conversioni da clic utilizzando
UPLOAD_CLICKSoUploadClickConversionè stato ritirato a partire dal 15 giugno 2026).
- Sì: utilizza Conversioni avanzate per i lead tramite l'API Data
Manager.
(Nota: il caricamento delle conversioni da clic utilizzando
- Si tratta di una telefonata?
Conversioni online (sul sito web):
- Vuoi monitorare i caricamenti di pagina (acquisti, ricevute) o i clic degli utenti?
- Sì: utilizza Conversioni sul sito web con lo snippet del tag impostato
su
WEBPAGEoWEBPAGE_ONCLICK.
- Sì: utilizza Conversioni sul sito web con lo snippet del tag impostato
su
- Vuoi monitorare le chiamate generate da un numero di telefono elencato sul tuo
sito web?
- Monitorare le durate effettive delle chiamate?
- Sì: utilizza Chiamate da un sito web (
WEBSITE_CALL) con uno snippet evento del tag e un numero di inoltro di Google dinamico. - No (monitorare solo i clic sui pulsanti/link sul sito mobile)? Utilizza
Clic sul tuo numero di telefono cellulare (
CLICK_TO_CALL).
- Sì: utilizza Chiamate da un sito web (
- Monitorare le durate effettive delle chiamate?
- Vuoi monitorare i caricamenti di pagina (acquisti, ricevute) o i clic degli utenti?
Conversioni di app mobile:
- È sufficiente monitorare le installazioni o gli acquisti dal Google Play Store?
- Sì: utilizza Conversioni app (
GOOGLE_PLAY_DOWNLOADoGOOGLE_PLAY_IN_APP_PURCHASE).
- Sì: utilizza Conversioni app (
- Monitori le azioni in-app utilizzando Google Analytics (GA4) o
analisi di app di terze parti?
- Sì: utilizza Firebase e analisi dell'app di terze parti (attivando le azioni di conversione
FIREBASE_*oTHIRD_PARTY_*).
- Sì: utilizza Firebase e analisi dell'app di terze parti (attivando le azioni di conversione
- È sufficiente monitorare le installazioni o gli acquisti dal Google Play Store?
Conversioni offline
Le conversioni offline ti aiutano a monitorare gli eventi di conversione che si verificano nel mondo offline, ad esempio nel tuo ufficio, nella sede della tua attività 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 specifico:
| 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
sul tuo sito web.
Il ConversionAction comprende diversi
tipi di conversioni sul sito web, distinti all'interno dell'API dal campo type 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 tue azioni di conversione.
Le conversioni 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 questi attributi con il
ConversionActionService. Per ulteriori informazioni su come taggare le 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 |
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 ConversionActionType
equivalenti 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 in-app utilizzando le proprietà Google Analytics 4 o analisi dell'app di terze parti, consulta Tipi di azioni di conversione aggiuntivi.
Conversioni dalle telefonate
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 ConversionActionType
equivalenti 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
Chiamate dagli annunci conversione 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
Chiamate da un sito web conversione 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 di Google dinamico per il monitoraggio delle chiamate sui numeri elencati su
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
Clic sul tuo numero nel tuo sito web per dispositivi mobili conversione nell'interfaccia web di Google Ads.
Il tipo CLICK_TO_CALL differisce dal tipo AD_CALL in quanto
non monitora le chiamate telefoniche 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 telefoniche.
Conversioni avanzate
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 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 correlati 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 correlati a SKAdNetwork e ai segmenti correlati 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 dell'attribuzione 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 Se Apple segnala un valore di
|
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 pubblicato l'annuncio che ha generato l'installazione tramite la rete pubblicitaria di iOS StoreKit è stato mostrato. |
segments.sk_ad_network_source_domain |
Il sito web in cui è stato pubblicato l'annuncio che ha generato l'installazione tramite la rete pubblicitaria di iOS StoreKit è stato mostrato. Un valore null significa 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 pubblicato l'annuncio che ha generato l'installazione tramite la rete pubblicitaria di iOS StoreKit è stato mostrato. Un valore null significa che questo segmento non è applicabile, ad esempio una 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 null 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 null 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 valori type:
Conversione della proprietà GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Puoi anche recuperare l'ID proprietà GA4, il nome della proprietà e il nome dell'evento dal
google_analytics_4_settingscampo.
Puoi apportare le seguenti modifiche a una conversione della proprietà GA4:
- Importa la conversione dalla proprietà GA4 nel tuo account Google Ads modificando il relativo campo
statusdaHIDDENaENABLED. - Modifica i campi
primary_for_goalecategoryper indicare in che modo deve influire sulle offerte e sui report di Google Ads. - Aggiorna il relativo
nameovalue_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 dell'app di terze parti
Per importare le conversioni di analisi delle app di terze parti o di Firebase, modifica lo stato di ConversionAction da HIDDEN a ENABLED utilizzando il metodo mutate di ConversionActionService.statusConversionActionHIDDENENABLEDmutateConversionActionService L'aggiornamento di
app_id non è supportato per queste azioni di conversione.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_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_SALESSTORE_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_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_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.