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.
    Questo è l'account a cui è stata datata l'autorizzazione ad accedere a Search Ads 360, che è lo stesso 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 di errore numerico.

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:

  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. Quindi, 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 il tuo ID client e il client secret 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 4 ore prima del caricamento delle conversioni.

  • Attivato il servizio API Conversion.

  • Se attribuisci le conversioni a determinate visite, attendi almeno 30 minuti dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere l'ID clic della visita se carichi prima di 30 minuti dalla visita. In rari casi, potresti dover attendere fino a 4 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 tua richiesta corrisponda esattamente a maiuscole e minuscole.
  • 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 ai valori clickId, criterionId o productGroupId che attribuisci 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 il tuo ID client e il tuo client secret, e quando ottieni un token di aggiornamento, assicurati di utilizzare un Account Google a cui è stato concesso l'accesso all'inserzionista che hai 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 la sezione Codici di risposta nell'API Search Ads 360 e Risposte di 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 sia selezionata anche la casella di controllo Mostra elementi rimossi nell'interfaccia utente.