נניח שאתם רוצים לקבל מידע על המוצרים שזמינים כרגע בחשבון שלכם. באופן ספציפי, אתם רוצים לדעת אם יש במוצרים שלכם בעיות שצריך לטפל בהן. אתם יודעים איך לקבל את המידע הזה מ-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 כדי לגלות מי מהן.