Dados estruturados de produtos: ofertas, avaliações, erros

Para que serve a marcação de produtos

Os dados estruturados de produtos descrevem um produto numa forma que os programas conseguem ler: o nome, a imagem, o preço, a moeda, a disponibilidade e as avaliações. O vocabulário vem do schema.org, e um formato comum é o JSON-LD, um bloco de dados dentro da página que os visitantes não veem. A Google pode usar estes dados para mostrar informações sobre o produto nos resultados de pesquisa, por exemplo um preço ou estrelas de avaliação. A Google também deixa claro que os dados estruturados não são nenhuma promessa de um resultado avançado.

Dois tipos de páginas de produto

A Google distingue dois casos. As fichas de comerciante destinam-se a páginas em que um comprador pode comprar-te o produto. Os fragmentos de produtos destinam-se a outras páginas de produto, como análises, testes e páginas de comparação. Os requisitos são diferentes, por isso decide primeiro em que caso está a tua página.

Segundo a Google, os resultados avançados de produtos só suportam páginas centradas num único produto ou em várias variantes do mesmo produto. A Google recomenda acrescentar a marcação às páginas de produto, não a páginas de categoria nem a listas de produtos.

Os elementos básicos

• Product: o artigo em si, com name, image, description, brand, sku e, se o tiveres, um GTIN.
• Offer: as condições de venda, com price, priceCurrency, availability, o url da oferta e, se o preço terminar, priceValidUntil.
• AggregateRating: a média de muitas avaliações, com ratingValue e ratingCount ou reviewCount.
• Review: uma análise individual. A Google exige que o nome do autor seja um nome válido de uma pessoa ou de uma equipa.

Um exemplo mínimo

Este bloco descreve uma caneca que está à venda. Fica no HTML da página de produto, normalmente no head ou no fim do body.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Caneca de cerâmica azul, 0.3 l",
  "image": "https://example.com/img/mug-blue.jpg",
  "sku": "MUG-BL-03",
  "brand": { "@type": "Brand", "name": "Cerâmica Exemplo" },
  "offers": {
    "@type": "Offer",
    "price": "12.90",
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/mug-blue"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "38"
  }
}
</script>

Três pormenores causam muitos erros. O schema.org pede um ponto como separador decimal e nenhum símbolo de moeda no preço, por isso escreve 12.90, e não 12,90 nem 12.90 €. A moeda vai em priceCurrency como código ISO 4217, por exemplo EUR ou PLN. A disponibilidade é um valor do schema.org, como InStock ou OutOfStock.

Avaliações e análises

Um AggregateRating precisa de ratingValue e de pelo menos um de ratingCount ou reviewCount. Dentro de um produto não é preciso itemReviewed. Se omitires bestRating e worstRating, a Google assume uma escala de 1 a 5. Se a tua loja usar outra escala, por exemplo de 1 a 10, indica-a.

Preço, disponibilidade e manter tudo atualizado

• Marca apenas o que os visitantes conseguem ver. A Google escreve que os dados estruturados têm de representar fielmente o conteúdo da página.
• Altera a marcação quando o preço ou o stock mudarem. Um bom sistema de loja faz isto automaticamente; um bloco escrito à mão, não.
• Define priceValidUntil apenas se o preço terminar mesmo. Segundo a Google, uma data no passado pode impedir que o fragmento de produto seja mostrado.
• Usa uma moeda por endereço. A Google pede um URL separado para cada moeda.
• Descreve o envio e as devoluções uma única vez para toda a loja. A Google recomenda uma política de devoluções e uma política de envio globais na marcação Organization.

Erros típicos

• O preço está escrito com vírgula, com símbolo de moeda ou como 0 numa página onde o produto é vendido.
• priceCurrency contém € ou $ em vez de um código como EUR ou USD.
• Falta a imagem, embora as fichas de comerciante a exijam.
• Uma página de loja usa AggregateOffer. As fichas de comerciante exigem um Offer, porque o comerciante tem de ser o vendedor.
• O nome ou o preço na marcação são diferentes dos da página, muitas vezes depois de uma alteração de preço.
• Dois blocos descrevem o mesmo produto com valores diferentes, por exemplo um do tema e outro de um plugin.

Como verificar a tua marcação

A Google indica o Teste de resultados avançados e a ferramenta de inspeção de URLs, que detetam a maioria dos erros técnicos. Alguns problemas continuam invisíveis para estes testes, por exemplo uma avaliação que não está na página. A Google também pode aplicar uma ação manual por dados estruturados que violam as suas regras. A página perde então a elegibilidade para resultados avançados, e os dados estruturados são ignorados.

Trabalhar com o Do4U

A Verificação de dados estruturados lê uma página a partir do seu endereço, ou o HTML ou o bloco JSON-LD que colares. Lê todos os blocos JSON-LD, incluindo @graph e itens aninhados, bem como microdados e RDFa. O código encontra erros de sintaxe com linha e coluna, tipos desconhecidos ou mal escritos e as propriedades que a Google exige ou recomenda para fragmentos de produtos, fichas de comerciante, ofertas e avaliações. Verifica a forma de preços, moedas, datas e avaliações e avisa quando um nome ou um preço da marcação não aparece no texto visível. Recebes uma árvore dos itens com erros, avisos e a fonte de cada regra. A página é lida tal como o servidor a entrega, sem JavaScript. Não é usada IA, e a verificação é gratuita, com um limite diário.

O Do4U encontra indícios; tu verificas e decides. Se aparece um resultado avançado é a Google que decide, e só tu sabes se um preço, um nível de stock ou uma avaliação estão corretos.