Suponha que você queira informações sobre os produtos disponíveis na sua conta. Em particular, você quer saber se algum dos seus produtos tem problemas que precisam ser resolvidos. Você sabe como extrair essas informações do Merchant Center, mas prefere configurar um sistema de alertas automáticos usando a API Content. Neste guia, vamos explicar como as informações de gravidade do problema na API Content são mapeadas para a priorização de problemas nos relatórios de diagnóstico do Merchant Center.
Exemplo com a API Content
Para receber os problemas que afetam seus produtos, execute
accountstatuses.get
na sua conta. Confira um exemplo reduzido do recurso que você recebe:
{
"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ê encontra a gravidade dos erros da conta do Merchant Center. Erros de Critical causam a suspensão da conta, o que impede a veiculação dos seus produtos.
Em itemLevelIssues, você pode conferir os erros que podem levar à reprovação de produtos. O itemLevelIssues[].numItems informa que dois itens na sua conta foram afetados por um link de imagem corrompido e que cinco itens têm um erro na página de destino.
Em itemLevelIssues[].servability, você pode conferir se o erro causa a reprovação dos produtos afetados. O link de imagem corrompido e o erro na página de destino causam a reprovação dos produtos.
Para encontrar todos os produtos afetados, chame
Productstatuses.list
e receba 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 o quão importante é corrigir esses problemas.
No nosso exemplo productstatuses, você pode usar itemLevelIssues[].servability
para descobrir se um erro desativa sua capacidade de veicular o produto no
Comprar no Google, nos anúncios do Shopping ou nas plataformas do Google.
Se itemLevelIssues[].servability for unaffected, como o erro ambiguous_gtin, ele não vai impedir que seu produto seja veiculado.
No entanto, se itemLevelIssues[].servability for disapproved, como o erro
mobile_landing_page_crawling_not_allowed, isso é um erro muito mais
grave, já que não é possível veicular o produto até que ele seja corrigido.
No exemplo accountstatuses, em accountLevelIssues[].severity, a seção "Diagnóstico" do Merchant Center define a priorização de problemas e o significado exato das diferentes prioridades.
Primeiro, confira o relatório:
Como todas as informações que você recebe da API Content for Shopping se correlacionam com o que aparece na seção "Diagnóstico"? Quais entradas são problemas que você precisa corrigir o mais rápido possível e quais seriam interessantes de resolver, mas não são essenciais? Quais problemas impedem que seus produtos sejam veiculados nos anúncios se não forem resolvidos?
Como mostrado nesses exemplos, a seção "Diagnóstico" fornece informações de gravidade sobre problemas da conta e dos produtos nela, enquanto a Content API (pelo serviço Accountstatuses) fornece informações de gravidade apenas para problemas de accountLevel.
Cada fonte divide os problemas em três categorias com base na gravidade. Entender como julgar a gravidade dos problemas retornados pelos serviços relacionados ao status pode ajudar a identificar rapidamente quais problemas são mais importantes de resolver 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 dos 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 de uma conta ou a reprovação de um item. Eles precisam ser resolvidos assim que possível para garantir que os itens estejam qualificados para aparecer nos resultados novamente.
Os avisos podem afetar negativamente a performance dos seus anúncios e provavelmente vão resultar em suspensões de itens ou da conta no futuro, a menos que o problema seja resolvido.
As notificações são otimizações sugeridas para aumentar a qualidade dos dados. Recomendamos resolver esses problemas, mas isso não é obrigatório.
Não é necessário acessar o Merchant Center para descobrir quais erros são quais.
Na Content API, o campo accountLevelIssues[].severity nos objetos de recurso accountstatuses fornece as mesmas informações de gravidade do problema. Esses campos podem conter um de três valores:
critical, error e suggestion.
Esses valores têm uma correspondência direta 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 () |
Assim, no exemplo accountstatuses, o problema missing_ad_words_link informa que você precisa vincular uma conta do Google Ads para veicular anúncios, mas não afeta a aprovação do produto no banco de dados do Merchant Center.
Por outro lado, a
editorial_and_professional_standards_destination_url_down_policy é uma
violação mais grave que suspende sua conta. Se você estiver participando do Comprar com o Google, do Google em várias plataformas ou tiver uma conta do Google Ads vinculada, um erro critical vai impedir imediatamente que seus produtos sejam veiculados nos programas Comprar com o Google, Google em várias plataformas e anúncios do Shopping.
Com essas informações, você pode escrever um software de alerta que vai chamar sua atenção imediatamente para problemas importantes e coletar problemas menos graves para uma possível correção, sem precisar acessar o Merchant Center para discernir qual é qual.