Use a marcação de dados estruturados nas páginas de destino do produto para ajudar o Google a recuperar informações atualizadas sobre itens e ofertas do seu site. Qualquer marcação de dados estruturados compatível com o Merchant Center terá atributos e valores correspondentes que são aceitos, conforme listado na especificação dos dados do produto. Seus dados estruturados precisam coincidir com os valores e atributos correspondentes.
Nesta página:
Atributos e anotações do schema.org
Os atributos são uma das maneiras de organizar os dados de produtos enviados ao Merchant Center. Cada um dos atributos contém uma informação sobre o item, como o título ou a descrição dele. A correspondência adequada dos valores do schema.org com os atributos da especificação dos dados do produto vai resultar em menos erros ao validar o feed.
Observação: se você usar as atualizações automáticas de itens, especifique as propriedades de schema.org price, priceCurrency, availability e condition para aumentar a precisão. Saiba mais sobre as atualizações automáticas de itens.
|
Atributo dos dados de produtos
|
Tipo e descrição | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Os atributos a seguir são do tipo Product do schema.org. |
|||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
| URL | |||||||||||||||||||||||||||||
|
Texto Uma SKU principal, necessária para agrupar todas as variantes de produtos do mesmo grupo. |
|||||||||||||||||||||||||||||
|
Texto O GTIN que identifica seu produto. Especifique apenas uma dessas propriedades de schema.org. Quando você usa valores GTIN, eles precisam ter o comprimento correto e conter o dígito de verificação certo. |
|||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
|
Texto Use a propriedade |
|||||||||||||||||||||||||||||
|
Texto Use a propriedade
|
|||||||||||||||||||||||||||||
|
E |
Número (em anos) Use a propriedade Os valores válidos são aqueles definidos pelo atributo de idade
|
||||||||||||||||||||||||||||
| Texto | |||||||||||||||||||||||||||||
|
OU |
Texto Use a propriedade |
||||||||||||||||||||||||||||
|
Texto Use a propriedade Os valores válidos são do tipo
|
|||||||||||||||||||||||||||||
|
Texto Use a propriedade Os valores válidos são do tipo WearableSizeSystemEnumeration. Eles são mapeados para valores de feed desta maneira:
|
|||||||||||||||||||||||||||||
|
Use a propriedade |
|||||||||||||||||||||||||||||
|
Use a propriedade |
|||||||||||||||||||||||||||||
|
Use a propriedade |
|||||||||||||||||||||||||||||
|
Use a propriedade |
|||||||||||||||||||||||||||||
|
As propriedades de schema.org a seguir são do tipo "Offer", que precisam ser aninhadas em |
|||||||||||||||||||||||||||||
| Um URL válido para seu produto. | |||||||||||||||||||||||||||||
|
OU: |
[price]: número. Enviado sem símbolos de moeda, espaços ou separadores de milhares (por exemplo, "1498.99"). [priceCurrency]: texto. Enviado no formato ISO 4217 com três letras (por exemplo, USD, GBP e EUR). A moeda precisa atender aos requisitos de idioma e moeda do país de destino. Observação: price e priceCurrency podem ser enviados diretamente na instância Offer ou indiretamente por uma propriedade priceSpecification de tipo UnitPriceSpecification. Quando sale_price é especificado, price precisa ser incluído usando uma propriedade priceSpecification com priceSpecification.priceType="ListPrice". O atributo preço promocional [sale_price] pode ser especificado diretamente na oferta ou em uma propriedade priceSpecification do tipo UnitPriceSpecification sem um priceSpecification.priceType. |
||||||||||||||||||||||||||||
|
Os valores válidos são do tipo
|
|||||||||||||||||||||||||||||
|
Os valores válidos são do tipo
|
|||||||||||||||||||||||||||||
| Um URL válido para finalização da compra do seu produto. | |||||||||||||||||||||||||||||
Exemplos com JSON-LD
Produto único
Exemplo
O exemplo a seguir mostra um produto básico com um conjunto mínimo de propriedades.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
}
O exemplo a seguir mostra como especificar o tipo e o sistema de tamanhos usando o schema.org. O exemplo especifica o tamanho dos EUA "XL" para uma camiseta azul destinada a adultos (pessoas com mais de 13 anos) no departamento de moda masculina "Big&Tall".
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "12345",
"image": "https://www.example.com/tshirt.jpg",
"name": "Classic T-Shirt",
"description": "All-cotton t-shirt in classic cut",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"material": "cotton",
"color": "blue",
"size": {
"@type": "SizeSpecification",
"name": "XL",
"sizeSystem": "https://schema.org/WearableSizeSystemUS",
"sizeGroup": [
"https://schema.org/WearableSizeGroupBig",
"https://schema.org/WearableSizeGroupTall"
]
},
"audience": {
"@type": "PeopleAudience",
"suggestedGender": "male",
"suggestedMinAge": 13
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/tshirt",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 24.99,
"priceCurrency": "USD"
}
}
Vários produtos não relacionados em uma página de destino
Quando sua página reúne vários produtos não relacionados e cada um tem a própria anotação de dados estruturados, todas as anotações precisam conter informações que identifiquem o produto a que se referem.
Por exemplo, recomendamos enviar a SKU (atributo código [id]) ou GTIN (atributo GTIN [gtin]) em cada anotação. Se você não enviar essas informações, talvez os itens na página de destino não correspondam aos dados estruturados do produto. Saiba mais como configurar dados estruturados nas páginas de destino.
Exemplo
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 39.99,
"priceCurrency": "USD"
}
},
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "racket-12345",
"image": "https://www.example.com/racket.jpg",
"name": "Nice racket",
"description": "Racket for Tennis",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/racket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 59.99,
"priceCurrency": "USD"
}
}
]Preço promocional
O exemplo a seguir ilustra um produto básico com um preço promocional. Para indicar um preço promocional, especifique também o preço de tabela original, que é definido na propriedade /priceType.
Exemplo
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": 10.00,
"priceCurrency": "USD",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
}
}
Se /UnitPriceSpecification for usado para o preço normal, a codificação simples contém dois /UnitPriceSpecification:
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": [
{
"@type": "UnitPriceSpecification",
"price": 10.00,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": 15.00,
"priceCurrency": "USD"
}
]
}
}
Frete
Para especificar os custos de frete (recomendado) do seu produto, use o tipo de Schema.org OfferShippingDetails que precisa ser aninhado em uma oferta usando a propriedade shippingDetails e os mapas que fazem parte do atributo frete [shipping] na especificação dos dados do produto. É possível enviar várias propriedades shippingDetails.
|
Atributo dos dados de produtos
|
Tipo e descrição |
|---|---|
Os atributos a seguir são do tipo OfferShippingDetails do schema.org. |
|
|
|
Texto Código do país ISO 3166-1 com dois dígitos Use a propriedade |
|
Texto Código de subdivisão ISO 3166-2 de dois ou três dígitos sem o prefixo do país. Compatível apenas com os seguintes países: Austrália, EUA ou Japão. Exemplos: "NY", "NSW" ou "03". Use a propriedade |
|
|
Use a propriedade |
|
|
Número (não negativo e inteiro) Esse valor especifica o tempo em dias úteis entre o momento em que um pedido é feito e o momento em que ele é entregue à transportadora. O tempo em separação especifica o intervalo de tempo entre o momento em que um pedido é feito e o momento em que ele é entregue à transportadora. O tempo em trânsito especifica o intervalo de tempo entre o envio do produto para a transportadora e o momento em que ele é entregue ao cliente. Use a propriedade |
|
Exemplo
O exemplo a seguir mostra como especificar as informações de frete usando o schema.org. O exemplo especifica um custo de frete de USD 3,49 para os seguintes estados dos EUA: Arizona, Califórnia e Nevada. O tempo em separação leva de 0 a 1 dia útil, e o tempo em trânsito de 1 a 5 dias úteis.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US",
"addressRegion": [ "CA", "NV", "AZ" ]
},
"shippingRate": {
"@type": "MonetaryAmount",
"value": 3.49,
"currency": "USD"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
}
}
}
Devoluções
Para especificar o período de devolução e o custo do produto, use o tipo MerchantReturnPolicy do schema.org, que precisa ser aninhado em Offer usando a propriedade hasMerchantReturnPolicy.
|
Atributo dos dados de produtos
|
Tipo e descrição |
|---|---|
| As propriedades de schema.org a seguir são do tipo MerchantReturnPolicy, que precisam ser aninhadas em um produto usando a propriedade Offers. Confira os exemplos abaixo. | |
| applicableCountry |
Código do país ISO 3166-1 alfa-2 com duas letras (por exemplo, "US"). Código do país ISO 3166-1 alfa-3 com três letras (por exemplo, "USA") Um país a que se aplica uma política de devolução específica do comerciante. Ele pode ser diferente do país de origem do produto. É possível especificar até 50 países. |
|
Os valores válidos são do tipo MerchantReturnEnumeration. Se especificado como MerchantReturnFiniteReturnWindow ou MerchantReturnUnlimitedWindow, recomenda-se returnMethod e returnShippingFeesAmount. Além disso, se especificado como MerchantReturnFiniteReturnWindow, o merchantReturnDays é obrigatório. |
|
| merchantReturnDays |
O número de dias (a partir da data de entrega) que um produto pode ser devolvido. |
| returnMethod |
Os valores válidos são do tipo ReturnMethodEnumeration:
|
| returnFees | O valor válido é FreeReturn do tipo ReturnFeesEnumeration. |
| returnShippingFeesAmount |
Informações sobre o custo do frete para devoluções do produto. |
Exemplo
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Nice trinket",
"description": "Trinket with clean lines",
"brand": {
"@type": "Brand",
"name": "MyBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 39.99,
"priceCurrency": "USD"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": 2.99,
"currency": "USD"
},
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1,
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5,
"unitCode": "DAY"
}
}
},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"applicableCountry": "US",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"merchantReturnDays": 60,
"returnMethod": "https://schema.org/ReturnByMail",
"returnFees": "https://schema.org/FreeReturn"
}
}
}
Eficiência energética
O schema.org aceita a rotulagem de produtos que têm eficiência energética usando o tipo EnergyConsumptionDetails, que pode ser especificado para um produto que usa a propriedade EnergyConsumptionDetails.
|
Atributo dos dados de produtos
|
Tipo e descrição |
|---|---|
As propriedades de schema.org a seguir são do tipo EnergyConsumptionDetails. |
|
|
Os valores válidos são do tipo |
|
|
classe de eficiência energética mínima |
Adicione à instância de EnergyConsumptionDetails que foi usada para especificar o atributo de classe de eficiência energética [energy_efficiency_class]. Depois disso, use a mesma tabela de mapeamento para selecionar o valor. Se a instância não for informada e energy_efficiency_class for especificado, o valor EUEnergyEfficiencyCategoryG será presumido. |
|
classe de eficiência energética máxima |
Adicione à instância de EnergyConsumptionDetails que foi usada para especificar o atributo de classe de eficiência energética [energy_efficiency_class]. Depois disso, use a mesma tabela de mapeamento para selecionar o valor. Se a instância não for informada e energy_efficiency_class for especificado, o valor EUEnergyEfficiencyCategoryA3Plus será presumido. |
Os valores energyEfficiencyScale, energyEfficiencyScaleMin e energyEfficiencyScaleMax são do tipo de enumeração EUEnergyEfficiencyEnumeration do schema.org e são mapeados para os valores dos três atributos de eficiência energética na especificação dos dados do produto conforme mostrado abaixo.
| Valor da especificação dos dados do produto | Valor de enumeração do schema.org do tipo EUEnergyEfficiencyEnumeration type |
|---|---|
A+++ |
EUEnergyEfficiencyCategoryA3Plus |
A++ |
EUEnergyEfficiencyCategoryA2Plus |
A+ |
EUEnergyEfficiencyCategoryA1Plus |
A |
EUEnergyEfficiencyCategoryA |
B |
EUEnergyEfficiencyCategoryB |
C |
EUEnergyEfficiencyCategoryC |
D |
EUEnergyEfficiencyCategoryD |
E |
EUEnergyEfficiencyCategoryE |
F |
EUEnergyEfficiencyCategoryF |
G |
EUEnergyEfficiencyCategoryG |
Exemplo
O exemplo a seguir mostra como especificar as informações de eficiência energética usando o schema.org. No exemplo, especificamos a classe de eficiência energética "C" da UE com a escala de "A+" a "F" para um aquecedor de água.
{ "@context": "https://schema.org/", "@type": "Product", "sku": "1234-5678", "image": "https://www.example.com/waterheater.jpg", "name": "Aquecedor de água", "description": "Aquecedor de água com grande capacidade", "gtin": "12345678901231", "mpn": "WH1234", "brand": { "@type": "Brand", "name": "ExampleWaterHeaterBrand" },
"hasEnergyConsumptionDetails": {
"hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
"energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
}, "offers": { "@type": "Offer", "url": "https://www.example.com/hotwaterheater", "itemCondition": "https://schema.org/NewCondition", "availability": "https://schema.org/InStock", "price": 1799.00, "priceCurrency": "EUR" }}Preço por unidade
O Schema.org aceita o preço unitário de produtos com a propriedade referenceQuantity no tipo UnitPriceSpecification, enviado usando a propriedade priceSpecification na oferta. Ao definir o preço unitário, especifique também o preço e a moeda do produto usando a propriedade priceSpecification, em vez de usar diretamente as propriedades price e priceCurrency.
|
Atributo dos dados de produtos
|
Tipo e descrição |
|---|---|
As propriedades do schema.org a seguir são do tipo UnitPriceSpecification. |
|
|
Especifique a medida de preço unitário usando uma propriedade Use a propriedade |
|
|
Especifique a medida base de preços unitários usando uma propriedade Use a propriedade |
|
Exemplo
O exemplo a seguir mostra um preço de € 3,99 por um saco de arroz de 5 KG com um preço padronizado preferencial por 1 KG. Isso significa que ele pode ser mostrado aos consumidores com um preço unitário de € 0,80/quilo.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "basrice12345",
"image": "https://www.example.com/rice.jpg",
"name": "Basmati rice",
"description": "Large bag of Organic Basmati white rice, 5 Kilogram",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "ExampleRiceBrand"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/basrice1kg",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 3.99,
"priceCurrency": "EUR",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 5,
"unitCode": "KGM",
"valueReference": {
"value": 1,
"unitCode": "KGM"
}
}
}
}
}
Testar sua marcação
Para testar a implementação de schema.org com a ferramenta Pesquisa aprimorada, consulte o relatório para dados estruturados de "Listagens do Merchant". Confira como usar a ferramenta para depurar problemas e interpretar os resultados na Central de Ajuda do Google Search Console. Saiba mais sobre os dados estruturados do produto.
Requisitos para a marcação de dados estruturados
- A marcação de dados estruturados precisa estar no HTML retornado do servidor da Web. Essa marcação não pode ser gerada com JavaScript após o carregamento da página.
- Sua página de destino não pode ser alterada com base nas informações sobre o cliente, por exemplo, para adaptar os preços de acordo com o endereço IP ou o tipo de navegador.
- Os dados estruturados precisam ser iguais aos valores exibidos para o cliente. Fornecer dados incorretos na página de destino é uma violação das diretrizes para desenvolvedores da Web.
- O Google recomenda o uso de JSON-LD para os dados estruturados.