Novo Módulo - Schema
Patch Notes - Schema
Novo
O módulo Schema injeta automaticamente dados estruturados JSON-LD Schema.org/Product nas páginas de produto da sua loja. Com ele, o Google recebe informações completas sobre preço, disponibilidade, marca, condição do produto, avaliações e política de devolução — aumentando as chances de exibir rich results nos resultados de busca, como estrelas de avaliação e preço em destaque. Tudo configurado pelo painel admin, sem editar templates.
O que o módulo faz
- Injeta um bloco
<script type="application/ld+json">no final de todas as páginas de produto, lido pelo Google via crawling - Exporta nome, imagens (galeria completa), descrição, SKU, marca, MPN, GTIN, condição e disponibilidade do produto
- Suporta três modos de preço: à vista com desconto percentual por atributo (boleto/PIX), preço original ou preço promocional
- Inclui preço riscado (“De:”) com guard automático — nunca exibe o campo quando ele é igual ou menor que o preço principal
- Exporta data de validade do preço (
priceValidUntil) a partir da data do preço promocional ou por número de dias configurado - Inclui
AggregateRatinge até 5 reviews individuais aprovados (nota 4 ou 5 estrelas) a partir das avaliações nativas do Magento - Inclui política de devolução (
hasMerchantReturnPolicy) com prazo mínimo de 7 dias, respeitando o Código de Defesa do Consumidor - Oculta automaticamente o bloco de preço para produtos B2B com
hide_priceativo - Remove campos nulos ou vazios do JSON — o Schema só contém o que tem valor preenchido no produto
Onde fica
Caminho no admin
Sistema → Configuração → Serviços → Schema
Configurações disponíveis
Geral
| Campo | Descrição |
| Habilitar | Liga ou desliga o módulo. Com “Não”, nenhum bloco é injetado nas páginas de produto. |
| Fonte da descrição | Campo do produto usado para preencher o campo description no Schema. Opções: Meta Description, Descrição Resumida ou Descrição Completa. |
Preço
| Campo | Descrição |
| Preço principal a enviar no Schema | Define qual valor vai para o campo price. Opções: Preço à Vista (Boleto/PIX), Preço Original ou Preço Promocional. |
| Atributo de desconto à vista | Atributo do produto que armazena o percentual de desconto à vista. Visível apenas quando o tipo de preço for “Boleto/PIX”. |
| Exibir preço original no Schema | Habilita o envio do preço riscado (“De:”) via priceSpecification. Só aparece quando o valor “De:” for estritamente maior que o preço principal. |
| Preço usado como “De:” | Fonte do valor riscado: Preço Promocional ou Preço Original. Visível apenas quando “Exibir preço original” estiver habilitado. |
| Validade do preço | Fonte da data priceValidUntil: data do preço promocional até (com fallback por dias) ou sempre calcular a partir de hoje somando os dias configurados. |
| Dias de validade | Número de dias somados à data atual para calcular priceValidUntil quando a data promocional não está disponível. |
Atributos do Produto
| Campo | Descrição |
| Marca | Atributo do produto para preencher o campo brand.name no Schema. Omitido se não estiver configurado ou sem valor. |
| MPN | Atributo para o campo mpn (número de peça do fabricante). Omitido se não estiver configurado ou sem valor. |
| GTIN / EAN | Atributo para o campo gtin13. Omitido se não estiver configurado ou sem valor. |
| Condição do Produto | Atributo para o campo itemCondition. Valores reconhecidos: novo, usado, recondicionado. Padrão quando não identificado: NewCondition. |
Avaliações
| Campo | Descrição |
| Incluir Avaliações de Produtos | Habilita o nó aggregateRating. Se o produto não atingir o número mínimo de avaliações aprovadas, o campo é omitido automaticamente. |
| Número mínimo de avaliações | Produtos com menos avaliações aprovadas do que este valor não terão aggregateRating no Schema. |
| Incluir Reviews Individuais | Habilita até 5 reviews individuais no Schema. Apenas avaliações aprovadas com nota 4 ou 5 estrelas são incluídas. Requer “Incluir Avaliações de Produtos” ativo. |
Política de Devolução
| Campo | Descrição |
| Incluir Política de Devolução | Habilita o nó hasMerchantReturnPolicy com valores para o mercado brasileiro (ReturnByMail, FreeReturn, país BR). |
| Prazo de devolução (dias) | Número de dias para devolução. Valores menores que 7 são substituídos automaticamente por 7, em conformidade com o Código de Defesa do Consumidor. |
Principais vantagens
- Melhora a visibilidade nos resultados de busca com rich results de preço, avaliações e disponibilidade
- Configuração 100% pelo painel admin — sem editar templates ou arquivos PHP
- Suporte a preço à vista com desconto percentual configurável por atributo de produto
- Guard automático no preço riscado: nunca exibe “De:” igual ou menor que o preço principal
- Reviews individuais priorizando avaliações de 5 estrelas, ignorando reviews sem texto
- Compatível com produtos B2B: oculta o bloco de preço quando
hide_priceestá ativo - Prazo de devolução com mínimo de 7 dias aplicado automaticamente, garantindo conformidade com o CDC
Quer essa funcionalidade na sua loja?
Entre em contato com a equipe mageshop e saiba como ativar o módulo Schema.
Fale com a mageshop