חומרת הבעיה ואבחון הבעיה ב-Merchant Center

אנחנו רוצים להציג את גרסת הבטא של Merchant API. זאת הגרסה החדשה של Content API for Shopping ועל העתיד.

לקבלת מידע על האופן שבו Merchant API יכול לשפר את השילוב שלכם ועל האופן שבו תוכלו לעזור לעצב את בעתיד, ראו הכרזה גרסת הבטא של Merchant API.

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