Command Palette

Search for a command to run...

Spiegazione dei tag Hreflang: una guida completa

Spiegazione dei tag Hreflang: una guida completa

T
Toolz Team
|Aug 23, 2026|15 min letto

Parte della raccolta Strumenti SEO

Il primo sito internazionale che ho spedito aveva undici versioni linguistiche e zero hreflang Il traffico sembrava in aggregato a posto, quindi nessuno lo ha messo in dubbio per mesi Poi un collega a Berlino ha cercato il nostro prodotto su google.de e ha ottenuto la pagina in inglese Non quella tedesca esisteva, era indicizzata, ed era scritta meglio dell'originale inglese Google non aveva proprio motivo di preferirla, quindi serviva qualunque versione avesse più link che puntassero ad essa, che era quella che avevamo promosso su Twitter in inglese per due anni.

Questa è la modalità di fallimento che hreflang esiste per prevenire ed è invisibile dall'interno del tuo mercato. Cerchi dal tuo paese nella tua lingua, ottieni la pagina giusta e concludi che tutto funziona. Le persone che sbagliano pagina sono quelle da cui non senti mai parlare, perché sono rimbalzate.

Questa guida copre hreflang end to end: cos'è l'annotazione, come sono costruiti i codici, i tre posti in cui puoi metterlo, le regole che fanno sì che Google si fidi di esso e come interagisce con tag canonici e sitemap È l'hub per un insieme di pezzi focalizzati su x-default, gli errori che rompono le implementazioni, hreflang contro canonicoe configurazioni specifiche del framework per Successivo.js e WordPress.

tl; dr: Un tag hreflang è un rel="alternate" hreflang="xx-XX" annotazione che indica ai motori di ricerca quale lingua e versione regionale di una pagina servire ogni utente Il valore è un codice di lingua ISO 639-1, facoltativamente più un codice di regione ISO 3166-1 alpha-2, quindi il Regno Unito è GB E non UK. Le annotazioni devono essere reciproche: ogni pagina di un set elenca ogni versione inclusa se stessa, oppure Google scarta il set Puoi implementarlo come HTML <link> tag, voci di sitemap XML o un HTTP Link intestazione, ma un solo metodo per URL impostato Il generatore hreflang costruisce tutti e tre i formati nel browser e convalida i codici prima di spedirli.

Cos'è un tag hreflang?

Un tag hreflang è un'annotazione che dichiara & quot; esiste un'altra versione di questa pagina per questa lingua e regione e vive in questo URL.& quot; Sembra così:

<link rel="alternate" hreflang="fr-CA" href="https://example.com/fr-ca/" />

Leggi da sinistra a destra: rel="alternate" dice che questa è una variante piuttosto che una pagina diversa, hreflang="fr-CA" dice che la variante è per i francofoni in Canada, e href fornisce l'URL assoluto Niente qui è una direttiva Google tratta hreflang come un forte suggerimento su quale URL scambiare per un dato ricercatore, non come un comando a cui deve obbedire, e annullerà il suggerimento quando le prove puntano altrove.

L'annotazione è definita in Google&#39;s documentazione sulle versioni localizzate di una pagina, e i valori del codice provengono da BCP47, lo standard IETF per i tag linguistici Bing supporta la stessa annotazione Yandex non utilizza hreflang e si basa sulle proprie impostazioni regionali, il che conta se i mercati in lingua russa fanno parte del tuo piano.

Quando hai bisogno di hreflang, e quando è una perdita di tempo?

Ne hai bisogno quando lo stesso contenuto esiste in più di una lingua, o in una lingua rivolta a più di una regione Non ne hai bisogno per un sito che esiste solo in inglese per un solo mercato, e aggiungerlo lì non fa altro che aggiungere markup.

Nella pratica emergono tre forme:

Forma del sito esempio Hai bisogno di hreflang?
Una lingua, un mercato Un sito di marketing SaaS solo negli Stati Uniti no
Molteplici lingue /en/, /de/, /ja/ versioni delle stesse pagine certo
Una lingua, più mercati example.com/us/ e example.com/uk/, entrambi inglesi Sì, e questo è il caso che più spesso si perde

La terza riga è quella su cui vale la pena soffermarsi Due pagine inglesi con prezzi diversi, copia di spedizione e ortografia sembrano duplicati per un crawler Senza hreflang, Google ne sceglie una e filtra l'altra, che è il modo in cui un negozio del Regno Unito finisce invisibile su google.co.uk mentre i suoi ranghi gemelli negli Stati Uniti L'annotazione è ciò che dice a Google che si tratta di varianti regionali deliberate piuttosto che di duplicazioni accidentali.

Come sono costruiti i codici hreflang?

Il valore ha due parti, e solo la prima è richiesta.

la lingua è un codice ISO 639-1 a due lettere, minuscolo: en, fr, de, ja, pt. la regione è un codice ISO 3166-1 alpha-2 a due lettere, maiuscolo, unito a un trattino: en-US, pt-BR, de-AT. L'involucro è una convenzione piuttosto che un requisito difficile, perché i tag linguistici vengono abbinati in modo insensibile al caso, ma ogni revisione del codice va più veloce quando la segui.

Le regole che le persone sbagliano, nell'ordine in cui le vedo sbagliare:

  • Il Regno Unito è GB. UK non è un codice ISO 3166-1. en-UK viene silenziosamente ignorato, il che è peggio di un errore perché nulla te lo dice.
  • La regione da sola non è una cosa. Non c'è modo di dire & quot;tutti in Canada&quot; senza nominare una lingua. hreflang="CA" non è valido Scrivi en-CA e fr-CA come voci separate.
  • L'America Latina è es-419. Questo è un codice regionale numerico M49 delle Nazioni Unite, valido in BCP 47, e la risposta giusta quando il tuo spagnolo è rivolto alla regione piuttosto che alla Spagna o al Messico in particolare.
  • Il cinese di solito vuole una sceneggiatura, non un paese. zh-Hant per Tradizionale e zh-Hans for Simplified descrivere il sistema di scrittura, che è ciò che interessa ai lettori. zh-CN e zh-TW lavora ma confondi la scrittura con la geografia.
  • Lingua e regione sono assi indipendenti. en-CA e fr-CA possono esistere entrambi Così può en-US, en-GB, e en-AU. Non assumere una pagina per paese o una pagina per lingua; mappa le combinazioni che il tuo sito serve veramente.

la generatore hreflang controlla ogni codice rispetto alla forma prevista e contrassegna i sottotag che non sono valori di lingua o regione riconosciuti, quindi en-UK fallisce alla tastiera invece che in una scansione tre settimane dopo.

Dove vanno i tag hreflang?

Sono supportati tre metodi di implementazione, e sono equivalenti in effetti La scelta è operativa.

metodo Dove vive Meglio per prezzo
HTML <link> Ogni pagina&#39;s <head> La maggior parte dei siti; più facile da eseguire il debug Ogni pagina porta il set completo, che cresce con il conteggio della lingua
Mappa del sito XML xhtml:link Voci della mappa del sito Grandi siti, molte località La mappa del sito deve rimanere sincronizzata; più lento da raccogliere
HTTP Link intestazione Risposta server PDF e altri file non HTML Necessita di configurazione del server; invisibile nel browser&#39;s view-source

Tag HTML nella testa:

<link rel="alternate" hreflang="en-US" href="https://example.com/us/pricing" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/pricing" />
<link rel="alternate" hreflang="de-DE" href="https://example.com/de/preise" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing" />

Lo stesso set di voci della mappa del sito, che necessita di xhtml namespace dichiarato il <urlset>:

<url>
  <loc>https://example.com/us/pricing</loc>
  <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/us/pricing"/>
  <xhtml:link rel="alternate" hreflang="en-GB" href="https://example.com/uk/pricing"/>
  <xhtml:link rel="alternate" hreflang="de-DE" href="https://example.com/de/preise"/>
  <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/pricing"/>
</url>

E come intestazione HTTP, che è l'unica opzione per un PDF:

Link: <https://example.com/us/whitepaper.pdf>; rel="alternate"; hreflang="en-US",
      <https://example.com/de/whitepaper.pdf>; rel="alternate"; hreflang="de-DE"

Scegli un metodo per set di URL Mixare tag HTML e voci di sitemap per le stesse pagine non è fatale, ma dà a Google due fonti che possono andare alla deriva, e il giorno in cui non sono d'accordo non saprai quale ha vinto Se stai già producendo una sitemap con il Generatore di mappe del sito XML, il formato della mappa del sito cade direttamente in esso.

Perché l'hreflang deve essere reciproco?

Perché un reclamo unidirezionale non è verificabile Se la tua pagina inglese dice & quot; la versione francese è laggiù&quot; e la pagina francese non dice nulla, chiunque potrebbe puntare a chiunque La regola di Google&#39;s è che entrambe le parti devono essere d'accordo, e il requisito del tag di ritorno è indicato chiaramente nella sua documentazione: le annotazioni senza confermare i tag di ritorno vengono ignorate.

La forma pratica della regola è più semplice di quanto sembri Metti il completo, identico insieme di annotazioni su ogni pagina del gruppo, inclusa una voce autoreferenziale per la pagina stessa La pagina inglese elenca inglese, francese, tedesco e x-default Così fa la pagina francese Così fa la pagina tedesca Stesso blocco, byte per byte, su tutti loro.

Quella ridondanza è la funzione Rende l'insieme autoverificante e rende meccanica la distribuzione: costruisci il blocco una volta per gruppo URL e rendilo da un'unica fonte anziché modificare manualmente per pagina L'editing manuale è il modo in cui un insieme di nove pagine finisce con otto blocchi corretti e una voce mancante, e una voce mancante è sufficiente affinché Google diffidi della coppia a cui appartiene.

Cosa fa x-default?

x-default nomina la pagina da servire quando nessun'altra voce corrisponde all'utente Qualcuno che naviga in terre coreane su un sito con versioni inglese, francese e tedesca: senza x-default, Google indovina Con esso, decidi tu, e la risposta è di solito un selettore di lingua o la tua homepage internazionale principale.

Non è un codice di lingua e non ne sostituisce uno La tua pagina in inglese ha ancora bisogno di una propria en oppure en-US ingresso e x-default si siede accanto come un catch-all Google lo tratta come opzionale, e lo tratto come richiesto, perché & quot; l'algoritmo sceglie qualcosa& quot; non è una strategia di routing Il guida completa x-default copre dove puntarlo, cosa succede quando lo punti su un reindirizzamento e perché una pagina di selezione della lingua ha bisogno di cure proprie.

Come interagiscono i tag hreflang e canonici?

Rispondono a domande diverse e non devono contraddirsi a vicenda.

Un tag canonico dice & quot; di questi URL quasi identici, indicizza questo.& quot; Un'annotazione hreflang dice & quot;questi URL sono alternati localizzati, servono quello giusto per utente.& quot; Il fallimento che mangia le versioni in tutta la lingua si sta canonizzando in tutte le lingue: la tua pagina francese dichiara canonica la pagina inglese, il che dice a Google di eliminare l'URL francese dall'indice, e hreflang non può resuscitare un URL che è stato canonizzato.

La regola è breve. Ogni pagina si canonizza a se stessa. Hreflang descrive le relazioni tra quelle pagine autocanoniche Metti in chiaro questi due fatti e i due sistemi cooperano; incrociali e il segnale più forte, canonico, vince e cancella silenziosamente le tue traduzioni. Hreflang vs canonico funziona attraverso le combinazioni, incluso il caso parametro-URL in cui entrambi sono in gioco contemporaneamente.

Come si verifica che l'hreflang funzioni?

Inizia con Search Console Il report International Targeting elenca i due fallimenti che contano su larga scala, & quot; no return tags&quot; e & quot; unknown language code&quot;, su tutta la proprietà, che batte l'ispezione delle pagine una alla volta Nota che è in ritardo: le correzioni vengono visualizzate solo dopo che Google ha eseguito la scansione di ogni pagina nel set interessato, quindi una settimana senza modifiche è normale e non è la prova che la correzione non è riuscita.

Quindi esegui la scansione del tuo sito Qualsiasi crawler che fa emergere annotazioni hreflang ti mostrerà l'insieme che ogni URL trasporta, e il controllo che stai eseguendo è se ogni pagina di un gruppo porta l'identico blocco completo Ordina per gruppo e guarda i conteggi; una pagina con quattro voci in un gruppo di cinque è il bug.

Quindi controlla la risoluzione dei target. Ciascuno href deve essere un URL assoluto che restituisce 200 ed è indicizzabile Un target che reindirizza funziona ancora ma aggiunge un hop, un target che 404s avvelena l'insieme e un target che è noindex è una contraddizione: stai pubblicizzando una pagina che hai detto a Google di ignorare.

Cosa si rompe più spesso?

In ordine approssimativo di quanto spesso li trovo:

  1. Tag di ritorno mancanti. La pagina A punta in B, B non punta indietro Google scarta la coppia.
  2. Nessun x-default. Gli utenti senza pari ottengono qualunque versione Google indovini.
  3. Codici non ISO. en-UK lead, seguiti da inventati come en-EU.
  4. URL relativi. hreflang richiede URL assoluti, protocollo e host inclusi.
  5. Disallineamenti trailing-slash. /fr/ e /fr sono URL diversi e l'annotazione deve corrispondere al modulo indicizzabile.
  6. Puntamento canonico attraverso le lingue. Annulla l'intero set.
  7. Metodi misti. Tag HTML e voci di sitemap per gli stessi URL, alla deriva.

Ognuno di questi produce un markup che sembra giusto Questo è ciò che rende noioso l'hreflang: il fallimento è sempre silenzioso. 12 errori hreflang comuni cammina attraverso ciascuno con il sintomo che osserveresti e la correzione.

Come si generano e mantengono i tag?

Per una manciata di URL, scrivere a mano il blocco va bene una volta e doloroso al secondo cambiamento Per qualsiasi cosa più grande, generalo.

la generatore di tag Hreflang prende una riga per versione - un codice e un URL assoluto - ed emette il blocco come tag di collegamento HTML, voci di mappa del sito o un'intestazione HTTP Convalida ogni codice rispetto alla forma ISO, contrassegna i sottotag non riconosciuti, cattura i codici duplicati, rifiuta gli URL relativi e avvisa quando il set non ha x-default Funziona interamente nel browser, quindi la tua struttura URL, che mappa tutta la tua architettura internazionale, non viene mai caricata da nessuna parte.

Per un sito che è già templato, la migliore risposta a lungo termine è quello di rendere il blocco dalla configurazione di routing in modo che non possa deriva Questo è ciò che il Successivo.js e WordPress le guide coprono: una fonte di verità per la mappa locale, un componente o filtro che rende l'intero insieme reciproco su ogni pagina del gruppo. Il generatore è quindi la cosa che usi per controllare l'output piuttosto che per produrlo, che è la giusta divisione del lavoro una volta che un sito supera alcune dozzine di URL.

Se stai assemblando il resto del livello SEO tecnico allo stesso tempo, il generatore di tag meta gestisce la testina per pagina e il Generatore robots.txt copre le direttive di scansione. IL guida agli strumenti di Hreflang va più in profondità sul generatore stesso.

Domande frequenti

Cos'è un tag hreflang?

Un tag hreflang è un rel="alternate" hreflang="xx-XX" annotazione che indica ai motori di ricerca quale lingua e versione regionale di una pagina servire un determinato utente Aiuta i siti internazionali a classificare la versione giusta in ogni mercato e impedisce che le pagine regionali quasi identiche vengano filtrate come duplicati.

Ho bisogno di hreflang se il mio sito è solo in inglese?

Solo se si punta a più di un mercato di lingua inglese con URL separati Un singolo sito inglese per un mercato unico non ha bisogno di hreflang Negozi separati degli Stati Uniti e del Regno Unito, entrambi in inglese, ne hanno bisogno, perché senza l'annotazione i due sembrano duplicati.

La regione fa parte di un codice hreflang richiesto?

No. Il codice della lingua è richiesto e la regione è facoltativa. en è valido da solo Ciò che non è valido è una regione senza una lingua: non c'è modo di prendere di mira un paese senza nominare una lingua.

Hreflang garantisce quale pagina mostra Google?

No. Hreflang è un segnale forte, non una direttiva Google può comunque servire una versione diversa quando altre prove, come le impostazioni esplicite della lingua user&#39;s o la lingua di query, puntano altrove.

Quanto tempo ci vuole perché le modifiche all'hreflang abbiano effetto?

Google deve eseguire una nuova scansione di ogni pagina del set prima di poter confermare i tag di ritorno, quindi le modifiche richiedono in genere giorni o settimane a seconda della frequenza di scansione del tuo sito Il rapporto International Targeting in Search Console si aggiorna sullo stesso ritardo.

Posso usare insieme hreflang e tag canonici?

Sì, e dovresti Ogni pagina si canonizza a se stessa, e hreflang descrive le relazioni tra quelle pagine auto-canoniche Canonicalizzare una versione linguistica all'altra la rimuove dall'indice e annulla il set hreflang.

Bing supporta hreflang?

SÌ. Bing sostiene lo stesso rel="alternate" hreflang annotazione. Yandex non utilizza hreflang e si affida invece alle proprie impostazioni regionali.

Dove dovrebbero andare i tag hreflang, nell'HTML o nella mappa del sito?

Entrambi funzionano I tag di collegamento HTML sono più facili da eseguire il debug e sono la scelta comune Le voci della mappa del sito mantengono le teste delle pagine magre e si adattano ai siti con molte località Usa un metodo per set di URL anziché entrambi.


Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!