Gerador de schema de produto

Como gerar o schema de produto

Três propriedades obrigatórias no produto, duas na oferta e um punhado de regras que decidem se a listagem aparece. O gerador confere cada uma enquanto você digita e escreve o bloco visível a partir dos mesmos valores.

1. Dê nome ao produto e adicione as imagens. name e image são obrigatórios na listagem do comerciante. A mesma foto em várias proporções vale mais que uma só, e toda URL precisa ser rastreável e indexável.
2. Preencha a oferta com o preço à vista. Um preço maior que zero, com ponto decimal e sem R$, e o código BRL. É isso que transforma um Product em algo que o Google pode listar como à venda. Parcelas ficam fora do price.
3. Defina a disponibilidade e a validade do preço. availability e itemCondition saem com os nomes curtos, que o Google aceita. Deixe priceValidUntil em branco em vez de esquecer uma data vencida nele.
4. Aponte para as políticas em vez de copiá-las. Marque frete e devolução uma vez, na Organization, e referencie esses nós aqui pelo @id. O Google recomenda a política global em vez de uma cópia em cada oferta.
5. Cole as duas saídas. O JSON-LD vai na página do produto. O bloco visível, com rótulos em português, traz exatamente o preço, a disponibilidade e os códigos que a marcação declara — que é a regra que a marcação precisa cumprir de qualquer jeito.

Três propriedades no produto, duas na oferta

Um gerador de schema de produto transforma os dados de um produto em JSON-LD Product e Offer — os dados estruturados que o Google lê para preço, disponibilidade e identificadores como o EAN. A lista do que é obrigatório é curta e vale decorar, porque quase tudo o que os geradores exigem não está nela.

O resto — brand, sku, gtin, description, availability, itemCondition, priceValidUntil, aggregateRating — é recomendado. Recomendado não quer dizer enfeite: a descrição o Google chama de altamente recomendável, e um identificador é o que liga a sua página ao mesmo produto no marketplace e no comparador de preços. Mas um gerador que não entrega nada enquanto você não preenche catorze campos está impondo o formulário dele, não as regras do Google.

Qual preço vai no price: o à vista, em BRL, com ponto

No Brasil, a lei já escolheu o preço principal. A Lei 10.962/2004 manda o comércio eletrônico divulgar de forma ostensiva o preço à vista, junto à imagem do produto, em fonte não inferior a doze (art. 2º, III). O Decreto 5.903/2006 completa: o preço se informa discriminando o total à vista; no parcelamento, também o total financiado, o número, a periodicidade e o valor das prestações, os juros e os encargos (art. 3º) — e informar o preço apenas em parcelas é infração (art. 9º, IV). É esse preço à vista que vai em price.

O formato é o avesso do brasileiro. As diretrizes de uso do schema.org, que o Google manda seguir, pedem ponto decimal, nenhum símbolo como separador de milhar e a moeda em priceCurrency, fora do valor:

Na página:   R$ 1.299,90 à vista
      No JSON-LD:  "price": "1299.90", "priceCurrency": "BRL"

A armadilha é o ponto de milhar. 1.299,90 e R$ 1299 o gerador recusa; 1.299 passa — é um número válido, e vale um real e 299 milésimos.

Parcelamento não tem para onde ir no JSON-LD. Nas propriedades de preço que o Google documenta para a listagem do comerciante, priceType só aceita StrikethroughPrice, referenceQuantity é preço por unidade de medida e validForMemberTier é preço de fidelidade; nenhuma descreve prestações, e o valor Installment do schema.org fica fora da lista. O 10x sem juros o Google lê no Merchant Center: o atributo [installment] vale no Brasil para anúncios do Shopping e listagens gratuitas, em todas as categorias, não tem propriedade schema.org correspondente e precisa bater com o parcelamento da página de destino. No feed, 10 parcelas de R$ 129,99 viram 10:129.99 BRL; entrada não é aceita na América Latina, e [price] segue sendo o pagamento à vista.

Desconto no Pix ou no boleto também não tem propriedade própria. A Lei 13.455/2017 autoriza preço diferente por prazo ou forma de pagamento, desde que o desconto esteja visível (art. 5º-A da Lei 10.962): marque em price o preço que a página apresenta como o preço do produto e deixe o desconto no texto. Para o Brasil, o Merchant Center pede o mesmo — preço com impostos incluídos e igual ao da página de destino.

E duas regras do Google que o gerador trata como erro: zero não é preço, então um "sob consulta" gravado como 0 desqualifica a oferta; e um priceValidUntil no passado pode fazer as informações do produto nem aparecerem. Em promoção, o preço atual fica em price, o original vai numa UnitPriceSpecification com priceType igual a StrikethroughPrice, e o preço ativo nunca leva priceType.

EAN, marketplace e a nota que não é sua

O gtin liga a sua página ao mesmo produto em qualquer outro lugar. O EAN-13 do código de barras é um GTIN de 13 dígitos, e os prefixos que a GS1 Brasil atribui são 789 e 790 — que indicam onde o código foi registrado, não onde o produto foi fabricado.

• Só dígitos. O Google aceita o GTIN numérico, de 8, 12, 13 ou 14 dígitos, nunca em forma de URL. O gerador escreve a propriedade genérica gtin; se preferir a mais específica, que o Google recomenda, troque por gtin13.
• Código de fonte oficial. A GS1 Brasil avisa que código comprado de fonte não autorizada pode estar duplicado e ser rejeitado por varejistas e marketplaces.
• A nota do marketplace fica no marketplace. O Google manda não coletar avaliações nem classificações de outros sites: a média do seu anúncio no Mercado Livre, na Shopee ou na Amazon é da página deles. No seu site, só as notas dos compradores da sua loja, com ratingCount — média sem contagem não é nota agregada.
• Vírgula só na tela. O leitor vê 4,7; o JSON-LD quer 4.7, e o gerador recusa a vírgula.

Para roupa e calçado, um detalhe pouco usado: a documentação do Google lista WearableSizeSystemBR, o sistema de tamanhos do Brasil, entre os valores de sizeSystem. Não está neste formulário, mas cabe no mesmo nó Product. As regras de quais notas você pode marcar estão no gerador de schema de avaliação.

Frete e devolução: uma política na Organization, com os 7 dias do CDC

shippingDetails e hasMerchantReturnPolicy aparecem como obrigatórios em muito conselho por aí. Na documentação do Google, são recomendados — e o Google prefere uma política global na Organization, referenciada na oferta só pelo @id, deixando a cópia dentro da Offer para o produto que foge da regra geral. É o que os dois campos deste formulário geram.

A devolução tem piso em lei. O Código de Defesa do Consumidor dá 7 dias para desistir de uma compra feita fora do estabelecimento comercial, contados do recebimento do produto, com devolução imediata do que foi pago (art. 49), e o Decreto 7.962/2013 obriga a loja online a informar com clareza como exercer esse direito de arrependimento (art. 5º). Na marcação da Organization, fica assim:

"hasMerchantReturnPolicy": {
        "@type": "MerchantReturnPolicy",
        "@id": "https://www.exemplo.com.br/trocas-e-devolucoes#politica",
        "applicableCountry": "BR",
        "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
        "merchantReturnDays": 7
      }

applicableCountry e returnPolicyCategory são obrigatórias; com prazo finito, merchantReturnDays também, e o Google conta os dias a partir da entrega. Se a loja dá 30 dias, escreva 30 — abaixo de 7, o markup descreveria menos que o direito de arrependimento. O frete tem a mesma contrapartida: o Decreto 7.962/2013 exige que o site mostre em destaque despesas adicionais como a entrega, as formas de pagamento e o prazo (art. 2º), e a marcação só repete isso para as máquinas. Loja física com retirada é outro nó: veja o gerador de schema de empresa local.