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 receber essas informações no Merchant Center, mas prefere configurar um sistema de alertas automático usando a API Content. Neste guia, vamos analisar como as informações de gravidade do problema na API Content são associadas à priorização de problemas encontrada 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 recebido:
{
"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ê verá 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 que podem levar à reprovação
do produto. Observe que itemLevelIssues[].numItems informa que dois itens na sua conta foram afetados por um link de imagem corrompido, e cinco itens têm um erro de 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 ver uma lista completa de problemas em cada produto. Ela 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 nosso 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 como o erro ambiguous_gtin, o erro não impedirá que seu produto seja veiculado.
No entanto, se itemLevelIssues[].servability for disapproved como o
mobile_landing_page_crawling_not_allowed, esse será um erro muito mais
sério, já que não será possível exibir seu produto até que o erro seja corrigido.
No exemplo do accountstatuses, em accountLevelIssues[].severity, a seção "Diagnóstico" do Merchant Center define a priorização de problemas e o que as diferentes prioridades significam.
Primeiro, confira o relatório:
Como todas as informações que você recebe da API Content for Shopping se relacionam com o que você vê na seção "Diagnóstico"? Quais entradas são problemas que você precisa corrigir o mais rápido possível e quais seriam bons para resolver, Quais problemas vão impedir a veiculação dos seus produtos nos anúncios se não forem resolvidos?
Como mostrado nesses exemplos, a seção "Diagnóstico" fornece informações de gravidade
sobre problemas na conta e nos produtos dela, enquanto a API Content
(usando o serviço Accountstatuses) fornece informações de gravidade
apenas para problemas accountLevel.
Cada fonte divide os problemas em três categorias com base na gravidade. Entender como julgar a gravidade dos problemas retornados dos serviços relacionados ao status pode ajudar a identificar rapidamente quais problemas 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 descreve a gravidade
do problema como um destes três níveis: erros, avisos e notificações. Em
tabelas de relatório como a mostrada 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. Elas precisam ser resolvidas o mais rápido possível para garantir que os itens estejam qualificados para aparecerem nos resultados novamente.
Os avisos podem afetar negativamente o desempenho dos seus anúncios e provavelmente levarão à suspensão do item 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. Resolver esses problemas é recomendado, mas não obrigatório.
No entanto, não precisamos 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 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 () |
Portanto, no exemplo da 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 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ê participa do Comprar com o Google, do Google plataformas ou se tinha uma conta vinculada do Google Ads, um erro critical impede que seus produtos sejam veiculados nos programas Comprar com o Google, Google plataformas e anúncios do Shopping imediatamente.
Com essas informações em mãos, você pode criar um software de alertas que chame sua atenção de forma imediata para problemas importantes, enquanto coleta problemas menos graves para uma correção final, sem precisar acessar o Merchant Center para discernir qual deles.