Suponha que você queira informações sobre os produtos disponíveis atualmente na sua do Compute Engine. Em particular, você quer saber se algum dos seus produtos têm problemas que precisam ser resolvidos. Você sabe como conseguir essas informações no Merchant Center, mas é melhor configurar um sistema de alerta automático usando a API Content. Neste guia, veremos como a gravidade do problema na API Content é associada à priorização de problemas encontrada no Relatórios de diagnóstico no Merchant Center.
Exemplo com a API Content
Para saber quais são os problemas que afetam seus produtos, faça o seguinte:
accountstatuses.get
para 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 do Merchant Center
erros da conta. Critical erros vão causar a suspensão da conta, o que vai
impedem que você veicule seus produtos.
Em itemLevelIssues, é possível ver os erros que podem levar a um produto
reprovações. itemLevelIssues[].numItems informa que dois itens
em sua conta foram afetados por um link de imagem corrompido, e cinco itens têm
erro na página de destino.
Em itemLevelIssues[].servability, é possível ver se o erro causa a
produtos afetados sejam reprovados. Tanto o link de imagem corrompido quanto
o erro da página de destino causa a reprovação dos produtos.
Para encontrar todos os produtos afetados, chame
Productstatuses.list
para acessar uma lista completa de problemas por produto. Ela retorna
entradas como as seguintes:
{
"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 que você tem informações sobre os problemas de todos os produtos na sua conta, mas não está claro a importância de corrigir esses problemas.
No exemplo productstatuses, é possível usar itemLevelIssues[].servability
para descobrir se um erro impede que você veicule o produto
Comprar com o Google, anúncios do Shopping ou Google plataformas.
Se itemLevelIssues[].servability for unaffected como o
ambiguous_gtin, o erro não impedirá que seu produto seja
disponibilização.
No entanto, se itemLevelIssues[].servability for disapproved como o
mobile_landing_page_crawling_not_allowed, trata-se de um erro
um erro grave, pois você não pode exibir seu produto até que o erro seja corrigido.
No exemplo accountstatuses, em accountLevelIssues[].severity, a
Seção "Diagnóstico"
no Merchant Center define a priorização de problemas
e exatamente o que significam as diferentes prioridades.
Primeiro, confira o relatório:
Como todas as informações que você recebe a API Content for Shopping está relacionada ao que você na seção "Diagnóstico"? quais entradas são problemas que você precisa corrigir o mais rápido possível; quais seriam bons em resolver, mas que não são essenciais? Quais problemas interromperá a veiculação de seus produtos nos anúncios se não forem resolvidos?
Conforme mostrado nesses exemplos, a seção "Diagnóstico" mostra informações de gravidade
sobre problemas na conta e nos produtos dela, enquanto a API Content
(pelo serviço Accountstatuses) fornece informações de gravidade.
apenas por problemas de accountLevel.
Cada fonte divide os problemas em três categorias com base sobre a gravidade do problema. Entender como julgar a gravidade dos problemas retornados pelos serviços relacionados ao status podem ajudar a identificar rapidamente quais problemas são as mais importantes a serem resolvidas e quais problemas podem ser ignorados com segurança.
Priorização de problemas
Na seção "Diagnóstico", a priorização descreve o problema
gravidade 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
alertas,
e
para notificações.
Os erros causaram a suspensão da conta ou a reprovação de um item. Eles deve ser resolvido o mais rápido possível para garantir que os itens estejam qualificados para exibição nos resultados novamente.
Os avisos podem afetar negativamente o desempenho dos seus anúncios e provavelmente levar à 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. Resolvendo 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 na
Objetos de recurso accountstatuses fornecem os mesmos
informações sobre a gravidade de problemas. 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 () |
No exemplo da accountstatuses, o problema missing_ad_words_link permite
precisa vincular uma conta do Google Ads para veicular anúncios, mas isso não
afetar a aprovação do produto no banco de dados do Merchant Center.
Por outro lado,
editorial_and_professional_standards_destination_url_down_policy é um
o erro mais grave que suspende sua conta. Se você estiver participando
no Comprar com o Google ou no Google plataformas, ou se você tinha uma conta do Google Ads vinculada
um erro critical impede que seus produtos sejam veiculados na
Programas "Comprar com o Google", "Google plataformas" e "Anúncios do Shopping" imediatamente.
Com essas informações, você pode criar um software de alerta que chamar a atenção de problemas importantes imediatamente, coletando menos problemas sérios para serem corrigidos, sem ter que acessar o Merchant Center para discernir qual é qual.