Schema Library: Template JSON-LD, Validate Checklist, Version Log

Schema Library là thư viện chuẩn hóa mẫu JSON-LD, kèm quy tắc đúng khi/sai khi, checklist validate, và version log để triển khai structured data nhất quán.

Tài liệu này dùng khi cần giảm lỗi schema, giúp máy hiểu đúng nội dung/thực thể, và đo được mức độ áp dụng bằng Schema Adoption Rate.

---

Mục tiêu và đầu ra #

Schema Library là “tài liệu kiểm chứng”, không phải “kho snippet”.

Output: mỗi schema type có 1 trang gồm template JSON-LD, rule dùng đúng, checklist validate, changelog phiên bản.

Đầu ra tối thiểu (public):

• Mẫu JSON-LD theo use-case (Organization, Article, FAQPage, HowTo, Service).
• “Đúng khi / Sai khi” để tránh dùng sai loại trang.
• Checklist validate (Rich Results Test + Schema Validator + kiểm tra indexability).
• Version log (v1.0/v1.1…) có “what changed/why changed”.
• Schema Adoption Rate: định nghĩa page mục tiêu và cách đếm.

---

Nguyên tắc triển khai structured data #

Structured data chỉ được coi là hợp lệ khi khớp nội dung hiển thị và tuân thủ guideline chung của Google.

Output: schema không lệch nội dung, không đánh dấu dữ liệu không tồn tại trên trang.

Đúng khi:

• Dữ liệu trong schema phản ánh đúng nội dung người dùng nhìn thấy trên trang.
• Dùng JSON-LD và triển khai ổn định theo template.
• Trang không bị chặn truy cập/index (robots/noindex/login).

Sai khi:

• Đánh dấu FAQ/HowTo “ẩn” hoặc không có nội dung tương ứng.
• Dùng sai schema cho sai loại trang (Article cho landing dịch vụ).
• Trùng lặp schema (plugin + custom) gây conflict/duplicate.

---

Danh mục schema theo use-case #

Mỗi nhóm trang nên có “schema mục tiêu” rõ để dễ audit và đo adoption.

Output: bảng mapping trang mục tiêu → schema type → cách validate.

Schema	Trang mục tiêu	Dùng khi	Không dùng khi	Validate
Organization	Homepage, About, entity brand	Khai báo thực thể thương hiệu	Nhét bừa mọi trang	Rich Results Test + Validator
Article	Blog/News/KB bài viết	Có author, ngày, nội dung dạng bài	Landing dịch vụ thuần CTA	Rich Results Test
FAQPage	Trang có Q&A hiển thị	Q&A thật, người dùng đọc được	FAQ ẩn/nhồi keyword	Rich Results Test
HowTo	Hướng dẫn có bước	Có step-by-step rõ	Bài giải thích/quan điểm	Rich Results Test
Service	Trang dịch vụ	Mô tả scope/deliverables rõ	Bài blog/KB	Validator + audit logic

Liên kết hệ thống: schema Service nên đi cùng trang dịch vụ SEO Website và dịch vụ SEO cho AI để entity và offer rõ hơn trong site graph.

---

Checklist validate (bắt buộc) #

Validate giúp phát hiện lỗi “Google đọc không ra” và lỗi “đủ cú pháp nhưng sai điều kiện”.

Output: mỗi URL có trạng thái pass/fail + log lỗi + ngày kiểm tra.

Quy trình 5 bước:

1. Kiểm tra render: schema có xuất hiện trong HTML cuối (Inspect / View Source).
2. Rich Results Test: sửa lỗi (error) trước; warning xử lý theo mức ưu tiên.
3. Schema Markup Validator: bắt lỗi schema.org tổng quát (ngoài Google-specific).
4. Kiểm tra indexability: không noindex/robots chặn; URL truy cập được.
5. Theo dõi GSC: nếu có report cho loại markup, kiểm tra coverage/lỗi sau khi index.

---

Schema Adoption Rate (KPI minh bạch) #

KPI đúng là “phủ đúng trang mục tiêu + pass validate”, không phải “có schema là xong”.

Output: % adoption theo tháng và theo nhóm trang (service/article/faq…).

Định nghĩa:

• Page mục tiêu: danh sách URL thuộc nhóm cần schema (ví dụ: toàn bộ trang dịch vụ).
• Adopted page: URL có schema đúng loại + không có lỗi critical trong Rich Results Test.

Công thức:

• Schema Adoption Rate (%) = (Số adopted page / Số page mục tiêu) × 100

---

Version log (mẫu ghi phiên bản) #

Version log là audit trail, giúp người đọc thấy thay đổi có lý do.

Output: mỗi lần cập nhật template/schema rule đều ghi “what changed/why changed”.

v1.0 (Initial release)

• What changed: phát hành template Organization/Article/FAQPage/HowTo/Service + checklist validate.
• Why changed: chuẩn hóa triển khai schema theo use-case và giảm lỗi conflict/duplicate.

---

Liên kết nội bộ liên quan #

• Trung tâm tài liệu: https://www.vlink.asia/kb/
• dịch vụ SEO Website: https://www.vlink.asia/dich-vu/dich-vu-seo-website/
• dịch vụ SEO cho AI: https://www.vlink.asia/dich-vu/dich-vu-seo-ai/
• SEO cho AI: https://www.vlink.asia/seo-cho-ai-la-gi/
• Case Study AI Overviews: https://www.vlink.asia/case-study-seo/

---

Nguồn tham khảo #

• Google Search Central: Structured data guidelines & implementation principles.
• Google Search Central: Rich Results Test.
• Google: Schema Markup Validator.

---

Nhận định từ VLINK #

Schema chỉ tạo “trust” khi nó vận hành như hệ chuẩn: dùng đúng ngữ cảnh, validate được, và có phiên bản để truy vết.