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