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