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 sulle campagne nella UI per verificare i risultati dell'importazione può essere fuorviante. Per verificare lo stato dell'importazione a livello di richiesta API, inizia con la diagnostica dei dati offline. La diagnostica dei dati offline non valuta la corrispondenza dei tag asincroni o la qualità dell'identificatore dell'utente per le conversioni avanzate. Per verificare l'integrità della corrispondenza, controlla i report diagnostici della UI di Google Ads per le conversioni avanzate per i lead e le conversioni avanzate per il web. Per i passaggi per la risoluzione dei problemi, consulta Avvisi di diagnostica dell'UI dopo un caricamento dell'API riuscito.

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 nel campo customer_id della richiesta. Verifica che l'azione di conversione nel caricamento sia attivata e che il relativo proprietario sia il cliente di conversione Google Ads del clic o un account nella gerarchia di monitoraggio delle conversioni dell'account 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 la 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 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. Altre possibili cause sono: Il cliente che esegue il caricamento è diverso dal cliente che esegue la conversione Google Ads. Tagging non è configurato correttamente per il modulo per i lead. I dati caricati non sono stati normalizzati e sottoposti ad hashing correttamente. 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 dei moduli per i lead. Se il tag non si attiva quando vengono inviati i moduli o se invia dati errati, è probabile che l'attribuzione delle 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'UI di Google Ads, fai clic su Strumenti > Data Manager > Impostazioni relative al 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 le metriche presentate ti soddisfano, ma non vedi i miglioramenti previsti nel rendimento della campagna o il "lift" 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
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	I Termini e condizioni per i dati dei clienti non sono stati accettati per il customer_id della richiesta. Trovi le istruzioni nella guida ai prerequisiti.
CONVERSION_ALREADY_ENHANCED	Questa conversione ha già ricevuto un aggiustamento ENHANCEMENT con i campi order_id e conversion_action specificati. Assicurati di fornire un valore 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. Trova le istruzioni nel Centro assistenza.
INVALID_USER_IDENTIFIER	Un campo dell'identificatore utente sottoposto ad hashing (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name o hashed_street_address) non è un digest SHA-256 esadecimale di 64 caratteri valido. Normalizza e sottoponi ad hashing i dati forniti dagli utenti prima di importarli. Per le istruzioni, consulta Normalizza e sottoponi ad hashing i dati forniti dagli utenti.
CONVERSION_NOT_FOUND	Google Ads non è riuscito a trovare una conversione corrispondente al campo conversion_action e all'identificatore di conversione (order_id o gclid_date_time_pair) forniti. Questo errore si applica solo agli aggiustamenti RESTATEMENT e RETRACTION. Per maggiori dettagli, consulta i requisiti per l'importazione degli aggiustamenti delle conversioni. Per gli aggiustamenti ENHANCEMENT, l'API accetta la richiesta senza restituire un errore CONVERSION_NOT_FOUND e valuta la corrispondenza order_id tra tag e API in modo asincrono. Tassi elevati di valori order_id non corrispondenti attivano un avviso di mancata corrispondenza dell'ID ordine nel report diagnostico delle conversioni avanzate nell'interfaccia utente di Google Ads. Per i passaggi per la risoluzione dei problemi, consulta Avvisi di diagnostica dell'UI dopo un caricamento API riuscito.

Avvisi di diagnostica della UI dopo un caricamento riuscito dell'API

Quando carichi gli aggiustamenti ENHANCEMENT utilizzando il servizio ConversionAdjustmentUploadService, l'API convalida la formattazione della richiesta al momento dell'importazione e associa i miglioramenti agli eventi dei tag del sito web in modo asincrono. Di conseguenza, le richieste API possono andare a buon fine senza errori nel campo partial_failure_error e mostrare uno stato EXCELLENT nella diagnostica dei dati offline. Allo stesso tempo, il report diagnostico delle conversioni avanzate nell'interfaccia utente di Google Ads può comunque mostrare avvisi.

Verifica le seguenti cause quando vengono visualizzati avvisi di diagnostica della UI dopo caricamenti API riusciti:

• Campi dell'indirizzo obbligatori mancanti: un oggetto OfflineUserAddressInfo nel campo address_info richiede quattro campi nella stessa voce: hashed_first_name, hashed_last_name, country_code e postal_code. I campi hashed_street_address, city e state sono facoltativi (se compili il campo hashed_street_address, deve comunque essere un digest esadecimale SHA-256 valido di 64 caratteri). L'API accetta oggetti address_info parziali non vuoti (ad esempio solo nome e cognome) senza restituire un errore nel campo partial_failure_error. Tuttavia, la corrispondenza downstream scarta gli indirizzi incompleti e attiva un avviso per i campi dell'indirizzo mancanti. Se uno dei quattro campi obbligatori non è disponibile, ometti l'oggetto UserIdentifier per il campo address_info.

• ID transazione mancanti negli eventi dei tag del sito web: se ometti il campo order_id da un aggiustamento ENHANCEMENT nell'API, viene restituito un errore FieldError.REQUIRED sincrono. Quando le richieste API includono il campo order_id, un avviso della UI relativo a un ID transazione mancante dall'evento di conversione fa riferimento al tag del tuo sito web. Questo avviso viene visualizzato quando meno del 90% degli eventi del tag di conversione sul sito web include un ID transazione valido (o quando il tag invia stringhe segnaposto come "undefined" o "null"). Configura il tag di conversione sul sito web in modo che invii un ID transazione univoco per ogni evento di conversione.

• Mancata corrispondenza degli ID ordine del tag e dell'API o caricamenti in ritardo: per gli aggiustamenti di ENHANCEMENT, l'API non restituisce un errore CONVERSION_NOT_FOUND o CONVERSION_EXPIRED al momento del caricamento. Invece, i valori order_id non corrispondenti attivano un avviso di mancata corrispondenza dell'ID ordine nell'UI e i miglioramenti caricati più di 24 ore dopo la conversione attivano un avviso di caricamento in ritardo. Abbina il campo order_id dell'API alla stringa esatta dell'ID transazione inviata dal tag di conversione sul sito web e carica il miglioramento entro 24 ore dall'evento di conversione.

• Dati utente non normalizzati sottoposti ad hashing prima del caricamento: l'hashing di valori non normalizzati, come lettere maiuscole, spazi vuoti iniziali o finali o numeri di telefono non in formato E.164, produce comunque un digest esadecimale SHA-256 valido di 64 caratteri. L'API accetta il caricamento senza restituire un errore INVALID_USER_IDENTIFIER, mentre la corrispondenza downstream non va a buon fine e segnala avvisi di formattazione o di tasso di corrispondenza basso. Segui le regole di normalizzazione riportate in Normalizza e sottoponi ad hashing i dati forniti dagli utenti.

• Volume di miglioramenti dell'API basso rispetto al volume dei tag del sito web: la diagnostica della UI confronta i miglioramenti dell'API deduplicati che contengono identificatori utente con gli eventi dei tag del sito web deduplicati e con consenso:

  • Configurazione della modalità di consenso: quando la modalità di consenso sul tag Google segnala l'impostazione ad_storage='denied', la diagnostica della UI esclude dal confronto gli eventi dei tag del sito web senza consenso, per cui l'omissione di questi eventi dai caricamenti dell'API non attiva un avviso di volume basso. Tuttavia, la gestione del consenso non corrispondente tra il tag del sito web e gli avvisi degli attivatori di backend:

    • Il tag non contiene ad_storage='denied', il backend salta il caricamento: gli avvisi di diagnostica dell'interfaccia utente conteggiano gli eventi dei tag come se avessero ricevuto il consenso e segnalano un avviso di copertura bassa.
    • Segnali dei tag ad_storage='denied', miglioramento dei caricamenti di backend: i miglioramenti caricati non hanno un evento tag con consenso corrispondente e contribuiscono agli avvisi di mancata corrispondenza dell'ID ordine.

    Applica lo stesso stato del consenso sia al tag del sito web sia ai caricamenti dei miglioramenti dell'API.

  • Eventi anonimi sul sito web: non attivare le conversioni avanzate per le azioni di conversione del funnel iniziale (come le visualizzazioni di pagina o di articoli) in cui il tag del sito web viene attivato per i visitatori anonimi. Se il tuo server invia miglioramenti dell'API solo per gli utenti che hanno eseguito l'accesso con dati di contatto noti, gli eventi dei tag anonimi non corrispondenti attivano un avviso di copertura bassa. Attiva le conversioni avanzate solo per le azioni di conversione per le quali i dati forniti dagli utenti sono sempre disponibili.

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 quando l'inserzionista potrebbe non sapere 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, inclusi gli errori di accesso al monitoraggio delle conversioni su più account.

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 è accessibile dall'account nel campo customer_id della richiesta. Recupera le informazioni sulla configurazione del monitoraggio delle conversioni per verificare che l'azione di conversione sia attivata. Il proprietario dell'azione di conversione deve essere il cliente di conversione Google Ads del clic o un account nella gerarchia di monitoraggio delle conversioni dell'account di caricamento. Ad esempio, questo errore si verifica se l'azione di conversione appartiene a un account amministratore precedente che è stato scollegato dopo il clic.
TOO_RECENT_CONVERSION_ACTION	L'azione di conversione è stata appena creata. Attendi almeno 6 ore dopo la creazione dell'azione prima di riprovare a caricare le conversioni non riuscite.
INVALID_CUSTOMER_FOR_CLICK	Il campo customer_id nella richiesta non corrisponde al cliente di conversione Google Ads al momento del clic. Questo errore si verifica quando l'account di caricamento non dispone anche dell'accesso tra account all'azione di conversione. Aggiorna il campo customer_id della richiesta in un account nella gerarchia del proprietario dell'azione di conversione.
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.
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 specifico. Se opportuno, modifica l'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.
VALUE_MUST_BE_UNSET	ClickConversion ha un valore impostato per gbraid o wbraid (senza gclid) e ha un valore per custom_variables o cart_data, che Google Ads non supporta con gbraid o wbraid. Annulla l'impostazione del campo in conflitto.