Kun käytät strukturoidun datan merkintöjä tuotteidesi laskeutumissivuilla, Googlen on helppo hakea ajantasaista tietoa tuotteistasi ja tarjouksistasi suoraan verkkosivustoltasi. Kaikilla Kauppiaskeskuksen tukemilla strukturoidun datan merkinnöillä on vastaavat määritteet ja hyväksytyt arvot, jotka on lueteltu tuotetietosäännöissä. Strukturoitu data on täsmäytettävä vastaavien arvojen ja määritteiden kanssa.
Sisällys
Määritteet ja schema.org-merkinnät
Määritteet ovat yksi tapa järjestää Kauppiaskeskukseen ilmoittamasi tuotetiedot. Jokainen määrite sisältää yhden tuotetta koskevan tiedon, kuten nimen tai kuvauksen. Kun schema.org-arvot täsmäytetään tarkasti vastaaviin tuotetietosääntöjen mukaisiin määritteisiin, virheiden määrä vähenee syötteen vahvistusvaiheessa.
Huom. Jos käytät automaattisia tuotepäivityksiä, voit parantaa tarkkuutta määrittämällä schema.org-ominaisuudet price, priceCurrency, availability ja condition. Lue lisää automaattisista tuotepäivityksistä.
|
Tuotetietojen määrite
|
Tyyppi ja kuvaus | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Seuraavat määritteet ovat peräisin schema.orgin Product-tyypistä. |
|||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
| URL-osoite | |||||||||||||||||||||||||||||
|
Teksti Ylätason SKU-tunnus, joka on pakollinen, kun samaan tuoteryhmään kuuluvat tuoteversiot ryhmitellään yhteen. |
|||||||||||||||||||||||||||||
|
Teksti GTIN-tunnus, joka yksilöi tuotteesi. Määritä vain yksi näistä schema.orgin ominaisuuksista. Jos käytät GTIN-arvoja, niiden pituuden on oltava oikea ja niihin on sisällyttävä oikea tarkistusnumero. |
|||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
|
Teksti Muuttujalla |
|||||||||||||||||||||||||||||
|
Teksti
|
|||||||||||||||||||||||||||||
|
JA |
Numero (vuosina)
Hyväksyttyjä arvoja ovat
|
||||||||||||||||||||||||||||
| Teksti | |||||||||||||||||||||||||||||
|
TAI |
Teksti
|
||||||||||||||||||||||||||||
|
Teksti
Kelvolliset arvot ovat peräisin
|
|||||||||||||||||||||||||||||
|
Teksti
Hyväksyttävät arvot ovat peräisin WearableSizeSystemEnumeration-tyypistä. Ne vastaavat syötteen arvoja seuraavasti:
|
|||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||
|
Seuraavat schema.org-ominaisuudet ovat peräisin Offer-tyypistä. Ne on sisällytettävä |
|||||||||||||||||||||||||||||
| Tuotteesi kelvollinen URL-osoite. | |||||||||||||||||||||||||||||
|
TAI |
price: Numero ilman valuuttasymboleja, tuhaterottimia tai välilyöntejä (esim. 1498.99). priceCurrency: Teksti kolmikirjaimisessa ISO 4217 ‑muodossa (esim. USD, GBP, EUR) – valuutan on oltava kohdemaan kieli- ja valuuttavaatimusten mukainen. Huom. Price- ja priceCurrency-arvon voi määrittää suoraan Offer-muuttujassa tai epäsuorasti priceSpecification-muuttujassa UnitPriceSpecification-tyypissä. Kun sale_price-määrite ilmoitetaan, price-arvo on ilmoitettava käyttämällä priceSpecification-muuttujaa ja arvoa priceSpecification.priceType="ListPrice". Sale_price voidaan määrittää suoraan Offer-muuttujassa tai priceSpecification-muuttujassa UnitPriceSpecification-tyypissä ilman arvoa priceSpecification.priceType. |
||||||||||||||||||||||||||||
|
Kelvolliset arvot ovat peräisin
|
|||||||||||||||||||||||||||||
|
Kelvolliset arvot ovat peräisin
|
|||||||||||||||||||||||||||||
| Tuotteesi kelvollinen kassan URL-osoite. | |||||||||||||||||||||||||||||
JSON-LD-esimerkkejä
Yksittäinen tuote
Esimerkki
Seuraava esimerkki kuvaa perustuotetta, jolla on vähimmäismäärä muuttujia.
{
"@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"
}
}
Seuraavassa esimerkissä havainnollistetaan, miten voit määrittää kokotyypin ja kokojärjestelmän schema.orgin avulla. Tässä esimerkissä ilmoitetaan Yhdysvaltojen kokojärjestelmän mukaisen XL-koon sininen t-paita, joka on tarkoitettu aikuisille (yli 13-vuotiaille) miesten muotikategoriassa "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"
}
}
Monia toisiinsa liittymättömiä tuotteita laskeutumissivulla
Jos sivullasi on useita tuotteita, jotka eivät liity toisiinsa ja joilla on omat strukturoidun datan merkinnät, jokaisessa merkinnässä on oltava tiedot siitä, mihin tuotteeseen se viittaa.
Jokaiseen merkintään kannattaa esimerkiksi lisätä SKU-tunnus (tunnus [id] ‐määrite) tai GTIN ([gtin]-määrite) kussakin merkinnässä. Jos näitä tietoja ei lisätä, laskeutumissivusi tuotteita ei välttämättä täsmätä strukturoituihin tuotetietoihin. Lue lisää laskeutumissivujen strukturoidun datan käyttöönotosta.
Esimerkki
[
{
"@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"
}
}
]Alennushinta
Seuraava esimerkki kuvaa perustuotetta, jolla on alennushinta. Jos haluat lisätä alennushinnan, ilmoita myös alkuperäinen ovh-hinta /priceType-muuttujan avulla.
Esimerkki
{
"@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"
}
}
}
Jos /UnitPriceSpecification on käytössä myös normaalihinnalle, /UnitPriceSpecifications esiintyy koodissa kahdesti:
{
"@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"
}
]
}
}
Toimitus
Voit ilmoittaa tuotteen toimituskulut (suositellaan) Schema.org-muuttujatyypillä OfferShippingDetails, joka pitää olla upotettu Offer-tyyppiin shippingDetails-muuttujalla ja vastata tuotetietosääntöjen shipping-määritettä. Voit lisätä useita shippingDetails-muuttujia.
|
Tuotetietojen määrite
|
Tyyppi ja kuvaus |
|---|---|
Seuraavat määritteet ovat peräisin schema.orgin OfferShippingDetails-tyypistä. |
|
|
|
Teksti Kaksinumeroinen ISO 3166-1 ‑maatunnus
|
|
Teksti Kaksi- tai kolminumeroinen ISO 3166-2 ‑alakoodi ilman maan etuliitettä. Tuettu vain Yhdysvalloissa, Australiassa ja Japanissa. Esimerkkejä: "NY", "NSW" tai "03".
|
|
|
Muuttujalla |
|
|
Numero (ei-negatiivinen kokonaisluku) Määrittää tilauksen käsittelyn ja toimituksen vähimmäis- ja enimmäiskeston arkipäivissä. Käsittelyaikaan sisältyy aika tilauksen tekemisen ja tuotteen luovuttamisen kuljetusyhtiölle välissä. Kuljetusaika on aika tuotteen luovuttamisen kuljetusyhtiölle ja toimittamisen asiakkaalle välissä. Muuttujalla |
|
Esimerkki
Seuraavassa esimerkissä havainnollistetaan, miten toimitustiedot ilmoitetaan schema.org-ominaisuuksilla. Esimerkissä toimituskuluiksi ilmoitetaan 3,49 USD Yhdysvalloissa Kalifornian, Nevadan ja Arizonan osavaltioissa. Käsittelyaika on 0–1 arkipäivää ja kuljetusaika 1–5 arkipäivää.
{
"@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"
}
}
}
}
}
Palautukset
Voit ilmoittaa tuotteen palautusjaksot ja ‐kulut Schema.orgin MerchantReturnPolicy-tyypillä. Se täytyy sisällyttää Offer-tyyppiin hasMerchantReturnPolicy-muuttujan avulla.
|
Tuotetietojen määrite
|
Tyyppi ja kuvaus |
|---|---|
| Seuraavat schema.org-ominaisuudet ovat peräisin MerchantReturnPolicy-tyypistä. Ne on sisällytettävä tuotteeseen offers-muuttujan avulla (katso alla olevat esimerkit). | |
| applicableCountry |
Kaksikirjaiminen ISO 3166-1 alpha-2 ‐muotoinen maatunnus (esim. US) Kolmikirjaiminen ISO 3166-1 alpha-3 ‐muotoinen maatunnus (esim. "USA") Maa, jota tietty kauppiaan palautuskäytäntö koskee. Tämä voi olla eri kuin maa, josta tuote on lähetetty. Voit määrittää enintään 50 maata. |
|
Kelvolliset arvot ovat peräisin MerchantReturnEnumeration-tyypistä. Jos arvoksi on ilmoitettu MerchantReturnFiniteReturnWindow tai MerchantReturnUnlimitedWindow, arvojen returnMethod ja returnShippingFeesAmount käyttö on suositeltavaa. Jos arvoksi on ilmoitettu MerchantReturnFiniteReturnWindow, merchantReturnDays on pakollinen. |
|
| merchantReturnDays |
Niiden päivien lukumäärä (toimituspäivästä laskettuna), jolloin tuote voidaan palauttaa. |
| returnMethod |
Kelvolliset arvot ovat peräisin ReturnMethodEnumeration-tyypistä:
|
| returnFees | ReturnFeesEnumeration-tyypin FreeReturn-arvo on kelvollinen. |
| returnShippingFeesAmount |
Tietoja tuotepalautusten toimituskuluista. |
Esimerkki
{
"@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"
}
}
}
Energiatehokkuus
Schema.org tukee sellaisten tuotteiden energiatehokkuusluokitusta, jotka käyttävät EnergyConsumptionDetails-tyyppiä. Sen voi määrittää tuotteilla, joilla on EnergyConsumptionDetails-muuttuja.
|
Tuotetietojen määrite
|
Tyyppi ja kuvaus |
|---|---|
Seuraavat schema.org-ominaisuudet ovat peräisin EnergyConsumptionDetails-tyypistä. |
|
|
Kelvolliset arvot ovat peräisin schema.orgin |
|
Lisää sen EnergyConsumptionDetails-muuttujan alle, jota on käytetty energy_efficiency_class-määritteen ilmoittamiseen. Valitse arvo käyttämällä samaa mäppäystaulukkoa. Jos arvoa ei ole annettu ja energy_efficiency_class on ilmoitettu, käytetään EUEnergyEfficiencyCategoryG-arvoa. |
|
Lisää sen EnergyConsumptionDetails-muuttujan alle, jota on käytetty energy_efficiency_class-määritteen ilmoittamiseen. Valitse arvo käyttämällä samaa mäppäystaulukkoa. Jos arvoa ei ole annettu ja energy_efficiency_class on ilmoitettu, käytetään EUEnergyEfficiencyCategoryA3Plus-arvoa. |
|
EnergyEfficiencyScale-, energyEfficiencyScaleMin- ja energyEfficiencyScaleMax-muuttujien arvot ovat peräisin schema.orgin listatyypistä EUEnergyEfficiencyEnumeration. Ne on mäpätty tuotetietosääntöjen kolmen energiatehokkuusmääritteen arvoihin seuraavasti.
| Tuotetietosääntöjen arvo | Schema.orgin luetteloarvo EUEnergyEfficiencyEnumeration -tyypistä |
|---|---|
A+++ |
EUEnergyEfficiencyCategoryA3Plus |
A++ |
EUEnergyEfficiencyCategoryA2Plus |
A+ |
EUEnergyEfficiencyCategoryA1Plus |
A |
EUEnergyEfficiencyCategoryA |
B |
EUEnergyEfficiencyCategoryB |
C |
EUEnergyEfficiencyCategoryC |
D |
EUEnergyEfficiencyCategoryD |
E |
EUEnergyEfficiencyCategoryE |
F |
EUEnergyEfficiencyCategoryF |
G |
EUEnergyEfficiencyCategoryG |
Esimerkki
Seuraavassa esimerkissä havainnollistetaan, miten voit ilmoittaa energiatehokkuustietoja schema.orgin avulla. Esimerkissä määritetään vedenlämmittimelle EU:n energiatehokkuusluokitus "C" asteikolla A+–F.
{ "@context": "https://schema.org/", "@type": "Product", "sku": "1234-5678", "image": "https://www.example.com/waterheater.jpg", "name": "Water heater", "description": "Suuren kapasiteetin vedenlämmitin", "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" }}Yksikköhinnoittelu
Schema.org tukee yksikköhinnoittelua referenceQuantity-muuttujalla, jonka tyyppi on UnitPriceSpecification. Käytä tarjouksessa muuttujaa priceSpecification. Kun määrität yksikköhinnoittelua, ilmoita myös tuotteen hinta ja valuutta priceSpecification-muuttujalla (älä lisää tarjoukseen suoraan price- ja priceCurrency-arvoja).
|
Tuotetietojen määrite
|
Tyyppi ja kuvaus |
|---|---|
Seuraavat schema.org-ominaisuudet ovat peräisin UnitPriceSpecification-tyypistä. |
|
|
Määritä yksikön hinnoitteluperuste Muuttujilla |
|
|
Määritä yksikköhinnan perusmäärä Muuttujilla |
|
Esimerkki
Seuraavassa esimerkissä havainnollistetaan, miten ilmoitetaan hinta 3,99 euroa viidelle kilolle riisiä, jonka standardihinta ilmoitetaan kilon perusteella. Tämä tarkoittaa, että tuotteen yksikköhintana voi näkyä kuluttajille 0,80 EUR per kilo.
{
"@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"
}
}
}
}
}
Merkintöjen testaaminen
Voit testata schema.org-toteutustasi rich-tulosten työkalulla (tarkistamalla kauppiaan listausten strukturoitua dataa koskevat raportit). Lisätietoja työkalusta, virheenkorjauksista ja työkalun tulosten tulkinnasta saat Google Search Consolen ohjekeskuksesta. Lue lisää tuotteiden strukturoidusta datasta.
Strukturoidun datan merkintöjä koskevat vaatimukset
- Strukturoidun datan merkintöjen on sisällyttävä verkkopalvelimen palauttamaan HTML:ään. Strukturoidun datan merkintöjä ei voi luoda JavaScriptillä sivun lataamisen jälkeen.
- Laskeutumissivua ei voi muuttaa asiakasta koskevien tietojen perusteella. Esimerkiksi hintoja ei siis saa muuttaa asiakkaan IP-osoitteen tai selaimen tyypin perusteella.
- Strukturoidun datan on vastattava asiakkaalle näytettyjä arvoja. Virheellisen datan käyttäminen tuotteen laskeutumissivuilla on web-kehittäjien ohjeiden vastaista.
- Google suosittelee strukturoidun datan ylläpitämiseen JSON-LD:tä.