Next.js hreflang

Next.js hreflang: implementare alternative linguistiche nell'App Router

Una guida pratica ai percorsi di localizzazione, ai link hreflang reciproci, ai metadati tradotti e alle pagine dinamiche in un'applicazione Next.js App Router.

/ La risposta breve

Hreflang funziona quando ogni versione linguistica ha un proprio URL indicizzabile, identifica l'intero set di lingue e crea collegamenti alle altre versioni. In Next.js, è possibile generare queste relazioni utilizzando metadati che tengono conto del percorso, anziché affidarsi esclusivamente al rilevamento della lingua del browser.

/ 01

Inizia con gli URL

Assegnare a ogni versione linguistica un percorso stabile

Utilizza una struttura di percorso come /fr/pricing o /de/products/widget. La pagina deve essere raggiungibile direttamente, visualizzare la lingua corrispondente sul server e rimanere valida quando un crawler la richiede senza cookie del browser o una preferenza Accept-Language.

  • Mantenere un URL canonico per ogni versione linguistica.
  • Per le pagine dinamiche, utilizzare slug stabili o una strategia di slug localizzati documentata.
  • Restituisci una risposta 200 reale per ogni percorso linguistico pubblicato.
Forma del percorso dell'App Router
app/
  [locale]/
    products/
      [slug]/
        page.js
        opengraph-image.js
    layout.js
    sitemap.js

// /fr/products/widget
// /de/products/widget
/ 02

Genera metadati

Creare relazioni linguistiche reciproche

I metadati di Next.js supportano un oggetto alternates.languages. Genera lo stesso set completo di lingue per ogni pagina locale, in modo che le versioni inglese, francese e tedesca rimandino tutte l'una all'altra.

  • Includi la pagina corrente nella sua mappa linguistica.
  • In ambiente di produzione, utilizzare URL HTTPS completi.
  • Assicurati che i codici lingua siano coerenti con i valori locali utilizzati dalla tua applicazione.
generaMetadata con Altified
import { headers } from "next/headers";
import { altified } from "@/lib/altified";

export async function generateMetadata() {
  const locale = (await headers()).get("x-altified-locale") || "en";

  return altified.translatedMetadata({
    locale,
    path: "/pricing",
    origin: "https://example.com",
    locales: ["en", "fr", "de"],
    title: "Pricing",
    description: "Plans for your product.",
  });
}
/ 03

Visualizza il contenuto

Fai in modo che la lingua della pagina corrisponda all'URL

Hreflang non è un meccanismo di traduzione. La pagina all'indirizzo /fr/products/widget deve effettivamente visualizzare contenuti, metadati, navigazione, dati strutturati e valori dinamici pertinenti in francese. Risolvere la lingua attiva prima che la risposta raggiunga il browser.

  • Traduci insieme titoli, descrizioni, campi Open Graph e intestazioni visibili.
  • Inoltra le impostazioni locali attive alle API di backend.
  • Utilizza le lingue di origine come lingua di riserva mentre la traduzione è in corso.
Inoltra le impostazioni locali attive
const response = await altifiedFetch(BACKEND_URL + path);

// The active Altified locale is forwarded to the backend.
const product = await response.json();
/ 04

Convalida il cluster

Verificare entrambe le direzioni prima del lancio

I motori di ricerca possono ignorare i gruppi di pagine incompleti o contraddittori. Testa ogni pagina pubblicata in una determinata lingua, esamina l'intestazione visualizzata e verifica che i link siano reciproci e che ogni pagina abbia un URL auto-canonico.

  • Inglese punta a francese, tedesco e inglese.
  • Il francese punta all'inglese, al tedesco e al francese.
  • Ogni elemento canonico utilizza la stessa lingua del contenuto della pagina.
  • Le località non pubblicate o incomplete non vengono pubblicizzate come alternative dal vivo.

/ Lista di controllo della produzione

Verifica l'esperienza linguistica prima dell'avvio.

  • Ogni località ha un URL diretto e indicizzabile dai motori di ricerca.
  • Ogni pagina in una determinata lingua restituisce contenuti e metadati tradotti.
  • I link Hreflang sono reciproci.
  • I canonici sono autoreferenziali nel linguaggio della pagina.
  • Sono inclusi percorsi dinamici per prodotti e articoli.
  • La mappa del sito contiene l'insieme degli URL delle diverse lingue.

/ Domande frequenti

Domande che i team si pongono prima di implementare la SEO multilingue.

Next.js genera automaticamente hreflang?

Next.js fornisce API per i metadati relativi alle alternative linguistiche, ma la tua applicazione deve fornire gli URL delle impostazioni locali e la mappatura della lingua corretti.

Gli URL hreflang devono essere assoluti?

Utilizza URL HTTPS completi nei metadati e nelle sitemap di produzione, in modo che le relazioni tra le lingue siano inequivocabili.

Ho ancora bisogno dei tag canonici quando utilizzo hreflang?

Sì. Hreflang descrive le versioni linguistiche o regionali equivalenti; ogni pagina localizzata dovrebbe comunque identificare il proprio URL canonico.