Giả sử bạn muốn biết 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 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 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 vấn đề trong báo cáo Chẩn đoán trong Merchant Center.
Ví dụ về Content API
Để biết 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à 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 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, ngăn bạn phân phát sản phẩm.
Trong itemLevelIssues, bạn có thể thấy 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 rằng 2 mặt hàng trong tài khoản của bạn bị ảnh hưởng bởi đường liên kết hình ảnh bị hỏng và 5 mặt hàng gặp lỗi về 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 hình ảnh bị hỏng và lỗi về 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
Productstatuses.list
để xem danh sách đầy đủ các vấn đề theo từng sản phẩm. Hệ thống sẽ 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 bạn không biết 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 để biết liệu một 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 Nền tảng trên Google hay không.
Nếu itemLevelIssues[].servability là unaffected như lỗi ambiguous_gtin, thì lỗi đó 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 khắc phục lỗi này.
Trong ví dụ về accountstatuses, trong 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 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 tương quan với những gì bạn thấy trong phần Chẩn đoán như thế nào? 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 cần thiết phải khắc phục? Những vấn đề nào sẽ ngăn sản phẩm của bạn 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 đối với 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 đề đượ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 phần Chẩn đoán, mức độ ưu tiên vấn đề mô tả mức độ nghiêm trọng của vấn đề là 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ư bảng ở trên, các cấp độ này được biểu thị bằng hình ảnh xuất hiện ở 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ể tác động tiêu cực đến hiệu quả hoạt động của quảng cáo và có thể khiến cho tài khoản bị tạm ngưng hoặc mặt hàng bị từ chối 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 nhưng không bắt buộc.
Tuy nhiên, bạn không cần phải 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 các đối tượng tài nguyên accountstatuses cung cấp thông tin tương tự 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 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 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 việc 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 thu hút sự chú ý của bạn đến 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 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 đề.