Risoluzione dei problemi

La gestione delle conversioni richiede un'integrazione complessa, che spesso coinvolge più strumenti e processi interdipendenti. Questa guida offre passaggi dettagliati che puoi seguire per risolvere eventuali problemi, ad esempio se ricevi errori dall'API che non comprendi o se non capisci le metriche o la diagnostica che vedi nella UI.

Leggere le metriche nella UI di Google Ads

La UI di Google Ads non organizza le metriche di conversione in base alla data di importazione, pertanto l'utilizzo dei report nella UI per verificare i risultati dell'importazione può essere fuorviante. Per verificare l'integrità dell'importazione, inizia con la diagnostica offline. Puoi anche scoprire di più sulla diagnostica nella UI di 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

Errore
NO_CONVERSION_ACTION_FOUND

L'azione di conversione specificata non è attiva o non è accessibile dall'account cliente specificato dal campo `client_id` nella richiesta. Assicurati che l'azione di conversione nel caricamento sia attiva 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 click_view risorsa, 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 l'oggetto ConversionAction specificato nella richiesta di caricamento abbia il tipo UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Assicurati di aver attivato le conversioni avanzate per i lead nelle tue impostazioni di conversione. Trova le istruzioni 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. L'API Google Ads restituisce questo errore solo se debug_enabled è true in UploadClickConversionsRequest.

Se una conversione genera questo avviso, l'API Google Ads la include in successful_event_count della diagnostica dei dati offline. L' API Google Ads include una voce per CLICK_NOT_FOUND nella alerts raccolta, in modo che tu possa 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. Di seguito sono riportate altre possibili cause:

In rari casi in cui il cliente che esegue il caricamento è diverso dal cliente di conversione di Google Ads questo errore può significare che il cliente che esegue il caricamento ha accettato i termini relativi ai dati dei clienti, ma il cliente di pubblicazione no.

Puoi determinare se un account ha accettato i termini relativi ai dati dei clienti eseguendo una query sulla customer risorsa e controllando il customer.offline_conversion_tracking_info.accepted_customer_data_terms campo.

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 ulteriori informazioni, consulta l'articolo Discrepanze nei dati dopo un caricamento riuscito.

  • Verifica che il tag Google sia configurato correttamente sulla pagina web e che venga attivato per gli invii dei moduli per i lead. Se il tag non viene attivato per gli invii dei moduli o se invia dati errati, è probabile che vedrai un'attribuzione bassa o nulla nelle conversioni caricate. Consulta gli articoli del Centro assistenza sulla configurazione del tag Google e la configurazione di Google Tag Manager per le conversioni avanzate per i lead.

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

  • Verifica di specificare correttamente il consenso nei caricamenti. Puoi farlo impostando le impostazioni di consenso predefinite per il tuo account (nella UI di Google Ads, fai clic su Strumenti -> Gestore dati -> Impostazioni consenso) o impostando il campo ClickConversion.consent su ogni conversione caricata.

Problemi con il rendimento della campagna

Se non riscontri problemi tecnici durante il caricamento delle conversioni e hai familiarità con le metriche presentate, ma non vedi i miglioramenti del rendimento della campagna previsti o l'"aumento" dopo l'implementazione delle conversioni avanzate per i lead, contatta l' assistenza per i prodotti Google Ads per ricevere aiuto.

Problemi con le 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

Errore
CONVERSION_NOT_FOUND Non è stato possibile trovare una conversione per la coppia di identificatori di conversione e azione di conversione fornita o per order_id Verifica che la conversione sia una conversione Google Ads per il cliente di conversione di Google Ads specificato in customer_id della richiesta.
Inoltre, verifica che la conversione non sia stata generata da un clic in cui gbraid o wbraid è stato compilato 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 customer_id della richiesta. Trova le istruzioni nella prerequisiti guida.
CONVERSION_ALREADY_ENHANCED Questa conversione ha già ricevuto un aggiustamento con order_id e conversion_action. Assicurati di fornire un order_id univoco per ogni conversione.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT L'oggetto conversion_action fornito non è idoneo per le conversioni avanzate per il web. Nella UI di Google Ads, assicurati di selezionare la casella Attiva le conversioni avanzate nell'azione di conversione a cui fai riferimento nella richiesta. Trova le istruzioni 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à generato un errore RequestError.INVALID_ENUM_VALUE. Si tratta di un problema comune quando si specifica consent e l'inserzionista potrebbe non sapere se è stato fornito il consenso. Se lo stato di consent è sconosciuto, deve essere impostato su DENIED.

  • Quando crei un'azione di conversione per le conversioni di app o per l'analisi di app di Firebase e di terze parti, puoi modificare il campo app_id solo al momento della creazione. Una volta creata l'azione di conversione, questo campo non può essere modificato.

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

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

  • L'intervallo consentito per il campo view_through_lookback_window_days è [1, 30] 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_conversion_metrics in un'azione di conversione genererà un errore FieldError.IMMUTABLE_FIELD. Imposta invece il primary_for_goal campo, come descritto nella guida agli obiettivi di conversione.

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

Errori comuni

Errore
INVALID_CONVERSION_ACTION_TYPE Il tipo di azione di conversione specificato non è valido per il caricamento delle conversioni da clic. Assicurati che l'oggetto ConversionAction specificato nella richiesta di caricamento abbia il tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND L'azione di conversione specificata non è attiva o non è stata trovata all'interno del caricamento customer_id. Recupera le informazioni sulla configurazione delle conversioni per assicurarti che l'azione di conversione nel caricamento sia attiva e di proprietà di customer_id della richiesta di caricamento.
TOO_RECENT_CONVERSION_ACTION L'azione di conversione è stata creata di recente. Attendi almeno 6 ore dopo la azione è stata creata prima di riprovare a eseguire le conversioni non riuscite.
INVALID_CUSTOMER_FOR_CLICK Il customer_id della richiesta non è lo stesso ID cliente che era l'account di conversione dell'API Google Ads al momento del clic. Aggiorna customer_id di 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 tua richiesta.
CLICK_CONVERSION_ALREADY_EXISTS In precedenza è stata caricata una conversione con la stessa combinazione di ID clic, conversion_date_time, e conversion_action era precedentemente caricata. Ignora questo errore se hai riprovato a eseguire il caricamento e questa conversione è andata a buon fine in precedenza. Se vuoi aggiungere un'altra conversione in aggiunta a quella caricata in precedenza, modifica 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 click_through_lookback_window_days campo. Una modifica di click_through_lookback_window_days influisce solo sui clic registrati dopo la modifica, pertanto la modifica della finestra temporale non risolverà questo errore per il clic specifico. Se appropriato, modifica the conversion_action in un'altra azione con una finestra temporale più lunga.
CONVERSION_PRECEDES_EVENT Il conversion_date_time è precedente alla data e all'ora del clic. Aggiorna conversion_date_time con un valore successivo.
GBRAID_WBRAID_BOTH_SET L'oggetto ClickConversion ha un valore impostato sia per gbraid sia 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 location di GoogleAdsError per determinare quale dei seguenti problemi ha causato l'errore.
  • L'oggetto ClickConversion ha un valore impostato per gclid, nonché almeno uno tra gbraid e 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.
  • L'oggetto ClickConversion ha un valore impostato per gbraid o wbraid e un valore per custom_variables. Google Ads non supporta le variabili personalizzate per una conversione con un gbraid o wbraid URL parametro. Annulla l'impostazione del campo custom_variables della conversione.