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 nell'interfaccia utente.

Lettura delle metriche nell'interfaccia utente 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'importazione dei dati sanitari, inizia con la diagnostica offline. Puoi anche scoprire di più sulla diagnostica nell'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 è attivata o non è accessibile dall'account cliente specificato dal campo `client_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 questa 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 su UploadClickConversionsRequest.

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:

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 non lo ha fatto.

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

  • Verifica che il tag Google sia configurato correttamente nella tua pagina web e che si attivi in caso di 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 relativi al 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 "incremento" 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

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 relativa a 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 customer_id della richiesta. Trova le istruzioni in questa 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 viene fatto riferimento nella 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, si verificherà 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 Conversioni di app o Firebase e analisi di 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 post del blog che annuncia il ritiro di altri modelli di attribuzione fornisce 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 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

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 è attivata o non è possibile trovarla nel 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 creata di recente. 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 conversioni 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 conferma 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 È già stata caricata 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 conferma 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 di ricerca non risolverebbe questo errore per il clic specifico. Se opportuno, modifica l'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 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 e assicurati di non combinare più clic nella stessa conversione. Ogni clic ha un solo ID clic.
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 e assicurati di non combinare più clic nella stessa conversione. Ogni clic ha un solo ID clic.
  • 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 ID clic gbraid o wbraid. Deseleziona il campo custom_variables della conversione.
Indietro
Rapporti