Next.js hreflang

Next.js hreflang: implementar alternativas de idioma no App Router

Um guia prático para rotas de localização, links hreflang recíprocos, metadados traduzidos e páginas dinâmicas numa aplicação Next.js App Router.

Resposta curta

O Hreflang funciona quando cada versão de idioma tem o seu próprio URL rastreável, identifica o conjunto completo de idiomas e cria ligações para as outras versões. No Next.js, gere estas relações com metadados que têm em conta as rotas, em vez de depender apenas da deteção do idioma do browser.

/ 01

Comece com URLs

Dê a cada versão de idioma uma rota estável

Utilize uma estrutura de rotas como /fr/pricing ou /de/products/widget. A página deve ser acessível diretamente, renderizar o idioma correspondente no servidor e permanecer válida quando um rastreador a solicitar, sem a necessidade de cookies do navegador ou da preferência Accept-Language.

  • Mantenha um único URL canónico por versão de idioma.
  • Utilize slugs estáveis ou uma estratégia de slugs localizados documentada para páginas dinâmicas.
  • Devolver uma resposta 200 real para cada rota de idioma publicada.
Formato da rota do router de aplicações
app/
  [locale]/
    products/
      [slug]/
        page.js
        opengraph-image.js
    layout.js
    sitemap.js

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

Gerar metadados

Criar relações linguísticas recíprocas

Os metadados do Next.js suportam um objeto `alternatives.languages`. Isto permite gerar o mesmo conjunto completo de idiomas em cada página de localização, garantindo que as versões em inglês, francês e alemão apontam umas para as outras.

  • Inclua a página atual no seu próprio mapa de idiomas.
  • Utilize URLs HTTPS totalmente qualificados em produção.
  • Mantenha os códigos de idioma consistentes com os valores de localidade utilizados pela sua aplicação.
gerarMetadados com 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

Renderize o conteúdo

Faça com que o idioma da página corresponda ao URL.

O hreflang não é um mecanismo de tradução. A página em /fr/products/widget deve renderizar o conteúdo em francês, os metadados, a navegação, os dados estruturados e os valores dinâmicos relevantes. A localidade ativa deve ser determinada antes da resposta chegar ao navegador.

  • Traduza títulos, descrições, campos Open Graph e cabeçalhos visíveis em conjunto.
  • Reencaminhe a localidade ativa para as APIs de backend.
  • Utilize traduções alternativas no idioma de origem enquanto a tradução estiver pendente.
Encaminhe a localidade ativa.
const response = await altifiedFetch(BACKEND_URL + path);

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

Valide o cluster

Verifique ambas as direções antes do lançamento.

Os motores de busca podem ignorar agrupamentos linguísticos incompletos ou contraditórios. Teste cada página publicada num idioma específico, inspecione o cabeçalho renderizado e confirme se os links são recíprocos e se cada página tem um URL autocanónico.

  • O inglês aponta para o francês, o alemão e o inglês.
  • O francês aponta para o inglês, o alemão e o francês.
  • Cada texto canónico utiliza a mesma linguagem que o conteúdo da página.
  • Os locais não publicados ou incompletos não são anunciados como alternativas ao vivo.

Lista de verificação de produção

Verifique a compatibilidade com o idioma antes de iniciar o projeto.

  • Cada localidade tem um URL direto e rastreável.
  • Cada página em idioma diferente devolve conteúdo traduzido e metadados.
  • Os links Hreflang são recíprocos.
  • Os elementos canónicos são autorreferenciais na linguagem da página.
  • Estão incluídas rotas dinâmicas para produtos e artigos.
  • O mapa do site contém o conjunto de URLs por idioma.

Perguntas frequentes

Perguntas que as equipas fazem antes de implementar SEO multilingue.

O Next.js gera o hreflang automaticamente?

O Next.js fornece APIs de metadados para alternativas de idioma, mas a sua aplicação deve fornecer os URLs de localidade e o mapeamento de idioma corretos.

Os URLs hreflang devem ser absolutos?

Utilize URLs HTTPS totalmente qualificados nos metadados de produção e nos mapas do website para que as relações entre os idiomas sejam inequívocas.

Ainda preciso de tags canónicas ao usar hreflang?

Sim. O Hreflang descreve versões equivalentes noutras línguas ou regiões; cada página localizada deve ainda identificar o seu próprio URL canónico.