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 có 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 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 của Merchant Center.
Ví dụ về Content API
Để các vấn đề ảnh hưởng đến sản phẩm của mình, bạn có thể chạy accountstatuses.get cho tài khoản của mình. Dưới đây là ví dụ rút gọn về tài nguyên mà bạn nhận lại:
{
"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 các 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 không thể phân phát các sản phẩm của mình.
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 ý itemLevelIssues[].numItems cho bạn biết rằng 2 mặt hàng trong tài khoản của bạn bị ảnh hưởng bởi một đường liên kết hình ảnh bị hỏng và 5 mặt hàng có lỗi trang đích.
Trong itemLevelIssues[].servability, bạn có thể thấy 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ả cá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 đề theo 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"
}
],
...
},
...
]
}
Giờ đây, 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 không rõ tầm quan trọng của việc khắc phục những 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 của bạn 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 giống 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 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.
Ở ví dụ về accountstatuses, dưới accountLevelIssues[].severity, phần Chẩn đoán trong Merchant Center 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.
Đầu 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ó mối liên hệ nào với thông tin bạn thấy trong phần Chẩn đoán? Những mục nào là vấn đề bạn cần khắc phục sớm nhất có thể và những vấn đề nào tốt cần giải quyết nhưng không cần thiết phải khắc phục? 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 bạn không giải quyết?
Như minh hoạ 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 của các vấn đề đối với tài khoản và sản phẩm trên 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 vấn đề thành ba danh mục dựa trên mức độ nghiêm trọng của vấn đề. Nhờ nắm được cách đánh giá mức độ nghiêm trọng của vấn đề mà các dịch vụ liên quan đến trạng thái trả về, bạn có thể nhanh chóng xác định vấn đề nào quan trọng nhất cần giải quyết và vấn đề nào có thể bỏ qua một cách an toàn.
Mức độ ưu tiên vấn đề
Trong phần 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 3 cấp độ: lỗi, cảnh báo và thông báo. Trong các bảng báo cáo như 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.
Đã xảy ra lỗi khiến tài khoản bị tạm ngưng hoặc mặt hàng bị từ chối. Các vấn đề này cần được giải quyết 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ể khiến mặt hàng hoặc tài khoản của bạn bị tạm ngưng trong tương lai nếu vấn đề không được giải quyết.
Thông báo là các biện pháp tối ưu hoá được đề xuất để nâng cao 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 ta không cần phải truy cập vào Merchant Center để tìm hiểu 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 ba giá trị: critical, error và suggestion.
Các giá trị này tương ứng trực tiếp với mức độ ưu tiên của 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) | Ưu tiên vấn đề |
|---|---|
critical |
Lỗi () |
error |
Cảnh báo () |
suggestion |
Thông báo () |
Vì vậy, trong ví dụ accountstatuses của chúng ta, vấn đề missing_ad_words_link cho phép 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 vấn đề 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 không được 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.
Nhờ được cung cấp thông tin này, bạn hiện có thể viết phần mềm cảnh báo ngay lập tức nhằm thu hút sự chú ý của bạn về các vấn đề quan trọng, đồng thời thu thập các vấn đề ít nghiêm trọng hơn để khắc phục mà không cần phải truy cập vào Merchant Center để biết các vấn đề.