Giả sử bạn muốn biết thông tin về những sản phẩm hiện có trong tài khoản. Đặc biệt, bạn muốn biết liệu có bất kỳ sản phẩm có vấn đề cần giải quyết. 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 thông qua Content API. Trong hướng dẫn này, chúng tôi sẽ xem xét mức độ nghiêm trọng của vấn đề thông tin trong Content API liên kết 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
Để xem 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ụ 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 Merchant Center
tài khoản. Critical lỗi sẽ dẫn đến việc tạm ngưng tài khoản,
ngăn bạn phân phát sản phẩm.
Trong itemLevelIssues, bạn có thể xem các lỗi sản phẩm có thể dẫn đến sản phẩm
trường hợp bị từ chối. Xin lưu ý rằng itemLevelIssues[].numItems cho bạn biết rằng 2 mục
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ục có
lỗi trang đích.
Trong itemLevelIssues[].servability, bạn có thể xem liệu lỗi này có gây ra
sản phẩm bị ảnh hưởng sẽ bị từ chối. Lưu ý rằng cả liên kết hình ảnh bị hỏng và
lỗi trang đích 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 gọi
Productstatuses.list
để xem danh sách đầy đủ các vấn đề theo từng sản phẩm. Trả về
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 chưa 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ó ảnh hưởng đến khả năng phân phát sản phẩm của bạn hay không
Mua trên Google, quảng cáo Mua sắm hoặc các nền tảng của Google.
Nếu itemLevelIssues[].servability là unaffected, giống như
ambiguous_gtin lỗi, lỗi này sẽ không khiến sản phẩm của bạn không thể
đầu cuối.
Tuy nhiên, nếu itemLevelIssues[].servability là disapproved giống như
mobile_landing_page_crawling_not_allowed lỗi, lỗi này nghiêm trọng hơn
nghiêm trọng 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, giá trị
Mục 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 từng mức độ ưu tiên.
Trước tiên, hãy xem báo cáo:
Tất cả thông tin bạn thu thập được bằng cách nào Content API for Shopping tương quan với những gì bạn thấy trong phần Chẩn đoán? Mục nhập nào là vấn đề bạn cần khắc phục càng sớm càng tốt và những vấn đề nào sẽ tốt để giải quyết nhưng không cần thiết phải khắc phục? Vấn đề nào sản phẩm của bạn có bị ngừng phân phát trong quảng cáo nếu các vấn đề đó chưa được giải quyết không?
Như được hiển thị trong các ví dụ này, mục Chẩn đoán cung cấp thông tin về mức độ nghiêm trọng
về 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) cung cấp thông tin về mức độ nghiêm trọng
chỉ dành cho số accountLevel.
Mỗi nguồn chia các vấn đề thành 3 loại dựa trên về mức độ nghiêm trọng của vấn đề. Hiểu cách đánh giá mức độ nghiêm trọng của 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 vấn đề là những vấn đề quan trọng nhất cần giải quyết và những vấn đề bạ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ấn đề sẽ mô tả vấn đề
mức độ nghiêm trọng là một trong ba mức độ: lỗi, cảnh báo và thông báo. Trong
bảng báo cáo như bảng trên, các cấp này được thể hiện bằng các hình ảnh
xuất hiện trong phần đầu
cột:
cho
các lỗi,
cho
các cảnh báo,
và
đối với 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. Chúng sẽ được giải quyết trong thời gian sớm nhất có thể để đảm bảo mặt hàng đủ điều kiện xuất hiện trong kết quả nữa.
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ẽ dẫn đến việc mặt hàng hoặc tài khoản bị tạm ngưng trong tương lai trừ phi vấn đề xảy ra đã được giải quyết.
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. Đang giải quyết bạn nên sử dụng 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 phần tử
Đố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 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 phép 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 việc này sẽ không
ảnh hưởng đến trạng thái phê duyệt của sản phẩm trong cơ sở dữ liệu của bạn trên 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 là tạm ngưng tài khoản của bạn. Nếu bạn đang tham gia
trong chương trình Mua trên Google, Các nền tảng của Google, hoặc nếu bạn đã liên kết một tài khoản Google Ads
tài khoản của bạn sẽ gặp critical lỗi 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.
Nhờ có thông tin này, giờ đây bạn có thể viết phần mềm cảnh báo đưa ra các vấn đề quan trọng ngay lập tức để thu thập các vấn đề nghiêm trọng để khắc phục sau cùng mà không phải truy cập vào Merchant Center để để biết đó là loại nào.