درجة خطورة المشكلة وبيانات تشخيص Merchant Center

لنفترض أنّك تريد الحصول على معلومات عن المنتجات المتاحة حاليًا في حسابك. يهمّك بشكل خاص معرفة ما إذا كانت أيّ من منتجاتك تتضمّن مشاكل تحتاج إلى حلّ. أنت تعرف كيفية الحصول على هذه المعلومات من 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 يوضّح لك أنّ رابط صورة معطّل يؤثّر في سلعتَين في حسابك، وأنّ 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" أو "إعلانات Shopping" أو "منصات 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.

تتطابق هذه القيم تمامًا مع تحديد الأولويّة للمشاكل في علامة التبويب "بيانات التشخيص":

خطورة المشكلة في جودة البيانات (واجهة برمجة التطبيقات)	تحديد الأولويّة للمشاكل
critical	خطأ ()
error	تحذير ()
suggestion	إشعار ()

في مثال accountstatuses، يوضّح لك الخطأ missing_ad_words_link أنّه عليك ربط حساب على "إعلانات Google" لعرض الإعلانات، ولكنّه لن يؤثر في الموافقة على المنتج في قاعدة بيانات Merchant Center. من ناحية أخرى، يُعدّ الخطأ editorial_and_professional_standards_destination_url_down_policy أكثر خطورة ويؤدي إلى تعليق حسابك. إذا كنت تشارك في ميزة "الشراء على Google" أو "منصات Google"، أو إذا كان لديك حساب مرتبط على "إعلانات Google"، سيمنع الخطأ critical عرض منتجاتك في برامج "الشراء على Google" و"منصات Google" و"إعلانات Shopping" على الفور.

باستخدام هذه المعلومات، يمكنك الآن كتابة برنامج تنبيه يعرض المشاكل المهمة على الفور، مع جمع المشاكل الأقل خطورة لحلّها في النهاية، بدون الحاجة إلى الانتقال إلى Merchant Center لمعرفة نوع كل مشكلة.