Na stronach docelowych produktów możesz używać znaczników danych strukturalnych, by ułatwić Google pobieranie aktualnych informacji o Twoich produktach i ofertach bezpośrednio z Twojej strony. Wszystkie znaczniki danych strukturalnych obsługiwane w Merchant Center mają odpowiadające im atrybuty i akceptowane wartości podane w specyfikacji danych produktów. Dane strukturalne powinny odpowiadać określonym wartościom i atrybutom.
Na tej stronie:
Atrybuty i adnotacje schema.org
Atrybuty to jeden ze sposobów porządkowania danych produktów przesyłanych do Merchant Center. Każdy atrybut zawiera informację o produkcie, np. tytuł lub opis. Dokładne dopasowanie wartości schema.org do odpowiednich atrybutów w specyfikacji danych produktów pozwala zmniejszyć liczbę błędów podczas weryfikacji pliku danych.
Uwaga: jeśli korzystasz z automatycznych aktualizacji produktów i chcesz zwiększyć ich dokładność, pamiętaj, aby określić wartości mikrodanych schema.org, takie jak price, priceCurrency, availability i condition. Dowiedz się więcej o automatycznych aktualizacjach produktów.
|
Atrybut w danych produktów
|
Typ i opis | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Poniższe atrybuty są przypisane obiektowi mikrodanych schema.org typu Product. |
|||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
| Adres URL | |||||||||||||||||||||||||||||
|
Tekst Nadrzędny kod SKU wymagany do grupowania wszystkich wersji produktów należących do tej samej grupy produktów. |
|||||||||||||||||||||||||||||
|
Tekst Numer GTIN, który jednoznacznie identyfikuje Twój produkt. Określ tylko jedną z tych mikrodanych schema.org. Jeśli używasz wartości GTIN, sprawdź, czy są poprawnej długości i zawierają prawidłową cyfrę kontrolną. |
|||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
|
Tekst Użyj właściwości |
|||||||||||||||||||||||||||||
|
Tekst Użyj właściwości
|
|||||||||||||||||||||||||||||
|
ORAZ |
Liczba (w latach) Użyj właściwości Prawidłowymi wartościami są te podane dla atrybutu grupa wiekowa
|
||||||||||||||||||||||||||||
| Tekst | |||||||||||||||||||||||||||||
|
LUB |
Tekst Użyj właściwości |
||||||||||||||||||||||||||||
|
Tekst Użyj właściwości Prawidłowe wartości to wartości typu
|
|||||||||||||||||||||||||||||
|
Tekst Użyj właściwości Prawidłowe wartości to wartości typu WearableSizeSystemEnumeration. Są one przypisane do tych wartości z pliku danych:
|
|||||||||||||||||||||||||||||
|
Użyj właściwości |
|||||||||||||||||||||||||||||
|
Użyj właściwości |
|||||||||||||||||||||||||||||
|
Użyj właściwości |
|||||||||||||||||||||||||||||
|
Użyj właściwości |
|||||||||||||||||||||||||||||
|
Poniższe mikrodane schema.org są przypisane typowi Offer, który musi być umieszczony w obiekcie |
|||||||||||||||||||||||||||||
| Prawidłowy adres URL prowadzący do Twojego produktu. | |||||||||||||||||||||||||||||
|
LUB: |
price: liczba. Wartość przesłana bez symboli walut, separatora tysięcy i spacji (na przykład „1498.99”). priceCurrency: tekst. Wartość przesłana w 3-literowym formacie ISO 4217, np. USD, GBP, EUR. Waluta powinna spełniać wymagania dotyczące języka i waluty obowiązujące w kraju docelowym. Uwaga: właściwości price i priceCurrency można podać bezpośrednio w typie Offer lub pośrednio za pomocą właściwości priceSpecification typu UnitPriceSpecification. Jeśli jest określony atrybut sale_price, musisz podać wartość price za pomocą właściwości priceSpecification z parametrem priceSpecification.priceType="ListPrice". Atrybut sale_price można określić bezpośrednio w typie Offer lub za pomocą właściwości priceSpecification typu UnitPriceSpecification bez wartości priceSpecification.priceType. |
||||||||||||||||||||||||||||
|
Prawidłowe wartości to wartości typu
|
|||||||||||||||||||||||||||||
|
Prawidłowe wartości to wartości typu
|
|||||||||||||||||||||||||||||
| Prawidłowy adres URL płatności prowadzący do Twojego produktu. | |||||||||||||||||||||||||||||
Przykłady przy użyciu JSON-LD
Jeden produkt
Przykład
Przykład poniżej pokazuje produkt podstawowy z minimalnym zestawem właściwości.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"gtin": "12345678901234",
"brand": {
"@type": "Thing",
"name": "MojaMarka"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": "39.99",
"priceCurrency": "PLN"
}
}
Poniższy przykład pokazuje, jak określić rodzaj rozmiaru i tabelę rozmiarów za pomocą danych schema.org. Ten przykład określa amerykański rozmiar „XL” dla niebieskiej koszulki dla dorosłych (grupa wiekowa 13+) w męskim dziale odzieżowym „Duży rozmiar dla wysokich”.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "12345",
"image": "https://www.example.com/tshirt.jpg",
"name": "Klasyczna koszulka",
"description": "Bawełniana koszulka o klasycznym kroju",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"material": "bawełna",
"color": "niebieski",
"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": "PLN"
}
}
Wiele niepowiązanych produktów na jednej stronie docelowej
Kiedy strona zawiera wiele niepowiązanych produktów, a każdy z nich ma własną adnotację dotyczącą danych strukturalnych, poszczególne adnotacje muszą zawierać informacje określające, do którego produktu się odnoszą.
Zaleca się na przykład podanie kodu SKU (atrybut identyfikator [id]) lub numeru GTIN (atrybut [gtin]) w każdej adnotacji. Jeśli nie podasz tych informacji, produkty na stronie docelowej mogą nie pasować do danych strukturalnych produktów. Dowiedz się więcej o konfigurowaniu danych strukturalnych na stronach docelowych.
Przykład
[
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"offers": {
"@type": "Offer",
"url": "https://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": "39.99",
"priceCurrency": "PLN"
}
},
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "racket-12345",
"image": "https://www.example.com/racket.jpg",
"name": "Fajna rakieta",
"description": "Rakieta tenisowa",
"gtin": "12345678901235",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"offers": {
"@type": "Offer",
"url": "http://www.example.com/racket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": "59.99",
"priceCurrency": "PLN"
}
}
]Cena promocyjna
Poniższy przykład pokazuje produkt podstawowy z ceną promocyjną. Aby podać cenę promocyjną, określ również pierwotną rynkową cenę detaliczną, którą wyraża się za pomocą właściwości /priceType.
Przykład
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"offers": {
"@type": "Offer",
"url": "http://www.example.com/trinket_offer",
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock",
"price": "10.00",
"priceCurrency": "PLN",
"priceSpecification": {
"@type": "UnitPriceSpecification",
"priceType": "http://schema.org/ListPrice",
"price": "15.00",
"priceCurrency": "PLN"
}
}
}
Jeśli wartość /UnitPriceSpecification jest również używana do określenia ceny katalogowej, kodowanie zawiera po prostu 2 wartości /UnitPriceSpecification:
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"gtin": "12345678901234",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"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": "PLN"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/ListPrice",
"price": "15.00",
"priceCurrency": "PLN"
}
]
}
}
Dostawa
Aby określić koszty dostawy (zalecane) dla Twojego produktu, użyj mikrodanych schema.org typu OfferShippingDetails, które muszą być umieszczone w obiekcie Offer za pomocą właściwości shippingDetails odpowiadającej atrybutowi dostawa [shipping] w specyfikacji danych produktów. Można podać kilka wartości shippingDetails.
|
Atrybut w danych produktów
|
Typ i opis |
|---|---|
Poniższe atrybuty są przypisane obiektowi mikrodanych schema.org typu OfferShippingDetails. |
|
|
|
Tekst 2-cyfrowy kod kraju w formacie ISO 3166-1. Użyj właściwości |
|
Tekst 2- lub 3-cyfrowy kod regionu w formacie ISO 3166-2 bez prefiksu kraju. Obsługiwany tylko w przypadku Australii, Japonii i Stanów Zjednoczonych. Przykłady: „NY”, „NSW” lub „03”. Użyj właściwości |
|
|
Użyj właściwości |
|
|
Liczba (nieujemna, liczba całkowita). Określa minimalną i maksymalną liczbę dni roboczych dla obsługi zamówienia i transportu. Czas obsługi zamówienia określa czas pomiędzy złożeniem zamówienia a jego przekazaniem przewoźnikowi. Czas przewozu określa czas między przekazaniem produktu przewoźnikowi a dostarczeniem go do klienta. Użyj właściwości |
|
Przykład
Poniższy przykład pokazuje, jak określić informacje o dostawie za pomocą mikrodanych schema.org. W przykładzie podano koszt dostawy w wysokości 3,49 PLN do stanów Kalifornia, Nevada i Arizona w Stanach Zjednoczonych. Czas obsługi zamówienia wynosi od 0 do 1 dnia roboczego, a czas przewozu wynosi od 1 do 5 dni roboczych.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"brand": {
"@type": "Brand",
"name": "MojaMarka"
},
"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": "PLN"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingDestination": {
"@type": "DefinedRegion",
"addressCountry": "US",
"addressRegion": [ "CA", "NV", "AZ" ]
},
"shippingRate": {
"@type": "MonetaryAmount",
"value": 3.49,
"currency": "PLN"
},
"deliveryTime": {
"@type": "ShippingDeliveryTime",
"handlingTime": {
"@type": "QuantitativeValue",
"minValue": 0,
"maxValue": 1
"unitCode": "DAY"
},
"transitTime": {
"@type": "QuantitativeValue",
"minValue": 1,
"maxValue": 5
"unitCode": "DAY"
}
}
}
}
}
Zwroty
Aby określić okresy i koszt zwrotu produktu, użyj mikrodanych schema.org typu MerchantReturnPolicy, który musi być umieszczony w typie Offer za pomocą właściwości hasMerchantReturnPolicy.
|
Atrybut w danych produktów
|
Typ i opis |
|---|---|
| Poniższe mikrodane schema.org są przypisane do typu MerchantReturnPolicy, który musi być umieszczony w produkcie za pomocą właściwości offers (zapoznaj się z przykładami poniżej). | |
| applicableCountry |
2-literowy kod kraju w formacie ISO 3166-1 alfa-2 (np. „PL”) 3-literowy kod kraju w formacie ISO 3166-1 alfa-3 (np. „POL”) Kraj, w którym obowiązują określone zasady zwrotów sprzedawcy. Może on być inny niż kraj, z którego produkt został wysłany. Możesz określić maksymalnie 50 krajów. |
|
Prawidłowe wartości to wartości typu MerchantReturnEnumeration. Jeśli podasz wartość MerchantReturnFiniteReturnWindow lub MerchantReturnUnlimitedWindow, zalecamy użycie właściwości returnMethod i returnShippingFeesAmount. Dodatkowo, jeśli podasz wartość MerchantReturnFiniteReturnWindow, wymagana jest właściwość merchantReturnDays. |
|
| merchantReturnDays |
W ciągu ilu dni od daty dostawy można zwrócić produkt. |
| returnMethod |
Prawidłowe wartości to wartości typu ReturnMethodEnumeration:
|
| returnFees | Prawidłowa wartość to FreeReturn typu ReturnFeesEnumeration. |
| returnShippingFeesAmount |
Informacje o koszcie dostawy zwracanych produktów. |
Przykład
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "trinket-12345",
"gtin": "12345678901234",
"image": "https://www.example.com/trinket.jpg",
"name": "Ładny drobiazg",
"description": "Drobiazg w minimalistycznym stylu",
"brand": {
"@type": "Brand",
"name": "Moja Marka"
},
"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": "PLN"
},
"shippingDetails": {
"@type": "OfferShippingDetails",
"shippingRate": {
"@type": "MonetaryAmount",
"value": 2.99,
"currency": "PLN"
},
"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"
}
}
}
Efektywność energetyczna
Schema.org obsługuje etykiety efektywności energetycznej produktów korzystających z właściwości typu EnergyConsumptionDetails, które można określić dla obiektu Product korzystającego z właściwości EnergyConsumptionDetails.
|
Atrybut w danych produktów
|
Typ i opis |
|---|---|
Poniższe mikrodane schema.org są typu EnergyConsumptionDetails. |
|
|
Prawidłowe wartości to wartości typu schema.org |
|
Dodaj w obiekcie EnergyConsumptionDetails, który został użyty do określenia atrybutu klasa efektywności energetycznej [energy_efficiency_class], i użyj tej samej tabeli mapowania do wybrania wartości. Jeśli nie podano tej wartości i określono atrybut klasa efektywności energetycznej [energy_efficiency_class], przyjmuje się wartość EUEnergyEfficiencyCategoryG. |
|
Dodaj w obiekcie EnergyConsumptionDetails, który został użyty do określenia atrybutu klasa efektywności energetycznej [energy_efficiency_class], i użyj tej samej tabeli mapowania do wybrania wartości. Jeśli nie podano tej wartości i określono atrybut klasa efektywności energetycznej [energy_efficiency_class], przyjmuje się wartość EUEnergyEfficiencyCategoryA3Plus. |
|
Wartości energyEfficiencyScale, energyEfficiencyScaleMin oraz energyEfficiencyScaleMax pochodzą z typu wyliczenia schema.org EUEnergyEfficiencyEnumeration i odpowiadają wartościom dla 3 atrybutów efektywności energetycznej w specyfikacji danych produktów tak, jak podano poniżej.
| Wartość w specyfikacji danych produktów | Wartość wyliczenia schema.org z typuEUEnergyEfficiencyEnumeration type |
|---|---|
A+++ |
EUEnergyEfficiencyCategoryA3Plus |
A++ |
EUEnergyEfficiencyCategoryA2Plus |
A+ |
EUEnergyEfficiencyCategoryA1Plus |
A |
EUEnergyEfficiencyCategoryA |
B |
EUEnergyEfficiencyCategoryB |
C |
EUEnergyEfficiencyCategoryC |
D |
EUEnergyEfficiencyCategoryD |
E |
EUEnergyEfficiencyCategoryE |
F |
EUEnergyEfficiencyCategoryF |
G |
EUEnergyEfficiencyCategoryG |
Przykład
Poniższy przykład pokazuje, jak określić informacje dotyczące efektywności energetycznej za pomocą mikrodanych schema.org. Ten przykład określa klasę efektywności energetycznej „C” w Unii Europejskiej ze skalą od „A+” do „F” dla podgrzewacza wody.
{ "@context": "https://schema.org/", "@type": "Product", "sku": "1234-5678", "image": "https://www.example.com/waterheater.jpg", "name": "Podgrzewacz wody", "description": "Podgrzewacz wody o dużej pojemności", "gtin": "12345678901231", "mpn": "WH1234", "brand": { "@type": "Brand", "name": "PrzykładowaMarkaPodgrzewaczaWody" },
"hasEnergyConsumptionDetails": {
"hasEnergyEffiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEffiencyScaleMax":
"https://schema.org/EUEnergyEfficiencyCategoryA1Plus",
"energyEffiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryF"
}, "offers": { "@type": "Offer", "url": "https://www.example.com/podgrzewaczwody", "itemCondition": "https://schema.org/NewCondition", "availability": "https://schema.org/InStock", "price": 1799.00, "priceCurrency": "PLN", }}Ceny jednostkowe
Schema.org obsługuje ceny jednostkowe produktów za pomocą właściwości referenceQuantity obiektów typu UnitPriceSpecification, o ile w obiekcie Offer używana jest właściwość priceSpecification. Przy określaniu ceny jednostkowej podaj też cenę i walutę produktu za pomocą właściwości priceSpecification (zamiast bezpośrednio używać właściwości price i priceCurrency w obiekcie Offer).
|
Atrybut w danych produktów
|
Typ i opis |
|---|---|
Poniższe mikrodane schema.org są typu UnitPriceSpecification. |
|
|
Określ miarę ceny jednostkowej za pomocą właściwości Użyj właściwości |
|
|
Określ podstawową miarę ceny jednostkowej za pomocą właściwości Użyj właściwości |
|
Przykład
Przykład poniżej pokazuje cenę 3,99 PLN za 5-kilogramową torbę ryżu z preferowaną ceną standardową za 1 kg. Oznacza to, że produkt może być wyświetlany klientom w cenie 0,80 PLN za kilogram.
{
"@context": "https://schema.org/",
"@type": "Product",
"sku": "basrice12345",
"image": "https://www.example.com/rice.jpg",
"name": "Ryż basmati",
"description": "Duża torba organicznego białego ryżu basmati, 5 kilogramów",
"gtin": "12345678901231",
"brand": {
"@type": "Brand",
"name": "PrzykladowaMarkaRyzu"
},
"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": "PLN",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 5,
"unitCode": "KGM",
"valueReference": {
"value": "1",
"unitCode": "KGM"
}
}
}
}
}
Testowanie znaczników
Przetestuj implementację schema.org za pomocą narzędzia do testowania wyników z elementami rozszerzonymi (sprawdzając raporty dotyczące danych strukturalnych „Informacje o produktach umieszczone przez sprzedawcę”). W Centrum pomocy Google Search Console znajdziesz więcej informacji o korzystaniu z narzędzia, debugowaniu ewentualnych problemów oraz o interpretowaniu wyników uzyskanych za pomocą narzędzia. Dowiedz się więcej o danych strukturalnych produktów.
Wymagania dotyczące znaczników danych strukturalnych
- Znaczniki danych strukturalnych muszą znajdować się w pliku HTML pobranym z serwera WWW. Znaczników danych strukturalnych nie można wygenerować za pomocą JavaScriptu po tym, jak strona zostanie załadowana.
- Twoje strony docelowe nie mogą zmieniać się na podstawie informacji o kliencie, na przykład przez dostosowywanie cen w zależności od adresu IP klienta lub rodzaju przeglądarki.
- Dane strukturalne muszą odpowiadać wartościom, które widzi klient. Podawanie nieprawidłowych danych na stronach docelowych produktów narusza nasze zasady dla programistów stron internetowych.
- Na potrzeby danych strukturalnych zalecamy stosowanie JSON-LD.