Supongamos que quieres obtener información sobre los productos disponibles actualmente en tu cuenta. En particular, te interesa saber si alguno de tus productos tiene problemas que deban abordarse. Sabes cómo obtener esta información de Merchant Center, pero prefieres configurar un sistema de alertas automáticas con Content API. En esta guía, analizaremos cómo la información sobre la gravedad de los problemas en Content API se relaciona con la priorización de problemas que se muestra en los informes de Diagnóstico de Merchant Center.
Ejemplo con Content API
Para obtener los problemas que afectan tus productos, puedes ejecutar
accountstatuses.get
para tu cuenta. A continuación, se muestra un ejemplo reducido del recurso que obtienes:
{
"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"
}
]
},
...
}
En accountLevelIssues[].severity, puedes ver la gravedad de los errores de la cuenta de Merchant Center. Los errores Critical provocarán la suspensión de la cuenta, lo que impedirá que publiques tus productos.
En itemLevelIssues, puedes ver los errores de productos que pueden provocar el rechazo de los productos. Ten en cuenta que itemLevelIssues[].numItems te indica que 2 artículos de tu cuenta se ven afectados por un vínculo de imagen roto y que 5 artículos tienen un error en la página de destino.
En itemLevelIssues[].servability, puedes ver si el error provoca que se rechacen los productos afectados. Ten en cuenta que tanto el vínculo de imagen roto como el error de la página de destino provocan que se rechacen los productos.
Para encontrar todos los productos afectados, llama a
Productstatuses.list
para obtener una lista completa de los problemas por producto. Devuelve entradas como las siguientes:
{
"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"
}
],
...
},
...
]
}
Ahora tienes información sobre los problemas de todos los productos de tu cuenta, pero no está claro qué tan importante es corregirlos.
En nuestro ejemplo de productstatuses, puedes usar itemLevelIssues[].servability para descubrir si un error inhabilita tu capacidad de publicar el producto en Comprar en Google, anuncios de Shopping o plataformas de Google.
Si itemLevelIssues[].servability es unaffected, como el error ambiguous_gtin, el error no impedirá que se publique tu producto.
Sin embargo, si itemLevelIssues[].servability es disapproved, como el error mobile_landing_page_crawling_not_allowed, este es un error mucho más grave, ya que no puedes publicar tu producto hasta que se corrija el error.
En nuestro accountstatuses ejemplo, en accountLevelIssues[].severity, la
sección Diagnóstico
en Merchant Center define la priorización de problemas
y qué significan exactamente las diferentes prioridades.
Primero, echa un vistazo al informe:
¿Cómo se relaciona toda la información que obtienes de Content API for Shopping con lo que ves en la sección Diagnóstico? ¿Qué entradas son problemas que debes corregir lo antes posible y cuáles sería bueno abordar, pero no es esencial corregir? ¿Qué problemas impedirán que tus productos se publiquen en tus anuncios si no se abordan?
Como se muestra en estos ejemplos, la sección Diagnóstico proporciona información sobre la gravedad de los problemas de la cuenta y los productos de esa cuenta, mientras que Content API (a través del servicio Accountstatuses) proporciona información sobre la gravedad solo para los problemas accountLevel.
Cada fuente divide los problemas en tres categorías según la gravedad del problema. Comprender cómo evaluar la gravedad de los problemas que muestran los servicios relacionados con el estado puede ayudar a identificar rápidamente qué problemas son los más importantes para abordar y cuáles se pueden ignorar de forma segura.
Prioridad de los problemas
En la sección Diagnóstico, la priorización de problemas describe la gravedad del problema como uno de tres niveles: errores, advertencias y notificaciones. En
las tablas de informes como la anterior, estos niveles se representan con imágenes que
aparecen en la primera
columna:
para
errores,
para
advertencias
y
para notificaciones.
Los errores provocaron la suspensión de la cuenta o el rechazo de un artículo. Deben resolverse lo antes posible para garantizar que los artículos vuelvan a ser aptos para aparecer en los resultados.
Las advertencias podrían afectar negativamente el rendimiento de tus anuncios y probablemente provoquen la suspensión de los artículos o las cuentas en el futuro si no se resuelve el problema.
Las notificaciones son optimizaciones sugeridas para aumentar la calidad de los datos. Se recomienda resolver estos problemas, pero no es obligatorio.
Sin embargo, no es necesario visitar Merchant Center para saber qué errores son cuáles.
En Content API, el campo accountLevelIssues[].severity de los objetos de recursos accountstatuses proporciona la misma información sobre la gravedad de los problemas. Estos campos pueden contener uno de tres valores: critical, error y suggestion.
Estos valores tienen una correspondencia uno a uno con la priorización de problemas en la pestaña Diagnóstico:
| Gravedad del problema de calidad de los datos (API) | Priorización de problemas |
|---|---|
critical |
Error () |
error |
Advertencia () |
suggestion |
Notificación () |
Por lo tanto, en nuestro ejemplo de accountstatuses, el problema missing_ad_words_link te indica que debes vincular una cuenta de Google Ads para publicar anuncios, pero no afectará la aprobación del producto en tu base de datos de Merchant Center.
Por otro lado, editorial_and_professional_standards_destination_url_down_policy es un error más grave que suspende tu cuenta. Si participas en Comprar en Google o plataformas de Google, o si tenías una cuenta de Google Ads vinculada, un error critical impide que tus productos se publiquen de inmediato en los programas Comprar en Google, plataformas de Google y anuncios de Shopping.
Con esta información, ahora puedes escribir un software de alertas que te avise de inmediato sobre los problemas importantes y recopile los problemas menos graves para corregirlos más adelante, sin tener que visitar Merchant Center para discernir cuáles son cuáles.