Risoluzione dei problemi

La gestione delle conversioni richiede un'integrazione complessa, che spesso coinvolge più strumenti e processi interdipendenti. Questa guida illustra la procedura dettagliata che puoi seguire per risolvere eventuali problemi, ad esempio se ricevi errori dall'API che non comprendi o se hai difficoltà a interpretare le metriche o la diagnostica visualizzate nell'interfaccia utente.

Lettura delle metriche nell'interfaccia utente di Google Ads

  • L'interfaccia utente di Google Ads non organizza le metriche sulle conversioni 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 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

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 è la data 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.
CLICK_CONVERSION_ALREADY_EXISTS Per questo clic esiste già una conversione con questo conversion_date_time. Assicurati che conversion_date_time sia univoco per ogni evento e riprova.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Assicurati di aver attivato le conversioni avanzate per i lead nelle impostazioni di conversione. Troverai 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 su UploadClickConversionsRequest.

Se una conversione genera questo avviso, l'API Google Ads lo include in successful_event_count dei dati diagnostici 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, può provenire da SA360 o DV360. Altre possibili cause sono:

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

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

  • Verifica che il tag Google sia configurato correttamente nella tua pagina web e che venga attivato quando vengono inviati i moduli per i lead. Se il tag non viene attivato al momento dell'invio dei moduli o se invia dati errati, è probabile che l'attribuzione nelle conversioni caricate sia bassa o assente. Consulta gli articoli del Centro assistenza su come configurare il tag Google e configurare Google Tag Manager per le conversioni avanzate per i lead.

  • Se utilizzi le conversioni avanzate per i lead senza il tag Google nella tua pagina web, devi includere il GCLID nelle importazioni delle 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 (nell'interfaccia utente di Google Ads, fai clic su Strumenti -> Data Manager -> Impostazioni di consenso) o impostando il campo ClickConversion.consent su ogni conversione caricata.

Problemi relativi al rendimento della campagna

Se non riscontri problemi tecnici durante il caricamento delle conversioni e hai familiarità con le metriche mostrate, ma non noti i miglioramenti del rendimento della campagna o l'impatto previsti dopo aver implementato le conversioni avanzate per i lead, rivolgiti all'assistenza del prodotto Google Ads per ricevere assistenza.

Problemi con le 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 per 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 è stato inserito 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 nella guida ai prerequisiti.
CONVERSION_ALREADY_ENHANCED Questa conversione ha già ricevuto un aggiustamento con order_id e conversion_action specificati. Assicurati di fornire un valore order_id univoco per ogni conversione.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Il valore 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 fai riferimento nella richiesta. Per istruzioni, consulta il Centro assistenza.

Problemi generali di gestione delle conversioni

Tieni presente i seguenti problemi comuni:

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

  • Quando crei un'azione di conversione per le conversioni di app o per Firebase e l'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 su GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Qualsiasi altra opzione comporterà 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 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 valore value_settings.always_use_default_value deve essere impostato su true. Se specifichi un valore false, verrà generato un INVALID_VALUE errore.

Errori comuni

Errore
INVALID_CONVERSION_ACTION_TYPE L'azione di conversione specificata ha un tipo non valido per il caricamento delle conversioni di clic. Assicurati che il valore 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 all'interno del caricamento customer_id. Recupero delle 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. Prima di riprovare le conversioni non riuscite, attendi almeno 6 ore dalla creazione dell'azione.
INVALID_CUSTOMER_FOR_CLICK customer_id della richiesta non è lo stesso ID cliente dell'account di conversione dell'API Google Ads al momento del clic. Aggiorna il customer_id della richiesta per 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 stai riprovando a eseguire il caricamento e questa conversione è riuscita in precedenza. Se vuoi aggiungere un'altra conversione oltre a quella caricata in precedenza, modifica il valore conversion_date_time del 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 dell'intervallo di tempo specificato nel click_through_lookback_window_days campo. Una modifica a 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 determinato clic. Se opportuno, modifica conversion_action in 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 con un valore successivo.
GBRAID_WBRAID_BOTH_SET Per ClickConversion è stato impostato un valore sia per gbraid sia per wbraid. Aggiorna la conversione in modo da utilizzare solo un 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 del GoogleAdsError per determinare quale dei seguenti problemi ha causato l'errore.
  • ClickConversion ha un valore impostato per gclid, nonché almeno uno di gbraid o wbraid. Aggiorna la conversione in modo da utilizzare un solo ID clic e assicurati di non combinare più clic nella stessa conversione. Ogni clic ha un solo ID click.
  • 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