Chuyển tới nội dung chính

Đồng bộ sản phẩm website với JSON-LD

Json-ld là gì?​

Json-ld (JavaScript Object Notation for Linked Data) là một đoạn mã có cấu trúc, được chèn vào website để mô tả về sản phẩm, giúp các hệ thống (như Google, Subiz) hiểu được chính xác sản phẩm website đang bán.

JSON-LD được dùng để quy phạm nhiều thông tin như sản phẩm, doanh nghiệp hay ưu đãi, … Tuy nhiên, JSON-LD về sản phẩm là quan trọng nhất, định nghĩa JSON-LD chi tiết cho một sản phẩm bạn có thể xem tại đây.

Ví dụ một đoạn mã JSON-LD cho sản phẩm "Điện thoại Xiaomi Redmi Note 13, giá 4.190.000đ"

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Xiaomi Redmi Note 13 Pro 5G 8GB/128GB",
  "image": "https://example.com/image.jpg",
  "sku": "67677",
  "description": "Snapdragon 7s Gen 2 - Màn hình AMOLED - Bảo hành 12 tháng",
  "url": "https://example.com/san-pham",
  "offers": {
    "@type": "Offer",
    "price": "4190000",
    "priceCurrency": "VND",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Tại sao website nên có JSON-LD​

Nếu website của bạn có JSON-LD như đoạn mã ở trên, Google sẽ đánh giá cao website của bạn hơn, tăng khả năng sản phẩm của bạn xuất hiện trên Google Shopping, AI Overview, Google Image product result, Google Lens.

Ngoài ra, Subiz sẽ đồng bộ toàn bộ sản phẩm của bạn lên kho sản phẩm trên Subiz. Mỗi khi bạn cập nhật giá sản phẩm trên website, Subiz sẽ tự biết và cập nhật theo mà không cần bạn phải nhập tay lại trên giao diện Subiz.

Điều kiện để Subiz nhận diện sản phẩm​

Mỗi sản phẩm cần đáp ứng đủ 2 điều kiện:

  1. Được khai báo là sản phẩm bằng "@type": "Product", chấp nhận cả "https://schema.org/Product".
  2. Có ít nhất một trong 6 trường định danh sản phẩm sau:
  • sku
  • mpn
  • @id
  • productID
  • offers.url
  • url của object Product

Lưu ý: Trường "id" không được sử dụng làm định danh, khai báo đúng phải là "@id".

Ví dụ hợp lệ:

{
    "@type": "Product",
    "sku": "SKU-001"
  }

Hoặc:

{
    "@type": "Product",
    "@id": "product-001"
  }

Các trường thông tin bắt buộc​

Dưới đây là những trường tối thiểu bạn phải có để tính năng đồng bộ sản phẩm hoạt động:

  • name: Tên sản phẩm., ví dụ: "Iphone 16"
  • sku: Mã định danh duy nhất cho từng sản phẩm. Ví dụ: "135344", "iphon-16-b"
  • price: Giá sản phẩm (phải để định dạng số, không chứa ký tự đặc biệt như dấu chấm, phẩy hay chữ "đ").
  • image: Link ảnh đại diện cho sản phẩm.
  • url: Link website mô tả chi tiết sản phẩm.
  • availability: Trạng thái hàng hóa (Sẵn hàng/Hết hàng)
mẹo

Dán link một sản phẩm bất kỳ vào công cụhttps://search.google.com/test/rich-results?authuser=2Rich Results Test , nếu hiện trạng thái Sản phẩm (Product) màu xanh là website đã sẵn sàng đồng bộ lên Subiz.

FAQs​

Làm sao để biết website của tôi đã có json-ld?​

Để kiểm tra bạn thao tác như sau:

  • Tới link 1 sản phẩm cụ thể
  • Nhấn tổ hợp phím Ctrl/cmd+U hoặc nhấn chuột phải chọn View Page Source
  • Bấm ctrl/cmd+F để mở box tìm kiếm, gõ json hoặc ld+json

Làm sao để cài json-ld lên website?​

Bạn liên hệ với quản trị viên website hoặc đơn vị phụ trách thiết kế website yêu cầu.

Website của tôi đã có cấu trúc json-ld nhưng không lấy được sản phẩm nào khi đồng bộ lên Subiz​

Hãy chắc chắn rằng trong cấu trúc website đã thỏa mãn cả 2 điều kiện:

  1. Có trường "@type": "Product", chấp nhận cả "https://schema.org/Product"

  2. Có ít nhất 1 trong 6 trường định danh:

  • sku
  • mpn
  • @id
  • productID
  • offers.url
  • url của object Product

Tại sao Subiz bỏ qua sản phẩm không có định danh?​

Subiz sử dụng trường định danh để nhận biết sản phẩm đã được đồng bộ trước đó hay chưa.

Ví dụ, website có 100 sản phẩm nhưng không sản phẩm nào có mã định danh:

  • Lần đồng bộ đầu tiên có thể tạo 100 sản phẩm.
  • Lần đồng bộ tiếp theo, hệ thống không xác định được đây là 100 sản phẩm cũ hay 100 sản phẩm mới.
  • Nếu tiếp tục tạo mới, kho sản phẩm có thể tăng lên 200, sau đó 300 sản phẩm và xuất hiện nhiều dữ liệu trùng lặp.

Vì vậy, những object "Product" không có trường định danh hợp lệ sẽ được Subiz bỏ qua để tránh tạo lặp sản phẩm.

Website của tôi đã có cấu trúc Microdata thì có đồng bộ được sản phẩm lên Subiz không?​

Có. Ngoài JSON-LD, Subiz có thể nhận diện sản phẩm được khai báo bằng Microdata. Một sản phẩm Microdata cần đáp ứng đủ 2 điều kiện sau:

  1. Có itemscope.

  2. Có itemtype=".../Product" và ít nhất một định danh dưới đây:

  • itemprop="sku"
  • itemprop="mpn"
  • itemid
  • itemprop="productID"
  • itemprop="offers" → itemprop="url"
  • itemprop="url" trực tiếp trên Product

Ví dụ tối thiểu hợp lệ:

<div itemscope itemtype="https://schema.org/Product">
    <meta itemprop="sku" content="SKU-001">
  </div>

Hoặc:

<div
    itemscope
    itemtype="https://schema.org/Product"
    itemid="product-001">
  </div>
Cập nhật lần cuối vào