JSON-LD Schema Checker

Tầm quan trọng của việc kiểm tra dữ liệu có cấu trúc

Trong kỷ nguyên Semantic Web (Web ngữ nghĩa), các robot của Google, Bing và Yahoo không chỉ đọc chữ mà còn cố gắng hiểu mối quan hệ giữa các thực thể. Việc triển khai JSON-LD giúp xác định rõ ràng: Đây là một sản phẩm, đây là một người, hay đây là một bài đánh giá. Nếu đoạn mã của bạn chứa lỗi cú pháp - chẳng hạn như dư dấu phẩy, thiếu dấu đóng ngoặc - các robot sẽ không thể giải mã thông tin. Điều này dẫn đến việc website mất đi cơ hội hiển thị Rich Snippets (như xếp hạng sao, giá sản phẩm, lịch sự kiện) trên trang kết quả tìm kiếm.

Cú pháp JSON-LD chuẩn là gì?

JSON-LD (JavaScript Object Notation for Linked Data) là một định dạng truyền tải dữ liệu sử dụng cấu trúc các cặp "khóa-giá trị". Một đoạn mã chuẩn luôn bắt đầu bằng thẻ <script type="application/ld+json">. Trong đó, hai thuộc tính quan trọng nhất là @context (xác định bộ từ điển, thường là schema.org) và @type (xác định loại dữ liệu). Công cụ kiểm tra của chúng tôi sẽ đi sâu vào từng lớp lồng nhau của JSON để đảm bảo tính nhất quán của dữ liệu.

Hướng dẫn sử dụng công cụ kiểm tra Schema

Để đạt được kết quả phân tích tốt nhất, quý khách vui lòng thực hiện theo các bước hướng dẫn chi tiết dưới đây:

• Bước 1: Sao chép mã nguồn: Truy cập vào website của bạn, nhấn F12 (hoặc Ctrl+U) để tìm đoạn mã Schema hoặc lấy mã từ các trình tạo tự động.
• Bước 2: Dán mã vào công cụ: Bạn có thể dán toàn bộ thẻ <script> hoặc chỉ phần nội dung JSON bên trong. Công cụ được lập trình để tự động nhận diện và bóc tách dữ liệu cần thiết.
• Bước 3: Thực hiện phân tích: Nhấn nút "PHÂN TÍCH MÃ". Hệ thống sẽ chạy thuật toán Parsing thời gian thực.
• Bước 4: Đọc thông báo lỗi:
  • Màu đỏ: Lỗi cú pháp nghiêm trọng, cần sửa ngay lập tức.
  • Màu vàng: Cảnh báo thiếu các trường khuyến nghị (như thiếu giá sản phẩm, thiếu ảnh đại diện).
  • Màu xanh: Thông tin đã được khai báo đúng và hợp lệ.
• Bước 5: Khắc phục và kiểm tra lại: Sau khi sửa đổi mã dựa trên gợi ý, hãy dán lại và kiểm tra cho đến khi báo cáo chuyển sang trạng thái xanh hoàn toàn.

Các lỗi Schema thường gặp và cách xử lý

Thông qua việc phân tích hàng ngàn mẫu dữ liệu, chúng tôi đã tổng hợp các lỗi phổ biến nhất mà các SEOer thường mắc phải:

1. Lỗi dấu phẩy cuối cùng (Trailing Comma): Đây là lỗi kinh điển. Trong JSON, phần tử cuối cùng của một danh sách không được phép có dấu phẩy. Hệ thống sẽ báo "Unexpected token" nếu bạn mắc lỗi này.
2. Thiếu dấu ngoặc kép: Cả khóa (key) và giá trị (value) dạng chuỗi đều phải nằm trong dấu ngoặc kép thẳng "". Nhiều người sử dụng dấu ngoặc kép cong từ Word hoặc Google Docs sẽ khiến mã bị lỗi.
3. Sai định dạng ngày tháng: Các trường như datePublished cần tuân thủ chuẩn ISO 8601 (VD: 2024-05-20).
4. Lỗi lồng ghép (Nesting): Việc mở ngoặc { mà không đóng ngoặc } tương ứng sẽ làm sập cấu trúc cây dữ liệu.

Ví dụ thực tế về sửa lỗi mã Schema

Hãy xem xét một đoạn mã Schema cho Bài viết (Article). Nếu bạn quên khai báo thuộc tính author, Google Search Console có thể gửi cảnh báo "Missing field 'author'". Bằng cách đưa mã vào công cụ kiểm tra của chúng tôi, hệ thống sẽ ngay lập tức tạo một cảnh báo màu vàng nhắc nhở bạn bổ sung thông tin tác giả để tăng tính minh bạch và uy tín (E-E-A-T) cho website.

Giải thích về các thuật ngữ kỹ thuật

Trong báo cáo kiểm tra, bạn có thể thấy các thuật ngữ sau:

- Validation: Quá trình xác nhận dữ liệu có tuân thủ quy tắc logic hay không.

- Parsing Error: Lỗi xảy ra khi máy tính không thể đọc được cấu trúc văn bản thành dữ liệu máy tính.

- Schema Dictionary: Từ điển chứa hàng ngàn thuộc tính do Schema.org quản lý.

Liên kết công cụ liên quan