Hướng dẫn
Quét Merchant Center để phát hiện lỗi feed, phân loại kèm gợi ý sửa.
Product Health đọc các lỗi sản phẩm cấp item từ Google Merchant Center, phân loại bằng một knowledge base cố định, và theo dõi vòng đời open→resolved của từng lỗi — giúp bạn phát hiện sự cố feed trước khi nó âm thầm giết ngân sách quảng cáo. Đây là Wedge 2 và cố ý chỉ làm một phần: không tự động sửa, và quét live cần một nguồn Merchant Center đã kết nối.
Product Health là một source (kéo dữ liệu vào), khác với các đích đến (outbound push) ở Kết nối. Nó quét, phân loại, và hiển thị gợi ý — không bao giờ tự sửa feed hay tài khoản Merchant Center thay bạn.
Không tự động áp dụng
Gợi ý chỉ là văn bản, không phải hành động. Việc sửa GTIN thiếu, ảnh hỏng, hay lệch giá vẫn diễn ra ở feed hoặc Shopify/cửa hàng của bạn — Product Health chỉ cho biết cái gì sai và trỏ tới tài liệu tham khảo.
Mở Product Health. Có hai cách quét:
google_merchant_center đã kết nối trong Kết nối với trạng thái connected hoặc active. Nút bị vô hiệu cho tới khi có nguồn.Mỗi lượt quét báo cáo số sản phẩm đã quét, số lỗi mới, và số lỗi tự động resolved — hiện ngay qua toast và cập nhật trên dải mức độ nghiêm trọng cùng bảng lỗi.
Mỗi lượt quét diff các lỗi mới phát hiện so với các lỗi đang open hiện có của workspace, khóa theo product_id + issue_code:
resolved.Các lượt quét có tính idempotent — chạy lại cùng một bộ dữ liệu sẽ không thay đổi gì. Mỗi lượt được ghi lại thành một scan_run (số sản phẩm quét, số lỗi mới/đã resolve, nguồn), hiển thị ở dòng "Last scan" trên trang.
Phân loại là một knowledge base tĩnh, không phải AI — một bảng cố định ánh xạ mã lỗi GMC đã biết sang mức độ nghiêm trọng đã chuẩn hóa, danh mục, và gợi ý sửa. Mã nằm ngoài knowledge base sẽ dùng mức độ nghiêm trọng do chính GMC báo cáo (critical / error / suggestion, mặc định là error nếu thiếu) và dùng mô tả gốc từ GMC làm gợi ý.
| Mã lỗi | Danh mục · mức độ · gợi ý |
|---|---|
| missing_gtin | Identifiers · error — Thêm GTIN (mã vạch/UPC/EAN) của sản phẩm; bắt buộc với hầu hết sản phẩm có thương hiệu. |
| invalid_gtin | Identifiers · error — Sửa GTIN; phải là mã vạch hợp lệ, duy nhất, khớp sản phẩm. |
| incorrect_identifier | Identifiers · error — Sửa brand/GTIN/MPN để bộ định danh nhất quán và hợp lệ. |
| missing_image_link | Images · critical — Cung cấp image_link; sản phẩm không có ảnh sẽ bị từ chối. |
| image_link_broken | Images · critical — Sửa URL ảnh bị hỏng; ảnh phải crawl được và độ phân giải cao. |
| image_link_pending_crawl | Images · suggestion — Không cần làm gì; ảnh đang chờ crawl và sẽ tự hết. |
| missing_price | Price & availability · critical — Thêm giá; sản phẩm không có giá sẽ không hiển thị. |
| mismatching_price | Price & availability · error — Đảm bảo giá trong feed khớp với giá trên landing page (kể cả tiền tệ). |
| sale_price_below_cost | Price & availability · warning — Kiểm tra lại giá sale; giá có vẻ thấp bất thường và có thể bị gắn cờ lỗi. |
| missing_availability | Price & availability · error — Đặt availability (in_stock / out_of_stock / preorder) khớp landing page. |
| landing_page_error | Landing page · critical — Landing page trả lỗi; đảm bảo URL sản phẩm tải được và không bị chặn. |
| desktop_landing_page_not_working | Landing page · critical — Sửa landing page desktop để tải không lỗi hoặc không redirect sai. |
| policy_violation | Policy · critical — Xem lại sản phẩm theo chính sách Shopping; sản phẩm bị từ chối do vi phạm chính sách. |
| missing_shipping | Shipping & tax · error — Cấu hình vận chuyển trong tài khoản hoặc feed cho các quốc gia liên quan. |
| missing_tax | Shipping & tax · error — Cấu hình thuế cho các bang Mỹ liên quan. |
| pending_initial_review | Review · suggestion — Không cần làm gì; sản phẩm đang được review lần đầu và sẽ tự hết. |
Thứ tự mức độ nghiêm trọng, xấu nhất trước: critical > error > warning > suggestion. Dải mức độ trên trang lọc bảng lỗi theo một trong bốn giá trị này.
Mỗi lỗi mới phát hiện (không tính lỗi đang mở phát hiện lại) sẽ phát ra một sự kiện chuẩn hóa product_issue_detected — cùng cơ chế audit trail bất biến dùng chung toàn Averosi, mô tả ở Khái niệm cốt lõi. Sự kiện được dedupe theo product_id + issue_code + ngày, nên cùng một lỗi sẽ không spam log sự kiện ở mỗi lượt quét trong khi nó vẫn đang mở.
Việc resolve một lỗi — tự động (không còn phát hiện) hoặc thủ công — không phát sinh loại sự kiện mới; nó chỉ cập nhật trạng thái vòng đời của lỗi và ghi một dòng audit log, giữ đúng 5 loại sự kiện cố định của schema chuẩn hóa.
Hoạt động quét có thể kiểm tra từ hai nơi: log scan_runs (mỗi lượt quét một dòng, kèm số liệu và trạng thái) và audit trail (product_health.scanned, product_health.issue_resolved, product_health.issues_bulk_resolved). Xem Giám sát để biết cách Averosi hiển thị lịch sử job và sự kiện nói chung.
google_merchant_center để bật quét live.Vẫn chưa giải quyết được?
Nếu tài liệu chưa đề cập, hãy mở trang Hỗ trợ.