La diagnosi di problemi tecnici sul tuo sito Web può essere uno degli aspetti più dispendiosi in termini di tempo ma importanti della gestione di un sito Web.
A peggiorare le cose, Google ti consente di ispezionare un solo URL alla volta per diagnosticare potenziali problemi sul tuo sito web (questo viene fatto all’interno di Google Search Console).
Fortunatamente, ora c’è un modo più veloce per testare il tuo sito web: inserisci l’API di controllo degli URL di Google Search Console…
Che cos’è l’API di controllo degli URL di Google Search Console?
Il Google API di ispezione dell’URL di Search Console è un modo per controllare in blocco i dati che Google Search Console ha sugli URL. Il suo scopo è aiutare gli sviluppatori e i SEO a eseguire il debug e ottimizzare le loro pagine in modo più efficiente utilizzando i dati di Google.
Ecco un esempio in cui utilizzo l’API per verificare se alcuni URL sono indicizzati e inviati nella mia mappa del sito:
Che tipo di dati puoi ottenere dall’API di controllo degli URL di Google Search Console?
L’API di controllo degli URL di Google Search Console ti consente di estrarre un’ampia gamma di dati. Di seguito è riportato un elenco di alcune delle funzionalità più discusse:
lastCrawTime
Con questo campo puoi capire esattamente quando Googlebot ha eseguito l’ultima scansione del tuo sito web. Questo è estremamente utile per SEO e sviluppatori per misurare la frequenza della scansione di Google dei loro siti. In precedenza, potevi accedere a questo tipo di dati solo tramite l’analisi dei file di registro o il controllo a campione dei singoli URL con Google Search Console.
robotsTxtState
Con questo campo puoi capire se hai regole robots.txt che bloccheranno Googlebot. Questo è qualcosa che puoi controllare manualmente, ma essere in grado di testarlo su larga scala con i dati di Google è un fantastico passo avanti.
googleCanonical e userCanonical
In alcune situazioni, è noto che Google seleziona un canonico diverso da quello specificato nel codice. In questa situazione, avere la possibilità di confrontare entrambi (affiancati e su larga scala) utilizzando l’API è utile per consentire di apportare le modifiche appropriate.
crawledAs
Questo campo ti permette di capire quale user agent viene utilizzato per una scansione del tuo sito: Mobile/Desktop. I codici di risposta sono di seguito per riferimento:
- SCRIVANIA – Agente utente desktop
- MOBILE – Agente utente mobile
pageFetchState
Comprendere pageFetchState può aiutarti a diagnosticare errori del server, 4xx non trovati, 404 soft, errori di reindirizzamento, pagine bloccate da robots.txt e URL non validi. Di seguito è riportato un elenco di risposte per riferimento.
| Campo | Cosa significa |
|---|---|
| PAGE_FETC_STATE_UNSPECIFIED | Stato di recupero sconosciuto |
| RIUSCITO | Recupero riuscito |
| SOFT_404 | Morbido 404 |
| BLOCKED_ROBOTS_TXT | Bloccato da robots.txt |
| NON TROVATO | Non trovato (404) |
| ACCESSO NEGATO | Bloccato per richiesta non autorizzata (401) |
| ERRORE DEL SERVER | Errore del server (5xx) |
| REDIRECT_ERROR | Errore di reindirizzamento |
| ACCESSO VIETATO | Bloccato per accesso vietato (403) |
| BLOCCATO_4XX | Bloccato a causa di un altro problema 4xx (non 403, 404) |
| INTERNAL_CRAWL_ERROR | Errore interno |
| URL NON VALIDO | URL non valido |
indexingState
Lo stato di indicizzazione indica lo stato corrente di indicizzazione degli URL. Oltre alle risposte Pass e Fail più ovvie, ci sono altre risposte:
- NEUTRO è equivalente al messaggio “Escluso” in Search Console.
- PARZIALE è equivalente al messaggio “Valido con avvisi” in Search Console.
- VERDETTO_NON SPECIFICATO significa che Google non è in grado di giungere a una conclusione sugli URL in questione.
Stato di copertura
Questo ti dà i dettagli sul fatto che un URL sia stato inviato nella tua mappa del sito e indicizzato.
referUrls
Ciò ti consente di vedere da dove è collegata ogni pagina, secondo Google.
Mappa del sito
Ciò ti consente di capire quali URL sono inclusi nelle mappe del sito.
Altri usi dell’API
Puoi anche utilizzare l’API per ispezionare il tuo sito AMP, se ne hai uno.
Come utilizzare l’API di controllo degli URL di Google Search Console passo dopo passo
L’utilizzo dell’API di ispezione degli URL di Google Search Console implica l’invio di una richiesta a Google. I parametri della richiesta che devi definire sono l’URL che desideri controllare e anche l’URL della proprietà in Google Search Console.
Il corpo della richiesta contiene dati con la seguente struttura:
Se sei curioso di saperne di più su come utilizzare l’API, Google ha un’ampia documentazione al riguardo.
Di seguito è riportato un esempio del tipo di risposta che puoi ottenere dall’API:
Se non ti senti a tuo agio con il codice o vuoi semplicemente provarlo subito, puoi utilizzare lo strumento gratuito Google Bulk Inspect URLs di valentin.app. Lo strumento fornisce un modo rapido per interrogare l’API senza alcuna abilità di codifica!
Ecco come usarlo. Puoi:
- Vai su https://valentin.app/inspect.html, autorizza l’accesso al tuo account Google e seleziona la proprietà di Search Console che desideri testare. Quindi incolla i tuoi URL nella casella sottostante. (I dati verranno elaborati nel tuo browser e non caricati su un server né condivisi con nessuno.)
- Fai clic sul pulsante “Ispeziona URL”. I dati inizieranno a essere estratti dall’API.
- Esportare i dati come file CSV o Excel facendo clic sul pulsante.
- Analizza i dati e verifica eventuali problemi.
Come puoi utilizzare in pratica l’API di controllo degli URL di Google Search Console?
In teoria, l’API di controllo degli URL di Google Search Console sembra un ottimo modo per capire di più sul tuo sito web. Tuttavia, puoi estrarre così tanti dati che è difficile sapere da dove iniziare. Diamo quindi un’occhiata ad alcuni esempi di casi d’uso.
1. Migrazione del sito: diagnosi di eventuali problemi tecnici
Le migrazioni dei siti possono causare tutti i tipi di problemi. Ad esempio, gli sviluppatori possono impedire accidentalmente a Google di eseguire la scansione del tuo sito o di determinate pagine tramite robots.txt.
Fortunatamente, l’API di controllo degli URL di Google Search Console rende il controllo di questi problemi un gioco da ragazzi.
Ad esempio, puoi verificare se stai impedendo a Googlebot di eseguire la scansione in blocco degli URL chiamando robotsTxtState.
Ecco un esempio in cui utilizzo l’API di controllo degli URL di Google Search Console (tramite valentin.app) per chiamare robotsTxtState per vedere lo stato corrente dei miei URL.
Come puoi vedere, queste pagine non sono bloccate da robots.txt e non ci sono problemi qui.
CONSIGLIO
2. Capisci se Google ha rispettato i tuoi canoni dichiarati
Se apporti una modifica ai tag canonici nel tuo sito, vorrai sapere se Google li sta rispettando o meno.
Ti starai chiedendo perché Google ignori il canonico che hai dichiarato. Google può farlo per una serie di motivi, ad esempio:
- Il tuo canonico dichiarato non è https. (Google preferisce https per i canonici.)
- Google ha scelto una pagina che ritiene sia una pagina canonica migliore di quella dichiarata canonica.
- Il tuo canonico dichiarato è una pagina noindex.
Di seguito è riportato un esempio in cui utilizzo l’API di ispezione degli URL di Google Search Console per vedere se Google ha rispettato i miei canoni dichiarati:
Come possiamo vedere dallo screenshot qui sopra, non ci sono problemi con queste pagine particolari e Google sta rispettando i canonici.
CONSIGLIO
Per vedere rapidamente se googleCanonical corrisponde a userCanonical, esporta i dati dallo strumento Google Bulk Inspect URLs in CSV e utilizza un SE formula in Excel. Ad esempio, supponendo che i tuoi dati googleCanonical siano nella colonna A e il tuo userCanonical sia nella colonna B, puoi utilizzare la formula =SE(A2=B2, “Autoriferito”,”Non Autoriferito”) per verificare la presenza di canoni non corrispondenti.
3. Comprendi quando Google esegue nuovamente la scansione dopo aver apportato modifiche al tuo sito
Quando aggiorni molte pagine del tuo sito web, vorrai conoscere l’impatto dei tuoi sforzi. Questo può accadere solo dopo che Google ha eseguito di nuovo la scansione del tuo sito.
Con l’API di controllo degli URL di Google Search Console, puoi vedere l’ora esatta in cui Google ha eseguito la scansione delle tue pagine utilizzando lastCrawlTime.
Se non riesci ad accedere ai file di registro del tuo sito web, questa è un’ottima alternativa per capire come Google esegue la scansione del tuo sito.
Ecco un esempio di me che controllo questo:
Come puoi vedere nello screenshot qui sopra, lastCrawlTime mostra la data e l’ora in cui il mio sito web è stato scansionato. In questo esempio, la scansione più recente di Google è la home page.
Comprendere quando Google esegue nuovamente la scansione del tuo sito Web a seguito di eventuali modifiche ti consentirà di collegare se le modifiche apportate hanno o meno un impatto positivo o negativo dopo la scansione di Google.
Domande frequenti
Come aggirare i limiti dell’API di ispezione degli URL di Google Search Console?
Sebbene l’API di controllo degli URL di Google Search Console sia limitata a 2.000 query al giorno, questo limite di query è determinato da Google Proprietà.
Ciò significa che puoi avere più proprietà all’interno di un sito Web se verificate separatamente in Google Search Console, consentendoti di aggirare il limite di 2.000 query al giorno.
Google Search Console ti consente di avere 1.000 proprietà nel tuo account Google Search Console, quindi questo dovrebbe essere più che sufficiente per la maggior parte degli utenti.
Posso utilizzare l’API di controllo degli URL di Google Search Console su qualsiasi sito web?
Un altro potenziale fattore limitante è che puoi eseguire l’API di controllo degli URL di Google Search Console solo su una proprietà di tua proprietà in Google Search Console. Se non hai accesso alla proprietà, non puoi controllarla utilizzando l’API di controllo degli URL di Google Search Console.
Quindi questo significa che l’audit di un sito a cui non hai accesso può essere problematico.
Quanto sono accurati i dati?
La precisione dei dati stessi è stata un problema per Google negli ultimi anni. Questa API ti dà accesso a quei dati. Quindi, probabilmente, l’API di ispezione degli URL di Google Search Console è valida solo quanto i dati al suo interno.
Come abbiamo mostrato in precedenza nel nostro studio sull’accuratezza di Google Keyword Planner, i dati di Google spesso non sono così accurati come le persone pensano che siano.
Pensieri finali
L’API di controllo degli URL di Google Search Console è un ottimo modo per i proprietari di siti di ottenere dati in blocco direttamente da Google su una scala più ampia rispetto a quanto era precedentemente possibile da Google Search Console.
Daniel Waisberg e il team dietro l’API di ispezione degli URL di Google Search Console ha sicuramente fatto un ottimo lavoro per far sì che questo venisse rilasciato in natura.
Ma una delle critiche all’API di ispezione degli URL di Google Search Console da parte della community SEO è che il limite della frequenza delle query è troppo basso per i siti più grandi. (È limitato a 2.000 query al giorno, per proprietà.)
Per i siti più grandi, questo non è sufficiente. Inoltre, nonostante le possibili soluzioni alternative, questo numero sembra essere ancora basso.
Qual è la tua esperienza nell’utilizzo dell’API di controllo degli URL di Google Search Console? Hai altre domande? me il ping su Twitter. 🙂
