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

O que é Schema Markup e que tipos são necessários para avaliações?

Schema Markup é dado estruturado, um bloco de JSON-LD que identifica o que é uma página para que os motores de busca e motores de resposta possam ler o conteúdo sem precisar adivinhar. Numa página de produto, 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 está a preencher: ligar os dados das suas avaliações à marcação de Product para que as estrelas possam aparecer.

Para rich results, o Google precisa de um Product que contenha Review, aggregateRating ou ambos. A regra que apanha a maioria dos lojistas: as avaliações e a nota na marcação têm de 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 apresenta 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 apresenta.
• Review: autor, reviewRating e reviewBody, para avaliações individuais na página.

Como adicionar Schema Markup sem quebrar o tema Shopify

Há três caminhos práticos, cada um com uma troca entre controlo e segurança. Editar o JSON-LD do tema manualmente dá controlo total, mas exige trabalhar em Liquid, onde uma vírgula errada quebra o bloco silenciosamente. Deixar uma aplicação de avaliações injetar o Schema dá menos trabalho, mas herda-se o formato que a aplicação usa, e algumas injetam-no do lado do cliente, onde o rastreador pode não o detetar. Um gerador de Schema fica no meio-termo: cola os valores reais, devolve um JSON-LD válido e insere-se um bloco limpo na página.

Independentemente do caminho escolhido, nunca cole Schema no meio de um bloco JSON-LD existente. Adicione-o como um script independente. No editor do tema, inclua uma secção Liquid 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 guardar, duplique o tema para ter um rollback limpo. Adicione o bloco, guarde e veja o código-fonte da página de produto em produção para confirmar que o JSON-LD está no HTML bruto, e não apenas após a execução dos scripts. Se as suas avaliações são injetadas por uma aplicação depois do carregamento, o padrão mais seguro é que a aplicação renderize do lado do servidor, ou que ligue o resultado do gerador a valores já presentes na página.

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

Como validar e evitar os erros que anulam o Schema silenciosamente

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 em falta. O validador do Schema.org deteta JSON malformado que o teste de rich results às vezes deixa passar. Veja também o código-fonte da página em produção para confirmar que o bloco está no HTML bruto.

A maioria dos Schemas anulados é tecnicamente válida e ainda assim rejeitada, porque descreve algo que a página não apresenta. Os casos clássicos: um aggregateRating sem avaliações apresentadas na página, um número de avaliações na marcação que não corresponde ao número no ecrã, ou marcação de Review numa página que é na verdade uma categoria ou a página inicial, e não um produto individual.

A versão mais profunda deste problema é a legibilidade. Muitas aplicações de avaliações foram construídas para o utilizador na página e ficam-se 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, pelo que 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 pesquisa e na IA é a lacuna que o BeyondReviews foi construído para fechar.

• aggregateRating presente, mas nenhuma avaliação apresentada 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 numa página que não é um produto individual.
• Avaliações presas num widget do lado do cliente que o rastreador não consegue ler.

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

Um Schema Shopify limpo resume-se a três coisas: um bloco Product independente, avaliações reais visíveis na página e uma marcação cujos valores correspondem ao que o utilizador vê. Adicione-o como um script separado para não corromper o tema, gere-o 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. Ignore a regra de correspondência e a marcação é válida e ignorada, o pior dos dois mundos: trabalho feito, nada apresentado.