Risoluzione dei problemi

La gestione delle conversioni richiede un'integrazione complessa, spesso con più strumenti e processi interdipendenti. Questa guida offre passaggi dettagliati che puoi seguire per risolvere eventuali problemi, che si tratti di errori dell'API che non comprendi o se hai dubbi sulle metriche o sulla diagnostica visualizzata nella UI.

Lettura delle metriche nella UI di Google Ads

L'interfaccia utente di Google Ads non organizza le metriche di conversione in base alla data di importazione, pertanto l'utilizzo dei report nell'interfaccia utente per verificare i risultati dell'importazione può essere fuorviante. Per verificare l'integrità dell'importazione, inizia con la diagnostica dei dati offline. Puoi anche scoprire di più sulla diagnostica nell'interfaccia utente Google Ads per le conversioni avanzate per i lead e le conversioni avanzate per il web.

Problemi con le conversioni avanzate per i lead

Questa sezione si concentra sulla risoluzione dei problemi comuni riscontrati durante l'importazione delle conversioni avanzate per i lead.

Errori comuni

Le seguenti indicazioni ti aiutano a diagnosticare e correggere gli errori comuni relativi alle conversioni avanzate per i lead.

Errore
NO_CONVERSION_ACTION_FOUND	L'azione di conversione specificata non è attivata o non è accessibile all'account cliente specificato dal campo customer_id nella richiesta. Assicurati che l'azione di conversione nel caricamento sia abilitata e di proprietà del cliente che invia la richiesta di caricamento. Questo errore può verificarsi anche se il GCLID nella richiesta appartiene a un account cliente che non ha accesso all'azione di conversione specificata nella richiesta. Puoi verificare se un GCLID appartiene a un account cliente utilizzando la risorsa click_view inviando una query che filtra in base a click_view.gclid e segments.date, dove la data è quella in cui si è verificato il clic.
INVALID_CONVERSION_ACTION_TYPE	Il tipo di azione di conversione specificato non è valido per le conversioni avanzate per i lead. Assicurati che ConversionAction specificato nella richiesta di caricamento sia di tipo UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Assicurati di aver attivato le conversioni avanzate per i lead nelle impostazioni delle conversioni. Trova le istruzioni in merito nella guida ai prerequisiti.
DUPLICATE_ORDER_ID	Gli eventi importati includono più conversioni con lo stesso ID ordine e non sono stati elaborati. Assicurati che gli ID ordine siano univoci e riprova.
CLICK_NOT_FOUND	Non è stato trovato alcun clic corrispondente agli identificatori utente forniti. Se una conversione genera questo avviso, l'API Google Ads lo include in successful_event_count della diagnostica dei dati offline. L'API Google Ads include una voce per CLICK_NOT_FOUND nella raccolta alerts, in modo da poter monitorare la frequenza di questo avviso. Questo errore è previsto se il clic non proviene da una campagna Google Ads. Ad esempio, potrebbe provenire da SA360 o DV360. Altre possibili cause sono le seguenti: Il cliente che carica i dati è diverso dal cliente di conversione Google Ads. Il tagging non è configurato correttamente per il tuo modulo per i lead. I dati caricati non sono stati normalizzati e sottoposti ad hashing correttamente. In rari casi in cui il cliente che carica i dati è diverso dal cliente di conversione Google Ads, questo errore può significare che il cliente che carica i dati ha accettato i termini relativi ai dati dei clienti, ma il cliente che pubblica gli annunci no. Puoi determinare se un account ha accettato i termini relativi ai dati dei clienti eseguendo una query sulla risorsa customer e controllando il campo customer.conversion_tracking_setting.accepted_customer_data_terms.

Discrepanze nelle metriche

Tieni presente i seguenti problemi comuni:

• Le conversioni potrebbero essere eliminate dalla nostra pipeline di elaborazione per vari motivi e non sono recuperabili. Per saperne di più, consulta la sezione Discrepanze nei dati dopo un caricamento riuscito.

• Verifica che il tag Google sia configurato correttamente sulla tua pagina web e che si attivi in base agli invii di moduli per i lead. Se il tag non viene attivato all'invio dei moduli o se invia dati errati, è probabile che l'attribuzione nelle conversioni caricate sia bassa o nulla. Consulta gli articoli del Centro assistenza su come configurare il tag Google e come configurare Google Tag Manager per le conversioni avanzate per i lead.

• Se utilizzi le conversioni avanzate per i lead senza il tag Google sulla tua pagina web, devi includere il GCLID nelle importazioni delle conversioni impostando il campo ClickConversion.gclid per ogni conversione.

• Verifica di specificare correttamente il consenso nei caricamenti. Puoi farlo impostando le impostazioni di consenso predefinite per il tuo account (nell'interfaccia utente di Google Ads, fai clic su Strumenti > Data Manager > Impostazioni relative al consenso) o impostando il campo ClickConversion.consent per ogni conversione caricata.

Problemi con il rendimento della campagna

Se non riscontri problemi tecnici durante il caricamento delle conversioni e ti trovi a tuo agio con le metriche presentate, ma non noti i miglioramenti previsti del rendimento della campagna o "lift" dopo l'implementazione delle conversioni avanzate per i lead, contatta l'assistenza per i prodotti Google Ads per ricevere aiuto.

Problemi relativi alle conversioni avanzate per il web

Questa sezione si concentra sulla risoluzione dei problemi comuni riscontrati durante l'importazione delle conversioni avanzate per il web.

Errori comuni

Le seguenti indicazioni ti aiutano a diagnosticare e correggere gli errori comuni relativi alle conversioni avanzate per il web.

Errore
CONVERSION_NOT_FOUND	Non è stato possibile trovare una conversione per la coppia di azione di conversione e identificatore di conversione fornita o order_id. Verifica che la conversione sia una conversione Google Ads per il cliente di conversione Google Ads specificato in customer_id della richiesta. Inoltre, verifica che la conversione non sia stata generata da un clic in cui sono stati compilati gbraid o wbraid anziché gclid. Google Ads non supporta le conversioni avanzate per il web per queste conversioni.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	I termini e le condizioni relativi ai dati dei clienti non sono stati accettati per il customer_id della richiesta. Trova le istruzioni in merito nella guida ai prerequisiti.
CONVERSION_ALREADY_ENHANCED	Questa conversione ha già ricevuto un aggiustamento con i valori order_id e conversion_action. Assicurati di fornire un order_id univoco per ogni conversione.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Il conversion_action fornito non è idoneo per le conversioni avanzate per il web. Nell'interfaccia utente di Google Ads, assicurati di selezionare la casella Attiva le conversioni avanzate nell'azione di conversione a cui fa riferimento la tua richiesta. Trova le istruzioni per questa operazione nel Centro assistenza.

Problemi generali di gestione delle conversioni

Tieni presente i seguenti problemi comuni:

• Se tenti di impostare un campo enum su UNKNOWN, verrà visualizzato un errore RequestError.INVALID_ENUM_VALUE. Si tratta di un problema comune quando si specifica consent quando l'inserzionista potrebbe non sapere se è stato dato il consenso. Se lo stato di consent è sconosciuto, deve essere impostato su DENIED.

• Quando crei un'azione di conversione per le conversioni da app o per Firebase e l'analisi delle app di terze parti, puoi modificare solo il campo app_id durante la creazione; una volta creata l'azione di conversione, questo campo non può essere modificato.

• Quando crei un'azione di conversione, puoi impostare il campo ConversionAction.attribution_model_settings.attribution_model su GOOGLE_ADS_LAST_CLICK o GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Qualsiasi altra opzione comporterà un errore CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Il nostro post del blog che annuncia il ritiro di altri modelli di attribuzione contiene maggiori dettagli.

• L'intervallo consentito per il campo click_through_lookback_window_days è da 1 a 60 giorni per le azioni di conversione di tipo AD_CALL e WEBSITE_CALL. Per la maggior parte delle altre azioni di conversione, l'intervallo consentito è da 1 a 90 giorni.

• L'intervallo consentito per il campo view_through_lookback_window_days è da 1 a 30 giorni per la maggior parte delle azioni di conversione. Questo campo deve essere non impostato per le azioni di conversione di tipo AD_CALL e WEBSITE_CALL.

• L'impostazione o l'aggiornamento del campo include_in_conversions_metric in un'azione di conversione comporterà un errore FieldError.IMMUTABLE_FIELD. Imposta invece il campo primary_for_goal, come descritto nella guida agli obiettivi di conversione.

• Quando crei un'azione di conversione di tipo WEBSITE_CALL o AD_CALL, il value_settings.always_use_default_value deve essere impostato su true. Se specifichi un valore di false, verrà generato un errore INVALID_VALUE.

Errori comuni

Le seguenti indicazioni ti aiutano a diagnosticare e correggere gli errori comuni relativi alle importazioni delle conversioni offline.

Errore
INVALID_CONVERSION_ACTION_TYPE	L'azione di conversione specificata ha un tipo non valido per il caricamento delle conversioni da clic. Assicurati che ConversionAction specificato nella richiesta di caricamento sia di tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND	L'azione di conversione specificata non è abilitata o non è possibile trovarla all'interno del caricamento di customer_id. Recupera informazioni sulla configurazione delle conversioni per assicurarti che l'azione di conversione nel caricamento sia attivata e di proprietà del customer_id della richiesta di caricamento.
TOO_RECENT_CONVERSION_ACTION	L'azione di conversione è stata appena creata. Attendi almeno 6 ore dopo la creazione dell'azione prima di riprovare le conversioni non riuscite.
INVALID_CUSTOMER_FOR_CLICK	L'customer_id della richiesta non corrisponde all'ID cliente che era l'account delle conversioni dell'API Google Ads al momento del clic. Aggiorna il customer_id della richiesta con il cliente corretto.
EVENT_NOT_FOUND	Google Ads non riesce a trovare la combinazione di ID clic e customer_id. Esamina i requisiti per customer_id e verifica di eseguire il caricamento utilizzando l'account Google Ads corretto.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	Più conversioni nella richiesta hanno la stessa combinazione di ID clic, conversion_date_time e conversion_action. Rimuovi le conversioni duplicate dalla richiesta.
CLICK_CONVERSION_ALREADY_EXISTS	È stata caricata in precedenza una conversione con la stessa combinazione di ID clic, conversion_date_time e conversion_action. Ignora questo errore se stavi riprovando a caricare e questa conversione è riuscita in precedenza. Se vuoi aggiungere un'altra conversione oltre a quella caricata in precedenza, modifica il conversion_date_time di ClickConversion per evitare di duplicare la conversione caricata in precedenza.
EVENT_NOT_FOUND	Google Ads non riesce a trovare la combinazione di ID clic e customer_id. Esamina i requisiti per customer_id e verifica di eseguire il caricamento utilizzando l'account Google Ads corretto.
EXPIRED_EVENT	Il clic importato si è verificato prima del periodo di tempo specificato nel campo click_through_lookback_window_days. Una modifica al click_through_lookback_window_days influisce solo sui clic registrati dopo la modifica, pertanto la modifica della finestra temporale non risolverebbe questo errore per il clic specifico. Se opportuno, modifica l'conversion_action con un'altra azione con una finestra temporale più lunga.
CONVERSION_PRECEDES_EVENT	conversion_date_time è precedente alla data e all'ora del clic. Aggiorna conversion_date_time a un valore successivo.
GBRAID_WBRAID_BOTH_SET	ClickConversion ha un valore impostato sia per gbraid che per wbraid. Aggiorna la conversione in modo che utilizzi un solo ID clic o parametro URL e assicurati di non combinare più clic nella stessa conversione. Ogni clic ha un solo ID clic o parametro URL.
VALUE_MUST_BE_UNSET	Controlla il location di GoogleAdsError per determinare quale dei seguenti problemi ha causato l'errore. ClickConversion ha un valore impostato per gclid e almeno uno tra gbraid o wbraid. Aggiorna la conversione in modo che utilizzi un solo ID clic o parametro URL e assicurati di non combinare più clic nella stessa conversione. Ogni clic ha un solo ID clic o parametro URL. ClickConversion ha un valore impostato per gbraid o wbraid e ha un valore per custom_variables. Google Ads non supporta le variabili personalizzate per una conversione con un parametro URL gbraid o wbraid. Imposta il campo custom_variables della conversione.