JSON-LD cho website: mã mẫu tiếng Việt, cách kiểm tra và nguyên tắc

JSON-LD là một cách viết schema markup, tức dữ liệu có cấu trúc, để mô tả trang web cho công cụ tìm kiếm bằng khối mã riêng, không đổi giao diện. Bạn khai báo doanh nghiệp, bài viết hoặc sản phẩm, kiểm tra bằng Rich Results Test và chỉ đánh dấu thông tin người dùng thấy thật trên trang.

JSON-LD là gì và khi nào có ích

Nếu bạn đang tìm schema markup là gì, câu trả lời ngắn gọn: đó là dữ liệu có cấu trúc, một đoạn mã khai báo rõ trang này nói về cái gì. Theo tài liệu giới thiệu của Google Search Central, Google dùng dữ liệu có cấu trúc để hiểu nội dung trang.

Còn json-ld là gì? Đó là một định dạng để viết dữ liệu có cấu trúc. Search Engine Land đưa tin Google đã hỗ trợ JSON-LD cho loại dữ liệu này.

Khi nào có ích? Khi trang của bạn mô tả một đối tượng cụ thể như doanh nghiệp, bài viết hoặc sản phẩm. Khai báo giúp máy hiểu đúng đối tượng, nhưng không phải lời hứa về thứ hạng hay hiển thị đặc biệt trên kết quả tìm kiếm.

Các mẫu dưới đây chỉ ghi phần nội dung JSON để bạn dễ chép. Những giá trị viết hoa kiểu GIA_TREN_TRANG là chỗ bạn thay bằng đúng thông tin đang hiện trên trang.

Organization và LocalBusiness cho doanh nghiệp

Organization mô tả tổ chức: tên, tên gọi khác. Mẫu tối giản, có dấu tiếng Việt:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Công ty TNHH Ví Dụ",
  "alternateName": "Ví Dụ"
}

Nếu doanh nghiệp có địa điểm kinh doanh cụ thể, hãy xem LocalBusiness. Google có tài liệu riêng về dữ liệu có cấu trúc LocalBusiness. Hãy đối chiếu danh sách thuộc tính ở đó trước khi triển khai.

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Quán cà phê Ví Dụ",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "ĐỊA_CHỈ_GHI_TRÊN_TRANG",
    "addressLocality": "Hà Nội",
    "addressCountry": "VN"
  },
  "telephone": "SO_DIEN_THOAI_TREN_TRANG"
}

Địa chỉ và số điện thoại phải khớp với phần bạn đang hiển thị ở chân trang hoặc trang liên hệ.

BlogPosting cho bài viết

Với bài blog, bạn khai báo tiêu đề, tác giả và ngày đăng. Google có hướng dẫn về Article schema markup, hãy dùng trang đó để kiểm tra thuộc tính được khuyến nghị.

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Tiêu đề đúng như đang hiện trên bài",
  "author": {
    "@type": "Organization",
    "name": "Tên tác giả hiển thị trên bài"
  },
  "datePublished": "NGAY_DANG_THEO_CHUAN_ISO"
}

Tên tác giả trong mã phải là tên người đọc thấy trên trang. Đừng điền một cái tên chỉ có trong mã.

Product cho cửa hàng online

Trang sản phẩm có hai tài liệu liên quan: Product snippet và Merchant listing.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Ấm đun nước inox",
  "description": "Mô tả ngắn giống phần mô tả trên trang",
  "offers": {
    "@type": "Offer",
    "priceCurrency": "VND",
    "price": "GIA_TREN_TRANG"
  }
}

Giá trong mã phải trùng giá khách nhìn thấy. Nếu giá đổi, hãy cập nhật cả hai nơi.

Cách kiểm tra bằng Rich Results Test

Sau khi thêm mã, bạn nên kiểm tra trước khi coi là xong.

Quy trình gợi ý:

• Dán địa chỉ trang đã đăng, hoặc dán đoạn mã đang thử.
• Xem công cụ nhận ra loại dữ liệu nào và có báo lỗi hay cảnh báo gì không.
• Sửa mã, kiểm tra lại, rồi mới áp dụng lên trang thật.
• So sánh từng giá trị trong mã với nội dung hiển thị trên trang.

Bước cuối nhiều người bỏ qua, dù công cụ không tự làm thay bạn được.

Nếu quản lý nhiều trang, công cụ TỐI ƯU SEO kiểm tra website theo bộ tiêu chí SEO; kiểm tra cơ bản miễn phí, kiểm tra chuyên sâu trừ credit. Trên website của người dùng, công cụ không tự đăng nội dung: mọi thay đổi chờ bạn duyệt và có nút hoàn tác. Bạn có thể xem trang chủ TỐI ƯU SEO hoặc đăng ký dùng thử miễn phí.

Nguyên tắc: chỉ đánh dấu điều hiển thị thật

Đây là nguyên tắc quan trọng nhất. Hướng dẫn chung về dữ liệu có cấu trúc của Google nêu các quy định mà dữ liệu cần tuân thủ. Hãy đọc kỹ trước khi triển khai.

Áp vào thực tế, bạn có thể tự hỏi ba điều:

• Thông tin này có đang hiển thị cho người đọc trên chính trang đó không?
• Giá trị trong mã có khớp với nội dung hiển thị không?
• Mô tả có đúng bản chất trang, hay chỉ thêm vào để trông giống có lợi thế?

Ví dụ: trang sản phẩm không hiện đánh giá của khách thì đừng khai báo đánh giá trong mã. Bài viết không ghi tác giả thì đừng bịa tên tác giả chỉ để mã trông đầy đủ.

Đánh dấu đúng, kiểm tra kỹ và giữ mã khớp với nội dung hiển thị là cách làm bền vững hơn việc chạy theo thủ thuật.

Nguồn tham khảo

• Intro to How Structured Data Markup Works, developers.google.com. Đọc ngày 22/10/2026.
• General Structured Data Guidelines, developers.google.com. Đọc ngày 22/10/2026.
• Local Business (LocalBusiness) Structured Data, developers.google.com. Đọc ngày 22/10/2026.
• Learn About Article Schema Markup, developers.google.com. Đọc ngày 22/10/2026.
• How To Add Product Snippet Structured Data, developers.google.com. Đọc ngày 22/10/2026.
• How To Add Merchant Listing Structured Data, developers.google.com. Đọc ngày 22/10/2026.
• Google Adds JSON-LD Support For Structured Data Markup (Search Engine Land), searchengineland.com. Đọc ngày 22/10/2026.