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 vengono mappate nell'interfaccia web di Google Ads.

Scegliere il tipo di azione di conversione giusto

Per scegliere il tipo di azione di conversione e la guida alla configurazione corretti per la tua integrazione, utilizza il seguente percorso decisionale:

1. Dove si verifica l'evento di conversione?

   • Nel mondo offline (ad esempio, in ufficio, nella sede dell'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.
   • Tramite una chiamata telefonica composta direttamente dai tuoi annunci: utilizza Chiamate dagli annunci (AD_CALL) (utilizzando CallAsset).

2. Conversioni offline:

   • È una chiamata?

     • Sì: utilizza

       Importazione conversioni di chiamata (UPLOAD_CALLS) per monitorare i risultati delle chiamate.

   • Si tratta di una vendita in negozio fisico?

     • Sì: utilizza

       Conversioni per le vendite in negozio (STORE_SALES).

   • Si tratta di una vendita offline o di un avanzamento del lead derivante da una visita al sito web?

     • Sì:utilizza le conversioni avanzate per i lead tramite l'API Data Manager. (Nota: il caricamento delle conversioni associate ai clic tramite UPLOAD_CLICKS o UploadClickConversion è ritirato a partire dal 15 giugno 2026).

3. 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 WEBPAGE o WEBPAGE_ONCLICK.

   • Vuoi monitorare le chiamate generate da un numero di telefono indicato 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 (just track button/link clicks on mobile site)? Utilizza

         Clic sul tuo numero di cellulare (CLICK_TO_CALL).

4. Conversioni da app mobile:

   • Il monitoraggio delle installazioni o degli acquisti dal Google Play Store è sufficiente?
     • Sì:utilizza le conversioni da app (GOOGLE_PLAY_DOWNLOAD o GOOGLE_PLAY_IN_APP_PURCHASE).

   • Monitori le azioni nell'app utilizzando Google Analytics (GA4) o un servizio di analisi dell'app di terze parti?

     • Sì: utilizza

       Firebase e analisi di app di terze parti (attivando le azioni di conversione FIREBASE_* o THIRD_PARTY_*).

Conversioni offline

Avviso: a partire dal 15 giugno 2026, le richieste 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 l'API Data Manager in alternativa. Per maggiori dettagli, consulta la sezione Ritiro delle funzionalità.

Nota: i token sviluppatore sono stati ritirati a favore dei progetti Google Cloud, ma questa limitazione dell'accesso storico rimane in vigore.

Le conversioni offline ti aiutano a monitorare gli eventi di conversione che si verificano offline, ad esempio nel tuo ufficio, nella sede della tua attività o per telefono.

La tabella seguente mostra i parametri API ConversionActionType equivalenti 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 Google Ads	Guida alla configurazione dell'API
UPLOAD_CLICKS	Monitora le conversioni da clic e le conversioni avanzate per i lead	Utilizzare l'API Data Manager
UPLOAD_CALLS	Monitora le conversioni generate dalle chiamate	Guida all'importazione delle conversioni di chiamata
STORE_SALES	Monitorare le conversioni per le vendite in negozio	Per saperne di più, consulta Vendite in negozio: importazione nell'azione di conversione con report.

Conversioni online (sito web)

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

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

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 azioni di conversione. Le conversioni Sito web e Clic sul numero di telefono richiedono il 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 il global_site_tag, che deve essere installato in ogni pagina del tuo sito web. Puoi recuperare entrambi questi attributi con ConversionActionService. Consulta il nostro Centro assistenza per saperne di più su come taggare le pagine.

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 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 risiede nell'opzione Snippet evento nell'interfaccia web. WEBPAGE corrisponde a Caricamento pagina per questa opzione, mentre WEBPAGE_ONCLICK corrisponde a Clic. Per saperne di più, consulta questo articolo del Centro assistenza.

Conversioni app

Una conversione da app ti consente di monitorare le installazioni di app mobile o gli acquisti in-app dal 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 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 dell'app di terze parti, consulta Tipi di azioni di conversione aggiuntive.

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

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 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 mobile

AD_CALL

Un'azione di conversione AD_CALL viene visualizzata come 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 nei tuoi annunci.

Una chiamata viene registrata come conversione se dura più di un periodo di tempo specificato. Il valore predefinito è 60 secondi.

WEBSITE_CALL

Un'azione di conversione WEBSITE_CALL viene visualizzata come 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 ai numeri elencati sul tuo sito web. Inoltre, devi configurare un asset di chiamata e

collegalo a livello di cliente, campagna o gruppo di annunci.

CLICK_TO_CALL

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

Il tipo CLICK_TO_CALL è diverso dal tipo AD_CALL in quanto non monitora le chiamate effettive. 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, le richieste 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 l'API Data Manager in alternativa. Per maggiori dettagli, consulta la sezione Ritiro delle funzionalità.

Nota: i token sviluppatore sono stati ritirati a favore dei progetti Google Cloud, ma questa limitazione dell'accesso storico rimane in vigore.

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 Migliora 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 ulteriori 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 qualsiasi combinazione 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 a segmenti correlati a SKAdNetwork e 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 per una determinata conversione.
segments.sk_ad_network_fine_conversion_value	Il valore di una conversione segnalato da Apple. Questo segmento non può essere applicato a metriche diverse da metrics.sk_ad_network_installs e metrics.sk_ad_network_total_conversions e può essere combinato solo con segmenti correlati alla data. Viene restituito un valore di 0 se Apple segnala un valore di 0 e nessun valore altrimenti. Controlla la presenza del campo per distinguere i due casi.
segments.sk_ad_network_coarse_conversion_value	Il valore approssimativo di 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 attraverso la rete pubblicitaria di iOS StoreKit.
segments.sk_ad_network_source_domain	Il sito web in cui è stato pubblicato 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 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 attraverso la rete pubblicitaria di iOS StoreKit. Un valore nullo indica che questo segmento non è applicabile, ad esempio una campagna non iOS, oppure 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 valori null che sono stati ridistribuiti ai valori di conversione. Questo segmento rappresenta la somma dei valori di conversione esatti osservati restituiti da Apple e dei valori null modellati da Google.
segments.sk_ad_network_version	La versione dell'API StoreKit Ad Network di iOS utilizzata.

Google Analytics

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

• Conversione 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 dal campo google_analytics_4_settings.

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 il relativo 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 dell'app di terze parti

Per importare le conversioni di analisi di app di terze parti o Firebase, modifica status di 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

Importante: esegui l'upgrade dei tuoi workflow di vendita in negozio all'API Data Manager per un'esperienza di sviluppo migliorata e l'accesso a funzionalità aggiuntive. Non consigliamo di implementare nuovi workflow per le vendite in negozio utilizzando l'API Google Ads.

Sebbene non sia possibile creare azioni di conversione STORE_SALES o STORE_SALES_DIRECT_UPLOAD utilizzando l'API Google Ads, l'API supporta l'importazione delle transazioni di vendita 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 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.