Công Cụ Xác Thực Schema Markup & JSON-LD
Cách dùng công cụ kiểm schema markup
Quay lại công cụMột trang đi vào; mọi khối JSON-LD trong HTML gốc của nó được bóc ra và đối chiếu với từ vựng Schema.org.
- 01
Nhập trang cần kiểm
Mỗi lượt một trang — dữ liệu có cấu trúc thuộc về từng trang, và một chồng cây entity không phải thứ đọc cạnh nhau được. Ô Chuẩn hoá URL vẫn quan trọng: để mức Chỉ domain là bạn đang đọc markup của trang chủ, không phải trang vừa dán.
- 02
Chạy kiểm tra trên HTML thô
Công cụ tải trang rồi bóc đúng HTML nhận được. Nó không chạy JavaScript, nên markup do script chèn vào sau khi tải xong thì không có ở đó để tìm. Vì vậy kết quả rỗng nói "không tìm thấy trong HTML gốc" chứ không nói "trang này không có schema".
- 03
Đọc bản in JSON của dữ liệu đã khai
Kết quả là một tài liệu JSON có đánh số dòng: dữ liệu có cấu trúc như đã được đọc, không phải markup thô bạn viết. Mục được tham chiếu bằng @id được điền vào đúng chỗ nó được dùng. Dòng có vấn đề được tô màu, với một icon cho lỗi và một icon khác cho cảnh báo. Dưới bản in, mỗi loại đã khai có một chip làm nổi mọi khối thuộc loại ấy.
- 04
Lần theo danh sách tới đúng dòng và xuất ra
Dưới bản in là hai con số đếm và mỗi vấn đề một mục, xếp theo số dòng. Mỗi mục liên kết tới đúng dòng của nó trong bản in, nên trang có ba mươi vấn đề vẫn đi hết được. Copy và Export ở hàng phía trên bản in trao cho bạn chính bản in: file tải về là .json bạn dán ngược lại được ngay.
Cách đọc báo cáo dữ liệu có cấu trúc JSON-LD
Danh sách trả lời hai câu hỏi: trang này khai gì, và phần nào trong đó một parser sẽ từ chối. Trường bắt buộc và điều kiện hiện rich result không được xét ở đây; công cụ tìm kiếm quyết định chúng theo từng loại rich result.
Các thành phần của bản in
- @type
- Loại Schema.org của mục, in ở dòng đầu tiên của nó, và là dòng mà loại không hợp lệ bị đánh dấu. Mục chỉ là tham chiếu thì không có dòng @type: trang không khai, và bản in không bịa thêm.
- @id
- Thứ phân biệt hai mục cùng loại, in ngay sau @type. Mục được tham chiếu bằng @id được điền vào chỗ nó được dùng, không lặp lại ở tầng trên cùng, nên bản in có thể ngắn hơn markup.
- Lỗi
- Markup mà một bộ đọc sẽ từ chối hoặc bỏ qua: type hay property không có trong từ vựng, giá trị sai kiểu, khối không phải JSON hợp lệ.
- Cảnh báo
- Markup hợp lệ nhưng nhiều khả năng không phải ý bạn — thường gặp nhất là property có thật nhưng không được định nghĩa cho type này. Schema.org gọi đó là kỳ vọng chứ không phải luật, nên ở đây chúng không bao giờ thành lỗi.
Tra cứu thông điệp
- Type không có trong từ vựng
- @type không tồn tại trong Schema.org — thường là gõ sai hoặc một cái tên site tự đặt. Mục hoàn toàn không có @type cũng báo y như vậy, vì bộ đọc không làm gì được với cả hai.
- Property không có trong từ vựng
- Tên property không tồn tại ở đâu trong Schema.org, nên không ai đọc được nó. Đây là lỗi: giá trị bị vứt đi bất kể nó ghi gì.
- Property không hợp lệ với type này
- Property có thật, chỉ là không thuộc type này — ví dụ cookTime trên một Article. Chỉ là cảnh báo: Schema.org coi việc một property thuộc type nào là gợi ý, và bên tiêu thụ vẫn thường đọc qua nó.
- Giá trị không khớp kiểu mong đợi
- Property có thật và thuộc về đây, nhưng giá trị sai loại — một chuỗi trơn ở chỗ đáng lẽ là một ngày hoặc một mục lồng.
- Khối này không phải JSON hợp lệ
- Được báo phía trên danh sách thay vì trong một khối, vì khối không parse được thì không có mục nào để gắn gì vào. Mọi thứ sau lỗi cú pháp đều không được đọc; một dấu phẩy thừa có thể giấu phần markup còn lại.
- Không có @context trỏ về schema.org
- Cố ý báo ở đây dù trình kiểm chuẩn im lặng về nó. Không có @context thì các tên bên trong chỉ là chữ, nên không kiểm được gì trong khối, và một báo cáo sạch trên khối chưa kiểm là câu trả lời tệ nhất có thể.