Trình tạo và kiểm tra hreflang

Thêm một hàng cho mỗi phiên bản ngôn ngữ-khu vực của cùng một trang. Có thể phát hiện ngôn ngữ-khu vực từ URL và mỗi trang có thể có x-default riêng tùy chọn.

hreflang	URL	x-default (tùy chọn, theo từng trang)	Xóa

Thêm x-default

Xác định một mẫu URL cho mỗi ngôn ngữ-khu vực với {path} làm phần giữ chỗ, rồi dán mỗi đường dẫn trên một dòng.

hreflang	Mẫu URL	x-default mẫu url (tùy chọn, theo từng trang)	Xóa

Đường dẫn (mỗi dòng một đường dẫn) Thêm x-default bằng mẫu:

Ý nghĩa của kết quả này ↓

Thêm ngôn ngữ-khu vực và URL ở trên để xem đầu ra.

Chạy hoàn toàn trong trình duyệt của bạn — nội dung bạn dán không được tải lên hay lưu trữ. Số đếm kết quả ẩn danh theo từng lần chạy có thể được dùng cho nghiên cứu tổng hợp; URL, tên miền, IP và mã định danh không bao giờ được bao gồm, và không công bố số liệu thống kê khi có dưới 100 lần chạy.

Kiểm tra URL đang hoạt động

Tải trang bạn đã triển khai: chúng tôi đọc các chú thích hreflang trực tiếp, rồi tải từng phiên bản thay thế đã khai báo (tối đa 25) để xác minh liên kết trả về và tham chiếu đến chính nó.

Phản hồi

Các lần kiểm tra chạy từ máy chủ của chúng tôi; chúng tôi tải URL bạn nhập và không lưu kết quả. Số đếm kết quả ẩn danh theo từng lần chạy có thể được dùng cho nghiên cứu tổng hợp; URL, tên miền, IP và mã định danh không bao giờ được bao gồm, và không công bố số liệu thống kê khi có dưới 100 lần chạy.

Báo cáo mẫu

Một trang tiếng Anh cho Hoa Kỳ và Vương quốc Anh, có mục dự phòng en chung và x-default, sẽ tạo các thẻ head như sau:

<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/" />

…và khi chạy cụm này qua trình kiểm tra tích hợp, kết quả là:

Mã được tự động chuẩn hóa. Dù nhập en-us hay en-US, trình tạo luôn xuất mã khu vực viết hoa (en-US).
Mục en chung giúp cụm hoàn chỉnh. Nó phục vụ người nói tiếng Anh ngoài Hoa Kỳ và Vương quốc Anh, những người nếu không sẽ không khớp trang nào — xem biến thể khu vực không có mục dự phòng chung.
x-default phục vụ tất cả người dùng còn lại — xem thiếu x-default để biết điều gì xảy ra khi không có mục này.
Không thể thấy tính hai chiều chỉ từ thẻ của một trang. Vì trình tạo xuất cùng một khối đầy đủ trên mọi trang trong nhóm, mỗi URL được liệt kê cũng tự động liên kết trở lại URL này.
Hãy thử tạo lỗi: dán en-uk thay cho en-gb và trình kiểm tra sẽ báo lỗi kèm cách sửa — xem định dạng mã.

Cách sử dụng

Thêm một hàng cho mỗi trang, một cột cho mỗi ngôn ngữ hoặc khu vực, rồi nhập từng URL.
Đặt x-default riêng cho từng hàng khi cần hoặc nhập sitemap hiện có để tạo cụm.
Sao chép thẻ head, sitemap XML hoặc header HTTP Link. Mỗi trang nhận một cụm hai chiều đầy đủ.
Dán mã đánh dấu đã triển khai hoặc kiểm tra URL trực tiếp để phát hiện lỗi phổ biến trước khi xuất bản.

Cách hoạt động (và nguyên nhân hreflang bị lỗi)

Dùng khi bạn kiểm soát mẫu HTML của các trang thông tin thông thường.

Đây thường là lựa chọn rõ ràng nhất: hiển thị cùng một cụm đầy đủ trong head của mọi trang.

Dùng khi khó thay đổi mẫu hoặc khi bạn quản lý tập trung nhiều biến thể URL.

Dùng nhất quán các mục xhtml:link và bảo đảm trình thu thập dữ liệu truy cập được sitemap.

Dùng khi phiên bản thay thế là PDF hoặc tài nguyên không phải HTML.

Đây là lựa chọn thực tế cho tệp không có HTML head. Không trộn nhiều phương thức khi không cần thiết.

hreflang cho công cụ tìm kiếm biết các phiên bản ngôn ngữ hoặc khu vực của một trang để người tìm kiếm nhận đúng phiên bản. Ba phương thức tương đương: thẻ <link rel="alternate"> trong <head>, mục xhtml:link trong sitemap XML hoặc header HTTP Link (lựa chọn duy nhất cho PDF và tệp không phải HTML). Chọn một phương thức cho mỗi trang; trộn chúng dễ gây xung đột.

Hai quy tắc thường làm hỏng triển khai: mỗi trang phải có mục tự tham chiếu và mỗi cặp phải liên kết hai chiều. Nếu A liệt kê B thì B phải liên kết lại A, nếu không cặp đó sẽ bị bỏ qua. Trình tạo xuất cụm đầy đủ trên mọi trang nên tự động đáp ứng cả hai.

Biến thể khu vực không có mục dự phòng chung

Nếu bạn xuất bản en-US và en-GB nhưng không có en chung, người nói tiếng Anh ở khu vực khác sẽ không khớp phiên bản nào và Google phải tự chọn. Hãy thêm một mục en chung.

Thiếu x-default

x-default chỉ định trang cho người dùng không khớp phiên bản ngôn ngữ-khu vực nào đã khai báo, thường là trang chọn ngôn ngữ hoặc phiên bản chính. Mục này không bắt buộc, nhưng khai báo rõ ràng tốt hơn để thuật toán tự chọn.

Trang chọn ngôn ngữ độc lập cũng cần chú thích. Đặt cùng khối thẻ head trên trang đó và dùng dòng x-default làm mục tự tham chiếu để cụm vẫn hai chiều. Trong sitemap, URL bộ chọn không phải trang ngôn ngữ-khu vực sẽ tự động nhận mục <url> có chú thích riêng.

x-default cũng là chú thích theo từng trang. Các trang trong cùng cụm có thể trỏ đến các x-default khác nhau; hãy dùng cột x-default theo hàng.

Trộn http/https và dấu gạch chéo cuối không nhất quán

URL hreflang phải khớp chính xác URL canonical. Nếu một số mục dùng http:// hoặc bỏ dấu gạch chéo cuối khiến trang chuyển hướng, Google có thể loại chúng. Hãy dùng dạng canonical cuối cùng của từng URL.

Mã ngôn ngữ đã ngừng sử dụng

Một số mã ISO 639-1 đã đổi tên nhưng vẫn còn trong dữ liệu hệ thống quản lý nội dung cũ: in → id (tiếng Indonesia), iw → he (tiếng Do Thái), ji → yi (tiếng Do Thái Đức). Hãy dùng mã hiện đại.

Định dạng mã

Giá trị có dạng ngôn ngữ hoặc ngôn-ngữ-KHU-VỰC: mã ngôn ngữ ISO 639-1 gồm hai chữ cái và mã khu vực ISO 3166-1 alpha-2 tùy chọn. Lỗi phổ biến là en-uk; mã khu vực của Vương quốc Anh là GB. Subtag chữ viết như zh-Hant hoặc zh-Hans cũng hợp lệ. Không dùng dấu gạch dưới như en_US.

Tra cứu mã ngôn ngữ và khu vực

Tìm mã ngôn ngữ ISO 639-1 và mã khu vực ISO 3166-1 mà trình tạo chấp nhận. Bí danh ngôn ngữ cũ được hiển thị cùng mã thay thế.

Lọc mã

Ngôn ngữ (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

Khu vực (249)

ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

Phương pháp

Công cụ tạo cụm từ một hàng cho mỗi URL và phiên bản ngôn ngữ-khu vực, chuẩn hóa các subtag rồi xuất cùng một bộ hoàn chỉnh, bao gồm tham chiếu đến chính trang đó, cho từng trang. Sau đó, công cụ áp dụng các quy tắc xác định cho mã, URL, mục trùng lặp, giao thức, dấu gạch chéo cuối, x-default và tính đối ứng. Khi kiểm tra trang đã xuất bản, công cụ tải URL được cung cấp cùng tối đa 25 URL thay thế để đối chiếu liên kết trả về, tham chiếu đến chính trang đó và cách chuẩn hóa canonical. Mọi thao tác đều diễn ra trong trình duyệt, ngoại trừ yêu cầu tùy chọn để kiểm tra trang đã xuất bản.

Tính năng

Tạo cụm đầy đủ, hai chiều cho từng nhóm trang, bao gồm cả tham chiếu đến chính trang đó.
Xuất thẻ trong head, sitemap XML tự động chia nhỏ khi vượt quá 50.000 URL, header HTTP Link và đoạn mã cho các framework web phổ biến.
Chuẩn hóa mã ngôn ngữ và khu vực, đồng thời phát hiện dấu gạch dưới, mã đã ngừng sử dụng và khu vực không hợp lệ.
Kiểm tra locale và URL trùng lặp, giao thức không đồng nhất, dấu gạch chéo cuối không nhất quán, lỗi liên kết đối ứng và thiếu x-default.
Nhập các hàng CSV hoặc TSV hay các mục xhtml:link từ sitemap và chạy toàn bộ quá trình phân tích trong trình duyệt.
Kiểm tra một URL đã xuất bản và tối đa 25 URL thay thế được khai báo để tìm liên kết trả về và tham chiếu đến chính trang đó.

Giới hạn

Công cụ chạy trong trình duyệt; dữ liệu được dán và quá trình tạo cục bộ không truy vấn cơ sở dữ liệu tìm kiếm.
Việc kiểm tra URL đã xuất bản phụ thuộc vào khả năng truy cập trang và bị giới hạn ở 25 URL thay thế cùng nội dung phản hồi đã giải mã tối đa 2 MiB.
Trình kiểm tra chỉ xác thực dữ liệu bạn cung cấp; công cụ không thể xác nhận việc lập chỉ mục của Google, nội dung riêng tư hoặc URL mà công cụ tìm kiếm sẽ chọn.
Sitemap được chia nhỏ khi đầu ra tạo ra vượt quá 50.000 URL; tệp tải xuống gồm chỉ mục và tất cả các phần.

Câu hỏi thường gặp

Nên đặt thẻ hreflang ở đâu—trong head, sitemap hay header HTTP?

Cả ba cách đều có thể dùng và có giá trị tương đương, nhưng hãy chọn một cách cho mỗi trang. Dùng thẻ <link rel="alternate"> trong head HTML, mục xhtml:link trong sitemap XML hoặc header HTTP Link—lựa chọn duy nhất cho tệp không phải HTML như PDF. Trộn nhiều phương thức trên cùng một trang có thể gây xung đột.

x-default là gì và tôi có cần dùng không?

x-default xác định trang sẽ phục vụ người dùng không khớp với bất kỳ locale nào đã khai báo—thường là trang chọn ngôn ngữ hoặc phiên bản chính. Thuộc tính này không bắt buộc, nhưng khai báo rõ ràng tốt hơn để thuật toán tự chọn, vì vậy nó được khuyến nghị cho hầu hết trang web.

Tại sao thẻ hreflang của tôi bị bỏ qua?

Gần như luôn do một trong ba nguyên nhân: chú thích không hai chiều (trang A liệt kê B nhưng B không liên kết lại A), trang thiếu mục tham chiếu đến chính nó, hoặc URL không khớp dạng canonical (http so với https, hay dấu gạch chéo cuối mà trang web chuyển hướng), nên phải đi qua chuyển hướng. Trình tạo này xuất cụm hai chiều đầy đủ kèm tham chiếu đến chính trang để ngăn hai lỗi đầu tiên.

Thẻ hreflang và canonical có xung đột không?

Chúng phải thống nhất. Mỗi phiên bản ngôn ngữ cần có canonical tự tham chiếu, trỏ đến chính nó chứ không phải ngôn ngữ khác, và mọi URL hreflang phải là dạng canonical của trang đó. Hreflang trỏ đến URL không canonical hoặc URL chuyển hướng thường bị loại bỏ.

en-uk có phải là giá trị hreflang hợp lệ không?

Không. Mã khu vực của Vương quốc Anh là GB, vì vậy hãy dùng en-gb. Giá trị hreflang gồm mã ngôn ngữ ISO 639-1 và mã khu vực ISO 3166-1 alpha-2 tùy chọn; en-uk là lỗi phổ biến nhất.

Bước tiếp theoTrình mô phỏng sự cố SEO — practice the same investigation on labeled fixtures. Hướng dẫn có bằng tiếng Anh.

Các vấn đề thường gặp và cách khắc phục

Lỗi Mã ngôn ngữ không hợp lệ Cách khắc phục: Thay thẻ phụ ngôn ngữ bằng mã ISO 639-1 hợp lệ, chẳng hạn en, fr hoặc de.
Lỗi Mã khu vực không hợp lệ Cách khắc phục: Thay thẻ phụ khu vực bằng mã ISO 3166-1 alpha-2 viết hoa hợp lệ, chẳng hạn US hoặc GB.
Lỗi hreflang dùng dấu gạch dưới thay vì dấu gạch nối Cách khắc phục: Đổi dấu phân cách ngôn ngữ-khu vực từ dấu gạch dưới sang dấu gạch nối, ví dụ en_US thành en-US.
Lỗi Ngôn ngữ-khu vực bị trùng lặp Cách khắc phục: Chỉ giữ một phiên bản thay thế cho mỗi giá trị ngôn ngữ-khu vực và xóa hoặc hợp nhất hàng trùng lặp.
Cảnh báo URL được gán cho nhiều ngôn ngữ-khu vực Cách khắc phục: Gán từng URL thay thế cho đúng ngôn ngữ-khu vực và xóa mọi hàng thứ hai trỏ đến cùng một trang bản địa hóa.
Cảnh báo Thiếu phiên bản thay thế x-default Cách khắc phục: Thêm một phiên bản thay thế x-default trỏ đến bộ chọn ngôn ngữ trung lập hoặc trang mặc định phù hợp nhất cho người dùng không khớp.
Lỗi URL thay thế không hợp lệ Cách khắc phục: Sửa thành URL http:// hoặc https:// có thể phân tích, không chứa khoảng trắng hay ký tự sai định dạng.
Lỗi URL thay thế không phải URL tuyệt đối Cách khắc phục: Mở rộng URL thay thế tương đối thành URL https:// chuẩn đầy đủ, gồm tên máy chủ và đường dẫn.