Suponha que você queira receber informações sobre os produtos disponíveis atualmente na sua conta. Especificamente, você quer saber se algum dos seus produtos tem problemas que precisam ser resolvidos. Você sabe como conseguir essas informações no Merchant Center, mas prefere configurar um sistema de alertas automáticos usando a API Content. Neste guia, vamos entender como as informações de gravidade do problema na API Content estão associadas à priorização vista nos relatórios de diagnóstico do Merchant Center.
Exemplo com a API Content
Para acessar os problemas que afetam seus produtos, execute
accountstatuses.get
na sua conta. Veja um exemplo reduzido do recurso que você receberá:
{
"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"
}
]
},
...
}
Em accountLevelIssues[].severity, você vê a gravidade dos erros da conta do Merchant Center. Critical erros vão causar a suspensão da conta, o que vai impedir você de veicular seus produtos.
Em itemLevelIssues, é possível ver os erros do produto que podem levar a reprovações. itemLevelIssues[].numItems informa que dois itens
na sua conta foram afetados por um link de imagem corrompido e cinco itens têm um
erro na página de destino.
Em itemLevelIssues[].servability, é possível ver se o erro faz com que os
produtos afetados sejam reprovados. Tanto o link da imagem corrompido quanto o erro da página de destino fazem com que os produtos sejam reprovados.
Para encontrar todos os produtos afetados, chame
Productstatuses.list
para conferir uma lista completa de problemas por produto. Ele retorna
entradas como estas:
{
"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"
}
],
...
},
...
]
}
Agora você tem informações sobre os problemas de todos os produtos na sua conta, mas não está claro a importância de corrigi-los.
No exemplo de productstatuses, é possível usar itemLevelIssues[].servability para descobrir se um erro desativa a veiculação do produto no Comprar com o Google, nos anúncios do Shopping ou no Google plataformas.
Se itemLevelIssues[].servability for unaffected, assim como o erro ambiguous_gtin, o erro não vai impedir que o produto seja veiculado.
No entanto, se itemLevelIssues[].servability for disapproved, como o
erro mobile_landing_page_crawling_not_allowed, ele será muito mais
sério, já que não será possível exibir seu produto até que o erro seja corrigido.
No exemplo de accountstatuses, em accountLevelIssues[].severity, a
seção Diagnóstico
do Merchant Center define a priorização de problemas
e o significado das diferentes prioridades.
Primeiro, analise o relatório:
Como todas as informações recebidas da API Content for Shopping se correlacionam com o que você vê na seção "Diagnóstico"? Quais entradas são problemas que você precisa corrigir o mais rápido e quais seriam bons de resolver, mas não são essenciais para corrigir? Quais problemas vão impedir a veiculação dos seus produtos nos anúncios se não forem resolvidos?
Conforme mostrado nesses exemplos, a seção "Diagnóstico" apresenta informações sobre a gravidade
de problemas na conta e nos produtos dela, enquanto a API Content
(usando o serviço Accountstatuses) fornece informações de gravidade
exclusivamente para problemas accountLevel.
Cada fonte divide os problemas em três categorias com base na gravidade do problema. Entender como avaliar a gravidade dos problemas retornados pelos serviços relacionados ao status ajuda a identificar rapidamente quais são os mais importantes a serem resolvidos e quais podem ser ignorados com segurança.
Priorização de problemas
Na seção "Diagnóstico", a priorização de problemas descreve a gravidade
como um destes três níveis: erros, avisos e notificações. Em tabelas de relatórios como a acima, esses níveis são representados por imagens que aparecem na primeira coluna: 
para erros, 
para avisos e 
para notificações.
Os erros causaram a suspensão da conta ou a reprovação de um item. Eles precisam ser resolvidos o mais rápido possível para garantir que os itens se qualifiquem para aparecer novamente nos resultados.
Os avisos podem afetar de maneira negativa a performance dos seus anúncios e provavelmente vão resultar em suspensões do item ou da conta, a menos que o problema seja resolvido.
As notificações são otimizações sugeridas para aumentar a qualidade dos dados. Resolver esses problemas é recomendado, mas não obrigatório.
No entanto, não é necessário acessar o Merchant Center para descobrir quais são os erros.
Na API Content, o campo accountLevelIssues[].severity nos
objetos de recurso accountstatuses fornece as mesmas
informações de gravidade do problema. Esses campos podem conter um destes três valores:
critical, error e suggestion.
Esses valores têm uma correspondência de um para um com a priorização de problemas na guia "Diagnóstico":
| Gravidade do problema de qualidade de dados (API) | Priorização de problemas |
|---|---|
critical |
Erro () |
error |
Aviso () |
suggestion |
Notificação () |
Portanto, no nosso exemplo de accountstatuses, o problema missing_ad_words_link informa que você precisa vincular uma conta do Google Ads para veicular anúncios, mas isso não afeta a aprovação do produto no seu banco de dados do Merchant Center.
Por outro lado, o
editorial_and_professional_standards_destination_url_down_policy é um
erro mais grave que suspende sua conta. Se você estiver participando do Comprar com o Google, do Google plataformas ou de ter uma conta vinculada do Google Ads, um erro critical vai impedir que seus produtos sejam veiculados imediatamente nos programas Comprar com o Google, Google plataformas e anúncios do Shopping.
Com essas informações em mãos, agora é possível criar um software de alerta que traga questões importantes à sua atenção imediatamente, além de coletar problemas menos sérios para uma eventual correção, sem precisar acessar o Merchant Center para discernir quais são os problemas.