Серьезность проблемы и диагностика 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 показывает, что у 2 товаров в вашем аккаунте не работает ссылка на изображение, а у 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 Ads или Surfaces across Google.

Если itemLevelIssues[].servability unaffected как в случае с ошибкой ambiguous_gtin , то эта ошибка не помешает отображению вашего продукта.

Однако, если itemLevelIssues[].servability disapproved , как в случае ошибки mobile_landing_page_crawling_not_allowed , это гораздо более серьезная ошибка, поскольку вы не сможете показывать свой продукт, пока она не будет исправлена.

В нашем примере accountstatuses , в разделе diagnostics в Merchant Center , в подразделе accountLevelIssues[].severity определяется приоритетность проблем и точно указывается, что означают различные приоритеты.

Для начала ознакомьтесь с отчетом:

Diagnostics report from Merchant Center

Как вся информация, которую вы получаете от Content API для покупок, соотносится с тем, что вы видите в разделе «Диагностика»? Какие записи представляют собой проблемы, которые необходимо исправить как можно скорее, а какие было бы неплохо решить, но не являются обязательными? Какие проблемы приведут к тому, что ваши товары не будут отображаться в рекламе, если их не устранить?

Как показано в этих примерах, раздел «Диагностика» предоставляет информацию о степени серьезности проблем, связанных с учетной записью и продуктами в этой учетной записи, в то время как API контента (через службу Accountstatuses ) предоставляет информацию о степени серьезности только для проблем accountLevel .

Каждый источник делит проблемы на три категории в зависимости от их серьезности. Понимание того, как оценивать серьезность проблем, полученных от служб, связанных со статусом, может помочь быстро определить, какие проблемы наиболее важны для решения, а какие можно спокойно игнорировать.

Приоритизация проблем

В разделе «Диагностика» приоритезация проблем описывает уровень серьезности проблемы по трем категориям: ошибки, предупреждения и уведомления. В таблицах отчетов, подобных приведенной выше, эти уровни представлены изображениями, которые отображаются в первом столбце: Ошибка для исправления ошибок, Предупреждение для предупреждений и Уведомление для уведомлений.

  • Ошибки привели либо к блокировке учетной записи, либо к отклонению товара. Их следует устранить как можно скорее, чтобы товары снова могли отображаться в результатах поиска.

  • Предупреждения могут негативно повлиять на эффективность вашей рекламы и, вероятно, приведут к блокировке товара или учетной записи в будущем, если проблема не будет решена.

  • Уведомления содержат предложения по оптимизации для повышения качества данных. Решение этих проблем рекомендуется, но не является обязательным.

Однако нам не нужно заходить в Merchant Center, чтобы выяснить, какие ошибки к чему относятся. В Content API поле accountLevelIssues[].severity в объектах ресурсов accountstatuses предоставляет ту же информацию о серьезности проблемы. Эти поля могут содержать одно из трех значений: critical , error и suggestion .

Эти значения имеют однозначное соответствие с приоритетом проблемы на вкладке «Диагностика»:

Серьезность проблем качества данных (API) Приоритизация проблем
critical Ошибка ( Ошибка )
error Предупреждение ( Предупреждение )
suggestion Уведомление ( Уведомление )

В нашем примере accountstatuses проблема missing_ad_words_link указывает на необходимость привязки аккаунта Google Ads для показа рекламы, но это не повлияет на одобрение товара в базе данных Merchant Center. С другой стороны, ошибка editorial_and_professional_standards_destination_url_down_policy является более серьезной и приостанавливает действие вашего аккаунта. Если вы участвуете в программах Buy on Google, Surfaces across Google или у вас был привязан аккаунт Google Ads, critical ошибка немедленно останавливает показ ваших товаров в программах Buy on Google, Surfaces across Google и Shopping Ads.

Вооружившись этой информацией, вы теперь можете создавать программное обеспечение для оповещений, которое будет немедленно обращать ваше внимание на важные проблемы, одновременно собирая информацию о менее серьезных проблемах для последующего устранения, без необходимости посещать Merchant Center, чтобы разобраться, какая проблема к чему относится.