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.
|
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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-12-16 UTC.
[null,null,["Ultimo aggiornamento 2024-12-16 UTC."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
