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.

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 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	Guida alla gestione delle conversioni offline Guida alle conversioni avanzate per i lead
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	Guida all'importazione delle conversioni per le vendite in negozio

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 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 ulteriori informazioni su come taggare le tue 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 del sito web. La differenza sta 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 di 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 dati 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 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 per dispositivi mobili

AD_CALL

Un'azione di conversione AD_CALL viene visualizzata come conversione Chiamate da annunci nell'interfaccia web di Google Ads. Dopo aver creato l'azione di conversione AD_CALL, specifica il nome della 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 una durata specificata. 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 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 conversione Clic sul tuo numero sul 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

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 ciascun 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	Guida alla configurazione dell'API
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 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, metrics.sk_ad_network_total_conversions e può essere combinato solo con segmenti correlati alla data. Viene restituito il valore 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, oppure 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 precisi 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 di app di terze parti

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

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.