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 i problemi che riscontri, ad esempio se ricevi errori dall'API che non comprendi o se hai dubbi sulle metriche o sulla diagnostica che vedi nell'interfaccia utente.

Lettura delle metriche nell'interfaccia utente 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 lo stato dell'importazione, inizia con la diagnostica dei dati offline. Puoi anche scoprire di più sulla diagnostica nell'interfaccia utente 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

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 dall'account cliente specificato dal campo customer_id nella richiesta. Assicurati che l'azione di conversione nel caricamento sia attivata e che sia 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 per click_view.gclid e segments.date, dove la data è quella in cui si è verificato il clic.

INVALID_CONVERSION_ACTION_TYPE L'azione di conversione specificata ha un tipo non valido per le conversioni avanzate per i lead. Assicurati che il valore 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 di conversione. Le istruzioni sono disponibili 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 dell'utente forniti.

Se una conversione genera questo avviso, l'API Google Ads lo include nel campo 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:

Nei 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 per i dati dei clienti, ma il cliente che esegue la pubblicazione non li ha accettati.

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 Discrepanze nei dati dopo un caricamento riuscito.

  • Verifica che il tag Google sia configurato correttamente sulla tua pagina web e che si attivi per gli invii di moduli per i lead. Se il tag non si attiva per gli invii dei moduli o se invia dati errati, è probabile che l'attribuzione nelle conversioni caricate sia bassa o assente. Consulta gli articoli del Centro assistenza sulla configurazione del tag Google e sulla 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 tua pagina web, devi includere il GCLID nelle importazioni delle conversioni impostando il campo ClickConversion.gclid in 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 relativi al rendimento della campagna

Se non riscontri problemi tecnici durante il caricamento delle conversioni e le metriche presentate ti soddisfano, ma non vedi i miglioramenti previsti nel rendimento della campagna o l'"incremento" dopo l'implementazione delle conversioni avanzate per i lead, contatta l'assistenza 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

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

Errore
CONVERSION_NOT_FOUND Impossibile 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 Google Ads specificato nel customer_id della richiesta.
Inoltre, verifica che la conversione non sia stata generata da un clic in cui è stato compilato 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 condizioni per i dati dei clienti non sono stati accettati per il campo customer_id della richiesta. Le istruzioni sono disponibili nella guida ai prerequisiti.
CONVERSION_ALREADY_ENHANCED Questa conversione ha già ricevuto un aggiustamento con i valori order_id e conversion_action specificati. Assicurati di fornire un order_id univoco per ogni conversione.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT L'ID 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 viene fatto riferimento nella richiesta. Le istruzioni sono disponibili nel Centro assistenza.

Problemi generali di gestione delle conversioni

Tieni presente i seguenti problemi comuni:

  • Il tentativo di impostare un campo enum su UNKNOWN genererà un errore RequestError.INVALID_ENUM_VALUE. Questo è un problema comune quando si specifica consent, se l'inserzionista non sa se il consenso è stato concesso. Se lo stato di consent è sconosciuto, deve essere impostato su DENIED.

  • Quando crei un'azione di conversione per le conversioni da app o Firebase e l'analisi delle app 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 campo ConversionAction.attribution_model_settings.attribution_model solo su GOOGLE_ADS_LAST_CLICK o GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Qualsiasi altra opzione genererà un errore CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Il nostro blog post che annuncia il ritiro di altri modelli di attribuzione contiene ulteriori dettagli.

  • L'intervallo consentito per il campo click_through_lookback_window_days è compreso tra 1 e 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 è compreso tra 1 e 90 giorni.

  • L'intervallo consentito per il campo view_through_lookback_window_days è compreso tra 1 e 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 genererà 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, value_settings.always_use_default_value deve essere impostato su true. Se specifichi un valore 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 il ConversionAction specificato nella richiesta di caricamento sia di tipo UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND L'azione di conversione specificata non è attivata o non è stata trovata all'interno dell'account customer_id di caricamento. Recupera le informazioni sulla configurazione delle conversioni per assicurarti che l'azione di conversione nel caricamento sia attivata e sia di proprietà del customer_id della richiesta di caricamento.
TOO_RECENT_CONVERSION_ACTION L'azione di conversione è stata appena creata. Attendi almeno 6 ore dalla creazione dell'azione prima di riprovare a caricare le conversioni non riuscite.
INVALID_CUSTOMER_FOR_CLICK L'ID customer_id della richiesta non corrisponde all'ID cliente che era l'account di conversione 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 Una conversione con la stessa combinazione di ID clic, conversion_date_time e conversion_action è stata caricata in precedenza. Ignora questo errore se hai riprovato a eseguire il caricamento e questa conversione è stata eseguita correttamente in precedenza. Se vuoi aggiungere un'altra conversione oltre a quella caricata in precedenza, modifica il valore 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 alla click_through_lookback_window_days influisce solo sui clic registrati dopo la modifica, pertanto la modifica della finestra temporale non risolve questo errore per il clic in questione. Se opportuno, modifica l'conversion_action in un'altra azione con una finestra temporale più lunga.
CONVERSION_PRECEDES_EVENT La data e l'ora di conversion_date_time sono precedenti a quelle del clic. Aggiorna conversion_date_time con un valore successivo.
GBRAID_WBRAID_BOTH_SET L'elemento 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, nonché 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. Annulla l'impostazione del campo custom_variables della conversione.
Indietro
Rapporti