hreflang en canoniek voor 20 talen in Next.js 15: metadata API, sitemap en typefouten
Twee verschillende taken
canonical en hreflang worden vaak verward, en hierdoor is de vertaalindexering niet goed.
- canoniek zegt: “van de groep identieke pagina’s is deze de belangrijkste.” Vertalingen zijn geen identieke pagina's.
- hreflang zegt: "deze pagina heeft versies in andere talen, hier zijn hun adressen."
Vandaar de hoofdregel: elke taalversie verwijst canoniek naar zichzelf. Als /kk/blog/post canoniek instelt op /en/blog/post, beschouwt Google de Kazachse versie als een kopie van de Engelse versie en wordt deze niet weergegeven in de resultaten.
Opmaakvereisten
- hreflang reciprocal: als pagina A naar B linkt, dan moet B naar A linken. Google negeert niet-wederzijdse links.
-Elke pagina neemt zichzelf op in de set.
- Codes - ISO 639-1 voor taal en, indien nodig, ISO 3166-1 alpha-2 voor regio gescheiden door een koppelteken:
ru,kk,en,pt-BR. Onderstrepingsteken (pt_BR) is niet geschikt. x-default- pagina voor gebruikers van wie de taal niet in de lijst voorkomt: meestal taalselectie of hoofdversie.- Alleen absolute URL's, en precies de URL's die 200 retourneren en zichzelf als canoniek beschouwen. De hreflang-link naar een adres met een omleiding is een fout.
Eén bron van waarheid
De lijst met landinstellingen en de beschikbaarheid van vertalingen voor een specifieke pagina moeten van één plaats worden gehaald:
// lib/i18n/config.ts
export const SITE = "https://example.com";
export const LOCALES = ["ru", "en", "kk", "uz", "tr", "de", "fr", "es", "pt-BR", "it",
"pl", "uk", "ar", "hi", "id", "ja", "ko", "zh", "vi", "th"] as const;
export type Locale = (typeof LOCALES)[number];
export const DEFAULT_LOCALE: Locale = "en";
export function localizedUrl(locale: Locale, path: string) {
return `${SITE}/${locale}${path === "/" ? "" : path}`;
}Metadata genereren
// app/[locale]/blog/[slug]/page.tsx
import type { Metadata } from "next";
import { LOCALES, type Locale, localizedUrl, DEFAULT_LOCALE } from "@/lib/i18n/config";
import { getPostTranslations } from "@/lib/posts";
export async function generateMetadata({
params,
}: {
params: Promise<{ locale: Locale; slug: string }>;
}): Promise<Metadata> {
const { locale, slug } = await params;
const translations = await getPostTranslations(slug); // только реально переведённые локали
const path = `/blog/${slug}`;
const languages: Record<string, string> = {};
for (const l of LOCALES) {
if (translations.includes(l)) languages[l] = localizedUrl(l, path);
}
if (translations.includes(DEFAULT_LOCALE)) {
languages["x-default"] = localizedUrl(DEFAULT_LOCALE, path);
}
return {
alternates: {
canonical: localizedUrl(locale, path), // сама на себя
languages,
},
};
}In Next.js 15 is params een belofte, dus await. Stel metadataBase in de hoofdindeling in als u relatieve paden gebruikt; hier zijn de adressen absoluut en is het betrouwbaarder.
Onvertaalde pagina's
Het meest voorkomende probleem met meertalige sites: 5 zijn vertaald voor 20 talen, en de overige 15 adressen bieden Engelse tekst onder /de/, /ja/ enzovoort. Dit zijn 15 opnames voor elk artikel. Opties:
- 1.Genereer dergelijke routes niet:
generateStaticParamsretourneert alleen bestaande paren, en inpage.tsxvoor ontbrekende -notFound(). - 2.Als de route moet bestaan (de algemene interface is bijvoorbeeld vertaald, maar het artikel niet), geef de pagina dan weer met
robots: { index: false }en neem deze niet op in de hreflang en sitemap.
De bovenstaande code houdt hier al rekening mee: alleen locales uit translations zijn opgenomen in languages.
Sitemap met alternatieven
hreflang kan ook worden gespecificeerd in de sitemap - dit is handig als er veel pagina's zijn:
// app/sitemap.ts
import type { MetadataRoute } from "next";
import { localizedUrl, type Locale } from "@/lib/i18n/config";
import { getAllPostsWithTranslations } from "@/lib/posts";
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
const posts = await getAllPostsWithTranslations();
return posts.flatMap((post) =>
post.locales.map((locale: Locale) => ({
url: localizedUrl(locale, `/blog/${post.slug}`),
lastModified: post.updatedAt,
alternates: {
languages: Object.fromEntries(
post.locales.map((l: Locale) => [l, localizedUrl(l, `/blog/${post.slug}`)])
),
},
}))
);
}Kies één methode: in <head> of in de sitemap. Beide zijn tegelijkertijd geldig, maar als ze uiteenlopen, krijg je tegenstrijdige signalen. Houd met 20 talen en duizenden pagina's rekening met de limiet van 50.000 URL's per bestand en verdeel de sitemap via generateSitemaps.
Diagnostiek
- Search Console → Pagina-indexering → “Dupliceren, Google heeft een andere canonieke pagina gekozen” voor vertalingen: controleer canoniek en controleer of de tekst daadwerkelijk is vertaald en niet hetzelfde is als het origineel.
- Bekijk de bron-HTML, niet de DOM in DevTools:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. De tags moeten in het serverantwoord voorkomen. - Controleer de wederkerigheid met een script: laad voor elke pagina alle URL's uit de hreflang en zorg ervoor dat ze allemaal teruglinken.
- Omleidingen per browsertaal. Als
/automatisch doorverwijst naarAccept-Language, is het mogelijk dat de robot (die deze header doorgaans niet verzendt) sommige versies nooit te zien krijgt. Bied taalselectie aan, maar forceer geen omleidingen vanaf taal-URL's.
Beperkingen
hreflang is een hint, geen richtlijn: Google kan een andere versie tonen als zij deze relevanter acht. Yandex ondersteunt hreflang, maar voor het Russischsprekende publiek kan regionale binding in Webmaster meer betekenen. En als de vertalingen machinaal zijn gemaakt en van slechte kwaliteit zijn, kan een goede opmaak hen niet behoeden voor een lage kwaliteitsbeoordeling.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.