Risoluzione dei problemi

Se riscontri problemi quando utilizzi l'API Search Ads 360, consulta questa sezione per la 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 cercando di accedere

  • Numero di progetto dalla console API di Google

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

  • Snippet di codice della tua richiesta

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

Errori di autorizzazione

Di seguito sono riportati alcuni errori di autorizzazione riscontrati comunemente:

Messaggio Descrizione

Access Not Configured. Please use Google API Console to activate the API for your project.

Questo errore si verifica se non hai abilitato l'API Search Ads 360 per il tuo account. Assicurati di:

  1. Vai alla console dell'API di Google.

  2. Seleziona il progetto. Se non hai ancora creato un progetto, consulta Creare un progetto per il client.

  3. Nella barra laterale a sinistra, espandi API e autenticazione. 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 utilità di Search Ads 360 come segue:

sa360Api.py --login

Scopri di più sul flusso di lavoro consigliato per l'autorizzazione.

Invalid client
no application name

Questo errore si verifica se non hai specificato un nome di prodotto durante la configurazione del progetto nella console API di Google. Per correggere questo errore, inserisci il nome del tuo prodotto nella schermata per il 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 il tuo ID client e client secret e quando ottieni un token di aggiornamento.

Errori di caricamento delle conversioni

Nella tabella seguente sono elencati gli errori che potrebbero verificarsi durante il caricamento delle conversioni. Tieni presente che i codici di errore esadecimali sono immutabili, pertanto 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. Carica nuovamente le conversioni dopo aver completato:

  • Verificato che l'ID clic sia stato generato 4 ore prima del caricamento delle conversioni.

  • Attivato il servizio di conversione dell'API.

  • Se attribuisci le conversioni a visite specifiche, attendi almeno 30 minuti dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere l'ID clic della visita se effettui il caricamento prima di 30 minuti dopo la visita. In rari casi, potrebbe essere necessario attendere fino a 4 ore prima che Search Ads 360 riconosca il clickId.

  • Confermato che il clic proviene da una sorgente valida, come indicato dal parametro gclsrc.

  • Verifica di aver specificato l'inserzionista corretto nella colonna inserzionistaId.

  • Verificato 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, verifica la presenza dei seguenti problemi comuni:

  • I nomi sono sensibili alle maiuscole, quindi assicurati che la tua 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 d'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 una metrica) per l'inserzionista associato alla clickId, criterionId o productGroupId che attribuisci alla conversione.

0x00000116 Custom metric '{name}' is not found

Assicurati che la variabile Floodlight personalizzata che hai specificato sia stata configurata come metrica (non una dimensione) per l'inserzionista associato alla clickId, criterionId o productGroupId che attribuisci alla 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 specificati 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 di Search Ads 360 viene generato da Search Ads 360 ed è garantito per essere univoco.

0x0000011B Advertiser conversion ID '{ID}' is not found

La tua richiesta update ha tentato di aggiornare un ID conversione inserzionista inesistente. Assicurati di aver specificato l'ID corretto.

0x0000011D User does not have permission to view advertiser {advertiser ID}

L'Account Google utilizzato dal cliente non è autorizzato a visualizzare l'inserzionista specificato nella richiesta.

Quando accedi alla console API di Google per recuperare l'ID client e il client secret e quando ottieni un token di aggiornamento, assicurati di utilizzare un Account Google a cui è stato concesso 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 ID conversione inserzionista.

L'ID conversione inserzionista è un ID generato e specificato 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 l'ID attività Floodlight che hai fornito non corrisponde al tipo di conversione specificato.

Segnalare codici di risposta e messaggi di errore

Se richiedi un report e la risposta è un messaggio di errore, consulta Codici di risposta nell'API Search Ads 360 e Risposte d'errore standard per ulteriori informazioni sull'errore.

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 la casella di controllo Mostra rimossi sia selezionata anche nell'interfaccia utente.