Giả sử bạn muốn nhận 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 tôi sẽ trình bày cách thông tin về mức độ nghiêm trọng của vấn đề trong Content API liên kết với mức độ ưu tiên của vấn đề trong Báo cáo chẩn đoán trong Merchant Center.
Ví dụ về Content API
Để các vấn đề ảnh hưởng đến sản phẩm, bạn có thể chạy
accountstatuses.get
cho tài khoản của mình. Dưới đây là ví dụ ngắn gọn về tài nguyên bạn nhận lại đượ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 accountLevelIssues[].severity, bạn sẽ thấy mức độ nghiêm trọng của lỗi tài khoản Merchant Center. Critical lỗi sẽ khiến tài khoản bị tạm ngưng và bạn sẽ không thể phân phát sản phẩm của mình nữa.
Trong itemLevelIssues, bạn có thể thấy các lỗi sản phẩm có thể khiến sản phẩm bị từ chối. Xin lưu ý rằng itemLevelIssues[].numItems cho bạn biết rằng 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 của hình ảnh bị hỏng và 5 mặt hàng có lỗi trang đích.
Trong itemLevelIssues[].servability, bạn có thể xem liệu lỗi 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 của 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 hãy gọi hàm
Productstatuses.list
để nhận danh sách đầy đủ các vấn đề của từng sản phẩm. Phương thứ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"
}
],
...
},
...
]
}
Bây giờ, bạn đã có thông tin về các vấn đề đối với tất cả sản phẩm trong tài khoản của mình, nhưng chưa rõ mức độ quan trọng của việc khắc phục các vấn đề này.
Trong ví dụ về productstatuses, bạn có thể sử dụng itemLevelIssues[].servability để tìm hiểu xem lỗi có vô hiệu hoá khả năng phân phát sản phẩm trong chương trình Mua trên 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 có giá trị 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 có giá trị disapproved giống 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 đó được khắc phục.
Trong ví dụ về accountstatuses, trong accountLevelIssues[].severity, mục Chẩn đoán trong Merchant Center sẽ xác định mức độ ưu tiên vấn đề và ý nghĩa chính xác của các mức độ ưu tiên khác nhau.
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 với những gì bạn thấy trong phần Chẩn đoán? Mục nào là vấn đề bạn cần khắc phục càng sớm càng tốt và mục nào cũng phù hợp để giải quyết nhưng không cần thiết? Vấn đề nào sẽ khiến sản phẩm của bạn ngừng phân phát trong quảng cáo nếu chưa được giải quyết?
Như trong những ví dụ này, mục Chẩn đoán cung cấp thông tin về mức độ nghiêm trọng liên quan đến các vấn đề đối với tài khoản và sản phẩm trong tài khoản đó, còn Content API (thông qua dịch vụ Accountstatuses) chỉ cung cấp thông tin về mức độ nghiêm trọng cho các vấn đề về accountLevel.
Mỗi nguồn chia các vấn đề thành 3 loại dựa trên mức độ nghiêm trọng của vấn đề. Việc biết cách đánh giá mức độ nghiêm trọng của các vấn đề được trả về từ các dịch vụ liên quan đến trạng thái có thể giúp 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 về vấn đề mô tả mức độ nghiêm trọng của vấn đề theo 1 trong 3 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.
Các lỗi đã dẫn đến việc tạm ngưng tài khoản hoặc từ chối mặt hàng. Các lỗi này sẽ được giải quyết trong thời gian sớm nhất có thể để đảm bảo các mục đủ điều kiện xuất hiện lại trong kết quả.
Cảnh báo có thể tác động tiêu cực đến hiệu suất quảng cáo và có thể sẽ khiến mặt hàng hoặc tài khoản 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à những cách tối ưu hoá được đề xuất để tăng chất lượng dữ liệu. Bạn nên giải quyết các vấn đề này (nhưng không bắt buộc).
Tuy nhiên, chúng tôi không cần phải truy cập vào Merchant Center để tìm xem đó là lỗi nào.
Trong Content API, trường accountLevelIssues[].severity trong các đối tượng tài nguyên accountstatuses cung cấp cùng một 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 một với một 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 xử lý 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 với một tài khoản Google Ads để phân phát quảng cáo, nhưng sẽ không ảnh hưởng đến việc phê duyệt sản phẩm trong cơ sở dữ liệu Merchant Center của bạn.
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, Các nền tảng của Google hoặc nếu bạn có tài khoản Google Ads được liên kết, lỗi critical sẽ khiến sản phẩm của bạn ngừng phân phát trong các chương trình Mua trên Google, Các nền tảng của Google và Quảng cáo mua sắm ngay lập tức.
Với thông tin này, giờ đây, bạn có thể viết phần mềm cảnh báo giúp chú ý ngay lập tức các vấn đề quan trọng trong khi vẫn thu thập được các vấn đề ít nghiêm trọng hơn để khắc phục sau cùng mà không cần phải truy cập vào Merchant Center để phân biệt.