L'API Search Ads 360 Reporting precedente non sarà più disponibile a partire dal 30 giugno 2024. Tieni presente che l'API Search Ads 360 Conversion non è interessata e continuerà a essere supportata. Tutte le nuove implementazioni di reporting devono utilizzare la nuova API Search Ads 360 Reporting.

A partire da aprile 2024, verrà restituito un errore non supportatoApiVersion quando si richiede un report. Consulta i dettagli qui.

Ti consigliamo inoltre di eseguire la migrazione delle implementazioni esistenti di Search Ads 360 alla nuova API. Per saperne di più, consulta la guida introduttiva e la guida alla migrazione della nuova API Search Ads 360 Reporting.

Questa pagina è stata tradotta dall'API Cloud Translation.

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: 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. 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.