Dados estruturados das informações do produto do comerciante (Product, Offer)

apresentação do Painel de informações do Shopping nos resultados da pesquisa

Quando você adiciona a marcação Product à sua página, ela pode se qualificar para exibição em experiências com produto do comerciante na Pesquisa Google, incluindo o Painel de informações do Shopping, o Imagens do Google, os resultados de produtos mais procurados e os snippets de produtos. As informações do produto do comerciante podem destacar dados mais específicos sobre um produto, como preço, disponibilidade e informações de frete e devolução.

Este guia se concentra nos requisitos de dados estruturados de Product para informações do produto do comerciante. Se você não souber qual marcação usar, leia nossa introdução à marcação Product.

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplos

Os exemplos a seguir ilustram como incluir dados estruturados nas suas páginas da Web para diferentes situações.

Página do produto com uma oferta

Veja um exemplo de página de produto que vende um item com avaliações do produto.

JSON-LD


 <html>
  <head>
    <title>Executive Anvil</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "name": "Executive Anvil",
      "image": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "description": "Sleeker than ACME's Classic Anvil, the Executive Anvil is perfect for the business traveler looking for something to drop from a height.",
      "sku": "0446310786",
      "mpn": "925872",
      "brand": {
        "@type": "Brand",
        "name": "ACME"
      },
      "review": {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": 4,
          "bestRating": 5
        },
        "author": {
          "@type": "Person",
          "name": "Fred Benson"
        }
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 4.4,
        "reviewCount": 89
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/anvil",
        "priceCurrency": "USD",
        "price": 119.99,
        "priceValidUntil": "2024-11-20",
        "itemCondition": "https://schema.org/UsedCondition",
        "availability": "https://schema.org/InStock"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div typeof="schema:Product">
        <div rel="schema:review">
          <div typeof="schema:Review">
            <div rel="schema:reviewRating">
              <div typeof="schema:Rating">
                <div property="schema:ratingValue" content="4"></div>
                <div property="schema:bestRating" content="5"></div>
              </div>
            </div>
            <div rel="schema:author">
              <div typeof="schema:Person">
                <div property="schema:name" content="Fred Benson"></div>
              </div>
            </div>
          </div>
        </div>
        <div rel="schema:image" resource="https://example.com/photos/4x3/photo.jpg"></div>
        <div property="schema:mpn" content="925872"></div>
        <div property="schema:name" content="Executive Anvil"></div>
        <div property="schema:description" content="Sleeker than ACME's Classic Anvil, the Executive Anvil is perfect for the business traveler looking for something to drop from a height."></div>
        <div rel="schema:image" resource="https://example.com/photos/1x1/photo.jpg"></div>
        <div rel="schema:brand">
          <div typeof="schema:Brand">
            <div property="schema:name" content="ACME"></div>
          </div>
        </div>
        <div rel="schema:aggregateRating">
          <div typeof="schema:AggregateRating">
            <div property="schema:reviewCount" content="89"></div>
            <div property="schema:ratingValue" content="4.4"></div>
          </div>
        </div>
        <div rel="schema:offers">
          <div typeof="schema:Offer">
            <div property="schema:price" content="119.99"></div>
            <div property="schema:availability" content="https://schema.org/InStock"></div>
            <div property="schema:priceCurrency" content="USD"></div>
            <div property="schema:priceValidUntil" datatype="xsd:date" content="2024-11-20"></div>
            <div rel="schema:url" resource="https://example.com/anvil"></div>
            <div property="schema:itemCondition" content="https://schema.org/UsedCondition"></div>
          </div>
        </div>
        <div rel="schema:image" resource="https://example.com/photos/16x9/photo.jpg"></div>
        <div property="schema:sku" content="0446310786"></div>
      </div>
  </body>
</html>

Microdados


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
  <div>
    <div itemtype="https://schema.org/Product" itemscope>
      <meta itemprop="mpn" content="925872" />
      <meta itemprop="name" content="Executive Anvil" />
      <link itemprop="image" href="https://example.com/photos/16x9/photo.jpg" />
      <link itemprop="image" href="https://example.com/photos/4x3/photo.jpg" />
      <link itemprop="image" href="https://example.com/photos/1x1/photo.jpg" />
      <meta itemprop="description" content="Sleeker than ACME's Classic Anvil, the Executive Anvil is perfect for the business traveler looking for something to drop from a height." />
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://example.com/anvil" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="itemCondition" content="https://schema.org/UsedCondition" />
        <meta itemprop="price" content="119.99" />
        <meta itemprop="priceValidUntil" content="2024-11-20" />
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <meta itemprop="ratingValue" content="4.4" />
      </div>
      <div itemprop="review" itemtype="https://schema.org/Review" itemscope>
        <div itemprop="author" itemtype="https://schema.org/Person" itemscope>
          <meta itemprop="name" content="Fred Benson" />
        </div>
        <div itemprop="reviewRating" itemtype="https://schema.org/Rating" itemscope>
          <meta itemprop="ratingValue" content="4" />
          <meta itemprop="bestRating" content="5" />
        </div>
      </div>
      <meta itemprop="sku" content="0446310786" />
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="ACME" />
      </div>
    </div>
  </div>
  </body>
</html>

Preços

Veja dois exemplos de codificação de preço em JSON-LD.

Especifique um preço usando a propriedade price da seguinte maneira:

"offers": {
  "@type": "Offer",
  "price": 10.00,
  "priceCurrency": "USD",
  ...
}

Como alternativa, é possível especificar um preço usando a propriedade priceSpecification.

"offers": {
  "@type": "Offer",
  "priceSpecification": {
    "@type": "UnitPriceSpecification",
    "price": 10.00,
    "priceCurrency": "USD"
  },
  ...
}

Preços com medidas de preço unitário

Veja um exemplo de como especificar um preço para 4,5 L de um produto que é sempre vendido em múltiplos de 750 mL. Esse tipo de preço é particularmente importante na UE para produtos vendidos por volume ou peso.

Quando a medida de preço unitário e a medida base de preço unitário estiverem presentes, especifique o preço dentro de UnitPriceSpecification.

"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 81.00,
"priceCurrency": "EUR",
"referenceQuantity": {
  "@type": "QuantitativeValue",
  "value": "4.5",
  "unitCode": "LTR",
  "valueReference": {
    "@type": "QuantitativeValue",
    "value": "750",
    "unitCode": "MLT"
  }
}
}

Detalhes do frete

Veja um exemplo de página de um produto com detalhes de frete. Este exemplo resultaria em uma taxa de frete de $3.49 para todos os usuários que moram nos EUA. Para mais exemplos, consulte a seção Frete.

JSON-LD


 <html>
  <head>
    <title>Nice trinket</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "sku": "trinket-12345",
      "gtin14": "12345678901234",
      "image": [
        "https://example.com/photos/16x9/trinket.jpg",
        "https://example.com/photos/4x3/trinket.jpg",
        "https://example.com/photos/1x1/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",
        "price": 39.99,
        "priceCurrency": "USD",
        "priceValidUntil": "2024-11-20",
        "shippingDetails": {
          "@type": "OfferShippingDetails",
          "shippingRate": {
            "@type": "MonetaryAmount",
            "value": 3.49,
            "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"
            }
          }
        }
      },
      "review": {
        "@type": "Review",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": 4,
            "bestRating": 5
          },
          "author": {
            "@type": "Person",
            "name": "Fred Benson"
          }
        },
        "aggregateRating": {
          "@type": "AggregateRating",
          "ratingValue": 4.4,
          "reviewCount": 89
        }
      }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Nice trinket</title>
  </head>
  <body>
    <div typeof="schema:Product">
      <div property="schema:sku" content="trinket-12345"></div>
      <div property="schema:gtin14" content="12345678901234"></div>
      <div property="schema:name" content="Nice trinket"></div>
      <div rel="schema:image" resource="https://example.com/photos/16x9/trinket.jpg"></div>
      <div rel="schema:image" resource="https://example.com/photos/4x3/trinket.jpg"></div>
      <div rel="schema:image" resource="https://example.com/photos/1x1/trinket.jpg"></div>
      <div property="schema:description" content="Trinket with clean lines"></div>
      <div rel="schema:brand">
        <div typeof="schema:Brand">
          <div property="schema:name" content="MyBrand"></div>
        </div>
      </div>
      <div rel="schema:offers">
        <div typeof="schema:Offer">
          <div rel="schema:url" resource="https://example.com/trinket_offer"></div>
          <div property="schema:itemCondition" content="https://schema.org/NewCondition"></div>
          <div property="schema:availability" content="https://schema.org/InStock"></div>
          <div property="schema:price" content="39.99"></div>
          <div property="schema:priceCurrency" content="USD"></div>
          <div property="schema:priceValidUntil" datatype="xsd:date" content="2024-11-20"></div>
          <div rel="schema:shippingDetails">
            <div typeof="schema:OfferShippingDetails">
              <div rel="schema:shippingRate">
                <div typeof="schema:MonetaryAmount">
                  <div property="schema:value" content="3.49"></div>
                  <div property="schema:currency" content="USD"></div>
                </div>
              </div>
              <div rel="schema:shippingDestination">
                <div typeof="schema:DefinedRegion">
                  <div property="schema:addressCountry" content="US"></div>
                </div>
              </div>
              <div rel="schema:deliveryTime">
                <div typeof="schema:ShippingDeliveryTime">
                  <div rel="schema:handlingTime">
                    <div typeof="schema:QuantitativeValue">
                      <div property="schema:minValue" content="0"></div>
                      <div property="schema:maxValue" content="1"></div>
                      <div property="schema:unitCode" content="DAY"></div>
                    </div>
                  </div>
                  <div rel="schema:transitTime">
                    <div typeof="schema:QuantitativeValue">
                      <div property="schema:minValue" content="1"></div>
                      <div property="schema:maxValue" content="5"></div>
                      <div property="schema:unitCode" content="DAY"></div>
                    </div>
                  </div>
                </div>
              </div>
            </div>
          </div>
        </div>
      </div>
      <div rel="schema:review">
        <div typeof="schema:Review">
          <div rel="schema:reviewRating">
            <div typeof="schema:Rating">
              <div property="schema:ratingValue" content="4"></div>
              <div property="schema:bestRating" content="5"></div>
            </div>
          </div>
          <div rel="schema:author">
            <div typeof="schema:Person">
              <div property="schema:name" content="Fred Benson"></div>
            </div>
          </div>
        </div>
      </div>
      <div rel="schema:aggregateRating">
        <div typeof="schema:AggregateRating">
          <div property="schema:reviewCount" content="89"></div>
          <div property="schema:ratingValue" content="4.4"></div>
        </div>
      </div>
    </div>
  </body>
</html>

Microdados


 <html>
  <head>
    <title>Nice trinket</title>
  </head>
  <body>
  <div>
    <div itemtype="https://schema.org/Product" itemscope>
      <meta itemprop="sku" content="trinket-12345" />
      <meta itemprop="gtin14" content="12345678901234" />
      <meta itemprop="name" content="Nice trinket" />
      <link itemprop="image" href="https://example.com/photos/16x9/trinket.jpg" />
      <link itemprop="image" href="https://example.com/photos/4x3/trinket.jpg" />
      <link itemprop="image" href="https://example.com/photos/1x1/trinket.jpg" />
      <meta itemprop="description" content="Trinket with clean lines" />
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="MyBrand" />
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://www.example.com/trinket_offer" />
        <meta itemprop="itemCondition" content="https://schema.org/NewCondition" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="price" content="39.99" />
        <meta itemprop="priceCurrency" content="USD" />
        <meta itemprop="priceValidUntil" content="2024-11-20" />
        <div itemprop="shippingDetails" itemtype="https://schema.org/OfferShippingDetails" itemscope>
          <div itemprop="shippingRate" itemtype="https://schema.org/MonetaryAmount" itemscope>
            <meta itemprop="value" content="3.49" />
            <meta itemprop="currency" content="USD" />
          </div>
          <div itemprop="shippingDestination" itemtype="https://schema.org/DefinedRegion" itemscope>
            <meta itemprop="addressCountry" content="US" />
          </div>
          <div itemprop="deliveryTime" itemtype="https://schema.org/ShippingDeliveryTime" itemscope>
            <div itemprop="handlingTime" itemtype="https://schema.org/QuantitativeValue" itemscope>
              <meta itemprop="minValue" content="0" />
              <meta itemprop="maxValue" content="1" />
              <meta itemprop="unitCode" content="DAY" />
            </div>
            <div itemprop="transitTime" itemtype="https://schema.org/QuantitativeValue" itemscope>
              <meta itemprop="minValue" content="1" />
              <meta itemprop="maxValue" content="5" />
              <meta itemprop="unitCode" content="DAY" />
            </div>
          </div>
        </div>
      </div>
      <div itemprop="review" itemtype="https://schema.org/Review" itemscope>
        <div itemprop="author" itemtype="https://schema.org/Person" itemscope>
          <meta itemprop="name" content="Fred Benson" />
        </div>
        <div itemprop="reviewRating" itemtype="https://schema.org/Rating" itemscope>
          <meta itemprop="ratingValue" content="4" />
          <meta itemprop="bestRating" content="5" />
        </div>
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <meta itemprop="ratingValue" content="4.4" />
      </div>
    </div>
  </div>
  </body>
</html>

Frete grátis

Veja um exemplo de frete grátis para compradores no estado de Nova York, nos EUA.

"shippingDetails": {
  "@type": "OfferShippingDetails",
  "shippingRate": {
    "@type": "MonetaryAmount",
    "value": "0",
    "currency": "USD"
  },
  "shippingDestination": [
    {
      "@type": "DefinedRegion",
      "addressCountry": "US",
      "addressRegion": ["NY"]
    }
  ]
}

Detalhes da devolução

Veja um exemplo de página de produto com detalhes de devolução. A marcação corresponde a uma política de devolução que exige que os produtos sejam devolvidos em até 60 dias, enviados para os EUA. Não há taxas de devolução.

JSON-LD


 <html>
  <head>
    <title>Nice trinket</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "sku": "trinket-12345",
      "gtin14": "12345678901234",
      "image": [
        "https://example.com/photos/16x9/trinket.jpg",
        "https://example.com/photos/4x3/trinket.jpg",
        "https://example.com/photos/1x1/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": "PriceSpecification",
          "price": 39.99,
          "priceCurrency": "CHF"
        },
        "hasMerchantReturnPolicy": {
          "@type": "MerchantReturnPolicy",
          "applicableCountry": "CH",
          "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
          "merchantReturnDays": 60,
          "returnMethod": "https://schema.org/ReturnByMail",
          "returnFees": "https://schema.org/FreeReturn"
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Nice trinket</title>
  </head>
  <body>
    <div typeof="schema:Product">
      <div property="schema:sku" content="trinket-12345"></div>
      <div property="schema:gtin14" content="12345678901234"></div>
      <div property="schema:name" content="Nice trinket"></div>
      <div rel="schema:image" resource="https://example.com/photos/16x9/trinket.jpg"></div>
      <div rel="schema:image" resource="https://example.com/photos/4x3/trinket.jpg"></div>
      <div rel="schema:image" resource="https://example.com/photos/1x1/trinket.jpg"></div>
      <div property="schema:description" content="Trinket with clean lines"></div>
      <div rel="schema:brand">
        <div typeof="schema:Brand">
          <div property="schema:name" content="MyBrand"></div>
        </div>
      </div>
      <div rel="schema:offers">
        <div typeof="schema:Offer">
          <div rel="schema:url" resource="https://example.com/trinket_offer"></div>
          <div property="schema:itemCondition" content="https://schema.org/NewCondition"></div>
          <div property="schema:availability" content="https://schema.org/InStock"></div>
          <div property="schema:price" content="39.99"></div>
          <div property="schema:priceCurrency" content="CHF"></div>
          <div property="schema:priceValidUntil" datatype="xsd:date" content="2024-11-20"></div>
          <div rel="schema:hasMerchantReturnPolicy">
            <div typeof="schema:MerchantReturnPolicy">
              <div property="schema:applicableCountry" content="US"></div>
              <div property="schema:returnPolicyCategory" content="https://schema.org/MerchantReturnFiniteReturnWindow"></div>
              <div property="schema:merchantReturnDays" content="60"></div>
              <div property="schema:returnMethod" content="https://schema.org/ReturnByMail"></div>
              <div property="schema:returnFees" content="https://schema.org/FreeReturn"></div>
            </div>
          </div>
        </div>
      </div>
    </div>
  </body>
</html>

Microdados


 <html>
  <head>
    <title>Nice trinket</title>
  </head>
  <body>
  <div>
    <div itemtype="https://schema.org/Product" itemscope>
      <meta itemprop="sku" content="trinket-12345" />
      <meta itemprop="gtin14" content="12345678901234" />
      <meta itemprop="name" content="Nice trinket" />
      <link itemprop="image" href="https://example.com/photos/16x9/trinket.jpg" />
      <link itemprop="image" href="https://example.com/photos/4x3/trinket.jpg" />
      <link itemprop="image" href="https://example.com/photos/1x1/trinket.jpg" />
      <meta itemprop="description" content="Trinket with clean lines" />
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="MyBrand" />
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://www.example.com/trinket_offer" />
        <meta itemprop="itemCondition" content="https://schema.org/NewCondition" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="price" content="39.99" />
        <meta itemprop="priceCurrency" content="CHF" />
        <meta itemprop="priceValidUntil" content="2024-11-20" />
        <div itemprop="hasMerchantReturnPolicy" itemtype="https://schema.org/MerchantReturnPolicy" itemscope>
          <meta itemprop="applicableCountry" content="US" />
          <meta itemprop="returnPolicyCategory" content="https://schema.org/MerchantReturnFiniteReturnWindow" />
          <meta itemprop="merchantReturnDays" content="60" />
          <meta itemprop="returnMethod" content="https://schema.org/ReturnByMail" />
          <meta itemprop="returnFees" content="https://schema.org/FreeReturn" />
        </div>
      </div>
    </div>
  </div>
  </body>
</html>

Classificações de eficiência energética

O exemplo a seguir ilustra como especificar informações de eficiência energética usando dados estruturados. O exemplo especifica a classe de eficiência energética da UE "C" com a escala "A+" a "F" de um aquecedor de água.

Observe que o valor da classe de eficiência energética mínima especifica a classe menos eficiente na escala de consumo de energia (neste caso, "F"), enquanto o valor máximo da classe de eficiência energética especifica a classe mais eficiente (neste caso, "A+").

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "1234-5678",
  "image": "https://www.example.com/waterheater.jpg",
  "name": "Water heater",
  "description": "Large capacity water heater",
  "gtin14": "12345678901231",
  "mpn": "WH1234",
  "brand": {
    "@type": "Brand",
    "name": "ExampleWaterHeaterBrand"
  },
  "hasEnergyConsumptionDetails": {
    "@type": "EnergyConsumptionDetails",
    "hasEnergyEfficiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
    "energyEfficiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF",
    "energyEfficiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryA1Plus"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/hotwaterheater",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 1799.00,
    "priceCurrency": "EUR"
  }
}

Modelo 3D

Este exemplo mostra como vincular um modelo 3D a um produto com a propriedade subjectOf. e o tipo 3DModel.

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "1234-5678",
  "image": "https://www.example.com/sofa.jpg",
  "name": "Water heater",
  "description": "White 3-Seat Sofa",
  "gtin14": "12345678901231",
  "mpn": "S1234W3",
  "brand": {
    "@type": "Brand",
    "name": "ExampleSofaBrand"
  },
  "subjectOf": {
    "@type": "3DModel",
    "encoding": {
      "@type": "MediaObject",
      "contentUrl": "https://example.com/sofa.gltf"
    }
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/whitechaiselongue",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "price": 1299.00,
    "priceCurrency": "USD"
  }
}

Diretrizes

Para que sua marcação Product se qualifique para as experiências com produto do comerciante, siga estas diretrizes:

Diretrizes técnicas

  • Somente páginas em que um comprador pode adquirir um produto são qualificadas para experiências com listagens de comerciantes, não páginas com links para outros sites que vendem o produto. O Google pode tentar verificar os dados do produto da listagem do comerciante antes de mostrar as informações nos resultados da pesquisa.
  • No momento, a pesquisa aprimorada de produtos é compatível apenas com páginas que se concentram em um único produto (ou várias variantes dele). Por exemplo, "sapatos da nossa loja" não é um produto específico. Isso inclui variantes do produto em que cada uma tem um URL diferente. Recomendamos que você priorize adicionar marcações às páginas de produtos em vez de páginas que os listem ou listem uma categoria deles.
  • Para ver detalhes sobre como fazer a marcação de variantes do produto, consulte a documentação de dados estruturados das variantes do produto.
  • Ao oferecer produtos à venda em várias moedas, tenha um URL distinto para cada uma. Por exemplo, se um produto estiver disponível para venda em dólares canadenses e dos EUA, use dois URLs distintos, um para cada moeda.
  • No momento, Car não é automaticamente compatível como subtipo de Product. Por enquanto, inclua os tipos Car e Product, caso queira anexar classificações a ele e se qualificar para o recurso de pesquisa. Por exemplo, em JSON-LD:
    {
      "@context": "https://schema.org",
      "@type": ["Product", "Car"],
      ...
    }

Diretrizes de conteúdo

  • Não é permitido conteúdo que promova produtos amplamente regulamentados ou proibidos, nem informações que possam causar danos graves, imediatos ou de longo prazo às pessoas. Isso inclui conteúdo relacionado a armas de fogo ou de outros tipos, drogas recreativas, tabaco e cigarro eletrônico, além de produtos relacionados a jogos de azar.

Definições de tipos de dados estruturados

É necessário incluir as propriedades obrigatórias para que seu conteúdo seja qualificado para exibição na pesquisa aprimorada. Também é possível incluir as propriedades recomendadas para adicionar mais informações aos seus dados estruturados, o que pode proporcionar uma melhor experiência do usuário.

Informações do produto

Product

A definição completa de Product está disponível em schema.org/Product (todos os links de schema.org estão em inglês). Ao fazer a marcação do seu conteúdo de informações do produto, use as seguintes propriedades do tipo Product:

Propriedades obrigatórias
name

Text

É o nome do produto.

image

Repetição de ImageObject ou URL

É o URL da foto de um produto. Imagens que mostram claramente o produto (por exemplo, em um fundo branco) são preferenciais.

Additional image guidelines:

  • Image URLs must be crawlable and indexable. To check if Google can access your URLs, use the URL Inspection tool.
  • Images must represent the marked up content.
  • Images must be in a file format that's supported by Google Images.
  • For best results, we recommend providing multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1.

For example:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
offers

Offer

É um Offer aninhado para vender o produto.

Os snippets de produto aceitam um Offer ou AggregateOffer, mas as listagens do comerciante exigem Offer porque o comerciante precisa ser o vendedor do produto para se qualificar para as experiências com produto.

Propriedades recomendadas
aggregateRating

AggregateRating

É o aggregateRating aninhado do produto. Siga as diretrizes de snippets de avaliação e a lista de propriedades AggregateRating obrigatórias e recomendadas.

audience

PeopleAudience

Informações opcionais sobre o público-alvo sugerido para o produto, como gênero e faixa etária sugeridos. Somente o tipo PeopleAudience é compatível. Veja a lista de propriedades PeopleAudience compatíveis com o Google.

brand.name

Text

Inclua a marca do produto na propriedade name do tipo Brand, se possível. Inclua no máximo um nome de marca.

color

Text

A cor ou combinação de cores do produto (por exemplo, "vermelho" ou "amarelo/azul-claro"). Veja também o atributo de cor na Ajuda do Google Merchant Center.

description

Text

É a descrição do produto. Embora a descrição do produto não seja obrigatória, é altamente recomendável fornecer uma descrição do item nessa propriedade.

gtin | gtin8 | gtin12 | gtin13 | gtin14 | isbn

Text

Inclua todos os identificadores globais relevantes, descritos em schema.org/Product. Embora você possa usar a propriedade genérica gtin para todos os GTINs, é recomendável usar o GTIN mais específico aplicável ao seu produto, já que essa é a representação mais precisa dele. O valor do GTIN precisa estar no formato numérico. Não aceitamos o formulário de URL para GTINs.

isbn é uma propriedade válida somente em Book. Para melhores resultados, use o formato ISBN-13. Para usar Book corretamente, associe ao tipo Product. Isso permitirá que você use propriedades dos dois tipos no nó. Exemplo:

{
  "@context": "https://schema.org",
  "@type": ["Product", "Book"],
  ....
}
hasEnergyConsumptionDetails

EnergyConsumptionDetails

Informações sobre o consumo de energia, como em produtos elétricos. Esta propriedade é particularmente importante em países europeus. Veja também a lista de propriedades EnergyConsumptionDetails compatíveis com o Google.

inProductGroupWithID

Text

O ID de um grupo de produtos ao qual essa variante do produto pertence. Veja também Item Group Id na Ajuda do Google Merchant Center. Especifique no máximo um valor.

Para ver detalhes sobre como adicionar marcação para variantes do produto, consulte a documentação de dados estruturados de variantes do produto.
isVariantOf

ProductGroup

Um grupo de produtos ao qual essa variante do produto pertence, se aplicável. Para ver detalhes sobre como adicionar marcação para variantes do produto, consulte a documentação de dados estruturados de variantes do produto.

material

Text

O material ou a combinação do material de que o produto é feito, como "couro" ou "algodão/poliéster". Veja também Material na Ajuda do Google Merchant Center.

mpn

Text

O número de peça do fabricante. Esta propriedade identifica exclusivamente o produto de certo fabricante.

pattern

Text

A estampa do produto, como "bolinhas" ou "listrado". Veja também Pattern na página de especificação dos dados do produto do Google Merchant Center.

review

Review

É o Review aninhado do produto. Siga as diretrizes de snippet de avaliação e a lista de propriedades de avaliação obrigatórias e recomendadas. Veja também a lista de outras propriedades Review específicas para o tipo Product do schema.org.

Se você adicionar uma avaliação do produto, o nome do avaliador precisará ser válido para Person ou Team.

Não recomendado: "50% de desconto na Black Friday"

Recomendado: "João da Silva" ou "Avaliadores do CNET"

size

Text ou SizeSpecification

O tamanho do produto, como "GG" ou "M". Veja também size na página de especificação dos dados do produto do Google Merchant Center. Veja a lista de propriedades SizeSpecification compatíveis com o Google. Especifique no máximo um valor.

sku

Text

O identificador específico da loja para o produto. Especifique no máximo um valor.

  • O valor sku precisa usar caracteres Unicode válidos para intercâmbio.
  • O valor sku não pode conter nenhum caractere de espaço em branco (conforme definido pela propriedade de espaço em branco Unicode).
  • Recomendamos que o valor sku contenha apenas caracteres ASCII.
subjectOf

3DModel

Um modelo 3D do produto, se aplicável. Veja a lista de propriedades 3DModel compatíveis com o Google. Especifique no máximo um valor 3DModel.

3DModel

A definição completa de 3DModel está disponível em schema.org/3DModel.

Use as seguintes propriedades para vincular a um modelo 3D. No momento, apenas modelos no formato glTF são aceitos.

Propriedades obrigatórias
encoding

MediaObject

A mídia do modelo 3D.

encoding.contentUrl

URL

O link para um arquivo de definição de modelo 3D no formato glTF. O arquivo precisa ter um sufixo .gltf ou .glb.

Detalhes da oferta

Offer

A definição completa de Offer está disponível em schema.org/Offer. Ao fazer a marcação de ofertas em um produto, use as seguintes propriedades do tipo Offer schema.org.

Propriedades obrigatórias
price ou priceSpecification.price

Number

É o preço da oferta de um produto. Siga as diretrizes de uso do schema.org.

Veja um exemplo da propriedade price:

"offers": {
  "@type": "Offer",
  "price": 39.99,
  "priceCurrency": "USD"
}

Ao contrário dos snippets de produto, as experiências com listagens do comerciante exigem um preço maior que zero.

O preço da oferta é obrigatório, mas pode ser aninhado em uma propriedade priceSpecification em vez de ser fornecido no nível de Offer.

priceCurrency ou priceSpecification.priceCurrency

Text

É a moeda usada para descrever o preço do produto, no formato ISO 4217 de três letras.

priceCurrency vai ser necessário se price for especificado. Caso contrário, priceSpecification.priceCurrency vai ser necessário se priceSpecification.price for especificado.

priceSpecification

UnitPriceSpecification

Os preços complexos podem ser especificados usando priceSpecification em vez da propriedade price. Consulte a lista de propriedades UnitPriceSpecification compatíveis e os exemplos para ver exemplos de como marcar várias formas de preços.

Os preços podem ser especificados usando price e priceCurrency no nível da Offer ou na propriedade priceSpecification.

Os preços com medidas de preço unitário podem especificar uma propriedade referenceQuantity dentro de UnitPriceSpecification.

Propriedades recomendadas
availability

ItemAvailability

São as possíveis opções de disponibilidade do produto. Os nomes curtos sem o prefixo de URL também são compatíveis (por exemplo, BackOrder).

  • https://schema.org/BackOrder: o item está em espera.
  • https://schema.org/Discontinued: o item foi descontinuado.
  • https://schema.org/InStock: o item está em estoque.
  • https://schema.org/InStoreOnly: o item só está disponível para compra na loja.
  • https://schema.org/LimitedAvailability: o item tem disponibilidade limitada.
  • https://schema.org/OnlineOnly: o item está disponível apenas on-line.
  • https://schema.org/OutOfStock: o item está esgotado no momento.
  • https://schema.org/PreOrder: o item está disponível para compra na pré-venda.
  • https://schema.org/PreSale: o item está disponível para pedidos e entregas antes da disponibilidade geral.
  • https://schema.org/SoldOut: o item está esgotado.

Não especifique mais de um valor.

hasMerchantReturnPolicy

MerchantReturnPolicy

Informações aninhadas sobre as políticas de devolução associadas a Offer. Se você decidir adicionar hasMerchantReturnPolicy, inclua também as propriedades MerchantReturnPolicy obrigatórias e recomendadas.

itemCondition

OfferItemCondition

Condição do item oferecido para venda. Os nomes curtos sem o prefixo de URL também são compatíveis (por exemplo, NewCondition).

  • https://schema.org/NewCondition: o item é novo.
  • https://schema.org/RefurbishedCondition: o item foi recondicionado.
  • https://schema.org/UsedCondition: o item é usado, e não novo.

Não especifique mais de um valor.

shippingDetails

OfferShippingDetails

Informações aninhadas sobre as políticas e opções de frete associadas a um Offer. Se você decidir adicionar shippingDetails, inclua também as propriedades OfferShippingDetails obrigatórias e recomendadas.

url

URL

URL da página da Web em que o usuário pode comprar o produto. Esse pode ser o URL preferencial da página atual, com todas as opções de variantes selecionadas corretamente. O URL pode ser omitido. Não inclua vários URLs.

Para ver detalhes sobre como adicionar marcação para variantes do produto, consulte a documentação de dados estruturados de variantes do produto.

UnitPriceSpecification

A definição completa de UnitPriceSpecification está disponível em schema.org/UnitPriceSpecification. Use as propriedades a seguir para capturar esquemas de preços mais complexos.

Propriedades obrigatórias
price

Number

É o preço da oferta de um produto. Consulte também a propriedade price de Offer.

priceCurrency

Text

É a moeda usada para descrever o preço do produto, no formato ISO 4217 de três letras. Consulte também a propriedade priceCurrency de Offer.

Propriedades recomendadas
referenceQuantity

QuantitativeValue (para preço unitário)

A quantidade de referência é usada para preços que especificam um valor de referência para o preço. Consulte também os exemplos Preço com medidas de preço unitário e Medida de preço unitário na Ajuda do Google Merchant Center para uma discussão detalhada sobre o preço unitário.

QuantitativeValue (para preço unitário)

Nesta seção, falamos sobre o uso do QuantitativeValue para a propriedade referenceQuantity de uma especificação de preço unitário. QuantitativeValue também é usado para durações de frete, mas com regras diferentes. A definição completa de QuantitativeValue está disponível em schema.org/QuantitativeValue.

QuantitativeValue pode ser usado para um preço baseado em uma medida de unidade, como a compra de pisos por metro quadrado ou líquidos por litro. Consulte Medida de preço unitário na Ajuda do Google Merchant Center para ver uma discussão detalhada sobre o preço unitário.

Veja a seguir um exemplo de preço de venda para 4,5 l de um produto que pode ser comprado em múltiplos para 750 ml.

"priceSpecification": {
  "@type": "UnitPriceSpecification",
  "price": 81.00,
  "priceCurrency": "EUR",
  "referenceQuantity": {
    "@type": "QuantitativeValue",
    "value": "4.5",
    "unitCode": "LTR",
    "valueReference": {
      "@type": "QuantitativeValue",
      "value": "750",
      "unitCode": "MLT"
    }
  }
}

Use as propriedades a seguir para capturar detalhes dos preços unitários.

Propriedades obrigatórias
unitCode

Text ou URL

A unidade de medida. Os códigos UN/CEFACT ou os equivalentes legíveis por humanos, conforme listado na medida de preço unitário da Ajuda do Google Merchant Center, são compatíveis.

value

Text

O valor numérico da unidade vendida.

Propriedades recomendadas
valueReference

QuantitativeValue

O QuantitativeValue na propriedade referenceQuantity de UnitPriceSpecification precisa incluir um QuantitativeValue aninhado na propriedade valueReference.

SizeSpecification

O tipo SizeSpecification é usado para indicar o tamanho de um produto. A definição completa do tipo está disponível em schema.org/SizeSpecification.

Propriedades recomendadas
name

Text

Um nome legível para o tamanho, como "XL". Para mais detalhes, consulte o atributo de tamanho na Ajuda do Google Merchant Center.

sizeGroup

WearableSizeGroupEnumeration ou Text

O grupo de tamanho sugerido para o produto, se aplicável. A interpretação do grupo é definida pela propriedade sizeGroup. É possível informar até dois grupos de tamanho. Os valores compatíveis são:

  • https://schema.org/WearableSizeGroupRegular: o tamanho do item é "médio".
  • https://schema.org/WearableSizeGroupPetite: o tamanho do item é "pequeno".
  • https://schema.org/WearableSizeGroupPlus: o tamanho do item é "plus".
  • https://schema.org/WearableSizeGroupTall: o tamanho do item é "alto".
  • https://schema.org/WearableSizeGroupBig: o tamanho do item é "grande".
  • https://schema.org/WearableSizeGroupMaternity: o tamanho do item é "gestante".

Os nomes curtos sem o prefixo de URL também são compatíveis (por exemplo, WearableSizeGroupRegular).

Veja também size_type e Tipos e valores de dados estruturados compatíveis na Ajuda do Google Merchant Center para saber mais sobre sistemas de tamanhos compatíveis. O Google também entende os valores de texto de size_type (regular, petite, plus, tall, big e maternity), mas outros mecanismos de pesquisa não. Por isso, é recomendável usar os valores de enumeração padrão do schema.org.

sizeSystem

WearableSizeSystemEnumeration ou Text

O sistema de tamanhos do produto, se aplicável. Os valores compatíveis são:

  • https://schema.org/WearableSizeSystemAU: é o sistema de tamanhos na Austrália.
  • https://schema.org/WearableSizeSystemBR: é o sistema de tamanhos no Brasil.
  • https://schema.org/WearableSizeSystemCN: é o sistema de tamanhos na China.
  • https://schema.org/WearableSizeSystemDE: é o sistema de tamanhos na Alemanha.
  • https://schema.org/WearableSizeSystemEurope: é o sistema de tamanhos na Europa.
  • https://schema.org/WearableSizeSystemFR: é o sistema de tamanhos na França.
  • https://schema.org/WearableSizeSystemIT: é o sistema de tamanhos na Itália.
  • https://schema.org/WearableSizeSystemJP: é o sistema de tamanhos no Japão.
  • https://schema.org/WearableSizeSystemMX: é o sistema de tamanhos no México.
  • https://schema.org/WearableSizeSystemUK: é o sistema de tamanhos no Reino Unido.
  • https://schema.org/WearableSizeSystemUS: é o sistema de tamanhos nos Estados Unidos.

Os nomes curtos sem o prefixo de URL também são compatíveis (por exemplo, WearableSizeSystemAU).

Veja também size_system na Ajuda do Google Merchant Center. O Google também entende os valores de texto de size_system (por exemplo, UR, BR, CN, DE, EU), mas outros mecanismos de pesquisa não. Portanto, é recomendável usar os valores de enumeração schema.org padrão.

PeopleAudience

A definição completa de PeopleAudience está disponível em schema.org/PeopleAudience.

Use as propriedades a seguir ao indicar o público recomendado de um produto. Veja também Atributos e valores de dados estruturados compatíveis na Ajuda do Google Merchant Center.

Propriedades recomendadas
suggestedGender

Text ou GenderType

O gênero sugerido para o produto. Precisa ser um destes valores:

  • https://schema.org/Male
  • https://schema.org/Female
  • Unisex: esse valor (não diferencia maiúsculas de minúsculas) está fora do padrão schema.org e não pode ter um prefixo https://schema.org/.

Confira Gender na Ajuda do Google Merchant Center para saber mais detalhes.

O Google vai preencher os valores GenderType sem o prefixo do schema.org. Portanto, os valores brutos male e female também são aceitos.

suggestedMaxAge (ou suggestedAge.maxValue)

Number

A idade máxima sugerida em anos para o produto. O Google mapeia as idades máximas sugeridas para produtos no seguinte conjunto fixo de valores numéricos:

  • 0.25: recém-nascidos
  • 1.0: de 3 a 12 meses
  • 5.0: de 1 a 5 anos
  • 13.0: crianças
suggestedMinAge (ou suggestedAge.minValue)

Number

A idade mínima sugerida em anos para o produto. O Google mapeia as idades mínimas sugeridas para produtos no seguinte conjunto fixo de valores numéricos:

  • 0: recém-nascidos
  • 0.25: de 3 a 12 meses
  • 1.0: de 1 a 5 anos
  • 5.0: crianças
  • 13.0: adultos

EnergyConsumptionDetails

A definição completa de EnergyConsumptionDetails está disponível em schema.org/EnergyConsumptionDetails.

Use as propriedades a seguir para indicar o consumo de energia de um produto, como bens elétricos. No momento, somente as classificações de eficiência energética da UE são aceitas.

Propriedades obrigatórias
hasEnergyEfficiencyCategory

EUEnergyEfficiencyEnumeration

A categoria de eficiência energética do produto. No momento, somente as classificações de eficiência energética da UE são aceitas:

  • https://schema.org/EUEnergyEfficiencyCategoryA3Plus: classe de eficiência energética A+++ da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryA2Plus: classe de eficiência energética A++ da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryA1Plus: classe de eficiência energética A+ da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryA: classe de eficiência energética A da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryB: classe de eficiência energética B da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryC: classe de eficiência energética C da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryD: classe de eficiência energética D da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryE: classe de eficiência energética E da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryF: classe de eficiência energética F da UE.
  • https://schema.org/EUEnergyEfficiencyCategoryG: classe de eficiência energética G da UE.

Os nomes curtos sem o prefixo de URL também são compatíveis (por exemplo, EUEnergyEfficiencyCategoryA).

Propriedades recomendadas
energyEfficiencyScaleMin e energyEfficiencyScaleMax

EUEnergyEfficiencyEnumeration

A classe de eficiência energética mais baixa e mais alta na escala de consumo de energia regulamentada da UE para a categoria de produto a que um produto pertence.

Consulte hasEnergyEfficiencyCategory para ver uma lista de valores compatíveis.

A propriedade energyEfficiencyScaleMin especifica a classe menos eficiente na escala de consumo de energia, enquanto energyEfficiencyScaleMax especifica a classe mais eficiente. Por exemplo, para um produto com uma classe de eficiência energética "C" em uma escala de "A+++" a "D", use:

{
  "@type": "EnergyConsumptionDetails",
  "hasEnergyEfficiencyCategory":  "https://schema.org/EUEnergyEfficiencyCategoryC",
  "energyEfficiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryD",
  "energyEfficiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryA3Plus"
}

Se energyEfficiencyScaleMin não for fornecido, podemos presumir que o valor é https://schema.org/EUEnergyEfficiencyCategoryG. Se energyEfficiencyScaleMax não for fornecido, podemos presumir que o valor é https://schema.org/EUEnergyEfficiencyCategoryA3Plus.

Frete

OfferShippingDetails

OfferShippingDetails permite que os usuários vejam os custos de frete e os prazos de entrega com base na localização deles e nas políticas de frete da sua empresa. Se quiser qualificar seus produtos para a melhoria de detalhes do frete, adicione as propriedades de OfferShippingDetails a seguir às páginas deles, além dos dados estruturados de Product.

Às vezes, os comerciantes oferecem várias opções de envio para que os usuários escolham uma delas. Por exemplo, entrega expressa, rápida ou padrão. Indique cada uma com várias propriedades shippingDetails, cada uma com diferentes combinações das propriedades shippingRate e deliveryTime.

Embora OfferShippingDetails não seja obrigatória, as seguintes propriedades são obrigatórias se você quiser que seus detalhes de frete se qualifiquem para a melhoria.

A definição completa de OfferShippingDetails está disponível em schema.org/OfferShippingDetails.

Propriedades obrigatórias
deliveryTime

ShippingDeliveryTime

É o período total entre o recebimento do pedido e a chegada dos produtos ao cliente final. As propriedades a seguir podem ser aninhadas na propriedade deliveryTime:

  • handlingTime
  • transitTime

Não forneça mais de um deliveryTime. Veja também a lista de propriedades ShippingDeliveryTime compatíveis com o Google.

shippingDestination

DefinedRegion

Indica destinos de frete. Especifique as informações do shippingDestination.addressCountry. Veja também a lista de propriedades DefinedRegion compatíveis com o Google.

shippingRate

MonetaryAmount

São informações sobre o custo do frete para o destino especificado. Pelo menos uma das propriedades shippingRate.value ou shippingRate.maxValue precisa ser especificada com shippingRate.currency.

Só é possível especificar um shippingRate por propriedade OfferShippingDetails. Para modelar vários preços de frete para o produto, especifique várias propriedades OfferShippingDetail.

shippingRate.currency

Text

É a moeda do custo do frete, no formato ISO 4217 de três letras. A moeda precisa ser igual à moeda da oferta.

shippingRate.value ou shippingRate.maxValue

Number

É o custo do frete para shippingDestination. Se uma string for usada para fornecer o valor, não inclua símbolos de moeda, separadores de milhares ou espaços.

Para especificar frete grátis, defina o valor como 0.

DefinedRegion

A propriedade DefinedRegion é usada para criar áreas personalizadas. Assim, os custos de frete e os tempos em trânsito corretos poderão ser configurados em vários serviços de entrega. No momento, isso é compatível apenas com um conjunto restrito de países, conforme documentado em Configurar regiões na Ajuda do Google Merchant Center.

Propriedades obrigatórias
addressCountry

Text

O código de país com duas letras, no formato ISO 3166-1 alpha-2.

Propriedades recomendadas
Escolha addressRegion ou postalCode

Identifica a região da área de entrega do cliente. Se omitido, o país inteiro será a região definida. Várias regiões podem ser listadas, mas não é possível misturar maneiras diferentes de especificar as regiões em uma instância DefinedRegion.

addressRegion

Text

Se você incluir , a região precisará ser um código de subdivisão ISO 3166-2 de dois ou três dígitos sem o prefixo do país. No momento, a Pesquisa Google é compatível somente com os EUA, a Austrália e o Japão. Exemplos: "NY" (para EUA, estado de Nova York), "NSW" (para Austrália, estado de Nova Gales do Sul) ou "03" (para Japão, prefeitura de Iwate).

Não inclua informações sobre uma região e um código postal ao mesmo tempo.

postalCode

Text

É o código postal. Por exemplo, 94043. Atualmente, códigos postais são aceitos para a Austrália, o Canadá e os EUA.

ShippingDeliveryTime

O ShippingDeliveryTime é usado para compartilhar o atraso total entre o recebimento de um pedido e a chegada dos produtos ao cliente final.

Propriedades recomendadas
handlingTime

QuantitativeValue (para prazos de envio)

É o período médio entre o recebimento do pedido e a saída dos produtos do depósito.

transitTime

QuantitativeValue (para prazos de envio)

É o período médio entre o envio do pedido e a chegada dos produtos ao cliente final.

QuantitativeValue (para prazos de envio)

O atributo QuantitativeValue é usado aqui para representar os prazos de envio. Um número mínimo e máximo de dias precisam ser especificados. O QuantitativeValue também é usado para preços unitários, com diferentes regras de validação para propriedades.

Propriedades obrigatórias
maxValue

Number

O número máximo de dias. O valor precisa ser um número inteiro não negativo.

minValue

Number

Número mínimo de dias. O valor precisa ser um número inteiro não negativo.

unitCode

Text

As unidades dos valores mínimo/máximo. O valor precisa ser DAY ou d.

Retorna

MerchantReturnPolicy

Use as propriedades a seguir para qualificar as informações do produto e mostrar a política de devolução, incluindo as taxas de devolução e o período para devolver um produto.

Propriedades obrigatórias
applicableCountry

Text

O código do país ao qual a política de devolução se aplica, usando a formatação de código de país ISO 3166-1 alfa-2 de duas letras. É possível especificar até 50 países.

returnPolicyCategory

MerchantReturnEnumeration

É o tipo de política de devolução. Use um dos seguintes valores:

  • https://schema.org/MerchantReturnFiniteReturnWindow: há um número definido de dias para devolver um produto.
  • https://schema.org/MerchantReturnNotPermitted: não é permitido fazer devoluções.
  • https://schema.org/MerchantReturnUnlimitedWindow: o prazo de devolução de um produto é ilimitado.

Se você usar MerchantReturnFiniteReturnWindow, a propriedade merchantReturnDays vai ser obrigatória.

Propriedades recomendadas
merchantReturnDays

Integer

O número de dias (a partir da data de entrega) que um produto pode ser devolvido. Essa propriedade só vai ser obrigatória se você definir returnPolicyCategory como MerchantReturnFiniteReturnWindow.

returnFees

ReturnFeesEnumeration

É o tipo de taxa de devolução. Use um dos seguintes valores compatíveis:

  • https://schema.org/FreeReturn: não há custo financeiro para o consumidor devolver o produto. Se essa opção for usada, não inclua a propriedade returnShippingFeesAmount.
  • https://schema.org/ReturnFeesCustomerResponsibility: o consumidor precisa lidar e pagar pelo frete da devolução. Se essa opção for usada, não inclua a propriedade returnShippingFeesAmount.
  • https://schema.org/ReturnShippingFees: há uma taxa de frete cobrada do consumidor pelo comerciante para devolver o produto. Especifique a taxa de frete diferente de zero usando a propriedade returnShippingFeesAmount.
returnMethod

ReturnMethodEnumeration

É o tipo de método de devolução oferecido. Isso só é recomendado se você definir returnPolicyCategory como MerchantReturnFiniteReturnWindow ou MerchantReturnUnlimitedWindow. Use um ou mais dos seguintes valores:

  • https://schema.org/ReturnAtKiosk: o item pode ser devolvido em um quiosque.
  • https://schema.org/ReturnByMail: o item pode ser devolvido pelo correio.
  • https://schema.org/ReturnInStore: o item pode ser devolvido na loja.
returnShippingFeesAmount

MonetaryAmount

O custo do frete para devolver um produto. Essa propriedade só será obrigatória se houver uma taxa de frete diferente de zero a ser paga pelo consumidor ao comerciante para devolver um produto. Nesse caso, returnFees precisa ser definido como https://schema.org/ReturnShippingFees. Se a devolução não tiver custos financeiros, returnFees vai precisar ser definido como https://schema.org/FreeReturn. Se o consumidor precisar lidar e pagar o custo do frete da devolução, defina returnFees como https://schema.org/ReturnFeesCustomerResponsibility.

Abordagens alternativas para definir as configurações de frete e devolução no Google

As políticas de envio de varejistas podem ser complexas e mudar com frequência. Se você estiver com problemas para indicar e manter os detalhes de frete e devolução atualizados com marcações e tiver uma conta do Google Merchant Center, considere definir suas configurações de frete e políticas de devolução na Ajuda do Google Merchant Center. Também é possível configurar políticas de frete e devolução no nível da conta no Search Console, que são adicionadas automaticamente ao Merchant Center.

Combinar várias configurações de frete e devolução

Ao combinar várias configurações de frete e devolução, pense em como substituir as informações da política com base na ordem de precedência. Por exemplo, se você fornecer marcação no nível da organização no seu site e configurações da política de devolução no Search Console, o Google só usará as informações fornecidas no Search Console. Se você enviar um feed de produtos no Merchant Center e definir as configurações de frete no Search Console, as informações do seu feed do Merchant Center substituirão as configurações do Search Console.

Veja o que tem precedência para informações de frete e política de devolução (classificadas por força, sendo os feeds mais fortes):

Monitorar pesquisas aprimoradas com o Search Console

O Search Console é uma ferramenta que ajuda você a monitorar o desempenho das suas páginas na Pesquisa Google. Não é preciso se inscrever na plataforma para ser incluído nos resultados da Pesquisa Google, mas isso pode ajudar você a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:

  1. Depois de implantar os dados estruturados pela primeira vez
  2. Depois de lançar novos modelos ou atualizar o código
  3. Análise periódica do tráfego

Depois de implantar os dados estruturados pela primeira vez

Depois que o Google indexar as páginas, procure problemas com o relatório de status da pesquisa aprimorada relevante. Em condições ideais, vai haver um aumento de itens válidos e nenhum aumento de itens inválidos. Se você encontrar problemas nos dados estruturados, faça o seguinte:

  1. Corrija os itens inválidos.
  2. Inspecione um URL ativo para verificar se o problema persiste.
  3. Solicite a validação com o relatório de status.

Depois de lançar novos modelos ou atualizar o código

Ao fazer mudanças significativas no site, monitore aumentos nos itens inválidos de dados estruturados.
  • Caso você perceba um aumento nos itens inválidos, talvez tenha lançado um novo modelo que não funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
  • Caso você veja uma diminuição nos itens válidos (não correspondidos por um aumento nos itens inválidos), talvez não esteja mais incorporando os dados estruturados às páginas. Use a Ferramenta de inspeção de URL para saber o que está causando o problema.

Análise periódica do tráfego

Analise o tráfego da Pesquisa Google com o Relatório de desempenho. Os dados vão mostrar com que frequência sua página aparece como aprimorada na Pesquisa, com que frequência os usuários clicam nela e qual é a posição média dela nos resultados. Também é possível extrair automaticamente esses resultados com a API Search Console.

There are two Search Console reports related to Product structured data:

Both reports provide warnings and errors related to Product structured data, but are separate due to the different requirements for the associated experiences. For example, the Merchant listings report includes checks for product snippets that include Offer structured data, so the Product snippets report only needs to be consulted for non-merchant listing pages.

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.