נניח שאתם רוצים לקבל מידע על המוצרים שזמינים כרגע בחשבון שלכם. אתם רוצים לדעת במיוחד אם יש לכם מוצרים עם בעיות שצריך לטפל בהן. אתם יודעים איך לקבל את המידע הזה מ-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 היא שגיאה חמורה יותר שגורמת להשעיית החשבון. אם אתם משתתפים בתוכניות Buy on Google או 'פלטפורמות של Google', או אם היה לכם חשבון Google Ads מקושר, שגיאה מסוג critical תגרום להפסקת הצגת המוצרים שלכם בתוכניות Buy on Google, 'פלטפורמות של Google' ומודעות שופינג באופן מיידי.
בעזרת המידע הזה, תוכלו לכתוב תוכנה לשליחת התראות שתפנה את תשומת הלב שלכם באופן מיידי לבעיות חשובות, ותאסוף בעיות פחות חמורות לתיקון בהמשך, בלי שתצטרכו להיכנס ל-Merchant Center כדי להבחין בין הבעיות.