Generatore di cluster hreflang

Dati di esempio — sostituiscili con i tuoi

Aggiungi una riga per ogni versione linguistica della stessa pagina. La lingua può essere rilevata dall’URL e ogni pagina può avere il proprio x-default facoltativo.

hreflang	URL	x-default (facoltativo, per pagina)	Rimuovi la voce

Aggiungi x-default

Definisci un modello di URL per ogni lingua con {path} come segnaposto, poi incolla un percorso per riga.

hreflang	Modello di URL	x-default modello di url (facoltativo, per pagina)	Rimuovi la voce

Percorsi (uno per riga) Aggiungi x-default usando il modello:

Cosa significa questo risultato ↓

Aggiungi qui sopra un’impostazione regionale e un URL per visualizzare l’output.

Viene eseguito interamente nel browser: nulla di ciò che incolli viene caricato o memorizzato. I conteggi anonimi degli esiti per singola esecuzione possono essere utilizzati per ricerche aggregate; URL, domini, IP e identificatori non sono mai inclusi e nessuna statistica viene pubblicata sotto le 100 esecuzioni.

Verifica un URL attivo

Recupera una pagina già pubblicata: leggiamo le sue annotazioni hreflang attive, quindi recuperiamo ogni URL alternativo dichiarato (fino a 25) per verificare link di ritorno e autoreferenze.

Commenti

I controlli vengono eseguiti dal nostro server; recuperiamo l’URL inserito e non conserviamo i risultati. I conteggi anonimi degli esiti per singola esecuzione possono essere utilizzati per ricerche aggregate; URL, domini, IP e identificatori non sono mai inclusi e nessuna statistica viene pubblicata sotto le 100 esecuzioni.

Un rapporto di esempio

Un sito in inglese per Stati Uniti e Regno Unito, con un’alternativa generica en e x-default, produce tag head come questi:

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

…e il controllo integrato di questo cluster segnala:

I codici vengono normalizzati automaticamente. Inserisci en-us o en-US: il generatore emette sempre la regione in maiuscolo (en-US), così gli errori di maiuscole non diventano un problema.
L’alternativa generica en rende il risultato completo. Raggiunge chi parla inglese fuori da Stati Uniti e Regno Unito, che altrimenti non troverebbe corrispondenze; consulta varianti regionali senza versione standard generale.
x-default raggiunge tutti gli altri; consulta x-default mancante per le pagine per capire cosa accade senza di esso.
La bidirezionalità non è visibile nei tag di una singola pagina; poiché il generatore emette lo stesso insieme completo su ogni pagina, ogni URL elencato rimanda automaticamente anche a questa pagina.
Prova a romperlo: incolla en-uk invece di en-gb e il validatore segnala l’errore indicando la correzione; consulta la struttura dei codici lingua.

Come usare il generatore

Aggiungi una riga per pagina e una colonna per lingua o regione, poi inserisci ogni URL linguistico o regionale.
Facoltativamente, imposta un x-default per riga e importa una sitemap esistente per creare un cluster.
Copia i tag head, l’XML della sitemap o gli header HTTP Link: ogni pagina riceve un cluster bidirezionale completo.
Incolla il markup pubblicato o controlla un URL per trovare gli errori comuni prima della pubblicazione.

Come funziona (e come si rompe hreflang)

Scegli un formato di distribuzione hreflang

I tag head HTML per le pagine

Usalo quando controlli i template HTML delle normali pagine online.

Di solito è la scelta più chiara: pubblica lo stesso cluster completo nell’head di ogni pagina.

Sitemap XML per le varianti

Usalo quando i template sono difficili da modificare o gestisci molte varianti di URL in modo centralizzato.

Usa le voci xhtml:link in modo coerente e mantieni la sitemap accessibile ai crawler.

Header HTTP Link per i file

Usalo quando l’alternativa è un PDF o un’altra risorsa non HTML.

È la possibilità pratica per i file senza head HTML. Evita di mescolare i metodi senza motivo.

hreflang indica ai motori di ricerca quali versioni linguistiche o regionali di una pagina esistono, così ogni persona riceve quella corretta. I tre metodi di distribuzione sono equivalenti: tag <link rel="alternate"> nel <head>, voci xhtml:link in una sitemap XML oppure header HTTP Link, l’unica possibilità per PDF e altri file non HTML. Scegli un metodo per pagina; mescolare i metodi crea conflitti.

Le due regole che fanno fallire la maggior parte delle implementazioni sono: ogni pagina deve includere una voce autoreferenziale e ogni coppia deve essere bidirezionale — se A elenca B, B deve elencare A a sua volta, altrimenti la coppia viene ignorata. Poiché questo generatore emette il cluster completo su ogni pagina, entrambe sono rispettate automaticamente.

Le varianti regionali senza una versione standard generale

Se pubblichi en-US ed en-GB ma non en generico, chi parla inglese in altri mercati non trova corrispondenze e Google sceglie per loro. Aggiungi una voce en generica che può puntare alla pagina regionale predefinita.

x-default mancante per le pagine

x-default indica la pagina da servire agli utenti che non corrispondono a nessuna lingua dichiarata, di solito un selettore di lingua o la versione principale. È facoltativo, ma è meglio renderlo esplicito che lasciare la scelta all’algoritmo.

Anche una pagina autonoma di selezione della lingua richiede le annotazioni: inserisci lo stesso insieme di tag head; la riga x-default è il suo riferimento a sé stessa, quindi il cluster resta bidirezionale. Nell’output sitemap, un URL del selettore che non è una pagina tradotta riceve automaticamente una propria voce <url> annotata.

x-default è anche un’annotazione per pagina: le pagine dello stesso cluster possono puntare a x-default diversi. Usa la colonna x-default per riga; quando le pagine differiscono, l’output passa a un insieme per pagina e ogni selettore distinto riceve una propria voce sitemap annotata.

I protocolli http/https misti e le barre finali incoerenti

Gli URL hreflang devono corrispondere esattamente all’URL canonical. Se metà delle voci usa http:// o omette la barra finale verso cui il sito reindirizza, quegli alternativi passano da reindirizzamenti che Google spesso scarta. Usa la forma finale e canonical di ogni URL.

Codici lingua obsoleti per le pagine

Alcuni codici ISO 639-1 sono stati rinominati ma restano nei vecchi export dei sistemi di gestione dei contenuti: in → id (indonesiano), iw → he (ebraico), ji → yi (lingua dell’Europa orientale). I motori di ricerca tollerano spesso le forme vecchie, ma usa i codici moderni.

La struttura dei codici lingua

I valori sono lingua o lingua-REGIONE: un codice ISO 639-1 di due lettere più, facoltativamente, una regione ISO 3166-1 alpha-2. Il caso classico è en-uk: il codice regionale del Regno Unito è GB. Anche le sottoparti di script come zh-Hant / zh-Hans sono valide. Gli underscore (en_US) non lo sono. La corrispondenza non distingue maiuscole e minuscole, quindi la grafia è solo cosmetica.

Cerca i codici lingua e regione

Cerca i codici lingua ISO 639-1 e i codici regione ISO 3166-1 accettati dal generatore. Gli alias obsoleti vengono mostrati insieme alla sostituzione.

Il filtro cerca, per esempio, en, gb o obsoleto

Filtra i codici

Le lingue e i codici lingua (188)

aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik in → id io is it iu iw → he ja ji → yi jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mo → ro mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu

Le regioni e i codici regionali (249)

ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

Il metodo e il processo

Lo strumento costruisce il cluster da una riga per URL e lingua, normalizza le sottoparti ed emette lo stesso insieme completo, con riferimenti a sé stessi, per ogni pagina. Applica poi regole deterministiche a codici, URL, duplicati, protocolli, slash finali, x-default e reciprocità. Nel controllo pubblicato recupera l’URL fornito e fino a 25 alternative per confrontare link di ritorno, riferimenti a sé stessi e canonicalizzazione. Tutto avviene nel navigatore, tranne la richiesta facoltativa del controllo pubblicato.

Funzionalità del generatore

Genera un cluster completo e bidirezionale per ogni insieme di pagine, inclusi i riferimenti a sé stesse.
Esporta tag head, XML sitemap con divisione automatica oltre 50.000 URL, header HTTP Link e modelli per i sistemi più comuni.
Normalizza i codici lingua e regione e rileva underscore, codici obsoleti e regioni non valide.
Controlla lingue e URL duplicati, protocolli misti, slash finali incoerenti, errori di reciprocità e assenza di x-default.
Il generatore importa righe CSV o TSV o voci xhtml:link da una sitemap ed esegue l’analisi interamente nel navigatore.
Controlla un URL pubblicato e fino a 25 alternative dichiarate per link di ritorno e riferimenti a sé stessi.

Le limitazioni del generatore

Il generatore funziona nel navigatore; l’input incollato e la generazione locale non interrogano un archivio di ricerca.
Il controllo di un URL pubblicato dipende dalla raggiungibilità della pagina ed è limitato a 25 alternative e a un corpo decodificato di 2 MiB.
Il validatore controlla ciò che fornisci; non può confermare l’indicizzazione Google, i contenuti privati o l’URL scelto da un motore di ricerca.
La divisione sitemap si applica all’output generato oltre 50.000 URL; lo scaricamento include l’indice e ogni parte.

Domande frequenti per lo strumento

Dove vanno i tag hreflang: nell’head, nella sitemap o in un’intestazione HTTP?

Sono possibili tutti e tre i metodi e sono equivalenti, ma scegline uno per pagina. Usa i tag <link rel="alternate"> nell’head HTML, le voci xhtml:link in una sitemap XML oppure un’intestazione HTTP Link, l’unica possibilità per file non HTML come i PDF. Mescolare i metodi sulla stessa pagina può creare conflitti.

Che cos’è x-default e devo usarlo?

x-default indica la pagina da servire agli utenti che non corrispondono ad alcuna lingua o località dichiarata, in genere un selettore della lingua o la versione principale. È facoltativo, ma è meglio dichiararlo esplicitamente che lasciare scegliere l’algoritmo; è consigliato per la maggior parte dei siti.

Perché i miei tag hreflang vengono ignorati?

Quasi sempre per uno di tre motivi: le annotazioni non sono bidirezionali, manca l’annotazione autoreferenziale oppure gli URL non corrispondono alla forma canonical e passano attraverso reindirizzamenti. Questo generatore produce il cluster bidirezionale completo con riferimenti autoreferenziali per evitare i primi due problemi.

I tag hreflang e canonical sono in conflitto?

Devono essere coerenti. Ogni versione linguistica dovrebbe avere un canonical autoreferenziale e ogni URL hreflang deve essere la forma canonical di quella pagina. Un hreflang che punta a un URL non canonical o che reindirizza viene spesso ignorato.

en-uk è un valore hreflang valido?

No. Il codice regionale del Regno Unito è GB, quindi usa en-gb. I valori hreflang sono composti da un codice lingua ISO 639-1 e da un codice regione ISO 3166-1 alpha-2 facoltativo; en-uk è l’errore più comune.

Passaggio successivoSimulatore di incidenti SEO — practice the same investigation on labeled fixtures. Le indicazioni sono disponibili in inglese.

Problemi comuni e come risolverli

Errore Il codice della lingua non è valido Correzione: Sostituisci il sottotag della lingua con un codice ISO 639-1 valido, come en, fr o de.
Errore Il codice della regione non è valido Correzione: Sostituisci il sottotag della regione con un codice ISO 3166-1 alpha-2 valido e maiuscolo, come US o GB.
Errore hreflang usa un trattino basso invece di un trattino Correzione: Sostituisci il separatore della lingua e regione da trattino basso a trattino, ad esempio da en_US a en-US.
Errore La combinazione di lingua e regione è ripetuta Correzione: Mantieni una sola alternativa per ogni valore di lingua e regione; rimuovi o unisci la riga ripetuta per quella lingua.
Avviso L’URL è assegnato a più impostazioni locali Correzione: Assegna ogni URL alternativo alla lingua e regione effettive; rimuovi la seconda voce che punta alla stessa pagina localizzata.
Avviso x-default alternate è mancanti Correzione: Aggiungi un’alternativa x-default che punti al selettore di lingua neutro o alla pagina predefinita più adatta agli utenti senza corrispondenza.
Errore Alternate URL è non valido Correzione: Correggi l’alternativa con un URL http:// o https:// analizzabile, senza spazi né caratteri non validi.
Errore Alternate URL è non assoluto Correzione: Espandi l’alternativa relativa nel relativo URL canonical completo con https://, includendo il nome del server e il percorso.