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

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