Como adicionar o esquema de produto do WooCommerce para obter resultados avançados

Principais conclusões

• O esquema de produto pode tornar as tuas páginas de produto elegíveis nos resultados de pesquisa do Google para preço, disponibilidade, classificações e outras funcionalidades de resultados avançados.
• Podes adicionar ou melhorar o esquema de produtos utilizando o esquema integrado do WooCommerce, um plug-in de SEO ou JSON-LD personalizado.
• O esquema pode ser ignorado se não corresponder ao que os compradores vêem na página do produto.
• O esquema não garante resultados de qualidade, mas é necessário para que os produtos WooCommerce se qualifiquem.

Tens uma loja WooCommerce, os teus produtos são legítimos e estás a fazer um esforço para aparecer no Google. Pesquisas um dos teus produtos no Google, e é apenas um link azul simples. Não tem classificação por estrelas. Não há foto do produto. Não tens preço. Nenhum dos detalhes rápidos que fazem alguém parar e clicar.

Ao mesmo tempo, outras lojas parecem ocupar mais espaço na página de resultados. As suas listagens parecem mais ricas. Podes saber qual é o produto, se está em stock e como as pessoas o avaliam, tudo isto antes mesmo de abrires a página. Esse pequeno contexto é muitas vezes o que decide o clique.

É aqui que entra o esquema do produto, que fornece ao Google detalhes mais claros do produto para que os resultados do teu produto tenham mais probabilidades de mostrar o preço, as avaliações, a disponibilidade e outras funcionalidades de resultados avançados.

Neste guia, vais aprender o que é o esquema de produtos do WooCommerce, porque é importante para a tua loja e como adicioná-lo da forma correta.

O que é o esquema de produtos no WooCommerce?

Pensa no esquema de produto como um tradutor entre a tua loja WooCommerce e o Google. De qualquer forma, adiciona o nome do produto, o preço e o estado do stock no WooCommerce. O esquema simplesmente empacota essa informação num formato motores de busca como o Google pode ler sem adivinhação.

Um esquema de produto (também designado por dados estruturados) é um pequeno bloco de código normalizado, normalmente no formato JSON-LD, que é adicionado ao HTML da tua página de produto. Os compradores nunca o vêem, mas o Google sim.

Estes dados estruturados seguem a norma Schema.org, que é a “linguagem” partilhada que os motores de busca utilizam para compreender as páginas. Quando o Google visita a página do teu produto, o esquema ajuda-o a compreender exatamente o que estás a vender e quais os detalhes importantes.

Aqui está uma forma fácil de o imaginar. Digamos que estás a vender auscultadores sem fios. Sem o esquema, o Google pode apenas entender que a página é sobre um produto. Com o esquema, estás a dizer explicitamente ao Google: este é um par de auscultadores sem fios, custa 299,95 dólares, está em stock e foi classificado com 4,5 estrelas em 86 avaliações. Quando o Google tem esses detalhes, pode mostrá-los diretamente nos resultados da pesquisa como resultados avançados, como o nome do produto, a imagem, o preço, o estado do stock e as classificações. Isto faz com que os teus produtos pareçam mais credíveis e mais clicáveis.

A melhor parte é que O WooCommerce já tem um produto básico O WooCommerce tem um esquema integrado, pelo que não tens de o configurar manualmente. Preenche os detalhes do teu produto como fazes normalmente e o WooCommerce pode gerar o esquema automaticamente em todas as páginas do produto. É um passo simples que pode fazer com que os teus produtos se destaquem no Google.

Porque é que as lojas WooCommerce precisam de um esquema de produtos

Vale a pena adicionar o esquema de produto porque pode tornar os teus produtos elegíveis para resultados avançados, o que pode melhorar a forma como as tuas listagens aparecem na pesquisa do Google para além de um simples link.

Eis o que o esquema de produto te ajuda a fazer:

• Melhor aspeto da pesquisa

Quando o Google compreende detalhes importantes como o preço e a disponibilidade, a tua listagem pode parecer mais completa nos resultados da pesquisa.

• Cliques de maior qualidade

Quando as pessoas podem ver as principais informações sobre o produto logo à partida, é mais provável que cliquem apenas quando o produto se adequa. Isto significa frequentemente menos cliques irrelevantes e uma intenção de compra mais forte.

• Mais confiança num relance

Os resultados avançados podem fazer com que a tua listagem pareça mais credível porque os compradores vêem imediatamente sinais como classificações e contagens de avaliações.

• Menos mal-entendidos para os motores de busca

Sem o esquema, o Google tem de interpretar o esquema da tua página, o que pode levar a detalhes em falta ou incorrectos nos resultados da pesquisa.

• Mais consistência entre produtos

Quando o esquema do WooCommerce está configurado corretamente, as páginas dos teus produtos seguem uma estrutura consistente, o que é uma grande vantagem quando tens muitos produtos.

• Mais visibilidade preparada para o futuro

Com mais experiências de pesquisa baseadas em IA a aparecerem, os dados de produtos limpos e estruturados ajudam a Google a compreender o teu catálogo de forma mais consistente. O esquema mantém os teus produtos elegíveis para formatos de pesquisa mais recentes.

Certifica-te de que as páginas dos teus produtos têm informações precisas dados do produto no WooCommerceespecialmente o preço, o estado das existências e os identificadores de produtos. Um esquema só pode ser tão bom quanto os dados que lhe dás.

Como o Google mostra resultados avançados para produtos do WooCommerce

Quando o Google encontra um esquema de produto válido na tua página de produto, pode compreender os detalhes do produto de forma mais clara. Se assim o decidir, o Google pode mostrar alguns desses detalhes diretamente nos resultados da pesquisa.

Para uma loja WooCommerce, isto significa que os compradores podem ver detalhes úteis do produto diretamente na página de resultados da pesquisa, desde que o teu conteúdo seja claro, preciso e corresponda ao que o Google espera.

Eis o que pode aparecer nesses resultados de pesquisa melhorados:

• Nome do produto
• Imagem do produto
• Preço
• Disponibilidade, como Em stock ou Fora de stock
• Classificação por estrelas e contagem de avaliações (quando as avaliações são suportadas e válidas)
• Informações de envio ou devolução em alguns casos, se as forneceres

Exemplo de resultados detalhados de produtos na pesquisa, mostrando preços, classificações e imagens. Os resultados podem ser diferentes consoante a pesquisa e o produto.

Nos bastidores, o Google não se limita a aceitar o teu esquema tal como está. Executa um processo de validação rápido:

• O Google visita a página do teu produto.
• Lê os dados estruturados e verifica se correspondem ao que os compradores podem ver na sua página de produto.
• Se os dados estruturados forem válidos e a página corresponder às diretrizes da Google para resultados de produtos sofisticados, a Google pode melhorar a listagem na pesquisa.

Algumas coisas importantes a saber:

• Os resultados avançados não são garantidos: Mesmo com um esquema perfeito, o Google pode não mostrar resultados optimizados para cada produto ou consulta de pesquisa. Decide o que aparece na pesquisa.
• O teu conteúdo na página deve corresponder ao teu esquema: Se o teu esquema do WooCommerce disser que o produto está em stock, mas a página mostrar que está esgotado, o Google pode ignorar completamente os teus dados estruturados do WooCommerce.
• As avaliações seguem regras mais rigorosas: As classificações devem ser provenientes de críticas reais e visíveis no teu Web site e seguir as diretrizes do Google. As avaliações falsas, ocultas ou copiadas podem tornar a tua página inelegível.

Como adicionar o esquema de produtos ao WooCommerce (3 métodos)

Adicionar um esquema de produto ao WooCommerce é sobretudo estruturar os detalhes do teu produto para que os motores de busca os possam compreender claramente.

Não precisas de redesenhar a tua loja ou alterar o que os compradores vêem. Podes utilizar o esquema integrado do WooCommerce, adicionar um plug-in ou escrever o teu próprio JSON-LD.

Esta secção explica-te como adicionar o esquema de produto para que funcione corretamente nas tuas páginas de produto.

Método A: Esquema de produto incorporado do WooCommerce

O WooCommerce produz automaticamente o esquema do produto em páginas de produtos individuais, pelo que, em muitos casos, não precisas de uma configuração adicional.

Nos bastidores, o WooCommerce gera um bloco JSON-LD a partir dos dados do seu produto. Obtém detalhes do editor de produtos para que o esquema permaneça em sincronia com o seu catálogo.

O que o WooCommerce inclui por defeito

Podes ver e gerir a maioria destes campos diretamente no editor de produtos do WooCommerce. Quando actualizas um produto, o WooCommerce utiliza esses dados para gerar automaticamente o esquema do produto.

O esquema nativo inclui estes campos-chave:

• Nome do produto e URL da página do produto (permalink)
• Imagem do produto
  
• SKU e estado do stock
• Oferece dados como preço normal e preço de venda
• Descrição do produto e breve descrição
• Tratamento básico para produtos variáveis usando a variação padrão
• Dados de avaliação e classificação quando as avaliações do WooCommerce estão activadas

Para as lojas mais pequenas, isto é suficiente para tornar a página elegível para os resultados avançados.

Onde a configuração predefinida é insuficiente

O esquema nativo é intencionalmente mínimo. Não inclui muitos campos que ajudam os motores de busca a compreender melhor os seus produtos, tais como:

• Informações sobre a marca
• Imagens completas da galeria de produtos
• Atributos pormenorizados como a cor ou o tamanho
• Sistemas de avaliação personalizados fora do WooCommerce
• Esquema a nível de categoria ou de arquivo

Isto significa que a saída predefinida é válida mas nem sempre completa.

Quando deves confiar no esquema nativo do WooCommerce

Este método funciona bem se:

• Queres um ponto de partida limpo sem plugins extra.
• Os teus produtos não necessitam de identificadores avançados.
• Preferes alargar gradualmente o esquema em vez de o substituir.

Segue estes passos para utilizar o esquema nativo do WooCommerce:

• Confirma que o esquema está a ser emitido

Abre qualquer página de produto e vê a fonte da página. Procura por <script type=”application/ld+json”>. Se o WooCommerce estiver a produzir o seu esquema nativo, verás um bloco JSON-LD com “@type”: “Produto”.

• Verifica se existe um esquema duplicado ou desativado

Alguns temas e plug-ins de SEO podem desativar ou anular os dados estruturados do WooCommerce. Se não vires a saída do esquema, verifica as definições relacionadas com o esquema ou os dados estruturados.

Personaliza a saída do esquema nativo do WooCommerce

O WooCommerce inclui filtros para alargar o seu esquema integrado, pelo que não precisas de adicionar um script de esquema separado à página. Mantém o esquema de produto predefinido do WooCommerce e utiliza filtros para acrescentar propriedades adicionais, como marca, imagens de galeria ou classificações.

Aqui está um exemplo que adiciona marca, imagens de galeria e aggregateRating. Adiciona o seguinte código ao ficheiro functions.php do teu tema ou a um pequeno plugin personalizado:

add_filter( 'woocommerce_structured_data_product', function( $markup, $product ) {
  // Adiciona a marca a partir do atributo do produto ou do campo personalizado
  se ( $brand = $product->get_attribute( 'pa_brand' ) ) {
  $markup['brand'] = [
  '@type' => 'Marca',
  'nome' => $marca,
  ];
  }
  // Adiciona as imagens da galeria ao conjunto de imagens principal
  $gallery_ids = $product->get_gallery_image_ids();
  se ( $gallery_ids ) {
  $images = is_array( $markup['image'] ?? [] )
  ? $markup['image'] 
  ( ! vazio( $markup['image'] ) ? [ $markup['image'] ] : [] ); 
  vê ( $gallery_ids as $id ) {
  $url = wp_get_attachment_url( $id );
  se ( $url ) {
  $images[] = $url;
  }
  }
  $markup['image'] = array_values( array_unique( array_filter( $images ) ) );
  }
  // Adiciona a classificação agregada se existirem críticas
  se ( $produt->get_review_count() ) {
  $markup['aggregateRating'] = [
  '@type' => 'AggregateRating',
  'ratingValue' => $product->get_average_rating(),
  'reviewCount' => $product->get_review_count(),
  ];
  }
  devolve $markup;
}, 10, 2 );

Para alargar os dados da Oferta, podes utilizar o seguinte código:

add_filter( 'woocommerce_structured_data_product_offer', function( $markup_offer, $product ) {
  // Exemplo: Adiciona detalhes de envio
  $markup_offer['shippingDetails'] = [
  '@type' => 'OfferShippingDetails',
  'shippingRate' => [
  '@type' => 'MonetaryAmount',
  'valor' => '5.00',
  'currency' => get_woocommerce_currency()
  ]
  ];
  devolve $markup_offer;
}, 10, 2 );

Método B: Um plugin SEO

Podes deixar que um SEO ou o plugin do esquema trata da maior parte da configuração. Utiliza um plugin respeitável que suporte o WooCommerce e produza JSON-LD.

Estes passos utilizam Classifica-te em Matemática como exemplo. Em Yoast ou SEOPress, os nomes dos menus podem ser diferentes, mas o fluxo de trabalho é o mesmo: ativa o suporte do WooCommerce, confirma que o esquema do produto está ativado e, em seguida, ajusta-o por produto, se necessário.

Segue estes passos para configurar o plugin para produtos WooCommerce:

• Instala e ativa o plugin que escolheste em Plugins → Adicionar novo.
• Executa o assistente de configuração e, em seguida, ativa o módulo Schema ou Structured Data. Se disponível, ativa o módulo WooCommerce.
  
  
• Define o esquema predefinido para os produtos:
  • Vai para Títulos e Meta → Produtos.
  • Confirma que a saída do esquema está activada e define o Tipo de esquema para Produto (ou Produto WooCommerce) e guarda as alterações.
• Configura o esquema num produto específico:
  • Edita um produto em Produtos → Todos os produtos.
  • Desloca-te até à meta-caixa do plugin e abre o separador Schema ou Structured Data.
  • Clica em Gerador de esquemas.
  • Seleciona Produto (ou Produto WooCommerce), guarda e, em seguida, clica em Atualizar.
    

Esta abordagem funciona para a maioria das lojas sem código. O plug-in usa os campos de produto do WooCommerce para gerar JSON-LD aprimorado, que pode cobrir lacunas no método nativo, como marcação de marca e avaliação.

Método C: JSON-LD manual

O JSON-LD manual é a opção mais flexível quando queres ter controlo total sobre o teu esquema de produto ou quando os plugins não cobrem o teu caso de utilização. Em vez de depender do WooCommerce ou de um plug-in de SEO para gerar a marcação, adiciona o teu próprio script JSON-LD à página do produto e decide exatamente quais as propriedades a incluir.

Decide quando é que o JSON-LD manual faz sentido

O esquema manual é útil quando:

• Tens um design personalizado ou uma configuração sem cabeça e os plug-ins WooCommerce ou SEO não estão a produzir o esquema correto.
• Tens de incluir campos extra, tais como detalhes de envio avançados, atributos únicos ou dados de produtos especializados.
• Pretendes combinar vários tipos de esquemas num bloco e as definições do plugin são demasiado limitadas.

Nota: O JSON-LD manual precisa de manutenção contínua. Se os preços, o estado do stock, as avaliações ou os URLs mudarem e a tua marcação não, o Google pode tratar o esquema como não fiável.

Opção 1: Utiliza um modelo JSON-LD de produto básico

Começa com uma estrutura de produto limpa e mapeia-a para dados reais do WooCommerce.

O seguinte é um modelo JSON-LD estático que podes copiar e colar para testar um único produto ou utilizar num site estático. Não requer PHP. Substitui os valores de exemplo por detalhes que são realmente mostrados na página do teu produto.

<script type="application/ld+json">
{
  "@contexto": "https://schema.org",
  "@type": "Produto",
  "nome": "Nome do produto de exemplo",
  "imagem": [
  "https://example.com/wp-content/uploads/product-image.jpg"
  ],
  "descrição": "Descrição breve do produto",
  "sku": "SKU-12345",
  "marca": {
  "@type": "Marca",
  "nome": "Nome da marca"
  },
  "oferece": {
  "@type": "Oferta",
  "url": "https://example.com/product/example-product/",
  "priceCurrency": "USD",
  "preço": "99.00",
  "disponibilidade": "https://schema.org/InStock",
  "itemCondition": "https://schema.org/NewCondition"
  },
  "aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.7",
  "reviewCount": "32"
  }
}
</script>

Podes adicionar este fragmento de código utilizando uma das seguintes opções:

• Cola-o no header.php do teu tema filho, mesmo antes de </head>.
• Usa um plugin como o Insert Headers and Footers e adiciona-o em Scripts no Header, depois cola o bloco <script>.
• Utiliza o plugin Code Snippets → Add New → seleciona PHP → cola o bloco <script> → envolve-o em is_product() para que seja executado apenas em páginas de produtos individuais → clica em Save and Activate.

Opção 2: Utiliza uma função PHP dinâmica

O seguinte snippet PHP extrai dados do WooCommerce em tempo real e produz o esquema do produto automaticamente nas páginas do produto, para que se mantenha atualizado à medida que o teu catálogo muda.

add_action( 'wp_head', 'my_custom_product_schema' );
função my_custom_product_schema() {
// Só produz o esquema em páginas de produtos individuais.
se ( ! is_product() ) {
regressa;
}
// Obtém o objeto atual do produto WooCommerce.
global $produto;
se ( ! $product instanceof WC_Product ) {
regressa;
}

// Obtém com segurança o URL da imagem em destaque (evita erros se nenhuma imagem for definida).
$imagem = '';
$image_src = wp_get_attachment_image_src( $product->get_image_id(), 'full' );
Se ( ! vazio( $image_src[0] ) ) {
$image = $image_src[0];
}
// Constrói o payload JSON-LD do produto usando dados do WooCommerce.
$data = [
'@context' => 'https://schema.org',
'@type' => 'Produto',
'name' => $product->get_name(),
'imagem' => $imagem,
// Prefere a descrição curta, volta à descrição completa.
'description' => wp_strip_all_tags( $product->get_short_description() ?: $product->get_description() ),
'sku' => $product->get_sku(),
// Substitui isto pela tua verdadeira lógica de marca, se necessário (atributo, taxonomia ou campo personalizado).
'marca' => [
'@type' => 'Marca',
'name' => 'Nome da tua marca',
],
// Dados da oferta: preço, moeda, URL e estado do stock.
'ofertas' => [
'@type' => 'Oferta',
'url' => get_permalink( $product->get_id() ),
'priceCurrency' => get_woocommerce_currency(),
'price' => $product->get_price(),
'disponibilidade' => $product->is_in_stock()
? 'https://schema.org/InStock' 
: 'https://schema.org/OutOfStock',
],
];
// Adiciona aggregateRating apenas quando existe pelo menos uma avaliação.
se ( $produt->get_review_count() ) {
$data['aggregateRating'] = [
'@type' => 'AggregateRating',
'ratingValue' => $product->get_average_rating(),
'reviewCount' => $product->get_review_count(),
];
}
// Emite a etiqueta de script JSON-LD no cabeçalho da página.
ecoa '';
}

Podes adicionar este fragmento de código utilizando uma das seguintes opções:

• Adiciona-o ao functions.php do teu tema filho.
• Adiciona-o num pequeno plugin personalizado.
• Utiliza o plugin Code Snippets → Add New → seleciona PHP → cola o código → define Location to Run everywhere → clica em Save and Activate.

Como testar o teu esquema de produtos WooCommerce

Depois de adicionar o esquema do produto, testa alguns URLs de produtos utilizando o teste de resultados avançados do Google. Isto serve para garantir que os motores de busca conseguem ler o teu esquema corretamente e que os teus produtos são elegíveis para os resultados avançados.

Corrige quaisquer erros ou avisos e, em seguida, aguarda alguns dias e verifica Consola de pesquisa para ver se o Google está a detetar as melhorias do teu produto. É uma verificação rápida que ajuda a confirmar que o Google está a ler o teu esquema do WooCommerce da forma que esperas.

Utilizar o teste de resultados avançados do Google para verificar a elegibilidade

O Teste de pesquisa avançada mostra se a página do seu produto se pode qualificar para funcionalidades de pesquisa melhoradas, como preço, disponibilidade e classificações. Mostra se o Google consegue ler o esquema do seu produto e quais os erros ou avisos que considera importantes.

Segue estes passos para testar uma página de produto:

• Abre o Teste de resultados avançados do Google.
• Escolhe URL ou Código:
  • URL: Cola o URL completo da página do produto em direto.
  • Código: Cola o teu JSON-LD ou o HTML da página se estiveres a testar localmente ou no staging.
• Seleciona o dispositivo definido como Smartphone, a menos que tenhas uma razão específica para testar o ambiente de trabalho, uma vez que o Google utiliza principalmente a indexação mobile-first.
• Clica em Testar URL ou Testar código e aguarda os resultados.
• Revê a secção Dados estruturados detectados.

O que confirmar

• Vês a listagem de Produtos ou Comerciantes detectada.
• Campos como nome, preço, disponibilidade e imagem estão presentes.
• A página mostra Eligible para obter resultados avançados se tudo for válido.
• Se houver problemas, a página apresenta erros ou avisos.

Validar o teu esquema com o Schema Markup Validator

O validador de marcação de esquema verifica se o seu JSON-LD segue o padrão Schema.org, além do que o Google usa para resultados avançados. Valida a sintaxe dos dados estruturados, os tipos e as propriedades do esquema e assinala os campos obsoletos ou em falta.

Segue estes passos para validar os dados estruturados do WooCommerce:

• Abre o Schema Markup Validator e escolhe URL ou Code Snippet.
• Cola o URL do produto ou JSON-LD e clica em Executar teste.
• Revê os tipos de esquemas e as mensagens detectadas.

O que confirmar

• O esquema do produto foi detectado.
• Revê os erros e avisos.

Compreender os erros e os avisos

Corrige os erros primeiro. Os avisos são opcionais e só deves adicionar campos opcionais se os visitantes puderem ver essa informação na página do produto.

• Os erros significam que o Google não pode utilizar o esquema de forma fiável. Os exemplos incluem campos obrigatórios em falta, como nome, offers.price, priceCurrency ou disponibilidade; valores inválidos ou o JSON está danificado.
• Os avisos significam que o esquema é válido mas está incompleto. Exemplos incluem campos de marca ou de revisão em falta.

Quando o teste de pesquisa de resultados avançados e o validador de esquema não estão de acordo

O Teste de pesquisa avançada e o Validador de marcação de esquema podem mostrar resultados diferentes porque verificam critérios diferentes.

• Se o teste de resultados avançados for aprovado, mas o validador apresentar problemas

A tua página é elegível, mas a estrutura não está limpa. Corrige problemas óbvios, como tipos inválidos ou sintaxe incorrecta, uma vez que podem afetar outros motores de busca e futuras actualizações do Google.

• Se o validador for aprovado mas o teste de resultados avançados disser não elegível

Verifica se os campos obrigatórios do Google, como o preço, a disponibilidade ou a imagem, estão em falta ou não são visíveis na página.

Monitorizar a integridade do esquema na Consola de Pesquisa do Google

Quando o esquema estiver ativo, monitoriza-o na Consola de Pesquisa para acompanhar o desempenho e os problemas. Isto mostra como o Google processa os teus dados estruturados do WooCommerce ao longo do tempo.

Relatório de snippets de produtos

Para ver o relatório Product Snippets, vai a Consola de pesquisa → Melhorias → Produto Fragmentos.

Este relatório mostra-te:

• Páginas válidas com dados estruturados de produtos
• Erros que impedem a obtenção de resultados de qualidade
• Avisos que limitam as melhorias

Estes estão relacionados com resultados ricos em produtos em pesquisas normais na Web.

Relatório de listagem de comerciantes

Para ver o relatório de listagens de comerciantes, vai a Consola de pesquisa → Melhorias → Comerciante Listagens.

Este relatório mostra-te:

• Dados estruturados utilizados em experiências de estilo de compras, como grelhas de produtos ou carrosséis. Estes resultados incluem sempre dados de preços.
• Que produtos são elegíveis
• Problemas de esquema que afectam a visibilidade
• Desempenho ligado a dados estruturados

Corrigir problemas

• Clica num tipo de erro para ver os URLs afectados.
• Abre um URL para ver os detalhes.
• Corrige o problema no WooCommerce ou nas definições do teu plug-in.
• Clica em Validar correção para que o Google possa reprocessar a página.

Testar novamente o teu esquema

Testa o URL ativo depois de publicares as alterações, não apenas os fragmentos de código.

O esquema pode quebrar silenciosamente durante as actualizações do site. Volta a testar se:

• Altera os plug-ins SEO ou de esquema
• Modifica os modelos do WooCommerce
• Adiciona extensões de revisão ou de preços
• Muda de tema ou redesenha as páginas
• Move ambientes ou domínios

Dá tempo ao Google para reprocessar as actualizações:

• Mesmo depois de corrigir o esquema, os resultados da pesquisa não são actualizados instantaneamente. O Google tem de rastrear e reindexar a página novamente.
• Se necessário, solicita um processamento mais rápido utilizando Search Console → Inspeção de URL → Solicitar indexação.

Um esquema válido garante que o teu Os produtos WooCommerce permanecem elegíveis e ajudam na pesquisa os motores compreendem-nas corretamente ao longo do tempo.

Como corrigir erros comuns do esquema de produtos do WooCommerce

Esta secção mostra-te como corrigir os erros de esquema de produto mais comuns que podes encontrar depois de adicionares o esquema à tua loja WooCommerce.

Marcação de produto duplicada ou em conflito

Se uma página de produto tiver vários blocos de esquema de produto, isso geralmente significa que mais de uma fonte está gerando o esquema ao mesmo tempo, por exemplo, WooCommerce, seu plug-in de SEO, seu tema ou um snippet JSON-LD manual. Isso pode confundir o Google e reduzir a chance de obter resultados avançados.

Identifica todas as fontes de esquema

• Verifica as definições do teu tema para opções como Schema, Dados estruturados, Rich snippets ou Marcação de produto.
• Verifica as definições do esquema do teu plugin SEO (Rank Math, Yoast, AIOSEO, SEOPress).
• Se utilizares um plugin de esquema dedicado, verifica se também está a gerar um esquema de produto para os produtos.
• Verifica se há algum código personalizado ou snippets que adicionam um bloco JSON-LD <script> nas páginas de produtos.

Escolhe uma fonte para tratar o esquema do produto

• Para a maioria das lojas, a configuração mais simples é uma fonte de esquema de produto, normalmente o teu plugin SEO principal ou um plugin de esquema dedicado.
• O esquema nativo do WooCommerce pode permanecer ativo se o teu plugin o estiver a ampliar. Se o teu plugin substituir o esquema do WooCommerce, segue a configuração recomendada pelo plugin.

Desliga os duplicados

• No teu tema, desactiva os dados estruturados do produto ou as opções de rich snippet se o teu plugin já produzir o esquema do produto.
• Nos plug-ins secundários, desactiva a saída do esquema do produto. Se só precisares de outras marcações (como migalhas de pão ou organização), deixa-as activas e desactiva a opção Produto.
• Evita executar dois plug-ins de esquema que geram ambos o esquema do produto.

Após cada alteração, testa novamente o URL do produto ativo. Deves ver um esquema de produto para a página, com os campos principais preenchidos, tais como nome, imagem, ofertas, priceCurrency, preço e disponibilidade.

Campos obrigatórios em falta

O Google requer alguns campos-chave para gerar resultados de qualidade. Se faltar apenas um, a página pode falhar a validação.

Se vires erros sobre campos obrigatórios em falta, como nome, offers.price, priceCurrency ou disponibilidade, isso significa normalmente que os dados do teu produto estão incompletos ou que a tua ferramenta de esquema não está a extrair os campos corretos do WooCommerce.

Verifica os dados do produto WooCommerce

• Abre Produtos → Todos os produtos e edita o produto.
• Certifica-te de que o produto tem um título claro no WooCommerce e que está publicado (não deixado como Rascunho automático).
• Adiciona um valor ao Preço normal. Adiciona o Preço de venda apenas se estiveres a utilizar uma venda.
• Em Dados do produto → Inventário, define o estado do stock como Em stock, Fora de stock ou Em espera.

Verifica as definições do teu plugin SEO ou schema

• No mesmo ecrã de edição do produto, encontra o teu painel de plugins (por exemplo, Rank Math ou Yoast).
• Certifica-te de que o tipo de esquema é Produto e não Artigo ou Página da Web.
• Certifica-te de que o plugin está a extrair o preço e o estado do stock dos campos de produto do WooCommerce. A maioria faz isso automaticamente, mas pode falhar se mapeares campos personalizados ou alterares as predefinições.

Por vezes, clica em Atualização força o WooCommerce ou o teu plugin SEO a atualizar o esquema com os dados mais recentes do produto. Após a atualização, testa novamente o URL do produto ativo.

Inconsistências de revisão e classificação

Este problema surge normalmente quando o teu esquema de produto mostra dados de avaliação ou classificação que não correspondem ao que os compradores podem realmente ver na página do produto. Também pode acontecer o contrário: as classificações aparecem na página, mas o teu esquema não as apresenta.

Confirma o que é visível na página do produto em direto

Abre a página do produto no front end e verifica:

• A classificação por estrelas é visível junto ao título?
• Qual é a classificação exacta indicada
• Qual é o número de revisões?
• As avaliações individuais são visíveis com autor e data

O teu esquema deve refletir exatamente o que é visível aqui.

Certifica-te de que as avaliações do WooCommerce estão activadas

No teu painel de controlo:

• Vai a WooCommerce → Definições → Produtos e confirma que a opção Ativar avaliações de produtos está activada.
• Edita o produto e confirma que a opção Ativar avaliações está activada em Dados do produto → Avançadas.
• Verifica a secção de comentários do produto e confirma se existem comentários publicados com classificações de estrelas.

Se as avaliações estiverem desactivadas ao nível da loja ou do produto, os plug-ins não conseguem, muitas vezes, produzir uma marcação de classificação válida.

Mantém o esquema alinhado com o que apresentas

Se tu classificações dos espectáculos na página: O teu plugin SEO ou de esquema deve obter automaticamente a mesma classificação e contagem de avaliações.

Se tu não mostrar classificações na página:

• Desliga qualquer definição de plug-in que force os dados de classificação no esquema do produto.
• Remove qualquer JSON-LD personalizado que adicione classificações.

Não incluas a marcação de classificação, a menos que os visitantes possam ver as classificações na página do produto.

Depois de fazeres as alterações, clica em Atualização para atualizar o resultado do esquema e, em seguida, testa novamente o URL do produto ativo. A tua marcação deve mostrar aggregateRating e revisão ou omite as classificações se não as apresentar.

Lista de controlo rápida

• Comentários activados nas definições do WooCommerce
• Comentários sobre o produto
• Existem críticas publicadas com classificação por estrelas
• A tua ferramenta de esquema não está a injetar classificações que não são visíveis
• A classificação do esquema e a contagem de avaliações correspondem à página do produto

Corrige identificadores em falta ou inválidos

Algumas ferramentas de esquema assinalam identificadores em falta ou inválidos, como SKU, GTIN (GTIN-8, GTIN-12, GTIN-13, GTIN-14), MPN ou marca, especialmente quando produzem esquemas de produtos mais detalhados.

Preencher identificadores no WooCommerce

• SKU: No separador Inventário do produto, adiciona um SKU único.
• Marca: Se o teu tema ou plugin adicionar um campo ou taxonomia de Marca, atribui a marca correta ao produto.
• GTIN ou MPN: Se o teu plugin fornecer campos GTIN ou MPN, introduz os valores no formato esperado (normalmente numérico para GTIN e o comprimento correto).

Verifica o mapeamento dos teus plugins

• Abre as definições do teu plugin SEO ou de esquema para o esquema do produto.
• Procura opções como Utilizar SKU como MPN, Mapear marca a partir da taxonomia ou Ativar identificadores globais.
• Confirma que o plugin está a ler a marca e o GTIN a partir do local certo (taxonomia, atributo de produto ou um campo personalizado).
• Se não tiveres GTINs reais para um produto, é melhor desativar a saída de GTIN do que introduzir valores falsos. Inclui apenas identificadores que sejam exactos para esse produto.

Depois de adicionares identificadores válidos ou desactivares a saída de identificadores, testa novamente o URL do produto ativo e confirma que os erros e avisos do identificador foram resolvidos ou reduzidos.

Conclusão

Adicionar um esquema de produto ao WooCommerce é ajudar os motores de busca a compreender os teus produtos com precisão.

O WooCommerce já te dá um ponto de partida, mas, dependendo da tua loja, podes precisar de o ampliar com um plugin SEO ou JSON-LD personalizado. A chave é manter os dados do produto precisos, evitar esquemas duplicados e garantir que o esquema corresponde ao que os compradores vêem na página.

Quando o teu esquema for válido e testado, monitoriza-o na Consola de Pesquisa do Google e volta a testá-lo após grandes actualizações, especialmente alterações de temas, plugins, preços ou avaliações.

Quando feito corretamente, o esquema de produto torna-se parte da base da tua loja. Ajuda o Google a ler corretamente o teu catálogo, reduz a ambiguidade e dá aos teus produtos uma melhor oportunidade de se destacarem na pesquisa.