Kiểm tra schema markup: xác thực dữ liệu có cấu trúc trên một trang hoặc cả website
Dữ liệu có cấu trúc cho công cụ tìm kiếm biết một trang nói về gì ở dạng chúng đọc được mà không phải đoán: đây là một sản phẩm, đây là giá của nó, đây là tác giả. Công cụ kiểm tra schema markup đọc markup đó và cho bạn biết nó có phân tích được không, có dùng từ vựng đúng không và có đủ đầy đủ cho một tính năng tìm kiếm không. Một trang thì dễ kiểm tra. Một website với hàng nghìn trang dựng từ template cần chạy cùng phép kiểm tra đó ở mọi nơi.
Công cụ kiểm tra schema markup kiểm tra gì
Việc xác thực diễn ra ở bốn cấp, và mỗi cấp bắt một loại vấn đề khác nhau:
- Cú pháp. JSON-LD có phân tích được không? Mọi thuộc tính microdata có nằm trong một item không? Thiếu một dấu phẩy hoặc một dấu nháy không được escape có thể khiến cả khối không đọc được.
- Từ vựng. Type và thuộc tính có phải là thuật ngữ Schema.org thật, được dùng trên đúng type của chúng không? Một thuộc tính viết sai chính tả vẫn là JSON hợp lệ nhưng không có nghĩa gì.
- Yêu cầu của tính năng. Google có tài liệu về thuộc tính bắt buộc và khuyến nghị cho mỗi rich result mà họ hỗ trợ. Markup có thể là Schema.org hợp lệ mà vẫn thiếu một thuộc tính Google cần cho product snippet hay event listing.
- Khớp với trang. Nguyên tắc về dữ liệu có cấu trúc của Google yêu cầu markup mô tả nội dung khách truy cập nhìn thấy được. Một mức giá trong markup không có trên trang, hoặc một headline khác với tiêu đề hiển thị, là vấn đề chất lượng mà không phép kiểm tra cú pháp nào tìm ra.
Hầu hết công cụ kiểm tra một trang bao quát ba cấp đầu. Cấp thứ tư cần markup và trang đã kết xuất đặt cạnh nhau.
Schema Markup Validator của Schema.org và Rich Results Test của Google
Hai công cụ miễn phí kiểm tra từng trang một, và chúng trả lời những câu hỏi khác nhau. Giới thiệu về dữ liệu có cấu trúc của Google khuyến nghị dùng Rich Results Test trong lúc xây dựng.
| Schema Markup Validator | Rich Results Test | |
|---|---|---|
| Đơn vị phát triển | Schema.org | |
| Số trang mỗi lần kiểm tra | 1 | 1 |
| URL hoặc mã dán vào | ✓ | ✓ |
| JSON-LD, microdata, RDFa | ✓ | ✓ |
| Toàn bộ từ vựng Schema.org | ✓ | – |
| Điều kiện rich result của Google | – | ✓ |
| Thiếu thuộc tính bắt buộc | – | ✓ |
| Xem trước kết quả | – | ✓ |
Schema Markup Validator đã thay thế Structured Data Testing Tool cũ của Google. Hãy dùng nó để biết markup có đúng Schema.org không, kể cả các type cung cấp dữ liệu cho knowledge panel hoặc câu trả lời AI nhưng không có rich result. Hãy dùng Rich Results Test khi mục tiêu là một tính năng cụ thể của Google. Không công cụ nào kiểm tra cả website trong một lần. SEO ProCheck hướng dẫn gỡ lỗi rich result không hoạt động bằng cả hai.
JSON-LD, microdata và RDFa
Google đọc cả ba định dạng và nói chúng tốt như nhau khi hợp lệ, nhưng khuyến nghị JSON-LD vì nó nằm trong một khối script, tách khỏi HTML, và dễ giữ đúng nhất trên các template. Một khối Product tối giản trông như sau:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Microdata và RDFa đặt cùng thông tin vào thuộc tính của HTML hiển thị. Cách đó giữ markup gần với nội dung, nhưng một thay đổi template HTML có thể âm thầm làm hỏng nó. Dù dùng cách nào, hãy dùng một cách cho mỗi item; mô tả cùng một sản phẩm hai lần bằng hai định dạng dễ dẫn tới việc hai bản mâu thuẫn nhau.
Lỗi dữ liệu có cấu trúc thường gặp
- JSON hỏng. Một dấu phẩy thừa ở cuối, một dấu nháy cong dán từ tài liệu, hoặc một xuống dòng thô bên trong chuỗi.
- Thiếu @context hoặc @type. Thiếu chúng, trình phân tích không biết khối đó mô tả gì.
- Thiếu thuộc tính bắt buộc. Xem bảng bên dưới.
- Markup không khớp với trang. Giá đã đổi trên trang nhưng chưa đổi trong markup.
- Giá trị cũ. Một offer có priceValidUntil đã qua, hoặc dateModified trước datePublished.
Thuộc tính bắt buộc cho một vài tính năng phổ biến, từ search gallery của Google:
| Loại | Google yêu cầu |
|---|---|
| Product snippet | name, cộng offers, review hoặc aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (tất cả là khuyến nghị) |
Một số markup vẫn hợp lệ nhưng không còn mang lại những gì nó từng mang lại:
| Markup | Thay đổi | Có từ |
|---|---|---|
| data-vocabulary.org | Không được hỗ trợ | 2021 |
| HowTo | Không có rich result | Tháng 9 năm 2023 |
| FAQPage | Chỉ website chính phủ và y tế | Tháng 8 năm 2023 |
| FAQPage | Không có rich result | Tháng 5 năm 2026 |
Vì sao một trang là không đủ
Dữ liệu có cấu trúc gần như luôn được tạo bởi template. Khi nó hỏng, nó hỏng trên mọi trang template đó phục vụ, hoặc trên nhóm trang có một trường bị trống. Kiểm tra trang sản phẩm bạn tình cờ mở sẽ không cho thấy 300 sản phẩm không có giá vì trường giá của chúng là một khoảng, hay các bài viết của một tác giả không có markup tác giả.
Ba điều chỉ lộ ra trên toàn website:
- Độ bao phủ. Nhóm trang nào có markup, và trang nào trong một nhóm thiếu thứ mà các trang cùng nhóm có.
- Trường hợp biên. Trường trống, ký tự lạ và giá trị chỉ một số bản ghi có.
- Trôi dạt. Markup hợp lệ lúc ra mắt nhưng không còn hợp lệ sau một lần phát hành. Tài liệu của Google khuyến nghị theo dõi các báo cáo rich result sau khi triển khai chính vì lý do này.
Cách xác thực schema markup trên toàn website
- Crawl website và trích xuất dữ liệu có cấu trúc từ mọi trang HTML. Nếu một số markup do JavaScript chèn vào, hãy kết xuất cả các trang, như mô tả trong hướng dẫn JavaScript SEO crawler.
- Sửa lỗi cú pháp trước. Không thể kiểm tra gì khác trên một khối không phân tích được.
- Gom trang theo template và liệt kê các type mỗi nhóm có. Tìm các trang thiếu một type mà phần lớn nhóm của chúng có.
- Kiểm tra thuộc tính bắt buộc cho các tính năng bạn muốn, rồi tới các thuộc tính khuyến nghị.
- So sánh markup với văn bản hiển thị: tên, headline và giá nên xuất hiện trên trang.
- Kiểm tra mẫu bằng Rich Results Test mỗi template một trang, để xác nhận những gì Google thấy.
- Theo dõi Search Console sau mỗi lần phát hành: các báo cáo rich result và Kiểm tra URL cho thấy Google tìm thấy gì trong lần crawl của chính họ.
Dữ liệu có cấu trúc là một bước của checklist audit SEO kỹ thuật, và markup sạch cũng giúp hệ thống AI đọc trang, như hướng dẫn AI SEO crawler giải thích.
Xác thực dữ liệu có cấu trúc với Neova
Danh mục Dữ liệu có cấu trúc của Neova đánh dấu schema markup trên mỗi trang là hợp lệ, có cảnh báo hoặc có lỗi, thêm cột Loại schema, và đưa ra kết luận cho từng type trong bảng URL. Nó đọc JSON-LD, microdata và RDFa từ mọi trang HTML trong lần crawl. Một số mục kiểm tra:
- Dữ liệu có cấu trúc có lỗi cú pháp, với JSON-LD không phân tích được hoặc thiếu @context hay @type
- Dữ liệu có cấu trúc thiếu thuộc tính bắt buộc hoặc khác với văn bản hiển thị, cho các tính năng Google có tài liệu
- Dữ liệu có cấu trúc thiếu thuộc tính khuyến nghị, mục này cũng đánh dấu markup data-vocabulary.org
- Giá Product trong dữ liệu có cấu trúc không hiển thị trên trang HTML và Ngày priceValidUntil của Offer đã qua
- Ngày mâu thuẫn trong dữ liệu có cấu trúc, lastmod của sitemap hoặc Last-Modified
- Thiếu loại dữ liệu có cấu trúc phổ biến trong nhóm trang và Trang HTML thiếu markup rich result mà nhóm trang của nó có
- Markup Organization hoặc Person thiếu thuộc tính nhận dạng
- Trang HTML không có dữ liệu có cấu trúc, mục này cũng đọc HTML đã kết xuất khi lần crawl có kết xuất
- Rich result không hợp lệ, từ Kiểm tra URL trong Google Search Console
Vì Neova tìm nhóm trang từ HTML, một vấn đề template sẽ hiện ra thành một nhóm cùng mục đánh dấu thay vì hàng nghìn dòng riêng lẻ. Các câu hỏi còn lại về type và định dạng được trả lời trong FAQ về schema markup của SEO ProCheck. Xem Tính năng hoặc tải Neova; Gói miễn phí crawl 1.000 URL với mọi mục kiểm tra.
Câu hỏi
Công cụ kiểm tra schema markup là gì?
Một công cụ đọc dữ liệu có cấu trúc trên trang, ở dạng JSON-LD, microdata hoặc RDFa, và kiểm tra nó phân tích được, dùng type và thuộc tính Schema.org đúng cách và, với một số công cụ, có đủ những gì một tính năng tìm kiếm yêu cầu.
Schema Markup Validator và Rich Results Test khác nhau thế nào?
Schema Markup Validator tại validator.schema.org kiểm tra markup theo toàn bộ từ vựng Schema.org. Rich Results Test của Google kiểm tra trang đủ điều kiện cho rich result nào của Google và thiếu thuộc tính bắt buộc hay khuyến nghị nào.
Dữ liệu có cấu trúc hợp lệ có đảm bảo có rich result không?
Không. Google nói markup hợp lệ giúp trang đủ điều kiện, không phải được đảm bảo. Google quyết định có hiển thị rich result hay không dựa trên truy vấn, trang và các nguyên tắc chất lượng.
Có thể xác thực schema markup trên cả website không?
Không thể với các công cụ kiểm tra một trang. Một crawler trích xuất và kiểm tra dữ liệu có cấu trúc trên mọi trang sẽ cho thấy vấn đề template, markup bị thiếu và các trang khác với nhóm của chúng, rồi bạn kiểm tra mẫu mỗi template một trang bằng Rich Results Test.
Nên dùng định dạng dữ liệu có cấu trúc nào?
Google đọc JSON-LD, microdata và RDFa và khuyến nghị JSON-LD, vì nó nằm trong một khối riêng tách khỏi HTML và dễ bảo trì nhất.