تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

درجة خطورة المشكلة وبيانات تشخيص 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 كيفية تحديد أولوية المشاكل ومعنى الأولويات المختلفة بدقة.

أولاً، ألقِ نظرة على التقرير:

تقرير "بيانات التشخيص" من 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 لتحديدها.