Risoluzione dei problemi

Se riscontri problemi durante l'utilizzo dell'API Search Ads 360, consulta questa sezione sulla risoluzione dei problemi.

Se si verifica un problema che non riesci a risolvere dopo aver letto le risorse su questo sito, contatta l'assistenza e tieni a portata di mano le seguenti informazioni:

• ID agenzia e ID inserzionista Search Ads 360 a cui stai tentando di accedere

• Numero del progetto nella console API di Google

• Il nome utente dell'Account Google che utilizzi per accedere all'API.
  Si tratta dell'account a cui è stata concessa l'autorizzazione ad accedere a Search Ads 360, ovvero lo stesso account che utilizzi per configurare l'autorizzazione.

• Snippet di codice della richiesta

• Risposta JSON
  Se la risposta è un errore, assicurati di includere il messaggio di errore, non solo il codice numerico dell'errore.

Errori di autorizzazione

Di seguito sono riportati alcuni errori di autorizzazione comuni:

Messaggio	Descrizione
Access Not Configured. Please use Google API Console to activate the API for your project.	Questo errore si verifica se non hai attivato l'API Search Ads 360 per il tuo account. Assicurati di aver eseguito le seguenti operazioni: Vai alla console dell'API di Google. Seleziona il progetto. Se non hai ancora creato un progetto, consulta Creare un progetto per il client. Nella barra laterale a sinistra, espandi API e autenticazione. Poi, fai clic su API. Nell'elenco delle API, assicurati che lo stato sia ON per l'API Search Ads 360.
Invalid grant	Questo errore si verifica quando il token di aggiornamento non è valido. Puoi ottenere un token di aggiornamento richiamando lo script di utilità Search Ads 360 come segue: sa360Api.py --login Scopri di più sul workflow consigliato per l'autorizzazione.
Invalid client no application name	Questo errore si verifica se non hai specificato un nome prodotto durante la configurazione del progetto nella Console API di Google. Per correggere questo errore, inserisci il nome del tuo prodotto nella schermata del consenso della console API di Google.
Altri tipi di errori di autorizzazione	Assicurati di utilizzare un Account Google a cui è stato concesso l'accesso a Search Ads 360 quando accedi alla console API di Google per recuperare l'ID cliente e il segreto cliente e quando ottieni un token di aggiornamento.

Errori di caricamento delle conversioni

Nella tabella seguente sono elencati gli errori che potresti riscontrare durante il caricamento delle conversioni. Tieni presente che i codici di errore esadecimali sono immutabili, quindi puoi utilizzarli nei tuoi script per identificare gli errori.

Codice di errore	Messaggio	Descrizione
0x00000101	Click ID '{ID}' is not found	L' ID clic specificato in una richiesta update non è valido. Ricarica le conversioni dopo aver eseguito quanto segue: Verificare che l'ID clic sia stato generato 6 ore prima del caricamento delle conversioni. Attivato il servizio API Conversion. Se attribuisci le conversioni a determinate visite, attendi almeno 6 ore dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere l'ID clic della visita se carichi prima di 6 ore dalla visita. In rari casi, potresti dover attendere fino a 24 ore prima che Search Ads 360 possa riconoscere l'ID clic. È stato confermato che il clic proviene da una sorgente valida come indicato dal parametro gclsrc. Abbiamo verificato che hai specificato l'inserzionista corretto nella colonna advertiserId. Verificare che l'ID clic sia stato generato negli ultimi 90 giorni.
0x0000010E	Floodlight activity name '{name}' is not found	Il nome dell'attività Floodlight specificato nella colonna segmentationName non è corretto o non è ancora disponibile. Se viene visualizzato questo errore, controlla se si verificano i seguenti problemi comuni: I nomi sono sensibili alle maiuscole, quindi assicurati che la richiesta corrisponda esattamente alle maiuscole. Assicurati di non aver incluso caratteri Unicode non stampabili o doppi spazi nel nome dell'attività Floodlight. Assicurati di aver specificato il nome di un' attività Floodlight, non di una colonna Floodlight. Verifica che l'attività Floodlight esista per l'inserzionista specificato nella colonna advertiserId. È possibile che tu abbia specificato l'inserzionista sbagliato. Dopo aver creato o modificato un'attività Floodlight, attendi un paio di ore prima di caricare le conversioni per l'attività.
0x00000115	Custom dimension '{name}' is not found	Assicurati che la variabile Floodlight personalizzata specificata sia stata configurata come dimensione (non metrica) per l'inserzionista associato a clickId, criterionId o productGroupId che stai attribuendo per la conversione.
0x00000116	Custom metric '{name}' is not found	Assicurati che la variabile Floodlight personalizzata specificata sia stata configurata come metrica (non come dimensione) per l'inserzionista associato a clickId, criterionId o productGroupId che stai attribuendo per la conversione.
0x0000011A	The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}	Qualcuno ha già caricato una conversione per lo stesso ambito e lo stesso ID conversione inserzionista specificato nella colonna conversionId. L'"ID conversione inserzionista" è un ID generato da te. Search Ads 360 richiede che questo ID sia univoco per un determinato ambito. L' ID conversione Search Ads 360 viene generato da Search Ads 360 ed è garantito come univoco.
0x0000011B	Advertiser conversion ID '{ID}' is not found	La tua richiesta update ha provato ad aggiornare un ID conversione dell'inserzionista che non esiste. Assicurati di aver specificato l'ID corretto.
0x0000011D	User does not have permission to view advertiser {advertiser ID}	L'Account Google utilizzato dal tuo cliente non ha l'autorizzazione per visualizzare l'inserzionista specificato nella richiesta. Quando accedi alla console API di Google per recuperare l'ID client e il segreto client e quando ottieni un token di aggiornamento, assicurati di utilizzare un Account Google a cui è stato concessito l'accesso all'inserzionista specificato.
0x0000011F	Advertiser conversion ID is already specified in this request	Due o più conversioni nella richiesta specificano lo stesso ambito e lo stesso ID conversione inserzionista. L'ID conversione dell'inserzionista è un ID che generi e specifichi nella colonna conversionId. Search Ads 360 richiede che questo ID sia univoco per un determinato ambito.
0x0000011E	The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)	L'ID o il nome dell'attività Floodlight che hai fornito non corrisponde al tipo di conversione specificato.

Codici di risposta e messaggi di errore dei report

Se richiedi un report e la risposta è un messaggio di errore, consulta Codici di risposta nell'API Search Ads 360 e Risposte standard agli errori per approfondire l'argomento.

I dati nell'interfaccia utente di Search Ads 360 non corrispondono a un report restituito dall'API

Per impostazione predefinita, i dati nell'interfaccia utente di Search Ads 360 devono corrispondere a quelli restituiti dall'API. Se imposti includeRemovedEntities su true in una richiesta di report, assicurati che sia selezionata anche la casella di controllo Mostra elementi rimossi nell'interfaccia utente.