SEO per Single Page Application: guida pratica

SEO per Single Page Application

SEO per Single Page Application: guida SEO React con checklist | We.Inc

Perché le single page app faticano nei risultati di ricerca e come rimediare: SSR, generazione statica o prerendering, titoli per route in React 19 o react-helmet-async, URL reali, soft 404, sitemap, Controllo URL e un verificatore del sorgente.

Le single page app spesso inviano ai motori di ricerca una shell HTML quasi vuota e costruiscono la pagina in un secondo momento con JavaScript. Google sa eseguire il rendering di JavaScript, ma lo fa con un ritardo e altri crawler potrebbero non farlo. La soluzione è servire HTML reale per ogni URL tramite rendering lato server, generazione statica o prerendering, con un title, una description e un canonical unici su ogni route.

Le tre correzioni che contano di più

  • Correzione
  • Perché
  • HTML reale per ogni URL pubblico
  • Crawler e anteprime dei link vedono subito il contenuto
  • Title, description e canonical unici per route
  • Ogni pagina può posizionarsi ed essere condivisa da sola
  • Un percorso reale per ogni vista e una sitemap
  • Ogni pagina può essere scoperta e indicizzata

Questo stesso sito è una single page app React che esegue il prerendering di ogni pagina pubblica in fase di build, quindi questi sono i controlli che facciamo sulle nostre pagine. Incolla il sorgente di una pagina nel verificatore per vedere cosa riceve un crawler prima che venga eseguito qualsiasi JavaScript.

  • Apri una pagina, scegli Visualizza sorgente pagina e copia tutto.
  • Incollalo nel verificatore qui sotto.
  • Leggi quali elementi di base sono presenti nell'HTML grezzo e quali mancano.
  • Colma le lacune con uno degli approcci e degli esempi di codice di questa pagina.
  • Conferma con il Controllo URL di Search Console, che mostra l'HTML di cui Google ha eseguito il rendering.
  • Controlla Visualizza sorgente, non il pannello Elements; il pannello mostra la pagina dopo l'esecuzione di JavaScript.
  • Mantieni l'HTML prerenderizzato identico a ciò che vedono gli utenti; mostrare contenuti diversi ai crawler è cloaking.
  • Non bloccare /assets o i file .js in robots.txt; a Google servono per il rendering.
  • Le anteprime dei link dei social network non eseguono JavaScript, quindi i tag Open Graph per route devono essere nell'HTML.

Domande frequenti

Google può indicizzare una single page app React?

Sì. Google esegue il rendering di JavaScript, ma le pagine aspettano in una coda di rendering e tutto ciò che non si carica viene perso. Altri motori di ricerca e i bot delle anteprime dei link eseguono meno rendering o nessuno, quindi servire HTML è la scelta più sicura.

Mi serve Next.js per la SEO con React?

No. Next.js rende facili il rendering lato server e la generazione statica, ma una SPA in stile Vite o Create React App può eseguire il prerendering delle route pubbliche in fase di build e ottenere lo stesso HTML scansionabile.

react-helmet serve ancora con React 19?

Non per i tag di base. React 19 esegue il rendering degli elementi title, meta e link da qualsiasi componente e li sposta nella head. react-helmet-async resta utile con React 18 e versioni precedenti.

Il prerendering è cloaking?

No, se crawler e persone ricevono lo stesso contenuto. Il prerendering salva solo la pagina che i tuoi utenti vedrebbero comunque. Diventa cloaking se l'HTML servito ai bot dice qualcosa di diverso.

Testare come Google

  • In Search Console, il Controllo URL mostra se una pagina è indicizzata e, con Testa URL live, l'HTML di cui Google ha eseguito il rendering e le risorse che non è riuscito a caricare. Confronta quell'HTML con la pagina visibile: intestazioni, testo principale e link devono esserci tutti.

SSR, generazione statica o prerendering

Modi per dare ai crawler HTML reale

  • Approccio
  • Come funziona
  • Adatto per
  • Costo
  • Rendering lato server (SSR)
  • Il server trasforma ogni richiesta in HTML, poi React lo idrata
  • Pagine che cambiano a ogni richiesta o per ogni utente
  • Serve un server; più parti in movimento
  • Generazione statica (SSG)
  • Le pagine vengono trasformate in HTML in fase di build
  • Pagine di marketing, documentazione, blog
  • Serve una nuova build per aggiornare i contenuti
  • Prerendering in fase di build di una SPA esistente
  • Uno script carica ogni route in un browser headless in fase di build e salva l'HTML
  • Un'app esistente solo lato client che non vuoi riscrivere
  • La build rallenta man mano che crescono le route
  • Solo lato client
  • Il server invia una shell vuota; JavaScript costruisce la pagina
  • Schermate dell'app dopo il login che non vanno indicizzate
  • Le pagine pubbliche dipendono dal rendering successivo di Google

Correzioni con il codice

Title e description per route in React 19

React 19 permette a qualsiasi componente di generare tag title, meta e link; React li sposta nella head del documento. Ogni route imposta i propri.

Lo stesso con react-helmet-async (React 18 e precedenti)

Avvolgi l'app una volta in HelmetProvider, poi imposta i tag per ogni pagina. La versione async è sicura per il rendering lato server e il prerendering.

URL reali, non frammenti hash

Google ignora tutto ciò che segue un # quando decide cos'è un URL. Usa la History API (BrowserRouter, createBrowserRouter) così ogni vista ha il proprio percorso.

Link scansionabili

I crawler seguono gli elementi a con un href. Un gestore di clic su un div per loro è invisibile. I componenti Link del router generano un vero anchor.

Evitare i soft 404 per le route sconosciute

Un'app solo lato client risponde a ogni URL con stato 200, quindi una pagina mancante sembra reale. Aggiungi un noindex alla vista di pagina non trovata, oppure servi un vero 404 dal server o dalla fase di prerendering.

Una sitemap di ogni route pubblica

Elenca ogni URL pubblico una sola volta, con il suo indirizzo canonico. Generala dallo stesso elenco di route usato dalla tua app, così non si disallineano mai.

Vuoi che i tag vengano scritti per te? Prova il

generatore di meta tag

  • Ogni pagina pubblica ha il proprio percorso URL (niente route con #)
  • Visualizza sorgente (non Ispeziona) mostra l'intestazione e il testo principale della pagina
  • Ogni route ha un title e una meta description unici
  • Ogni route ha un link canonical verso se stessa
  • La navigazione usa veri elementi a con href
  • Gli URL sconosciuti restituiscono uno stato 404 o hanno noindex
  • Una sitemap elenca ogni URL pubblico ed è inviata in Search Console
  • robots.txt non blocca i file JavaScript o CSS
  • L'HTML renderizzato nel Controllo URL mostra il contenuto completo
  • Le schermate private e dopo il login sono noindex o protette da login

Verificatore del sorgente della pagina

Incolla l'HTML da Visualizza sorgente pagina per controllare cosa riceve un crawler.

Sorgente della pagina (l'esempio è una tipica shell SPA vuota)

Checklist SEO per SPA

Title

"{title}" ({n} caratteri)

Nessun title nell'HTML

Meta description

{n} caratteri

Mancante

Link canonical

Intestazione principale (h1)

Nessun h1 prima dell'esecuzione di JavaScript

Testo visibile

{n} parole nel body prima dell'esecuzione di JavaScript

Link scansionabili

{n} elementi a con un href reale

Title Open Graph (anteprime dei link)

Indicizzazione consentita

meta robots: {robots}

Nessun meta robots (indicizzabile)

Crea il tuo sito gratis · Gratis per creare, senza carta

Correlati: Guide

Prodotto

Per chi è

Funzionalità

Risorse

Azienda

Mappa del sito