Предположим, вы хотите получить информацию о товарах, доступных в вашем аккаунте. В частности, вам интересно узнать, есть ли у каких-либо из ваших товаров проблемы, требующие решения. Вы знаете, как получить эту информацию из 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», «Покупки» или на Surfaces в Google.
Если itemLevelIssues[].servability unaffected как в случае ошибки ambiguous_gtin , то эта ошибка не помешает показу вашего продукта.
Однако если itemLevelIssues[].servability disapproved , как ошибка mobile_landing_page_crawling_not_allowed , это гораздо более серьезная ошибка, поскольку вы не сможете обслуживать свой продукт, пока ошибка не будет исправлена.
В нашем примере accountstatuses в разделе «Диагностика» в Merchant Center под accountLevelIssues[].severity определяется приоритетность проблем и то, что именно означают различные приоритеты.
Сначала взгляните на отчет:
Как вся информация, которую вы получаете от Content API for Shopping, соотносится с тем, что вы видите в разделе «Диагностика»? Какие записи указывают на проблемы, которые необходимо исправить как можно скорее, а какие — нет? Какие проблемы, если их не устранить, могут помешать показу ваших товаров в рекламе?
Как показано в этих примерах, раздел «Диагностика» предоставляет информацию о серьезности проблем для учетной записи и продуктов в этой учетной записи, тогда как 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 — более серьёзная ошибка, которая блокирует ваш аккаунт. Если вы участвуете в программах «Купить в Google», «Surfaces across Google» или у вас был привязан аккаунт Google Ads, critical ошибка немедленно прекратит показ ваших товаров в программах «Купить в Google», «Surfaces across Google» и «Shopping Ads».
Вооружившись этой информацией, вы теперь можете написать программное обеспечение для оповещения, которое будет немедленно сообщать вам о важных проблемах, одновременно собирая менее серьезные проблемы для их последующего устранения, без необходимости посещать Merchant Center, чтобы разобраться, что к чему.