Bài viết này trình bày cách triển khai mã đánh dấu dữ liệu có cấu trúc cho dữ liệu sản phẩm của bạn.
- Trước khi bắt đầu, hãy xem lại bài viết Giới thiệu về mã đánh dấu dữ liệu có cấu trúc cho Merchant Center rồi kiểm tra để đảm bảo trang web của bạn đáp ứng các yêu cầu này.
- Để biết các nguyên tắc chung về dữ liệu có cấu trúc ngoài dữ liệu sản phẩm trong Merchant Center, hãy tham khảo Hướng dẫn bắt đầu sử dụng của schema.org. Bạn cũng nên dùng Search Console để khắc phục sự cố liên quan đến dữ liệu có cấu trúc cũng như để đo lường hiệu suất và lưu lượng tìm kiếm trên trang web của bạn.
- Bạn có thể xem thêm hướng dẫn trong bài viết về Dữ liệu có cấu trúc của sản phẩm, cụ thể là các mục trên trang thông tin của người bán.
Trên trang này
- Bắt đầu
- Thêm mã đánh dấu dữ liệu có cấu trúc
- Sản phẩm và Mặt hàng
- Kiểm tra mã đánh dấu
- Dữ liệu có cấu trúc bắt buộc cho trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng
- Dữ liệu có cấu trúc bắt buộc cho các mặt hàng lấy tại cửa hàng
Bắt đầu
Để thêm mã đánh dấu dữ liệu có cấu trúc vào trang web, bạn cần phải có thể truy cập và chỉnh sửa HTML của trang web, hoặc cấu hình mẫu của hệ thống cửa hàng. Mã đánh dấu là một chú thích của thẻ HTML giúp trình thu thập dữ liệu và bot của công cụ tìm kiếm biết rằng có dữ liệu sản phẩm trên trang web của bạn, đồng thời giúp hệ thống hiểu được dữ liệu đó một cách chính xác.
Để trình thu thập dữ liệu của Google so khớp dữ liệu có cấu trúc với dữ liệu sản phẩm thì bạn phải đáp ứng các điều kiện sau:
- Trang đích chỉ có một mặt hàng duy nhất.
- Nếu có nhiều mặt hàng trên toàn bộ trang, thì mỗi mặt hàng trên trang đó phải được chú thích bằng SKU hoặc GTIN và mặt hàng tương ứng trong dữ liệu sản phẩm trên Mua sắm phải có cùng SKU (thuộc tính mã nhận dạng
[id]
) hoặc GTIN (thuộc tính GTIN[gtin]
). Điều này có thể hữu ích nếu bạn đăng nhiều biến thể của cùng một sản phẩm (ví dụ như nhiều phiên bản kích thước hoặc màu sắc, hoặc các sản phẩm có liên quan) trên cùng một trang đích. - Mã đánh dấu dữ liệu có cấu trúc phải có trong HTML mà máy chủ web trả về. Bạn không thể tạo mã đánh dấu dữ liệu có cấu trúc bằng JavaScript khi trang đã tải xong.
- Nội dung trên trang đích của bạn, trong đó có mức giá, không được tự động thay đổi dựa trên thông tin người dùng (như địa chỉ IP hoặc loại trình duyệt).
- Dữ liệu có cấu trúc phải khớp với các giá trị mà người dùng nhìn thấy. Việc cung cấp dữ liệu không chính xác trên trang đích của sản phẩm là hành vi vi phạm nguyên tắc của chúng tôi đối với nhà phát triển web.
Nếu không đáp ứng được ít nhất một trong các điều kiện này, thì các sản phẩm trên trang đích sẽ không khớp với dữ liệu sản phẩm.
Phần nội dung của schema.org liên quan đến các phiên bản thông tin mà máy có thể hiểu giúp bạn hiểu và làm rõ dữ liệu có cấu trúc của mình.
Thêm mã đánh dấu dữ liệu có cấu trúc
Mã đánh dấu JSON-LD
Để thêm mã đánh dấu dữ liệu có cấu trúc vào trang web, bạn nên thêm mã này dưới dạng JSON-LD vào mã đánh dấu trong HTML. Hãy tham khảo bài viết Giới thiệu về mã đánh dấu dữ liệu có cấu trúc trên Google Tìm kiếm để biết thêm thông tin.
Mã đánh dấu JSON-LD sẽ khác với mã dành cho người dùng, nhờ đó dễ duy trì hơn. Bạn có thể thêm bất kỳ mã đánh dấu dữ liệu có cấu trúc nào được thiết kế riêng cho Google mà không cần phải thay đổi thành phần hình ảnh của trang web.
Nếu dùng một nền tảng thương mại điện tử trên trang web, bạn có thể cần phải điều chỉnh một số phần trong mẫu hoặc mã của nền tảng thì mới có thể thêm dữ liệu có cấu trúc. Ngoài ra, trang web của bạn có thể hỗ trợ JavaScript cho mẫu và ứng dụng cấp độ trang.
Ví dụ
JSON-LD
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "http://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": "399900.00",
"priceCurrency": "VND"
}
Mã đánh dấu dữ liệu có cấu trúc đã thêm có thể xuất hiện ở bất kỳ vị trí trong nguồn HTML nhưng bạn nên đưa dữ liệu sản phẩm có cấu trúc vào HTML ban đầu để có kết quả tốt nhất.
Sản phẩm và mặt hàng
Trang đích phải có cả hai thông tin sau:
- Một đối tượng Sản phẩm mô tả sản phẩm đó
- Một đối tượng Mặt hàng được lồng trong trường mặt hàng sẽ mô tả cách bán sản phẩm này
Xin lưu ý rằng giá phải được chỉ định bằng dấu thập phân là dấu chấm, chứ không phải dấu phẩy. Nếu đăng giá ở nhiều đơn vị tiền tệ trên trang đích, bạn có thể dùng nhiều đối tượng loại Offer. Khi dùng nhiều đối tượng Mặt hàng, bạn cũng cần dùng thuộc tính priceCurrency
để chỉ định các đơn vị tiền tệ.
Nếu giá ưu đãi xuất hiện trên trang đích và giá này là số tiền mà người dùng thực sự phải trả vào thời điểm đó, hãy đảm bảo rằng bạn cung cấp giá ưu đãi trong dữ liệu có cấu trúc.
Quan trọng: Schema.org không hỗ trợ một số thuộc tính trong quy cách sản phẩm. Bạn phải chỉ định các giá trị schema.org sau đây cho tính năng tự động cập nhật mặt hàng: price
, priceCurrency
, availability
và condition
. Tìm hiểu thêm về Dữ liệu có cấu trúc Trang thông tin của người bán (Product, Offer) trên Trung tâm Google Tìm kiếm.
Kiểm tra mã đánh dấu
Bạn có thể kiểm tra việc triển khai schema.org bằng Search Console hoặc Công cụ kiểm tra kết quả nhiều định dạng. Hãy truy cập vào trang Kiểm tra kết quả nhiều định dạng hoặc Trung tâm trợ giúp của Google Search Console để tìm hiểu thêm về cách sử dụng công cụ này, cách gỡ lỗi và cách đọc hiểu kết quả bạn thu được khi dùng công cụ này.
Dữ liệu có cấu trúc bắt buộc cho trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng
Nếu đã chọn sử dụng Quảng cáo kho hàng tại địa phương có trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng, thì bạn có thể thêm mã đánh dấu dữ liệu có cấu trúc bổ sung trong bảng bên dưới vào Mặt hàng được lồng, để cho biết sản phẩm được bán ở cửa hàng thực tế nào:
Lưu ý: Bạn có thể sử dụng mã đánh dấu Schema.org trên các trang web viết bằng bất kỳ ngôn ngữ nào. Mã đánh dấu, như HTML, được viết bằng tiếng Anh. Giá trị Schema.org phân biệt chữ hoa chữ thường.
Giá trị Schema.org | Giá trị trong quy cách nguồn cấp dữ liệu kho hàng hoặc sản phẩm | Loại giá trị |
Product > offers > availableAtOrFrom > branchCode | store code |
Một giá trị nhận dạng riêng biệt gồm chữ và số cho mỗi cửa hàng địa phương. Bạn phải dùng cùng mã cửa hàng mà bạn đã cung cấp trong Trang doanh nghiệp. |
Dữ liệu có cấu trúc bắt buộc cho các mặt hàng lấy tại cửa hàng
Nếu đã chọn sử dụng Quảng cáo kho hàng tại địa phương có trang sản phẩm cho biết tình trạng còn hàng tại cửa hàng và tính năng đến lấy hàng sau hoặc lấy hàng trong ngày, thì bạn có thể thêm mã đánh dấu dữ liệu có cấu trúc bổ sung trong bảng bên dưới vào Mặt hàng được lồng, để cho biết người mua có thể đến lấy sản phẩm ở cửa hàng thực tế nào:
Lưu ý: Bạn có thể sử dụng mã đánh dấu Schema.org trên các trang web viết bằng bất kỳ ngôn ngữ nào. Mã đánh dấu, như HTML, được viết bằng tiếng Anh. Giá trị Schema.org phân biệt chữ hoa chữ thường.
Thuộc tính schema.org | Giá trị trong quy cách nguồn cấp dữ liệu kho hàng hoặc sản phẩm | Loại giá trị |
Product > offers > availableDeliveryMethod | -- | Giá trị schema.org OnSiteSelectup cho biết sản phẩm có hàng để khách đến nhận tại cửa hàng. |
Product > offers > potentialAction | pickup method |
Giá trị BuyAction của schema.org cho biết khách hàng có thể mua sản phẩm trên mạng rồi nhận tại cửa hàng. Giá trị ReserveAction của schema.org cho biết khách hàng có thể đặt trước sản phẩm trên mạng rồi nhận tại cửa hàng. |
Product > offers > deliveryLeadTime | pickup sla |
Thời gian thực hiện việc giao hàng chỉ được có giá trị là 1 hoặc 0. Thuộc tính này dùng để cho biết số ngày dự kiến khách hàng phải đợi cho đến khi có thể đến lấy hàng, cụ thể như sau: 0 = Cùng ngày 1 = Ngày tiếp theo |
Tìm hiểu thêm về bài viết Giới thiệu về dữ liệu có cấu trúc cho Merchant Center.