Giả sử bạn muốn lấy thông tin về các sản phẩm hiện có trong tài khoản của mình. Cụ thể, bạn muốn biết liệu có sản phẩm nào của mình gặp vấn đề cần giải quyết hay không. Bạn biết cách lấy thông tin này từ Merchant Center, nhưng bạn muốn thiết lập một hệ thống cảnh báo tự động bằng Content API. Trong hướng dẫn này, chúng ta sẽ xem xét cách thông tin về mức độ nghiêm trọng của vấn đề trong Content API tương ứng với mức độ ưu tiên của vấn đề trong báo cáo Chẩn đoán của Merchant Center.
Ví dụ về Content API
Để nhận các vấn đề ảnh hưởng đến sản phẩm của bạn, bạn có thể chạy accountstatuses.get cho tài khoản của mình. Dưới đây là một ví dụ rút gọn về tài nguyên mà bạn nhận được:
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
Trong mục accountLevelIssues[].severity, bạn sẽ thấy mức độ nghiêm trọng của các lỗi trong tài khoản Merchant Center. Lỗi Critical sẽ khiến tài khoản bị tạm ngưng, điều này sẽ ngăn bạn phân phát sản phẩm.
Trong phần itemLevelIssues, bạn có thể xem các lỗi về sản phẩm có thể dẫn đến việc sản phẩm bị từ chối. Xin lưu ý rằng itemLevelIssues[].numItems cho bạn biết 2 mặt hàng trong tài khoản của bạn chịu ảnh hưởng của một đường liên kết bị hỏng đến hình ảnh và 5 mặt hàng có lỗi trang đích.
Trong phần itemLevelIssues[].servability, bạn có thể xem liệu lỗi này có khiến các sản phẩm bị ảnh hưởng bị từ chối hay không. Xin lưu ý rằng cả đường liên kết đến hình ảnh bị hỏng và lỗi trang đích đều khiến sản phẩm bị từ chối.
Để tìm tất cả sản phẩm bị ảnh hưởng, bạn gọi Productstatuses.list để nhận danh sách đầy đủ các vấn đề theo từng sản phẩm. Thao tác này trả về các mục như sau:
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
Giờ đây, bạn đã có thông tin về các vấn đề của tất cả sản phẩm trong tài khoản của mình, nhưng không rõ mức độ quan trọng của việc khắc phục những vấn đề này.
Trong ví dụ productstatuses, bạn có thể sử dụng itemLevelIssues[].servability để biết liệu một lỗi có khiến bạn không thể phân phát sản phẩm trong chương trình Mua qua Google, quảng cáo Mua sắm hoặc Các nền tảng của Google hay không.
Nếu itemLevelIssues[].servability là unaffected như lỗi ambiguous_gtin, thì lỗi này sẽ không ngăn sản phẩm của bạn phân phát.
Tuy nhiên, nếu itemLevelIssues[].servability là disapproved như lỗi mobile_landing_page_crawling_not_allowed, thì đây là một lỗi nghiêm trọng hơn nhiều vì bạn không thể phân phát sản phẩm cho đến khi lỗi này được khắc phục.
Trong ví dụ accountstatuses của chúng tôi, trong phần accountLevelIssues[].severity, mục Chẩn đoán trong Merchant Center xác định mức độ ưu tiên của vấn đề và ý nghĩa chính xác của các mức độ ưu tiên.
Trước tiên, hãy xem báo cáo:
Tất cả thông tin bạn nhận được từ Content API for Shopping có liên quan như thế nào đến thông tin bạn thấy trong mục Chẩn đoán? Những mục nào là vấn đề bạn cần khắc phục càng sớm càng tốt và những mục nào bạn nên giải quyết nhưng không bắt buộc phải khắc phục? Những vấn đề nào sẽ khiến sản phẩm của bạn không được phân phát trong quảng cáo nếu bạn không giải quyết?
Như trong các ví dụ này, phần Chẩn đoán cung cấp thông tin về mức độ nghiêm trọng của các vấn đề đối với tài khoản và sản phẩm trong tài khoản đó, trong khi Content API (thông qua dịch vụ Accountstatuses) chỉ cung cấp thông tin về mức độ nghiêm trọng của các vấn đề accountLevel.
Mỗi nguồn chia các vấn đề thành 3 danh mục dựa trên mức độ nghiêm trọng của vấn đề. Việc hiểu cách đánh giá mức độ nghiêm trọng của các vấn đề do các dịch vụ liên quan đến trạng thái trả về có thể giúp bạn nhanh chóng xác định những vấn đề quan trọng nhất cần giải quyết và những vấn đề có thể bỏ qua một cách an toàn.
Mức độ ưu tiên vấn đề
Trong mục Chẩn đoán, mức độ ưu tiên của vấn đề mô tả mức độ nghiêm trọng của vấn đề theo một trong ba cấp độ: lỗi, cảnh báo và thông báo. Trong các bảng báo cáo như bảng ở trên, các cấp độ này được biểu thị bằng hình ảnh xuất hiện trong cột đầu tiên: 
cho lỗi, 
cho cảnh báo và 
cho thông báo.
Lỗi đã khiến tài khoản bị tạm ngưng hoặc mặt hàng bị từ chối. Bạn nên giải quyết các lỗi này càng sớm càng tốt để đảm bảo mặt hàng đủ điều kiện xuất hiện lại trong kết quả.
Cảnh báo có thể ảnh hưởng tiêu cực đến hiệu suất quảng cáo và có thể dẫn đến việc tài khoản hoặc mặt hàng bị tạm ngưng trong tương lai nếu bạn không giải quyết vấn đề.
Thông báo là đề xuất tối ưu hoá để tăng chất lượng dữ liệu. Bạn nên giải quyết các vấn đề này. Tuy nhiên, đây không phải là yêu cầu bắt buộc.
Tuy nhiên, chúng ta không cần truy cập vào Merchant Center để biết lỗi nào là lỗi nào.
Trong Content API, trường accountLevelIssues[].severity trong đối tượng tài nguyên accountstatuses cung cấp thông tin về mức độ nghiêm trọng của vấn đề. Các trường này có thể chứa một trong 3 giá trị: critical, error và suggestion.
Các giá trị này tương ứng với mức độ ưu tiên vấn đề trên thẻ Chẩn đoán:
| Mức độ nghiêm trọng của vấn đề về chất lượng dữ liệu (API) | Mức độ ưu tiên của vấn đề |
|---|---|
critical |
Lỗi () |
error |
Cảnh báo () |
suggestion |
Thông báo () |
Vì vậy, trong ví dụ về accountstatuses, vấn đề missing_ad_words_link cho bạn biết rằng bạn cần liên kết một tài khoản Google Ads để phân phát quảng cáo, nhưng vấn đề này sẽ không ảnh hưởng đến trạng thái phê duyệt sản phẩm trong cơ sở dữ liệu Merchant Center.
Mặt khác, editorial_and_professional_standards_destination_url_down_policy là một lỗi nghiêm trọng hơn khiến tài khoản của bạn bị tạm ngưng. Nếu bạn đang tham gia chương trình Mua trên Google, Nền tảng trên Google hoặc nếu bạn đã liên kết tài khoản Google Ads, thì lỗi critical sẽ ngay lập tức ngăn sản phẩm của bạn phân phát trong chương trình Mua trên Google, Nền tảng trên Google và quảng cáo Mua sắm.
Với thông tin này, giờ đây, bạn có thể viết phần mềm cảnh báo để ngay lập tức thông báo cho bạn về các vấn đề quan trọng trong khi thu thập các vấn đề ít nghiêm trọng hơn để khắc phục sau này mà không cần phải truy cập vào Merchant Center để phân biệt các vấn đề.