Предположим, вы хотите получить информацию о продуктах, доступных на данный момент в вашей учетной записи. В частности, вам интересно узнать, есть ли в каком-либо из ваших продуктов проблемы, требующие решения. Вы знаете, как получить эту информацию из 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 чтобы узнать, отключает ли ошибка возможность показывать продукт в сервисах «Купить через Google», «Товарные объявления» или «Поверхности» в 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», Surfaces через Google или если у вас есть связанная учетная запись Google Рекламы, critical ошибка немедленно прекращает показ ваших продуктов в программах «Купить через Google», Surfaces через Google и «Товарные объявления».
Вооружившись этой информацией, вы теперь можете написать программное обеспечение для оповещений, которое сразу же будет обращать ваше внимание на важные проблемы, одновременно собирая менее серьезные проблемы для возможного исправления, без необходимости посещать Merchant Center, чтобы понять, что есть что.