Como Adicionar Schema Markup no Shopify (Sem Quebrar o Tema)

O que é Schema Markup e o que o Shopify já inclui por padrão?

Schema Markup é dado estruturado, um bloco de JSON-LD que identifica o que é uma página para que os mecanismos de busca e motores de resposta possam ler o conteúdo sem precisar adivinhar. Em uma página de produto, ele informa: isto é um Product, aqui está o preço, aqui está a classificação, aqui estão as avaliações. O Google usa esses dados para exibir a classificação por estrelas, o preço e a disponibilidade abaixo do seu resultado.

Os temas Shopify já incluem alguns dados estruturados, geralmente um bloco básico de Product, mas raramente incluem Review ou aggregateRating, porque o tema não tem avaliações próprias para descrever. É essa lacuna que você está preenchendo: conectar os dados das suas avaliações ao marcação de Product para que as estrelas possam aparecer.

Quais tipos de Schema são necessários para avaliações de produto?

Para rich results, o Google precisa de um Product que contenha Review, aggregateRating ou ambos. O bloco Product traz nome, imagem e ofertas. O aggregateRating traz a média e o número de avaliações. Cada Review traz autor, nota e o texto da avaliação.

A regra que pega a maioria dos lojistas: as avaliações e a nota na marcação precisam estar visíveis na página. Não é possível marcar um aggregateRating de 4,8 com 200 avaliações se a página não exibe nenhuma delas. O Google interpreta isso como enganoso e remove o rich result da página inteira.

• Product: nome, imagem e ofertas (preço, moeda, disponibilidade).
• aggregateRating: ratingValue e reviewCount, correspondendo ao que a página exibe.
• Review: autor, reviewRating e reviewBody, para avaliações individuais na página.

Editar o tema, usar um aplicativo ou um gerador: qual é o melhor caminho?

Há três caminhos práticos, cada um com uma troca entre controle e segurança. Editar o JSON-LD do tema à mão dá controle total, mas exige mexer em Liquid (a linguagem de templates do Shopify), onde uma vírgula errada quebra o bloco silenciosamente. Deixar um aplicativo de avaliações injetar o Schema dá menos trabalho, mas você herda o formato que o aplicativo usa, e alguns injetam o Schema pelo lado do cliente, onde o rastreador pode não enxergar. Um gerador de Schema fica no meio-termo: você cola os valores reais, ele devolve um JSON-LD válido e você insere um bloco limpo na página.

Se você não se sente confortável em código de tema, comece pelo gerador. É o caminho de menor risco para colocar um bloco correto na página, e você pode colar a saída diretamente em uma seção Liquid personalizada sem reescrever o tema.

• JSON-LD do tema: mais controle, maior risco de quebra silenciosa de sintaxe.
• Injeção por aplicativo: menos trabalho, mas verifique se renderiza no código-fonte da página, não só no navegador.
• Gerador de Schema: cole os valores reais, obtenha JSON-LD validado, insira um único bloco.

Como adicionar Schema Markup sem quebrar o tema Shopify?

Nunca cole Schema no meio de um bloco JSON-LD existente. Adicione como um script independente. No editor do tema, inclua uma seção de Liquid (templates do Shopify) personalizada (ou edite o template de produto) e coloque um novo script do tipo application/ld+json com o seu bloco Product. Mantendo-o separado, um erro no seu bloco não pode corromper o bloco do tema, e vice-versa.

Antes de salvar, duplique o tema para ter um rollback limpo. Adicione o bloco, salve e veja o código-fonte da página de produto ao vivo para confirmar que o JSON-LD está no HTML bruto, não só após a execução dos scripts. Se as suas avaliações são injetadas por um aplicativo depois do carregamento, o padrão mais seguro é que o aplicativo renderize do lado do servidor, ou que você vincule a saída do gerador a valores já impressos na página.

Como validar o Schema Markup e identificar erros?

Execute cada template de produto por duas verificações: o Rich Results Test do Google para elegibilidade e o validador do Schema.org para sintaxe. O Rich Results Test indica se o Product é elegível para estrelas e aponta campos obrigatórios ausentes. O validador do Schema.org detecta JSON malformado que o teste de rich results às vezes passa por alto.

O erro que você verá com mais frequência não é de sintaxe. É um aviso de que a nota não tem avaliações visíveis, ou de que os valores marcados não batem com a página. É a regra da divergência de novo. Corrija fazendo a marcação descrever exatamente o que o cliente pode ver, depois revalide antes de seguir em frente.

• Rich Results Test: confirma a elegibilidade do Product e lista campos ausentes.
• Validador do Schema.org: detecta JSON malformado que o teste de rich results pode não capturar.
• Veja o código-fonte da página ao vivo: confirme que o bloco está no HTML bruto.

Quais erros invalidam o Schema Markup silenciosamente?

A maioria dos Schemas anulados é tecnicamente válida e ainda assim rejeitada, porque descreve algo que a página não exibe. Os casos clássicos: um aggregateRating sem avaliações renderizadas na página, um número de avaliações na marcação que não bate com o número na tela, ou marcação de Review em uma página que é na verdade uma categoria ou a página inicial, e não um produto individual.

A versão mais profunda desse problema é a legibilidade. Muitos aplicativos de avaliações foram construídos para o cliente na página e param por aí: as estrelas aparecem corretamente no navegador, mas o texto e a nota das avaliações ficam presos dentro de um Widget que os rastreadores e motores de resposta não conseguem ler, então a marcação descreve um conteúdo que a máquina nunca vê. Tornar as suas avaliações legíveis, verificáveis e citáveis na busca e na IA é a lacuna que o BeyondReviews foi construído para fechar.

• aggregateRating presente, mas nenhuma avaliação renderizada na página.
• Número ou média de avaliações na marcação não corresponde aos números visíveis.
• Markup de Product ou Review em uma página que não é um produto individual.
• Avaliações presas em um Widget do lado do cliente que o rastreador não consegue ler.

O que é necessário para o Schema funcionar de verdade

Um Schema Shopify limpo se resume a três coisas: um bloco Product independente, avaliações reais visíveis na página e um marcação cujos valores batem com o que o cliente vê. Adicione como um script separado para não corromper o tema, gere a partir dos seus números reais em vez de digitar manualmente e valide cada template antes de considerar concluído.

Faça isso e as estrelas, o preço e o número de avaliações ficam elegíveis para aparecer no seu resultado do Google. Pule a regra de correspondência e a marcação é válido e ignorado, o pior dos dois mundos: trabalho feito, nada exibido.