Risoluzione dei problemi

Se riscontri problemi durante l'utilizzo dell'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 di 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 concessa l'autorizzazione ad accedere a Search Ads 360, ovvero 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

Ecco 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 svolto le seguenti operazioni:

  1. Vai alla console dell'API di Google.

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

  3. Nella barra laterale a sinistra, espandi API e autenticazione. Poi fai clic su API. Nell'elenco delle API, assicurati che lo stato dell'API Search Ads 360 sia ON.

Invalid grant

Questo errore si verifica quando il token di aggiornamento non è valido. Puoi ottenere un token di aggiornamento richiamando lo script di utilità di 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 del 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 l'ID cliente e il client secret e quando ottieni un token di aggiornamento.

Errori di caricamento delle conversioni

La tabella seguente elenca 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 insert o update non è valido. Carica di nuovo le conversioni dopo aver eseguito le seguenti operazioni:

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

  • Attivato il servizio API Conversion.

  • Se attribuisci le conversioni a visite specifiche, attendi almeno 6 ore dopo la visita prima di caricare la conversione. Search Ads 360 potrebbe non riconoscere il clickID della visita se il caricamento avviene prima di 6 ore dalla visita. In rari casi, potrebbe essere necessario attendere fino a 24 ore prima che Search Ads 360 possa riconoscere il clickId.

  • Confermato che il clic proviene da un'origine valida, come indicato dal parametro gclsrc.

  • Verificato che l'ID clic sia stato generato negli ultimi 90 giorni.

0x00000106 Either a click ID or keyword ID is required

La conversione non specifica a cosa è attribuita. Specifica la colonna clickId o le colonne customerId, campaignId, adGroupId e criterionId che identificano una parola chiave.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Specifica segmentationType: "FLOODLIGHT" e l'attività Floodlight nella colonna segmentationName o segmentationId.

Quando modifichi una conversione registrata da Search Ads 360 tramite un tag Floodlight, l'attività Floodlight è necessaria per identificare la conversione.

0x0000010E Floodlight activity name '{name}' is not found

Il nome dell'attività Floodlight specificato nella colonna segmentationName non è corretto o non è ancora disponibile. Se visualizzi questo errore, controlla i 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 spazi doppi 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 a cui appartiene l'ID clic o la parola chiave nella richiesta.
  • 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 come metrica) per l'inserzionista associato a clickId, criterionId o productGroupId che stai attribuendo alla 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 alla conversione.

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

La tua richiesta update non ha specificato la colonna conversionId. conversionId è obbligatorio per identificare la conversione che vuoi modificare. Consulta Ritiro di dsConversionId.

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 che sia univoco.

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

La tua richiesta update ha tentato di aggiornare un ID conversione inserzionista che non esiste. Controlla i seguenti problemi comuni:

  • Assicurati di aver specificato l'ID corretto nella colonna conversionId. Per le conversioni caricate tramite l'API, si tratta del valore conversionId specificato al momento dell'inserimento della conversione. Per le conversioni registrate tramite i tag Floodlight, si tratta dell'ID ordine Floodlight.
  • Assicurati che conversionTimestamp sia il timestamp della conversione esistente, in millisecondi Epoch UTC. Un timestamp convertito da un fuso orario locale o specificato in secondi anziché in millisecondi non corrisponde alla conversione esistente.
  • Per le conversioni registrate tramite i tag Floodlight, assicurati di aver specificato l'attività Floodlight della conversione nella colonna segmentationName o segmentationId e che la conversione sia avvenuta negli ultimi 28 giorni.
0x0000011D User does not have permission to view advertiser {advertiser ID}

L'Account Google utilizzato dal tuo client non dispone dell'autorizzazione per visualizzare l'inserzionista a cui appartiene l'ID clic o la parola chiave 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 a quell'inserzionista.

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

0x00000124 Conversion timestamp is before click timestamp

La data/ora conversionTimestamp è precedente a quella del clic specificata nella colonna clickId. Assicurati che il timestamp sia specificato in millisecondi UTC epoch, non in secondi o in un fuso orario locale.

0x00000125 Conversion age is older than the max supported age

La tua richiesta update ha tentato di modificare una conversione troppo vecchia per essere modificata. Le conversioni registrate da Search Ads 360 tramite i tag Floodlight possono essere modificate solo entro 28 giorni dalla conversionTimestamp.

0x00000126 Service internal error

Riprova a inviare la richiesta in un secondo momento. Molto probabilmente si tratta di un errore temporaneo. Se l'errore persiste, contatta l'assistenza SA360.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 non riesce a trovare l'ID cliente specificato nella colonna customerId. Specifica l'ID cliente del nuovo Search Ads 360 dell'account cliente che contiene la parola chiave, ad esempio 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 non riesce a trovare la parola chiave identificata dalle colonne customerId, campaignId, adGroupId e criterionId. Assicurati che tutti e quattro gli ID siano ID del nuovo Search Ads 360 e che la parola chiave appartenga al gruppo di annunci, alla campagna e all'account cliente specificati.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Una conversione attribuita a una parola chiave deve specificare customerId, campaignId, adGroupId e criterionId. Il messaggio indica l'ID mancante. Consulta Attribuire una conversione solo a una parola chiave.

0x0000012F Editing a click ID older than 60 days is not supported.

La tua richiesta update ha specificato un clickId generato più di 60 giorni fa. Le conversioni possono essere modificate solo entro 60 giorni dal clic.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

La tua richiesta update ha specificato la colonna dsConversionId deprecata o ha passato un ID conversione di Search Ads 360 nella colonna conversionId. Identifica invece la conversione in base al relativo ID conversione inserzionista. Consulta Ritiro di dsConversionId.

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