נניח שאתם רוצים לקבל מידע על המוצרים שזמינים כרגע בחשבון שלכם. במיוחד, אתם רוצים לדעת אם יש בעיות במוצרים שלכם שצריך לטפל בהן. אתם יודעים איך לקבל את המידע הזה מ-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, מדובר בשגיאה חמורה הרבה יותר כי לא תוכלו להציג את המוצר עד שהשגיאה תתוקן.
בדוגמה שלנו, בקטע accountLevelIssues[].severity ב-accountLevelIssues[].severity, בקטע 'אבחון' ב-Merchant Center מוגדר סדר העדיפויות של הבעיות והמשמעות המדויקת של רמות העדיפות השונות.accountstatuses
קודם כול, כדאי לעיין בדוח:
איך כל המידע שאתם מקבלים מ-Content API for Shopping קשור למה שאתם רואים בקטע 'אבחון'? אילו רשומות הן בעיות שצריך לפתור בהקדם האפשרי, ואילו רשומות כדאי לטפל בהן אבל לא חיוני לתקן אותן? אילו בעיות יגרמו להפסקת הצגת המוצרים במודעות אם לא יטופלו?
כפי שמוצג בדוגמאות האלה, בקטע 'אבחון' מוצג מידע על רמת החומרה של בעיות בחשבון ובמוצרים בחשבון הזה, ואילו ב-Content API (דרך השירות Accountstatuses) מוצג מידע על רמת החומרה של בעיות ב-accountLevel בלבד.
בכל מקור, הבעיות מחולקות לשלוש קטגוריות לפי חומרת הבעיה. הבנת האופן שבו בודקים את חומרת הבעיות שחוזרות מהשירותים שקשורים לסטטוס יכולה לעזור לכם לזהות במהירות אילו בעיות חשוב לטפל בהן קודם, ואילו בעיות אפשר להתעלם מהן בבטחה.
תעדוף בעיות
בקטע 'אבחון', תעדוף הבעיות מתאר את חומרת הבעיה באחת משלוש רמות: שגיאות, אזהרות והתראות. בטבלאות דוחות כמו זו שלמעלה, הרמות האלה מיוצגות בתמונות שמופיעות בעמודה הראשונה: 
לשגיאות, 
לאזהרות ו-
להתראות.
שגיאות גרמו להשעיית החשבון או לפסילה של פריט. כדאי לפתור אותן בהקדם האפשרי כדי לוודא שהפריטים יוכלו שוב להופיע בתוצאות.
אזהרות עלולות להשפיע לרעה על ביצועי המודעות, וסביר להניח שאם לא תפתרו את הבעיה הן יובילו להשעיה של פריטים או של החשבון.
הודעות הן הצעות לאופטימיזציה לשיפור איכות הנתונים. מומלץ לפתור את הבעיות האלה, אבל זו אינה חובה.
עם זאת, אין צורך להיכנס ל-Merchant Center כדי לבדוק אילו שגיאות הן אילו.
ב-Content API, השדה accountLevelIssues[].severity באובייקטי המשאבים accountstatuses מספק את אותו מידע על חומרת הבעיה. השדות האלה יכולים להכיל אחד משלושת הערכים הבאים: critical, error ו-suggestion.
לערכים האלה יש התאמה ישירה לתעדוף הבעיות בכרטיסייה 'אבחון':
| חומרת הבעיה באיכות הנתונים (API) | תעדוף בעיות |
|---|---|
critical |
שגיאה () |
error |
אזהרה () |
suggestion |
התראה () |
לדוגמה, בדוגמאות שלנו, הבעיה missing_ad_words_link מאפשרת לכם לדעת שאתם צריכים לקשר חשבון Google Ads כדי להציג מודעות, אבל היא לא תשפיע על אישור המוצר במסד הנתונים של Merchant Center.accountstatuses
לעומת זאת, השגיאה editorial_and_professional_standards_destination_url_down_policy היא שגיאה חמורה יותר שגורמת להשעיית החשבון. אם אתם משתתפים בתוכנית Buy on Google או בתוכנית 'פלטפורמות שונות ב-Google', או אם קישרתם חשבון Google Ads, הודעת השגיאה critical תגרום להפסקה מיידית של הצגת המוצרים שלכם בתוכניות Buy on Google, 'פלטפורמות שונות ב-Google' ומודעות שופינג.
בעזרת המידע הזה, תוכלו לכתוב תוכנת התראות שתתריע מיד על בעיות חשובות ותאסוף בעיות פחות חמורות לצורך תיקון עתידי, בלי שתצטרכו להיכנס ל-Merchant Center כדי להבין מהי כל בעיה.