درجة خطورة المشكلة وبيانات تشخيص 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 لمعرفة ما إذا كان هناك خطأ يمنعك من عرض المنتج في Buy on 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.

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

مدى خطورة مشكلة جودة البيانات (API)	تحديد الأولويّة للمشاكل
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 لمعرفة المشاكل المهمة من غير المهمة.