נניח שאתם רוצים לקבל מידע על המוצרים שזמינים כרגע בחשבון שלכם. באופן ספציפי, אתם מעוניינים לדעת אם במוצרים שלכם יש בעיות שדורשות טיפול. אמנם יודעים איך להשיג את המידע הזה מ-Merchant Center, אבל מעדיפים להגדיר מערכת התראות אוטומטית באמצעות Content API. במדריך הזה נסביר איך המידע על חומרת הבעיה ב-Content API ממופה לתעדוף הבעיות שמופיע בדוחות האבחון ב-Merchant Center.
דוגמה ל-Content API
כדי לטפל בבעיות שמשפיעות על המוצרים, אפשר להפעיל את accountstatuses.get בחשבון. הנה דוגמה מקוצרת למקור המידע שתקבל בחזרה:
{
"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"
}
]
},
...
}
בקטע accountLevelIssues[].severity מוצגת רמת החומרה של שגיאות בחשבון Merchant Center. שגיאות Critical יגרמו להשעיית החשבון ולהפסקת ההצגה של המוצרים שלכם.
בקטע itemLevelIssues מוצגות השגיאות במוצרים שיכולות להוביל לדחיית מוצרים. שימו לב ש-itemLevelIssues[].numItems מודיעה לכם ש-2 פריטים בחשבון מושפעים מקישור לא תקין לתמונה, ו-5 פריטים כוללים שגיאה בדף הנחיתה.
בקטע itemLevelIssues[].servability תוכלו לראות אם השגיאה גורמת לפסילת המוצרים. שימו לב שגם הקישור לתמונה הפגום וגם השגיאה בדף הנחיתה גורמים לפסילת המוצרים.
כדי למצוא את כל המוצרים המושפעים, אפשר להתקשר לכתובת
Productstatuses.list
ולקבל רשימה מלאה של הבעיות לפי מוצר. הפונקציה מחזירה ערכים כמו:
{
"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"
}
],
...
},
...
]
}
עכשיו יש לכם מידע על הבעיות בכל המוצרים בחשבון, אבל לא ברור עד כמה חשוב לפתור את הבעיות האלה.
בדוגמה productstatuses שלנו, תוכלו להשתמש ב-itemLevelIssues[].servability כדי לבדוק אם שגיאה משביתה את האפשרות להציג את המוצר ב'קונים ב-Google', במודעות שופינג או בפלטפורמות השונות של Google.
אם המאפיין itemLevelIssues[].servability הוא unaffected כמו השגיאה
ambiguous_gtin, השגיאה לא תמנע את הצגת המוצר.
עם זאת, אם המאפיין itemLevelIssues[].servability הוא disapproved כמו השגיאה mobile_landing_page_crawling_not_allowed, מדובר בשגיאה חמורה יותר כי לא תוכלו להציג את המוצר עד שהשגיאה תתוקן.
בדוגמה של accountstatuses, בקטע accountLevelIssues[].severity, הקטע 'אבחון' ב-Merchant Center מגדיר תעדוף בעיות בדיוק ואת המשמעות של סדרי העדיפויות השונים.
תחילה מעיינים בדוח:
איך כל המידע שאתם מקבלים מ-Content API for Shopping תואם למה שמופיע בקטע 'אבחון'? אילו רשומות הן בעיות שצריך לפתור בהקדם האפשרי, ואילו לא חובה לפתור? אילו בעיות יגרמו למוצרים שלך להפסיק להופיע במודעות אם לא יטופלו?
כפי שמוצג בדוגמאות האלה, בקטע 'אבחון' מוצג מידע על חוּמרה של בעיות בחשבון ובמוצרים באותו חשבון, ואילו ב-Content API (דרך השירות Accountstatuses) ניתן לקבל מידע על חוּמרה של בעיות הקשורות ל-accountLevel בלבד.
כל מקור מחלק את הבעיות לשלוש קטגוריות, בהתאם לחומרת הבעיה. כשמבינים איך להעריך את חומרת הבעיות שהוחזרו מהשירותים שקשורים לסטטוס, אפשר לזהות במהירות את הבעיות שהכי חשוב לטפל בהן, ומאילו בעיות אפשר להתעלם בצורה בטוחה.
תעדוף בעיות
בקטע 'אבחון', תעדוף הבעיות מתאר את חומרת הבעיה באחת משלוש רמות: שגיאות, אזהרות והתראות. בטבלאות דוחות כמו זו שלמעלה, הרמות האלה מיוצגות על ידי תמונות שמופיעות בעמודה הראשונה: 
לשגיאות, 
לאזהרות ו-
להתראות.
השגיאות גרמו להשעיית החשבון או לפסילת הפריט. כדאי לפתור אותן בהקדם האפשרי כדי להבטיח שהפריטים יוכלו להופיע שוב בתוצאות.
אזהרות עלולות להשפיע לרעה על ביצועי המודעות, וסביר להניח שיובילו בעתיד להשעיה של פריטים או של החשבון, אלא אם הבעיה תיפתר.
ההתראות הן הצעות לאופטימיזציה לשיפור איכות הנתונים. מומלץ לפתור את הבעיות האלה, אבל זו לא חובה.
עם זאת, אנחנו לא צריכים להיכנס ל-Merchant Center כדי לבדוק אילו שגיאות.
ב-Content API, השדה accountLevelIssues[].severity באובייקטים של המשאב accountstatuses מספק את אותו מידע על חומרת הבעיה. השדות האלה יכולים להכיל אחד משלושה ערכים: critical, error ו-suggestion.
הערכים האלה תואמים אחד לאחד עם תעדוף הבעיות בכרטיסייה 'אבחון':
| חומרת הבעיה באיכות הנתונים (API) | תעדוף בעיות |
|---|---|
critical |
שגיאה () |
error |
אזהרה () |
suggestion |
התראה () |
לכן, בדוגמה accountstatuses, הבעיה missing_ad_words_link מיידעת אתכם שעליכם לקשר חשבון Google Ads כדי להציג מודעות, אבל לא תהיה לכך השפעה על אישור המוצר במסד הנתונים של Merchant Center.
מצד שני, השגיאה editorial_and_professional_standards_destination_url_down_policy היא שגיאה חמורה יותר שמובילה להשעיית החשבון שלכם. אם אתם משתתפים בתוכנית 'קונים ב-Google', 'בפלטפורמות השונות של Google' או אם היה לכם חשבון Google Ads מקושר, השגיאה critical תפסיק מיד את הצגת המוצרים בתוכניות 'קונים ב-Google', 'בפלטפורמות השונות של Google' ו'מודעות שופינג'.
כשבידכם המידע הזה, תוכלו לכתוב תוכנה עם התראות שתיידע אתכם מיד לגבי בעיות חשובות, ובמקביל אוספים בעיות פחות חמורות לתיקון בסופו של דבר, בלי שתצטרכו להיכנס ל-Merchant Center כדי להבין מה הסיבה.