Supongamos que deseas obtener información sobre los productos que están disponibles en tu cuenta actualmente. En particular, te interesa saber si alguno de tus productos tiene problemas que se deban abordar. Sabes cómo obtener esta información en Merchant Center, pero preferirías configurar un sistema de alertas automáticas con Content API. En esta guía, analizaremos cómo se asigna la información sobre la gravedad del problema en Content API a la priorización de problemas que se muestra en los informes de diagnóstico de Merchant Center.
Ejemplo con Content API
Para solucionar los problemas que afectan a tus productos, puedes ejecutar accountstatuses.get
en tu cuenta. A continuación, se muestra un ejemplo reducido del recurso que obtendrás:
{
"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
dejará de publicar tus productos.
En itemLevelIssues
, puedes ver los errores de los productos que pueden provocar rechazos. Tenga en cuenta que itemLevelIssues[].numItems
le informa que 2 elementos de su cuenta se ven afectados por un vínculo de imagen roto y que 5 elementos tienen un error de página de destino.
En itemLevelIssues[].servability
, puedes ver si el error hace que se rechacen los productos afectados. Ten en cuenta que tanto el vínculo de imagen que no funciona como el error de la página de destino hacen que se rechacen los productos.
Si quieres encontrar todos los productos afectados, llama a Productstatuses.list
para obtener una lista completa de los problemas por producto. Muestra 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 sabes la importancia de solucionarlos.
En nuestro ejemplo de productstatuses
, puedes usar itemLevelIssues[].servability
para descubrir si un error inhabilita la capacidad de publicar el producto en Comprar con Google, los anuncios de Shopping o las plataformas de Google.
Si itemLevelIssues[].servability
es unaffected
, como el error ambiguous_gtin
, este no impedirá que se publique tu producto.
Sin embargo, si itemLevelIssues[].servability
es disapproved
como el error mobile_landing_page_crawling_not_allowed
, es un error mucho más grave, ya que no puedes entregar el producto hasta que se corrija el error.
En nuestro ejemplo de accountstatuses
, en accountLevelIssues[].severity
, la
sección Diagnóstico
de Merchant Center define la priorización de problemas
y, con precisión, qué significan las diferentes prioridades.
Primero, consulta el informe:
¿Cómo se correlaciona toda la información que obtienes de Content API for Shopping con lo que ves en la sección Diagnóstico? ¿Qué entradas corresponden a problemas que debes corregir lo antes posible y cuáles sería mejor abordar, pero no son esenciales? ¿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 de gravedad sobre los problemas de la cuenta y sus productos, 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 su gravedad. 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 que debes 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 en 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 han causado la suspensión de la cuenta o el rechazo de un artículo. Se deben resolver lo antes posible a fin de garantizar que los elementos sean aptos para volver a aparecer en los resultados.
Las advertencias pueden tener un impacto negativo en el rendimiento de sus anuncios y probablemente generen la suspensión de la cuenta o del artículo en el futuro, a menos que se resuelva 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 necesitamos visitar Merchant Center para averiguar cuáles son los errores.
En Content API, el campo accountLevelIssues[].severity
de los objetos de recursos accountstatuses
proporciona la misma información sobre la gravedad del problema. Estos campos pueden contener uno de tres valores: critical
, error
o suggestion
.
Estos valores tienen una correspondencia uno a uno con la priorización del problema 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 de missing_ad_words_link
te permite saber que necesitas 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 con Google, en las plataformas de Google o si tenías una cuenta de Google Ads vinculada, un error critical
impide que tus productos se publiquen en los programas Comprar con Google, Plataformas de Google y anuncios de Shopping de inmediato.
Con esta información, ahora puedes escribir software de alertas que te informe sobre problemas importantes de inmediato mientras recopilas los problemas menos graves para una posible solución en el futuro, sin tener que visitar Merchant Center para distinguirlos.